LIGO Air Configuration

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