Difference between revisions of "Universal Device Test Guide"

From Wiki Knowledge Base | Teltonika GPS
Line 1: Line 1:
[[Image:Qsg_rut950_teltonika.PNG|centre]]__TOC__
+
[[Image:Qsg_rut950_teltonika.PNG|centre|]]
  
=='''Introduction'''==
 
  
'''''Thank you for joining Teltonika by purchasing our device!'''''
+
__TOC__
  
We have good news for you - even though our devices have very different functionalities and features, they can be '''managed''' using the '''same [https://teltonika-gps.com/product/fota/ OTA (Over-The-Air)] or [[Teltonika Configurator|desktop]] platforms''', thus this means '''convenient''' and '''time saving solution'''.
 
  
Even though '''our devices are simple to use''', they have a very '''wide range of possible applications'''. Please check out our several [https://teltonika-gps.com/industries/use-cases/ '''use cases examples'''].
 
  
Although our devices are simple to use, sometimes a few questions can appear. 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 all of our devices functionalities and specifications.
+
=='''<big>Introduction</big>'''==
 +
[[File:Welcome to the telematics banner 1.1.png]]
  
Even 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.
+
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.
  
Furthermore, below you can find more basic information which would be the best guide for getting used to our device.
+
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.
  
=='''How to insert SIM card and connect the battery*'''==
+
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.
All our devices use SIM card for GSM/GPRS communication, 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 into your device.
+
 
 +
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.
 +
 
 +
=='''<big>Basic Testing</big>'''==
 +
[[File:5 easy steps to prepare any Teltonika Telematics device banner.png]]
 +
 
 +
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 [[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.
 
# Gently remove '''device cover''' using '''plastic pry tool''' from both sides as it is showed in a 1st picture.
 +
# After opening device cover, you will see '''SIM card''' and '''battery''' connection '''slots'''.
 
# 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.
 
# 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.
 
# 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.
 
# 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]]
 +
|}
  
  
 +
'''<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.'''
  
 +
{|
 +
|-
 +
|[[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>
 +
|}
  
[[File:Figure1.png]][[File:Figure2.png]][[File:Figure3.png]][[File:Figure4.png]]
 
  
 +
==='''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 '''[https://teltonika-gps.com/downloads/en/fmb120/TeltonikaCOMDriver.zip 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 Status|LED behaviour description]]'''”.
 +
<span> </span>
 +
 
 +
Connect device to computer*** using '''USB cable''' or '''Bluetooth''' connection.
 +
 
 +
 
 +
''* FMB900, FMB910, FMB920, MTB100, FMB202, FMB204 devices support '''(6 - 30 V)'''  DC power supply.''
 +
 
 +
<nowiki>**</nowiki> FMP100, FMB002, FMB020, FMB003 can be powered up and configured via USB without any need of external power supply.
 +
 
 +
<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)
  
 +
==='''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'''====
  
'''<nowiki>*</nowiki> If you would like to check how to insert SIM card into your particular device, you will find a link with all devices manuals here.'''
+
At first device will have default factory settings set. These settings should be changed according to the user's needs.<br />
 +
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.
  
{|
+
Configuration process begins by pressing on connected device:
|-
+
 
|[[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>
+
[[File:Faceless_configurator_select.png|370x370px]]
|}
+
 
 +
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.
  
=='''PC Connection (Windows)'''==
+
GNSS Info tab contains GNSS Status, Satellites and Location information.
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>
 
  
#Connect device to computer using '''USB cable''' or '''Bluetooth''' connection:
+
* GNSS Status describes whether the module is ON, received/sent GNSS packets count, FIX status and FIX time
#* Using '''USB cable'''
+
* Satellites provide you information about visible and currently in-use satellites
#**You will need to install USB drivers, see "[[Universal Device Test Guide#How to install USB drivers (Windows)|'''How to install USB drivers (Windows)''']]"
+
* Location provides you the coordinates, speed, altitude and angle of your current location.
#* Using '''Bluetooth'''
 
#**Device Bluetooth is enabled by default. Turn on '''Bluetooth''' on your PC, then select '''Add Bluetooth or other device > Bluetooth'''. Choose your device named – “'''FMxyzw_last_7_imei_digits'''”, without '''LE''' in the end. Enter default password '''5555''', press '''Connect''' and then select '''Done'''. Keep in mind that the FMx640 devices do not support configuration via Bluetooth.
 
#You are now ready to use the device on your computer.
 
  
 +
GSM Info tab contains GSM Status, Records, GPRS Traffic, SMS Count and Sockets information
  
''* FMB900, FMB910, FMB920, MTB100, FMB202, FMB204 devices support '''(6 - 30 V)'''  DC power supply.''<span></span>
+
* 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
  
=='''How to install USB drivers (Windows)'''==
+
{| class="wikitable"
 +
|+
 +
GNSS/GSM Status
 +
!Illustration
 +
!Description of most important parameters
 +
|-
 +
! rowspan="2" |[[File:GNSS Info.png|frameless|800x800px]]
 +
|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.
 +
|-
 +
| 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.
 +
|-
 +
|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.
 +
{| class="wikitable"
 +
|+
 +
|[[File:Testing_always_sending.png|alt=|frameless]]
 +
|'''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.
 +
{| class="wikitable"
 +
|+GPRS Settings
 +
!Illustration
 +
!Parameter ID
 +
!Description
 +
|-
 +
! rowspan="3" |[[File:GPRS_settings.png|alt=|frameless|400x400px]]
 +
|<span style="background-color:#91b9d4;">2001</span>
 +
|'''A'''ccess '''P'''oint '''N'''ame is a gateway between mobile operator and public internet.
 +
It can be obtained from your SIM card provider.
  
#Please download COM port drivers from Teltonika '''[https://teltonika-gps.com/downloads/en/fmb120/TeltonikaCOMDriver.zip here]'''.
+
When correct APN settings will be entered device will connect to the internet.
#Extract and run '''TeltonikaCOMDriver.exe'''.
 
# Click '''Next''' in driver installation window.
 
#In the following window click '''Install''' button.
 
# Setup will continue installing the driver and eventually the confirmation window will appear. Click '''Finish''' to complete the setup.
 
  
=='''Configuration (Windows)'''==
+
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>
 +
|APN username (if there are no APN username, empty field should be left)
 +
|-
 +
| rowspan="3" |[[File:SERVER_settings.png|alt=|frameless|400x400px]]
 +
|<span style="background-color:#b9d491;">2004</span>
 +
|Domain/IP of destination server
 +
|-
 +
|<span style="background-color:#d491b9;">2005</span>
 +
|Port of destination server
 +
|-
 +
|<span style="background-color:#d4b991;">2006</span>
 +
|Data sending to destination server protocol (0 – TCP, 1 – UDP)
 +
|}
 +
[[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
  
At first device will have default factory settings set. These settings should be changed according to the user's needs.<br />
+
<br />
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 MS .NET Framework. Make sure you have the correct version installed.
+
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"
 +
'''Note''': Before SMS text, two space symbols should be inserted.
  
{| class="wikitable" style="width:50%;"
+
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:
 +
{| class="wikitable"
 
|+
 
|+
! colspan="4" style="width:50%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |MS .NET requirements
+
Testing Data Acquisition settings
 +
!Illustration
 +
!Parameter ID
 +
!Description
 
|-
 
|-
! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Operating system
+
! rowspan="3" |[[File:Testing_Data_Acquisition_V2.png|alt=|frame|Picture 5: Recommended Data Acquisition values for testing purposes]]
! style="width:25%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |MS .NET Framework version
+
|'''10000'''
! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Version
+
|'''Min period''' indicates time interval in seconds in order to acquire new record.
! style="width:5%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" |Link
 
 
|-
 
|-
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |<ul style="list-style: none; margin: 0px;">
+
|'''10004'''
<li>Windows Vista</li>
+
|'''Min Saved Records''' defines minimum number of records in one data packet that can be sent to server.
<li>Windows 7</li>
+
|-
<li>Windows 8.1</li>
+
|'''10005'''
<li>Windows 10</li>
+
|'''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.
</ul>
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |MS .NET Framework 4.6.2
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |32 and 64 bit
 
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" |[https://www.microsoft.com/en-us/download/confirmation.aspx?id=53344 www.microsoft.com]
 
 
|}
 
|}
  
Launch '''Configurator.exe'''. After launch software language can be changed by clicking [[File:Language_icon.png|25px|link=]] in the right bottom corner:
+
Device will generate periodic records and send them to server based on Data Acquisition settings.
  
[[File:FMB_Configurator_language.jpg|400px]]
+
Using these settings, the device will make a periodic record every 30 seconds and will send it every 30 seconds
  
Configuration process begins by pressing on connected device:
+
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 [[Main Page|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 [[Main Page|Teltonika WIKI documentation.]] Click on ''your device'' -> First Start -> Mounting recommendations and precautions.
 +
 
 +
===='''Installation instructions'''====
 +
[[File:OBD tracker mounting places.3.png]]
 +
 
 +
 
 +
 
 +
 
 +
 
 +
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 [[Fleet Management platforms|here]].
 +
 
 +
Below you can find steps on how to setup simple TCP/UDP listener on your personal computer.
 +
 
 +
# Open [[Opening TCP/UDP port|TCP/UDP port]]
 +
# Go to [[Java Parser First Start Guide]]
 +
 
 +
Below you can find pictures of how the track looks on different pre-made tracking platforms:
 +
 
 +
[[File:TAVL jamming.png]]
 +
 
 +
[[File:Wialonturbo.jpg]]
 +
 
 +
=='''<big>Advanced Testing</big>'''==
 +
 
 +
[[File:Discover more device possibilities in-depth banner.png]]
 +
 
 +
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'''===
  
[[File:Faceless_configurator_select.png]]
+
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.]]
  
After connection to Configurator '''Status window''' will be displayed:
+
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:
  
[[File:Faceless_configurator.png]]
+
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.
  
Various '''[[{{{model|FMB1YX}}}_Status_info|Status window]]''' tabs display information about '''[[{{{model|FMB1YX}}}_Status_info#GNSS_Info|GNSS]], [[{{{model|FMB1YX}}}_Status_info#GSM_Info|GSM]], [[{{{model|FMB1YX}}}_Status_info#I.2FO_Info|I/O]], [[{{{model|FMB1YX}}}_Status_info#Maintenance|Maintenance]]''' and etc. {{{model|FMB1YX}}} can be loaded and saved to the device. After any modification of configuration changes need to be saved to device using '''Save to device''' button. Main buttons offer following functionalities:<br />
+
Example:
#[[File:Load_from_device.png|25px|link=]] '''Load from device''' – loads configuration from device.
 
#[[File:Save_to_device.png|25px|link=]] '''Save to device''' – saves configuration to device.
 
#[[File:Load_from_file.png|25px|link=]] '''Load from file''' – loads configuration from file.
 
#[[File:Save_to_file.png|25px|link=]] '''Save to file''' – saves configuration to file.
 
#[[File:Firmware_update.png|link=|25x25px]]<span> </span>'''Update firmware'''<span> – updates firmware on device.</span>
 
#[[File:Read_records.png|25px|link=]] '''Read records''' – read records from device.
 
#[[File:Reboot_device.png|25px|link=]] '''Reboot device''' – restarts device.
 
#[[File:Reset_configuration.png|25px|link=]] '''Reset configuration''' – sets device configuration to default.
 
  
Most important configurator sections are GPRS – where all your server and '''GPRS settings''' can be configured and '''Data Acquisition''' – where data acquiring parameters can be configured.
+
"setparam 2001:wap" will change configured APN name.
More details about devices configuration using Configurator and more information about your particular device can be found [[Main Page|'''{{{config_link|in the manual}}}'''.]]
 
  
=='''Quick SMS configuration'''==
+
Answer:
  
Default configuration has optimal parameters present to ensure best performance of track quality and data usage.<br />
+
"Param ID:2001 Value:wap2"
Quickly set up your device 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"
+
Example:
  
<div style="column-count:2;-moz-column-count:2;-webkit-column-count:2">
+
"setparam 2001:wap;2002:user;2003:pass" will change configured APN name, APN username and APN password.
GPRS settings:
 
* <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)
 
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)
 
</div>
 
  
'''Note''': Before SMS text, two space symbols should be inserted.<br /><br />
+
==='''Advanced Use Case configuration'''===
[[File:IOS sms cfg.png|235px|right]]
 
  
{{{quick_sms_tmt|<table style="width:70%">
+
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.
  <tr>
 
    <td colspan="4">'''Default configuration settings'''</td>
 
  </tr>
 
  <tr>
 
    <td colspan="4">Movement and ignition detection:</td>
 
  </tr>
 
  <tr>
 
    <td>[[File:Accelerometer.png|65px]]</td>
 
    <td>Vehicle movement will be detected by accelerometer</td>
 
    <td>[[File:Ignition detection-2-2.png|65px]]</td>
 
    <td>Ignition will be detected by vehicle power voltage between 13,2 – 30 V</td>
 
  </tr>
 
  <tr>
 
    <td colspan="4">Device makes a record '''On Moving''' if one of these events happen:</td>
 
  </tr>
 
  <tr>
 
    <td>[[File:300s_icon_2.png|65px]]</td>
 
    <td>300 seconds passes</td>
 
    <td>[[File:Angle_10_2.png|65px]]</td>
 
    <td>Vehicle turns 10° degrees</td>
 
  </tr>
 
  <tr>
 
    <td>[[File:Min_distance.png|65px]]</td>
 
    <td>Vehicle drives 100 meters</td>
 
    <td>[[File:Speed_delta.png|65px]]</td>
 
    <td>Speed difference between last coordinate and current position is greater than 10 km/h</td>
 
  </tr>
 
  <tr>
 
    <td colspan="4">Device makes a record '''On Stop''' if:</td>
 
  </tr>
 
  <tr>
 
    <td>[[File:1h_icon.png|65px]]</td>
 
    <td>1 hour passes while vehicle is stationary and ignition is off</td>
 
  </tr>
 
  <tr>
 
    <td colspan="4">Records sending to server:</td>
 
  </tr>
 
  <tr>
 
    <td>[[File:120_s.png|65px]]</td>
 
    <td>If device has made a record it is sent to the server every 120 seconds</td>
 
  </tr>
 
</table>}}}
 
  
<br />
+
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.
<p>After successful SMS configuration, device will '''synchronize time''' and '''update records''' to '''configured server'''. More SMS commands can be found '''[[FMB SMS/GPRS Commands|here.]]'''</p>
 
  
{{{mounting_recommendations|=='''Mounting recommendations'''==
+
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.
  
{{{connecting_wires|* <big>Connecting wires</big>
+
'''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]'''.  
{{{plugged_in|** Wires should be connected while the module is not plugged in.}}}
 
:* Wires should be fastened to stable wires or other non-moving parts. Any heat emitting and/or moving objects should be kept away from the wires.
 
:* There should be no exposed wires. If factory isolation was removed while connecting wires, the isolation material should be applied.
 
:* If the wires are placed in the exterior or in places where they can be damaged or exposed to heat, humidity, dirt, etc., additional isolation should be applied and the wires should not be loose.
 
:* Wires cannot be connected to the board computers or control units.
 
}}}
 
  
{{{connecting_power_source|* <big>Connecting power source</big>
+
'''Specific technical''' use case instructions can be found [[Usage scenarios|here.]]
** Be sure that after the car computer goes to sleep mode, power might be still available on the power wires. Depending on car, this may happen in 5 to 30 minutes period.
 
** When module is connected, measure voltage again to make sure it did not decrease.
 
** It is recommended to connect to the main power cable in the fuse box.
 
** 3 A, 125 V external fuse shall be used.
 
}}}
 
  
{{{connecting_ignition|* <big>Connecting ignition wire</big>
+
=='''<big>Solutions</big>'''==
**Be sure to check if it is a real ignition wire i. e. power does not disappear after starting the engine.
 
**Check if this is not an ACC wire (when key is in the first position, most of the vehicle electronics are available).
 
**Check if power is still available when you turn off any of vehicles devices.
 
**Ignition is connected to the ignition relay output. As alternative, any other relay, which has power output when ignition is on, may be chosen.
 
}}}
 
  
{{{connecting_ground_wire|* <big>Connecting ground wire</big>
+
[[File:Extend device's capabilities with our solutions banner.png]]
**Ground wire is connected to the vehicle frame or metal parts that are fixed to the frame.
 
**If the wire is fixed with the bolt, the loop must be connected to the end of the wire.
 
**For better contact scrub paint from the spot where loop is going to be connected.
 
}}}
 
{{{pay_attention|{{Template:Pay_attention|model={{{model|device}}}}}}}}
 
}}}
 
  
 +
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.
  
=='''Installation instructions'''==
+
==='''FOTA WEB'''===
  
In case device has internal GNSS antenna it should be mounted with the logo facing towards open sky
+
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.]
(metal free)
 
  
[[File:Faceless_device.jpg|center|]]
+
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'''===
  
Device can be mounted under the plastic panel behind the front window, with the sticker direction to a window (sky). It is recommended to place device behind dashboard as close to the window as possible. A good example of GNSS antenna placement is displayed in a picture below (area colored green).  
+
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.
  
SIM card should be inserted in the module while the connector is plugged off (while module has no power).
+
=='''<big>Protocols</big>'''==
  
[[File:FMB120 install2.jpg|center|]]
+
[[File:Understand communication language banner.png]]
  
==<span style="color:#FF0000">'''Safety information'''</span>==
+
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'''===
  
===Precautions===
+
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.]]
  
This message contains information on how to operate device safely. By following these requirements and recommendations, you will avoid dangerous situations. You must read these instructions carefully and follow them strictly before operating the device!
+
==='''Protocols implementation'''===
{{{SELV|* The device uses SELV limited power source. The nominal voltage is +12 V DC. The allowed voltage range is {{{voltage|+10..+30}}}V DC.}}}
 
*To avoid mechanical damage, it is advised to transport the device in an impact-proof package. {{{LED_indicators|Before usage, the device should be placed so that its LED indicators are visible. They show the status of device operation.}}}
 
{{{FMB0_3_ignition|*Before unmounting the device from the vehicle, ignition '''MUST be OFF'''.}}}
 
{{{connecting|* When connecting the {{{wires|wires}}}{{{2x6_wires|2x6 connector wires to the vehicle}}}{{{1x5_wires|connection (1x5) cables to the vehicle}}}, the appropriate jumpers of the vehicle power supply should be disconnected.}}}
 
{{{FMB2_connecting_cables|* When installing the connection cables to the vehicle, the appropriate jumpers of the power supply of the vehicle should be disconnected.}}}
 
{{{unmounting|* Before unmounting the device from the vehicle, the {{{2x6_connector|2x6 connector}}} {{{1x5_connection|1x5 connection}}} must be disconnected.}}}
 
{{{zone_of_limited|* The device is designed to be mounted in a zone of limited access, which is inaccessible to the operator. All related devices must meet the requirements of EN 60950-1 standard.}}}<br>
 
{{{boats|* The devices are not designed as a navigational device for boats.}}}
 
  
 +
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.
  
  
{| class="wikitable" style="border-style: solid; border-width: 0px"
+
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]] ).
|+
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_nb.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''Do not disassemble the device. If the device is damaged, the power supply cables are not isolated or the isolation is damaged, DO NOT touch the device before unplugging the power supply.'''
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_nb.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''All wireless data transferring devices produce interference that may affect other devices which are placed nearby.'''
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_key.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''The device must be connected only by qualified personnel.'''
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_tick.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''The device must be firmly fastened in a predefined location.'''
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_tick.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''The programming must be performed using a PC with autonomic power supply.'''
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_humidity.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''The device is susceptible to water and humidity.'''
 
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_ecute.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | '''Installation and/or handling during a lightning storm is prohibited.'''
 
|}
 

Revision as of 14:33, 15 June 2021

Main Page > General Information > Universal Device Test Guide
Qsg rut950 teltonika.PNG



Introduction

Welcome to the telematics banner 1.1.png

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

5 easy steps to prepare any Teltonika Telematics device banner.png

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.
FM nuasmenintas 1.1.png FM nuasmenintas 2.2.png FM nuasmenintas 3.3.png FM nuasmenintas 4.4.png


* 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.

Alert.png
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:

Faceless configurator select.png

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
GNSS Info.png 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.
GSM Info.png 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

OBD tracker mounting places.3.png



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:

TAVL jamming.png

Wialonturbo.jpg

Advanced Testing

Discover more device possibilities in-depth banner.png

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.

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.

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

Extend device's capabilities with our solutions banner.png

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

Understand communication language banner.png

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 ).