Difference between revisions of "BASIC TRACK & TRACE"
m (Text replacement - "Bluetooth" to "Bluetooth®") |
|||
(22 intermediate revisions by 2 users not shown) | |||
Line 4: | Line 4: | ||
==Solution description== | ==Solution description== | ||
− | Teltonika GPS trackers are developed on one common firmware platform, which is constantly being developed and extended with new features. A common platform means that the main core of functionality is the same on all types of our trackers – be it professional, advanced or simple tracker. Smart usage of functions opens for a user various possibilities and brings a valuable advantage comparing to other GPS trackers of a similar price range in the market, making them suitable for different telematics solutions. | + | Teltonika GPS trackers are developed on one '''common firmware platform''', which is constantly being developed and extended with new features. A common platform means that the main core of functionality is the same on all types of our trackers – be it professional, advanced or simple tracker. Smart usage of functions opens for a user various possibilities and brings a valuable advantage comparing to other GPS trackers of a similar price range in the market, making them suitable for different telematics solutions. |
− | + | [[File:BasicTrackAndTrace.png|alt=|right|thumb|800x400px]] | |
− | For a fast and easy “Teltonika data protocols” implementation, data packets parser tool and source code examples of communication server are prepared. For an easy control of the whole fleet, customers get access to FOTA WEB service for free. FOTA WEB is a powerful tool for remote configuration and firmware updates. Trackers support universal configurator – a tool for configuration, firmware updates and testing. | + | For a fast and easy “Teltonika data protocols” implementation, data packets parser tool and source code examples of communication server are prepared. For an easy control of the whole fleet, customers get access to '''FOTA WEB''' service for free. FOTA WEB is a powerful tool for remote configuration and firmware updates. Trackers support '''universal configurator''' – a tool for configuration, firmware updates and testing. |
The basic firmware functionality supports such generic features like sleep modes, trip detection, and different data acquisition modes that depend on ignition/movement source or even the connected GSM operator. The device supports different ignition detection modes, depending on the installation variant. Moreover, it supports such advanced functions like auto geofence, towing detection, green driving, crash event detection, virtual odometer, unplug detection, GPRS/SMS notifications and many more. The user can easily enable the function he needs using the configurator or FOTA WEB and change the configuration in accordance with the changing needs of the client. | The basic firmware functionality supports such generic features like sleep modes, trip detection, and different data acquisition modes that depend on ignition/movement source or even the connected GSM operator. The device supports different ignition detection modes, depending on the installation variant. Moreover, it supports such advanced functions like auto geofence, towing detection, green driving, crash event detection, virtual odometer, unplug detection, GPRS/SMS notifications and many more. The user can easily enable the function he needs using the configurator or FOTA WEB and change the configuration in accordance with the changing needs of the client. | ||
− | Teltonika trackers also support BLE technology that significantly expands their functionality. For example, if a client wants to get more telemetric vehicle data, it is possible to connect via | + | Teltonika trackers also support '''BLE technology''' that significantly expands their functionality. For example, if a client wants to get more telemetric vehicle data, it is possible to connect via Bluetooth® OBDII dongle and read such data like millage, engine hours, engine faults, fuel level, etc. Advanced BLE mode lets to configure BLE beacons and various BLE sensors (temperature, humidity, movement, etc.). BLE beacons can be used as an immobilizer or for the authentication of drivers and passengers. Another possible way of using them is to monitor assets during transportation, even for indoor tracking. By the way, it also is possible to configure a device via Bluetooth®. Teltonika provides Bluetooth® communication protocols so that users could develop their own mobile application to read notifications in real time and do many other useful functions with their trackers. |
==What you need for a solution?== | ==What you need for a solution?== | ||
− | *''' | + | *'''FMx920''' device ([https://wiki.teltonika-gps.com/view/FMB920 '''FMB920'''] is taken as example) a simple tracker with a basic set of functions. |
{| class="mw-collapsible mw-collapsed wikitable" | {| class="mw-collapsible mw-collapsed wikitable" | ||
| Other devices that work with this solution: | | Other devices that work with this solution: | ||
|- | |- | ||
− | | [https://wiki.teltonika-gps.com/view/ | + | | [https://wiki.teltonika-gps.com/view/FMB965 '''FMB965'''], [https://wiki.teltonika-gps.com/view/FMC920 '''FMC920'''], [https://wiki.teltonika-gps.com/view/FMB003 '''FMB003'''], [https://wiki.teltonika-gps.com/view/FMB001 '''FMB001'''], [https://wiki.teltonika-gps.com/view/FMC003 '''FMC003'''], [https://wiki.teltonika-gps.com/view/FMM920 '''FMM920'''], [https://wiki.teltonika-gps.com/view/FMM003 '''FMM003'''], [https://wiki.teltonika-gps.com/view/FMB002 '''FMB002'''], [https://wiki.teltonika-gps.com/view/FMB020 '''FMB020'''] |
|} | |} | ||
− | *The [https://wiki.teltonika-gps.com/view/ | + | *The [https://wiki.teltonika-gps.com/view/FMB920_First_Start#How_to_insert_Micro-SIM_card '''SIM card'''] in order to get data to your server |
− | *[https://wiki.teltonika-gps.com/view/ | + | *[https://wiki.teltonika-gps.com/view/EYE_FAQ '''EYE BEACON/SENSOR'''] BLE sensors that can be additionally connected if necessary |
− | *[https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTA WEB'''] to remotely send the configuration to the device | + | *[https://wiki.teltonika-gps.com/view/How_to_connect_OBD_II_Bluetooth®_Dongle_to_FMB_device#Supported_Bluetooth®_OBD_II_dongles '''Bluetooth® OBD II dongles'''] Bluetooth® OBD II dongles from other manufacturers can be connected if necessary to receive data from the OBD connector |
+ | *[https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTA WEB'''] to remotely send the configuration to the device<br /> | ||
==Installation== | ==Installation== | ||
− | It’s important to hide the tracker, so it would not be a simple task for the thieves to find and unplug it. But also, please do not forget to follow [https://wiki.teltonika-gps.com/view/ | + | It’s important to hide the tracker, so it would not be a simple task for the thieves to find and unplug it. But also, please do not forget to follow [https://wiki.teltonika-gps.com/view/FMB920_First_Start#Mounting_recommendations mounting recommendations] as well. |
Although devices have high gain antennas it’s important to mount devices with stickers on top and in metal-free space. The device should be firmly fixed to the surface or cables. Please make sure, that device is not fixed to heat emitting or moving parts. | Although devices have high gain antennas it’s important to mount devices with stickers on top and in metal-free space. The device should be firmly fixed to the surface or cables. Please make sure, that device is not fixed to heat emitting or moving parts. | ||
− | + | [[File:MAGNET.png|alt=|left|thumb|600x200px]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | = | + | Additional accessories such as '''EYE SENSOR''' or '''EYE BEACON''' can be used for this solution. EYE SENSOR can transmit to the tracker parameters such as temperature, humidity, angle, movement, data on the presence of a magnetic field. EYE SENSOR and EYE BEACON can transmit a unique identification number, which can be used in many scenarios, such as an immobilizer, more details [https://wiki.teltonika-gps.com/view/FMB920_Features_settings#Immobilizer here]. Also, check more detailed information about EYE SENSOR and EYE BEACON [https://wiki.teltonika-gps.com/view/EYE_SENSOR_/_BTSMP1 here] and [https://wiki.teltonika-gps.com/view/EYE_BEACON_/_BTSID1 here]. |
+ | [[File:OBDdongle.png|alt=|left|thumb|800x300px]] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | You can also use third-party '''OBD BT dongles''' for this solution (if there is a need to get data from the vehicle's OBDII interface. You can read more about selecting the appropriate OBD BT dongle models [https://wiki.teltonika-gps.com/view/How_to_connect_OBD_II_Bluetooth®_Dongle_to_FMB_device#Supported_Bluetooth®_OBD_II_dongles here]. | ||
+ | <br> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | ==Configuration== | ||
+ | ==='''1. Prerequisites:'''=== | ||
+ | ====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB920_First_Start First start guide]==== | ||
+ | ====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB920_Sleep_modes Sleep modes].==== | ||
+ | ==='''2. BASIC TRACK & TRACE configuration:'''=== | ||
+ | [[File:GPRS settings.png|alt=|left|thumb|258x258px]] | ||
− | + | Parameter ID – Parameter name GPRS settings: | |
− | |||
<br /> | <br /> | ||
+ | *<span style="background-color:#91b9d4;">2001</span> – APN | ||
+ | *<span style="background-color:#91d4b9;">2002</span> – APN username (if there are no APN username, empty field should be left) | ||
+ | *<span style="background-color:#b991d4;">2003</span> – APN password (if there are no APN password, empty field should be left) | ||
+ | [[File:SERVER settings.png|alt=|left|thumb|259x259px]] | ||
Line 117: | Line 92: | ||
+ | <br />Server settings: | ||
+ | *<span style="background-color:#b9d491;">2004</span> – Domain | ||
+ | *<span style="background-color:#d491b9;">2005</span> – Port | ||
+ | *<span style="background-color:#d4b991;">2006</span> – Data sending protocol (0 – TCP, 1 – UDP) | ||
+ | |||
+ | <br /> | ||
− | |||
− | [[File: | + | After successful GPRS/SERVER settings configuration, FMB920 device will '''synchronize time''' and '''update records''' to '''the configured server'''. Time intervals and default I/O elements can be changed by using [https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions Teltonika Configurator] or [https://wiki.teltonika-gps.com/view/FMB920_Parameter_list FMB920 Parameter list|SMS parameters].<br /> |
+ | [[File:Online_deep_sleep_carsharing.PNG|alt=|left|thumb]] | ||
+ | |||
+ | |||
+ | Sleep settings: | ||
<br /> | <br /> | ||
+ | *<span style="background:#05CC6F">102</span> – Sleep settings(0 – Disable, 1 – Gps sleep, 2 – Deep sleep, 3 – Online Deep sleep, 4 – Ultra sleep) | ||
+ | '''Note''': This scenario will not work with [[FMB130 Sleep modes#Deep%20Sleep%20mode|Deep Sleep]] and [[FMB130 Sleep modes#Ultra%20Deep%20Sleep%20mode|Ultra Sleep]] modes, since they disable the device's GSM module to save power. | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | Can adapter settings: | ||
+ | <br /> | ||
+ | [[File:Obdii.png|alt=|left|455x455px|thumb]] | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | *<span style="background-color:#E18DE7;">807</span> – OBDII mode (This setting enables the BT module in ODBII mode) | ||
+ | <br /> | ||
+ | <br /> | ||
− | *<span style="background-color:# | + | *<span style="background-color:#dee11d;">805</span> – This field contains the name of the device to which the tracker will connect via the BT channel |
− | + | <br /> | |
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:ObdIO.png|alt=|left|452x452px|thumb]] | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | *<span style="background-color:#1de1d2;">40100</span> – Number Of DTC, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic ) | ||
+ | *<span style="background-color:#e1701d;">40160</span> – Engine RPM, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic ) | ||
+ | *<span style="background-color:#bce5d7;">40170</span> – Vehicle Speed, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic ) | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | '''Quickstart:''' From default configuration to BASIC TRACK & TRACE solution in one SMS: | ||
+ | " setparam <span style="background-color:#91b9d4;">2001</span>:APN;<span style="background-color:#91d4b9;">2002</span>:APN_user;<span style="background-color:#b991d4;">2003</span>:APN_password;<span style="background-color:#b9d491;">2004</span>:Domain;<span style="background-color:#d491b9;">2005</span>:Port;<span style="background-color:#d4b991;">2006</span>:0;<span style="background:#05CC6F">102</span>:3;<span style="background:#E18DE7">807</span>:2;<span style="background-color:#dee11d;">805</span>:DONGLE;<span style="background-color:#1de1d2;">40100</span>:1;<span style="background-color:#e1701d;">40160</span>:1;<span style="background-color:#bce5d7;">40170</span>:1" | ||
+ | This SMS will set up your device to report the BASIC TRACK & TRACE scenario to the server and the possibility receive data when using OBDII BT dongle. | ||
+ | '''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings. | ||
+ | '''To use EYE SENSOR sensors''', it is best to use the Teltonika configurator, as it becomes necessary to select the correct preset. | ||
+ | [[File:Codec 8.png|alt=|left|452x452px|thumb]] | ||
− | |||
<br /> | <br /> | ||
<br /> | <br /> | ||
<br /> | <br /> | ||
− | |||
<br /> | <br /> | ||
− | + | <br /> | |
− | + | *Set the Data Protocol setting to Codec 8 Extended | |
− | + | <br /> | |
− | + | <br /> | |
− | + | <br /> | |
− | + | <br /> | |
+ | <br /> | ||
+ | [[File:Sensor settings.png|alt=|left|452x452px|thumb]] | ||
+ | <br /> | ||
+ | *In the Bluetooth® 4.0 section, set the operating mode for one of the 4 sensors as Advanced | ||
+ | <br /> | ||
+ | <br /> | ||
+ | *Enter the MAC address of the sensor | ||
+ | <br /> | ||
+ | <br /> | ||
+ | *Select the appropriate preset and load it | ||
+ | <br /> | ||
+ | <br /> | ||
+ | [[File:Sensor IO.png|alt=|left|452x452px|thumb]] | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | *In the I / O section, select the sensor parameters of interest: these can be temperature, humidity, motion sensor, magnetic field sensor, tilt angle sensor, sensor battery level. | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
+ | <br /> | ||
==Parsing information== | ==Parsing information== | ||
Line 172: | Line 224: | ||
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream | ! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" | 00 00 00 00 00 00 00 32 8E 01 00 00 01 7E 06 5D E1 B8 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 C0 00 06 <span style="background:#0b9768">00 EF</span> <span style="background:#d4f991">00</span> <span style="background:#0b9768">00 F0</span> <span style="background:#d4f991">00</span> <span style="background:#0b9768">00 01</span> <span style="background:#d4f991">01</span> <span style="background:#0b9768">00 B3</span> <span style="background:#d4f991">01</span> <span style="background:#0b9768">00 1E</span> <span style="background:#d4f991">00</span> <span style="background:#0b9768">00 25</span> <span style="background:#d4f991">00</span> 00 03 <span style="background:#0b9768">00 19</span> <span style="background:#d4f991">00 7D</span> <span style="background:#0b9768">00 56</span> <span style="background:#d4f991">03 25</span> <span style="background:#0b9768">00 24</span><span style="background:#d4f991"> 03 84 </span> 00 00 00 03 <span style="background:#0b9768">01 4B</span> <span style="background:#d4f991">00 00 00 00 00 00 00 H7</span> <span style="background:#0b9768">01 CF</span> <span style="background:#d4f991">00 00 00 00 00 00 0C CB</span> <span style="background:#0b9768">01 D0</span> <span style="background:#d4f991">00 00 00 00 00 0B FF C7</span> 00 00 01 00 00 79 3F |
− | |||
− | |||
|} | |} | ||
Line 182: | Line 232: | ||
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code Part | ! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |HEX Code Part | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | Zero Bytes | + | | 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;" |00 00 00 00 | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Data Field Length | | style="vertical-align: middle; text-align: center;" |Data Field Length | ||
− | | style="vertical-align: middle; text-align: center;" |00 00 00 | + | | style="vertical-align: middle; text-align: center;" |00 00 00 32 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Codec ID | | style="vertical-align: middle; text-align: center;" |Codec ID | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |8E (Codec 8 Extended) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records) | | style="vertical-align: middle; text-align: center;" |Number of Data 1 (Number of Total Records) | ||
Line 195: | Line 245: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Timestamp | | style="vertical-align: middle; text-align: center;" |Timestamp | ||
− | | style="vertical-align: middle; text-align: center;" |00 00 01 | + | | style="vertical-align: middle; text-align: center;" |00 00 01 7E 06 5D E1 B8 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | Priority | + | | style="vertical-align: middle; text-align: center;" |Priority |
| style="vertical-align: middle; text-align: center;" |00 | | style="vertical-align: middle; text-align: center;" |00 | ||
|- | |- | ||
Line 204: | Line 254: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Latitude | | style="vertical-align: middle; text-align: center;" |Latitude | ||
− | | style="vertical-align: middle; text-align: center;" |00 00 00 00 | + | | style="vertical-align: middle; text-align: center;" |00 00 00 00 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Altitude | | style="vertical-align: middle; text-align: center;" |Altitude | ||
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 00 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Angle | | style="vertical-align: middle; text-align: center;" |Angle | ||
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 00 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Satellites | | style="vertical-align: middle; text-align: center;" |Satellites | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Speed | | style="vertical-align: middle; text-align: center;" |Speed | ||
Line 219: | Line 269: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |Event IO ID | | style="vertical-align: middle; text-align: center;" |Event IO ID | ||
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |00 00 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |N of Total ID | | 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 C0 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO | | 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 06 |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |1’st IO ID | | style="vertical-align: middle; text-align: center;" |1’st IO ID | ||
− | | style="vertical-align: middle; text-align: center;" |EF (AVL ID | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 EF</span> (AVL ID 239, Name: Ignition) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |1’st IO Value | | style="vertical-align: middle; text-align: center;" |1’st IO Value | ||
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00</span> |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |2’nd IO ID | | style="vertical-align: middle; text-align: center;" |2’nd IO ID | ||
− | | style="vertical-align: middle; text-align: center;" |F0 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 F0</span> (AVL ID 240, Name: Movement) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |2’nd IO Value | | style="vertical-align: middle; text-align: center;" |2’nd IO Value | ||
− | | style="vertical-align: middle; text-align: center;" |00 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00</span> |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | 3’rd IO ID | + | | style="vertical-align: middle; text-align: center;" |3’rd IO ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 01</span> (AVL ID 1, Name: Digital Input 1) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | 3’rd IO Value | + | | style="vertical-align: middle; text-align: center;" |3’rd IO Value |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">01</span> (Digital Input 1 state 1 - Digital Input 1 on) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |4’th IO ID |
− | | style="vertical-align: middle; text-align: center;" |B3 (AVL ID | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 B3</span> (AVL ID 179, Name: Digital Output 1) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |4’th IO Value |
− | | style="vertical-align: middle; text-align: center;" |01 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">01</span> (Digital Output 1 state 1 - Digital Output 1 on) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |5’th IO ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 1E</span> (AVL ID 30, Name: Number of DTC) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |5’th IO Value |
− | | style="vertical-align: middle; text-align: center;" | 00 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00</span> (Number of DTC state 0 - without DTC) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |6’th IO ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 25</span> (AVL ID 37, Name: Vehicle Speed) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |6’th IO Value |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00</span> (Vehicle Speed 0 ) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | style="vertical-align: middle; text-align: center;" |N2 of Two Bytes IO | |
− | + | | style="vertical-align: middle; text-align: center;" |00 03 | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | style="vertical-align: middle; text-align: center;" | N2 of Two | ||
− | | style="vertical-align: middle; text-align: center;" | | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |1’st IO ID | | style="vertical-align: middle; text-align: center;" |1’st IO ID | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 19</span> (AVL ID 25, Name: BLE Temperature #1) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |1’st IO Value | | style="vertical-align: middle; text-align: center;" |1’st IO Value | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00 7D</span> (Temperature value 1.25 degrees Celsius) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |2’nd IO ID | | style="vertical-align: middle; text-align: center;" |2’nd IO ID | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 56</span> (AVL ID 86, Name: BLE Humidity #1) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |2’nd IO Value | | style="vertical-align: middle; text-align: center;" |2’nd IO Value | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">03 25</span> (Humidity 80.5%) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |3’rd IO ID | | style="vertical-align: middle; text-align: center;" |3’rd IO ID | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 24</span> (AVL ID 36, Name: Engine RPM) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |3’rd IO Value | | style="vertical-align: middle; text-align: center;" |3’rd IO Value | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">03 84</span> (Engine RPM state 900 RPM) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N4 of Two Bytes IO |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| style="vertical-align: middle; text-align: center;" |00 00 | | style="vertical-align: middle; text-align: center;" |00 00 | ||
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |N8 of Two Bytes IO |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |00 03 |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |1’st IO ID |
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">01 4B</span> (AVL ID 331, Name: BLE 1 Custom #1) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |1’st IO Value | | style="vertical-align: middle; text-align: center;" |1’st IO Value | ||
− | | style="vertical-align: middle; text-align: center;" | 00 00 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00 00 00 00 00 00 00 H7</span> (Flags. Each set bit (0-7) means the presence of value (0-7).) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |2’nd IO ID | | style="vertical-align: middle; text-align: center;" |2’nd IO ID | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">01 CF</span> (AVL ID 463, Name: BLE 1 Custom #2) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |2’nd IO Value | | style="vertical-align: middle; text-align: center;" |2’nd IO Value | ||
− | | style="vertical-align: middle; text-align: center;" |00 00 00 00 | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00 00 00 00 00 00 0C CB</span> (Movement status) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |3’rd IO ID | | style="vertical-align: middle; text-align: center;" |3’rd IO ID | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">01 D0</span> (AVL ID 464, Name: BLE 1 Custom #3) |
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |3’rd IO Value | | style="vertical-align: middle; text-align: center;" |3’rd IO Value | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |<span style="background:#d4f991">00 00 00 00 00 0B FF C7</span> (Angle. 0B – Most significant byte represents device pitch. FFC7– Two least significant bytes represent device roll.) |
|- | |- | ||
− | | style="vertical-align: middle; text-align: center;" | | + | | style="vertical-align: middle; text-align: center;" |NX of X 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;" |Number of Data 2 (Number of Total Records) | | style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records) | ||
Line 426: | Line 365: | ||
|- | |- | ||
| style="vertical-align: middle; text-align: center;" |CRC-16 | | style="vertical-align: middle; text-align: center;" |CRC-16 | ||
− | | style="vertical-align: middle; text-align: center;" |00 00 | + | | style="vertical-align: middle; text-align: center;" |00 00 79 3F |
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | <br> | ||
[[Category: Usage scenarios]] | [[Category: Usage scenarios]] |
Latest revision as of 14:07, 6 December 2023
Main Page > General Information > Usage scenarios > BASIC TRACK & TRACEIntroduction
Nowadays, when smart devices are progressing very fast, the phrase “basic track and trace” has a new meaning. Getting only the coordinates from the device is not enough anymore. Therefore, GPS trackers must be universal to meet various requirements. Among other things, when choosing a GPS tracker, it is very important to understand what additional services and tools you will get with the device.
Solution description
Teltonika GPS trackers are developed on one common firmware platform, which is constantly being developed and extended with new features. A common platform means that the main core of functionality is the same on all types of our trackers – be it professional, advanced or simple tracker. Smart usage of functions opens for a user various possibilities and brings a valuable advantage comparing to other GPS trackers of a similar price range in the market, making them suitable for different telematics solutions.
For a fast and easy “Teltonika data protocols” implementation, data packets parser tool and source code examples of communication server are prepared. For an easy control of the whole fleet, customers get access to FOTA WEB service for free. FOTA WEB is a powerful tool for remote configuration and firmware updates. Trackers support universal configurator – a tool for configuration, firmware updates and testing.
The basic firmware functionality supports such generic features like sleep modes, trip detection, and different data acquisition modes that depend on ignition/movement source or even the connected GSM operator. The device supports different ignition detection modes, depending on the installation variant. Moreover, it supports such advanced functions like auto geofence, towing detection, green driving, crash event detection, virtual odometer, unplug detection, GPRS/SMS notifications and many more. The user can easily enable the function he needs using the configurator or FOTA WEB and change the configuration in accordance with the changing needs of the client.
Teltonika trackers also support BLE technology that significantly expands their functionality. For example, if a client wants to get more telemetric vehicle data, it is possible to connect via Bluetooth® OBDII dongle and read such data like millage, engine hours, engine faults, fuel level, etc. Advanced BLE mode lets to configure BLE beacons and various BLE sensors (temperature, humidity, movement, etc.). BLE beacons can be used as an immobilizer or for the authentication of drivers and passengers. Another possible way of using them is to monitor assets during transportation, even for indoor tracking. By the way, it also is possible to configure a device via Bluetooth®. Teltonika provides Bluetooth® communication protocols so that users could develop their own mobile application to read notifications in real time and do many other useful functions with their trackers.
What you need for a solution?
- FMx920 device (FMB920 is taken as example) a simple tracker with a basic set of functions.
Other devices that work with this solution: |
FMB965, FMC920, FMB003, FMB001, FMC003, FMM920, FMM003, FMB002, FMB020 |
- The SIM card in order to get data to your server
- EYE BEACON/SENSOR BLE sensors that can be additionally connected if necessary
- Bluetooth® OBD II dongles Bluetooth® OBD II dongles from other manufacturers can be connected if necessary to receive data from the OBD connector
- FOTA WEB to remotely send the configuration to the device
Installation
It’s important to hide the tracker, so it would not be a simple task for the thieves to find and unplug it. But also, please do not forget to follow mounting recommendations as well.
Although devices have high gain antennas it’s important to mount devices with stickers on top and in metal-free space. The device should be firmly fixed to the surface or cables. Please make sure, that device is not fixed to heat emitting or moving parts.
Additional accessories such as EYE SENSOR or EYE BEACON can be used for this solution. EYE SENSOR can transmit to the tracker parameters such as temperature, humidity, angle, movement, data on the presence of a magnetic field. EYE SENSOR and EYE BEACON can transmit a unique identification number, which can be used in many scenarios, such as an immobilizer, more details here. Also, check more detailed information about EYE SENSOR and EYE BEACON here and here.
You can also use third-party OBD BT dongles for this solution (if there is a need to get data from the vehicle's OBDII interface. You can read more about selecting the appropriate OBD BT dongle models here.
Configuration
1. Prerequisites:
1.1. Read through First start guide
1.2. Understanding of possible Sleep modes.
2. BASIC TRACK & TRACE configuration:
Parameter ID – Parameter name GPRS settings:
- 2001 – APN
- 2002 – APN username (if there are no APN username, empty field should be left)
- 2003 – APN password (if there are no APN password, empty field should be left)
Server settings:
- 2004 – Domain
- 2005 – Port
- 2006 – Data sending protocol (0 – TCP, 1 – UDP)
After successful GPRS/SERVER settings configuration, FMB920 device will synchronize time and update records to the configured server. Time intervals and default I/O elements can be changed by using Teltonika Configurator or FMB920 Parameter list|SMS parameters.
Sleep settings:
- 102 – Sleep settings(0 – Disable, 1 – Gps sleep, 2 – Deep sleep, 3 – Online Deep sleep, 4 – Ultra sleep)
Note: This scenario will not work with Deep Sleep and Ultra Sleep modes, since they disable the device's GSM module to save power.
Can adapter settings:
- 807 – OBDII mode (This setting enables the BT module in ODBII mode)
- 805 – This field contains the name of the device to which the tracker will connect via the BT channel
- 40100 – Number Of DTC, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
- 40160 – Engine RPM, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
- 40170 – Vehicle Speed, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
Quickstart: From default configuration to BASIC TRACK & TRACE solution in one SMS:
" setparam 2001:APN;2002:APN_user;2003:APN_password;2004:Domain;2005:Port;2006:0;102:3;807:2;805:DONGLE;40100:1;40160:1;40170:1"
This SMS will set up your device to report the BASIC TRACK & TRACE scenario to the server and the possibility receive data when using OBDII BT dongle.
Note: Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings.
To use EYE SENSOR sensors, it is best to use the Teltonika configurator, as it becomes necessary to select the correct preset.
- Set the Data Protocol setting to Codec 8 Extended
- In the Bluetooth® 4.0 section, set the operating mode for one of the 4 sensors as Advanced
- Enter the MAC address of the sensor
- Select the appropriate preset and load it
- In the I / O section, select the sensor parameters of interest: these can be temperature, humidity, motion sensor, magnetic field sensor, tilt angle sensor, sensor battery level.
Parsing information
1.Prerequisites:
1.1. Open TCP/UDP port
1.2. Read Java parser first start guide
2. Parsing example:
Unparsed received data in hexadecimal stream |
---|
00 00 00 00 00 00 00 32 8E 01 00 00 01 7E 06 5D E1 B8 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 C0 00 06 00 EF 00 00 F0 00 00 01 01 00 B3 01 00 1E 00 00 25 00 00 03 00 19 00 7D 00 56 03 25 00 24 03 84 00 00 00 03 01 4B 00 00 00 00 00 00 00 H7 01 CF 00 00 00 00 00 00 0C CB 01 D0 00 00 00 00 00 0B FF C7 00 00 01 00 00 79 3F |
AVL Data Packet Part | HEX Code Part |
---|---|
Zero Bytes | 00 00 00 00 |
Data Field Length | 00 00 00 32 |
Codec ID | 8E (Codec 8 Extended) |
Number of Data 1 (Number of Total Records) | 01 |
Timestamp | 00 00 01 7E 06 5D E1 B8 |
Priority | 00 |
Longitude | 00 00 00 00 |
Latitude | 00 00 00 00 |
Altitude | 00 00 |
Angle | 00 00 |
Satellites | 00 |
Speed | 00 00 |
Event IO ID | 00 00 |
N of Total ID | 00 C0 |
N1 of One Byte IO | 00 06 |
1’st IO ID | 00 EF (AVL ID 239, Name: Ignition) |
1’st IO Value | 00 |
2’nd IO ID | 00 F0 (AVL ID 240, Name: Movement) |
2’nd IO Value | 00 |
3’rd IO ID | 00 01 (AVL ID 1, Name: Digital Input 1) |
3’rd IO Value | 01 (Digital Input 1 state 1 - Digital Input 1 on) |
4’th IO ID | 00 B3 (AVL ID 179, Name: Digital Output 1) |
4’th IO Value | 01 (Digital Output 1 state 1 - Digital Output 1 on) |
5’th IO ID | 00 1E (AVL ID 30, Name: Number of DTC) |
5’th IO Value | 00 (Number of DTC state 0 - without DTC) |
6’th IO ID | 00 25 (AVL ID 37, Name: Vehicle Speed) |
6’th IO Value | 00 (Vehicle Speed 0 ) |
N2 of Two Bytes IO | 00 03 |
1’st IO ID | 00 19 (AVL ID 25, Name: BLE Temperature #1) |
1’st IO Value | 00 7D (Temperature value 1.25 degrees Celsius) |
2’nd IO ID | 00 56 (AVL ID 86, Name: BLE Humidity #1) |
2’nd IO Value | 03 25 (Humidity 80.5%) |
3’rd IO ID | 00 24 (AVL ID 36, Name: Engine RPM) |
3’rd IO Value | 03 84 (Engine RPM state 900 RPM) |
N4 of Two Bytes IO | 00 00 |
N8 of Two Bytes IO | 00 03 |
1’st IO ID | 01 4B (AVL ID 331, Name: BLE 1 Custom #1) |
1’st IO Value | 00 00 00 00 00 00 00 H7 (Flags. Each set bit (0-7) means the presence of value (0-7).) |
2’nd IO ID | 01 CF (AVL ID 463, Name: BLE 1 Custom #2) |
2’nd IO Value | 00 00 00 00 00 00 0C CB (Movement status) |
3’rd IO ID | 01 D0 (AVL ID 464, Name: BLE 1 Custom #3) |
3’rd IO Value | 00 00 00 00 00 0B FF C7 (Angle. 0B – Most significant byte represents device pitch. FFC7– Two least significant bytes represent device roll.) |
NX of X Byte IO | 00 00 |
Number of Data 2 (Number of Total Records) | 01 |
CRC-16 | 00 00 79 3F |