Skip to Content
CommandsStatesTimersTR

TR Command

The TR command (Time tRigger) allows configuring 8 date and time triggers (TR00 to TR07) that use the Real Time Clock (RTC) synchronized with GPS.

What is it for?

  • ⏰ Execute actions at specific times (e.g.: report at 8:00 AM)
  • 🔄 Periodic tasks every minute, hour or specific second
  • 📅 Event scheduling based on time
  • 🌐 Precise synchronization with GPS time (UTC)

The time used is UTC 0 (synchronized with GPS). Adjust according to your time zone.

Syntax

Configure trigger

STRaabbccdd

Query trigger

QTRaa

Response: RTRaabbccdd

Parameters

ParameterDescriptionRange
aaTrigger index00-07
bbHour00-23 or **
ccMinute00-59 or **
ddSecond00-59 or **

Wildcard **

Use ** as a wildcard so the trigger activates at any value of that field:

PatternMeaning
12****Triggers every second of 12:xx:xx
**30**Triggers every second of minute 30
****00Triggers at second 00 of every minute
1230**Triggers every second of 12:30
123000Triggers exactly at 12:30:00

TR Signal (Trigger)

PropertyValue
NameTR
Index00-07
Edge+ (positive)
Conditional useNot suitable

Examples

Trigger at exact time

>STR00083000<    // TR00: triggers at 08:30:00 UTC

Trigger every minute

>STR01****00<    // TR01: triggers at second 00 of every minute

Trigger every hour

>STR02**0000<    // TR02: triggers at XX:00:00 (every hour on the hour)

Trigger every second (of a specific hour)

>STR03120000<    // TR03: triggers only at 12:00:00
>STR0312****<    // TR03: triggers every second between 12:00:00 and 12:59:59

Usage in Rules

Daily report at 6:00 AM UTC

// Configure trigger at 06:00:00
>STR00060000<
 
// Generate report when activated
>SRL00E;TRG=TR00+;ACC={GCP00H}<

Heartbeat every minute

// Trigger at second 00 of every minute
>STR01****00<
 
// Send life report
>SRL01E;TRG=TR01+;ACC={GCP01L}<

Action during business hours

// Trigger at 08:00 and 18:00
>STR02080000<    // Start of workday
>STR03180000<    // End of workday
 
// Enable/disable business hours flag
>SRL10E;TRG=TR02+;ACC={SSSU0011}<    // U00 = in hours
>SRL11E;TRG=TR03+;ACC={SSSU0000}<    // U00 = out of hours

Multiple triggers per hour

// Reports every 15 minutes
>STR00**0000<    // XX:00:00
>STR01**1500<    // XX:15:00
>STR02**3000<    // XX:30:00
>STR03**4500<    // XX:45:00
 
// All generate the same report
>SRL00E;TRG=TR00+;ACC={GCP00H}<
>SRL01E;TRG=TR01+;ACC={GCP00H}<
>SRL02E;TRG=TR02+;ACC={GCP00H}<
>SRL03E;TRG=TR03+;ACC={GCP00H}<

Tip: Combine TR with TD for more flexible reports (TR for fixed times, TD for intervals).

Compatibility

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