Difference between revisions of "EYE SENSOR / BTSMP1"
(169 intermediate revisions by 20 users not shown) | |||
Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
− | ==<p style="font-size:32px | + | ==<p style="font-size:32px><span style="color:#0054A6">Introduction</span></p>== |
− | Wireless solutions open up new horizons for your business and help to keep an eye on your assets. Discover our brand-new and certified | + | Wireless solutions open up new horizons for your business and help to keep an eye on your assets. Discover our brand-new and certified Bluetooth Low Energy ID sensor model from Teltonika with robust waterproof casing and a long-lifetime battery. The model is designed for a low-cost fast and easy configuration and integration to save precious time, resources, and ensure accountability. |
− | [[File:BTSMP1 | + | [[File:BTSMP1.png|center|frameless|1157x1157px]] |
==<p style="font-size:32px><span style="color:#0054A6">About BTSMP1</span></p>== | ==<p style="font-size:32px><span style="color:#0054A6">About BTSMP1</span></p>== | ||
Line 45: | Line 45: | ||
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 3 s) | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 3 s) | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |2.5 years | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |2.5+ years |
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 5 s), default | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 5 s), default | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |4 years | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |4+ years |
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 10 s) | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Battery life (Tx=2 dBm; interval: 10 s) | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |5 years | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |5+ years |
|} | |} | ||
{| class="wikitable" | {| class="wikitable" | ||
Line 58: | Line 58: | ||
! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | ! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | ||
|- | |- | ||
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Bluetooth |
− | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Bluetooth 4.2 compliant, |
+ | Bluetooth 5.2 certified | ||
|- | |- | ||
| style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Range | | style="width:10%;border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Range | ||
Line 113: | Line 114: | ||
===<p style="font-size:24px><span style="color:#0054A6">Dimensions</span>=== | ===<p style="font-size:24px><span style="color:#0054A6">Dimensions</span>=== | ||
[[File:Eye dimensions.png]] | [[File:Eye dimensions.png]] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==<p style="font-size:32px><span style="color:#0054A6">Mounting recomendations</span></p>== | ==<p style="font-size:32px><span style="color:#0054A6">Mounting recomendations</span></p>== | ||
Line 195: | Line 122: | ||
Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to: | Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to: | ||
<br>• Transmitting at 2 dBm power. | <br>• Transmitting at 2 dBm power. | ||
− | <br>• Data advertising at | + | <br>• Data advertising at 1 second intervals. |
<br>• Eddystone and Sensors protocol | <br>• Eddystone and Sensors protocol | ||
<br> | <br> | ||
Line 207: | Line 134: | ||
{| | {| | ||
|- align="TOP" | |- align="TOP" | ||
− | |||
− | |||
− | |||
| | | | ||
− | |[[File: | + | |[[File:Detailed_list_-_collapsed.png|border|360x640px|none]] |
| | | | ||
+ | |[[File:Overview - without update (sensor).png|border|360x640px|none]] | ||
| | | | ||
+ | |[[File:Basic settings.png|right|border|360x640px]] | ||
| | | | ||
− | |[[File: | + | |[[File:Advanced settings.png|right|border|360x640px]] |
− | |||
− | |||
− | |||
− | | | ||
|} | |} | ||
Line 226: | Line 148: | ||
==== [[File:Group 125.png|baseline|frameless|upright=0.2|link=|alt=]]Overview window ==== | ==== [[File:Group 125.png|baseline|frameless|upright=0.2|link=|alt=]]Overview window ==== | ||
− | In overview window you can see device details, check firmware version and update if available, go to device configuration settings | + | In overview window you can see device details, check firmware version and update if available , go to device configuration settings. If you select to Configure device new window will open with Basic and Advanced settings. |
− | |||
<br> | <br> | ||
Line 241: | Line 162: | ||
|[[File:Eddystone ID settings.png|frameless]] | |[[File:Eddystone ID settings.png|frameless]] | ||
|} | |} | ||
− | In Advanced settings tab you can can configure EYE beacon sensor parameters: Beacon information (iBeacon ID*, Eddystone ID). UUID/MINOR/MAJOR parameter can be changed for iBeacon ID*. Namespace ID/Instance ID can be changed for Eddystone ID. If you scroll down you will be able to adjust Sensor reading interval and event settings of the EYE Sensor '''Note:''' iOS doesn't show devices with iBeacon protocol | + | In Advanced settings tab you can can configure EYE beacon sensor parameters: Beacon information (iBeacon ID*, Eddystone ID). UUID/MINOR/MAJOR parameter can be changed for iBeacon ID*. Namespace ID/Instance ID can be changed for Eddystone ID. If you scroll down you will be able to adjust Sensor reading interval and event settings of the EYE Sensor '''Note:''' iOS doesn't show devices with iBeacon protocol |
− | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator ( | + | =====<p style="font-size:16px><span style="color:#0054A6">Advanced configuration: Sensor reading and events<span>===== |
− | If you have firmware / configurator which does not support EYE sensor tab in | + | <br> |
+ | {| | ||
+ | |- style="vertical-align: top;" | ||
+ | |[[File:Magnetic field event.png]] | ||
+ | |[[File:Humidity event.png]] | ||
+ | |[[File:Temperature event.png]] | ||
+ | |[[File:Movement event2.png]] | ||
+ | |- | ||
+ | |'''Magnetic field event''' - adjust if the device generates events based on detection or exit (loss) of the magnet. | ||
+ | |'''Humidity event''' - adjust if the device generates events based on entrance or exit to selected humidity range | ||
+ | |'''Temperature event''' - adjust if the device generates events based on entrance or exit to selected temperature range | ||
+ | |'''Movement event''' - adjust movement/stop detection and timeouts it takes to register movement / stopping | ||
+ | |- | ||
+ | |[[File:Maximum event duration.png|frameless]] | ||
+ | |[[File:Event Advertising settings.png|frameless]] | ||
+ | |[[File:Sensor reading interval.png|frameless]] | ||
+ | |- | ||
+ | |'''Maximum event duration''' - how long will one event be advertised | ||
+ | |'''Event advertising settings''' - advertising period after event detection | ||
+ | |'''Sensor reading interval''' - how often values are updated by the device | ||
+ | |} | ||
+ | <br> | ||
+ | |||
+ | ==<p style="font-size:32px"><span style="color:#0054A6">FM Tracker Configuration</span></p>== | ||
+ | |||
+ | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator (standard functionality / advanced mode)</span>=== | ||
+ | If you have firmware / configurator which does not support EYE sensor tab in Bluetooth 4.0 section, then you can still use Avanced BLE configuration to connect with EYE Sensors. | ||
To configure FM with BTSMP1 EYE Sensor: | To configure FM with BTSMP1 EYE Sensor: | ||
Line 263: | Line 210: | ||
# In [[FMB120 System settings|System settings]] Enable [[Codec#Codec%208%20Extended|Codec8 Extended]]; | # In [[FMB120 System settings|System settings]] Enable [[Codec#Codec%208%20Extended|Codec8 Extended]]; | ||
# In [[FMB120 GPRS settings|GPRS settings]] Configure [[FMB120 GPRS settings#GPRS%20Settings%20and%20Server%20Settings|GPRS Settings and Server Settings]] | # In [[FMB120 GPRS settings|GPRS settings]] Configure [[FMB120 GPRS settings#GPRS%20Settings%20and%20Server%20Settings|GPRS Settings and Server Settings]] | ||
− | # In [[FMB120 | + | # In [[FMB120 Bluetooth settings|Bluetooth]] settings Enable Bluetooth, set this setting as either "Enable (hidden)" or "Enable (visible)", otherwise Bluetooth will be disabled; |
− | # In [[FMB120 | + | # In [[FMB120 Bluetooth 4.0 settings|Bluetooth 4.0]] settings: |
## set Non Stop Scan to "Disable", configure "Update Frequency" and "Scan duration" as 30 seconds. These settings will bring the best results for BLE scanning with our device; | ## set Non Stop Scan to "Disable", configure "Update Frequency" and "Scan duration" as 30 seconds. These settings will bring the best results for BLE scanning with our device; | ||
− | ## In [[FMB120 | + | ## In [[FMB120 Bluetooth 4.0 settings#Advanced%20Mode|Bluetooth 4.0 settings Advanced Mode Settings]] Load EYE Sensor preset according to packet settings in EYE app(if you do not have preset you can download them from below table) |
## Configure MAC address of the sensor | ## Configure MAC address of the sensor | ||
# To receive data to server enable corresponding IO elements in [[FMB120 I/O settings#Priority|FMB120 I/O settings]] | # To receive data to server enable corresponding IO elements in [[FMB120 I/O settings#Priority|FMB120 I/O settings]] | ||
Line 304: | Line 251: | ||
'''Preset Configuration:''' | '''Preset Configuration:''' | ||
− | If EYE Sensor Packet Settings is EYE Sensors or Eddystone and EYE Sensors:<br>[[File: | + | If EYE Sensor Packet Settings is EYE Sensors or Eddystone and EYE Sensors:<br>[[File:Eddystone and eye.png|frameless|1152x1152px]] |
− | |||
− | |||
<br>If EYE Sensor Packet Settings is EYE Sensors or iBeacon and EYE Sensors: | <br>If EYE Sensor Packet Settings is EYE Sensors or iBeacon and EYE Sensors: | ||
− | [[File: | + | [[File:Ibeacon and eye.png|frameless|1152x1152px]] |
'''IO element value descriptions:''' | '''IO element value descriptions:''' | ||
Line 319: | Line 264: | ||
|- | |- | ||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Custom1 | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Custom1 | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Flags (not supported with | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Flags(not supported with curent FMX640 preset) |
|- | |- | ||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Temperature | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Temperature | ||
Line 687: | Line 632: | ||
</tr></table> | </tr></table> | ||
− | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator new functionalities | + | ===<p style="font-size:24px"><span style="color:#0054A6">Teltonika configurator new functionalities (not released yet)</span>=== |
− | Starting with firmware | + | Starting with firmware 03.27.10.Rev.323 there is additional tabs available in Bluetooth 4.0 section that allow for easier configuration to connect FM and EYE sensor or beacon. |
− | ''' | + | '''Bluetooth 4.0''' |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<br> | <br> | ||
− | Functionalities were reorganized and transferred to | + | Functionalities were reorganized and transferred to Bluetooth 4.0 configuration tab with additional horizontal tabs selection for specific settings: |
<br> | <br> | ||
*'''Global''' - Parameters responsible for device scanning ability like power and duratations. | *'''Global''' - Parameters responsible for device scanning ability like power and duratations. | ||
Line 710: | Line 648: | ||
*'''BLE Scan Duration''' - Sensors data reading time. Recommended value 30. | *'''BLE Scan Duration''' - Sensors data reading time. Recommended value 30. | ||
*'''Scan retries until error''' - Scan retries count, till start to show the value as Error '3000' - sensor disconnected. Recommended value 30. | *'''Scan retries until error''' - Scan retries count, till start to show the value as Error '3000' - sensor disconnected. Recommended value 30. | ||
− | *'''BT Power Level''' - Telematics device | + | *'''BT Power Level''' - Telematics device Bluetooth power level setting. |
*'''BLE Broadcasting service ID''' - Telematics device can broadcast configured ID. | *'''BLE Broadcasting service ID''' - Telematics device can broadcast configured ID. | ||
*''' BLE connection control''' - Connection mode settings. If broadcasting ID is configured, parameter should be set to Prohibit. | *''' BLE connection control''' - Connection mode settings. If broadcasting ID is configured, parameter should be set to Prohibit. | ||
Line 721: | Line 659: | ||
<br> | <br> | ||
Sensor Configuration can be set to Custom Sensors, Eye Sensors or both. | Sensor Configuration can be set to Custom Sensors, Eye Sensors or both. | ||
− | With the Custom Sensors setting enabled, [https://wiki.teltonika-gps.com/view/ | + | With the Custom Sensors setting enabled, [https://wiki.teltonika-gps.com/view/FMB130_Bluetooth_4.0_settings#Advanced_Mode| any BLE sensor can be configured.]<br> |
When '''EYE Sensors''' is selected, Eye Sensor connectionless functionalities or EYE list search window will appear, depending on the selected EYE Sensor filter. | When '''EYE Sensors''' is selected, Eye Sensor connectionless functionalities or EYE list search window will appear, depending on the selected EYE Sensor filter. | ||
<br> | <br> | ||
Line 743: | Line 681: | ||
{| class="wikitable" | {| class="wikitable" | ||
|+ | |+ | ||
− | ! colspan="2" |Eye | + | ! colspan="2" |Eye Sensor #1 Data |
− | |||
− | |||
− | |||
|- | |- | ||
|1st Parameter ID | |1st Parameter ID | ||
Line 777: | Line 712: | ||
|variable | |variable | ||
|- | |- | ||
− | ! colspan="2" | + | ! colspan="2" |Eye Sensor #2 Data |
− | |||
− | |Eye Sensor #2 Data | ||
− | |||
|- | |- | ||
|1st Parameter ID | |1st Parameter ID | ||
Line 811: | Line 743: | ||
|variable | |variable | ||
|- | |- | ||
− | ! colspan="2" |Eye Sensor #N | + | ! colspan="2" |Eye Sensor #N Data |
|- | |- | ||
!... | !... | ||
Line 822: | Line 754: | ||
|- | |- | ||
!Parameter ID!!Name | !Parameter ID!!Name | ||
− | !Data type!!Description | + | !Data type!!Description!! |
+ | |- | ||
+ | | -||1 | ||
+ | |1 byte unsigned integer||Reserved. Added To each Eye Sensor start. Currently always 0. | ||
|- | |- | ||
− | |5||Eye Sensor Device Name | + | |5||Eye Sensor #1 Device Name |
|Array||Device’s name from Device Name List tab | |Array||Device’s name from Device Name List tab | ||
|- | |- | ||
|6 | |6 | ||
− | |EYE Sensor Temperature | + | |EYE Sensor #1 Temperature |
|2 byte signed integer | |2 byte signed integer | ||
|Temperature value measured by EYE Sensor from List Values from -32768 to +32768 with 0.01 C delta | |Temperature value measured by EYE Sensor from List Values from -32768 to +32768 with 0.01 C delta | ||
|- | |- | ||
|7 | |7 | ||
− | |EYE Sensor Humidity | + | |EYE Sensor #1 Humidity |
|1 byte unsigned integer | |1 byte unsigned integer | ||
|Humidity measured by EYE Sensor from List Values from 0 to 100% | |Humidity measured by EYE Sensor from List Values from 0 to 100% | ||
|- | |- | ||
|8 | |8 | ||
− | |EYE Sensor Magnet presence | + | |EYE Sensor #1 Magnet presence |
|1 byte unsigned integer | |1 byte unsigned integer | ||
|Magnet measured by EYE Sensor from List Values from 0 to1 | |Magnet measured by EYE Sensor from List Values from 0 to1 | ||
|- | |- | ||
|9 | |9 | ||
− | |EYE Sensor Movement presence | + | |EYE Sensor #1 Movement presence |
|1 byte unsigned integer | |1 byte unsigned integer | ||
|Movement measured by Eye Sensor from List Values | |Movement measured by Eye Sensor from List Values | ||
|- | |- | ||
|10 | |10 | ||
− | |EYE Sensor Movement count | + | |EYE Sensor #1 Movement count |
|2 byte unsigned integer | |2 byte unsigned integer | ||
|Movement counts measured by EYE Sensor from List Values | |Movement counts measured by EYE Sensor from List Values | ||
|- | |- | ||
|11 | |11 | ||
− | |EYE Sensor Pitch | + | |EYE Sensor #1 Pitch |
− | |1 byte | + | |1 byte unsigned integer |
|Pitch angle measured by Eye Sensor from list Values | |Pitch angle measured by Eye Sensor from list Values | ||
|- | |- | ||
|12 | |12 | ||
− | |EYE Sensor Angle Roll | + | |EYE Sensor #1 Angle Roll |
− | |2 byte | + | |2 byte unsigned integer |
− | |Roll Angle measured by EYE Sensor from List Values | + | |Roll Angle measured by EYE Sensor from List Values from |
|- | |- | ||
|13 | |13 | ||
− | |EYE Sensor Low battery indicator | + | |EYE Sensor #1 Low battery indicator |
|1 byte unsigned integer | |1 byte unsigned integer | ||
|Low battery state measured by EYE Sensor from List Values from 0 to1 | |Low battery state measured by EYE Sensor from List Values from 0 to1 | ||
|- | |- | ||
|14 | |14 | ||
− | |EYE Sensor Battery voltage | + | |EYE Sensor #1 Battery voltage |
|2 byte unsigned integer | |2 byte unsigned integer | ||
|Low battery state measured by EYE Sensor from List Values from 0 to1 | |Low battery state measured by EYE Sensor from List Values from 0 to1 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
|} | |} | ||
Line 1,055: | Line 979: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10812</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10812</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 1</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 1</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">2</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,065: | Line 989: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10813</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10813</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 2</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 2</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">2</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,075: | Line 999: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10814</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10814</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 3</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 3</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">2</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,085: | Line 1,009: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10815</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10815</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 4</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Movement 4</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">2</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,094: | Line 1,018: | ||
<tr> | <tr> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10816</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10816</td> | ||
− | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE | + | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Angle 1</td> |
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">4</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFFFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,104: | Line 1,028: | ||
<tr> | <tr> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10817</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10817</td> | ||
− | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE | + | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Angle 2</td> |
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">4</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFFFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,114: | Line 1,038: | ||
<tr> | <tr> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10818</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10818</td> | ||
− | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE | + | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Angle 3</td> |
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">4</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFFFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,124: | Line 1,048: | ||
<tr> | <tr> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10819</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10819</td> | ||
− | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE | + | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Angle 4</td> |
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">4</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> |
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFFFFFFFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,179: | Line 1,103: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10824</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10824</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 1</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 1</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">1</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,190: | Line 1,114: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10825</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10825</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 2</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 2</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">1</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,201: | Line 1,125: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10826</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10826</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 3</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 3</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">1</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,212: | Line 1,136: | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">10827</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">10827</td> | ||
<td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 4</td> | <td style="width: 20%; text-align:center; vertical-align:middle;">EYE Battery Voltage 4</td> | ||
− | <td style="width: 5%; text-align:center; vertical-align:middle;"> | + | <td style="width: 5%; text-align:center; vertical-align:middle;">1</td> |
<td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">Unsigned</td> | ||
<td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | <td style="width: 10%; text-align:center; vertical-align:middle;">0</td> | ||
− | <td style="width: 10%; text-align:center; vertical-align:middle;"> | + | <td style="width: 10%; text-align:center; vertical-align:middle;">0xFF</td> |
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
<td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | <td style="width: 5%; text-align:center; vertical-align:middle;">-</td> | ||
Line 1,308: | Line 1,232: | ||
<td style="width: 25%; text-align:center; vertical-align:middle;">Movement count value of EYE Sensor 4</td> | <td style="width: 25%; text-align:center; vertical-align:middle;">Movement count value of EYE Sensor 4</td> | ||
</tr> | </tr> | ||
− | + | ||
− | + | </table> | |
− | + | <br>'''Note:''' If you are using presets(firmware/configurator without EYE product support), then refer to [[FMB130 Teltonika Data Sending Parameters ID#BLE%20Sensors%20I.2FO%20elements|BLE Sensors I/O elements]] table instead. | |
− | + | ||
− | + | ==<p style="font-size:32px"><span style="color:#0054A6">EYE Sensor Protocol overview</span></p>== | |
− | + | ||
− | + | ||
− | + | ===<p style="font-size:24px><span style="color:#0054A6">Sensor advertising</span>=== | |
− | + | <br> | |
− | + | [[File:Sensors data.png|center]] | |
− | + | <br> | |
− | + | ===<p style="font-size:24px><span style="color:#0054A6">Beacon and sensors data</span>=== | |
− | + | [[File:Beacon and sensors data.png|center|819x819px|alt=|frameless]] | |
− | + | <br> | |
− | + | <br> | |
− | + | ===<p style="font-size:24px><span style="color:#0054A6">Protocol description</span>=== | |
− | + | At the highest-level Bluetooth LE advertising packet consists of Advertising Indication and Scan Response. Both packets can be maximum of 31 bytes in size. Advertising Indication packet is always broadcasted when Scan Response is broadcasted only if Observer device requests it by using Active Scan. | |
− | + | <br><br> | |
− | + | BTSMP1 uses Advertising Indication to send beacon data which can be configured to select between iBeacon and Eddystone protocols or to be disabled at all. In that case, data which is shown as Scan Response in protocol overview will be sent as Advertising Indication without Scan Response following it. | |
− | + | <br><br> | |
− | + | Scan Response is used to send device name and manufacturer specific data. Manufacturer specific data includes Teltonika Company ID (0x089A) and protocol version (0x01). It is followed by Flag Encoded Data (Table 1) and Extended Data (Table 2). Later on, protocol will be highly configurable in and will allow to disable/enable sending of device name or any sensor value allowing to reduce size of the packet being sent. | |
− | + | <br><br> | |
− | + | Device Name has the following default value for Beacon – ID1_XXXXXXX | |
− | + | <br> | |
− | + | <div style="display:inline-table"> | |
− | + | {| class="nd-othertables_2" style="width:125%;" ; | |
− | + | |+'''Table 1. Flag Encoded Date''' | |
− | + | |- | |
− | + | !Data!! Size (Bytes)!!Description | |
− | + | |- | |
− | + | |Flags||1||Each set bit (0-7) means the presence of value (0-7). Bits: | |
− | + | <br>0 – Temperature value presence | |
− | + | <br>1 – Humidity value presence | |
− | + | <br>2 – Magnetic sensor presence | |
− | + | <br>3 – Magnetic sensor state (1 magnetic field is detected/0 magnetic field is not detected) Valid value is present only if bit 2 flag is set. | |
− | + | <br>4 – Movement sensor counter | |
− | + | <br>5 – Movement sensor angle | |
− | + | <br>6 – Low Battery indication (if set to 1 low battery voltage detected) | |
− | + | <br>7 – Battery voltage value presence | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ( | ||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | |Value 0||2||Temperature | |
− | + | <br>Value in Celsius * 100 | |
− | + | <br>NOTE: present only if bit 0 is set, otherwise is not being sent | |
|- | |- | ||
− | | | + | |Value 1 ||1||Humidity |
− | | | + | <br>Value in percent |
− | | | + | <br>NOTE: present only if bit 1 is set, otherwise is not being sent |
− | | | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |Value 2||2||Movement Sensor counter |
− | | | + | <br>Most significant bit indicates movement state and 15 least significant bits represent count of movement events. |
− | | | + | <br>NOTE: present only if bit 4 is set, otherwise is not being sent |
− | | | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |Value 3 ||3||Movement sensor angle |
− | | | + | <br>Most significant byte – pitch (-90/+90) |
− | | | + | <br>Two least significant bytes – roll (-180/+180) |
− | + | <br>NOTE: present only if bit 5 is set, otherwise is not being sent | |
− | |||
− | |||
|- | |- | ||
− | | | + | |Value 4||1|| Battery Voltage |
− | + | <br>Battery voltage in mV = 2000 + VALUE * 10 | |
− | + | <br>NOTE: present only if bit 7 is set, otherwise is not being sent | |
− | |||
− | | | ||
− | | | ||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
+ | </div> | ||
+ | |||
+ | ===<p style="font-size:24px><span style="color:#0054A6">GATT Characteristics</span>=== | ||
+ | {| class="wikitable" style="width: 100%; background-color: white; border-bottom: 2px solid #0054A6;" | ||
− | + | |- | |
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 20px;" | Name | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 280px;" | Service UUID | |
− | + | ||
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 280px;" | Characteristic UUID | |
− | + | ||
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" | Data Type | |
− | + | ||
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" | Min | |
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" | Max | |
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6; width: 120px" | Default Value | |
− | |||
− | |||
− | |||
− | + | ! style="color: #0054A6; background-color: white; border-bottom: 2px solid #0054A6;" | Notes | |
− | + | |- | |
− | + | | Device Name || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0016-7df2-4d4e-8e6d-c611745b92e9 || ASCII || 0 || 11 || Unique for each device || - | |
− | |||
− | + | |- | |
− | + | | Tx Power Lever || 1804 || 00002a07-0000-1000-8000-00805f9b34fb || SINT8 || -14 || 8 || 2 || Possible values: -14, -11, -8, -5, -2, 2, 4, 8 | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | ||
+ | | Protocol Type|| e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0001-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 4 || 1 for EYE_Beacon, <br> 4 for EYE_Sensor || 0 - iBeacon <br> 1 - EddyStone <br> 2 - EYE Sensor <br> 3 - iBeacon + EYE Sensor <br> 4 - Eddsytone + EYE Sensor | ||
+ | |||
|- | |- | ||
− | | | + | |
− | + | | Advertising Interval|| e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0002-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 20 || 10000 || 1000 || miliseconds | |
− | + | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | |
− | + | | Sub Advertising Interval || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0003-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 20 || 1000 || 100 || Used by repeats, miliseconds | |
− | + | ||
|- | |- | ||
− | | | + | |
− | + | | Advertising Repeats || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0004-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 1 || 10 || 1 || Repeats work only if Advertising Interval is more than 2000 ms and Repeats set to more than 1 | |
− | + | ||
|- | |- | ||
− | | | + | |
− | <br> | + | | iBeacon ID || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0005-7df2-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 20 bytes || 20 bytes || Unique for each device || 16 B - UUID<br>2 B - major<br>2 B - minor |
− | <br> | + | |
|- | |- | ||
− | | | + | |
− | + | | Eddystone ID || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0006-7df2-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 16 bytes || 16 bytes || Unique for each device || 10 B - Namespace<br>6 B - Instance | |
− | <br> | + | |
− | |||
|- | |- | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | | Password || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0008-7df2-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 4 bytes ||4 bytes || 123456 || Always 6 Digits | |
+ | |||
+ | |- | ||
− | + | | Sensor Interval || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0009-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 0 || 10000 || 1000 || miliseconds | |
|- | |- | ||
− | + | | Event Interval || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c000a-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 0 || 10000 || 1000 || miliseconds | |
+ | |||
+ | |- | ||
− | + | | Event Duration || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c000b-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 30 || 30 || seconds | |
− | + | |- | |
− | + | | Temperature Event || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c000c-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 2 || 2 || 0 - on entrance<br>1 - on exit<br>2 - no event | |
− | + | |- | |
− | + | | Temperature Low || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c000d-7df2-4d4e-8e6d-c611745b92e9 || INT8 || -40 || 85 || -20 || celsius | |
− | + | |- | |
− | + | | Temperature High || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c000e-7df2-4d4e-8e6d-c611745b92e9 || INT8 || -40 || 85 || 50 || celsius | |
|- | |- | ||
− | | | + | | Humidity Event || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c000f-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 2 || 2 || 0 - on entrance<br>1 - on exit<br>2 - no event |
|- | |- | ||
− | | | + | | Humidity Low || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0010-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 100 || 15 || % |
|- | |- | ||
− | | | + | | Humidity High || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0011-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 100 || 50 || % |
+ | |- | ||
− | + | | Movement Event || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0012-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 2 || 2 || 0 - on entrance<br>1 - on exit<br>2 - no event | |
− | |||
+ | |- | ||
− | + | | Movement Start || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0013-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 0 || 300 || 5 || seconds | |
− | | | ||
− | |||
− | |||
|- | |- | ||
− | |||
+ | | Movement Stop || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0014-7df2-4d4e-8e6d-c611745b92e9 || UINT16 || 0 || 300 || 5 || seconds | ||
− | + | |- | |
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | + | | Magnetic Event || e61c0000-7df2-4d4e-8e6d-c611745b92e9 || e61c0015-7df2-4d4e-8e6d-c611745b92e9 || UINT8 || 0 || 2 || 2 || 0 - on entrance <br> 1 - on exit <br> 2 - no event | |
− | | | ||
− | |||
− | + | |- | |
− | + | | Manufacturer || 180A || 2A29 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "Teltonika" | |
− | + | |- | |
+ | | Model || 180A || 2A24 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "BTSID1" | ||
− | |||
|- | |- | ||
− | | | + | | Serial || 180A || 2A25 || BYTE ARRAY || - || - || Not Configurable || Not used |
|- | |- | ||
− | | | + | | Hardware || 180A || 2A27 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "Table:1 Volt:325 |
|- | |- | ||
− | | | + | | Firmware || 180A || 2A26 || BYTE ARRAY || - || - || Not Configurable || Read Only. Ex. "1.1.0-beta" |
|- | |- | ||
− | | | + | | System ID || 180A || 2A23 || BYTE ARRAY || - || - || Not Configurable || Not used |
|- | |- | ||
− | | | + | | MAC || 180A || 652143dc-dec6-4fb1-bd46-3e919d2410a6 || BYTE ARRAY || 6 || 6 || Not Configurable || Read Only. ex. 112233445566 -> 11:22:33:44:55:66 |
− | + | ||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | | Scan Response Data || e61c0000-7df3-4d4e-8e6d-c611745b92e9 || e61c0001-7df3-4d4e-8e6d-c611745b92e9 || BYTE ARRAY || 17 || 17 || Not Configurable || Scan Response Data, see picture for detail view of data structure |
− | | | + | |} |
− | | | + | [[File:Lentele0603.png|800px|frameless|center]] |
− | + | ===<p style="font-size:24px><span style="color:#0054A6">EYE Sensor Bluetooth frame parsing example</span>=== | |
− | | | + | {| class="nd-othertables_2" style="width:100%;" |
+ | |+ | ||
+ | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Unparsed data | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0048BA">02</span><span style="background:#B0BF1A">01</span><span style="background:#7CB9E8">06</span><span style="background:#C0E8D5">1A</span><span style="background:#B284BE">FF</span><span style="background:#72A0C1">4C00</span><span style="background:#EDEAE0">0215</span><span style="background:#C46210">FFFFFFFF0B8C404510C655AAB636EBEF</span><span style="background:#EFDECD">BB70</span><span style="background:#E52B50">0055</span><span style="background:#FFF600">02</span><span style="background:#03C03C">0C</span><span style="background:#FF3800">09</span><span style="background:#FFBF00">4D50315F31323334353637</span><span style="background:#FF7E00">0E</span><span style="background:#3DDC84">FF</span><span style="background:#008000">9A08</span><span style="background:#00FFFF">01</span><span style="background:#D0FF14">B7</span><span style="background:#00FF00">08B4</span><span style="background:#007FFF">12</span><span style="background:#F4C2C2">0CCB</span><span style="background:#BFFF00">0BFFC7</span><span style="background:#00BFFF">67</span> |
− | + | |} | |
− | | | + | <br> |
− | | | + | {| class="nd-othertables_2" style="width:100%;" |
− | + | |+ | |
− | | | + | ! colspan="4" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parsed data |
− | | | ||
− | | | ||
− | |||
− | |||
|- | |- | ||
− | | | + | ! colspan="2" rowspan="1" style="width:33%; vertical-align: middle; text-align: center;" |Parameter |
− | + | ! rowspan="1" style="width:33%; vertical-align: middle; text-align: center;" |HEX Code Part | |
− | + | ! rowspan="1" style="width:33%; vertical-align: middle; text-align: center;" |Actual Value | |
− | |||
− | |||
− | |||
− | |||
− | | | ||
|- | |- | ||
− | | | + | | rowspan="50" style="vertical-align: middle; text-align: center;" | |
− | + | | style="vertical-align: middle; text-align: center;" |Length | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0048BA">02</span> |
− | | | + | | |
− | | | ||
− | | | ||
− | | | ||
− | |||
− | |||
− | |||
|- | |- | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | | style="vertical-align: middle; text-align: center;" |Type | |
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#B0BF1A">01</span> | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Flags |
− | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#7CB9E8">06</span> | |
− | | | ||
− | |||
− | |< | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Length | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#C0E8D5">1A</span> |
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Type | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#B284BE">FF</span> |
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Apple company identifier (big endian) | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#72A0C1">4C00</span> |
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Beacon type | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#EDEAE0">0215</span> |
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |UUID | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#C46210">FFFFFFFF0B8C404510C655AAB636EBEF</span> |
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Major | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#EFDECD">BB70</span> |
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Minor | |
− | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#E52B50">0055</span> | |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Power |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#FFF600">02</span> |
− | | | ||
− | |||
− | | | ||
− | |||
− | |||
− | |||
− | < | ||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Length | |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#03C03C">0C</span> |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Type | |
− | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#FF3800">09</span> | |
− | |||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Device name |
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#FFBF00">4D50315F31323334353637</span> | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Length |
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#FF7E00">0E</span> | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Type |
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#3DDC84">FF</span> | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Teltonika company ID (big endian) |
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#008000">9A08</span> | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Protocol version |
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#00FFFF">01</span> | ||
+ | | | ||
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Flags |
− | |- | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#D0FF14">B7</span> |
− | | | + | |Raw value example 0xB7. Data has to be interpretated as binary value. |
− | + | In this example would be (MSB)<span style="background:#B284BE">1</span>011 011<span style="background:#00FFFF">1</span>(LSB) and is parsed from least significant byte(LSB). | |
+ | |||
− | + | 0 – Temperature value presence. <span style="background:#00FFFF">1</span> Means device is reading and transmitting temperature value. | |
− | + | 1 – Humidity value presence. 1 Means device is reading and transmitting humidity value. | |
− | + | ||
− | + | 2 – Magnetic sensor presence. 1 Means device is reading and transmitting Magnetic sensor value. | |
+ | |||
+ | 3 – Magnetic sensor state (1 magnetic field is detected/0 magnetic field is not detected) Valid value is present only if bit 2 flag is set. | ||
+ | |||
+ | 4 – Movement sensor counter. 1 Means device is reading and transmitting movement state and count values. | ||
+ | |||
+ | 5 – Movement sensor angle. 1 Means device is reading and transmitting angle roll and pitch values. | ||
+ | |||
+ | 6 – Low Battery indication. 0 – Means device battery is from 100 to 15 % (When value changes to 1 Battery level is lower than 15 %. | ||
+ | |||
+ | 7 – Battery voltage value presence. <span style="background:#B284BE">1</span> Means device is reading and transmitting battery voltage value. | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Temperature |
− | | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#00FF00">08B4</span> |
− | + | | Raw value example 0x08B4 hex, 2228 dec. | |
− | + | ||
− | + | Raw value needs to be divided by 100. | |
− | + | ||
+ | '''Real temperature''' is 22,28 Celsius. | ||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" | Humidity | |
− | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#007FFF">12</span> | |
− | + | |Raw value example 0x12 hex, 18 dec. | |
+ | Decimal value is humidity in percent. Humidity 18 % | ||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Movement | |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#F4C2C2">0CCB</span> |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:# | + | | (MSB)0000 1100 1100 1011(LSB) binary |
− | | | + | 0 - Most significant byte(MSB) represents '''Movement status'''. In this case device is not moving 0. If it was 1 device is moving. |
+ | |||
+ | 000 1100 1100 1011 – represent detected movements count 3275 decimal value means device has detected total 3275 movement events, | ||
|- | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Angle | ||
+ | | style="vertical-align: middle; text-align: center;" |<span style="background:#BFFF00">0BFFC7</span> | ||
+ | |0B – Most significant byte represents '''device pitch'''. Device pitch can be from -90 to 90 degrees. | ||
+ | In this example device pitch is 0000 1011 (2's complement) = 11° degrees. | ||
+ | |||
+ | |||
+ | FFC7– Two least significant bytes represent '''device roll'''. Device roll can be from -180 to 180 degrees. | ||
− | + | In this example device Roll is 1111 1111 1100 0111 (2's complement) = -57° degrees | |
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Battery voltage |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:# | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#00BFFF">67</span> |
− | | | + | |'''Battery voltage –''' raw value example 0x67 hex. Decimal value of parameter 103'''.''' To calculate battery voltage need to use calculation 2000 + (VALUE * 10). In this case battery voltage value 2000+(103x10)= 3030 mV |
− | | style=" | + | |} |
− | + | ||
+ | ===<p style="font-size:24px><span style="color:#0054A6">FM Packet parsing example (standard functionality / advanced mode)</span>=== | ||
+ | |||
+ | |||
+ | |||
+ | {| class="nd-othertables_2" style="width:100%;" | ||
+ | |+ | ||
+ | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Unparsed data | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;"| Received data in hexadecimal stream: <code>00000000000000488E010000017CA6B6BFD8010F0E5188209AB482008600A80F0000000</code><br><code>00006000000020019090400560024000301CF0000001601D00000FF4D01D10000006D00000001014B0001B6010000CF7D</code> |
− | | style="vertical-align: middle; text-align: center;" | | + | |} |
+ | |||
+ | {| class="nd-othertables_2" style="width:100%;" | ||
+ | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL Data Packet | ||
|- | |- | ||
− | + | ! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |AVL Data Packet Part | |
− | + | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part | |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | rowspan="4" style="vertical-align: middle; text-align: center;" | |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Zero Bytes |
+ | | style="vertical-align: middle; text-align: center;" |00 00 00 00 | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Data Field Length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 00 48 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Codec ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |8E (Codec8 Extended) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records) |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | rowspan="34" style="vertical-align: middle; text-align: center;" |AVL Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Timestamp |
+ | | style="vertical-align: middle; text-align: center;" |00 00 01 7C A6 B6 BF D8 (GMT: Friday, 22 October 2021 06:36:07) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Priority |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Longitude |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0F 0E 51 88 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Latitude |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |20 9A B4 82 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Altitude |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 86 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Angle |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 0A |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Satellites |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0E |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Speed |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 |
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Event IO ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N of Total ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 06 |
− | | | + | |- |
− | + | | style="vertical-align: middle; text-align: center;" |N1 of One Byte IO | |
− | + | | style="vertical-align: middle; text-align: center;" |00 00 | |
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N2 of Two Bytes IO |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 02 |
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 19 (25 = BLE Temperature #1) |
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Value |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |09 04 (2308=23.08°C) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 56 (86 = BLE Humidity #1) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Value |
− | + | | style="vertical-align: middle; text-align: center;" |00 36 (24 %RHT) | |
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |N4 of Four Bytes IO | |
− | + | | style="vertical-align: middle; text-align: center;" |00 03 | |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 CF (463 - BLE 1 Custom #2 = Movement status and movement events count) |
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Value |
− | | style="vertical-align: middle; text-align: center;" |00 00 00 | + | | style="vertical-align: middle; text-align: center;" |00 00 00 16 (Currently not moving events count 22) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 D0 (464 - BLE 1 Custom #3 = Angle ) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Value |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 FF 4D (Pitch = 0°, Roll = -179°) |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 D1 (465 - BLE 1 Custom #4 = Battery Voltage) |
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Value |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 00 6D (109 = 2000 + 109 * 10 mV = 3090 mV) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO |
+ | | style="vertical-align: middle; text-align: center;" |00 00 | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |NX of X Bytes IO |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 01 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N’th IO ID - AVL ID. |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 4B (331 - BLE 1 Custom #1 = Flags) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Length of Variable Length IO |
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 01 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Value of Variable Length IO |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |B7 = (MSB)<span style="background:#B284BE">1</span>1011 011<span style="background:#00FFFF">1</span>(LSB) |
− | + | It's parsed from least significant byte(LSB): | |
− | + | ||
− | + | ||
− | + | Bit 0 – Temperature value presence. | |
− | + | ||
− | + | <span style="background:#00FFFF">1</span> Means device is reading and transmitting temperature value. | |
− | + | ||
− | + | ||
− | + | Bit 1 – Humidity value presence. | |
− | + | ||
− | + | 1 Means device is reading and transmitting humidity value. | |
− | + | ||
+ | |||
+ | Bit 2 – Magnetic sensor presence. | ||
+ | |||
+ | 1 Means device is reading and transmitting Magnetic sensor value. | ||
+ | |||
+ | |||
+ | Bit 3 – Magnetic sensor state | ||
+ | |||
+ | 1 magnetic field is detected/0 magnetic field is not detected) Valid value is present only if bit 2 flag is set. | ||
+ | |||
+ | |||
+ | Bit 4 – Movement sensor counter. | ||
+ | |||
+ | 1 Means device is reading and transmitting movement state and count values. | ||
+ | |||
+ | |||
+ | Bit 5 – Movement sensor angle. | ||
+ | |||
+ | 1 Means device is reading and transmitting angle roll and pitch values. | ||
+ | |||
+ | |||
+ | Bit 6 – Low Battery indication. | ||
+ | |||
+ | 0 – Means device battery is from 100 to 15 % (When value changes to 1 Battery level is lower than 15 %. | ||
+ | |||
+ | |||
+ | 7 – Battery voltage value presence. | ||
+ | |||
+ | <span style="background:#B284BE">1</span> Means device is reading and transmitting battery voltage value. | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records) |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |CRC-16 |
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 00 CF 7D |
|- | |- | ||
− | | style=" | + | |} |
− | + | ===<p style="font-size:24px><span style="color:#0054A6">FM EYE Sensor record parsing example with the new firmware (EYE Sensor filtering by name / not released yet)</span>=== | |
+ | '''Parsing EYE Sensor records example''' <br> | ||
+ | Below You will find an example on how to parse EYE Sensor record with two EYE Sensors present. | ||
+ | |||
+ | {| class="nd-othertables_2" style="width:100%;" | ||
+ | |+ | ||
+ | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Unparsed data | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;"| Received data in hexadecimal stream: <code>00000000000000908E0100000183407a2beb000f0e3fe3209ab40e008801290d00002c350001000000000</code><br><code>000000000012c350063<span style="background-color:#91d4b9;">0130050f4d50315f42453241413500000000000602d60807012f0801000901000a024e000b01f90c025aff0d01000e020bcc</code><br><code>30050f4d50315f33464539414100000000000602cb080701300801000901000a0263000b01000c02af000d01000e020b90</span>010000f178</code> |
− | | style="vertical-align: middle; text-align: center;" | | + | |} |
+ | |||
+ | {| class="nd-othertables_2" style="width:100%;" | ||
+ | |+ | ||
+ | |||
+ | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL Data Packet | ||
|- | |- | ||
− | + | ! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |AVL Data Packet Part | |
− | + | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part | |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | rowspan="4" style="vertical-align: middle; text-align: center;" | |
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |Zero Bytes |
+ | | style="vertical-align: middle; text-align: center;" |00 00 00 00 | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Data Field Length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 00 90 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Codec ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |8E (Codec8 Extended) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records) |
− | | style="vertical-align: middle; text-align: center;" |01 | + | | style="vertical-align: middle; text-align: center;" |01 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | rowspan="24" style="vertical-align: middle; text-align: center;" |AVL Data |
− | | style="vertical-align: middle; text-align: center;" |00 00 | + | | style="vertical-align: middle; text-align: center;" |Timestamp |
+ | | style="vertical-align: middle; text-align: center;" |00 00 01 83 40 7a 2b eb(GMT: Tuesday, 18 June 2019 08:25:22.001) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Priority |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Longitude |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0f 0e 3f e3 |
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Latitude | |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |20 9a b4 0e |
− | | style="vertical-align: middle; text-align: center;" | | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Altitude |
+ | | style="vertical-align: middle; text-align: center;" |00 88 | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Angle | ||
+ | | style="vertical-align: middle; text-align: center;" |01 29 | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Satellites | ||
+ | | style="vertical-align: middle; text-align: center;" |0d | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Speed | ||
+ | | style="vertical-align: middle; text-align: center;" |00 00 | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Event IO ID | ||
+ | | style="vertical-align: middle; text-align: center;" |2c 35 (11317) | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |N of Total ID | ||
| style="vertical-align: middle; text-align: center;" |00 01 | | style="vertical-align: middle; text-align: center;" |00 01 | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N1 of One Byte IO |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 00 |
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |N2 of Two Bytes IO | ||
+ | | style="vertical-align: middle; text-align: center;" |00 00 | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N4 of Four Bytes IO |
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 00 |
|- | |- | ||
− | |||
− | |||
− | |||
+ | | style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO | ||
+ | | style="vertical-align: middle; text-align: center;" |00 00 | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |NX of X Bytes IO | ||
+ | | style="vertical-align: middle; text-align: center;" |00 01 | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |N’th IO ID - AVL ID. | ||
+ | | style="vertical-align: middle; text-align: center;" |2c 35 (11317) | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Length of Variable Length IO | ||
+ | | style="vertical-align: middle; text-align: center;" |00 63 (99 bytes) | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Value of Variable Length IO 11317 | ||
+ | | style="vertical-align: middle; text-align: center;" | | ||
+ | '''0130050f4d50315f42453241413500000000000602d60807012f0801000901000a024e000b01f90c025aff0d01000e020bcc''' | ||
+ | '''30050f4d50315f33464539414100000000000602cb080701300801000901000a0263000b01000c02af000d01000e020b90''' | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records) | ||
+ | | style="vertical-align: middle; text-align: center;" |01 | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |CRC-16 | ||
+ | | style="vertical-align: middle; text-align: center;" |00 00 f1 78 | ||
+ | |- | ||
+ | |} | ||
− | + | ==== Parsing AVL ID 11317 data ==== | |
− | |||
− | |||
+ | {| class="nd-othertables_2" style="width:100%;" | ||
+ | |+ | ||
+ | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL ID 11317 Unparsed data | ||
+ | |- | ||
+ | | style="vertical-align: middle; text-align: center;" |<code>'''630130050f4d50315f42453241413500000000000602d60807012f0801000901000a024e000b01f90c025aff0d01000e020bcc'''</code>'''<br><code>30050f4d50315f33464539414100000000000602cb080701300801000901000a0263000b01000c02af000d01000e020b90'''</code> | ||
+ | |} | ||
− | + | {| class="nd-othertables_2" style="width:100%;" | |
+ | |+ | ||
− | + | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parsing the data | |
− | + | |- | |
− | + | ! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |AVL Data packet part | |
− | + | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part | |
− | + | |- | |
− | 1 | + | | rowspan="4" style="vertical-align: middle; text-align: center;" | |
− | + | | style="vertical-align: middle; text-align: center;" |AVL ID Data Length | |
− | + | | style="vertical-align: middle; text-align: center;" |00 63 | |
− | + | |- | |
− | + | | style="vertical-align: middle; text-align: center;" |Constant | |
− | + | | style="vertical-align: middle; text-align: center;" |01 | |
− | + | |- | |
− | + | | style="vertical-align: middle; text-align: center;" |Eye Sensor #1 data length | |
− | + | | style="vertical-align: middle; text-align: center;" |30 (48 bytes) | |
− | + | |- | |
− | 1 | + | | style="vertical-align: middle; text-align: center;" |1st Parameter ID |
− | + | | style="vertical-align: middle; text-align: center;" |05 (Eye Sensor Device name) | |
− | + | |- | |
− | + | | rowspan="60" style="vertical-align: middle; text-align: center;" |AVL Data | |
− | + | | style="vertical-align: middle; text-align: center;" |Parameter data length | |
− | + | | style="vertical-align: middle; text-align: center;" |0f (15 bytes) | |
− | + | |- | |
− | + | | style="vertical-align: middle; text-align: center;" |Parameter data | |
− | + | | style="vertical-align: middle; text-align: center;" |4d 50 31 5f 42 45 32 41 41 35 00 00 00 00 00 | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |2nd Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |06 (Eye Sensor #1 temperature) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | + | | style="vertical-align: middle; text-align: center;" |d6 08 (little endian, converted to decimal and multiplied by 0.01C = 22.42C) | |
− | |||
− | |||
− | |||
− | |||
− | | | ||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | + | | style="vertical-align: middle; text-align: center;" |07 (Eye Sensor #1 Humidity) | |
− | |||
− | |||
− | | | ||
− | |||
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Parameter data length | |
− | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) | |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |2f (converted to decimal = 47%) |
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |08 (Eye Sensor #1 Magnet) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 (no magnet detected) |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |09 (EYE Sensor #1 Movement presence) |
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 (none detected) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0a (parameter ID #10, EYE Sensor #1 Movement count) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter Data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |4e 00 (converted to dec = 19968) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0b (Parameter ID #11 Eye Sensor #1 Pitch) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter Data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |f9 (converted to decimal = 159 degrees) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0c (Parameter ID #12 Eye sensor #1 Roll) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |5a ff (Eye Sensor Roll value) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0d (parameter ID #13 low battery voltage indicator) |
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |Parameter data length | |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) |
− | | style="vertical-align: middle; text-align: center;" | | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 (low battery voltage not detected) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0e (Eye Sensor #1 battery voltage) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |0b cc (Converted to decimal = 3020 mV) |
− | |||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Eye Sensor #2 data length |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |30 (48 bytes) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |05 (Eye Sensor Device name) |
|- | |- | ||
− | | | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | + | | style="vertical-align: middle; text-align: center;" |0f (15 bytes) | |
− | |||
− | |||
− | |||
− | | | ||
− | |||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | + | | style="vertical-align: middle; text-align: center;" |09 (EYE Sensor #1 Movement presence) | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | style="vertical-align: middle; text-align: center;" | | ||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| style="vertical-align: middle; text-align: center;" |06 (Eye Sensor #1 temperature) | | style="vertical-align: middle; text-align: center;" |06 (Eye Sensor #1 temperature) | ||
|- | |- | ||
Line 2,177: | Line 1,971: | ||
| style="vertical-align: middle; text-align: center;" |02 (2 bytes) | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |cb 08 (little endian, converted to decimal and multiplied by 0.01C = 22.51C) |
− | |||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
Line 2,187: | Line 1,980: | ||
| style="vertical-align: middle; text-align: center;" |01 (1 byte) | | style="vertical-align: middle; text-align: center;" |01 (1 byte) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |30 (converted to decimal = 48%) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
Line 2,197: | Line 1,990: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter Data | | style="vertical-align: middle; text-align: center;" |Parameter Data | ||
− | | style="vertical-align: middle; text-align: center;" |00 (no magnet detected) | + | | style="vertical-align: middle; text-align: center;" |00 (no magnet presence detected) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
Line 2,203: | Line 1,996: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter data length | | style="vertical-align: middle; text-align: center;" |Parameter data length | ||
− | | style="vertical-align: middle; text-align: center;" | 01 (1 byte) | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" |00 ( | + | | style="vertical-align: middle; text-align: center;" |00 (no movement presence detected) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
| style="vertical-align: middle; text-align: center;" |0a (parameter ID #10, EYE Sensor #1 Movement count) | | style="vertical-align: middle; text-align: center;" |0a (parameter ID #10, EYE Sensor #1 Movement count) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
| style="vertical-align: middle; text-align: center;" |02 (2 bytes) | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |63 00 (converted to decimal = 25344) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | Parameter ID | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
| style="vertical-align: middle; text-align: center;" |0b (Parameter ID #11 Eye Sensor #1 Pitch) | | style="vertical-align: middle; text-align: center;" |0b (Parameter ID #11 Eye Sensor #1 Pitch) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter data length |
− | | style="vertical-align: middle; text-align: center;" | 01 (1 byte) | + | | style="vertical-align: middle; text-align: center;" |01 (1 byte) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 (converted to dec = 0 degrees) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
Line 2,232: | Line 2,025: | ||
| style="vertical-align: middle; text-align: center;" |02 (2 bytes) | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |af 00 (Converted to dec = 44800) |
− | |||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Parameter ID | | style="vertical-align: middle; text-align: center;" |Parameter ID | ||
Line 2,242: | Line 2,034: | ||
| style="vertical-align: middle; text-align: center;" |01 (1 byte) | | style="vertical-align: middle; text-align: center;" |01 (1 byte) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
| style="vertical-align: middle; text-align: center;" |00 (low battery voltage not detected) | | style="vertical-align: middle; text-align: center;" |00 (low battery voltage not detected) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | Parameter ID | + | | style="vertical-align: middle; text-align: center;" |Parameter ID |
| style="vertical-align: middle; text-align: center;" |0e (Eye Sensor #1 battery voltage) | | style="vertical-align: middle; text-align: center;" |0e (Eye Sensor #1 battery voltage) | ||
|- | |- | ||
Line 2,251: | Line 2,043: | ||
| style="vertical-align: middle; text-align: center;" |02 (2 bytes) | | style="vertical-align: middle; text-align: center;" |02 (2 bytes) | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" |Parameter | + | | style="vertical-align: middle; text-align: center;" |Parameter Data |
− | | style="vertical-align: middle; text-align: center;" |0b | + | | style="vertical-align: middle; text-align: center;" |0b 90 (Converted to decimal = 2960mV) |
|- | |- | ||
− | + | |} | |
− | + | ||
− | + | ==<p style="font-size:32px"><span style="color:#0054A6">Safety information</span></p>== | |
− | + | This message contains information on how to operate BTSID1 safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device! | |
− | + | ||
− | + | 1. To avoid mechanical damage, it is advised to transport the device in an impact-proof package. | |
− | + | ||
− | + | 2. In case of malfunction contact yours Teltonika account manager or write to technical support team over VIP helpdesk.<br> | |
− | + | [[File:Safety.jpg]] | |
− | + | ||
− | + | ==<p style="font-size:32px><span style="color:#0054A6">Certification & Approvals</span></p>== | |
− | + | ||
− | + | {| class="wikitable" | |
− | + | |+ | |
− | + | ! style="width:50%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Certificates | |
− | + | ! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |} | ||
− | |||
− | ==<p style="font-size:32px"><span style="color:#0054A6">Safety information</span></p>== | ||
− | This message contains information on how to operate BTSID1 safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device! | ||
− | |||
− | 1. To avoid mechanical damage, it is advised to transport the device in an impact-proof package. | ||
− | |||
− | 2. In case of malfunction contact | ||
− | [[File:Safety | ||
− | |||
− | ==<p style="font-size:32px | ||
− | |||
− | {| class="wikitable" | ||
− | |+ | ||
− | ! style="width:50%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Certificates | ||
− | ! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | | ||
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |E-Mark (EU) | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | E-Mark (EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_E-Mark|YES]] |
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |FCC (USA) | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | FCC (USA) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_FCC|YES]] |
− | |||
|- | |- | ||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | CE/RED (EU) | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | CE/RED (EU) | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_CE_/_RED|YES]] |
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |RoHS (EU) | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | RoHS (EU) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_RoHS|YES]] |
− | |||
|- | |- | ||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | REACH (EU) | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | REACH (EU) | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_REACH|YES]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |Anatel(EU) (PR) |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[BTSMP_ANATEL|YES]] |
− | |||
|- | |- | ||
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | IP rating |
− | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[[ | + | | style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | [[BTS_IP67|YES]] |
− | |||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==<p style="font-size:32px"><span style="color:#0054A6">External Links</span></p>== | ==<p style="font-size:32px"><span style="color:#0054A6">External Links</span></p>== | ||
− | ===Product Page=== | + | === Product Page === |
https://teltonika-gps.com/eye/ | https://teltonika-gps.com/eye/ | ||
− | ===Product Change Notifications=== | + | === Product Change Notifications === |
The latest Product Change Notifications can be found: [[BTSMP1_Product_Change_Notifications|Product Change Notifications]] | The latest Product Change Notifications can be found: [[BTSMP1_Product_Change_Notifications|Product Change Notifications]] | ||
− | + | === Compatibilty with other Teltonika Devices === | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ===Compatibilty with other Teltonika Devices=== | ||
Teltonika Networks: | Teltonika Networks: | ||
https://wiki.teltonika-networks.com/view/Bluetooth_EYE_Sensor_and_EYE_Beacon_support | https://wiki.teltonika-networks.com/view/Bluetooth_EYE_Sensor_and_EYE_Beacon_support | ||
− | + | === Partner Providers Supporting Software === | |
− | + | * [[3Dtracking with Fleet Management (FM)|3Dtracking]] | |
− | ===Partner Providers Supporting Software=== | + | * [[GPS-server with Fleet Management (FM)|GPS-server]] |
− | *[[3Dtracking with Fleet Management (FM)|3Dtracking]] | + | * [[Gurtam Wialon with Fleet Management (FM)|Gurtam Wialon]] |
− | *[[GPS-server with Fleet Management (FM)|GPS-server]] | + | * [[Mapon with Fleet Management (FM)|Mapon]] |
− | *[[Wialon with Fleet Management (FM)|Wialon]] | + | * [[WhiteLabel Tracking with Fleet Management (FM)|WhiteLabel Tracking]] |
− | *[[Mapon with Fleet Management (FM)|Mapon]] | ||
− | *[[WhiteLabel Tracking with Fleet Management (FM)|WhiteLabel Tracking | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | === | + | === [[EYE FAQ|Frequently asked questions]] === |
− | + | * [[EYE FAQ#Questions%20about%20Power%20and%20Electrical%20characteristics|Questions about Power and Electrical characteristics]] | |
− | + | * [[EYE FAQ#Questions%20about%20EYE%20Accessory%20configuration%20.28EYE%20APP.29|Questions about EYE Accessory configuration (EYE APP)]] | |
− | + | * [[EYE FAQ#Questions%20about%20FMBxxx%20compatibility%20with%20EYE%20Accessories|Questions about FMBxxx compatibility with EYE Accessories]] | |
− | + | * [[EYE FAQ#Questions%20about%20Protocols|Questions about Protocols]] | |
− | + | * [[EYE FAQ#Other%20questions%20.28Questions%20without%20category.29|Other questions (Questions without category)]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | === Documents === |
− | + | ==== [https://teltonika-gps.com/datasheet_eye_sensor.pdf Datasheet PDF] ==== | |
− | [[Category: | + | ==== [https://teltonika-gps.com/BTS_Quick_Manual.pdf Quick Manual PDF] ==== |
+ | [[Category:EYE Accessories]] |
Revision as of 09:58, 20 September 2022
Main Page > Sensors > EYE SENSOR / BTSMP1Introduction
Wireless solutions open up new horizons for your business and help to keep an eye on your assets. Discover our brand-new and certified Bluetooth Low Energy ID sensor model from Teltonika with robust waterproof casing and a long-lifetime battery. The model is designed for a low-cost fast and easy configuration and integration to save precious time, resources, and ensure accountability.
About BTSMP1
Perfect for traceability use cases, delivery tracking, monitoring of various movable objects in logistics (trailers, containers), agriculture (tractor attachments), and constructions (tools and inventory). Sensors data makes it especially suitable for cold chain refrigerator use cases. The built-in accelerometer can detect item movement, pitch and roll of the device. Magnet detection can be used for wireless open/close detection and notifications such as trailer door events, etc. EYE sensor supports iBeacon and Eddystone protocols. The device is fully compatible with the Teltonika firmware platform which provides extended functionality. Configure, scan, and update anytime anywhere with a dedicated Teltonika mobile app
Product Specification
Features
Functionalities |
---|
Beacon ID, LED, Temperature, Humidity, Accelerometer, Magnet detection |
Dimensions and weight | |
---|---|
Dimensions | 56,6 mm x 38 mm x 13 mm |
Weight | 18g |
Battery and power | |
---|---|
Model | CR2450 |
Type | Type Lithium, Manganese Dioxide |
Total Capacity | 600 mAh |
Replaceable | No |
Battery life (Tx=2 dBm; interval: 3 s) | 2.5+ years |
Battery life (Tx=2 dBm; interval: 5 s), default | 4+ years |
Battery life (Tx=2 dBm; interval: 10 s) | 5+ years |
Connectivity | |
---|---|
Bluetooth | Bluetooth 4.2 compliant,
Bluetooth 5.2 certified |
Range | 80 m |
Available transmission power levels | Up to 8 dBm |
Sensitivity | -88 dBm |
Casing | |
---|---|
Protection | IP67 |
Mounting | Two holes to screw/leash/strip, tape |
Customization | Custom logo upon request (Special conditions) |
Environmental Requirements | |
---|---|
Humidity (non-condensing) | From 0% to 100% |
Operational temperature | -20°C / +60°C (-4°F / +140°F) |
Protocols compatibility | |
---|---|
iBeacon | Yes
*iOS doesn't show devices with iBeacon protocol |
Eddystone | Yes |
EYE Sensor | Yes |
Dimensions
Mounting recomendations
EYE App Configuration
Devices work constantly and are ready to perform out of the box. Default basic Sensor settings are set to:
• Transmitting at 2 dBm power.
• Data advertising at 1 second intervals.
• Eddystone and Sensors protocol
If you would like to change these settings you will need to:
1) Download and install EYE APP - Teltonika application to change sensor settings.
Eye App Overview
With the application you will be able to scan for visible Teltonika EYE devices, check their statuses or connect for configuration or firmware update.
Devices in view
In this window you will see all visible devices. You have options to see devices in Short list or in default list. When looking at devices in default list you will be able to open Detailed view of devices and check transmitted data statuses. Additionaly if you are looking for specific devices you will be able to use Search function to filter search options. When in this window select a device of your choice to connect and after passing pin code (default pin code is 123456) you will go to device overview window.
Overview window
In overview window you can see device details, check firmware version and update if available , go to device configuration settings. If you select to Configure device new window will open with Basic and Advanced settings.
Configure window
In this window you can check and change device configuration settings. In main tab Basic Settings you can change main settings. Change Device name, Power signal strength, Advertising interval and Packet transmission type*. For more settings go to Advanced settings tab to enable various events.
Advanced configuration window
Advanced configuration: Beacon Settings
In Advanced settings tab you can can configure EYE beacon sensor parameters: Beacon information (iBeacon ID*, Eddystone ID). UUID/MINOR/MAJOR parameter can be changed for iBeacon ID*. Namespace ID/Instance ID can be changed for Eddystone ID. If you scroll down you will be able to adjust Sensor reading interval and event settings of the EYE Sensor Note: iOS doesn't show devices with iBeacon protocol
Advanced configuration: Sensor reading and events
FM Tracker Configuration
Teltonika configurator (standard functionality / advanced mode)
If you have firmware / configurator which does not support EYE sensor tab in Bluetooth 4.0 section, then you can still use Avanced BLE configuration to connect with EYE Sensors.
To configure FM with BTSMP1 EYE Sensor:
Requirements:
Firmware/configurator version with multiple custom IO fields per sensor, we recommend:
FMBXXX: 03.27.07.Rev.00/1.7.22_B.3.27_R.21 or newer
FMX640: 01.02.03/1.7.24_B.FM64_R.34 or newer (FMB640 does not support for BLE functionality)
Step 1: Check EYE App Settings:
- Make sure that name of the sensor is default length (10 symbols) in EYE App Basic Configuration window
- Note what Packet settings you have set in EYE App Basic Configuration window
Step 2: Configure FM device using Teltonika configurator:
- In System settings Enable Codec8 Extended;
- In GPRS settings Configure GPRS Settings and Server Settings
- In Bluetooth settings Enable Bluetooth, set this setting as either "Enable (hidden)" or "Enable (visible)", otherwise Bluetooth will be disabled;
- In Bluetooth 4.0 settings:
- set Non Stop Scan to "Disable", configure "Update Frequency" and "Scan duration" as 30 seconds. These settings will bring the best results for BLE scanning with our device;
- In Bluetooth 4.0 settings Advanced Mode Settings Load EYE Sensor preset according to packet settings in EYE app(if you do not have preset you can download them from below table)
- Configure MAC address of the sensor
- To receive data to server enable corresponding IO elements in FMB120 I/O settings
Advanced mode configuration:
EYE Sensor Packet Setting: | |||
Preset you should use: | EYE Sensors | EYE iBeacon | EYE Eddystone |
FMBXXX Preset download link: | |||
FMBXXX Configuration example download link: | |||
FMX640 Preset download link: | |||
Instructions how you can manually add a preset: link |
Preset Configuration:
If EYE Sensor Packet Settings is EYE Sensors or Eddystone and EYE Sensors:
If EYE Sensor Packet Settings is EYE Sensors or iBeacon and EYE Sensors:
IO element value descriptions:
NAME | DESCRIPTION |
---|---|
Custom1 | Flags(not supported with curent FMX640 preset) |
Temperature | Ambient temperature in Celsius |
Humidity | Ambient humidity in percent |
Custom2 | Movement and movement events count |
Custom3 | Angle |
Custom4 | Battery voltage (2000 + (VALUE * 10)) in mV |
Property ID in AVL packet | Property name | Bytes | Type | Min | Max | Multiplier | Units | Description |
---|---|---|---|---|---|---|---|---|
25 | BLE Temperature #1 | 2 | Signed | -4000 | 12500 | 0.01* | °C | Degrees ( °C ), -40 - +125;
Error codes: 4000 - abnormal sensor state 3000 - sensor not found 2000 - failed sensor data parsing |
26 | BLE Temperature #2 | 2 | Signed | -4000 | 12500 | 0.01* | °C | Degrees ( °C ), -40 - +125;
Error codes: 4000 - abnormal sensor state 3000 - sensor not found 2000 - failed sensor data parsing |
27 | BLE Temperature #3 | 2 | Signed | -4000 | 12500 | 0.01* | °C | Degrees ( °C ), -40 - +125;
Error codes: 4000 - abnormal sensor state 3000 - sensor not found 2000 - failed sensor data parsing |
28 | BLE Temperature #4 | 2 | Signed | -4000 | 12500 | 0.01* | °C | Degrees ( °C ), -40 - +125;
Error codes: 4000 - abnormal sensor state 3000 - sensor not found 2000 - failed sensor data parsing |
86 | BLE Humidity #1 | 2 | Unsigned | 0 | 1000 | 0.1* | %RH | Humidity |
104 | BLE Humidity #2 | 2 | Unsigned | 0 | 1000 | 0.1* | %RH | Humidity |
106 | BLE Humidity #3 | 2 | Unsigned | 0 | 1000 | 0.1* | %RH | Humidity |
108 | BLE Humidity #4 | 2 | Unsigned | 0 | 1000 | 0.1* | %RH | Humidity |
331 | BLE 1 Custom #1 | Variable | HEX | 0 | - | - | - | Custom IO element for BLE sensor |
463 | BLE 1 Custom #2 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
464 | BLE 1 Custom #3 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
465 | BLE 1 Custom #4 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
466 | BLE 1 Custom #5 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
332 | BLE 2 Custom #1 | Variable | HEX | 0 | - | - | - | Custom IO element for BLE sensor |
467 | BLE 2 Custom #2 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
468 | BLE 2 Custom #3 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
469 | BLE 2 Custom #4 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
470 | BLE 2 Custom #5 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
333 | BLE 3 Custom #1 | Variable | HEX | 0 | - | - | - | Custom IO element for BLE sensor |
471 | BLE 3 Custom #2 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
472 | BLE 3 Custom #3 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
473 | BLE 3 Custom #4 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
474 | BLE 3 Custom #5 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
334 | BLE 4 Custom #1 | Variable | HEX | 0 | - | - | - | Custom IO element for BLE sensor |
475 | BLE 4 Custom #2 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
476 | BLE 4 Custom #3 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
477 | BLE 4 Custom #4 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
478 | BLE 4 Custom #5 | 8 | UNSIGNED LONG INT | 0 | 4294967295 | - | - | Custom IO element for BLE sensor |
Teltonika configurator new functionalities (not released yet)
Starting with firmware 03.27.10.Rev.323 there is additional tabs available in Bluetooth 4.0 section that allow for easier configuration to connect FM and EYE sensor or beacon.
Bluetooth 4.0
Functionalities were reorganized and transferred to Bluetooth 4.0 configuration tab with additional horizontal tabs selection for specific settings:
- Global - Parameters responsible for device scanning ability like power and duratations.
- EYE - Parameters to configure data reading from EYE sensors.
Common settings
- Non Stop Scan - Enable Non Stop Scan feature, the device will try to scan for the sensors all the time if any of them are configured.
- Sensors and Beacons Update frequency - changes sensors temperature/humidity/battery voltage data update frequency. Minimum value: 30s, maximum value: 65535s. Recommended value 30.
- BLE Scan Duration - Sensors data reading time. Recommended value 30.
- Scan retries until error - Scan retries count, till start to show the value as Error '3000' - sensor disconnected. Recommended value 30.
- BT Power Level - Telematics device Bluetooth power level setting.
- BLE Broadcasting service ID - Telematics device can broadcast configured ID.
- BLE connection control - Connection mode settings. If broadcasting ID is configured, parameter should be set to Prohibit.
Sensors
Sensor Configuration can be set to Custom Sensors, Eye Sensors or both.
With the Custom Sensors setting enabled, any BLE sensor can be configured.
When EYE Sensors is selected, Eye Sensor connectionless functionalities or EYE list search window will appear, depending on the selected EYE Sensor filter.
Name
When EYE Sensors Filter is set to Name, the Eye List search window will appear on the configurator. With this setting, separate EYE Sensor records (AVL ID: 11317) will be generated according to the configured parameters, which are described below:
- Data Clear period- defines how long the FM tracker waits when the Eye sensor is not detected before removing it from the Eye Sensor list and not sending the sensor values. If Data Clear Period is set to 0, then the EYE Sensor will not be removed from the EYE Sensor list and it will always be included in the periodic records.
- RSSI- Parameter defines the dBm threshold value of when the EYE sensor will be added to the sensor list. If the FM tracker detects the RSSI lower than the configured value, it will not be added to the EYE Sensor list.
- Record period - Defines how often the EYE Sensor record (AVL ID: 11317) will be generated when the FM tracker is operating On Stop or On Move modes, according to the configured movement source..
- EYE Sensor Settings - Define what sensor readings data is included in to the EYE Sensor Records. Sensor readings which are not needed can be disabled, to reduce data consumption.
- EYE Name list - Defines what EYE sensors will be added to EYE Sensor list. For EYE Sensors to be added to the list, only the beginning part of the EYE Sensor local name has to match. For example, if in the EYE name list “EYE_SENSOR” is added and the FM tracker detects EYE_SENSOR1, EYE_SENSOR2, EYE_SENSORXYZ, all these EYE Sensors will be added to EYE Sensor list. If the EYE name list is left empty, all the detected EYE Sensors will be included in the EYE Sensor list. NOTE: If EYE Sensor has a name that matches configured one in EYE Name List and if it has a MAC address, that matches configured one in EYE Sensors filtered by MAC address, then such sensor will not be added to EYE Sensor list, but it’s data will be added according EYE Sensor filtered by MAC IO elements.
Once Eye Sensor filtering by name list is selected, EYE Sensor records containing the AVL ID:11317 will start being generated. Below is an example of how EYE Sensor data is packed into AVL ID 11317
AVL ID 11317 structure
Eye Sensor #1 Data | |
---|---|
1st Parameter ID | 1 byte |
1st Parameter Data Length | 1 byte |
1st Parameter Data | variable |
2nd Parameter ID | 1 byte |
2nd Parameter Data Length | 1 byte |
2nd Parameter Data | variable |
<...> | |
Nth Parameter ID | 1 byte |
Nth Parameter Data Length | 1 byte |
Nth Parameter Data | variable |
Eye Sensor #2 Data | |
1st Parameter ID | 1 byte |
1st Parameter Data Length | 1 byte |
1st Parameter Data | variable |
2nd Parameter ID | 1 byte |
2nd Parameter Data Length | 1 byte |
2nd Parameter Data | variable |
<...> | |
Nth Parameter ID | 1 byte |
Nth Parameter Data Length | 1 byte |
Nth Parameter Data | variable |
Eye Sensor #N Data | |
... | ... |
Parameter IDs are used to identify what type of EYE Sensor information is included in the packet. Below is the table describing the possible EYE Sensor parameter IDs, along with their data type and data length.
Parameter ID | Name | Data type | Description | |
---|---|---|---|---|
- | 1 | 1 byte unsigned integer | Reserved. Added To each Eye Sensor start. Currently always 0. | |
5 | Eye Sensor #1 Device Name | Array | Device’s name from Device Name List tab | |
6 | EYE Sensor #1 Temperature | 2 byte signed integer | Temperature value measured by EYE Sensor from List Values from -32768 to +32768 with 0.01 C delta | |
7 | EYE Sensor #1 Humidity | 1 byte unsigned integer | Humidity measured by EYE Sensor from List Values from 0 to 100% | |
8 | EYE Sensor #1 Magnet presence | 1 byte unsigned integer | Magnet measured by EYE Sensor from List Values from 0 to1 | |
9 | EYE Sensor #1 Movement presence | 1 byte unsigned integer | Movement measured by Eye Sensor from List Values | |
10 | EYE Sensor #1 Movement count | 2 byte unsigned integer | Movement counts measured by EYE Sensor from List Values | |
11 | EYE Sensor #1 Pitch | 1 byte unsigned integer | Pitch angle measured by Eye Sensor from list Values | |
12 | EYE Sensor #1 Angle Roll | 2 byte unsigned integer | Roll Angle measured by EYE Sensor from List Values from | |
13 | EYE Sensor #1 Low battery indicator | 1 byte unsigned integer | Low battery state measured by EYE Sensor from List Values from 0 to1 | |
14 | EYE Sensor #1 Battery voltage | 2 byte unsigned integer | Low battery state measured by EYE Sensor from List Values from 0 to1 |
MAC
IF EYE Sensors are selected to be filtered by MAC address, separate EYE sensor records will not be generated; EYE sensor values will be included into regular records with their corresponding IO elements. Up to 4 EYE Sensors can be configured with different MAC Addresses.
In the case of filtering by MAC Address, more advanced configuration is possible, as EYE Sensors’ IOs’ Low, High level, Event Only and Operand parameters can also be configured separately for each IO.
- Working Mode - parameter has 2 options – Disabled and EYE Sensor. When it is disabled, EYE Sensor IO values will not be included into the records. When EYE Sensor is selected, EYE Sensor IO values will be included into records.
- MAC Settings - parameter specifies the MAC address of the EYE Sensor for the FM tracker to read, parse its data and put to corresponding IO elements. If the sensor is not found for set amount of scan retries, error values will be stored into IO elements.
- I/O elements - allows for advanced EYE sensor I/O elements configuration.
Table below describes I/O elements which were added for EYE sensor with the new functionalities release.
Property ID in AVL packet | Property name | Bytes | Type | Min | Max | Multiplier | Units | Description |
---|---|---|---|---|---|---|---|---|
11317 | EYE Sensor List | variable length | HEX | 0 bytes | 1024 bytes | - | - | EYE Sensor List |
10800 | EYE Temperature 1 | 2 | Signed | -32768 | 32768 | 0,01 | °C | Temperature measured by EYE sensor 1 |
10801 | EYE Temperature 2 | 2 | Signed | -32768 | 32768 | 0,01 | °C | Temperature measured by EYE sensor 2 |
10802 | EYE Temperature 3 | 2 | Signed | -32768 | 32768 | 0,01 | °C | Temperature measured by EYE sensor 3 |
10803 | EYE Temperature 4 | 2 | Signed | -32768 | 32768 | 0,01 | °C | Temperature measured by EYE sensor 4 |
10804 | EYE Humidity 1 | 1 | Unsigned | 0 | 100 | - | % | Humidity measured by EYE sensor 1 |
10805 | EYE Humidity 2 | 1 | Unsigned | 0 | 100 | - | % | Humidity measured by EYE sensor 2 |
10806 | EYE Humidity 3 | 1 | Unsigned | 0 | 100 | - | % | Humidity measured by EYE sensor 3 |
10807 | EYE Humidity 4 | 1 | Unsigned | 0 | 100 | - | % | Humidity measured by EYE sensor 4 |
10808 | EYE Magnet 1 | 1 | Unsigned | 0 | 1 | - | - | Magnet measured by EYE sensor 1 |
10809 | EYE Magnet 2 | 1 | Unsigned | 0 | 1 | - | - | Magnet measured by EYE sensor 2 |
10810 | EYE Magnet 3 | 1 | Unsigned | 0 | 1 | - | - | Magnet measured by EYE sensor 3 |
10811 | EYE Magnet 4 | 1 | Unsigned | 0 | 1 | - | - | Magnet measured by EYE sensor 4 |
10812 | EYE Movement 1 | 2 | Unsigned | 0 | 0xFFFF | - | - | Movement state and count measured by EYE sensor 1 |
10813 | EYE Movement 2 | 2 | Unsigned | 0 | 0xFFFF | - | - | Movement state and count measured by EYE sensor 2 |
10814 | EYE Movement 3 | 2 | Unsigned | 0 | 0xFFFF | - | - | Movement state and count measured by EYE sensor 3 |
10815 | EYE Movement 4 | 2 | Unsigned | 0 | 0xFFFF | - | - | Movement state and count measured by EYE sensor 4 |
10816 | EYE Angle 1 | 4 | Unsigned | 0 | 0xFFFFFFFF | - | - | Pitch and Roll angles measured by EYE sensor 1 |
10817 | EYE Angle 2 | 4 | Unsigned | 0 | 0xFFFFFFFF | - | - | Pitch and Roll angles measured by EYE sensor 2 |
10818 | EYE Angle 3 | 4 | Unsigned | 0 | 0xFFFFFFFF | - | - | Pitch and Roll angles measured by EYE sensor 3 |
10819 | EYE Angle 4 | 4 | Unsigned | 0 | 0xFFFFFFFF | - | - | Pitch and Roll angles measured by EYE sensor 4 |
10820 | EYE Low Battery 1 | 1 | Unsigned | 0 | 1 | - | - | Low Battery indication EYE sensor 1 |
10821 | EYE Low Battery 2 | 1 | Unsigned | 0 | 1 | - | - | Low Battery indication EYE sensor 2 |
10822 | EYE Low Battery 3 | 1 | Unsigned | 0 | 1 | - | - | Low Battery indication EYE sensor 3 |
10823 | EYE Low Battery 4 | 1 | Unsigned | 0 | 1 | - | - | Low Battery indication EYE sensor 4 |
10824 | EYE Battery Voltage 1 | 1 | Unsigned | 0 | 0xFF | - | - | Battery Voltage of EYE sensor 1 |
10825 | EYE Battery Voltage 2 | 1 | Unsigned | 0 | 0xFF | - | - | Battery Voltage of EYE sensor 2 |
10826 | EYE Battery Voltage 3 | 1 | Unsigned | 0 | 0xFF | - | - | Battery Voltage of EYE sensor 3 |
10827 | EYE Battery Voltage 4 | 1 | Unsigned | 0 | 0xFF | - | - | Battery Voltage of EYE sensor 4 |
10832 | EYE Roll 1 | 2 | signed | -180 | 180 | - | - | Roll value of EYE Sensor 1 |
10833 | EYE Roll 2 | 2 | signed | -180 | 180 | - | - | Roll value of EYE Sensor 2 |
10834 | EYE Roll 3 | 2 | signed | -180 | 180 | - | - | Roll value of EYE Sensor 3 |
10835 | EYE Roll 4 | 2 | signed | -180 | 180 | - | - | Roll value of EYE Sensor 4 |
10836 | EYE Movement Count 1 | 2 | unsigned | 0 | 65535 | - | - | Movement count value of EYE Sensor 1 |
10837 | EYE Movement Count 2 | 2 | unsigned | 0 | 65535 | - | - | Movement count value of EYE Sensor 2 |
10838 | EYE Movement Count 3 | 2 | unsigned | 0 | 65535 | - | - | Movement count value of EYE Sensor 3 |
10839 | EYE Movement Count 4 | 2 | unsigned | 0 | 65535 | - | - | Movement count value of EYE Sensor 4 |
Note: If you are using presets(firmware/configurator without EYE product support), then refer to BLE Sensors I/O elements table instead.
EYE Sensor Protocol overview
Sensor advertising
Beacon and sensors data
Protocol description
At the highest-level Bluetooth LE advertising packet consists of Advertising Indication and Scan Response. Both packets can be maximum of 31 bytes in size. Advertising Indication packet is always broadcasted when Scan Response is broadcasted only if Observer device requests it by using Active Scan.
BTSMP1 uses Advertising Indication to send beacon data which can be configured to select between iBeacon and Eddystone protocols or to be disabled at all. In that case, data which is shown as Scan Response in protocol overview will be sent as Advertising Indication without Scan Response following it.
Scan Response is used to send device name and manufacturer specific data. Manufacturer specific data includes Teltonika Company ID (0x089A) and protocol version (0x01). It is followed by Flag Encoded Data (Table 1) and Extended Data (Table 2). Later on, protocol will be highly configurable in and will allow to disable/enable sending of device name or any sensor value allowing to reduce size of the packet being sent.
Device Name has the following default value for Beacon – ID1_XXXXXXX
Data | Size (Bytes) | Description |
---|---|---|
Flags | 1 | Each set bit (0-7) means the presence of value (0-7). Bits:
|
Value 0 | 2 | Temperature
|
Value 1 | 1 | Humidity
|
Value 2 | 2 | Movement Sensor counter
|
Value 3 | 3 | Movement sensor angle
|
Value 4 | 1 | Battery Voltage
|
GATT Characteristics
Name | Service UUID | Characteristic UUID | Data Type | Min | Max | Default Value | Notes |
---|---|---|---|---|---|---|---|
Device Name | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0016-7df2-4d4e-8e6d-c611745b92e9 | ASCII | 0 | 11 | Unique for each device | - |
Tx Power Lever | 1804 | 00002a07-0000-1000-8000-00805f9b34fb | SINT8 | -14 | 8 | 2 | Possible values: -14, -11, -8, -5, -2, 2, 4, 8 |
Protocol Type | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0001-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 4 | 1 for EYE_Beacon, 4 for EYE_Sensor |
0 - iBeacon 1 - EddyStone 2 - EYE Sensor 3 - iBeacon + EYE Sensor 4 - Eddsytone + EYE Sensor |
Advertising Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0002-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 20 | 10000 | 1000 | miliseconds |
Sub Advertising Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0003-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 20 | 1000 | 100 | Used by repeats, miliseconds |
Advertising Repeats | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0004-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 1 | 10 | 1 | Repeats work only if Advertising Interval is more than 2000 ms and Repeats set to more than 1 |
iBeacon ID | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0005-7df2-4d4e-8e6d-c611745b92e9 | BYTE ARRAY | 20 bytes | 20 bytes | Unique for each device | 16 B - UUID 2 B - major 2 B - minor |
Eddystone ID | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0006-7df2-4d4e-8e6d-c611745b92e9 | BYTE ARRAY | 16 bytes | 16 bytes | Unique for each device | 10 B - Namespace 6 B - Instance |
Password | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0008-7df2-4d4e-8e6d-c611745b92e9 | BYTE ARRAY | 4 bytes | 4 bytes | 123456 | Always 6 Digits |
Sensor Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0009-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 0 | 10000 | 1000 | miliseconds |
Event Interval | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c000a-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 0 | 10000 | 1000 | miliseconds |
Event Duration | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c000b-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 30 | 30 | seconds |
Temperature Event | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c000c-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 2 | 2 | 0 - on entrance 1 - on exit 2 - no event |
Temperature Low | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c000d-7df2-4d4e-8e6d-c611745b92e9 | INT8 | -40 | 85 | -20 | celsius |
Temperature High | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c000e-7df2-4d4e-8e6d-c611745b92e9 | INT8 | -40 | 85 | 50 | celsius |
Humidity Event | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c000f-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 2 | 2 | 0 - on entrance 1 - on exit 2 - no event |
Humidity Low | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0010-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 100 | 15 | % |
Humidity High | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0011-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 100 | 50 | % |
Movement Event | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0012-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 2 | 2 | 0 - on entrance 1 - on exit 2 - no event |
Movement Start | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0013-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 0 | 300 | 5 | seconds |
Movement Stop | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0014-7df2-4d4e-8e6d-c611745b92e9 | UINT16 | 0 | 300 | 5 | seconds |
Magnetic Event | e61c0000-7df2-4d4e-8e6d-c611745b92e9 | e61c0015-7df2-4d4e-8e6d-c611745b92e9 | UINT8 | 0 | 2 | 2 | 0 - on entrance 1 - on exit 2 - no event |
Manufacturer | 180A | 2A29 | BYTE ARRAY | - | - | Not Configurable | Read Only. Ex. "Teltonika" |
Model | 180A | 2A24 | BYTE ARRAY | - | - | Not Configurable | Read Only. Ex. "BTSID1" |
Serial | 180A | 2A25 | BYTE ARRAY | - | - | Not Configurable | Not used |
Hardware | 180A | 2A27 | BYTE ARRAY | - | - | Not Configurable | Read Only. Ex. "Table:1 Volt:325 |
Firmware | 180A | 2A26 | BYTE ARRAY | - | - | Not Configurable | Read Only. Ex. "1.1.0-beta" |
System ID | 180A | 2A23 | BYTE ARRAY | - | - | Not Configurable | Not used |
MAC | 180A | 652143dc-dec6-4fb1-bd46-3e919d2410a6 | BYTE ARRAY | 6 | 6 | Not Configurable | Read Only. ex. 112233445566 -> 11:22:33:44:55:66 |
Scan Response Data | e61c0000-7df3-4d4e-8e6d-c611745b92e9 | e61c0001-7df3-4d4e-8e6d-c611745b92e9 | BYTE ARRAY | 17 | 17 | Not Configurable | Scan Response Data, see picture for detail view of data structure |
EYE Sensor Bluetooth frame parsing example
Unparsed data | ||
---|---|---|
0201061AFF4C000215FFFFFFFF0B8C404510C655AAB636EBEFBB700055020C094D50315F313233343536370EFF9A0801B708B4120CCB0BFFC767 |
Parsed data | |||
---|---|---|---|
Parameter | HEX Code Part | Actual Value | |
Length | 02 | ||
Type | 01 | ||
Flags | 06 | ||
Length | 1A | ||
Type | FF | ||
Apple company identifier (big endian) | 4C00 | ||
Beacon type | 0215 | ||
UUID | FFFFFFFF0B8C404510C655AAB636EBEF | ||
Major | BB70 | ||
Minor | 0055 | ||
Power | 02 | ||
Length | 0C | ||
Type | 09 | ||
Device name | 4D50315F31323334353637 | ||
Length | 0E | ||
Type | FF | ||
Teltonika company ID (big endian) | 9A08 | ||
Protocol version | 01 | ||
Flags | B7 | Raw value example 0xB7. Data has to be interpretated as binary value.
In this example would be (MSB)1011 0111(LSB) and is parsed from least significant byte(LSB).
1 – Humidity value presence. 1 Means device is reading and transmitting humidity value. 2 – Magnetic sensor presence. 1 Means device is reading and transmitting Magnetic sensor value. 3 – Magnetic sensor state (1 magnetic field is detected/0 magnetic field is not detected) Valid value is present only if bit 2 flag is set. 4 – Movement sensor counter. 1 Means device is reading and transmitting movement state and count values. 5 – Movement sensor angle. 1 Means device is reading and transmitting angle roll and pitch values. 6 – Low Battery indication. 0 – Means device battery is from 100 to 15 % (When value changes to 1 Battery level is lower than 15 %. 7 – Battery voltage value presence. 1 Means device is reading and transmitting battery voltage value. | |
Temperature | 08B4 | Raw value example 0x08B4 hex, 2228 dec.
Raw value needs to be divided by 100. Real temperature is 22,28 Celsius. | |
Humidity | 12 | Raw value example 0x12 hex, 18 dec.
Decimal value is humidity in percent. Humidity 18 % | |
Movement | 0CCB | (MSB)0000 1100 1100 1011(LSB) binary
0 - Most significant byte(MSB) represents Movement status. In this case device is not moving 0. If it was 1 device is moving. 000 1100 1100 1011 – represent detected movements count 3275 decimal value means device has detected total 3275 movement events, | |
Angle | 0BFFC7 | 0B – Most significant byte represents device pitch. Device pitch can be from -90 to 90 degrees.
In this example device pitch is 0000 1011 (2's complement) = 11° degrees.
In this example device Roll is 1111 1111 1100 0111 (2's complement) = -57° degrees | |
Battery voltage | 67 | Battery voltage – raw value example 0x67 hex. Decimal value of parameter 103. To calculate battery voltage need to use calculation 2000 + (VALUE * 10). In this case battery voltage value 2000+(103x10)= 3030 mV |
FM Packet parsing example (standard functionality / advanced mode)
Unparsed data | ||
---|---|---|
Received data in hexadecimal stream: 00000000000000488E010000017CA6B6BFD8010F0E5188209AB482008600A80F0000000 00006000000020019090400560024000301CF0000001601D00000FF4D01D10000006D00000001014B0001B6010000CF7D
|
AVL Data Packet | ||
---|---|---|
AVL Data Packet Part | HEX Code Part | |
Zero Bytes | 00 00 00 00 | |
Data Field Length | 00 00 00 48 | |
Codec ID | 8E (Codec8 Extended) | |
Number of Data 1 (Number of Total Records) | 01 | |
AVL Data | Timestamp | 00 00 01 7C A6 B6 BF D8 (GMT: Friday, 22 October 2021 06:36:07) |
Priority | 01 | |
Longitude | 0F 0E 51 88 | |
Latitude | 20 9A B4 82 | |
Altitude | 00 86 | |
Angle | 00 0A | |
Satellites | 0E | |
Speed | 00 00 | |
Event IO ID | 00 00 | |
N of Total ID | 00 06 | |
N1 of One Byte IO | 00 00 | |
N2 of Two Bytes IO | 00 02 | |
ID | 00 19 (25 = BLE Temperature #1) | |
Value | 09 04 (2308=23.08°C) | |
ID | 00 56 (86 = BLE Humidity #1) | |
Value | 00 36 (24 %RHT) | |
N4 of Four Bytes IO | 00 03 | |
ID | 01 CF (463 - BLE 1 Custom #2 = Movement status and movement events count) | |
Value | 00 00 00 16 (Currently not moving events count 22) | |
ID | 01 D0 (464 - BLE 1 Custom #3 = Angle ) | |
Value | 00 00 FF 4D (Pitch = 0°, Roll = -179°) | |
ID | 01 D1 (465 - BLE 1 Custom #4 = Battery Voltage) | |
Value | 00 00 00 6D (109 = 2000 + 109 * 10 mV = 3090 mV) | |
N8 of Eight Bytes IO | 00 00 | |
NX of X Bytes IO | 00 01 | |
N’th IO ID - AVL ID. | 01 4B (331 - BLE 1 Custom #1 = Flags) | |
Length of Variable Length IO | 00 01 | |
Value of Variable Length IO | B7 = (MSB)11011 0111(LSB)
It's parsed from least significant byte(LSB):
1 Means device is reading and transmitting temperature value.
1 Means device is reading and transmitting humidity value.
1 Means device is reading and transmitting Magnetic sensor value.
1 magnetic field is detected/0 magnetic field is not detected) Valid value is present only if bit 2 flag is set.
1 Means device is reading and transmitting movement state and count values.
1 Means device is reading and transmitting angle roll and pitch values.
0 – Means device battery is from 100 to 15 % (When value changes to 1 Battery level is lower than 15 %.
1 Means device is reading and transmitting battery voltage value. | |
Number of Data 2 (Number of Total Records) | 01 | |
CRC-16 | 00 00 CF 7D |
FM EYE Sensor record parsing example with the new firmware (EYE Sensor filtering by name / not released yet)
Parsing EYE Sensor records example
Below You will find an example on how to parse EYE Sensor record with two EYE Sensors present.
Unparsed data | ||
---|---|---|
Received data in hexadecimal stream: 00000000000000908E0100000183407a2beb000f0e3fe3209ab40e008801290d00002c350001000000000 000000000012c3500630130050f4d50315f42453241413500000000000602d60807012f0801000901000a024e000b01f90c025aff0d01000e020bcc 30050f4d50315f33464539414100000000000602cb080701300801000901000a0263000b01000c02af000d01000e020b90010000f178
|
AVL Data Packet | ||
---|---|---|
AVL Data Packet Part | HEX Code Part | |
Zero Bytes | 00 00 00 00 | |
Data Field Length | 00 00 00 90 | |
Codec ID | 8E (Codec8 Extended) | |
Number of Data 1 (Number of Total Records) | 01 | |
AVL Data | Timestamp | 00 00 01 83 40 7a 2b eb(GMT: Tuesday, 18 June 2019 08:25:22.001) |
Priority | 00 | |
Longitude | 0f 0e 3f e3 | |
Latitude | 20 9a b4 0e | |
Altitude | 00 88 | |
Angle | 01 29 | |
Satellites | 0d | |
Speed | 00 00 | |
Event IO ID | 2c 35 (11317) | |
N of Total ID | 00 01 | |
N1 of One Byte IO | 00 00 | |
N2 of Two Bytes IO | 00 00 | |
N4 of Four Bytes IO | 00 00 | |
N8 of Eight Bytes IO | 00 00 | |
NX of X Bytes IO | 00 01 | |
N’th IO ID - AVL ID. | 2c 35 (11317) | |
Length of Variable Length IO | 00 63 (99 bytes) | |
Value of Variable Length IO 11317 |
0130050f4d50315f42453241413500000000000602d60807012f0801000901000a024e000b01f90c025aff0d01000e020bcc 30050f4d50315f33464539414100000000000602cb080701300801000901000a0263000b01000c02af000d01000e020b90 | |
Number of Data 2 (Number of Total Records) | 01 | |
CRC-16 | 00 00 f1 78 |
Parsing AVL ID 11317 data
AVL ID 11317 Unparsed data | ||
---|---|---|
630130050f4d50315f42453241413500000000000602d60807012f0801000901000a024e000b01f90c025aff0d01000e020bcc 30050f4d50315f33464539414100000000000602cb080701300801000901000a0263000b01000c02af000d01000e020b90
|
Parsing the data | ||
---|---|---|
AVL Data packet part | HEX Code Part | |
AVL ID Data Length | 00 63 | |
Constant | 01 | |
Eye Sensor #1 data length | 30 (48 bytes) | |
1st Parameter ID | 05 (Eye Sensor Device name) | |
AVL Data | Parameter data length | 0f (15 bytes) |
Parameter data | 4d 50 31 5f 42 45 32 41 41 35 00 00 00 00 00 | |
2nd Parameter ID | 06 (Eye Sensor #1 temperature) | |
Parameter data length | 02 (2 bytes) | |
Parameter data | d6 08 (little endian, converted to decimal and multiplied by 0.01C = 22.42C) | |
Parameter ID | 07 (Eye Sensor #1 Humidity) | |
Parameter data length | 01 (1 byte) | |
Parameter data | 2f (converted to decimal = 47%) | |
Parameter ID | 08 (Eye Sensor #1 Magnet) | |
Parameter data length | 01 (1 byte) | |
Parameter Data | 00 (no magnet detected) | |
Parameter ID | 09 (EYE Sensor #1 Movement presence) | |
Parameter data length | 01 (1 byte) | |
Parameter data | 00 (none detected) | |
Parameter ID | 0a (parameter ID #10, EYE Sensor #1 Movement count) | |
Parameter Data length | 02 (2 bytes) | |
Parameter data | 4e 00 (converted to dec = 19968) | |
Parameter ID | 0b (Parameter ID #11 Eye Sensor #1 Pitch) | |
Parameter Data length | 01 (1 byte) | |
Parameter data | f9 (converted to decimal = 159 degrees) | |
Parameter ID | 0c (Parameter ID #12 Eye sensor #1 Roll) | |
Parameter data length | 02 (2 bytes) | |
Parameter data | 5a ff (Eye Sensor Roll value) | |
Parameter ID | 0d (parameter ID #13 low battery voltage indicator) | |
Parameter data length | 01 (1 byte) | |
Parameter data | 00 (low battery voltage not detected) | |
Parameter ID | 0e (Eye Sensor #1 battery voltage) | |
Parameter data length | 02 (2 bytes) | |
Parameter data | 0b cc (Converted to decimal = 3020 mV) | |
Eye Sensor #2 data length | 30 (48 bytes) | |
Parameter ID | 05 (Eye Sensor Device name) | |
Parameter data length | 0f (15 bytes) | |
Parameter Data | 09 (EYE Sensor #1 Movement presence) | |
Parameter ID | 06 (Eye Sensor #1 temperature) | |
Parameter data length | 02 (2 bytes) | |
Parameter Data | cb 08 (little endian, converted to decimal and multiplied by 0.01C = 22.51C) | |
Parameter ID | 07 (Eye Sensor #1 Humidity) | |
Parameter data length | 01 (1 byte) | |
Parameter Data | 30 (converted to decimal = 48%) | |
Parameter ID | 08 (Eye Sensor #1 Magnet) | |
Parameter data length | 01 (1 byte) | |
Parameter Data | 00 (no magnet presence detected) | |
Parameter ID | 09 (EYE Sensor #1 Movement presence) | |
Parameter data length | 01 (1 byte) | |
Parameter Data | 00 (no movement presence detected) | |
Parameter ID | 0a (parameter ID #10, EYE Sensor #1 Movement count) | |
Parameter data length | 02 (2 bytes) | |
Parameter Data | 63 00 (converted to decimal = 25344) | |
Parameter ID | 0b (Parameter ID #11 Eye Sensor #1 Pitch) | |
Parameter data length | 01 (1 byte) | |
Parameter Data | 00 (converted to dec = 0 degrees) | |
Parameter ID | 0c (Parameter ID #12 Eye sensor #1 Roll) | |
Parameter data length | 02 (2 bytes) | |
Parameter Data | af 00 (Converted to dec = 44800) | |
Parameter ID | 0d (parameter ID #13 low battery voltage indicator) | |
Parameter data length | 01 (1 byte) | |
Parameter Data | 00 (low battery voltage not detected) | |
Parameter ID | 0e (Eye Sensor #1 battery voltage) | |
Parameter data length | 02 (2 bytes) | |
Parameter Data | 0b 90 (Converted to decimal = 2960mV) |
Safety information
This message contains information on how to operate BTSID1 safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device!
1. To avoid mechanical damage, it is advised to transport the device in an impact-proof package.
2. In case of malfunction contact yours Teltonika account manager or write to technical support team over VIP helpdesk.
Certification & Approvals
Certificates | |
---|---|
E-Mark (EU) | YES |
FCC (USA) | YES |
CE/RED (EU) | YES |
RoHS (EU) | YES |
REACH (EU) | YES |
Anatel(EU) (PR) | YES |
IP rating | YES |
External Links
Product Page
https://teltonika-gps.com/eye/
Product Change Notifications
The latest Product Change Notifications can be found: Product Change Notifications
Compatibilty with other Teltonika Devices
Teltonika Networks: https://wiki.teltonika-networks.com/view/Bluetooth_EYE_Sensor_and_EYE_Beacon_support
Partner Providers Supporting Software
Frequently asked questions
- Questions about Power and Electrical characteristics
- Questions about EYE Accessory configuration (EYE APP)
- Questions about FMBxxx compatibility with EYE Accessories
- Questions about Protocols
- Other questions (Questions without category)