Jump to content

LIGO AIR ADAPTER User Guide: Difference between revisions

From SOJI ELECTRONICS
[checked revision][checked revision]
change color
Update content
Line 1: Line 1:
== Safety Information ==
== Safety Information ==
{| class="wikitable"
!ℹ️ NOTICE — Important notes during sensor installation
|-
|Read and understand all safety information in this document before installing, operating or servicing the LIGO AIR ADAPTER
* Keep the device out of the reach of children. It is not a toy and contains small parts.
* Do not modify, drill or otherwise alter the device.
* Always '''disconnect power''' before wiring, connecting/disconnecting cables or servicing.
* Connect the device only to a power source within the rated input voltage.
|}


== Product Overview ==
== Product Overview ==
Line 14: Line 24:


The device acts as:
The device acts as:
* A BLE to wired protocol bridge
* A BLE to wired protocol bridge.
* A Sensor Union Module (SUM) capable of aggregating data from multiple sensors
* A Sensor Union Module (SUM) capable of aggregating data from multiple sensors.
* A BLE signal receiver with enhanced sensitivity for extended wireless range
* A BLE signal receiver with enhanced sensitivity for extended wireless range.


LIGO AIR ADAPTER supports multiple output interfaces including RS232, RS485, and AF, ensuring compatibility with a wide range of GPS tracking devices.
LIGO AIR ADAPTER supports multiple output interfaces including RS232, RS485, and AF, ensuring compatibility with a wide range of GPS tracking devices.


=== System Architecture ===
=== System Architecture ===
[[File:System architecture1.png|center|thumb|928x928px|Figure 1. Ligo Air Adapter — System Architecture]]
[[File:System architecture1.png|center|thumb|928x928px|Figure 1. LIGO AIR ADAPTER — System Architecture]]
* Wireless fuel sensors (Ligo Air / Ligo Air Pro) transmit fuel level data via BLE
* Wireless fuel sensors (Ligo Air / Ligo Air Pro) transmit fuel level data via BLE.
* LIGO AIR ADAPTER receives BLE data and processes it.
* LIGO AIR ADAPTER receives BLE data and processes it.
* Processed data is transmitted to the GPS tracker via RS232, RS485 or AF interface.
* Processed data is transmitted to the GPS tracker via RS232, RS485 or AF interface.
* Log sensor data for history view and troubleshooting
* Log sensor data for history view and troubleshooting.


== Package Contents ==
== Package Contents ==
{| class="wikitable"
!No.
!Description
!Qty (pcs)
|-
|1
|LIGO AIR ADAPTER
|01
|-
|2
|Quick user guide
|01
|}
Table 1. LIGO AIR ADAPTER — Package content


== Specifications ==
== Specifications ==
{| class="wikitable"
| valign="top" |'''No.'''
| valign="top" |'''PARAMETERS'''
| valign="top" |'''RS232'''
| valign="top" |'''RS485'''
| valign="top" |'''PRO'''
| valign="top" |'''AF'''
|-
| valign="top" |1
| valign="top" |Dimension (without wire), mm
| colspan="4" valign="top" |670x800
|-
| valign="top" |2
| valign="top" |Output interface
| colspan="2" valign="top" |Digital
| valign="top" |Analog & Digital
| valign="top" |Analog
|-
| valign="top" |3
| valign="top" |Baud rate, bit/sec
| colspan="3" valign="top" |2400, 4800, 9600, 14400,
19200, 38400, 115200.
| valign="top" |
|-
| valign="top" |4
| valign="top" |Power supply, VDC
| colspan="4" valign="top" |7 – 36 VDC
|-
| valign="top" |5
| valign="top" |Maximum power consumption
| colspan="4" valign="top" |~15 mA @13.5VDC
|-
| valign="top" |6
| valign="top" |Power supply protection
| colspan="4" valign="top" |1000VDC reverse polarity protection
|-
| valign="top" |7
| valign="top" |Operating temperature, °C
| colspan="4" valign="top" |-40 to 85 °C
|-
| valign="top" |8
| valign="top" |Waterproof standard
| colspan="4" valign="top" |IP67
|-
| valign="top" |9
| valign="top" |Output value range
| colspan="2" valign="top" |Digital
| valign="top" |Digital and analog
| valign="top" |Analog (0-10V)
|-
| valign="top" |10
| valign="top" |Data output mode
| colspan="4" valign="top" |SUM, AVERAGE, INDIVIDUAL
|-
| valign="top" |11
| valign="top" |Bluetooth specs
| colspan="4" valign="top" |BLE 5.2
|-
| valign="top" |12
| valign="top" |Average service life, years (expected)
| colspan="4" valign="top" |8 years
|}
Table 2. LIGO AIR ADAPTER — Detail specifications


== Installation ==
== Installation ==
Line 38: Line 127:


{| class="wikitable" style="text-align:center;"
{| class="wikitable" style="text-align:center;"
|+ Table 1. Ligo Air Adapter cable description
|+
! No. !! Wire Color !! Wire Name !! Description
! No. !! Wire Color !! Wire Name !! Description
|-
|-
Line 57: Line 146:
| 8 || <div style="display:flex;align-items:center;justify-content:center;gap:8px;"><span style="display:inline-block;width:32px;height:14px;background:#1e6cff;"></span><span style="min-width:60px;text-align:left;font-weight:bold;">BLUE</span></div> || '''RS232-TX''' || style="text-align:left;" | Output data for RS232
| 8 || <div style="display:flex;align-items:center;justify-content:center;gap:8px;"><span style="display:inline-block;width:32px;height:14px;background:#1e6cff;"></span><span style="min-width:60px;text-align:left;font-weight:bold;">BLUE</span></div> || '''RS232-TX''' || style="text-align:left;" | Output data for RS232
|}
|}
Table 3. LIGO AIR ADAPTER — Cable description


==== Mechanical installation ====
==== Mechanical installation ====
Line 68: Line 158:


{| class="wikitable" style="text-align:center;"
{| class="wikitable" style="text-align:center;"
|+ Table 2. Ligo Air Adapter — Wiring connection table
|+
! No. !! Wire Name !! RS232 !! RS485 !! AF !! PRO
! No. !! Wire Name !! RS232 !! RS485 !! AF !! PRO
|-
|-
Line 87: Line 177:
| 8 || '''RS232-TX''' || ✓ || — || — || ✓
| 8 || '''RS232-TX''' || ✓ || — || — || ✓
|}
|}
 
Table 4. LIGO AIR ADAPTER — Wiring connection{{Notice
{{Notice
| title = Protocol Connection
| title = Protocol Connection
| body = The PRO model supports all available output communication protocols (RS232, RS485, and AF). Select the output interface compatible with the existing GPS tracker.
| body = The PRO model supports all available output communication protocols (RS232, RS485 and AF). Select the output interface compatible with the existing GPS tracker.
}}
}}


Line 107: Line 196:
| style="text-align:center;" | Green solid || Valid data is being received from paired sensor(s)
| style="text-align:center;" | Green solid || Valid data is being received from paired sensor(s)
|}
|}
Table 5. LIGO AIR ADAPTER — LED status


== Configuration ==
== Configuration ==
Line 117: Line 207:


<gallery mode="packed" widths="250" heights="500">
<gallery mode="packed" widths="250" heights="500">
File:LIGO-BLE-Adapter-fig2-connection-section.png|Figure 1. Connection section
File:LIGO-BLE-Adapter-fig2-connection-section.png|Figure 2. Connection section
File:LIGO-BLE-Adapter-fig3-settings-section.png|Figure 2. Settings section
File:LIGO-BLE-Adapter-fig3-settings-section.png|Figure 3. Settings section
File:LIGO-BLE-Adapter-fig4-help-section.png|Figure 3. Help section
File:LIGO-BLE-Adapter-fig4-help-section.png|Figure 4. Help section
</gallery>
</gallery>


==== Connection section ====
==== Connection section ====


This section provides general information and real-time status of this device.
This section provides general information and real-time status of the device. It allows users to quickly verify that the adapter is powered, accessible, and ready for configuration.
 
Included information:


This section includes:
* Device name
* Device name.
* Device MAC address and serial number
* Device MAC address and serial number.
* Firmware / Hardware version
* Firmware/Hardware version.
* Fuel data of paired sensors
* Fuel data of paired sensors.
* Supply voltage and temperature
* Supply voltage and temperature.
* RSSI signal
* RSSI signal.


The Connection section allows users to quickly verify that the adapter is powered, accessible, and ready for configuration.
The Connection section allows users to quickly verify that the adapter is powered, accessible, and ready for configuration.
Line 138: Line 229:
==== Settings section ====
==== Settings section ====


The Settings section contains all configuration parameters related to sensor pairing, output interfaces, data type, …
The Settings section contains all configuration parameters related to sensor pairing, output interfaces, and data type. It is intended for device setup and integration with GPS tracking devices.
 
Key configuration functions:


Key configuration functions include:
* Sensor pairing management (add / remove sensors using MAC address)
* Sensor pairing management (add / remove sensors using MAC address)
* Output interface configuration (RS232, RS485, AF)
* Output interface configuration (RS232, RS485, AF)
Line 147: Line 239:
* Data log configuration and viewing
* Data log configuration and viewing
* Installation report generation
* Installation report generation
This section is intended for device setup and integration with GPS tracking devices.


==== Help section ====
==== Help section ====
Line 167: Line 257:
Follow these steps to pair Ligo Air/Ligo Air Pro sensors with LIGO AIR ADAPTER
Follow these steps to pair Ligo Air/Ligo Air Pro sensors with LIGO AIR ADAPTER


* Launch Ligo BLE Configurator application > Select LIGO AIR ADAPTER (the software auto scan nearby BLE Adapter) > press Connect button to the connect the target BLE Adapter.
* Launch Ligo BLE Configurator application > Select LIGO AIR ADAPTER (the software auto scan nearby BLE Adapter) > press Connect button
* Switch to Settings section to start pairing sensor to the LIGO AIR ADAPTER as Figure 4.
* Switch to Settings section to start pairing sensor to the LIGO AIR ADAPTER as Figure 4.


[[File:LIGO-BLE-Adapter-fig5-sensor-pairing.png|center|700px|thumb|Figure 4. Steps to pairing Ligo sensor to the BLE Adapter]]
[[File:LIGO-BLE-Adapter-fig5-sensor-pairing.png|center|700px|thumb|Figure 5. Steps to pairing Ligo sensor to the LIGO AIR ADAPTER]]


==== Parameters configuration ====
==== Parameters configuration ====


[[File:LIGO-BLE-Adapter-fig6-parameters.png|center|700px|thumb|Figure 5. Parameters configuration]]
[[File:LIGO-BLE-Adapter-fig6-parameters.png|center|700px|thumb|Figure 6. Parameters configuration]]


{| class="wikitable"
{| class="wikitable"
Line 208: Line 298:
|}
|}


''Table 2. Parameter descriptions of LIGO AIR ADAPTER''
Table 6. LIGO AIR ADAPTER — Parameter descriptions


== Operation ==
== Operation ==
Line 216: Line 306:
==== Data log ====
==== Data log ====


[[File:LIGO-BLE-Adapter-fig7-data-log.png|center|700px|thumb|Figure 6. Step to view data log]]
[[File:LIGO-BLE-Adapter-fig7-data-log.png|center|700px|thumb|Figure 7. Step to view data log]]


The Data Log function allows users to view historical fuel level data received from paired sensors over time.
The Data Log function allows users to view historical fuel level data received from paired sensors over time.
Line 237: Line 327:
==== Settings log ====
==== Settings log ====


[[File:LIGO-BLE-Adapter-fig8-settings-log.png|center|700px|thumb|Figure 7. Steps to view settings log]]
[[File:LIGO-BLE-Adapter-fig8-settings-log.png|center|700px|thumb|Figure 8. Steps to view settings log]]


The Settings Log function allows users to review the historical configuration records of the LIGO AIR ADAPTER.
The Settings Log function allows users to review the historical configuration records of the LIGO AIR ADAPTER.
Line 257: Line 347:
*Real installation photos captured via mobile device
*Real installation photos captured via mobile device


[[File:install-report.png|center|700px|thumb|Set Empty]]
[[File:install-report.png|center|700px|thumb|Figure 9. Installation report]]


===== Maintenance Report =====
===== Maintenance Report =====
Line 269: Line 359:
*Real installation photos captured via mobile device
*Real installation photos captured via mobile device


[[File:maintance-report.png|center|700px|thumb|Set Empty]]
[[File:maintance-report.png|center|700px|thumb|Figure 10. Maintenance report]]


===== View Report  =====
===== View Report  =====
Line 276: Line 366:
Steps to open reports:
Steps to open reports:


1. '''Open View Report''' in the Ligo BLE Configurator App.
* '''Open View Report''' in the Ligo BLE Configurator App.
 
* '''Enter the Adapter Serial Number (SN)''' and press the Search button.
2. '''Enter the Adapter Serial Number (SN)''' and press the Search button.


The system displays:
The system displays:
Line 284: Line 373:
*Maintenance reports
*Maintenance reports


[[File:view-report.png|center|700px|thumb|Set Empty]]
[[File:view-report.png|center|700px|thumb|Figure 11. View report]]


== Troubleshooting ==
== Troubleshooting ==
Line 300: Line 389:
| Incorrect fuel value || Wrong data mode || Check SUM / AVERAGE setting
| Incorrect fuel value || Wrong data mode || Check SUM / AVERAGE setting
|}
|}
Table 7. LIGO AIR ADAPTER — Troubleshooting


== Maintenance ==
== Maintenance ==
{| class="wikitable"
!Frequency
!Action
|-
|Monthly
|Confirm the status LED indicates normal operation, verify RSSI ≥ −80 dBm at receiver
|-
|Quarterly
|Inspect power and data wiring and the enclosure for looseness, corrosion, moisture, or physical damage.
|-
|Annually
|Full functional test and confirm end-to-end data flow to the GPS/telematics unit.
|}
Table 8. LIGO AIR ADAPTER — Maintenance


== Certification / Compliance ==
== Certification / Compliance ==
Line 321: Line 425:
| Website || [http://sojielectronics.com sojielectronics.com]
| Website || [http://sojielectronics.com sojielectronics.com]
|}
|}
 
Table 9. LIGO AIR ADAPTER — Support/ Contact<div class="noprint">
<div class="noprint">


== Related Documents ==
== Related Documents ==

Revision as of 04:04, 20 June 2026

Safety Information

ℹ️ NOTICE — Important notes during sensor installation
Read and understand all safety information in this document before installing, operating or servicing the LIGO AIR ADAPTER
  • Keep the device out of the reach of children. It is not a toy and contains small parts.
  • Do not modify, drill or otherwise alter the device.
  • Always disconnect power before wiring, connecting/disconnecting cables or servicing.
  • Connect the device only to a power source within the rated input voltage.

Product Overview

Scope

This document provides instructions for installation, configuration, operation, and basic troubleshooting of the LIGO AIR ADAPTER.

It is intended for system integrators, installers, and technical personnel involved in fuel monitoring and GPS telematics systems.

Product Overview

LIGO AIR ADAPTER is a communication and aggregation product designed to connect Ligo Air/Ligo Air Pro wireless fuel level sensors to GPS trackers that do not support BLE communication.

The device acts as:

  • A BLE to wired protocol bridge.
  • A Sensor Union Module (SUM) capable of aggregating data from multiple sensors.
  • A BLE signal receiver with enhanced sensitivity for extended wireless range.

LIGO AIR ADAPTER supports multiple output interfaces including RS232, RS485, and AF, ensuring compatibility with a wide range of GPS tracking devices.

System Architecture

Figure 1. LIGO AIR ADAPTER — System Architecture
  • Wireless fuel sensors (Ligo Air / Ligo Air Pro) transmit fuel level data via BLE.
  • LIGO AIR ADAPTER receives BLE data and processes it.
  • Processed data is transmitted to the GPS tracker via RS232, RS485 or AF interface.
  • Log sensor data for history view and troubleshooting.

Package Contents

No. Description Qty (pcs)
1 LIGO AIR ADAPTER 01
2 Quick user guide 01

Table 1. LIGO AIR ADAPTER — Package content

Specifications

No. PARAMETERS RS232 RS485 PRO AF
1 Dimension (without wire), mm 670x800
2 Output interface Digital Analog & Digital Analog
3 Baud rate, bit/sec 2400, 4800, 9600, 14400,

19200, 38400, 115200.

4 Power supply, VDC 7 – 36 VDC
5 Maximum power consumption ~15 mA @13.5VDC
6 Power supply protection 1000VDC reverse polarity protection
7 Operating temperature, °C -40 to 85 °C
8 Waterproof standard IP67
9 Output value range Digital Digital and analog Analog (0-10V)
10 Data output mode SUM, AVERAGE, INDIVIDUAL
11 Bluetooth specs BLE 5.2
12 Average service life, years (expected) 8 years

Table 2. LIGO AIR ADAPTER — Detail specifications

Installation

Hardware description and installation

Cable and wire definition

No. Wire Color Wire Name Description
1
RED
VCC Power supply (7–36 V DC)
2
WHITE
AF Analog output (0–10 V)
3
BLACK
GND Ground
4
GREEN
RS485-B Signal wire B for RS485
5
YELLOW
RS485-A Signal wire A for RS485
6
BLACK
GND Ground
7
BROWN
RS232-RX Input data for RS232
8
BLUE
RS232-TX Output data for RS232

Table 3. LIGO AIR ADAPTER — Cable description

Mechanical installation

  • Install Ligo Adapter inside the vehicle cabin or protected enclosure
  • Avoid direct exposure to water, excessive heat, or strong electromagnetic sources
  • Ensure sufficient distance from high-current cables when possible

Electrical connection

Connect the selected communication interface to the GPS tracker following the table below:

No. Wire Name RS232 RS485 AF PRO
1 VCC
2 AF
3 GND
4 RS485-B
5 RS485-A
6 GND
7 RS232-RX
8 RS232-TX

Table 4. LIGO AIR ADAPTER — Wiring connection

ℹ️ NOTICE — Protocol Connection

The PRO model supports all available output communication protocols (RS232, RS485 and AF). Select the output interface compatible with the existing GPS tracker.

LED Status Indication

The Ligo Adapter is equipped with a status LED to indicate its current operating state.

LED Status Description
Red blinking No sensor is paired with the adapter
Red solid Sensor(s) paired, but no data is being received
Green solid Valid data is being received from paired sensor(s)

Table 5. LIGO AIR ADAPTER — LED status

Configuration

Software configuration

LIGO AIR ADAPTER is configured using Ligo BLE Configurator. Please download and install it from Play Store on android OS or App Store on IOS before starting configurations.

The software is structured into three main sections, each serving a specific purpose in the installation, operation and troubleshooting as these below figures.

Connection section

This section provides general information and real-time status of the device. It allows users to quickly verify that the adapter is powered, accessible, and ready for configuration.

Included information:

  • Device name
  • Device MAC address and serial number
  • Firmware / Hardware version
  • Fuel data of paired sensors
  • Supply voltage and temperature
  • RSSI signal

The Connection section allows users to quickly verify that the adapter is powered, accessible, and ready for configuration.

Settings section

The Settings section contains all configuration parameters related to sensor pairing, output interfaces, and data type. It is intended for device setup and integration with GPS tracking devices.

Key configuration functions:

  • Sensor pairing management (add / remove sensors using MAC address)
  • Output interface configuration (RS232, RS485, AF)
  • Communication protocol
  • Data mode selection (SUM, AVERAGE, INDIVIDUAL)
  • Data log configuration and viewing
  • Installation report generation

Help section

The Support section provides technical assistance and software information.

This section includes:

  • Software version
  • Technical support contact information
  • Reference documentation and troubleshooting resources

This section ensures that users can easily access assistance if necessary.

Sensor pairing and configuration

Sensor pairing

Follow these steps to pair Ligo Air/Ligo Air Pro sensors with LIGO AIR ADAPTER

  • Launch Ligo BLE Configurator application > Select LIGO AIR ADAPTER (the software auto scan nearby BLE Adapter) > press Connect button
  • Switch to Settings section to start pairing sensor to the LIGO AIR ADAPTER as Figure 4.
Error creating thumbnail: Unable to save thumbnail to destination
Figure 5. Steps to pairing Ligo sensor to the LIGO AIR ADAPTER

Parameters configuration

Error creating thumbnail: Unable to save thumbnail to destination
Figure 6. Parameters configuration
No. Parameter Description
1 Message interval (1..60s) Defines the time interval between two consecutive data transmissions from the LIGO AIR ADAPTER
2 Protocol Selects the output communication protocol used to transmit fuel data to the GPS tracker.
  • SOJI protocol
  • LLS protocol
3 Automatic transmission mode Defines the data transmission format.
  • HEX format
  • ASCII format
4 Baud rate Sets the serial communication speed for RS232 or RS485 output.
5 Data mode Defines how fuel data from multiple paired sensors is processed before transmission.
  • SUM: Total fuel value of all paired sensors
  • AVERAGE: Average fuel value of all paired sensors
  • INDIVIDUAL: Fuel data from each sensor is transmitted individually upon Modbus request.
6 Address (1-254) Sets the Modbus address of the LIGO AIR ADAPTER.
7 Level min (0..8V) Defines the minimum output voltage level for the AF output.
8 Level max (2..10V) Defines the maximum output voltage level for the AF output.
9 Max volume Defines the maximum digital fuel level resolution used for data transmission.
  • 1023: 10-bit resolution.
  • 4095: 12-bit resolution.

Table 6. LIGO AIR ADAPTER — Parameter descriptions

Operation

Data log and settings log

Data log

Error creating thumbnail: Unable to save thumbnail to destination
Figure 7. Step to view data log

The Data Log function allows users to view historical fuel level data received from paired sensors over time.

The log records:

  • Timestamp of received data
  • Fuel level values from paired sensors
  • RSSI signal
  • Temperature of sensor

This function is used for:

  • System verification during installation
  • Diagnostic and troubleshooting purposes
  • Validation of sensor communication stability

The user can select a time period (Today, Yesterday, Week, Month, or a Custom Period) and then press the Download button to retrieve the data log, as shown in Figure 6.

The retrieved data log is displayed in the Log Display Area.

Settings log

Error creating thumbnail: Unable to save thumbnail to destination
Figure 8. Steps to view settings log

The Settings Log function allows users to review the historical configuration records of the LIGO AIR ADAPTER.

This log stores all parameter changes previously configured by the user, enabling traceability and verification of device setup.

The user can select the Log source (data from EEPROM or data on the server), and the settings log will be displayed in the Log Display Area, as shown in Figure 7.

Report

Installation Report

Each installation report includes:

  • Installer Name
  • Installation Date and Time
  • Serial Number of Adapter (SN)
  • Model: Vehicle Information
  • Plate number: License of vehicle
  • Other information
  • Real installation photos captured via mobile device
Error creating thumbnail: Unable to save thumbnail to destination
Figure 9. Installation report
Maintenance Report

Each maintenance report includes:

  • Installer Name
  • Maintenance Date and Time
  • Serial Number of Adapter (SN)
  • Model: Vehicle Information
  • Plate number: License of vehicle
  • Other information
  • Real installation photos captured via mobile device
Error creating thumbnail: Unable to save thumbnail to destination
Figure 10. Maintenance report
View Report

The View Report function allows users to review installation and maintenance history at any time.

Steps to open reports:

  • Open View Report in the Ligo BLE Configurator App.
  • Enter the Adapter Serial Number (SN) and press the Search button.

The system displays:

  • Installation reports
  • Maintenance reports
Error creating thumbnail: Unable to save thumbnail to destination
Figure 11. View report

Troubleshooting

Issue Possible Cause Recommended Action
No data on GPS Incorrect wiring Verify interface wiring
Sensor not detected MAC address not added Reconfigure sensor list
Unstable data BLE signal attenuation Reposition adapter
Incorrect fuel value Wrong data mode Check SUM / AVERAGE setting

Table 7. LIGO AIR ADAPTER — Troubleshooting

Maintenance

Frequency Action
Monthly Confirm the status LED indicates normal operation, verify RSSI ≥ −80 dBm at receiver
Quarterly Inspect power and data wiring and the enclosure for looseness, corrosion, moisture, or physical damage.
Annually Full functional test and confirm end-to-end data flow to the GPS/telematics unit.

Table 8. LIGO AIR ADAPTER — Maintenance

Certification / Compliance

Support / Contact

Channel Detail
Company SOJI ELECTRONICS.,JSC
Address C50-LK13, Lot No. 09, New Urban Area, Le Trong Tan street, Duong Noi Ward, Ha Dong District, Hanoi City, Vietnam
Tel/Fax +84 24 62 932 369
Email contact@sojielectronics.com
Website sojielectronics.com

Table 9. LIGO AIR ADAPTER — Support/ Contact

Revision History

Loading revision history...

SOJI Electronics