Jump to content
  • EN

Universal Device Test Guide: Difference between revisions

From Teltonika Telematics Wiki
← Older editNewer edit →
VisualWikitext
No edit summary
(52 intermediate revisions by 8 users not shown)
Line 1: Line 1:
__TOC__
[[Image:Qsg_rut950_teltonika.PNG|centre|]]
=='''<big>Introduction</big>'''==
[[File:Welcome to the telematics banner 1.1.png]]


This Universal Device Test Guide helps new users to get acquainted with Teltonika Telematics Fleet Management devices and to test basic functions in 5 easy steps.


The guide also provides information about specific use cases, advanced features, and software solutions.
__TOC__


Use the [[Main Page|'''Teltonika WIKI''']], [https://community.teltonika.lt/c/teltonika-telematics/6 '''Teltonika Telematics Community page'''] and our [https://www.youtube.com/channel/UCjWIn5amqvtWc7X7tI_04LQ '''Official Youtube Channel'''] to get more in-depth information and answers to any other questions. Our highly professional support engineers are always willing to help - they can be reached via [https://helpdesk.teltonika-iot-group.com/ '''HelpDesk'''].


=='''<big>Basic Testing</big>'''==
[[File:5 easy steps to prepare any Teltonika Telematics device banner.png]]


Here, we will go through five easy testing steps which will introduce you to Teltonika Telematics devices.
=='''<big>Introduction</big>'''==
[[File:Welcome to the telematics banner 1.1.png]]


We will cover everything you need to start using the device - from inserting a SIM card and powering the device, to receiving GNSS track information from your vehicle to the server.
Universal Device Testing Guide can be applied to any Teltonika Telematics device. Purpose of this guide is to help new users get acquainted with Teltonika Fleet Management devices and test basic functions in 5 easy steps.


Once you are finished with basic testing, you will find additional instructions on how to test specific use cases and advanced features of our devices as well as remote tracker management platform and other solutions.


In case you have any questions regarding Teltonika devices or their features, do not worry - we have a well of knowledge called '''[[Main Page|Teltonika WIKI]]''', '''[https://community.teltonika-gps.com/ Crowd Support Forum]''' and our '''[https://www.youtube.com/channel/UCjWIn5amqvtWc7X7tI_04LQ Official Youtube Channel]''', where you can find answers regarding our devices functionalities and specifications.


Equipment and software required to follow this guide:
If you do not find answers to your questions online - do not despair, we have a highly professional team of support engineers who are willing to help and can be reached via VIP Helpdesk.


* Teltonika Telematics device with the included accessories
=='''<big>Basic Testing</big>'''==
* Pry tool to open the device enclosure (if needed)
[[File:5 easy steps to prepare any Teltonika Telematics device banner.png]]  
* Working, registered SIM card (type depends on device)
* Power supply unit capable of supplying 10-30 VDC.
* Personal computer with Windows OS, internet connection and:
** COM port drivers (download .zip file [https://wiki.teltonika-gps.com/images/d/d0/TeltonikaCOMDriver.zip '''here'''])
** Latest Microsoft .NET Framework
** Teltonika Configurator software (download the latest version [[Teltonika Configurator versions|'''here''']])
* One of the following:
** A GNSS tracking service (see overview [[Fleet Management platforms|'''here''']]), and/or
** Teltonika TCP/UDP listener and parser (download the software [[Special:Redirect/file/Protocols and AVL parser pack.zip|'''here''']] (archive password: 1234)


In this chapter we will go through 5 easy testing steps which will help you get acquainted with Teltonika Telematics devices. We will cover everything you need to start using the device - from inserting SIM card, powering the device and ending with GPS track information directly from your vehicle to the server.


==='''Prepare the Device'''===
All our devices use SIM card for telecommunication, thus you will not be able to get any data and/or communicate with the device remotely without the SIM card. In this chapter you will find a guide on how to insert SIM card and connect internal battery.


Below is the General Quick Start Guide video. It shows steps that can be applied to most Teltonika Telematics devices.
''Note:'' Different Teltonika devices use different SIM card types: mini-SIM, micro-SIM, nano-SIM, and [[Requirements for eSIM|eSIM]] (which is soldered during device manufacturing process).
{|
===='''How to insert SIM card and connect the battery*'''====
|-
# Gently remove '''device cover''' using '''plastic pry tool''' from both sides as it is showed in a 1st picture.
|''Note!''||''The video shows a configuration procedure with a 1GLOBAL SIM and APN. If you use other service providers, please contact them for exact APN details''
# After opening device cover, you will see '''SIM card''' and '''battery''' connection '''slots'''.
|}<youtube width="850" height="480">GDGFG6Lh1B0</youtube>
# Insert '''SIM''' card as shown with '''PIN request disabled''' or read '''[[FMB120 Security info|Security info]]''' (Universal Guide) how to enter it later in Configurator. Make sure that SIM card '''cut-off corner''' is pointing forward to slot.
# Connect the battery as shown on device. Position the battery in place where it does not obstruct other components.
# Attach device '''cover''' back. Device is ready to be connected.
{| class="wikitable"
|+
|[[File:FM nuasmenintas 1.1.png]]
|[[File:FM nuasmenintas 2.2.png]]
|[[File:FM nuasmenintas 3.3.png]]
|[[File:FM nuasmenintas 4.4.png]]
|}


==='''STEP 1: Prepare the Device'''===
'''Result: The SIM card is inserted into the device and the internal battery is connected.'''


Requirements for this step:
'''<nowiki>*</nowiki> If you would like to check how to insert SIM card into your particular device, please check [[Main Page|Teltonika WIKI documentation.]] Click on ''your device'' -> First Start -> How to insert SIM Card.'''


* Teltonika Telematics device with the included accessories
* Pry tool to open the device enclosure (if needed)
* Working, registered SIM card (type depends on device)
{|
{|
|-
|-
|[[File:Alert.png|left|link=]]||<b>Attention! Power off the device before inserting/removing the SIM card. Disconnect all power sources - internal battery and external voltage. Otherwise, the SIM card may be damaged or the device may not detect it.</b>
|[[File:Alert.png|left|link=]]||<b>SIM card insertion/removal must be performed when device is powered off – external voltage {{{battery|and internal battery}}} disconnected. Otherwise SIM card might be damaged or device will not detect it.</b>
|}
|}




==='''Connect the device to PC'''===


All Teltonika Telematics devices use SIM cards to enable telecommunication. It is impossible to get any data from the device to a server without a SIM card. Different devices may use different SIM card types: mini-SIM, micro-SIM, nano-SIM, [[Requirements for eSIM|'''eSIM''']] (soldered during manufacturing).
One way to control your device is by connecting it to PC. During this step, we will introduce you on how to establish the connection.
===='''How to install USB drivers (Windows)'''====
Download COM port drivers from Teltonika '''[https://teltonika-gps.com/downloads/en/fmb120/TeltonikaCOMDriver.zip here]''' and install them.


Some devices have an internal battery. It provides power to the device when no other power sources are available. The battery may not be connected when you receive your device (check your order details). The internal battery must be connected before first use.
===='''PC Connection (Windows)'''====
Power-up device with '''DC voltage (10 – 30 V)*''' power supply using '''supplied power cable**'''. LED’s should start blinking, see “'''[[LED Status|LED behaviour description]]'''”.
<span> </span>


==== To insert the SIM card and connect the battery: ====
Connect device to computer*** using '''USB cable''' or '''Bluetooth''' connection.
#Look for your device in the device list below and find the related pictures.
#Carefully remove the device cover - use a pry tool if needed.
#*Some devices have an external SIM card slot. In these cases, first open the slot.
#Insert the SIM card into the SIM card slot. Orient the SIM card correctly - align the cut-off corner.
#Connect the battery. Position the battery so that it does not mechanically interfere with other internal components when the cover is closed.
#*Some devices require battery cable management and precise steps to insert the internal components back into the enclosure.
#Re-install the device cover.


The device is now ready to be connected to the PC.


==== Illustrations to help you prepare the device: ====
''* FMB900, FMB910, FMB920, MTB100, FMB202, FMB204 devices support '''(6 - 30 V)'''  DC power supply.''
<div class="toccolours mw-collapsible mw-collapsed">
<strong>Basic trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB900</strong>
|-
|[[Image:Fmb900_cover_1.png|500px]]
|[[Image:Fmb900_cover_2.png|500px]]
|[[Image:Fmb900_cover_3.png|500px]]
|[[Image:Fmb900_cover_4.png|500px]]
|}


{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
<nowiki>**</nowiki> FMP100, FMB002, FMB020, FMB003 can be powered up and configured via USB without any need of external power supply.
|<strong>FMB910, FMB920, FMB930 </strong>
|-
|{{{SIM1|[[Image:FMB9_sim_ir_battery_insert-1.png|500px]]}}}
|{{{SIM2|[[Image:FMB9_sim_ir_battery_insert-2.png|500px]]}}}
|{{{SIM3|[[Image:FMB9_sim_ir_battery_insert-3.png|500px]]}}}
|{{{SIM4|[[Image:FMB9_sim_ir_battery_insert-4.png|500px]]}}}
|}


{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
<nowiki>***</nowiki> If you would like to check how to connect your particular device to PC, please see device [[Main Page|Teltonika WIKI documentation]]. Click on ''your device'' -> First Start -> PC Connection (Windows)
|<strong>FMC920, FMM920 </strong>
|-
|{{{SIM1|[[File:FMC920 1.png|500px]]}}}
|{{{SIM2|[[File:FMC920 2.png|500px]]}}}
|{{{SIM3|[[File:FMC920 3.png|500px]]}}}
|{{{SIM4|[[File:FMC920 4.png|500px]]}}}
|{{{SIM5|[[File:FMC920_5.png|500px]]}}}
|{{{SIM5|[[File:FMC920_6.png|500px]]}}}
|}


{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
==='''Configure the Device'''===
|<strong>FMB965</strong>
After powering up your device, it should be configured to meet your needs. Here you will find steps on how to prepare your device for a first start.
|-
|{{{SIM1|[[Image:FMB965_sim_ir_battery_insert-1.png|260px]]}}}
|{{{SIM2|[[Image:FMB965_sim_ir_battery_insert-2.png|260px]]}}}
|{{{SIM3|[[Image:FMB965_sim_ir_battery_insert-3.png|260px]]}}}
|{{{SIM4|[[Image:FMB965_sim_ir_battery_insert-4.png|260px]]}}}
|{{{SIM4|[[Image:FMB965_sim_ir_battery_insert-5.png|260px]]}}}
|{{{SIM4|[[Image:FMB965_sim_ir_battery_insert-6.png|260px]]}}}
|}
</div>
</div>


<div class="toccolours mw-collapsible mw-collapsed">
===='''Configuration'''====
<strong>Fast & Easy trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMP100</strong>
|-
|[[Image:FMP100 1.png|300px]]
|[[Image:FMP100 2.png|300px]]
|[[Image:FMP100 3.png|300px]]
|[[Image:FMP100 4.png|300px]]
|[[Image:FMP100 5.png|300px]]
|[[Image:FMP1000 6.png|300px]]
|}


{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
At first device will have default factory settings set. These settings should be changed according to the user's needs.<br />
|<strong>FMB010</strong>
Main configuration can be performed via '''[[Teltonika Configurator]]''' software. Get the latest '''Configurator''' version from '''[[{{{SAS_Configurator_Versions|Teltonika Configurator versions}}}|here]]'''. Configurator operates on Microsoft Windows OS and uses prerequisite latest MS .NET Framework.
|-
|{{{insert1|[[Image:Fmb010_cover_1.png|280px]]}}}
|{{{insert2|[[Image:Fmb010_cover_2.png|280px]]}}}
|{{{insert3|[[Image:Fmb010_battery_1.png|280px]]}}}
|{{{insert4|[[Image:Fmb010_cover_3.png|280px]]}}}
|}


{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
Configuration process begins by pressing on connected device:
|<strong>FMB020</strong>
|-
|{{{insert1|[[Image:Fmb020 card 1.png|280px]]}}}
|{{{insert2|[[Image:Fmb020 card 2.png|280px]]}}}
|{{{insert3|[[Image:Fmb020 card 3.png|280px]]}}}
|{{{insert4|[[Image:Fmb020 card 4.png|280px]]}}}
|}


{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
[[File:Faceless_configurator_select.png|370x370px]]
|<strong>FMC800, FMM800, FMM80A</strong>
|-
|{{{insert1|[[Image:Fmm001_cover_1.png|280px]]}}}
|{{{insert2|[[Image:Fmm0001_cover_2.png|280px]]}}}
|{{{insert3|[[Image:Fmm001_battery_1.png|280px]]}}}
|{{{insert4|[[Image:Fmm001_cover_3.png|280px]]}}}
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMT100, FMC880, FMM880</strong>
|-
||[[Image:FMT100_sim_insert-1.png|170px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[Image:FMT100_sim_insert-2.png|170px]]
|[[Image:FMT100_sim_insert-3.png|170px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[Image:FMT100_sim_insert-4.png|170px]]
|[[Image:FMT100_sim_insert-5.png|170px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[Image:FMT100_sim_insert-6.png|170px]]
|}
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed">
<strong>Advanced trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB110</strong>
|-
|[[Image:{{{sim_insert_pic1|FMB110-Battery-1.png}}}|260px]]
|[[Image:{{{sim_insert_pic2|FMB110-Battery-2.png}}}|260px]]
|[[Image:{{{sim_insert_pic3|FMB110-Battery-3.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|FMB110-Battery-4.png}}}|260px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB120, FMB122, FMB130, FMC130, FMM130</strong>
|-
|[[Image:{{{sim_insert_pic1|FMB1_cover1_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic2|FMB1_cover2_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic3|FMB1_cover3_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|FMB1_cover4_correct.png}}}|260px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMC13A, FMM13A</strong>
|-
|[[Image:FMC13A_cover1_correct.png|280px]]
|[[Image:FMC13A_cover2_correct.png|280px]]
|[[Image:FMC13A_cover3_correct.png|280px]]
|[[Image:FMC13A_cover4_correct.png|280px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB202, FMB204, FMB209</strong>
|-
|[[Image:case7.png|250px]]
|[[Image:case4.png|250px]]
|[[Image:case2.png|250px]]
|[[Image:case5.png|250px]]
|[[Image:case3.png|250px]]
|[[Image:case6.png|250px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB230</strong>
|-
|[[Image:FMX2YX_cover_open1_correct.png|280px]]
|[[Image:FMX2YX_cover2_correct.png|280px]]
|[[Image:FMX2YX cover3 correct.png|280px]]
|[[Image:FMX2YX_cover4_correct.png|280px]]
|[[Image:FMX2YX_cover5_correct.png|middle|280px]]
|[[Image:FMX2YX_cover6_correct.png|middle|280px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMC230, FMM230, FMC234</strong>
|-
|[[Image:FMX2YX_cover_open1_correct.png|280px]]
|[[Image:FMX2YX_cover2_correct.png|280px]]
|[[Image:FMX2YX SIM insert FMC230.png|280px]]
|[[Image:FMX2YX_cover4_correct.png|280px]]
|[[Image:FMX2YX_cover5_correct.png|middle|280px]]
|[[Image:FMX2YX_cover6_correct.png|middle|280px]]
|}
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed">
<strong>OBD trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB001</strong>
|-
|{{{insert1|[[Image:Fmb010_cover_1.png|280px]]}}}
|{{{insert2|[[Image:Fmb010_cover_2.png|280px]]}}}
|{{{insert3|[[Image:Fmb010_battery_1.png|280px]]}}}
|{{{insert4|[[Image:Fmb010_cover_3.png|280px]]}}}
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB002, FMB003</strong>
|-
|{{{insert1|[[Image:Fmb020 card 1.png|280px]]}}}
|{{{insert2|[[Image:Fmb020 card 2.png|280px]]}}}
|{{{insert3|[[Image:Fmb020 card 3.png|280px]]}}}
|{{{insert4|[[Image:Fmb020 card 4.png|280px]]}}}
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMC001, FMC003, FMC00A, FMM001, FMM003, FMM00A</strong>
|-
|{{{insert1|[[Image:Fmm001_cover_1.png|280px]]}}}
|{{{insert2|[[Image:Fmm0001_cover_2.png|280px]]}}}
|{{{insert3|[[Image:Fmm001_battery_1.png|280px]]}}}
|{{{insert4|[[Image:Fmm001_cover_3.png|280px]]}}}
|}
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed">
<strong>CAN trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB140, FMC150, FMM150</strong>
|-
|[[Image:{{{sim_insert_pic1|FMB1_cover1_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic2|FMB1_cover2_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic3|FMB1_cover3_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|FMB1_cover4_correct.png}}}|260px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB240</strong>
|-
|[[Image:FMX2YX_cover_open1_correct.png|280px]]
|[[Image:FMX2YX_cover2_correct.png|280px]]
|[[Image:FMX2YX SIM insert FMC230.png|280px]]
|[[Image:FMX2YX_cover4_correct.png|280px]]
|[[Image:FMX2YX_cover5_correct.png|middle|280px]]
|[[Image:FMX2YX_cover6_correct.png|middle|280px]]
|}
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed">
<strong>Professional trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB641</strong>
|-
|[[Image:Fmb640FMB640111.png|260px]]
|[[Image:Fmb640-FMB640222.png|260px]]
|[[Image:Fmb640FMB640333.png|260px]]
|[[Image:Fmb640FMB640444.png|260px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMC650, FMM650</strong>
|-
|[[Image:{{{sim_insert_pic1|{{{model|Fmb640}}}-cover-1.png}}}|260px]]
|[[Image:{{{sim_insert_pic2|{{{model|Fmb640}}}-cover-2.png}}}|260px]]
|[[Image:{{{sim_insert_pic3|{{{model|Fmb640}}}-cover-3.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|{{{model|Fmb640}}}-cover-4.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|{{{model|Fmb640}}}-cover-5.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|{{{model|Fmb640}}}-cover-6.png}}}|260px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMB125, FMC125, FMM125</strong>
|-
|[[Image:{{{sim_insert_pic1|FMB1_cover1_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic2|FMB122-Battery-Sim-2.png}}}|260px]]
|[[Image:{{{sim_insert_pic3|FMB1_cover3_correct.png}}}|260px]]
|[[Image:{{{sim_insert_pic4|FMB1_cover4_correct.png}}}|260px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>FMC225</strong>
|-
|[[Image:FMX2YX_cover_open1_correct.png|280px]]
|[[Image:FMX2YX_cover2_correct.png|280px]]
|[[Image:FMX2YX SIM insert FMC230.png|280px]]
|[[Image:FMX2YX_cover4_correct.png|280px]]
|[[Image:FMX2YX_cover5_correct.png|middle|280px]]
|[[Image:FMX2YX_cover6_correct.png|middle|280px]]
|}
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed">
<strong>Autonomous trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>TAT100, TAT140, TAT240</strong>
|-
|[[Image:TAT100 Cover off.png|275px]]
|[[Image:TAT100 SIM in.png|275px]]
|[[Image:TAT100 Device on V3.png|275px]]
|[[Image:TAT100 Cover on.png|275px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>TMT250</strong>
|-
|[[Image:Tmt250battery1.png|185px]]
|[[Image:Tmt250battery2.png|185px]]
|[[Image:Tmt250battery3.png|185px]]
|[[Image:Tmt250battery4.png|185px]]
|[[Image:Tmt250battery5.png|185px]]
|[[Image:Tmt250battery6.png|185px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>GH5200</strong>
|-
|[[Image:GH5200 battery sim insert-1.jpg|250px]]
|[[Image:GH5200 battery sim insert-2.jpg|250px]]
|[[Image:GH5200 battery sim insert-3.jpg|250px]]
|[[Image:GH5200 battery sim insert-4.jpg|250px]]
|}
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed">
<strong>E-Mobility trackers</strong>
<div class="mw-collapsible-content">
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>TST100</strong>
|-
|[[Image:TST100_setup_1.jpg|250px]]
|[[Image:TST100_setup_2.jpg|250px]]
|[[Image:TST100_setup_3.jpg|250px]]
|[[Image:TST100_setup_4.jpg|250px]]
|[[Image:TST100_setup_5.png|250px]]
|[[Image:TST100_setup_6.jpg|250px]]
|[[Image:TST100_setup_7.jpg|250px]]
|}
 
{| class="wikitable mw-collapsible mw-collapsed" role="presentation"
|<strong>TFT100</strong>
|-
|[[Image:Cover1.png|250px]]
|[[Image:Cover2.png|250px]]
|[[Image:Cover3.png|250px]]
|[[Image:Cover4.png|250px]]
|[[Image:Cover5.png|250px]]
|}
</div>
</div>
==='''STEP 2: Connect the Device to PC'''===
'''Result: The device is powered with a power supply and connected to the PC.'''


Requirements for this step:
After connection to Configurator '''Status window''' will be displayed.


* Prepared Teltonika Telematics device
In the status window, you will be able to see crucial information that influence device operation such as GNSS and GSM statuses.
* Personal computer with Windows OS, internet connection and:
** COM port drivers (download .zip file [https://wiki.teltonika-gps.com/images/d/d0/TeltonikaCOMDriver.zip '''here'''])
* A power supply unit capable of supplying 10-30 VDC.


GNSS Info tab contains GNSS Status, Satellites and Location information.


One of the ways to control your device is by connecting it to a PC via USB or Bluetooth®. Before connecting, power must be provided to the device by a power supply.
* GNSS Status describes whether the module is ON, received/sent GNSS packets count, FIX status and FIX time
* Satellites provide you information about visible and currently in-use satellites
* Location provides you the coordinates, speed, altitude and angle of your current location.


For device-specific information about connecting to PC, see [[Main Page|'''Wiki Knowledge Base''']] → ''Your device model'' → First Start → PC Connection (Windows).
GSM Info tab contains GSM Status, Records, GPRS Traffic, SMS Count and Sockets information


==== To connect the device to the PC: ====
* GSM Status describes modem status, SIM state, GPRS status, signal level and operator code
* Records provide you information about sent records count and the date of last record sent/server response
* GPRS Traffic contains information about data usage
* SMS Count shows you sent/received SMS count
* Sockets provide status about AVL Data server communication


# Install COM port drivers.
# <u>Before</u> connecting the device to the power supply and turning the power supply on, make sure that the power supply will provide voltage in the range of 10-30 VDC, e.g. 12 VDC.
# Do not turn on the power supply. Connect the device to the power supply using the provided power cable.
#* Some devices can be powered and configured using only a USB cable, without the need for a separate power supply (in this case, skip to the last step).
# Now, turn on the power supply – device LEDs should start blinking (see [[LED Status|'''LED Status''']]).
# Connect the device to the PC via the provided USB cable or Bluetooth®.
The device is now powered and connected to the PC.
==='''STEP 3: Configure the Device'''===
'''Result: The device is configured to generate and send records to a specified server.'''
Requirements for this step:
* Teltonika Telematics device connected to the PC
* PC with Windows OS and latest Microsoft .NET Framework.
* Teltonika Configurator software (download the latest version [[Teltonika Configurator versions|'''here''']]).
Every Teltonika Telematics device is pre-configured with default factory settings. Use the [[Teltonika Configurator Introduction|'''Teltonika Configurator''']] software and easily change device settings to meet your specific needs.
Here, we go through the most important features of the Configurator:
* Starting the Configurator.
* Using the most important menus: Status, System, GPRS, and Data Acquisition.
==== Start the Configurator ====
On your PC, start the Configurator and select your connected device.
[[File:Faceless_configurator_select.png|370x370px]]
The primary window opens. It contains three areas:
# Top area - loading and saving configurations, updating firmware, and other actions.
# Left-side area - shows menus containing various device settings. Each device may have a different set of settings.
# Main area - here, the settings will show up when you click on a menu.
{|
|-
|'''''Important!'''''||<b>''After making changes to the configuration, save them by clicking “Save to device.”To restore the configuration to default factory settings, click “Reset configuration”.''</b>
<b>''To disconnect from the device, click the device button (top right).''</b>
|}
==== Status Menu ====
The Status menu contains general device information. View statuses of the main systems, such as GNSS and GSM, in separate tabs.
[[File:GNSS Info.png|frameless|550x550px]][[File:GSM Info.png|frameless|549x549px]]
{| class="wikitable"
{| class="wikitable"
|+Status menu overview
|+
!Tab in Status menu
GNSS/GSM Status
!Description
!Illustration
!Most important parameters to watch
!Description of most important parameters
|-
| rowspan="2" |GNSS info
| rowspan="2" |Shows status of GNSS module and the fix status, counts for packets and satellites, location information.
|Module Status – shows whether the GNSS module is ON or in one of the Sleep modes.
|-
|-
|Fix Status – shows if a satellite fix is available.
! rowspan="2" |[[File:GNSS Info.png|frameless|800x800px]]
Make sure that the device is facing an open sky - at least four visible satellites are required for a GNSS fix.
|Module status - here you will be able to see whether module is ON or in a Sleep mode.
|-
|-
| rowspan="3" |GSM info
|Fix Status - Fix/No Fix. For a GNSS fix, at least 4 visible satellites are needed, thus for best performance, the device should be facing open sky.
| rowspan="3" |Shows GSM modem and SIM status, signal level, record sending timestamps, GPRS traffic and SIM data, sockets.
|Signal Level – shows the signal level.
Make sure that signal is available – this allows the device to successfully send data to the server.
|-
|-
|Type – shows the type of GPRS connection.
| rowspan="3" |[[File:GSM Info.png|frameless|801x801px]]
|Signal Level - make sure that the signal is available in order to send the data to the server.
|-
|-
|Socket – shows socket information (“Closed”, or the server domain and port used to send AVL data via TCP/UDP).
|Type - AVL Data sending status.
|-
|-
|I/O info
|Socket - Closed or Server domain and port which is used when sending AVL Data via TCP/UDP.
| colspan="2" |Shows current values from all configurable I/O elements.
|-
|Maintenance
| colspan="2" |Allows capturing data logs, accelerometer data, and calibrating LLS sensors.
|}
|}
 
Various '''Status window''' tabs display information about '''GNSS, GSM, I/O, Maintenance''' and etc. configuration can be loaded and saved to the device. '''After changing the configuration, make sure that modifications are saved by clicking "Save to device" button.''' To restore default configuration, click '''"Reset configuration"''' button.
==== System Menu ====
The System menu contains global settings that control the general operation of the tracking device.
 
{| class="wikitable"
{| class="wikitable"
|+
|+
Note on “Saving/Sending Records Without Time Sync” for testing purposes
|[[File:Testing_always_sending.png|alt=|frameless]]
|[[File:Testing_always_sending.png|alt=|frameless]]
|''Locate the “System Settings” area.''
|'''Note:''' make sure that "Records Saving/Sending Without TS" in System Tab is configured as "Always" ''for testing purposes.''
''For testing purposes, set the “Saving/Sending Records Without Time Sync” setting to “Always”.''
This will allow device to send the data even if there is no GNSS fix (which is hardly obtained inside the buildings) and/or time synchronization.
 
''This will allow the device to send data without a GNSS fix and/or time synchronization (which may happen when testing the device indoors, e.g. in an office).''
|}
 
==== GPRS Menu ====
The GPRS menu allows configuring server and GPRS settings.
 
With a correct GPRS/server setting configuration, the device will synchronize time, and update records to the configured server. The device will do this based on time intervals set in the Data Acquisition menu (see below).
{|
|-
|''Note!''||''If you have not yet set up a GNSS tracking service, you can use Teltonika TCP/UDP listener (to receive data from the device) and Teltonika parser (to parse the received information). Download the software [[Special:Redirect/file/Protocols and AVL parser pack.zip|'''here''']] (archive password: 1234).''
|}
|}
The table below describes the most important parameters in the GPRS menu. This is the minimal required configuration for a device to start sending data to your server.
Most important configurator section is GPRS – where all your server and '''GPRS settings''' can be configured and '''Data Acquisition''' – where data acquiring parameters can be configured.
{| class="wikitable"
{| class="wikitable"
|+GPRS menu overview
|+GPRS Settings
!Figure
!Illustration
!Area
!Parameter ID
!Parameter ID
!Parameter description
!Description
|-
|-
| rowspan="3" |[[File:GPRS_settings.png|alt=|frameless|400x400px]]
! rowspan="3" |[[File:GPRS_settings.png|alt=|frameless|400x400px]]
| rowspan="3" |GPRS Settings
|<span style="background-color:#91b9d4;">2001</span>  
|<span style="background-color:#91b9d4;">2001</span>
|'''A'''ccess '''P'''oint '''N'''ame is a gateway between mobile operator and public internet.
|APN (Access Point Name) – a gateway between mobile operator and the public internet.
It can be obtained from your SIM card provider.
The device connects to the internet when current APN settings are entered.


Obtain the APN from your SIM card provider.
When correct APN settings will be entered device will connect to the internet.


Some devices support the Auto APN feature, see [[Auto APN feature for FM trackers|'''here''']] for more information.
Note: we do have an auto APN functionality, which is described [[Auto APN feature for FM trackers|'''here''']]
|-
|<span style="background-color:#b991d4;">2003</span>
|APN password (if there are no APN password, empty field should be left)
|-
|-
|<span style="background-color:#91d4b9;">2002</span>
|<span style="background-color:#91d4b9;">2002</span>
|APN username (leave the field empty if there is no APN username).
|APN username (if there are no APN username, empty field should be left)
|-
|<span style="background-color:#b991d4;">2003</span>
|APN password (leave the field empty if there is no APN password).
|-
|-
| rowspan="3" |[[File:SERVER_settings.png|alt=|frameless|400x400px]]
| rowspan="3" |[[File:SERVER_settings.png|alt=|frameless|400x400px]]
| rowspan="3" |Server Settings
|<span style="background-color:#b9d491;">2004</span>
|<span style="background-color:#b9d491;">2004</span>
|Domain/IP address of destination server.
|Domain/IP of destination server
|-
|-
|<span style="background-color:#d491b9;">2005</span>
|<span style="background-color:#d491b9;">2005</span>  
|Port of destination server.
|Port of destination server
|-
|-
|<span style="background-color:#d4b991;">2006</span>
|<span style="background-color:#d4b991;">2006</span>  
|Protocol for sending data to the destination server (0 – TCP, 1 - UDP).
|Data sending to destination server protocol (0 – TCP, 1 – UDP)
|}
|}
You can also quickly set up your device GPRS settings via SMS. Send the following SMS command. The highlighted parameter IDs are explained in the table above. Make sure to insert two space symbols before SMS text:
[[File:SMS_testing.png|alt=|347x347px|thumb|Picture 4: SMS communication between user and device]]'''Note:''' If you do not have GPS tracking service yet, you can use Teltonika TCP/UDP listener to receive data from the device and Teltonika parser to parse received information. Software can be downloaded from [[Special:Redirect/file/Protocols_and_AVL_parser_pack.zip|here.]] Archive password: 1234
 
<br />
If you do not want to configure your device via configurator, you can quickly set up your device GPRS settings by sending this SMS command to it:
  "  setparam <span style="background-color:#91b9d4;">2001</span>:APN;<span style="background-color:#91d4b9;">2002</span>:APN_username;<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"
  "  setparam <span style="background-color:#91b9d4;">2001</span>:APN;<span style="background-color:#91d4b9;">2002</span>:APN_username;<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"
[[File:SMS_testing.png|alt=Communcation between user and device via SMS|none|thumb|347x347px|Communication between user and device via SMS]]
'''Note''': Before SMS text, two space symbols should be inserted.


==== Data Acquisition Menu ====
After successful GPRS/SERVER settings configuration, device will '''synchronize time''' and '''update records''' to '''the configured server''' according to the Data Acquisition time intervals. Default configuration has optimal parameters present to ensure best performance of track quality and data usage. However, '''''for testing''''',  we do recommend these Data Acquisition settings:
The Data Acquisition menu allows configuring how the device acquires data based on the operator type and movement source.
 
The device will generate periodic records and send them to the server based on the Data Acquisition settings. The default device configuration has optimal parameters pre-configured for best track quality and data usage.  
 
For testing purposes, set certain parameters according to the table below. As can be seen, here we configure the device to make records every 30 seconds and send them also every 30 seconds. The device will switch operating modes (between “On Stop” and “Moving”) based on the status of configured movement source.
 
After testing, configure Data Acquisition settings according to your needs. For more detailed information about configuring your device using the Teltonika Configurator, see [[Main Page|'''Wiki Knowledge Base''']] → Y''our device model'' → Configuration.
 
The table below describes the most important parameters in the Data Acquisition menu.
{| class="wikitable"
{| class="wikitable"
|+Data Acquisition menu overview
|+
!Figure ('''Recommended Data Acquisition settings for device testing''')
Testing Data Acquisition settings
!'''Parameter ID'''
!Illustration
!'''Parameter description'''
!Parameter ID
!Description
|-
|-
| rowspan="3" |[[File:Testing_Data_Acquisition_V2.png|alt=]]
! rowspan="3" |[[File:Testing_Data_Acquisition_V2.png|alt=|frame|Picture 5: Recommended Data Acquisition values for testing purposes]]
|10000
|'''10000'''
|Min Period –the minimal time interval (seconds) between record acquisition. The device will acquire new records every Min Period seconds.
|'''Min period''' indicates time interval in seconds in order to acquire new record.
|-
|-
|10004
|'''10004'''
|Min Saved Records – the minimum number of records that can be sent to the server in one data packet. The device will send no less that Min Saved Records every Min Period seconds.
|'''Min Saved Records''' defines minimum number of records in one data packet that can be sent to server.
|-
|-
|10005
|'''10005'''
|Send Period – the time interval (seconds) after which the device checks whether it has generated enough records (based on the Min Saved Records parameter).
|'''Send Period''' indicates time interval in seconds of sending data to server. If interval is set to 0 seconds, device will not send any records to server.
|}


Device will generate periodic records and send them to server based on Data Acquisition settings.


''Note! If the link with the server is open, records are sent to the server immediately after they are generated. Send Period setting is only used to trigger data sending if the link with the server is closed.''
Using these settings, the device will make a periodic record every 30 seconds and will send it every 30 seconds
|}


==='''STEP 4: Mount the Device'''===
After testing, Data Acquisition settings should be configured according to your needs.
'''Result: The device is mounted in an optimal location, with good GNSS and GSM connectivity.'''


Requirements for this step:
The device will switch operating mode between On Stop and Moving based on configured corresponding movement source status.


* Teltonika Telematics device with a basic configuration
More details about devices configuration using Configurator and more information about your particular device can be found [[Main Page|Teltonika WIKI documentation.]] Click on ''your device'' -> Configuration.
* The tracked object (vehicle, asset) (if available)


==='''Mount the Device'''===
Different types of devices have specific mounting instructions: some of them are simple plug-and-play, while other hard-wired devices require professional installation. Please find your specific device mounting instructions [[Main Page|Teltonika WIKI documentation.]] Click on ''your device'' -> First Start -> Mounting recommendations and precautions.


Every Teltonika Telematics device has specific mounting instructions. Some devices are plug-and-play, while hard-wired devices require professional installation.
===='''Installation instructions'''====
[[File:OBD tracker mounting places.3.png]]


For detailed information about wiring your specific device, see [[Main Page|'''Wiki Knowledge Base''']] → ''Your device model'' → First Start → Mounting recommendations and precautions.


The most important mounting recommendations are:


* For vehicles, if possible, mount the device under the plastic panel behind the front window.
* The Teltonika logo on the device should be facing the sky – this orients the antennas of the device for best signal reception.
* Make sure that no metal parts surround the device – metal may negatively impact signal reception.


Below is an example illustration for mounting a device.


[[File:Mounting picture 02-01.png|frameless|806x806px]]
Considering the fact that different device types have different mounting positions, here are our recommendations for hard-wired devices:


==='''STEP 5: Track the Device'''===
* Mount under the plastic panel behind the front window
'''Result: The user tracks their device on a tracking platform.'''
* Logo facing front window (sky)
* No metal parts surrounding the device


Requirements for this step:
==='''Tracking the Device'''===


* Teltonika Telematics device with a basic configuration
Last but not least step for Basic Testing would be to get data/track from your device.  
* A user account on one of the supported tracking platforms, or
* Access to a router and a TCP/UDP listener
The last step in basic testing is to get data from your device to a tracking platform.  


Do this by using pre-made tracking platforms (see [[Fleet Management platforms|'''here''']]), or simple TCP/UDP listeners.
This can be done by using either simple TCP/UDP listeners or pre-made tracking platform like listed [[Fleet Management platforms|here]].  


To set up a simple TCP/UDP listener on your personal computer:
Below you can find steps on how to setup simple TCP/UDP listener on your personal computer.


# Open a TCP/UDP port (see [[Opening TCP/UDP port|'''here''']]).
# Open [[Opening TCP/UDP port|TCP/UDP port]]  
# Do the steps according to [[Java Parser First Start Guide|'''Java Parser First Start Guide''']].
# Go to [[Java Parser First Start Guide]]  


The illustrations below show a device track on different pre-made tracking platforms.
Below you can find pictures of how the track looks on different pre-made tracking platforms:


[[File:TAVL jamming.png]]
[[File:TAVL jamming.png]]
Line 628: Line 228:
[[File:Discover more device possibilities in-depth banner.png]]
[[File:Discover more device possibilities in-depth banner.png]]


Here, we review certain advanced functionalities that allow you to get the most out of your Teltonika Telematics device.
In this chapter we will review advanced device functionalities to get the most out of your Teltonika Telematics device. We will go through some of the specific, widespread use cases, however, keep in mind that device scenarios are not limited to just that. Available device functions can accomplish much wider range of application scenarios, which will be limited only by your imagination!


This advanced testing guide is only an example – available functionalities allow accomplishing much more!
==='''Advanced SMS capabilities'''===


==='''Parameter IDs and Advanced SMS capabilities'''===
Teltonika devices have broad SMS usage spectrum including advanced device configuration and debugging. A full list of SMS commands can be found [[FMB SMS/GPRS Commands|here.]]
[[File:WIKI_hover.gif|alt=|right]]
All of the parameters mentioned in the guide above (and many more) have a name and an ID (unique identifier). The parameter ID consists of 3 or 5 digits. See a detailed list of parameters and their IDs [[FMB Device Family Parameter list|'''here''']]. You can also find a relevant parameter ID by hovering your mouse pointer over a specific parameter in the Configurator.


Parameters of Teltonika Telematics devices may be configured and read via SMS.
For example, one of the most widely used SMS command for configuring the device is "setparam". Below you can see a description of this command:


Teltonika Telematics devices offer a wide range of SMS configuration and debugging features - see the full list of SMS commands [[FMB SMS/GPRS Commands|'''here''']].
Setparam changes parameter value. Command structure is: ''"<SMS_Login><Space><SMS_Password><Space>setparam<Space>[Parameter ID]'' ''':''' ''[New Parameter Value]'' ''';''' ''[Parameter ID]'' ''':''' ''[New Parameter Value]''..." Parameter ID consists of 3 or 5 digits. A detailed list of parameters and identifiers can be found [[FMB Device Family Parameter list|here]].
{| class="wikitable"
|+
|[[File:WIKI_hover.gif]]
|You can also find parameter ID by hovering mouse pointer over specific parameter in configurator.
|}
SMS command is limited to 160 characters.


SMS command length is limited to 160 characters.
Example:


The general SMS command structure is:
"setparam 2001:wap" will change configured APN name.
<SMS_Login>''<space>''<SMS_Password>''<space>''<Command>''<space>''[Parameter ID]''':'''[New Parameter Value]''';'''[Parameter ID]''':'''[New Parameter Value]...


* A space symbol separates these elements: SMS login, password, command name, the first parameter:value pair
Answer:
* A colon symbol separates the parameter ID and the new parameter value
* Multiple parameter values can be changed with one SMS command – a semicolon symbol separates parameter:value pairs.


If no login name and password are set in the device configuration, just omit them in the SMS command. I.e., the command should start with two spaces, followed by the command name.
"Param ID:2001 Value:wap2"


As an example, let us take one of the most widely used SMS commands: “setparam”. It changes a parameter value, e.g.:
Example:


* If a login and password are set:
"setparam 2001:wap;2002:user;2003:pass" will change configured APN name, APN username and APN password.


<SMS_Login><space><SMS_Password><space>setparam<space>101:1
==='''Advanced Use Case configuration'''===
This SMS command will change the parameter “101” (Ignition settings) to “1” (DIN1).


* If no login and password are set:
Our devices can be as simple or as complicated as you want them to be. Having one firmware and one configurator for all the devices allows different devices to be used in a broad spectrum of use cases. Other use cases have specific devices assigned.


<space><space>setparam<space>101:2;138:1
To show how easy it is to use our devices in different use cases we prepared a technical description of what steps are needed to integrate our device into your use case.
This SMS command will change the parameter “101” (Ignition settings) to “2” (Accelerometer) and parameter “138” (Movement source) to “1” (Ignition).


==='''Advanced Use Cases'''===
Each category explains what parameters have to be configured and why as well as showing examples of what information you should expect on your server and how to read it.


Beyond basic configuration, Teltonika Telematics devices can be configured as intricately as you require. Most devices can cover a broad spectrum of use cases, while others are highly specialized.
'''General''' use case descriptions, an overview of the most commonly used solutions, their topologies, and possibilities, provided on the Teltonika website '''[https://teltonika-gps.com/industries/use-cases/ USE CASES]'''.  


General and specific use cases are presented in the links below. Each category explains what parameters must be configured and why. Where applicable, we provide examples of what information would be available on your server and how to read it.
'''Specific technical''' use case instructions can be found [[Usage scenarios|here.]]  
 
* General use cases are presented on the Teltonika Telematics website [https://teltonika-gps.com/industries/use-cases/ '''here'''].
* Specific technical usage scenarios are presented on the Telematics Wiki [[Usage scenarios|'''here''']].


=='''<big>Solutions</big>'''==
=='''<big>Solutions</big>'''==
Line 676: Line 272:
[[File:Extend device's capabilities with our solutions banner.png]]
[[File:Extend device's capabilities with our solutions banner.png]]


Here, we overview Teltonika Telematics solutions to remotely access, manage and control devices, including external devices, such as tachographs.
In this section we will get acquainted with our most useful and simple to utilize solutions which will provide remote access, management and control of your device as well as external devices like tachograph.


==='''FOTA WEB'''===
==='''FOTA WEB'''===
FOTA WEB is a SaaS solution for the remote, OTA (over-the-air) management of Teltonika Telematics devices.<youtube width="850" height="480">SiMwnkEEes4</youtube>


FOTA WEB allows you to:
FOTA WEB – a brand new and exciting solution for remote access to your Teltonika Fleet management devices! FOTA WEB enables firmware upgrades, configuration changes, remote device debugging of FMx devices, as well as CAN adapter updates without a need of a dedicated application – everything is achieved through your regular Web browser, from any device. By default device connects to FOTA WEB every 720 minutes (parameter is configurable). For more information click '''[[FOTA WEB|here]].''' If you would like to have your own FOTA WEB account, please contact your Sales Manager. [https://www.youtube.com/watch?v=SiMwnkEEes4 Short video about FOTA WEB.]


* Access your devices through a Web browser on any device
Moreover, we also have a desktop FOTA solution: desktop ''FOTA is predecessor of FOTA WEB, which is mainly used for updating EOL (End-Of-Life, - FM5300, FMA120 etc.) devices. We strongly advise to use our newest [[FOTA WEB]] platform for OTA changes.''
* Upgrade device firmware
* Change the configuration
* Remotely debug FMx devices
* Update CAN adapters without a dedicated application
* Upload a CAN configuration to some devices


For more information, see [[FOTA WEB|'''here''']].
'''''Note:''''' FOTA WEB meets all '''GDPR''' requirements thus '''we do not store, track or analyze your personal data.'''


FOTA WEB is compatible with all currently sold products and is available for all direct Teltonika Telematics customers. Contact Teltonika Telematics sales representatives to obtain access to FOTA WEB. FOTA WEB meets all GDPR requirements.
==='''WEB Tacho'''===
{|
|-
|''Note!''||''A desktop solution – FOTA – is a predecessor to FOTA WEB. It is mainly used to update EOL (end-of-life) devices. We strongly recommend to use the newest version of FOTA WEB to perform OTA management.''
|}
==='''TachoSync'''===


[[TachoSync]] is a cloud-based SaaS (Software-as-a-Service) solution that streamlines '''remote download and management of tachograph data''', ensuring effortless compliance and operational efficiency.
Teltonika WEB Tacho is an online service that allows to remotely download Tachograph files from supported tachographs, using Teltonika professional trackers. Files are stored on server, in defined format (.DDD, .V1B, .C1B, .TGD). Files can be downloaded – directly from the website, receive in Email, receive to defined FTP server. For more information click '''[[WEB Tacho|here.]]''' If you would like to have your own WEB Tacho account, please contact your Sales Manager.


Contact Teltonika Telematics sales representatives to obtain access to TachoSync.
{|
|-
|''Note!''||''TachoSync will gradually replace our previous solution - WEB Tacho - by the end of 2025 (may change depending on adoption rates).''
|}
=='''<big>Protocols</big>'''==
=='''<big>Protocols</big>'''==


[[File:Understand communication language banner.png]]
[[File:Understand communication language banner.png]]


Here, we introduce the communication protocols used by Teltonika Telematics devices.  
Our devices communicate using unique Teltonika's protocols. Protocols are applied for different usage scenarios using Codecs. Each Codec has its own structure and application scenario. A codec is a device or computer program for encoding or decoding a digital data stream or signal.
 
==='''Data sending protocols'''===
 
Each Codec used by Teltonika devices has different purpose. For example, [[Codec#Codec 8 Extended|Codec 8 Extended]] is main FM device protocol used to send data to server, while [[Codec#Codec for communication over GPRS messages|Codec 12]] is used for device-server communication using GPRS messages. All information about Teltonika's communication protocols used by FM devices can be found [[Codec|here.]]
 
==='''Protocols implementation'''===
 
TCP/UDP listener and AVL Records parser, which source code could be used as a template for developing your own server, can be helpful for implementing protocols. A full software pack can be downloaded from [[Special:Redirect/file/Protocols_and_AVL_parser_pack.zip|here.]] Archive password: 1234.


All Teltonika Telematics devices communicate with servers using specialized protocols, called “codecs”. Each protocol has a particular structure and application scenario. E.g., [[Codec#Codec%208%20Extended|'''Codec 8 Extended''']] is used for one-way device to server data transmission, while [[Codec#Codec%20for%20communication%20over%20GPRS%20messages|'''Codec 12''']] is used for two-way device-server communication via GPRS messages.


More general information about the various protocols can be found [[Codec|'''here''']].
Each device I/O parameter has its own unique ID, which is called AVL ID. Once the TCP/UDP listener and AVL Records parser are implemented, received AVL IDs descriptions can be checked in the AVL ID list page for your specific device (for example: [[FMB120_Teltonika_Data_Sending_Parameters_ID|FMB120]] ).
[[Category:General Information]]

Revision as of 14:33, 15 June 2021

Main Page > General Information > Universal Device Test Guide



Introduction

Universal Device Testing Guide can be applied to any Teltonika Telematics device. Purpose of this guide is to help new users get acquainted with Teltonika Fleet Management devices and test basic functions in 5 easy steps.

Once you are finished with basic testing, you will find additional instructions on how to test specific use cases and advanced features of our devices as well as remote tracker management platform and other solutions.

In case you have any questions regarding Teltonika devices or their features, do not worry - we have a well of knowledge called Teltonika WIKI, Crowd Support Forum and our Official Youtube Channel, where you can find answers regarding our devices functionalities and specifications.

If you do not find answers to your questions online - do not despair, we have a highly professional team of support engineers who are willing to help and can be reached via VIP Helpdesk.

Basic Testing

In this chapter we will go through 5 easy testing steps which will help you get acquainted with Teltonika Telematics devices. We will cover everything you need to start using the device - from inserting SIM card, powering the device and ending with GPS track information directly from your vehicle to the server.

Prepare the Device

All our devices use SIM card for telecommunication, thus you will not be able to get any data and/or communicate with the device remotely without the SIM card. In this chapter you will find a guide on how to insert SIM card and connect internal battery.

Note: Different Teltonika devices use different SIM card types: mini-SIM, micro-SIM, nano-SIM, and eSIM (which is soldered during device manufacturing process).

How to insert SIM card and connect the battery*

  1. Gently remove device cover using plastic pry tool from both sides as it is showed in a 1st picture.
  2. After opening device cover, you will see SIM card and battery connection slots.
  3. Insert SIM card as shown with PIN request disabled or read Security info (Universal Guide) how to enter it later in Configurator. Make sure that SIM card cut-off corner is pointing forward to slot.
  4. Connect the battery as shown on device. Position the battery in place where it does not obstruct other components.
  5. Attach device cover back. Device is ready to be connected.


* If you would like to check how to insert SIM card into your particular device, please check Teltonika WIKI documentation. Click on your device -> First Start -> How to insert SIM Card.

SIM card insertion/removal must be performed when device is powered off – external voltage and internal battery disconnected. Otherwise SIM card might be damaged or device will not detect it.


Connect the device to PC

One way to control your device is by connecting it to PC. During this step, we will introduce you on how to establish the connection.

How to install USB drivers (Windows)

Download COM port drivers from Teltonika here and install them.

PC Connection (Windows)

Power-up device with DC voltage (10 – 30 V)* power supply using supplied power cable**. LED’s should start blinking, see “LED behaviour description”.

Connect device to computer*** using USB cable or Bluetooth connection.


* FMB900, FMB910, FMB920, MTB100, FMB202, FMB204 devices support (6 - 30 V) DC power supply.

** FMP100, FMB002, FMB020, FMB003 can be powered up and configured via USB without any need of external power supply.

*** If you would like to check how to connect your particular device to PC, please see device Teltonika WIKI documentation. Click on your device -> First Start -> PC Connection (Windows)

Configure the Device

After powering up your device, it should be configured to meet your needs. Here you will find steps on how to prepare your device for a first start.

Configuration

At first device will have default factory settings set. These settings should be changed according to the user's needs.
Main configuration can be performed via Teltonika Configurator software. Get the latest Configurator version from here. Configurator operates on Microsoft Windows OS and uses prerequisite latest MS .NET Framework.

Configuration process begins by pressing on connected device:

After connection to Configurator Status window will be displayed.

In the status window, you will be able to see crucial information that influence device operation such as GNSS and GSM statuses.

GNSS Info tab contains GNSS Status, Satellites and Location information.

  • GNSS Status describes whether the module is ON, received/sent GNSS packets count, FIX status and FIX time
  • Satellites provide you information about visible and currently in-use satellites
  • Location provides you the coordinates, speed, altitude and angle of your current location.

GSM Info tab contains GSM Status, Records, GPRS Traffic, SMS Count and Sockets information

  • GSM Status describes modem status, SIM state, GPRS status, signal level and operator code
  • Records provide you information about sent records count and the date of last record sent/server response
  • GPRS Traffic contains information about data usage
  • SMS Count shows you sent/received SMS count
  • Sockets provide status about AVL Data server communication
GNSS/GSM Status
Illustration Description of most important parameters
Module status - here you will be able to see whether module is ON or in a Sleep mode.
Fix Status - Fix/No Fix. For a GNSS fix, at least 4 visible satellites are needed, thus for best performance, the device should be facing open sky.
Signal Level - make sure that the signal is available in order to send the data to the server.
Type - AVL Data sending status.
Socket - Closed or Server domain and port which is used when sending AVL Data via TCP/UDP.

Various Status window tabs display information about GNSS, GSM, I/O, Maintenance and etc. configuration can be loaded and saved to the device. After changing the configuration, make sure that modifications are saved by clicking "Save to device" button. To restore default configuration, click "Reset configuration" button.

Note: make sure that "Records Saving/Sending Without TS" in System Tab is configured as "Always" for testing purposes.

This will allow device to send the data even if there is no GNSS fix (which is hardly obtained inside the buildings) and/or time synchronization.

Most important configurator section is GPRS – where all your server and GPRS settings can be configured and Data Acquisition – where data acquiring parameters can be configured.

GPRS Settings
Illustration Parameter ID Description
2001 Access Point Name is a gateway between mobile operator and public internet.

It can be obtained from your SIM card provider.

When correct APN settings will be entered device will connect to the internet.

Note: we do have an auto APN functionality, which is described here

2003 APN password (if there are no APN password, empty field should be left)
2002 APN username (if there are no APN username, empty field should be left)
2004 Domain/IP of destination server
2005 Port of destination server
2006 Data sending to destination server protocol (0 – TCP, 1 – UDP)
Picture 4: SMS communication between user and device

Note: If you do not have GPS tracking service yet, you can use Teltonika TCP/UDP listener to receive data from the device and Teltonika parser to parse received information. Software can be downloaded from here. Archive password: 1234


If you do not want to configure your device via configurator, you can quickly set up your device GPRS settings by sending this SMS command to it: 

"  setparam 2001:APN;2002:APN_username;2003:APN_password;2004:Domain;2005:Port;2006:0"

Note: Before SMS text, two space symbols should be inserted.

After successful GPRS/SERVER settings configuration, device will synchronize time and update records to the configured server according to the Data Acquisition time intervals. Default configuration has optimal parameters present to ensure best performance of track quality and data usage. However, for testing, we do recommend these Data Acquisition settings:

Testing Data Acquisition settings
Illustration Parameter ID Description
Picture 5: Recommended Data Acquisition values for testing purposes
 10000 Min period indicates time interval in seconds in order to acquire new record.
10004 Min Saved Records defines minimum number of records in one data packet that can be sent to server.
10005 Send Period indicates time interval in seconds of sending data to server. If interval is set to 0 seconds, device will not send any records to server.

Device will generate periodic records and send them to server based on Data Acquisition settings.

Using these settings, the device will make a periodic record every 30 seconds and will send it every 30 seconds

After testing, Data Acquisition settings should be configured according to your needs.

The device will switch operating mode between On Stop and Moving based on configured corresponding movement source status.

More details about devices configuration using Configurator and more information about your particular device can be found Teltonika WIKI documentation. Click on your device -> Configuration.

Mount the Device

Different types of devices have specific mounting instructions: some of them are simple plug-and-play, while other hard-wired devices require professional installation. Please find your specific device mounting instructions Teltonika WIKI documentation. Click on your device -> First Start -> Mounting recommendations and precautions.

Installation instructions



Considering the fact that different device types have different mounting positions, here are our recommendations for hard-wired devices:

  • Mount under the plastic panel behind the front window
  • Logo facing front window (sky)
  • No metal parts surrounding the device

Tracking the Device

Last but not least step for Basic Testing would be to get data/track from your device.

This can be done by using either simple TCP/UDP listeners or pre-made tracking platform like listed here.

Below you can find steps on how to setup simple TCP/UDP listener on your personal computer.

  1. Open TCP/UDP port
  2. Go to Java Parser First Start Guide

Below you can find pictures of how the track looks on different pre-made tracking platforms:

Advanced Testing

In this chapter we will review advanced device functionalities to get the most out of your Teltonika Telematics device. We will go through some of the specific, widespread use cases, however, keep in mind that device scenarios are not limited to just that. Available device functions can accomplish much wider range of application scenarios, which will be limited only by your imagination!

Advanced SMS capabilities

Teltonika devices have broad SMS usage spectrum including advanced device configuration and debugging. A full list of SMS commands can be found here.

For example, one of the most widely used SMS command for configuring the device is "setparam". Below you can see a description of this command:

Setparam changes parameter value. Command structure is: "<SMS_Login><Space><SMS_Password><Space>setparam<Space>[Parameter ID] : [New Parameter Value] ; [Parameter ID] : [New Parameter Value]..." Parameter ID consists of 3 or 5 digits. A detailed list of parameters and identifiers can be found here.

You can also find parameter ID by hovering mouse pointer over specific parameter in configurator.

SMS command is limited to 160 characters.

Example:

"setparam 2001:wap" will change configured APN name.

Answer:

"Param ID:2001 Value:wap2"

Example:

"setparam 2001:wap;2002:user;2003:pass" will change configured APN name, APN username and APN password.

Advanced Use Case configuration

Our devices can be as simple or as complicated as you want them to be. Having one firmware and one configurator for all the devices allows different devices to be used in a broad spectrum of use cases. Other use cases have specific devices assigned.

To show how easy it is to use our devices in different use cases we prepared a technical description of what steps are needed to integrate our device into your use case.

Each category explains what parameters have to be configured and why as well as showing examples of what information you should expect on your server and how to read it.

General use case descriptions, an overview of the most commonly used solutions, their topologies, and possibilities, provided on the Teltonika website USE CASES.

Specific technical use case instructions can be found here.

Solutions

In this section we will get acquainted with our most useful and simple to utilize solutions which will provide remote access, management and control of your device as well as external devices like tachograph.

FOTA WEB

FOTA WEB – a brand new and exciting solution for remote access to your Teltonika Fleet management devices! FOTA WEB enables firmware upgrades, configuration changes, remote device debugging of FMx devices, as well as CAN adapter updates without a need of a dedicated application – everything is achieved through your regular Web browser, from any device. By default device connects to FOTA WEB every 720 minutes (parameter is configurable). For more information click here. If you would like to have your own FOTA WEB account, please contact your Sales Manager. Short video about FOTA WEB.

Moreover, we also have a desktop FOTA solution: desktop FOTA is predecessor of FOTA WEB, which is mainly used for updating EOL (End-Of-Life, - FM5300, FMA120 etc.) devices. We strongly advise to use our newest FOTA WEB platform for OTA changes.

Note: FOTA WEB meets all GDPR requirements thus we do not store, track or analyze your personal data.

WEB Tacho

Teltonika WEB Tacho is an online service that allows to remotely download Tachograph files from supported tachographs, using Teltonika professional trackers. Files are stored on server, in defined format (.DDD, .V1B, .C1B, .TGD). Files can be downloaded – directly from the website, receive in Email, receive to defined FTP server. For more information click here. If you would like to have your own WEB Tacho account, please contact your Sales Manager.

Protocols

Our devices communicate using unique Teltonika's protocols. Protocols are applied for different usage scenarios using Codecs. Each Codec has its own structure and application scenario. A codec is a device or computer program for encoding or decoding a digital data stream or signal.

Data sending protocols

Each Codec used by Teltonika devices has different purpose. For example, Codec 8 Extended is main FM device protocol used to send data to server, while Codec 12 is used for device-server communication using GPRS messages. All information about Teltonika's communication protocols used by FM devices can be found here.

Protocols implementation

TCP/UDP listener and AVL Records parser, which source code could be used as a template for developing your own server, can be helpful for implementing protocols. A full software pack can be downloaded from here. Archive password: 1234.


Each device I/O parameter has its own unique ID, which is called AVL ID. Once the TCP/UDP listener and AVL Records parser are implemented, received AVL IDs descriptions can be checked in the AVL ID list page for your specific device (for example: FMB120 ).

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Universal_Device_Test_Guide&oldid=65773"