Difference between revisions of "EYE SENSOR / BTSMP1"
Line 142: | Line 142: | ||
[[File:Mounting recomendations 1.jpg]] | [[File:Mounting recomendations 1.jpg]] | ||
− | ==Configurating | + | ==Configurating EYE sensor== |
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. | ||
Line 152: | Line 152: | ||
<br>[[File:QR.jpg]] | <br>[[File:QR.jpg]] | ||
− | === | + | ===Device configuration=== |
'''With the application you will be able to scan for visible Teltonika EYE devices, check their statuses or connect for configuration or firmware update.''' | '''With the application you will be able to scan for visible Teltonika EYE devices, check their statuses or connect for configuration or firmware update.''' | ||
<br> | <br> | ||
{| | {| | ||
− | |-align=" | + | |- align="TOP" |
| | | | ||
|[[File:Detailed_list_-_collapsed.png|border|360x640px|none]] | |[[File:Detailed_list_-_collapsed.png|border|360x640px|none]] | ||
Line 162: | Line 162: | ||
|[[File:Overview - without update (sensor).png|border|360x640px|none]] | |[[File:Overview - without update (sensor).png|border|360x640px|none]] | ||
| | | | ||
− | |[[File:Basic settings.png|right|border|360x640px | + | |[[File:Basic settings.png|right|border|360x640px]] |
| | | | ||
− | |[[File:Advanced settings.png|right|border|360x640px | + | |[[File:Advanced settings.png|right|border|360x640px]] |
|} | |} | ||
Line 179: | Line 179: | ||
<br> | <br> | ||
[[File:Group 117.png|sub|frameless|upright=0.2|link=|alt=]]'''Advanced configuration window''': | [[File:Group 117.png|sub|frameless|upright=0.2|link=|alt=]]'''Advanced configuration window''': | ||
+ | |||
Beacon information (iBeacon ID, Eddystone ID) | Beacon information (iBeacon ID, Eddystone ID) | ||
+ | {| | ||
+ | |- align="TOP" | ||
+ | | | ||
+ | [[File:IBeacon ID settings.png|frameless]] | ||
+ | | | ||
+ | |[[File:Eddystone ID settings.png|frameless]] | ||
+ | |} | ||
+ | |||
'''Sensor reading interval''' - how often values are updated by the device | '''Sensor reading interval''' - how often values are updated by the device | ||
Line 216: | Line 225: | ||
==Protocol overwiev== | ==Protocol overwiev== | ||
− | ===Sensor advertising=== | + | ===Sensor advertising === |
<br> | <br> | ||
[[File:Sensors data.png|center]] | [[File:Sensors data.png|center]] | ||
Line 226: | Line 235: | ||
===Protocol description=== | ===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. | 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><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. | 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><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. | 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><br> |
Device Name has the following default value for Beacon – ID1_XXXXXXX | Device Name has the following default value for Beacon – ID1_XXXXXXX | ||
<br> | <br> | ||
− | <div style=display:inline-table> | + | <div style="display:inline-table"> |
− | {| class="nd-othertables_2" | + | {| class="nd-othertables_2" style="width:100%;" ; |
− | |+ '''Table 1. Flag Encoded Date''' | + | |+'''Table 1. Flag Encoded Date''' |
|- | |- | ||
− | ! Data !! Size (Bytes) !! Description | + | ! Data!!Size (Bytes)!!Description |
|- | |- | ||
− | | Flags|| 1|| Each set bit (0-7) means the presence of value (0-7). Bits: | + | |Flags||1||Each set bit (0-7) means the presence of value (0-7). Bits: |
<br>0 – Temperature value presence | <br>0 – Temperature value presence | ||
<br>1 – Humidity value presence | <br>1 – Humidity value presence | ||
Line 249: | Line 258: | ||
<br>7 – Battery voltage value presence | <br>7 – Battery voltage value presence | ||
|- | |- | ||
− | | Value 0 || 2|| Temperature | + | | Value 0||2 ||Temperature |
<br>Value in Celsius * 100 | <br>Value in Celsius * 100 | ||
<br>NOTE: present only if bit 0 is set, otherwise is not being sent | <br>NOTE: present only if bit 0 is set, otherwise is not being sent | ||
|- | |- | ||
− | | Value 1 || 1|| Humidity | + | |Value 1||1||Humidity |
<br>Value in percent | <br>Value in percent | ||
<br>NOTE: present only if bit 1 is set, otherwise is not being sent | <br>NOTE: present only if bit 1 is set, otherwise is not being sent | ||
|- | |- | ||
− | | Value 2 || 2|| Movement Sensor counter | + | | Value 2||2||Movement Sensor counter |
<br>Most significant bit indicates movement state and 15 least significant bits represent count of movement events. | <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 | <br>NOTE: present only if bit 4 is set, otherwise is not being sent | ||
|- | |- | ||
− | | Value 3 || 3|| Movement sensor angle | + | |Value 3||3||Movement sensor angle |
<br>Most significant byte – pitch (-90/+90) | <br>Most significant byte – pitch (-90/+90) | ||
<br>Two least significant bytes – roll (-180/+180) | <br>Two least significant bytes – roll (-180/+180) | ||
<br>NOTE: present only if bit 5 is set, otherwise is not being sent | <br>NOTE: present only if bit 5 is set, otherwise is not being sent | ||
|- | |- | ||
− | | Value 4 || 1|| Battery Voltage | + | | Value 4|| 1||Battery Voltage |
<br>Battery voltage in mV = 2000 + VALUE * 10 | <br>Battery voltage in mV = 2000 + VALUE * 10 | ||
<br>NOTE: present only if bit 7 is set, otherwise is not being sent | <br>NOTE: present only if bit 7 is set, otherwise is not being sent | ||
|} | |} | ||
</div> | </div> | ||
− | <div style=display:inline-table> | + | <div style="display:inline-table"> |
− | {| class="nd-othertables_2" style="text-align: center; | + | {| class="nd-othertables_2" style="text-align: center;" |
− | |+ '''Table 2. Extended Data''' | + | |+'''Table 2. Extended Data''' |
|- | |- | ||
− | ! Type !! Description | + | !Type!!Description |
|- | |- | ||
− | |colspan="2"| '''1 byte types''' | + | | colspan="2" |'''1 byte types''' |
|- | |- | ||
− | | 0 || For future use | + | |0 ||For future use |
|- | |- | ||
− | | ... || For future use | + | |... ||For future use |
|- | |- | ||
− | | 49 || For future use | + | |49||For future use |
|- | |- | ||
− | |colspan="2"| '''2 bytes types''' | + | | colspan="2" |'''2 bytes types''' |
|- | |- | ||
− | | 50 || For future use | + | |50||For future use |
|- | |- | ||
− | | ... || For future use | + | |...||For future use |
|- | |- | ||
− | | 99 || For future use | + | |99 ||For future use |
|- | |- | ||
− | |colspan="2"| '''4 bytes types''' | + | | colspan="2" |'''4 bytes types''' |
|- | |- | ||
− | | 100 || For future use | + | |100||For future use |
|- | |- | ||
− | | ... || For future use | + | |...||For future use |
|- | |- | ||
− | | 149 || For future use | + | |149||For future use |
|- | |- | ||
− | |colspan="2"| '''8 bytes types''' | + | | colspan="2" |'''8 bytes types''' |
|- | |- | ||
− | | 150 || For future use | + | |150 ||For future use |
|- | |- | ||
− | | ... || For future use | + | |...||For future use |
|- | |- | ||
− | | 199 || For future use | + | |199 ||For future use |
|- | |- | ||
− | |colspan="2"| '''Variable size types''' | + | | colspan="2" |'''Variable size types''' |
|- | |- | ||
− | | 200 || For future use | + | |200||For future use |
|- | |- | ||
− | | ... || For future use | + | |...||For future use |
|- | |- | ||
− | | 255 || For future use | + | |255||For future use |
|- | |- | ||
|} | |} | ||
Line 326: | Line 335: | ||
! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Unparsed data | ! 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">0000</span><span style="background:#BFFF00">C1001A</span><span style="background:#00BFFF">6E</span> | + | | 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">0000</span><span style="background:#BFFF00">C1001A</span><span style="background:#00BFFF">6E</span> |
|} | |} | ||
<br> | <br> | ||
Line 368: | Line 377: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Minor | | 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;" |<span style="background:#E52B50">0055</span> |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Power | | style="vertical-align: middle; text-align: center;" |Power | ||
Line 376: | Line 385: | ||
| style="vertical-align: middle; text-align: center;" |<span style="background:#03C03C">0C</span> | | 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;" | Type |
| style="vertical-align: middle; text-align: center;" |<span style="background:#FF3800">09</span> | | style="vertical-align: middle; text-align: center;" |<span style="background:#FF3800">09</span> | ||
|- | |- | ||
Line 427: | Line 436: | ||
| style="vertical-align: middle; text-align: center;" |Humidity | | style="vertical-align: middle; text-align: center;" |Humidity | ||
| style="vertical-align: middle; text-align: center;" |<span style="background:#007FFF">12</span> | | style="vertical-align: middle; text-align: center;" |<span style="background:#007FFF">12</span> | ||
− | |Raw value example 0x12 hex, 18 dec. | + | | Raw value example 0x12 hex, 18 dec. |
Decimal value is humidity in percent. Humidity 18 % | Decimal value is humidity in percent. Humidity 18 % | ||
|- | |- | ||
Line 452: | Line 461: | ||
|} | |} | ||
− | ==Safety information== | + | == 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! | 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! | ||
Revision as of 12:08, 20 August 2021
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 or fall events. 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 information
Features
Functionalities |
---|
Beacon ID, LED, Temperature, Humidity, Accelerometer, Magnet detection |
Dimensions and weight | |
---|---|
Dimensions | 56,6 mm x 38 mm x 13 mm |
Weight 19 g | 19g |
Battery and power (not confirmed) | |
---|---|
Model | CR2450 |
Type | Lithium / Manganese Dioxide (Li/MnO2) |
Total Capacity | 620 mAh |
Replaceable | No |
Battery life (Tx=2 dBm; interval: 3 s) | 5 years |
Battery life (Tx=2 dBm; interval: 10 s) | 8 years |
Electronic | |
---|---|
Microcontroller | ST Microelectronics BlueNRG-2 |
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 95% |
Operational temperature | -20°C / +60°C (-4°F / +140°F) (Possible to have -40°C / + 85°C (-40°F / +185°F)) |
Protocols compatibility | |
---|---|
iBeacon | Yes |
Eddystone | Yes |
Teltonika | Yes |
Certificates | |
---|---|
CE (EU) | Yes |
FCC (USA) | Yes |
UKCA (UK) | Yes |
RoHS | Yes |
E-mark | Yes |
Dimensions
Mounting recomendations
Configurating EYE sensor
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 3 second intervals.
• Eddystone 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.
Device configuration
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 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.
In Advanced settings tab you can can configure EYE beacon sensor parameters:
Advanced configuration window:
Beacon information (iBeacon ID, Eddystone ID)
Sensor reading interval - how often values are updated by the device
Event advertising settings - how often device will scan for new events
Maximum event duration - how long will one event be advertised
Movement event - adjust movement/stop detection and timeouts it takes to register movement / stopping
Temperature event - adjust if the device generates events based on entrance or exit to selected temperature range
Humidity event - adjust if the device generates events based on entrance or exit to selected humidity range
Magnetic field event - adjust if the device generates events based on detection or exit (loss) of the magnet.
Protocol overwiev
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
|
Type | Description |
---|---|
1 byte types | |
0 | For future use |
... | For future use |
49 | For future use |
2 bytes types | |
50 | For future use |
... | For future use |
99 | For future use |
4 bytes types | |
100 | For future use |
... | For future use |
149 | For future use |
8 bytes types | |
150 | For future use |
... | For future use |
199 | For future use |
Variable size types | |
200 | For future use |
... | For future use |
255 | For future use |
Protocol parsing example
Unparsed data | ||
---|---|---|
0201061AFF4C000215FFFFFFFF0B8C404510C655AAB636EBEFBB700055020C094D50315F313233343536370EFF9A0801B708B4120000C1001A6E |
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)11011 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 | C1 – 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 | 6E | 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 |
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.