Changes

19,905 bytes added ,  13:15, 30 November 2021
Created page with " Category: Usage scenarios ==Introduction== To satisfy the growing demand for farming produce and tackle many challenges affecting the agriculture industry, present-day..."

[[Category: Usage scenarios]]

==Introduction==

To satisfy the growing demand for farming produce and tackle many challenges affecting the agriculture industry, present-day farmers have to be more innovative, efficient, competitive, but save resources at the same time. As a result, comprehensive, affordable, and customisable agricultural machinery tracking solutions combined with process monitoring and automation are becoming not only an attractive option but rather a necessity.

==Solution description==
Thanks to the fast-developing IoT technologies, agriculture-specific equipment, farming implements, and/or accessories tracking and management can be successfully achieved by combining GPS devices, CAN Bus data adaptors, and Bluetooth Low Energy 4.X (BLE) ID beacons. The ultimate choice for this matter - Teltonika ADVANCED category GPS tracker FMB140 with built-in CAN data reading feature and advanced software version supporting agriculture type vehicles (aka ALL-CAN300 option). The main advantage is the ability to receive specific agricultural vehicle data via the CAN bus via the Agricultural State Flag parameter. It is possible to obtain such special data as the position of the joystick, the position and status of hydraulic tools, the status of the grain tank and more. Also, using BLE sensors and beacons, you can get additional parameters that are not provided by standard sensors. This can be raising or lowering of the dump truck body and cab, temperature and humidity in the chamber. You can also track expensive equipment using BLE beacons.

==What you need for a solution?==

*[https://teltonika-gps.com/product/fmb140/'''FMB140 device'''].

*The [https://wiki.teltonika-gps.com/view/FMB003_First_Start#How_to_insert_Nano-SIM_card_and_connect_battery '''SIM card'''] in order to get data to your server

*[https://wiki.teltonika-gps.com/view/FOTA_WEB '''FOTA WEB'''] to remotely send the configuration to the device.<br />

*[https://wiki.teltonika-gps.com/view/How_to_start_with_FMB_devices_and_Sensors%3F'''BLE ID beacons and sensors.''']<br />



==Installation==

[[File:FMB140-wiring-scheme.jpg|thumb750x600px]]


When installing FMB140 in a vehicle, follow the[https://wiki.teltonika-gps.com/view/FMB003_First_Start ''' mounting recommendations. ''']When connecting to the CAN bus, you must use the diagrams provided by our technical support engineers. The diagrams indicate in detail and clearly the connection points in the vehicle wiring and the required program number. It is also possible to obtain data from the vehicle CAN bus by performing an [https://wiki.teltonika-gps.com/view/FMB140_autoscan_feature_instructions '''auto scan procedure.'''] FMB140 has the function of working with wireless BLE sensors, supports connection of temperature sensors and iButton reader via 1-wire.

<br />
[[File:Ble mount.jpg|thumb500x600px]]

The installation of BLE sensors and beacons is quite simple, you need to install the sensor in a suitable place using screws or double-sided tape and install the required configuration in the tracker and sensor. This gives a huge advantage over wired sensors, since there is no need to pull wires, which means you can seriously save on the services of an electrician!
<br />
==Configuration==

==='''1. Prerequisites:'''===

====1.1. Read through [https://wiki.teltonika-gps.com/view/FMB140_First_Start start guide]====
====1.2. Understanding of possible [https://wiki.teltonika-gps.com/view/FMB140_Sleep_modes Sleep modes].====
<br />


[[File:GPRS settings.png|alt=|left|thumb|258x258px]]

'''Parameter ID – Parameter name GPRS settings:'''

<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]]



<br />
<br />

<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 />

After successful GPRS/SERVER settings configuration, FMB140 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 [[FMB140 Parameter list|SMS parameters]].<br />

<br />

[[File:8E.png|thumb|alt=|left]]
'''Data protocol settings:'''

*<span style="background:#05CC2F">113</span> – Data protocol (0 – Codec8, 1 – Codec8Extended)
<br />
'''Note''': To get OEM parameters, you need to use [[Codec#Codec_8_Extended|Codec8Extended]].

<br />

[[File:Online_deep_sleep_carsharing.PNG|alt=|left|thumb]]
'''Sleep settings:'''
<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 [[FMB003 Sleep modes#Deep%20Sleep%20mode|Deep Sleep]] and [[FMB003 Sleep modes#Ultra%20Deep%20Sleep%20mode|Ultra Sleep]] modes, since they disable the device's GSM module to save power.
<br />
<br />
[[File:Program Number.jpg|alt=|left|453x453px|thumb]]
<br />
<br />
<br />
<br />
<br />

'''CAN Adapter setting:'''
*<span style="background-color:#E18DE7;">45002</span> – The program number that is indicated in the wiring diagram.

<br />
<br />
<br />
<br />
<br />
<br />

[[File:Send data with 0.jpg|alt=|left|453x453px|thumb]]
<br />
<br />
*<span style="background-color:#dee11d;">45001</span> – Send data with 0, if ignition is off(0 – Disable, 1 – Enable)
<br />
<br />
<br />
<br />
<br />
<br />
[[File:Io can adapter.jpg|thumb|alt=|left|452x452px]]

<br />
*<span style="background-color:#1de1d2;">45100</span> – Vehicle speed, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
*<span style="background-color:#e1701d;">45130</span> – Fuel level in ltr*10 , Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
*<span style="background-color:#1de2d2;">45140</span> – Engine RPM, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
<br />
<br />
<br />
*<span style="background-color:#bce5d7;">45160</span> – Fuel level in %, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
<br />
<br />
<br />
<br />
<br />
<br />
<br />
[[File:Agricultural state flags.jpg|thumb|alt=|left|452x452px]]
<br />
<br />
*<span style="background-color:#1de2d2;">46060</span> – Agricultural State Flags, Priority "Low" (0 – Disabled 1 – Low 2 – High 3 – Panic )
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
'''Quickstart:''' From default configuration to AGRICULTURE AND FARMING INDUSTRY 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">45002</span>:Program number;<span style="background-color:#dee11d;">45001</span>:0;<span style="background-color:#1de1d2;"> 45100</span>:1;<span style="background-color:#e1701d;"> 45160</span>:1;<span style="background-color:#bce5d7;"> 45130</span>:1;<span style="background-color:#e1701d;"> 45140</span>:1;<span style="background-color:#e1701d;"> 46060</span>:1;<span style="background-color:#02BD2F;"> 113</span>:1"
This SMS will set up your device to report object location to the server and possibility for read Engine RPM, Fuel level in %, Fuel level in ltr*10 and Vehicle speed parameters.

'''Note''': Before SMS text, two space symbols should be inserted if no SMS username or password was set in SMS \ Call settings.
<br />
<br />

To use BLE sensors, use the configurator in online mode (tracker is connected) or offline (tracker is disabled). When using the configurator in offline mode, you can remotely download the configuration via FOTA WEB.
[[File:BLE SET.jpg|thumb|1200x1200px]]
[[File:BLE IO.jpg|thumb|alt=|left|1200x1200px]]
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />

==Parsing information==

==='''1.Prerequisites:'''===

==== 1.1. Open [https://wiki.teltonika-gps.com/view/Opening_TCP/UDP_port TCP/UDP port]====

==== 1.2. Read Java parser [https://wiki.teltonika-gps.com/view/Java_Parser_First_Start_Guide first start guide]====

==='''2. Parsing example:'''===
{| class="nd-othertables_2" style="width:100%;"
! rowspan="1" style="width:100%; vertical-align: middle; text-align: center;" |Unparsed received data in hexadecimal stream
|-
| style="vertical-align: middle; text-align: center;" | 00000000000000848E010000017CE9B241900000000000000000000000000000000000000015000700EF0100F00100150500C800004502<span style="background:#0b9768">0051</span>00005900000900B5000000B600000042385C0
<br />
043000000440000<span style="background:#0b9768">001A</span>090E<span style="background:#0b9768">0068</span>0023
<span style="background:#0b9768">0054</span>0000<span style="background:#0b9768">0055</span>0000000400F100006466001000000000<span style="background:#0b9768">01D4</span>00FDFFFF<span style="background:#0b9768">0057</span>000000000001<span style="background:#0b9768">0208</span>000000000000000000000100000647


|}
{| class="nd-othertables_2" style="width:100%;"
|-
! rowspan="1" style="width:50%; vertical-align: middle; text-align: center;" |AVL Data Packet 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;" |00 00 00 00
|-
| style="vertical-align: middle; text-align: center;" |Data Field Length
| style="vertical-align: middle; text-align: center;" |00 00 00 84
|-
| style="vertical-align: middle; text-align: center;" |Codec ID
| 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;" |01
|-
| style="vertical-align: middle; text-align: center;" |Timestamp
| style="vertical-align: middle; text-align: center;" |00 00 01 7C E9 B2 41 90 (04.11.2021 6:45:46)
|-
| style="vertical-align: middle; text-align: center;" | Priority
| style="vertical-align: middle; text-align: center;" |00
|-
| style="vertical-align: middle; text-align: center;" |Longitude
| style="vertical-align: middle; text-align: center;" |00 00 00 00
|-
| 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;" |Altitude
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |Angle
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |Satellites
| style="vertical-align: middle; text-align: center;" |00
|-
| 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;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |N of Total ID
| style="vertical-align: middle; text-align: center;" |00 21
|-
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
| style="vertical-align: middle; text-align: center;" |00 07
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |00 EF (AVL ID: 239, Name: Ignition)
|-
| 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;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |00 F0 (AVL ID: 240, Name: Movement)
|-
| 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;" | 3’rd IO ID
| style="vertical-align: middle; text-align: center;" |00 15 (AVL ID: 21, Name: GSM Signal)
|-
| style="vertical-align: middle; text-align: center;" | 3’rd IO Value
| style="vertical-align: middle; text-align: center;" |05
|-
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |00 C8 (AVL ID: 200, Sleep Mode)
|-
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00
|-
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |00 45 (AVL ID: 69, GNSS Status)
|-
| style="vertical-align: middle; text-align: center;" |5'th IO Value
| style="vertical-align: middle; text-align: center;" | 02
|-
| style="vertical-align: middle; text-align: center;" |6'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 51</span> (AVL ID: 81, Vehicle Speed)
|-
| style="vertical-align: middle; text-align: center;" |6'th IO Value
| style="vertical-align: middle; text-align: center;" | 00
|-
| style="vertical-align: middle; text-align: center;" |7'th IO ID
| style="vertical-align: middle; text-align: center;" |00 59 (AVL ID: 89, Fuel level)
|-
| style="vertical-align: middle; text-align: center;" |7'th IO Value
| style="vertical-align: middle; text-align: center;" |00
|-
| style="vertical-align: middle; text-align: center;" |N2 of Two Byte IO
| style="vertical-align: middle; text-align: center;" |00 09
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |00 B5 (AVL ID: 181, GNSS PDOP)
|-
| 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;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |00 B6 (AVL ID: 182, GNSS HDOP)
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
| style="vertical-align: middle; text-align: center;" |00 00

|-
| style="vertical-align: middle; text-align: center;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |00 42 (AVL ID: 66, External Voltage)
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
| style="vertical-align: middle; text-align: center;" |38 5C
|-
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |00 43 (AVL ID: 67, Battery Voltage)
|-
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |5'th IO ID
| style="vertical-align: middle; text-align: center;" |00 44 (AVL ID: 68, Battery Current)
|-
| style="vertical-align: middle; text-align: center;" |5'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |6'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 1A</span> (AVL ID: 26, BLE Temperature #2)
|-
| style="vertical-align: middle; text-align: center;" |6'th IO Value
| style="vertical-align: middle; text-align: center;" |09 0E
|-
| style="vertical-align: middle; text-align: center;" |7'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 68</span> (AVL ID: 26, BLE Humidity #2)
|-
| style="vertical-align: middle; text-align: center;" |7'th IO Value
| style="vertical-align: middle; text-align: center;" |00 23
|-
| style="vertical-align: middle; text-align: center;" |8'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 54</span> (AVL ID: 84, Fuel level)
|-
| style="vertical-align: middle; text-align: center;" |8'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |9'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 55</span> (AVL ID: 85, Engine RPM)
|-
| style="vertical-align: middle; text-align: center;" |9'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00
|-
| style="vertical-align: middle; text-align: center;" |N4 of Four Byte IO
| style="vertical-align: middle; text-align: center;" |00 04
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |00 F1 (AVL ID: 241, Active GSM Operator)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |00 00 64 66
|-
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
| style="vertical-align: middle; text-align: center;" |00 10 (AVL ID: 16, Total Odometer)
|-
| 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;" |3’rd IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">01 D4</span> (AVL ID: 468, BLE 2 Custom #3)
|-
| style="vertical-align: middle; text-align: center;" |3’rd IO Value
| style="vertical-align: middle; text-align: center;" |00 FD FF FF
|-
| style="vertical-align: middle; text-align: center;" |4'th IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">00 57</span> (AVL ID:87, Total Mileage)
|-
| style="vertical-align: middle; text-align: center;" |4'th IO Value
| style="vertical-align: middle; text-align: center;" |00 00 00 00
|-
| style="vertical-align: middle; text-align: center;" |N8 of Eight Byte IO
| style="vertical-align: middle; text-align: center;" |00 01
|-
| style="vertical-align: middle; text-align: center;" |1’st IO ID
| style="vertical-align: middle; text-align: center;" |<span style="background:#0b9768">02 08</span> (AVL ID: 520, Agricultural State Flags_P4)
|-
| style="vertical-align: middle; text-align: center;" |1’st IO Value
| style="vertical-align: middle; text-align: center;" |00 00 00 00 00 00 00 00
|-
| 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 06 47
|}
<br />
<br />
<br />
<br />
[[File:Asf.jpg|thumb750x600px]]
<br />
<br />
The Agricultural State Flag can be interpreted from this table, which can be found [https://wiki.teltonika-gps.com/view/FMB140_CAN_adapters#ALL-CAN300_Agricultural_State_Flags'''here.'''] Each bit carries useful information that can be obtained.
==Demonstration in platform==


'''WIALON:''' Open WIALON → Open Messages → Select your device → Select the date interval → Select Message (data messages) → Select execute and you will see all the information.
[[File:Wialon page.jpg|thumb|left|1138x1138px]]