Escort Knowledge Base

Teltonika-BLE: Difference between revisions

Page Discussion

Teltonika-BLE (view source)

Revision as of 13:09, 4 March 2026

1,018 bytes removed ,  3 months ago
→‎Lost Connection
VisualWikitext
Line 8: Line 8:
* Up to 4 sensors can be connected to the majority of different Teltonika models via Bluetooth
* Up to 4 sensors can be connected to the majority of different Teltonika models via Bluetooth
* In case your tracker has the Rs485 port, the sensors can be connected to such tracker by means of the BLE-Rs485 adapter (also called ‘'''base'''’ sometimes)
* In case your tracker has the Rs485 port, the sensors can be connected to such tracker by means of the BLE-Rs485 adapter (also called ‘'''base'''’ sometimes)
1.Before connecting the sensor, find '''its MAC address''' via Escort app for Android devices (Apple devices don’t give access to MAC addresses of any devices) or directly on the sensor’s body (Fig.1 and Fig.2).
Before connecting the sensor, find '''its MAC address''' via Escort app for Android devices (Apple devices don’t give access to MAC addresses of any devices) or directly on the sensor’s body.
{| class="wikitable"
{| class="wikitable"
|[[File:Imageфсы.png|frameless]]
|[[File:Imageфсы.png|frameless]]
|[[File:Imagesbsb.png|353x353px]]
|[[File:Imagesbsb.png|353x353px]]
|-
|-
|Fig.1 MAC address in the app
|MAC address in the app
|Fig.2 MAC address on the sensor’s head
|MAC address on the sensor’s head
|}
|}
2. In the Teltonika configurator, go to the '''Bluetooth''' tab first. Make sure  that everything is configured as shown on the Fig. 3 below
 
== Bluetooth and Bluetooth 4.0 tabs (entering MAC address, BLA Scan settings) ==
In the Teltonika configurator, go to the '''Bluetooth''' tab first. Make sure  that everything is configured as shown on the figure below


[[File:Photo 5418063427176959105 x.jpg|frameless|408x408px]]
[[File:Photo 5418063427176959105 x.jpg|frameless|408x408px]]
Line 22: Line 24:




3. On the    '''Bluetooth 4.0 tab''' (Fig. 4),    configure '''the''' '''BLE Scan settings''' as follows:
On the    '''Bluetooth 4.0 tab''',    configure '''the''' '''BLE Scan settings''' as follows:


-         disable the '''Non Stop Scan'''
-         disable the '''Non Stop Scan'''
Line 38: Line 40:




Further below you have 4 '''Connection slots''' to pair up to 4 sensors (those can be any TD, DU or TH sensors). Click on the '''Advanced''' button and then '''enter the MAC address''' of the sensor.




4. Further below you have 4 '''Connection slots''' to connect up to    4 sensors (those can be any TD, DU or TL sensors). Click on the '''Advanced''' button and then '''enter the MAC address''' of the sensor (Fig. 4).






[[File:Photo 5418063427176959106 xs.jpg|frameless|495x495px]]


[[File:Photo 5418063427176959106 xs.jpg|frameless|495x495px]]




== Bluetooth 4.0 tab (Preset selection) ==


5.Then, click on the '''preset button''' (Fig. 5) and select '''the preset required for a certain sensor model''' and click on the '''Load''' button (Fig. 6):
Then, click on the '''preset button''' and select '''the preset required for a certain sensor model''' and click on the '''Load''' button :


-         “escort fuel” for TD-BLE,
-         “escort fuel” for TD-BLE,


-         “escort luminosity” or “escort temperature” for TL-BLE, “Escort_DU-BLE_Angle_sensor” for DU-BLE
-         “escort luminosity” or “escort temperature” for TH-BLE, “Escort_DU-BLE_Angle_sensor” for DU-BLE




Line 63: Line 66:


== I/O tab settings ==
== I/O tab settings ==
6. Next, go to the I/O tab (Fig. 7) and select the '''Low option in the Priority column''' for the '''BLE Fuel Level''' and '''BLE Temperature''' (BLE Battery Charge is optional) parameters for TD or    TL-BLE sensors (luminosity = fuel level).
Next, go to the I/O tab and select the '''Low option in the Priority column''' for the '''BLE Fuel Level''' and '''BLE Temperature''' (BLE Battery Charge is optional) parameters for TD.


In case of a DU-BLE, you may want to set the '''Operand''' option to the '''On Change''' and configure the '''Event Only''' option as '''Yes''' for the BLE Temperature parameter that corresponds to the Event notification sent by the sensor. Then, whenever the '''sensor’s Event Notification''' changes (it might be happening every time the tap of a hatch is opened, for example), the tracker will transmit an extra message to the server immediately upon receiving a new Event Notification.
In case of a DU-BLE, you may want to set the '''Operand''' option to the '''On Change''' for the BLE Temperature parameter that corresponds to the Event notification sent by the sensor. Then, whenever the '''sensor’s Event Notification''' changes (it might be happening every time the tap of a hatch is opened, for example), the tracker will transmit an extra message to the server immediately upon receiving a new Event Notification.




Line 71: Line 74:
[[File:Photo 5418063427176959112 x.jpg|frameless|700x700px]]
[[File:Photo 5418063427176959112 x.jpg|frameless|700x700px]]


Fig. 7 I/O tab


To find the io_ you need on the monitoring platform, check the following table:


[[File:Photo 5418063427176959113 x.jpg|frameless|700x700px]]


To find the io_ you need on the monitoring platform, check the following table:
[[File:Таблица данных на телтонику.png|809x809px]]


[[File:Photo 5418063427176959113 x.jpg|frameless|700x700px]]
== System settings (Codec 8 Extended) ==
In the '''System''' tab, click on the '''Codec 8 Extended''' option.


== System settings ==
7.In the '''System''' tab, click on the '''Codec 8 Extended''' option (Fig. 8)




Line 86: Line 89:
[[File:Photo 5418063427176959114 x.jpg|frameless|635x635px]]
[[File:Photo 5418063427176959114 x.jpg|frameless|635x635px]]


Fig. 8 System. Data Protocol. Codec 8 Extended
System. Data Protocol. Codec 8 Extended


8. When  selecting the installation spot for the tracker, check the '''RSSI (Signal Strength)''' in the     Bluetooth 4.0 tab by clicking on the '''Discover     BLE''' button during 2-3 minutes (Fig. 9).
== RSSI check ==
When  selecting the installation spot for the tracker, check the '''RSSI (Signal Strength)''' in the Bluetooth 4.0 tab by clicking on the '''Discover BLE''' button during 2-3 minutes.




The average value must be from '''-45 to -85 dB''' for optimal connection stability.
The average value must be from '''-45 to -85 dB''' for optimal connection stability.


[[File:Photo 5418063427176959116 x.jpg|frameless|570x570px]]                                              Fig. 9 Checking RSSI is vital
[[File:Photo 5418063427176959116 x.jpg|frameless|570x570px]]                                              Checking RSSI is vital
 
 
 


 
== Antenna orientation ==
9. Remember to orient the sensor with the tracker so that the sensor’s and the tracker’s Bluetooth antenna were facing each other (Fig. 10)
Remember to orient the sensor with the tracker so that the sensor’s and the tracker’s Bluetooth antenna were facing each other.




Line 105: Line 106:
[[File:Antenna direction.png]]
[[File:Antenna direction.png]]


Fig. 10 Sensor and tracker orientation (applicable to both TD-BLE and DU-BLE models)
Sensor and tracker orientation (applicable to TD-BLE, DU-BLE, TH-BLE models)
 
 
 
10. The “io_” parameters (Fig. 11) you need  to find in the tracker’s messages on the platform are as follows:
 
== [[File:Photo 5418063427176959129 x.jpg|frameless|523x523px]] ==
Fig. 11 Connections and IO list






11. Remember    to click on the '''Save to device'''    button after changing any configurations in the Teltonika configurator to  apply the changes.
== Saving changes ==
Remember    to click on the '''Save to device'''    button after changing any configurations in the Teltonika configurator to  apply the changes.


[[File:Photo 5418063427176959118 x.jpg|frameless|573x573px]]
[[File:Photo 5418063427176959118 x.jpg|frameless|573x573px]]


Fig. 12 Saving the changes
Saving the changes




Line 223: Line 218:
[[File:Photo 5418063427176959131 x.jpg]]
[[File:Photo 5418063427176959131 x.jpg]]


[[File:Таблица данных на телтонику.png]]
Fig. 22 io_ list (partial)




Line 242: Line 234:




= Connecting TH-BLE via Rs485-BLE adapter/base =
The TH-BLE sensor can be connected to any Teltonika only via the BLE-Rs485 adapter (as of 1<sup>st</sup> of July, 2021).
The sensor transmits several parameters. Their list varies from one (earlier release) version to the other (newer release) version.
They are: '''atmospheric pressure''' (earlier release only), '''temperature''', '''humidity''', '''luminosity''' (newer release only), '''battery charge'''.
The RSSI parameter is calculated by the BLE-Rs485 adapter. It is not transmitted by the sensor.
In case of a TH-BLE, the adapter/base can use up to 2 addresses to channel the data that comes from the sensor.
Depending on the preset you select, the order in which the parameters are transmitted to the tracker changes (Fig. 25 and 26).
[[File:Photo 5418063427176959135 x.jpg]]
[[File:Photo 5418063427176959136 x.jpg]]
Fig. 25 Selecting preset
Fig. 26 Parameters transmitted via addresses 1 and 2


= BLE Fuel Level missing in I/O =
= BLE Fuel Level missing in I/O =
'''If you cannot find the BLE Fuel Level parameter in the I/O tab''' of a newer version of Teltonika configurator, please, use one of the old ones available via the links below.
'''If you cannot find the BLE Fuel Level parameter in the I/O tab''' of a newer version of Teltonika configurator, please, use one of the old ones available via the links below in the "Compatibility list" section of this article.


The links allow you to download a compressed file with an old FW version (you don’t need to install it onto the tracker) and an older version of the configurator for different tracker models.
The links allow you to download a compressed file with an old FW version (you don’t need to install it onto the tracker) and an older version of the configurator for different tracker models.
Line 269: Line 242:
The password for the compressed file is '''1234'''
The password for the compressed file is '''1234'''


== Lost Connection ==
== Data losses ==
If there is a connection loss, after several attempts to collect the data (the '''Scan retries until error''' setting in the Bluetooth 4.0 tab) the tracker will transmit the error '''code 3000/300 in the temperature io'''. The level value will be transmitted as the last reading transmitted by the sensor if it was connected via the BLE base, or '''0\-4\65532''' in the fuel data.
If there is a connection loss, after several attempts to collect the data (the '''Scan retries until error''' setting in the Bluetooth 4.0 tab) the tracker will transmit the error '''code 3000/300 in the temperature io'''. The level value will be transmitted as the last reading transmitted by the sensor if it was connected via the BLE base, or '''0\-4\65532''' in the fuel data.


Before installing a BLE sensor and a tracker, you need to check the stability of the Bluetooth connection to select the best spot to install the GPS tracker/gateway (or BLE-RS485-RS232 adapter) at to minimize the risks of connection losses happening in the future.
Before installing a BLE sensor and a tracker, you need to properly configure the BLE Scan sessions as indicated in this article above) and check the stability of the Bluetooth connection to select the best spot to install the GPS tracker/gateway (or BLE-RS485-RS232 adapter) to minimize the risks of connection losses happening in the future. Also, be sure to orient the antennas of the devices as per recommendations provided in this article above.


To determine if the connection between the Bluetooth transmitter of the sensor and the Bluetooth receiver is stable or not, you should use the RSSI parameter. When you search for a place to install the GPS tracker, you should calculate the average RSSI (Received Signal Strength Indicator) by taking into account the 10 or more measurements of the RSSI taken over the course of 2-3 minutes while the engine of the vehicle is running and all electronics inside the cab and around the vehicle are switched on.
To determine if the connection between the Bluetooth transmitter of the sensor and the Bluetooth receiver is stable or not, you should use the RSSI parameter. When you search for a place to install the GPS tracker, you should calculate the average RSSI (Received Signal Strength Indicator) by taking into account the 10 or more measurements of the RSSI taken over the course of 2-3 minutes while the engine of the vehicle is running and all electronics inside the cab and around the vehicle are switched on.
Line 285: Line 258:


== Presets ==
== Presets ==
You can also downolad our '''TD 150 BLE''' and '''DU BLE''' presets for Teltonika tracker manually
You can also downolad our '''TD 150 BLE''' and '''DU BLE''' presets for Teltonika tracker manually and add them to the preset library.


# First of all, download preset file from the links below:  [https://drive.google.com/file/d/1_wiyNRlUvUn0JarXYwcJNpeahZNlH1Fw/view TD 150 BLE] [https://drive.google.com/file/d/1xQgTjlbQ8W2oOb8Owpj2Jr_U7xh4-2a0/view DU BLE]
# First of all, download preset file via the following links:  [https://drive.google.com/file/d/1_wiyNRlUvUn0JarXYwcJNpeahZNlH1Fw/view TD 150 BLE] [https://drive.google.com/file/d/1xQgTjlbQ8W2oOb8Owpj2Jr_U7xh4-2a0/view DU BLE]
# .Follow the Teltonika settings in the right corner below in the configurator  [[File:Imageaaveda.png|833x833px]]   
# Go to the Teltonika settings in the right corner below in the configurator  [[File:Imageaaveda.png|833x833px]]   
# Open Preset Settings and find preset file, that you downloaded earlier  [[File:Imageacacac.png|839x839px]]   
# Open Preset Settings and find preset file, that you downloaded earlier  [[File:Imageacacac.png|839x839px]]   
# Choose the downloaded preset file  [[File:Imagecavcf.png|837x837px]] [[File:Imageavdsfbdn.png|837x837px]]  
# Choose the downloaded preset file  [[File:Imagecavcf.png|837x837px]] [[File:Imageavdsfbdn.png|837x837px]]  
Retrieved from "https://wikien.escortsensors.com/index.php/Special:MobileDiff/1872"