Jump to content

Test-AC: Difference between revisions

From Teltonika Telematics Wiki
No edit summary
No edit summary
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Power Saving settings==
https://wiki.teltonika-gps.com/view/Template:FTX_Features
{{#switch: {{{model}}}
=SECO Scenario=
| #default =
 
[[File:FTX power saving settings.png|right|500 px]]
===<u>Introduction</u>===
| ATC700
[[File:FTX SECO.png|right|500px]]
| ATM700 =  
 
[[File:ATX power saving settings.png|right|500 px]]
The purpose of Secure Engine Cut Off (SECO) is to bring a vehicle to a stop, in order to prevent unauthorized use. SECO disables the fuel pump, which would prevent the engine from continuing to run and stop the vehicle from being driven. For safety reasons, the system is designed to slow the vehicle down gradually in a controlled manner, ensuring that security measures do not compromise the driver’s or passengers’ safety. It is typically triggered by remote commands (SMS or GPRS) and is used for security or immobilization purposes.
}}
 
Puts the device into a power-saving mode, preserving the power consumption from the external source or the internal battery.
===<u>Prerequisites</u>===
{{#switch: {{{model}}}
*At least one '''DOUT''' is available.
| #default =
*'''SECO functionality''' should have DOUT control priority higher than '''Immobilizer''' scenario.
| ATC700
 
| ATM700 =
===<u>How It Works</u>===
}}
Firstly, in order to safely slow down vehicle the systems toggles the relay, which is connected to fuel pump ('''GNSS Available'''). Secondly, at a safe speed, the system tuns on DOUT permanently in order to stop the vehicle ('''Speed Pulse'''). Last mode is activated in case no GNSS fix is available ('''GNSS Unavailable''').
 
'''Speed Pulse'''
 
DOUT control starts when the vehicle speed goes below a configured speed threshold and remains below this threshold for a specified speed check period. As soon as that happens DOUT is activated.
 
The timer will be reset if the vehicle speed increases above the configured speed threshold.
 
'''GNSS Available'''
 
This mode requires a GNSS fix to be present before DOUT control begins.  
 
DOUT pulsing starts when the vehicle speed drops below a configured speed pulse threshold and the speed remains below this threshold for a specified speed check period.
 
'''GNSS Unavailable'''
 
This mode is used when a GNSS fix is not available.


===Online Sleep===
In this mode, the system initiates DOUT control only if the vehicle is stationary, location data is unavailable, and the movement timeout condition is met.
*In Online Sleep mode, the device manages the connection only when records need to be sent. The connection is opened at periodic intervals to send records and closed immediately after, without any timeout.
*Changing the Permanent Link setting during Online Sleep will wake up the device to apply the new configuration.
*With Permanent Link enabled, the device maintains a constant connection, sending records immediately as they are generated, rather than waiting for the next scheduled send. After sending connection remains open.
*All listed entry conditions must be met in order to enter Online Sleep.
*At least one exit condition must be met in order to wake up from Online Sleep.
<br>


<table class="nd-othertables_2" style="width:100%; border-collapse: collapse; border-bottom: 3px solid #336699;">
'''Note:''' If there is no GNSS fix available and “secoon” command is sent, the system waits for the movement timeout to be reached before activating the configured DOUT. This approach ensures that the vehicle is stationary prior to disabling the fuel supply.


=== <u> Parameters list </u>===
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
<tr>
<th style="width:1%; vertical-align: middle; text-align: center;">PARAMETER NAME</th>
<th style="width:1%; vertical-align: middle; text-align: center;">PARAMETER ID (RELATED AVL ID)</th>
<th style="width:5%; vertical-align: middle; text-align: center;">DESCRIPTION</th>
<th style="width:6%; vertical-align: middle; text-align: center;">VALUES</th>
</tr>
<tr>
<tr>
<th style="width:1%; vertical-align: middle; text-align: center;">Module</th>
<th style="width:1%; vertical-align: middle; text-align: center;">Entry Conditions</th>
<th style="width:5%; vertical-align: middle; text-align: center;">Exit conditions</th>
<th style="width:6%; vertical-align: middle; text-align: center;">Disabled functions</th>


</tr>
<td style="vertical-align: middle; text-align: center;"> SECO DOUT status </td>
<td style="vertical-align: middle; text-align: center;"> 396</td>
<td style="vertical-align: middle; text-align: center;"> SECO DOUT status. </td>
<td style="vertical-align: middle; text-align: left;">'''0''' = SECO DOUT is '''OFF''' <br> '''1''' = SECO DOUT is '''pulsing''' <br> '''2''' = SECO DOUT is '''ON''' </td>
 
</tr>  
<tr>
<tr>


<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">'''''Main'''''</td>
<td style="vertical-align: middle; text-align: center;"> Priority </td>
<td style="vertical-align: middle; text-align: left; min-width: 550px; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: center;"> 1039600 </td>
*Configured '''Ignition source''' is off.<br>
<td style="vertical-align: middle; text-align: center;"> Priority of how events are being sent to a server. For example, events with low priority are added to the periodical record, and events with high priority are sent immediately after they occur. </td>
*Movement is not detected by the configured '''Movement source'''.<br>
<td style="vertical-align: middle; text-align: left;"> '''0''' = SECO  scenario is '''disabled''' <br> '''1''' = SECO scenario is '''low''' <br> '''2''' = SECO scenario is '''high''' <br>
*Device time must be synchronized, as this condition depends on the ''Record Settings -> Saving / sending mode'' parameter<br>
**'''After Position Fix''' - device time is synchronized with GNSS satellites and GPS fix is obtained.<br>
**'''After Time Sync''' - device time is synchronized over NTP, NITZ, or GNSS satellites.<br>
**'''Always''' - device will enter sleep mode without time synchronization and GPS fix.<br>
*Sleep timeout is reached.<br>
*No SMS messages are being received.<br>
*No open Data sockets (ignored with enabled permanent link)<br>
*No active FOTA WEB connection progress.<br>
</td>
<td style="vertical-align: middle; horizontal-align: center; min-width: 150px; border-bottom: 3px solid #336699;">
*Ignition is ON.<br>
*Movement is detected.<br>
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN1}} | *DIN1 is activated }} {{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN2}} | *DIN2 is activated }} {{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN3}} | *DIN3 is activated }}
*Periodic wake-up (if enabled).<br></td>
<td style="vertical-align: middle; horizontal-align: center; min-width: 100px; border-bottom: 3px solid #336699;">  
*GNSS<br>
*Odometer<br>
*Data acquisition<br>
*SNTP time synchronization<br>
*Overspeeding<br>
*Trip<br>
*Unplug Detection<br>
*Jamming Detection<br>
*Eco Driving<br>
</td>
</td>


</tr>
</tr>  
<tr>
<tr>


{{#if: {{FTX Pin Support List|model={{{model}}}|pin=Manual CAN}} |
<td style="vertical-align: middle; text-align: center;"> Speed </td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">'''''CAN'''''</td>
<td style="vertical-align: middle; text-align: center;"> 12254 </td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: center;"> Speed threshold at which the configured digital output (DOUT) will be activated. </td>
*No communication with Main module for 1 second.
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''0'''<br> Maximum value = '''255''' <br> Default value = '''10''' </td>
*No configured CAN data is read for 5 seconds.
*At least 1 second has passed since the last module wake up.</td>
<td style="vertical-align: middle; text-align: left; min-width: 150px; border-bottom: 3px solid #336699;"">
*Main module sends any request via UART.<br>
*Any CAN data is present on the CAN bus.<br></td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">  
*CAN
</td>
}}


</tr>
</tr>  
<tr>
<tr>
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=Manual BT}} |
<td style="vertical-align: middle; text-align: left;">'''''BLE'''''</td>
<td style="vertical-align: middle; text-align: left;">
*Main module enters Online/Deep sleep modes.
*No communication with Main module for 1 second.
*At least 1 second has passed since the last module wake up.</td>
<td style="vertical-align: middle; text-align: left; min-width: 150px;"">
*The device can wake up from sleep when a DIN input changes (detected through the external MCU).
*DIN pins remain active in sleep mode and can be used as wake-up sources for the device.</td>
<td style="vertical-align: middle; text-align: left;"> </td>
}}


</tr>
<td style="vertical-align: middle; text-align: center;"> Speed pulse scenario </td>
</table>
<td style="vertical-align: middle; text-align: center;"> 12259 </td>
<td style="vertical-align: middle; text-align: center;">
Speed threshold at which the configured digital output (DOUT) will be toggled. </td>
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''0'''<br> Maximum value = '''255''' <br>Default value = '''10''' </td>


===Deep Sleep===
</tr>
<tr>


*During Deep Sleep mode, the device generates and stores periodic records.
<td style="vertical-align: middle; text-align: center;">
*All listed entry conditions must be met in order to enter Deep Sleep.
Speed check period </td>
*At least one exit condition must be met in order to wake up from Deep Sleep.
<td style="vertical-align: middle; text-align: center;"> 12255 </td>
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: center;"> Time span during which speed must be lower than configured for output to activate (GNSS on). </td>
<td style="vertical-align: middle; text-align: left;">  Minimum value = '''0'''<br> Maximum value = '''65535''' <br>Default value = '''10''' </td>


</tr>
<tr>
<tr>
<th style="width:1%; vertical-align: middle; text-align: center;">Module</th>
 
<th style="width:1%; vertical-align: middle; text-align: center;">Entry Conditions</th>
<td style="vertical-align: middle; text-align: center;">
<th style="width:5%; vertical-align: middle; text-align: center;">Exit conditions</th>
Movement timeout</td>
<th style="width:6%; vertical-align: middle; text-align: center;">Disabled functions</th>
<td style="vertical-align: middle; text-align: center;"> 12256 </td>
<td style="vertical-align: middle; text-align: center;"> Duration after which the DOUT will be activated if no movement is detected and GNSS is off. </td>
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''0'''<br> Maximum value = '''65535''' <br>Default value = '''30''' </td>


</tr>
</tr>
<tr>
<tr>


<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">'''''Main'''''</td>
<td style="vertical-align: middle; text-align: center;">Eventual records</td>
<td style="vertical-align: middle; text-align: left; min-width: 550px; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: center;"> 1039604</td>
*Configured '''Ignition source''' is off.
<td style="vertical-align: middle; text-align: center;">Enables feature status sending only when the event happens (an eventual record). When disabled, feature status will be sent with both eventual and periodical records.</td>
*Movement is not detected by the configured '''Movement source'''.
<td style="vertical-align: middle; text-align: left;"> '''0''' = SECO status will be sent with both eventual and periodical records. <br> '''1''' = SECO status will be sent only when the event happens (an eventual record).</td>
*Device time must be synchronized, as this condition depends on the ''Record Settings -> Saving / sending mode'' parameter.
 
**'''After Position Fix''' - device time is synchronized with GNSS satellites and GPS fix is obtained.
**'''After Time Sync''' - device time is synchronized over NTP, NITZ, or GNSS satellites.
**'''Always''' - device will enter sleep mode without time synchronization and GPS fix.
*Sleep timeout is reached.
*No SMS messages are being received.
*No open Data sockets (ignored with enabled permanent link)<br>
*No active FOTA WEB connection progress.
</td>
<td style="vertical-align: middle; horizontal-align: center; min-width: 150px; border-bottom: 3px solid #336699;">
*Ignition is ON.
*Movement is detected.
*Periodic wake-up (if enabled).
</td>
<td style="vertical-align: middle; horizontal-align: center; min-width: 100px; border-bottom: 3px solid #336699;">  
*Modem
*Record sending
*GNSS
*IMU (Inertial Measurement Unit)
*FOTA WEB
*LEDs (Navigation and Status)
*Odometer
*Data acquisition
*SNTP time synchronization
*Overspeeding
*Trip
*Unplug Detection
*Jamming Detection
*Eco Driving
</td>
</tr>
</tr>
<tr>
<tr>


{{#if: {{FTX Pin Support List|model={{{model}}}|pin=Manual CAN}} |
<td style="vertical-align: middle; text-align: center;">Output control</td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">'''''CAN'''''</td>
<td style="vertical-align: middle; text-align: center;">12252</td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: center;">
*No communication with Main module for 1 second.
Digital output used for connection to fuel pump to gradually stop the vehicle. </td>
*No configured CAN data is read for 5 seconds.
<td style="vertical-align: middle; text-align: left;"> '''0''' = DOUT control is disabled <br> '''1''' = DOUT1 is controlled <br> '''2''' = DOUT2 is controlled <br> '''3''' = DOUT3 is controlled <br> '''4''' = DOUT4 is controlled</td>
*At least 1 second has passed since the last module wake up.
</td>
<td style="vertical-align: middle; text-align: left; min-width: 150px; border-bottom: 3px solid #336699;"">
*Main module sends any request via UART.
*Any CAN data is present on the CAN bus.
</td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">  
*CAN
</td>
}}


</tr>
</tr>
<tr>
<tr>


{{#if: {{FTX Pin Support List|model={{{model}}}|pin=Manual BT}} |
<td style="vertical-align: middle; text-align: center;">Output pulse</td>
<td style="vertical-align: middle; text-align: left;">'''''BLE'''''</td>
<td style="vertical-align: middle; text-align: center;">12253</td>
<td style="vertical-align: middle; text-align: left;">
<td style="vertical-align: middle; text-align: center;">Pulse functionality adds additional output control which helps to slow down vehicle before fully disabling fuel pump.</td>
*Main module enters Online/Deep sleep modes.
<td style="vertical-align: middle; text-align: left;"> '''0''' = Disabled <br> '''1''' = Enabled </td>
*No communication with Main module for 1 second.
*At least 1 second has passed since the last module wake up.
</td>
<td style="vertical-align: middle; text-align: left; min-width: 150px;"">
*The device can wake up from sleep when a DIN input changes (detected through the external module).
*DIN pins remain active in sleep mode and can be used as wake-up sources for the device.
</td>
<td style="vertical-align: middle; text-align: left;">  
*BLE scanning
</td>
}}


</tr>
</tr>
</table>
<tr>


===Power Off Sleep===
<td style="vertical-align: middle; text-align: center;">
*All listed entry conditions must be met in order to enter Power Off Sleep.
DOUT on duration</td>
*At least one exit condition must be met in order to wake up from Power Off Sleep.
<td style="vertical-align: middle; text-align: center;">12257</td>
When device goes into sleep mode, some modules are turned off to consume less power. Listed below are the modules and scenarios that are turned off in common with all modes and those that are disabled specifically for the '''Power off sleep''' mode:
<td style="vertical-align: middle; text-align: center;"> Duration for how long DOUT should be active.</td>
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''10'''<br> Maximum value = '''5000''' <br>Default value = '''1000''' </td>


</tr>
<tr>
<tr>
<th style="width:1%; vertical-align: middle; text-align: center;">Module</th>
<th style="width:1%; vertical-align: middle; text-align: center;">Entry Conditions</th>
<th style="width:5%; vertical-align: middle; text-align: center;">Exit conditions</th>
<th style="width:6%; vertical-align: middle; text-align: center;">Disabled functions</th>


<td style="vertical-align: middle; text-align: center;">DOUT off duration</td>
<td style="vertical-align: middle; text-align: center;">12258</td>
<td style="vertical-align: middle; text-align: center;"> A value in milliseconds, for how long DOUT should be inactive. </td>
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''10'''<br> Maximum value = '''5000''' <br>Default value = '''1000''' </td>
</tr>
</table>
<!---For Template:FTX SMS/GPRS Commands--->
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=DOUT1}}{{FTX Pin Support List|model={{{model}}}|pin=DOUT2}}{{FTX Pin Support List|model={{{model}}}|pin=DOUT3}}
|
===SECO Commands===
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
<tr>
<th style="width:20%; vertical-align: middle; text-align: left;">COMMAND</th>
<th style="width:45%; vertical-align: middle; text-align: left;">DESCRIPTION</th>
<th style="width:35%; vertical-align: middle; text-align: left;">SYNTAX EXAMPLE</th>
</tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - secooff|secooff]]</td>
<td style="vertical-align: middle; text-align: left;">Deactivate SECO scenario.</td>
<td style="vertical-align: middle; text-align: left;"><code>secooff</code></td>
</tr>
</tr>
<tr>
<tr>
<td style="vertical-align: middle; text-align: left;">[[SMS/GPRS command - secoon|secoon]]</td>
<td style="vertical-align: middle; text-align: left;">Activate SECO scenario.</td>
<td style="vertical-align: middle; text-align: left;"><code>secoon</code></td>
</tr>
</table>
}}
----
https://wiki.teltonika-gps.com/index.php?title=Template:FTX_Mobile_network
==Server settings== 
[[File:FTX server settings.png|right|500x800px]]
===Primary server settings===
'''Domain'''
*Server or Domain address, either IP address or Domain can be written.
'''Port'''
*Server Port.
'''Data protocol'''
*TCP (Transmission control protocol) or UDP (User datagram protocol). Changing this parameter will alter how the device communicates. From the device side, TCP and UDP work almost the same, the only difference is that UDP doesn't need additional confirmation from the server side, that the data packet was received. TCP has that and uses more network data for the confirmation. The desired data transfer protocol can be selected through the configurator. For more information on the protocol differences of Teltonika devices, refer here [https://wiki.teltonika-gps.com/view/Teltonika_Data_Sending_Protocols]
----
'''New description added''' <br>
<span style="color:#00FF00;">'''Encryption'''
*TLS/DTLS are security protocols that protect information sent over a network by encrypting the data so only the intended recipient can read it. These Protocols help authenticate devices communicating with the server and ensure data integrity during transmission. TLS/DTLS encryption creates a secure, private connection so sensitive data can travel safely across networks.</span>
*In order to utilize TLS/DTLS encryption, server certificates must be uploaded via '''Teltonika Configurator Tool (TCT)''' or '''FOTA Web''' using '''Upload user TLS certificate''' task. For more information please reference [[{{{model}}} Device status]].


<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">'''''Main'''''</td>
*'''Note:''' Currently Encryption is supported only if TCP/UDP data protocol is used. MQTT + TLS is not supported in '''Firmware version 3.7.0''' at this time.
<td style="vertical-align: middle; text-align: left; min-width: 550px; border-bottom: 3px solid #336699;">
 
*Configured '''Ignition source''' is off.
----
*Movement is not detected by the configured '''Movement source'''.
===Secondary server settings===
*Device time must be synchronized, as this condition depends on the ''Record Settings -> Saving / sending mode'' parameter
'''Mode'''  
**'''After Position Fix''' - device time is synchronized with GNSS satellites and GPS fix is obtained.
*Backup - Records are sent to second server while main server is not available.  
**'''After Time Sync''' - device time is synchronized over NTP, NITZ, or GNSS satellites.
*Duplicate - records are sent to both servers (main and second), records are deleted from Flash storage only if both servers confirmed that the records were received from device.
**'''Always''' - device will enter sleep mode without time synchronization and GPS fix.
 
*Sleep timeout is reached.
{| class="wikitable"
*No SMS messages are being received.
|+ Secondary server parameters
*No open Data sockets (ignored with enabled permanent link)<br>
|-
*No active FOTA WEB connection progress.
! Parameter !! Parameter ID !! Values
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN1}} | *DIN1 is deactivated }} {{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN2}} | *DIN2 is deactivated }} {{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN3}} | *DIN3 is deactivated }}
|-
</td>
| Second server type || 2010 || 0 - Disable, 1 - Backup, 2 - Duplicate
<td style="vertical-align: middle; horizontal-align: center; min-width: 150px; border-bottom: 3px solid #336699;">
|-
*Ignition is ON.
| Secondary server IP or DNS address || 2007 || String
*Movement is detected.
|-
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN1}} | *DIN1 is activated }} {{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN2}} | *DIN2 is activated }} {{#if: {{FTX Pin Support List|model={{{model}}}|pin=DIN3}} | *DIN3 is activated }}
| Secondary server port || 2008 || Integer
</td>
|-
<td style="vertical-align: middle; horizontal-align: center; min-width: 100px; border-bottom: 3px solid #336699;">  
| Secondary server protocol || 2009 || 0 - TCP, 1 - UDP
*Modem
|}
*Record sending
 
*GNSS
https://wiki.teltonika-gps.com/view/Template:FTX_Features
*IMU (Inertial Measurement Unit)
=GNSS Fuel Counter=
*FOTA WEB
[[File:FTX GNSS fuel counter.png|right|500px]]
*Charger service
 
*LEDs (Navigation and Status)
===<u>Introduction</u>===
*Odometer
The Fuel Counter GNSS scenario provides fuel consumption estimation using GNSS-derived distance and user-configured fuel rate. It calculates the amount of fuel used by multiplying traveled distance by the average fuel rate and converting it to appropriate units. It is a software-based alternative when fuel flow sensors are not available.
*Data acquisition
===<u>How It Works</u>===
*SNTP time synchronization
The scenario monitors GNSS data and updates fuel usage whenever valid  GNSS PVT(Position, Velocity, Time) messages are received and movement is detected. It also supports runtime reconfiguration to keep fuel usage parameters in sync with user changes.
*Overspeeding
 
*Trip
*On device startup, the scenario:
*Unplug Detection
**Checks for a retained value of previously used fuel.
*Jamming Detection
**If found, it restores this value and updates the corresponding I/O element.
*Eco Driving
**If no retained value is found, the system uses the current configuration parameter (user-defined or default), stores it in retained RAM for future startups, and updates the I/O element.
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=Manual CAN}} |
 
*CAN (''does not receive requests, does not read CAN bus messages'')
When GNSS messages are received, the scenario determines whether they represent a GNSS source event or position data, and, if valid movement is detected, updates both distance traveled and fuel consumption.
}}
{{#if: {{FTX Pin Support List|model={{{model}}}|pin=BT}} | *BLE
**PIN's are unavailable while BLE module is off.
**Anything connected or enabled by BLE module(1 wire, DIN's, DOUT's, BLE as a peripheral)
}}
</td>


If the scenario is enabled and the user modifies the average fuel usage parameter, it automatically detects any deviation between the configuration and the current I/O value and synchronizes them.
=== <u> Parameters list </u>===
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
<tr>
<th style="width:1%; vertical-align: middle; text-align: center;">PARAMETER NAME</th>
<th style="width:1%; vertical-align: middle; text-align: center;">PARAMETER ID (RELATED AVL ID)</th>
<th style="width:5%; vertical-align: middle; text-align: center;">DESCRIPTION</th>
<th style="width:6%; vertical-align: middle; text-align: center;">VALUES</th>
</tr>
</tr>
<tr>
<tr>


{{#if: {{FTX Pin Support List|model={{{model}}}|pin=Manual CAN}} |
<td style="vertical-align: middle; text-align: center;"> Scenario priority </td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">'''''CAN'''''</td>
<td style="vertical-align: middle; text-align: center;"> 1001200<br>(12)</td>
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">
<td style="vertical-align: middle; text-align: center;">Priority of how events are being sent to a server. For example, events with low priority are added to the periodical record, and events with high priority are sent immediately after they occur.</td>
*Main module enters power off sleep mode.
<td style="vertical-align: middle; text-align: left;"> '''0'''=Disable <br>  '''1'''=Low priority <br>  '''2'''=High priority </td>
</td>
 
<td style="vertical-align: middle; text-align: left; min-width: 150px; border-bottom: 3px solid #336699;"">
</tr> 
*Main module wakes up and restarts CAN module.
<tr>
</td>
 
<td style="vertical-align: middle; text-align: left; border-bottom: 3px solid #336699;">  
<td style="vertical-align: middle; text-align: center;"> Average consumption </td>
*CAN (''does not receive requests, does not read CAN bus messages'')
<td style="vertical-align: middle; text-align: center;"> 11902 </td>
</td>
<td style="vertical-align: middle; text-align: center;">Average consumption presented in the technical documentation of the vehicle.</td>
}}
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''0.0'''<br> Maximum value = '''50.0''' <br> Default value = '''0.0''' </td>


</tr>
</tr>
<tr>
<tr>


{{#if: {{FTX Pin Support List|model={{{model}}}|pin=BT}} |
<td style="vertical-align: middle; text-align: center;">
<td style="vertical-align: middle; text-align: left;">'''''BLE'''''</td>
Fuel counter value</td>
<td style="vertical-align: middle; text-align: left;">
<td style="vertical-align: middle; text-align: center;"> 11910 </td>
*Main module enters power off sleep mode.
<td style="vertical-align: middle; text-align: center;">The initial fuel counter value in litres. Can be used to set the starting value or reset the current one.</td>
</td>
<td style="vertical-align: middle; text-align: left;"> Minimum value = '''0.0'''<br> Maximum value = '''4294967.2''' <br> Default value = '''0.0''' </td>
<td style="vertical-align: middle; text-align: left; min-width: 150px;"">
*Main module wakes up and restarts BLE module.
</td>
<td style="vertical-align: middle; text-align: left;">  
*PIN's are unavailable while BLE module is off.
*Anything connected or enabled by BLE module(1 wire, DIN's, DOUT's, BLE as a peripheral)
</td>
}}


</tr>
</tr>
</table>
</table>

Latest revision as of 08:48, 6 March 2026

https://wiki.teltonika-gps.com/view/Template:FTX_Features

SECO Scenario

Introduction

The purpose of Secure Engine Cut Off (SECO) is to bring a vehicle to a stop, in order to prevent unauthorized use. SECO disables the fuel pump, which would prevent the engine from continuing to run and stop the vehicle from being driven. For safety reasons, the system is designed to slow the vehicle down gradually in a controlled manner, ensuring that security measures do not compromise the driver’s or passengers’ safety. It is typically triggered by remote commands (SMS or GPRS) and is used for security or immobilization purposes.

Prerequisites

  • At least one DOUT is available.
  • SECO functionality should have DOUT control priority higher than Immobilizer scenario.

How It Works

Firstly, in order to safely slow down vehicle the systems toggles the relay, which is connected to fuel pump (GNSS Available). Secondly, at a safe speed, the system tuns on DOUT permanently in order to stop the vehicle (Speed Pulse). Last mode is activated in case no GNSS fix is available (GNSS Unavailable).

Speed Pulse

DOUT control starts when the vehicle speed goes below a configured speed threshold and remains below this threshold for a specified speed check period. As soon as that happens DOUT is activated.

The timer will be reset if the vehicle speed increases above the configured speed threshold.

GNSS Available

This mode requires a GNSS fix to be present before DOUT control begins.

DOUT pulsing starts when the vehicle speed drops below a configured speed pulse threshold and the speed remains below this threshold for a specified speed check period.

GNSS Unavailable

This mode is used when a GNSS fix is not available.

In this mode, the system initiates DOUT control only if the vehicle is stationary, location data is unavailable, and the movement timeout condition is met.

Note: If there is no GNSS fix available and “secoon” command is sent, the system waits for the movement timeout to be reached before activating the configured DOUT. This approach ensures that the vehicle is stationary prior to disabling the fuel supply.

Parameters list

PARAMETER NAME PARAMETER ID (RELATED AVL ID) DESCRIPTION VALUES
SECO DOUT status 396 SECO DOUT status. 0 = SECO DOUT is OFF
1 = SECO DOUT is pulsing
2 = SECO DOUT is ON
Priority 1039600 Priority of how events are being sent to a server. For example, events with low priority are added to the periodical record, and events with high priority are sent immediately after they occur. 0 = SECO scenario is disabled
1 = SECO scenario is low
2 = SECO scenario is high
Speed 12254 Speed threshold at which the configured digital output (DOUT) will be activated. Minimum value = 0
Maximum value = 255
Default value = 10
Speed pulse scenario 12259 Speed threshold at which the configured digital output (DOUT) will be toggled. Minimum value = 0
Maximum value = 255
Default value = 10
Speed check period 12255 Time span during which speed must be lower than configured for output to activate (GNSS on). Minimum value = 0
Maximum value = 65535
Default value = 10
Movement timeout 12256 Duration after which the DOUT will be activated if no movement is detected and GNSS is off. Minimum value = 0
Maximum value = 65535
Default value = 30
Eventual records 1039604 Enables feature status sending only when the event happens (an eventual record). When disabled, feature status will be sent with both eventual and periodical records. 0 = SECO status will be sent with both eventual and periodical records.
1 = SECO status will be sent only when the event happens (an eventual record).
Output control 12252 Digital output used for connection to fuel pump to gradually stop the vehicle. 0 = DOUT control is disabled
1 = DOUT1 is controlled
2 = DOUT2 is controlled
3 = DOUT3 is controlled
4 = DOUT4 is controlled
Output pulse 12253 Pulse functionality adds additional output control which helps to slow down vehicle before fully disabling fuel pump. 0 = Disabled
1 = Enabled
DOUT on duration 12257 Duration for how long DOUT should be active. Minimum value = 10
Maximum value = 5000
Default value = 1000
DOUT off duration 12258 A value in milliseconds, for how long DOUT should be inactive. Minimum value = 10
Maximum value = 5000
Default value = 1000



https://wiki.teltonika-gps.com/index.php?title=Template:FTX_Mobile_network

Server settings

Primary server settings

Domain

  • Server or Domain address, either IP address or Domain can be written.

Port

  • Server Port.

Data protocol

  • TCP (Transmission control protocol) or UDP (User datagram protocol). Changing this parameter will alter how the device communicates. From the device side, TCP and UDP work almost the same, the only difference is that UDP doesn't need additional confirmation from the server side, that the data packet was received. TCP has that and uses more network data for the confirmation. The desired data transfer protocol can be selected through the configurator. For more information on the protocol differences of Teltonika devices, refer here [1]

New description added
Encryption

  • TLS/DTLS are security protocols that protect information sent over a network by encrypting the data so only the intended recipient can read it. These Protocols help authenticate devices communicating with the server and ensure data integrity during transmission. TLS/DTLS encryption creates a secure, private connection so sensitive data can travel safely across networks.
  • In order to utilize TLS/DTLS encryption, server certificates must be uploaded via Teltonika Configurator Tool (TCT) or FOTA Web using Upload user TLS certificate task. For more information please reference [[{{{model}}} Device status]].
  • Note: Currently Encryption is supported only if TCP/UDP data protocol is used. MQTT + TLS is not supported in Firmware version 3.7.0 at this time.

Secondary server settings

Mode

  • Backup - Records are sent to second server while main server is not available.
  • Duplicate - records are sent to both servers (main and second), records are deleted from Flash storage only if both servers confirmed that the records were received from device.
Secondary server parameters
Parameter Parameter ID Values
Second server type 2010 0 - Disable, 1 - Backup, 2 - Duplicate
Secondary server IP or DNS address 2007 String
Secondary server port 2008 Integer
Secondary server protocol 2009 0 - TCP, 1 - UDP

https://wiki.teltonika-gps.com/view/Template:FTX_Features

GNSS Fuel Counter

Introduction

The Fuel Counter GNSS scenario provides fuel consumption estimation using GNSS-derived distance and user-configured fuel rate. It calculates the amount of fuel used by multiplying traveled distance by the average fuel rate and converting it to appropriate units. It is a software-based alternative when fuel flow sensors are not available.

How It Works

The scenario monitors GNSS data and updates fuel usage whenever valid GNSS PVT(Position, Velocity, Time) messages are received and movement is detected. It also supports runtime reconfiguration to keep fuel usage parameters in sync with user changes.

  • On device startup, the scenario:
    • Checks for a retained value of previously used fuel.
    • If found, it restores this value and updates the corresponding I/O element.
    • If no retained value is found, the system uses the current configuration parameter (user-defined or default), stores it in retained RAM for future startups, and updates the I/O element.

When GNSS messages are received, the scenario determines whether they represent a GNSS source event or position data, and, if valid movement is detected, updates both distance traveled and fuel consumption.

If the scenario is enabled and the user modifies the average fuel usage parameter, it automatically detects any deviation between the configuration and the current I/O value and synchronizes them.

Parameters list

PARAMETER NAME PARAMETER ID (RELATED AVL ID) DESCRIPTION VALUES
Scenario priority 1001200
(12)
Priority of how events are being sent to a server. For example, events with low priority are added to the periodical record, and events with high priority are sent immediately after they occur. 0=Disable
1=Low priority
2=High priority
Average consumption 11902 Average consumption presented in the technical documentation of the vehicle. Minimum value = 0.0
Maximum value = 50.0
Default value = 0.0
Fuel counter value 11910 The initial fuel counter value in litres. Can be used to set the starting value or reset the current one. Minimum value = 0.0
Maximum value = 4294967.2
Default value = 0.0