This part of the document applies to LC-313, LC-260, LC-261, LC-305. These are teltonika’s new devices that share the same protocol (Named Codec 8). The devices can base ignition on Din1 (OBD2), Accellerometer and power voltage

More information:
https://wiki.teltonika.lt/view/Getting_Started
https://wiki.teltonika.lt/view/FMB_SMS/GPRS_Commands

Configurator

Teltonika have a new configurator with shared functionality over all FMB and FMT Devices. This configurator connects over USB. The configurator is found on google drive:
\Documentation\Devices\Teltonika\FMT100\Teltonika.Configurator_0.17.9_C.008.zip

You will need to have the Teltonika FMB driver installed
\Documentation\Devices\Teltonika\FMT100\MS_USB_ComPort_Driver_exe_v1.1032.3.zip

Connecting to the device is pretty simple. Install the Drivers. then connect the device over usb (It needs to have external power as well) and then open the configurator app. By default it loads the configuration of the device and let you know the status.

FOTA

Fota web can be found at https://fm.teltonika.lt/ 

Here we can update device configuration and firmware over the air. You can upload a configuration made in the Teltonika configurator and upload it to the FOTA webpage.

By default, the devices connect every 720 minutes -> every 12h to connect to Fota Web.
You can speed up the process by sending “SMSlogin SMSpasw web_connect” SMS/GPRS command to the device.

Alternatively, if you want to set up the device to connect to Fota Web periodically more often you can use “SMSlogin SMSpasw setparam 13002:newperiod”
minimum period – 30 min. 

‘  web_connect’ (notice the whitespace in front, quotes should not be send to the device)

‘ setparam 13002:newperiod’ (notice the whitespace in front, quotes should not be send to the device)

By default without login and password the command will be ”  web_connect” notice the 2 spaces in the first position

If you are missing some data values in the message you can add them in the I/O Section. Please note the more elements you add here the bigger the message data will be

Configurations

We have some configurations pre-made. They can be found in google drive at:

\Documentation\Devices\Teltonika\FMT100\Configurations

Old FMA devices

This part of the document applies to LC-312A and LC-324.

Example of the LC-312A

The LC-312A (TeltonikaFMAxx) is currently used on our platform.

The LC-324 (TeltonikaFM11xx) was not fully integrated.

There are some subtle differences between LC-312A and LC-324. Although both devices use the same protocol, the protocol contains (enumId, value)-pairs. The enumIds used by both models does not always match. For example, the enumId for Dallas temperature sensor 1 is different.

How to contact support

Send an email to: ramiz.ka@teltonika.ae 

http://support.teltonika.ae/support/home

j.devos@360locate.com

testtest

How does the device pin-out look?

Pin Nr.	Pin Name	Description
1	VCC (1030)V DC (+)	Power supply for module. Power supply range (10…30) V DC
2	OUT 2	Digital output. Channel 2. Open collector output. Max. 300mA.
3	OUT 1	Digital output. Channel 1. Open collector output. Max. 300mA.
4	DIN 2	Digital input, channel 2
5	DIN 1	Digital input, channel 1 DEDICATED FOR IGNITION INPUT
6	GND(VCC(1030)V DC)(-)	Ground pin. (1030)V DC ( ― )
7	AIN 1	Analog input, channel 1. Input range: 0-30V/0-10V DC
8	DATA_DALLAS	Data channel for Dallas 1-Wire® devices
9	DIN 3	Digital input, channel 3
10	Ucc_DALLAS	+ 3,8 V output for Dallas 1-Wire® devices. (max 20mA)

How to interpret the LEDs?

Navigate LED

Behavior	Meaning
Permanently switched on	GPS signal is not received
Blinking every second	Normal mode, GPS is working
Off	GPS is turned off because:Deep sleep mode, or;GPS module is turned off

Status LED

Behavior	Meaning
Blinking every second	Normal mode
Blinking every 2 seconds	Deep sleep mode
Blinking fast for a short time	Modem activity
Blinking fast constantly	Boot mode
Off	Device is not working, or;Device firmware is being flashed

How to find supplier documentation

There are a number of links and credentials available:

• %USERPROFILE%\Google Drive\GD – 360L\Documentation\Devices\Teltonika\FM12xx\passwords.txt

I found none of the information on these websites very helpful. You are better off with the documents already in drive.

How to provision

The Teltonika uses auto provisioning in combination with USB-based configuration tool provided by the supplier.

1. Obtain a configuration tool
   1. See %USERPROFILE%\Google Drive\GD - 360L\Documentation\Devices\Teltonika\FMA120\FMA1YX.01.27.05.Rev.0\FMA_Configurator_v1.1.27.5\FMA Configurator.exe
2. Obtain a configuration
   1. See C:\Git\development\Devices\Teltonika\FMA120\
3. Configure the device

How to configure remotely

Teltonika offers SMS and SMS over GPRS (DeviceSettingChanges) to configure the device remotely.

SMS requires a login and password, which are set to '' (blank) in default configuration.

A typical remote configuration change looks like: 'setparam <parameterId> <value>' (without the quotes)

To read a parameter remotely you can use getparam <parameterId>.

• If send through SMS the device will reply to your phone.
• If send through GPRS consult the GatewayDatalog for the device.

To obtain the correct parameterId see either enums.cs:TeltonikaParameterId or consult the user manual

• %USERPROFILE%\Google Drive\GD - 360L\Documentation\Devices\Teltonika\FMA120\FMA120-User-Manual-v1.13.pdf

GPRS

GPRS configuration supports the same commands as SMS configuration does, but does not require a login and password:

setparam <teltonikaIoId> <value>

getparam <teltonikaIoId>

The final packet send out to the device is slightly different from, for example, setparam 1002 1234, since the packet needs to be length-prefixed and crc’d.

• This prefixing and crc-ing is done in TeltonikaParser.HandleBinaryReply.
  • When implementing a GPRS setting in TeltonikaParser.HandleReply you can simply return the string setparam 1002 1234
  • When sending manual settings you can also simply set the DeviceSettingChange.Value = "setparam 1002 1234"
• This also means that the packet in the gateway datalog will be slightly different from setparam 1002 1234.

Read here how to implement new setting changes

SMS

The Teltonika accepts SMS from any phone and is login and password protected, but by default these are '' (blank).

If the Teltonika is in deep sleep (not implemented yet), it will not receive SMS until it wakes up.

Useful commands:

‘  setparam <teltonikaIoId> <value>’ (notice the whitespace in front, quotes should not be send to the device)

‘  getparam <teltonikaIoId>’ (notice the whitespace in front, quotes should not be send to the device)

Consult the SMS COMMAND LIST in %USERPROFILE%\Google Drive\GD - 360L\Documentation\Devices\Teltonika\FMA120\FMA120-User-Manual-v1.13.pdf for a list of all the SMS commands.

If the device is not replying to your SMS, make sure to prepend two spaces to the command.

How to find IO ids

See TeltonikaIoId, and TeltonikaParameterId.

The TeltonikaIoIds are scavenged from over the internet.

The TeltonikaParameterIds are imported from the ids listed in the user manual.

Get Firmware Version

This is done by sending a custom command, getver, through device setting overview page (Back Office).

Decoding the message can be done with a hex-to-string converter (http://string-functions.com/hex-string.aspx)

From: 0C01060000009D5665723A30332E31302E30385F3030204750533A41584E5F352E31305F333333332048773A464D42313230204D6F643A323420494D45493A33353230393330383130363533383420496E69743A323031382D31302D31372031313A3620557074696D653A31323033373631204D41433A303031453432393630313237205350433A312830292041584C3A30204F42443A3020424C3A312E362042543A3401

To: Ver:03.10.08_00 GPS:AXN_5.10_3333 Hw:FMB120 Mod:24 IMEI:352093081065384 Init:2018-10-17 11:6 Uptime:1203761 MAC:001E42960127 SPC:1(0) AXL:0 OBD:0 BL:1.6 BT:4

How to Upgrade Firmware

Teltonika offers a dedicated windows application to upgrade your firmware through USB.

Updater: 

• %USERPROFILE%\Google Drive\GD – 360L\Documentation\Devices\Teltonika\FMA120\FMA1YX.01.27.05.Rev.0\Firmware Updater v2.2.0\FM Updater.exe

Firmware file:

• %USERPROFILE%\Google Drive\GD – 360L\Documentation\Devices\Teltonika\FMA120\FMA1YX.01.27.05.Rev.0\Firmware Updater v2.2.0\FMA1YX.01.27.05.Rev.0.e.CFW

How to Debug / Retrieve device log

You can connect using USB to retrieve a device-side log. Below I show how to do this using Putty:

Connect using Serial at speed 115200

Make sure to log all session output to a file (it will be much easier to search through and analyse after)

Make sure to enable “Implicit LF in every CR” or your linebreaks won’t work

The exact Serial settings. You might use a different serial line than COM5.

After performing this elaborate setup, make sure to save this to a putty profile.

See also Debug Mode in %USERPROFILE%\Google Drive\GD - 360L\Documentation\Devices\Teltonika\FMA120\FMA120-User-Manual-v1.13.pdf for a list of all the SMS commands.

How does Ignition Detection work?

Teltonika has a dedicated ignition input (input 1). The device reports a virtual ignition id, containing the status of the ignition column.

This virtual ignition can be based on three different sources:

1. Power Voltage
2. Digital Input 1 (recommended) (set in our provided configuration)
3. Movement sensor

You can query and configure the source using the getparam 1004 and setparam 1004 1 command.

Despite having configured the ignition source to Digital Input 1, there were occasions where the device reported Digital Input 1 = 1 (incorrectly) and Ignition = 0 (correct). This is why we mapped Device.IO1 to LocationEventType.Unknown i.s.o. LocationEventType.IgnitionOn, and Device.Ignition to LocationEventType.IgnitionOn.

FAQ

Update this table whenever you get a question that can not be captured by the Device capability chart / Integration checklist

How to (im)mobilize in combination with controlled starting / buzzer?

Currently we only support one type of controlled starting, which is immobilization (this is also used with buzzer).

First, disable the immobilization:

‘ setparam 1903 0’ (quotes are provided for clarity w.r.t. whitespace, please don’t send them to the device)

Then, set the first output to low (for indefinite amount of time):

‘ setdigout 0?’ (quotes are provided for clarity w.r.t. whitespace, please don’t send them to the device)

Or to high (depending on how the device circuitry is connected):

‘ setdigout 1?’ (quotes are provided for clarity w.r.t. whitespace, please don’t send them to the device)

How to change server AP and port ?

‘ setparam 1245 83.149.67.162’ (quotes are provided for clarity w.r.t. whitespace, please don’t send them to the device) ‘ setparam 1246 49041’

How to change APN ?

‘ setparam 2001:apn;2002:user;2003:pass’ ‘ setparam 2001:apn’

How to set the ro

How to set the roaming intervals?

Currently we do not support home and roamining intervals for Teltonika.

Teltonika supports three different intervals:

• Home
• Unknown
• Roaming

We assume no operator code is entered, which means the device will operate in Unknown interval.

Currently this is the only interval that is configurable through our platform (i.e., when changing the device interval in the BackOffice, it will change the Unknown interval).

Should the device not report at the expected interval, verify that no Home and Roaming operators are set:

Example of a configuration in which no Home and Roaming operators are set, causing the device to report at the Unknown interval

How to implement new device setting changes?

Teltonika does not allow multiple setparams in a single packet. However, some of our SettingId do not match directly to a single setparam-command.

For example, consider the following line in the configurator:

Each column in the row is controlled by a separate setparam. This means that to configure a temperature sensor alert, we need to send the following setparam-commands:

1. setparam 1500 1 // Enable the reporting of Dallas temperature 1
2. setparam 1501 1 // set the priority to high (report as event)
3. setparam 1502 0 // set the high-value threshold (yes, high value precedes low level)
4. setparam 1503 0 // set the low-value threshold
5. setparam 1504 0 // generate event on exit of the range
6. setparam 1505 10 // generate the event if the range is exited more than 10 seconds

To remember which part of the setting we are in, the DeviceSettingChange.CommandId is used.

Fortunately, all these details are already abstracted for you (but they can still be useful to know if you need to send manual changes). Here’s how a temperature sensor change is implemented:

return S( operation, new TeltonikaIoSetting( parameterId: TeltonikaParameterId.Dallas_Temperature_1, enabled: true, averagingLengthSeconds: Math.Min(tempChange.LowerTempDurationInSeconds, tempChange.UpperTempDurationInSeconds), highValueThreshold: (int)(tempChange.UpperLimitCelcius * 10), lowValueThreshold: (int)(tempChange.LowerLimitCelcius * 10), priority: TeltonikaParameterPriority.High, operand: TeltonikaParameterLogicOperand.OnRangeExit ));

Th S function above is translating the TeltonikaIoSetting into the correct setparam-commands.

You also don’t have to worry about incrementing CommandIds, or inserting new DeviceSettingChanges if your change requires any subsequent setparam-commands (all this is done by TeltonikaParser.HandleMultiReply).

The routing from a DeviceSettingChange into multiple setparams happens in TeltonikaParser.HandleSmsOverGprsMultipleReplies.

The routing from a DeviceSettingChange into a single setparam happens in TeltonikaParser.HandleReply.