Accumulates elapsed time across multiple activations and outputs TRUE when the total reaches the preset duration.
The RTO (Retentive Timer On-Delay) instruction retains its elapsed time .ET when .IN turns FALSE and resumes counting on the next activation:
.IN is TRUE — Timer accumulates elapsed time .ET..IN is FALSE — Timer pauses and retains .ET..ET >= .PT — Output .Q becomes TRUE..R (Reset) is TRUE — Resets .ET to 0 and .Q to FALSE. You can bind an optional R reset variable directly in the action operand slot or reset the timer with the R qualifier.Alt or right-click -> Edit Qualifier & Instruction).PT, for example T#60s) and optionally select a boolean reset variable in the R input slot.from automation_machine import ActionInstruction
step.add_action("timer_name", "Timer description", instruction=ActionInstruction.RTO, duration=60000)
ActionQualifier enum (default: ActionQualifier.N)ActionInstruction.RTO60000 for 60 seconds).ET and .Q| Variable | Type | Description |
|---|---|---|
.IN |
BOOL |
Input signal — timer accumulates while TRUE |
.R |
BOOL |
Reset input — clears .ET to 0 and .Q to FALSE when TRUE |
.Q |
BOOL |
Output signal — TRUE when .ET >= .PT |
.PT |
TIME |
Preset target duration |
.ET |
TIME |
Accumulated elapsed time (retained across activations) |