| Line 35: |
Line 35: |
| | '''Configure window''': In this window you can check and change device configuration settings. In main tab Basic Settings (1) you can change main settings. Change Device name (2.1), Power signal strength (2.2), Advertising interval (2.3) and Packet (2.4) transmition type. For more settings go to Advanced settings (3) tab to enable various events. | | '''Configure window''': In this window you can check and change device configuration settings. In main tab Basic Settings (1) you can change main settings. Change Device name (2.1), Power signal strength (2.2), Advertising interval (2.3) and Packet (2.4) transmition type. For more settings go to Advanced settings (3) tab to enable various events. |
| | <br><br></br><br></br><br></br><br></br><br></br> | | <br><br></br><br></br><br></br><br></br><br></br> |
| | + | |
| | ==Protocol overwiev== | | ==Protocol overwiev== |
| | + | |
| | ===Beacon advertising=== | | ===Beacon advertising=== |
| | [[File:Beacon advertising.jpg|800px|center]] | | [[File:Beacon advertising.jpg|800px|center]] |
| − | ===Beacon and sensors data===
| |
| − | [[File:beacon and sensor data.jpg|800px|center]]
| |
| − | ===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.
| |
| − | <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>
| |
| − | {| class="wikitable"
| |
| − | |+ 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
| |
| − | |}
| |
| − | {| class="wikitable" style="text-align: center;
| |
| − | |+ Table 2. Extended Data
| |
| − | |-
| |
| − | ! Type !! Description
| |
| − | |-
| |
| − | |colspan="2"| '''1 byte types'''
| |
| − | |-
| |
| − | | 0 || For future use
| |
| − | |-
| |
| − | | ... || For future use
| |
| − | |-
| |
| − | | 49 || For future use
| |
| − | |-
| |
| − | |colspan="2"| '''2 bytes types'''
| |
| − | |-
| |
| − | | 50 || For future use
| |
| − | |-
| |
| − | | ... || For future use
| |
| − | |-
| |
| − | | 99 || For future use
| |
| − | |-
| |
| − | |colspan="2"| '''4 bytes types'''
| |
| − | |-
| |
| − | | 100 || For future use
| |
| − | |-
| |
| − | | ... || For future use
| |
| − | |-
| |
| − | | 149 || For future use
| |
| − | |-
| |
| − | |colspan="2"| '''8 bytes types'''
| |
| − | |-
| |
| − | | 150 || For future use
| |
| − | |-
| |
| − | | ... || For future use
| |
| − | |-
| |
| − | | 199 || For future use
| |
| − | |-
| |
| − | |colspan="2"| '''Variable size types'''
| |
| − | |-
| |
| − | | 200 || For future use
| |
| − | |-
| |
| − | | ... || For future use
| |
| − | |-
| |
| − | | 255 || For future use
| |
| − | |-
| |
| − | |}
| |
| − | ===Protocol parsing example===
| |
| − | <br>
| |
| − | {| 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:#9F2B68">02</span><span style="background:#F19CBB">0C</span><span style="background:#3B7A57">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:#FDEE00">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>
| |
| − | |}
| |
| − |
| |
| | | | |
| | ==Product information== | | ==Product information== |
| Line 261: |
Line 161: |
| | 2. In case of malfunction contact yours Teltonika account manager or write to technical support team over VIP helpdesk.<br> | | 2. In case of malfunction contact yours Teltonika account manager or write to technical support team over VIP helpdesk.<br> |
| | [[File:Safety.jpg]] | | [[File:Safety.jpg]] |
| | + | |
| | + | ==External Links== |
| | + | https://teltonika-gps.com/eye/ |
