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):
! 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
| 27/08/2025 || Protocol Integration || 1.1 || Minor changes
|}
[[Category:LIGO Air]]
[[Category:LIGO Air]]
Revision as of 07:14, 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).
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
