Jump to content

LIGO AIR ADAPTER User Guide: Difference between revisions

From SOJI ELECTRONICS
[checked revision][checked revision]
← Older editNewer edit →
Admin (talk | contribs)
Bureaucrats, Interface administrators, Administrators
2,029 edits
VisualWikitext
Update
Line 1: Line 1:
== Safety Information ==
== Safety Information ==


''Detailed safety information was not specified in the source user guide (LIGO BLE Adapter User Guide). The general guidance below applies to all installations:''
== Product Overview ==


{{Warning|title=Installation Safety|body=
=== Scope ===
* Install LIGO BLE Adapter inside the vehicle cabin or a protected enclosure.
* Avoid direct exposure to water, excessive heat, or strong electromagnetic sources.
* Ensure sufficient distance from high-current cables when possible.
* '''Verify wiring before powering on''' the system to avoid damaging the adapter or connected GPS tracker.
}}


== Product Overview ==
This document provides instructions for installation, configuration, operation, and basic troubleshooting of the Ligo BLE Adapter.
 
It is intended for system integrators, installers, and technical personnel involved in fuel monitoring and GPS telematics systems.


'''Scope:''' This document provides instructions for installation, configuration, operation, and basic troubleshooting of the LIGO BLE Adapter. It is intended for system integrators, installers, and technical personnel involved in fuel monitoring and GPS telematics systems.
=== Product Overview ===


LIGO BLE 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.
Ligo BLE 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:
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 BLE Adapter supports multiple output interfaces including '''RS232, RS485, and AF''', ensuring compatibility with a wide range of GPS tracking devices.
Ligo BLE 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:LIGO-BLE-Adapter-fig1-system-architecture.png|center|700px|thumb|Figure 1. LIGO BLE Adapter wiring diagram]]
[[File:LIGO-BLE-Adapter-fig1-system-architecture.png|center|700px|thumb|Figure 1. Ligo BLE Adapter wiring diagram]]


* 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 BLE Adapter receives BLE data and processes it.
* Ligo BLE 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 ==
''Package contents were not specified in the source user guide (LIGO BLE Adapter User Guide). Refer to the [[LIGO BLE Adapter Datasheet]] or contact manufacturer for the latest package list.''


== Specifications ==
== Specifications ==


''Detailed technical specifications were not included in this user guide. Refer to the [[LIGO BLE Adapter Datasheet]] for full parameters (power supply, dimensions, output range, etc.).''
== Installation ==


== Installation ==
=== Hardware description and installation ===


=== Cable and Wire Definition ===
==== Cable and wire definition ====


{| class="wikitable" style="text-align:center;"
{| class="wikitable" style="text-align:center;"
|-
|-
! No. !! Wire Colour !! Function !! Description
! No. !! Wire color !! Description
|-
|-
| 1 || style="background:#E53935;color:#fff;font-weight:bold;" | RED || VCC || style="text-align:left;" | Power supply (7 – 36 V DC)
| 1 || style="background:#E53935;color:#fff;font-weight:bold;" | VCC || style="text-align:left;" | Power supply (7 – 36V DC)
|-
|-
| 2 || style="background:#fafafa;color:#000;font-weight:bold;border:1px solid #999;" | WHITE || AF || style="text-align:left;" | Analog output (1 – 9 V)
| 2 || style="background:#fafafa;color:#000;font-weight:bold;border:1px solid #999;" | AF || style="text-align:left;" | Analog output (1 – 9V)
|-
|-
| 3 || style="background:#1a1a1a;color:#fff;font-weight:bold;" | BLACK || GND || style="text-align:left;" | Ground
| 3 || style="background:#1a1a1a;color:#fff;font-weight:bold;" | GND || style="text-align:left;" | Ground
|-
|-
| 4 || style="background:#43A047;color:#fff;font-weight:bold;" | GREEN || RS485-B || style="text-align:left;" | Signal wire B for RS485
| 4 || style="background:#43A047;color:#fff;font-weight:bold;" | RS485-B || style="text-align:left;" | Signal wire B for RS485
|-
|-
| 5 || style="background:#FFD700;color:#000;font-weight:bold;" | YELLOW || RS485-A || style="text-align:left;" | Signal wire A for RS485
| 5 || style="background:#FFD700;color:#000;font-weight:bold;" | RS485-A || style="text-align:left;" | Signal wire A for RS485
|-
|-
| 6 || style="background:#1a1a1a;color:#fff;font-weight:bold;" | BLACK || GND || style="text-align:left;" | Ground
| 6 || style="background:#1a1a1a;color:#fff;font-weight:bold;" | GND || style="text-align:left;" | Ground
|-
|-
| 7 || style="background:#6D4C41;color:#fff;font-weight:bold;" | BROWN || RS232-RX || style="text-align:left;" | Input data for RS232
| 7 || style="background:#6D4C41;color:#fff;font-weight:bold;" | RS232-RX || style="text-align:left;" | Input data for RS232
|-
|-
| 8 || style="background:#1E88E5;color:#fff;font-weight:bold;" | BLUE || RS232-TX || style="text-align:left;" | Output data for RS232
| 8 || style="background:#1E88E5;color:#fff;font-weight:bold;" | RS232-TX || style="text-align:left;" | Output data for RS232
|}
|}


''Table 1. LIGO BLE Adapter wire color and function.''
''Table 1. Ligo BLE Adapter wire color and function''


=== Mechanical Installation ===
==== Mechanical installation ====


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


=== Electrical Connection ===
==== Electrical connection ====


# Connect '''VCC (Red)''' and '''GND (Black)''' to the power source.
# Connect VCC (Red) and GND (Black) to the power source
# Connect selected communication interface to the GPS tracker:
# Connect selected communication interface to the GPS tracker:
#* '''With LIGO BLE Adapter – RS232:'''
#* With Ligo BLE Adapter – RS232:
#** '''Brown (RX)''' to '''Tx''' of GPS tracker.
#*: Brown (RX) to Tx of GPS tracker
#** '''Blue (TX)''' to '''Rx''' of GPS tracker.
#*: Blue (TX) to Rx of GPS tracker
#* '''With LIGO BLE Adapter – RS485:'''
#* With Ligo BLE Adapter – RS485:
#** '''Yellow (RS485-A)''' connect to '''RS485-A''' of GPS tracker.
#*: Yellow (RS485-A) connect to RS485-A of GPS tracker
#** '''Green (RS485-B)''' connect to '''RS485-B''' of GPS tracker.
#*: Green (RS485-B) connect to RS485-B of GPS tracker
#* '''With LIGO BLE Adapter – AF:'''
#* With Ligo BLE Adapter – AF:
#** '''White (AF output)''' connect to '''Analog input''' of GPS tracker.
#*: White (AF output) connect to Analog input of GPS tracker
#* '''With LIGO BLE Adapter – PRO:'''
#* With Ligo BLE Adapter – PRO:
#** You can choose one of the above interfaces to connect to GPS tracker.
#*: You can choose one of these above interfaces to connect to GPS tracker
# '''Verify wiring before powering on''' the system.
# Verify wiring before powering on the system


== Configuration ==
== Configuration ==


LIGO BLE Adapter is configured using '''LIGO BLE Configurator''' app. Please download and install it from Play Store (Android) or App Store (iOS) before starting configurations.
=== Software configuration ===


The software is structured into three main sections, each serving a specific purpose in installation, operation and troubleshooting.
Ligo BLE 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.


<gallery mode="packed" widths="250" heights="500" caption="">
The software is structured into three main sections, each serving a specific purpose in the installation, operation and troubleshooting as these below figures.
 
<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 1. Connection section
File:LIGO-BLE-Adapter-fig3-settings-section.png|Figure 2. Settings section
File:LIGO-BLE-Adapter-fig3-settings-section.png|Figure 2. Settings section
Line 101: Line 98:
</gallery>
</gallery>


=== Connection Section ===
==== Connection section ====


This section provides general information and real-time status of this device. It includes:
This section provides general information and real-time status of this device.
 
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.
Line 113: Line 112:
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.


=== Settings Section ===
==== Settings section ====


The Settings section contains all configuration parameters related to sensor pairing, output interfaces, data type, etc. Key configuration functions include:
The Settings section contains all configuration parameters related to sensor pairing, output interfaces, data type, …
* Sensor pairing management (add / remove sensors using MAC address).
 
* Output interface configuration (RS232, RS485, AF).
Key configuration functions include:
* Communication protocol.
* Sensor pairing management (add / remove sensors using MAC address)
* Data mode selection (SUM, AVERAGE, INDIVIDUAL).
* Output interface configuration (RS232, RS485, AF)
* Data log configuration and viewing.
* Communication protocol
* Installation report generation.
* Data mode selection (SUM, AVERAGE, INDIVIDUAL)
* Data log configuration and viewing
* Installation report generation


This section is intended for device setup and integration with GPS tracking devices.
This section is intended for device setup and integration with GPS tracking devices.


=== Help Section ===
==== Help section ====
 
The Support section provides technical assistance and software information.


The Support section provides technical assistance and software information. It includes:
This section includes:
* Software version.
* Software version
* Technical support contact information.
* Technical support contact information
* Reference documentation and troubleshooting resources.
* Reference documentation and troubleshooting resources


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


=== Sensor Pairing ===
=== Sensor pairing and configuration ===
 
==== Sensor pairing ====


Follow these steps to pair LIGO Air / LIGO Air Pro sensors with LIGO BLE Adapter:
Follow these steps to pair Ligo Air/Ligo Air Pro sensors with Ligo BLE Adapter


# Launch LIGO BLE Configurator application → Select '''LIGO BLE ADAPTER''' (the software auto-scans nearby BLE Adapters) → press '''Connect''' button to connect to the target BLE Adapter.
* Launch Ligo BLE Configurator application > Select LIGO BLE ADAPTER (the software auto scan nearby BLE Adapter) > press Connect button to the connect the target BLE Adapter.
# Switch to the '''Settings''' section to start pairing the sensor with the LIGO BLE Adapter as shown in Figure 5.
* Switch to Settings section to start pairing sensor to the Ligo BLE Adapter as Figure 4.


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


=== Parameters Configuration ===
==== Parameters configuration ====


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


{| class="wikitable"
{| class="wikitable"
Line 151: Line 156:
! No. !! Parameter !! Description
! No. !! Parameter !! Description
|-
|-
| style="text-align:center;" | 1 || Message interval (1…60 s) || Defines the time interval between two consecutive data transmissions from the LIGO BLE Adapter.
| style="text-align:center;" | 1 || Message interval (1..60s) || Defines the time interval between two consecutive data transmissions from the Ligo BLE Adapter
|-
|-
| style="text-align:center;" | 2 || Protocol || Selects the output communication protocol used to transmit fuel data to the GPS tracker:
| style="text-align:center;" | 2 || Protocol || Selects the output communication protocol used to transmit fuel data to the GPS tracker.
* SOJI protocol
* SOJI protocol
* LLS protocol
* LLS protocol
|-
|-
| style="text-align:center;" | 3 || Automatic transmission mode || Defines the data transmission format:
| style="text-align:center;" | 3 || Automatic transmission mode || Defines the data transmission format.
* HEX format
* HEX format
* ASCII format
* ASCII format
Line 163: Line 168:
| style="text-align:center;" | 4 || Baud rate || Sets the serial communication speed for RS232 or RS485 output.
| style="text-align:center;" | 4 || Baud rate || Sets the serial communication speed for RS232 or RS485 output.
|-
|-
| style="text-align:center;" | 5 || Data mode || Defines how fuel data from multiple paired sensors is processed before transmission:
| style="text-align:center;" | 5 || Data mode || Defines how fuel data from multiple paired sensors is processed before transmission.
* '''SUM''' — Total fuel value of all paired sensors.
* SUM: Total fuel value of all paired sensors
* '''AVERAGE''' — Average 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.
* INDIVIDUAL: Fuel data from each sensor is transmitted individually upon Modbus request.
|-
|-
| style="text-align:center;" | 6 || Address (1–254) || Sets the Modbus address of the LIGO BLE Adapter.
| style="text-align:center;" | 6 || Address (1-254) || Sets the Modbus address of the Ligo BLE Adapter.
|-
|-
| style="text-align:center;" | 7 || Level min (0…8 V) || Defines the minimum output voltage level for the AF output.
| style="text-align:center;" | 7 || Level min (0..8V) || Defines the minimum output voltage level for the AF output.
|-
|-
| style="text-align:center;" | 8 || Level max (2…10 V) || Defines the maximum output voltage level for the AF output.
| style="text-align:center;" | 8 || Level max (2..10V) || Defines the maximum output voltage level for the AF output.
|-
|-
| style="text-align:center;" | 9 || Max volume || Defines the maximum digital fuel level resolution used for data transmission:
| style="text-align:center;" | 9 || Max volume || Defines the maximum digital fuel level resolution used for data transmission.
* '''1023''' — 10-bit resolution.
* 1023: 10-bit resolution.
* '''4095''' — 12-bit resolution.
* 4095: 12-bit resolution.
|}
|}


''Table 2. Parameter descriptions of LIGO BLE Adapter.''
''Table 2. Parameter descriptions of Ligo BLE Adapter''


== Operation ==
== Operation ==


=== Data Log ===
=== Data log and settings log ===


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


The Data Log function allows users to view historical fuel level data received from paired sensors over time. The log records:
[[File:LIGO-BLE-Adapter-fig7-data-log.png|center|700px|thumb|Figure 6. Step to view data log]]
* Timestamp of received data.
 
* Fuel level values from paired sensors.
The Data Log function allows users to view historical fuel level data received from paired sensors over time.
* RSSI signal.
 
* Temperature of sensor.
The log records:
* Timestamp of received data
* Fuel level values from paired sensors
* RSSI signal
* Temperature of sensor


This function is used for:
This function is used for:
* System verification during installation.
* System verification during installation
* Diagnostic and troubleshooting purposes.
* Diagnostic and troubleshooting purposes
* Validation of sensor communication stability.
* 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.


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 7. The retrieved data log is displayed in the Log Display Area.
==== 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 BLE Adapter.


The Settings Log function allows users to review the historical configuration records of the LIGO BLE Adapter. This log stores all parameter changes previously configured by the user, enabling traceability and verification of device setup.
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 8.
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.


=== LED Status Indication ===
=== LED Status Indication ===


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


{| class="wikitable"
{| class="wikitable"
Line 216: Line 229:
! LED Status !! Description
! LED Status !! Description
|-
|-
| style="text-align:center;" | Red blinking || No sensor is paired with the adapter.
| style="text-align:center;" | Red blinking || No sensor is paired with the adapter
|-
|-
| style="text-align:center;" | Red solid || Sensor(s) paired, but no data is being received.
| style="text-align:center;" | Red solid || Sensor(s) paired, but no data is being received
|-
|-
| 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)
|}
|}


Line 229: Line 242:
! Issue !! Possible Cause !! Recommended Action
! Issue !! Possible Cause !! Recommended Action
|-
|-
| No data on GPS || Incorrect wiring || Verify interface wiring.
| No data on GPS || Incorrect wiring || Verify interface wiring
|-
|-
| Sensor not detected || MAC address not added || Reconfigure sensor list.
| Sensor not detected || MAC address not added || Reconfigure sensor list
|-
|-
| Unstable data || BLE signal attenuation || Reposition adapter.
| Unstable data || BLE signal attenuation || Reposition adapter
|-
|-
| Incorrect fuel value || Wrong data mode || Check SUM / AVERAGE setting.
| Incorrect fuel value || Wrong data mode || Check SUM / AVERAGE setting
|}
|}
If problem persists, contact [[#Support / Contact|Support]].


== Maintenance ==
== Maintenance ==
''Detailed maintenance procedures were not specified in the source user guide. General recommendations:''
* Periodically inspect wire connections for corrosion or damage.
* Ensure the adapter remains in a protected enclosure, away from water and excessive heat.
* Verify LED status periodically — solid green indicates healthy operation.
* Use the Data Log function for routine validation of sensor communication stability.


== Certification / Compliance ==
== Certification / Compliance ==
''No certification or compliance information was provided in the source user guide (LIGO BLE Adapter User Guide). Refer to [[Product Certification & Approvals]] for current certificate status.''


== Support / Contact ==
== Support / Contact ==

Revision as of 03:47, 11 June 2026

Safety Information

Product Overview

Scope

This document provides instructions for installation, configuration, operation, and basic troubleshooting of the Ligo BLE Adapter.

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

Product Overview

Ligo BLE 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 BLE Adapter supports multiple output interfaces including RS232, RS485, and AF, ensuring compatibility with a wide range of GPS tracking devices.

System Architecture

Error creating thumbnail: Unable to save thumbnail to destination
Figure 1. Ligo BLE Adapter wiring diagram
  • Wireless fuel sensors (Ligo Air / Ligo Air Pro) transmit fuel level data via BLE
  • Ligo BLE 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

Specifications

Installation

Hardware description and installation

Cable and wire definition

No. Wire color Description
1 VCC Power supply (7 – 36V DC)
2 AF Analog output (1 – 9V)
3 GND Ground
4 RS485-B Signal wire B for RS485
5 RS485-A Signal wire A for RS485
6 GND Ground
7 RS232-RX Input data for RS232
8 RS232-TX Output data for RS232

Table 1. Ligo BLE Adapter wire color and function

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

  1. Connect VCC (Red) and GND (Black) to the power source
  2. Connect selected communication interface to the GPS tracker:
    • With Ligo BLE Adapter – RS232:
      Brown (RX) to Tx of GPS tracker
      Blue (TX) to Rx of GPS tracker
    • With Ligo BLE Adapter – RS485:
      Yellow (RS485-A) connect to RS485-A of GPS tracker
      Green (RS485-B) connect to RS485-B of GPS tracker
    • With Ligo BLE Adapter – AF:
      White (AF output) connect to Analog input of GPS tracker
    • With Ligo BLE Adapter – PRO:
      You can choose one of these above interfaces to connect to GPS tracker
  3. Verify wiring before powering on the system

Configuration

Software configuration

Ligo BLE 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.

  • Figure 1. Connection section
    Figure 1. Connection section
  • Figure 2. Settings section
    Figure 2. Settings section
  • Figure 3. Help section
    Figure 3. Help section

Connection section

This section provides general information and real-time status of this device.

This section includes:

  • 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, data type, …

Key configuration functions include:

  • 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

This section is intended for device setup and integration with GPS tracking devices.

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 BLE Adapter

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

Parameters configuration

Error creating thumbnail: Unable to save thumbnail to destination
Figure 5. Parameters configuration
No. Parameter Description
1 Message interval (1..60s) Defines the time interval between two consecutive data transmissions from the Ligo BLE 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 BLE 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 2. Parameter descriptions of Ligo BLE Adapter

Operation

Data log and settings log

Data log

Error creating thumbnail: Unable to save thumbnail to destination
Figure 6. 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 7. Steps to view settings log

The Settings Log function allows users to review the historical configuration records of the Ligo BLE 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.

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)

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

Maintenance

Certification / Compliance

Support / Contact

Channel Detail
Company SOJI ELECTRONICS JOINT STOCK COMPANY
Address NO-04, LK-03 Ha Tri, Ha Cau, Ha Dong, Hanoi, Vietnam
Tel/Fax +84 24 62 932 369
Email contact@sojielectronics.com
Website sojielectronics.com

Cross-references to other documents.

Revision History

Loading revision history...

SOJI Electronics
Retrieved from "https://wiki.sojielectronics.com/index.php?title=LIGO_AIR_ADAPTER_User_Guide&oldid=1522"