LIGO BLE CONFIGURATOR

Overview

The LIGO BLE Configurator is a cross-platform mobile application for configuring, monitoring, and managing LIGO Bluetooth Low Energy (BLE) fuel level sensors. It runs on Android and iOS and communicates with sensors over Bluetooth Low Energy. The application is developed by SOJI Electronics JSC using Microsoft .NET MAUI.

Supported Product Lines

From the home screen (Bluetooth Products page) you choose one of three product lines. The available pages and settings adapt to the product you select.

Product	Type	Description
LIGO AIR	Wireless sensor	Battery-powered wireless fuel level sensor using Bluetooth 5.2
LIGO PRO BLE / PRO 2(S)	Wired sensor	Wired fuel level sensor with Bluetooth 5.2 for wireless configuration
LIGO AIR ADAPTER	Transceiver	Transceiver device that connects multiple LIGO AIR wireless sensors

Key Capabilities

Scan for and connect to nearby LIGO BLE sensors
View real-time sensor data (fuel level, temperature, capacitance, battery, accelerometer)
Calibrate the tank using Set Empty / Set Full points and a multi-point calibration table
Configure sensor parameters (output format, transmission interval, address, baud rate, and more)
Manage BLE / advanced settings (TX power, advertising interval, BLE mode, logging)
Download stored data logs and export them as Excel (.xlsx) files
View setting / event logs retrieved from the SOJI server
Update sensor firmware
Create installation and maintenance reports with photos
Manage multiple wireless sensors through the LIGO AIR ADAPTER
Protect sensor access with a password, including a password recovery mechanism

Navigation Structure

After a product is selected, the application uses a three-tab layout at the bottom of the screen:

Tab	Purpose
Connection	Device scanning, connection, and the real-time device dashboard
Settings	Product-specific configuration pages (calibration, parameters, advanced settings, logs, reports)
Help	Online support contacts, application information, and user-guide resource links

Figure 1. Bluetooth Products (home) page

System Requirements

Operating System

Platform	Minimum version
Android	Android 8.0 Oreo (API level 26) or later
iOS	iOS 13.2 or later

Hardware

A mobile device with Bluetooth Low Energy (BLE) support. BLE hardware is required; the app shows a warning if the device does not support BLE.
A camera is used for scanning QR codes and taking report photos (optional features).

Permissions

The application declares and requests the following permissions. On first use (when the Products page opens), the app requests Bluetooth, Location, and Camera permission.

Permission	Why it is used
Bluetooth	Read data from and write configuration to LIGO BLE sensors
Location	Required by the operating system for BLE scanning; also used to record the sensor installation location
Camera	Scan a sensor serial-number QR code and take photos for reports
Photos / Storage	Attach photos to reports and save exported data files
Internet / Network	Upload logs and reports and retrieve server-side setting logs

NOTICE: Android Location requirement

On Android, Location Services must be enabled for BLE scanning to work. This is an Android operating-system requirement, not a limitation of the application.

Network

An internet connection is required only for the server-connected features: uploading data logs and reports to the SOJI server, and viewing setting / event logs retrieved from the server. Scanning, connecting, calibration, parameter configuration, and firmware updates work over Bluetooth without an internet connection.

Installation

Installing the Application

Install LIGO BLE Configurator from the Apple App Store (iOS) or Google Play Store (Android), or from the distribution package provided by SOJI Electronics.
Open the application after installation completes.

LIGO BLE Configurator on Google Play
LIGO BLE Configurator on App Store

Granting Permissions

When you open the application and reach the Products page, it checks for the permissions it needs and prompts you to grant any that are missing:

Allow Bluetooth access. If Bluetooth permission is not granted, the app shows a message asking you to allow Bluetooth access and cannot scan for sensors.
Allow Location access (used for BLE scanning and to record installation location).
Allow Camera access (used for QR scanning and report photos).
If Bluetooth is turned off on the device, enable it when prompted.

NOTICE: Bluetooth not available

If the device hardware does not support Bluetooth Low Energy, the app displays the warning "Your phone does not support Bluetooth Low Energy" and scanning is unavailable.

[ Screenshot to be added: Operating-system permission dialog (Bluetooth / Location / Camera) ]

Please capture this screen and place the image here.

Operating-system permission dialog (Bluetooth / Location / Camera)

Quick Start

This section walks through connecting to a sensor and reaching its dashboard for the first time.

Select a Product

Open the app to display the Bluetooth Products page.
Tap the product line you are working with: LIGO AIR, LIGO PRO BLE / PRO 2(S), or LIGO AIR ADAPTER.
The app opens the scan page for that product and begins searching for nearby BLE devices automatically.

Scan and Connect

The scan page lists discovered devices. Each row shows the device name, signal strength (RSSI), and a fuel-level reading taken from the advertisement data.

Use the search bar to filter the list by name or serial number.
Use the SOJI filter toggle to show only SOJI / LIGO devices.
Use the QR scanner to find a specific sensor by scanning its QR code.

Locate your target device in the list.
Tap Connect on the device row to start the BLE connection.
When the connection succeeds, the app opens the Device page (dashboard).

Figure 2. Scan page (LIGO AIR)
Figure 3. Scan page (LIGO PRO)

Open Settings

Use the Settings tab to reach the configuration pages for the connected device. The menu contents depend on the product line.

Figure 5. Settings menu (LIGO PRO)
Figure 6. Settings menu (LIGO AIR)

Password Prompt

LIGO sensors are password protected. The password is not requested at connection time; instead, it is requested the first time you open a password-protected settings page (for example Parameter Settings, Advanced Settings, or Set Empty / Set Full). Enter the password and tap OK to continue.

The factory default password is 1234. Change it after the initial setup.
If you forget the password, use Forgot Password on the prompt to obtain a recovery hash and contact SOJI support. See Section 9.

Features

This section summarises the main screens. Detailed configuration steps are in Section 6 (Configuration / Settings).

Device Dashboard

After connecting, the Device page shows a tank graphic with a fill-level indicator plus live readings. The fields shown depend on the product line.

LIGO PRO BLE

Figure 7. LIGO PRO dashboard (top)
Figure 8. LIGO PRO dashboard (details)
LIGO PRO dashboard (further details)

Fields displayed under the DEVICE section include:

Field	Description
Data source	Source of the displayed data (advertisement or connected)
C_working_compensated	Temperature-compensated working capacitance value
C Min / C Max	Empty / full tank capacitance reference values
OSC frequency	Oscillator frequency reading
Fuel volume (Liter)	Calculated fuel volume based on calibration
Baudrate	Current serial communication baud rate
Filter time (s)	Signal filtering time in seconds
BLE mode	Current Bluetooth operating mode
Address	Sensor network address
Rssi	Received Signal Strength Indicator
Boot counts	Number of sensor power-on cycles
Operating time (hours)	Total sensor operating time
Sensor type	Hardware type identifier
Protocol	Communication protocol (when available)
Sensor message	Status message (color-coded: green = OK, red = error)
Device ID / Serial Number	Identifiers (tap to copy to clipboard)
Boot / Firmware / Hardware version, FW build date	Firmware and hardware identifiers

LIGO AIR

Figure 9. LIGO AIR dashboard (top)
Figure 10. LIGO AIR dashboard (details)
LIGO AIR dashboard (further details)

The LIGO AIR dashboard adds wireless-specific fields not present on the wired LIGO PRO:

Field	Description
Raw data	Unprocessed sensor reading
C_working_compensated, C Min, C Max	Capacitance working and reference values
CNT	Counter / oscillator count value
Vbat	Battery voltage (e.g. X.XX V)
Axis X / Y / Z	Three-axis accelerometer readings
Time/Date	Sensor internal real-time clock value
Rssi, Boot counts, Operating time	Signal strength and usage statistics
Sensor message	Status message (color-coded)
Serial Number / MAC address	Identifiers (tap to copy)
Boot / Firmware / Hardware version, FW build date	Firmware and hardware identifiers

Calibration

Two calibration methods map raw capacitance readings to fuel volume: Set Empty / Set Full (two reference points) and a multi-point calibration table for non-linear tanks. See Section 6.1.

Logs

Data Logs – download historical measurements stored in the sensor and export them as Excel files.
Setting Logs / Event Logs – view configuration-change and event history retrieved from the SOJI server.

Firmware Update

Update the sensor firmware over the air. LIGO PRO uses the Nordic DFU process (.zip files); LIGO AIR and LIGO AIR ADAPTER use the Silicon Labs OTA process (.gbl files). See Section 6.4.

Reports

Create installation and maintenance reports with up to 3 photos each, and view previously created reports. See Section 6.5.

Multi-Sensor Management (LIGO AIR ADAPTER)

The LIGO AIR ADAPTER aggregates data from multiple LIGO AIR sensors. From the adapter connection page you can add sensors, remove sensors, and refresh their status. See Section 6.

Figure 11. LIGO AIR ADAPTER - connected sensor list

Configuration / Settings

All configuration pages provide Load from Sensor (read current values from the device) and Save to Sensor (write changes to the device).

Calibration

Set Empty / Set Full

Establishes the empty-tank and full-tank reference points for linear fuel-level calculation. Applicable to LIGO PRO BLE and LIGO AIR.

Set the empty point:

Lower the fuel level to minimum (drain the tank).
Open Settings > Set Empty/Full.
Watch the live C_working_compensated value and wait for it to stabilise.
Tap Set Empty to record the C Min value.

Set the full point:

Fill the tank to maximum.
Wait for the C_working_compensated value to stabilise.
Tap Set Full to record the C Max value.

CAUTION: Stable readings required

Make sure the fuel level is completely stable before tapping Set Empty or Set Full. Unstable readings produce inaccurate calibration.

Multi-Point Calibration Table

For non-linear tanks, a multi-point table improves accuracy. Applicable to LIGO PRO BLE and LIGO AIR (on LIGO AIR it is reached via the calibration page).

Tap Load from Sensor to read the current table from the device.
Tap + to add a calibration point.
Enter the known Volume (liter); the Level value comes from the current reading.
Repeat for several fuel levels (for example empty, 1/4, 1/2, 3/4, full).
Tap - next to a row to remove a point.
Tap Save to Sensor to write the table to the device.

Use View Chart to plot the calibration curve and confirm it rises smoothly. On LIGO AIR, Advanced Settings > Recalculate in liters recalculates stored calibration data into liter units.