Jump to content

Template:ATX System: Difference between revisions

From Teltonika Telematics Wiki
ATX70Y upload works
Line 206: Line 206:
== Button settings ==
== Button settings ==
[[File:Button settings.png|right|500px]]
[[File:Button settings.png|right|500px]]
Multi action button functionality utilizes tracker button for various actions (e.g. ''Alarm''). Button employs click pattern logic. It extends number of actions, which can triggered by press the button in specific manner.  
Multi action button functionality utilizes tracker button for various actions (e.g. ''Alarm''). Button employs click pattern logic.


===Click patterns ===
===Click patterns ===

Revision as of 08:39, 4 December 2025

Configuration password

Protects the device from unauthorized access while using USB or Bluetooth to make any form of configuration changes.

  • Set password - Set the primary password for the device. Required to access the device every time using the USB or via Bluetooth connection.
  • Recovery password (optional) - in the event that the primary password is forgotten, the recovery password can be used as a backup to unlock the device configuration.













GNSS settings

In GNSS Source settings user can configure which GNSS system(s) to use.

List of configurable GNSS sources:

  • GPS
  • GPS + GLONASS
  • GPS + Galileo
  • GPS + BeiDou
  • GPS + GLONASS + Galileo + BeiDou



Power Saving settings

Puts the device into a power-saving mode, preserving the power consumption from the external source or the internal battery. The device enters this mode after the conditions are met.

Online sleep

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

Disabled modules in Online sleep

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 Online sleep mode:

  • GNSS
  • Scenarios (Common):
    • SNTP time synchronization

Online sleep entry conditions

All entry conditions must be met:

  • Movement is not detected by the configured movement source.
  • Device time must be synchronized. 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.
  • There are no SMS messages being received.
  • Data sockets are closed (ignored when permanent link is enabled)
  • FOTA WEB connection is not in progress.

Online sleep exit conditions

At least one exit condition must be met:

  • Movement is detected.
  • Periodic wake-up (if enabled).

Power off sleep

Disabled modules in Power off sleep

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:

  • Modem
  • GNSS
  • IMU (Inertial Measurement Unit)*
  • FOTA WEB
  • Charger service*

*If power bank mode is selected and charger is enabled, device will not enter in Real Time clock sleep and stay in Power off sleep mode, which results in a similar mode to Deep Sleep.

  • Scenarios (Common):
    • LEDs (Navigation and Status)
    • SNTP time synchronization


Power off entry conditions

All entry conditions must be met:

  • Movement is not detected by the configured movement source.
  • Device time must be synchronized. 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.
  • There are no SMS messages being received.
  • Data sockets are closed (ignored when permanent link is enabled)
  • FOTA WEB connection is not in progress.
  • TCT is not connected.
  • USB is not connected. This condition does not apply if Power bank mode is enabled.

Note: Starting with 3.7.0 Firmware, USB presence check will be replaced with TCT connection check.

Power off sleep exit conditions

At least one exit condition must be met:

  • Movement is detected.
  • USB is disconnected.
  • Button is pressed.

Time synchronization settings

Accurate system time is essential for proper event logging, record timestamping, and scheduling. The device supports 2 primary time synchronization sources: GNSS and SNTP. When one source becomes unavailable, the device can fall back to the other to maintain accurate time.

  • NTP Resync - how often a device should resynchronize its time. If the set value is not equal to zero, time resynchronization will occur periodically at time intervals to which this parameter is set.
  • NTP server 1 and NTP Server 2 let the user select which NTP server (s) will be used to re-synchronize time.

Prerequisites

Network Connectivity

  • To use SNTP, the device must connect to the internet

Configuration Access

  • TCT NTP settings (e.g., synchronization interval, NTP server domains) must be accessible for setup or modification.

Parameter Description

GNSS Time Synchronization

  • Trigger Condition: If a valid GNSS fix is available and the difference between the GNSS-provided time and the internal RTC is ≥ 3 seconds for a continuous period of 5 seconds, a time correction occurs.
  • Subsequent Synchronizations: After the first successful sync, the wait time before the device checks for another 3-second difference increases to 5 minutes to prevent excessive corrections.

SNTP Time Synchronization

  • Trigger Condition: If the device lacks a GNSS fix for 60 seconds, it attempts to synchronize time via SNTP'.
  • Resynchronization Interval: Defined by TCT NTP settings (default is 3 hours).
  • NTP Servers: 2 servers can be configured; by default, pool.ntp.org is the primary server and time.google.com is the fallback. If the first server is unreachable, the device automatically attempts the second.

Expected Behavior

GNSS Time Sync Process

  • When GNSS is active, the device continuously compares GNSS time to the internal clock.
  • If the 3-second offset persists for 5 seconds, the clock is updated immediately.
  • After the first correction, the device waits 5 minutes before checking for another large time discrepancy.

SNTP Time Sync Process

  • If no GNSS fix is available for 60 seconds (e.g., poor satellite signal, modem off, etc.), the device initiates an SNTP request.
  • If the primary NTP server is unreachable, it tries the secondary server.
  • The device repeats this SNTP synchronization after the configured interval (default 3 hours).

Fallback Mechanism

  • GNSS is the first choice for time synchronization.
  • When GNSS is not available, SNTP ensures the device clock remains accurate until a valid GNSS fix is restored.

Battery settings

Battery settings allow selecting battery charge modes.

Possible charge modes:

On need - battery will charge on need (will not charge in sleep mode)
After ignition ON - Battery will start charging when the ignition source is turned ON (will not charge in sleep mode)
Always - battery will charge all the time, even in Online and Deep sleep modes.







Power Bank Support

Asset Tracker devices have a power bank support functionality. It improves battery life by allowing for a larger discharge range for the battery and focusing on powering device from the connected power bank.

Basic operation

Power bank support functionality checks for power bank connection via USB. When connection is established, it analyzes current battery voltage. If current battery voltage value is in the range of minimum and maximum battery topoff threshold, device will prioritize external power source. If current battery voltage is not in the range (is too low), device will use switch charging mode or it is too high, it will stop charging.

Note: If the power bank is connected, but the battery is not charging, Asset tracker will check for USB connection status change every 10 seconds until battery charging starts. This logic will change with the new ATX hardware in future releases.

Power Bank mode and Power Off Sleep

When the battery reaches the upper topoff threshold, charging stops and the power bank enters sleep mode, causing the external voltage to drop below 4V. The device then shuts down remaining modules and enters Real Time Clock sleep mode. If the device is in Power Off Sleep mode, but not yet in Real Time Clock sleep mode and the timer to generate a record expires, the device wakes up, creates the record, and then repeats the cycle.

Note: Power bank detection relies on sensing external power, not the USB detection interrupt, because some power banks leave a small voltage (1-3V) on the line when sleeping.

Location settings

This feature allows switching between location sources.
Parameter: Location source (param ID = 128).

Values:

GNSS (0) - enables GNSS, disables neighbouring cell tower IOs.

LBS (1) - Powers down GNSS, enables neighbouring cell tower IOs. Note, when Saving / Sending Mode (parameter ID: 107) is set to "After position fix" (SMS/GPRS parameter value = 0), Location Source "LBS" is not available.

Location Based Services (LBS)

The Location Based Services (LBS) feature manages and stores the information about detected network cells. This can be used to determine the approximate location of the device withou relying on GNSS. Activating this scenario disables GNSS.

Cell IOs settings are not user-configurable.

To represent a single cell, a total of 5 IOs are required: LAC, CellId, RSSI, MNC, MCC. A total of 4 neighbouring cells are supported, i.e. 5*4 = 20 IOs in total.

Note that depending on modem and network type, RSSI might not be available and is only roughly calculated.

LED indication

This feature allows disabling or enabling status and navigation LEDs.



Button settings

Multi action button functionality utilizes tracker button for various actions (e.g. Alarm). Button employs click pattern logic.

Click patterns

Button has several click patterns, which allows to have possibility to control multiple actions by clicking it with different time intervals.

Click pattern Description
1 Click Button is pressed not longer than 2s.
2 Clicks Button is pressed not more than two times. If button was pressed more than 2 times, then double click will not be detected. Time between clicks can’t be longer than 1s.
Long Press Button is pressed and held for 2s to 5s.
Long Hold (Power Off via Button) Button is pressed and held for more than 5s.

Note: If button pressed in such pattern, that it is not possible to detect any of the click patterns, then the button will be in tamper state. In this case, button will wait for release of the button and then at least 1 second of released state. After that, it will go back to normal state and wait for new click pattern.

Power button

Power button has four click patterns, which can be used to trigger selected actions and generate event records with set event priority. Available actions. They can bet set for all four click patterns.

  • Alarm - Generates high priority alarm event and sends to the server immediately.
  • None - Does not generate any events and does not send any data.

Parameter list

[[Category:{{{model}}} Configuration]]
PARAMETER NAME PARAMETER ID (RELATED AVL ID) DESCRIPTION VALUES
Alarm - 1 Click 13014
(236)
Action selection after 1 click method. Action will be triggered when button is pressed not longer than 2 seconds. 0 = Disable Disable scenario.

1 = Low priority Device makes an additional record with indication of event cause.

2 = High priority Device makes an additional record with high priority flag and immediately sends an event packet to the server by GPRS.
Alarm - 2 Clicks 13015
(236)
Action selection after 2 clicks method. Action will be triggered when button is pressed not more than two times and time between clicks can not be longer than 1 second. 0 = Disable Disable scenario.

1 = Low priority Device makes an additional record with indication of event cause.

2 = High priority Device makes an additional record with high priority flag and immediately sends an event packet to the server by GPRS.
Alarm - Long Press 13016
(236)
Action selection after long press method. Action will be triggered when button is pressed longer than 2 seconds. 0 = Disable Disable scenario.

1 = Low priority Device makes an additional record with indication of event cause.

2 = High priority Device makes an additional record with high priority flag and immediately sends an event packet to the server by GPRS.
Power Off via Button 13087
(236)
Enable or disable powering off device via power off button. When functionality is enabled, the device can be turned off via power off button by holding it more than 5 seconds. -