Jump to content

LIGO Air Configuration: Difference between revisions

From SOJI ELECTRONICS
[unchecked revision][checked revision]
← Older edit
Admin (talk | contribs)
Bureaucrats, Interface administrators, Administrators
1,203 edits
VisualWikitext
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
This page describes how to configure the LIGO AIR fuel level sensor, including BLE mobile application setup, calibration procedure (Set Empty / Set Full), calibration table options, and advertising protocol integration.
This page describes how to configure the LIGO AIR fuel level sensor, including BLE mobile application setup, calibration procedure (Set Empty / Set Full), calibration table options, and advertising protocol integration.


Line 32: Line 30:
[[File:LIGO-AIR-device-list.png|thumb|400px|center|Selecting LIGO AIR from device list]]
[[File:LIGO-AIR-device-list.png|thumb|400px|center|Selecting LIGO AIR from device list]]


'''Recommendation''': Signal strength (RSSI) at the receiving device must be ≥ -80 dBm. For weak signal cases, use LIGO PRO or LIGO AIR Adapter.
'''Recommendation''': Signal strength (RSSI) at the receiving device must be ≥ -80 dBm. For weak signal cases, use LIGO AIR PRO or LIGO AIR ADAPTER.


== Calibration: Set Empty / Set Full ==
== Calibration: Set Empty / Set Full ==
Line 97: Line 95:
| Password || Access password || '''Must change default password to prevent unauthorized access'''
| Password || Access password || '''Must change default password to prevent unauthorized access'''
|}
|}
== Protocol Integration ==
LIGO AIR utilizes Bluetooth Low Energy (BLE) to transmit structured fuel sensor data in advertising packets at regular intervals. Data includes fuel level, battery voltage, temperature, and operation mode. For long-range applications, the LIGO AIR Adapter is recommended to boost reception.
In addition to its native protocol, LIGO AIR supports both '''Escort''' and '''Mielta''' protocols, enabling seamless protocol switching without requiring additional integration effort. Users can configure the desired protocol via the mobile application.
=== Advertising Message Format ===
Structure of the '''Manufacturer data''' field in the advertising message (same for any type of peripheral unit):
'''Example Manufacturer data''': <code>0x0CFFFC0D024D0100241F000600</code>
{| class="wikitable"
! Sequence number of bytes !! Description !! Example
|-
| 0          || Length of field || 0x0C
|-
| +1          || Type of field (Manufacturer data) || Always 0xFF
|-
| +2          || Company ID || 0x0DFC
|-
| +4          || Hardware id (type of device) || 0x02 – LIGO Air
|-
| +5 and further || Payload (sensor parameters) || 0x4D0100241F000600
|}
=== Hardware ID Mapping ===
In order to distinguish between types of hardware, the '''hardwareid''' byte defines a set of useful parameters from the peripheral unit, their size and order.
{| class="wikitable"
! Byte of hardwareid !! Type of hardware
|-
| 0x02 || LIGO Air
|-
| 0x03 || LIGO Air Pro
|}
''The list of hardware may be expanded.''
=== Payload Data Format ===
LIGO Air and LIGO Air Pro use the same payload data format.
{| class="wikitable"
! Sequence number of bytes !! Parameter type !! Parameter length (bytes) !! Range !! Unit of measurement
|-
| 0  || Fuel level || 2 || 0 to 1023 (option) / 0 to 4095 (default) / Liter: 0 to 65535 (option) || Arbitrary units
|-
| +2 || Reserved || 1 || NA || NA
|-
| +3 || Built-in battery voltage || 1 || 0 to 255 || Volt × 10
|-
| +4 || Temperature || 1 || -128 to 127 || Celsius degrees
|-
| +5 || Reserved || 1 || NA || NA
|-
| +6 || Firmware version || 1 || 0 to 255 || Version number
|-
| +7 || Operation Mode || 1 || 0 and 1 || 0: Working Mode, 1: Storage Mode
|}
=== Example Payload Decoding ===
'''Example Payload data''': <code>0x4D0100241F000600</code>
{| class="wikitable"
! Bytes !! 4D01 !! NA !! 24 !! 1F !! NA !! 06 !! 00
|-
! Field
| Fuel level || Reserved || Battery voltage || Temperature || Reserved || Firmware version || Operation Mode
|-
! Little-endian (hex)
| 014D || NA || 24 || 1F || NA || 06 || 00
|-
! Decimal
| 333 || NA || 36 || 31 || NA || 006 || 0
|-
! Value
| 333 (unit or liter) || NA || 3.6 Volt || 31 °C || NA || 0.0.6 || Working mode
|}
[[File:LIGO-AIR-payload-example.png|thumb|600px|center|Payload data decoding example]]
== Security Recommendations ==
* Change the default password provided by the manufacturer immediately after first connection to prevent unauthorized access
* Verify the sensor's MAC address against the manufacturer's QR code label to confirm device authenticity
* Restrict app installation to authorized technicians only
== Revision History ==
{| class="wikitable"
! Date !! Document !! Version !! Description
|-
| 18/06/2025 || Protocol Integration || 1.0  || Initial Release
|-
| 27/08/2025 || Protocol Integration || 1.1  || Minor changes
|}




[[Category:LIGO Air]]
[[Category:LIGO Air]]

Latest revision as of 07:44, 13 May 2026

This page describes how to configure the LIGO AIR fuel level sensor, including BLE mobile application setup, calibration procedure (Set Empty / Set Full), calibration table options, and advertising protocol integration.

Mobile Application

To configure the LIGO AIR fuel sensor, download the LIGO BLE Configurator app:

  • iOS: Available on App Store
  • Android: Available on Google Play (CH Play)

Hereinafter LIGO BLE Configurator is referred to as the "application" or "app".

Note: For full operation, you must grant all the permissions requested by the app (Camera, Location, Nearby devices, Bluetooth).

File:LIGO-AIR-app-permissions.png
Granting permissions for LIGO BLE Configurator

Connecting Sensor

  1. Run the application
  2. Open the device list and select the sensor you want to connect to
  3. Wait for the sensor to appear in the discovered devices list
  4. Press Connect next to the desired sensor

Each sensor in the list shows:

  • Device name (e.g., LIGO AIR_7EEF7E7F)
  • RSSI (signal strength)
  • Temperature
  • Current fuel level
  • Battery voltage (Vbat)
  • Firmware version (FW)
File:LIGO-AIR-device-list.png
Selecting LIGO AIR from device list

Recommendation: Signal strength (RSSI) at the receiving device must be ≥ -80 dBm. For weak signal cases, use LIGO AIR PRO or LIGO AIR ADAPTER.

Calibration: Set Empty / Set Full

After installation, the sensor must be calibrated to ensure accurate measurement.

Step 1: Set Full

  1. Immerse the sensor in fuel until the fuel reaches the sensor flange
  2. Wait for the C_working value to stabilize
  3. Press Set Full button in the app
File:LIGO-AIR-set-full.png
Set Full procedure

Step 2: Set Empty

  1. Remove the sensor from the fuel
  2. Wait for 1–2 minutes to allow the fuel to drain from the measuring probe
  3. Press Set Empty button in the app
File:LIGO-AIR-set-empty.png
Set Empty procedure

Reference Values

Field Description Example
C_working_compensated Current capacitance value (temperature compensated) 19747
C_Min Captured "empty" reference value 4000
C_Max Captured "full" reference value 200000

Calibration Table

Volume measurement can be obtained in two ways:

Method Description
Calibration table on the Platform (Server) The sensor sends raw level values (0 to 4095) to the server via the telematic device. The platform uses a calibration table to convert these values into volume (liters).
Calibration table on the Sensor The sensor directly sends volume values (liters) based on the internal calibration table.

Note: For LIGO AIR sensors, the manufacturer recommends performing the calibration table on the platform.

Configurable Parameters

Parameter Description Default / Range
Device name Sensor BLE name shown in scan list LIGO AIR_<MAC>
Advertising protocol Protocol used in advertising packet SOJI (default) / Mielta / Escort
Measurement interval Sampling rate 5 to 10 seconds
Advertising message interval How often the sensor broadcasts LIGO AIR: 5–10s, LIGO AIR PRO: 10–15s
Output mode Raw value or liters 0–1023 / 0–4095 (default) / Liter 0–65535
Password Access password Must change default password to prevent unauthorized access
SOJI Electronics
Retrieved from "https://wiki.sojielectronics.com/index.php?title=LIGO_Air_Configuration&oldid=362"