Teltonika-BLE: Difference between revisions
→Direct BT connection (no adapter)
| Line 9: | Line 9: | ||
* 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). == | |||
{| class="wikitable" | {| class="wikitable" | ||
|[[File:Imageфсы.png|frameless]] | |[[File:Imageфсы.png|frameless]] | ||
|[[File: | |[[File:Imagesbsb.png|353x353px]] | ||
|- | |- | ||
|Fig.1 MAC address in the app | |Fig.1 MAC address in the app | ||
|Fig.2 MAC address on the sensor’s head | |Fig.2 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 == | |||
[[File:Photo 5418063427176959105 x.jpg|frameless|408x408px]] | [[File:Photo 5418063427176959105 x.jpg|frameless|408x408px]] | ||
3. On the '''Bluetooth 4.0 tab''' (Fig. 4), configure '''the''' '''BLE Scan settings''' as follows: | == 3. On the '''Bluetooth 4.0 tab''' (Fig. 4), configure '''the''' '''BLE Scan settings''' as follows: == | ||
- disable the '''Non Stop Scan''' | - disable the '''Non Stop Scan''' | ||
| Line 42: | Line 40: | ||
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 | == 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). == | ||
| Line 50: | Line 48: | ||
== 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): == | |||
5.Then, | |||
- “escort fuel” for TD-BLE, | - “escort fuel” for TD-BLE, | ||
- “escort luminosity” or “escort temperature” for TL-BLE | - “escort luminosity” or “escort temperature” for TL-BLE, “Escort_DU-BLE_Angle_sensor” for DU-BLE | ||
| Line 63: | Line 58: | ||
[[File:Photo 5418063427176959107 x.jpg|frameless|645x645px]] | [[File:Photo 5418063427176959107 x.jpg|frameless|645x645px]] | ||
[[File:Photo 5418063427176959111 x.jpg|frameless|645x645px]] | [[File:Photo 5418063427176959111 x.jpg|frameless|645x645px]] | ||
== 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). == | |||
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''' 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. | ||
| Line 74: | Line 70: | ||
Fig. 7 I/O tab | Fig. 7 I/O tab | ||
| Line 80: | Line 77: | ||
[[File:Photo 5418063427176959113 x.jpg|frameless|700x700px]] | [[File:Photo 5418063427176959113 x.jpg|frameless|700x700px]] | ||
7.In the '''System''' tab, click on the '''Codec 8 Extended''' option (Fig. 8) | == 7.In the '''System''' tab, click on the '''Codec 8 Extended''' option (Fig. 8) == | ||
| Line 87: | Line 84: | ||
Fig. 8 System. Data Protocol. Codec 8 Extended | Fig. 8 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). == | |||
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). | |||
| Line 99: | Line 95: | ||
== 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) == | |||
[[File:Antenna direction.png]] | |||
[[File: | |||
Fig. 10 Sensor and tracker orientation (applicable to both TD-BLE and DU-BLE models) | Fig. 10 Sensor and tracker orientation (applicable to both TD-BLE and DU-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 | 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. == | |||
11 | |||
[[File:Photo 5418063427176959118 x.jpg|frameless|573x573px]] | [[File:Photo 5418063427176959118 x.jpg|frameless|573x573px]] | ||
| Line 132: | Line 118: | ||
= Connecting BLE via adapter (BLE-Rs485 base) = | = Connecting BLE via adapter (BLE-Rs485 base) = | ||
== 1. First, connect the adapter to your C200M or other Rs485-USB converter and connect the USB cable of the converter to your laptop or computer. It is better if all 4 wires of the adapter are connected to the converter: orange to orange ('''Rs485 Line A'''), white to white ('''Rs485 Line B'''), black to black ('''GND''') and red to red ('''PWR''') (Fig. 13). == | |||
[[File:Photo 5418063427176959119 x.jpg|frameless|495x495px]] | [[File:Photo 5418063427176959119 x.jpg|frameless|495x495px]] | ||
| Line 140: | Line 126: | ||
2. In the Escort configurator for PC, select the COM port that corresponds to the converter that you are using to connect the adapter (to find its number, check the Windows Device manager’s COM and LPT ports section; C200M will be defined there as '''STMicroelectronics Virtual COM port''' device). Then go to the '''BLE''' then click '''BLE adapter settings''' (Fig. 14) | == 2. In the Escort configurator for PC, select the COM port that corresponds to the converter that you are using to connect the adapter (to find its number, check the Windows Device manager’s COM and LPT ports section; C200M will be defined there as '''STMicroelectronics Virtual COM port''' device). Then go to the '''BLE''' then click '''BLE adapter settings''' (Fig. 14) == | ||
[[File:Photo 5418063427176959122 x.jpg|frameless|372x372px]][[File:Photo 5418063427176959123 m.jpg|frameless]] | [[File:Photo 5418063427176959122 x.jpg|frameless|372x372px]][[File:Photo 5418063427176959123 m.jpg|frameless]] | ||
| Line 148: | Line 133: | ||
3. You will see 4 different cells to connect up to 4 sensors (if the base has the '''FW 2.3.8''' and the configurator is of the '''1.0.2.38 version''', you need to scroll down to see more cells) (Fig. 14 and 15) | == 3. You will see 4 different cells to connect up to 4 sensors (if the base has the '''FW 2.3.8''' and the configurator is of the '''1.0.2.38 version''', you need to scroll down to see more cells) (Fig. 14 and 15) == | ||
{| class="wikitable" | {| class="wikitable" | ||
|[[File:Photo 5418063427176959892 m.jpg|frameless|275x275px]] | |[[File:Photo 5418063427176959892 m.jpg|frameless|275x275px]] | ||
| Line 164: | Line 148: | ||
== 4. Connect the sensor to the first cell before anything else. Click '''Connect sensor''' (Fig. 16) and then enter the '''first letters''' of the sensor’s model (TD, DU, TL or TH), the lower dash _ will appear automatically. Then enter the '''6-digit serial number''' of the sensor, its password and then click '''Establish connection''' (Fig. 17) == | |||
4. Connect the sensor to the first cell before anything else. Click '''Connect sensor''' (Fig. 16) and then enter the '''first letters''' of the sensor’s model (TD, DU, TL or TH), the lower dash _ will appear automatically. Then enter the '''6-digit serial number''' of the sensor, its password and then click '''Establish connection''' (Fig. 17) | |||
{| class="wikitable" | {| class="wikitable" | ||
|[[File:Photo 5418063427176959124 m.jpg|frameless]] | |[[File:Photo 5418063427176959124 m.jpg|frameless]] | ||
| Line 183: | Line 160: | ||
5. For each sensor the base can use 1 or 2 network addresses to transmit the 2 main parameters via the main one and the 2 additional parameter via the auxiliary address. The additional parameters can be switched off (Fig. 18) | == 5. For each sensor the base can use 1 or 2 network addresses to transmit the 2 main parameters via the main one and the 2 additional parameter via the auxiliary address. The additional parameters can be switched off (Fig. 18) == | ||
| Line 197: | Line 174: | ||
6. Once the sensor or several sensors are connected to the base, make sure to configure the Rs485 tab of the Teltonika configurator so that the tracker were able to send requests to the network addresses that the base uses to “channel” the data that comes from the sensors (Fig. 19) | == 6. Once the sensor or several sensors are connected to the base, make sure to configure the Rs485 tab of the Teltonika configurator so that the tracker were able to send requests to the network addresses that the base uses to “channel” the data that comes from the sensors (Fig. 19) == | ||
[[File:Photo 5418063427176959127 x.jpg|699x699px]] | [[File:Photo 5418063427176959127 x.jpg|699x699px]] | ||
| Line 205: | Line 181: | ||
7. Then '''disconnect the base from the C200M''' or other converter, connect it to the power supply (black and red wires, the fuse from the kit must be installed in the red wire between the adapter and the power supply) and the '''orange to the line A Rs485''' of the tracker and '''white to the line B Rs485''' (Fig. 20) | == 7. Then '''disconnect the base from the C200M''' or other converter, connect it to the power supply (black and red wires, the fuse from the kit must be installed in the red wire between the adapter and the power supply) and the '''orange to the line A Rs485''' of the tracker and '''white to the line B Rs485''' (Fig. 20) == | ||
[[File:Photo 5418063427176959128 x.jpg]]Fig. 20 Wiring of the base and the tracker via the Rs485 port | [[File:Photo 5418063427176959128 x.jpg]]Fig. 20 Wiring of the base and the tracker via the Rs485 port | ||
| Line 213: | Line 188: | ||
8. In the '''I/O tab''' of the Teltonika configurator, select the priority Low (Fig. 21). For DU-BLE’s event | == 8. In the '''I/O tab''' of the Teltonika configurator, select the priority Low (Fig. 21). For DU-BLE’s event notification consider setting '''Event Only''' to '''Yes''' and the '''Operand''' to '''On Change'''. == | ||
The '''DU-BLE’s event notification''' can be transmitted either as a '''LLS Fuel Level''' parameter (if the adapter/base has the FW 2.3.8 or newer) or as a '''LLS Temperature''' parameter (FW 2.3.3 or older). | |||
[[File:Photo 5418063427176959129 x.jpg]] | |||
Fig. 21 I/O tab LLS parameters | |||
9. The io | == 9. The io list for the wired adapter (as well as for the wired sensors) is partially shown below == | ||
[[File:Photo 5418063427176959131 x.jpg]] | |||
[[File: | [[File:Imageacas.png]] | ||
Fig. 22 io_ list (partial) | Fig. 22 io_ list (partial) | ||
| Line 231: | Line 208: | ||
10. When selecting the spot to install the adapter on, be sure to assess its average '''RSSI value''' over the course of 2-3 minutes in the '''Escort configurator''' (Fig. 23). It must be falling into the range from '''-45 to -85 dB''' | == 10. When selecting the spot to install the adapter on, be sure to assess its average '''RSSI value''' over the course of 2-3 minutes in the '''Escort configurator''' (Fig. 23). It must be falling into the range from '''-45 to -85 dB''' == | ||
[[File:Photo 5418063427176959132 x.jpg]]Fig. 23 RSSI check | [[File:Photo 5418063427176959132 x.jpg]]Fig. 23 RSSI check | ||
11. Properly orient the Bluetooth antennas of the sensor and the adapter (Fig. 24) | == 11. Properly orient the Bluetooth antennas of the sensor and the adapter (Fig. 24) == | ||
[[File:Photo 5418063427176959103 mыкм.jpg]][[File:Photo 5418063427176959133 m.jpg]] | [[File:Photo 5418063427176959103 mыкм.jpg]][[File:Photo 5418063427176959133 m.jpg]] | ||
Fig. 24 Orienting the adapter and the sensor | |||
= Connecting TH-BLE via Rs485-BLE adapter/base = | = Connecting TH-BLE via Rs485-BLE adapter/base = | ||
| Line 259: | Line 234: | ||
[[File:Photo 5418063427176959135 x.jpg]] | [[File:Photo 5418063427176959135 x.jpg]] | ||
[[File:Photo 5418063427176959136 x.jpg]]Fig. 25 Selecting preset | [[File:Photo 5418063427176959136 x.jpg]] | ||
Fig. 25 Selecting preset | |||
Fig. 26 Parameters transmitted via addresses 1 and 2 | Fig. 26 Parameters transmitted via addresses 1 and 2 | ||
| Line 268: | Line 245: | ||
The password for the compressed file is '''1234''' | The password for the compressed file is '''1234''' | ||
== Lost Connection == | |||
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. | |||
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. | |||
The reason why the RSSI should be taken as the average value is that the RSSI itself is a dynamic parameter, its value changes constantly. This average value must be within the connection stability range. | |||
In case of the Bluetooth 4.0 the connection stability range is the value from -35 dBm to -85 dBm. If the average RSSI is less than -85 dBm (for example, -90 dBm), placing the tracker/gateway where it was during the RSSI check will most probably lead to the connection instability. As a result, not all the sensor's data packages will be received by the tracker. | |||
The solution is to try and turn the tracker around a bit or move it closer to the sensor and placing it at a spot where the average RSSI will be within the -35...-85 dBm range. Alternatively, you could install our BLE-RS485-RS232 BA_BLE adapter/base that tends to perform better than the Bluetooth modules of the trackers. | |||
Please, note that the RSSI is calculated by the receiver, so the connection quality is determined by the receiver and also depends on the receiver's sensitivity. | |||
== Presets == | |||
You can also downolad our '''TD 150 BLE''' and '''DU BLE''' presets for Teltonika tracker manually | |||
# 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]2.Follow the Teltonika settings in the right corner below in the configurator [[File:Imageaaveda.png|833x833px]] 3. Open Preset Settings and find preset file, that you downloaded earlier [[File:Imageacacac.png|839x839px]] 4. Choose the downloaded preset file [[File:Imagecavcf.png|837x837px]] [[File:Imageavdsfbdn.png|837x837px]]5. After that you will find our preset file in the preset list [[File:Imageacevsd.png|837x837px]] | |||
= Compatibility list = | = Compatibility list = | ||