Skip to Content
CommandsStatesTimersTD

TD Command

The TD (Time/Distance) command allows configuring 32 timers/counters (TD00 to TD31) that generate triggers based on elapsed time and/or traveled distance.

What is it used for?

  • ⏱️ Periodic reports by time (every X seconds)
  • 📍 Distance-based reports (every X meters)
  • 🔄 Combined triggers (time OR distance, whichever occurs first)
  • ⚡ Activate rules in the Event Engine

Storage Modes

ModeMemoryPersistenceRecommended use
EFlash✅ Non-volatilePermanent configuration
DFlash✅ Non-volatilePermanently disable
RRAM❌ VolatileDynamic timers in rules
CRAM❌ VolatileStop temporary timers

To preserve Flash memory:

  • Use R/C (RAM) when you need to start/stop timers frequently
  • Use E/D (Flash) only for configurations that rarely change

Syntax

Configure timer

STDaabcccccddddd

Query timer

QTDaa

Response: RTDaabcccccddddd

Parameters

ParameterDescriptionRange
aaTimer index00-31
bEnable modeE, D, R, C
cccccTime in seconds00000-99999
dddddDistance in meters00000-99999

All timers start at 00000 when the device powers on.

TD Signal (Trigger)

PropertyValue
NameTD
Index00-31
Edge+ (positive)
Conditional useNot suitable

When the timer reaches its limit (time OR distance), it generates a TDxx+ trigger that can be used as a trigger in logic rules.

Examples

Time-only trigger

>STD00E0030000000<    // Timer 00: triggers every 300 seconds
FieldValueMeaning
Timer00Index 0
ModeEEnabled (Flash)
Time00300300 seconds (5 min)
Distance00000Not used

Distance-only trigger

>STD02E0000001000<    // Timer 02: triggers every 1000 meters

Time OR distance trigger

>STD01E0006001000<    // Timer 01: triggers every 60s OR every 1000m

Whichever occurs first resets both counters.

Abbreviated format (time only)

>STD00E00300<         // Equivalent to STD00E0030000000

Compatible with previous firmware versions.

Usage in Rules (Volatile RAM)

For dynamic timers within rules, use R (start) and C (stop) modes:

// When IGN connects → start 120-second timer
>SRL12E;TRG=IN07+;ACC={STD05R0012000000}<
 
// When timer expires → generate report and stop
>SRL13E;TRG=TD05+;ACC={GCP00L}{STD05C}<
 
// When IGN disconnects → stop timer
>SRL14E;TRG=IN07-;ACC={STD05C}<

Periodic reports with IGN

// Permanent 60-second timer
>STD00E0006000000<
 
// Generate CP report every 60s only if IGN is on
>SRL00E;TRG=TD00+;CND=IGN;ACC={GCP00H}<

Distance-based tracking

// 500-meter timer
>STD01E0000000500<
 
// Generate report every 500m while moving
>SRL01E;TRG=TD01+;CND=MV00;ACC={GCP01H}<

Compatibility

💾Firmware v1.03.00
SPLegacy
ULLegacy
MTLegacy
💾Firmware v1.00.00
SP-IOT
SM-IOT
Last updated
NTTR