reference · South Africa
Timer instructions: TON, TOF, and TP explained
TON, TOF, and TP timers explained: IEC 61131-3 syntax, vendor differences across Siemens and Allen-Bradley, and the timing bugs that bite in production.
Timer instructions are the second concept every PLC engineer needs after contacts and coils. The IEC 61131-3 standard defines three timers: TON, TOF, and TP. Each behaves differently and a programmer who reaches for the wrong one creates bugs that only surface under specific input timing. Vendor extensions add a fourth — retentive ON-delay — which is not standard and does not port.
Try the simulator →What this instruction does
The timers family is one of the building blocks every working PLC engineer uses on a weekly basis. This page is the one-page reference: what the instruction is for, how the IEC 61131-3 standard form reads, where each major vendor's IDE diverges from the standard, and the mistakes that typically cost a shift on commissioning. We program these on real hardware ourselves; the worked examples below are the patterns that actually ship, not toy snippets. Read the page front to back the first time, then bookmark it as a quick lookup once the patterns are in muscle memory. The simulator covers each example in the sandbox at the free tier, so you can copy a rung from this page and run it without installing anything.
IEC 61131-3 syntax
The standard form is the place to anchor; once the IEC syntax is clear the vendor variations are easier to read. The block below is the canonical timers declaration as the standard defines it.
TON_Inst(IN := <bool>, PT := T#5s);
TON_Inst.Q // BOOL output, true after PT elapses
TON_Inst.ET // TIME elapsed
// TOF and TP have the same instance pattern.
A few notes on reading the syntax. The instance name on the left is what the runtime allocates state against — every call to a function block needs its own instance, never reused across rungs. The inputs after the colon-equals are how you bind real signals or constants to the block's parameters at call time. The dotted accessors after the call are how you read the output state on the next scan; the runtime only refreshes them at the call site, so referencing a dotted output from a rung that runs before the call gives you stale data.
Vendor implementations
Every major vendor implements the IEC standard form, but each adds its own conventions on top — IDE menu paths, datatype names, retentive variants. The mappings below are the ones that bite on a real commissioning visit. If your vendor is not listed here, the IEC form above is still the safe starting point; check the vendor docs for the brand-specific diff before you ship.
Siemens
TIA Portal: Instructions > Basic instructions > Timer operations. Drag TON, TOF, or TP onto a rung; each requires its own instance DB.
Reusing the same instance DB across two TON calls causes both timers to share state. Q and ET drift in unpredictable ways and the bug surfaces only when both rungs run simultaneously.
Allen-Bradley
Studio 5000: TON, TOF, and RTO instructions. Preset .PRE in milliseconds; accumulator .ACC counts up; .DN is the done bit.
Allen-Bradley adds RTO (retentive ON-delay) which IEC 61131-3 does not define. RTO holds .ACC across input drops and requires an explicit RES instruction to reset.
CODESYS
TON, TOF, TP from the standard library; declared as instances in a VAR block, called with IN and PT inputs.
CODESYS follows IEC 61131-3 strictly. ET freezes at PT once Q is true on TON, which differs from older Siemens behaviour where ET kept counting up.
Worked examples
The examples below are patterns we ship. Each one names the production context, the rung shape, and the parameter values that work in practice. Copy them into the simulator's sandbox to see the timing behaviour live before you put them on hardware.
Motor warm-up delay
A 5-second TON between the start command and the run output gives the lubrication system time to prime before mechanical load engages.
// Pseudo-ladder
// StartCmd ─] [─[TON 5000 ms]─( RunCmd )
Conveyor run-on after stop
A TOF on the stop command keeps the conveyor running for 3 seconds after stop is pressed, draining upstream feed without stranding parts on the belt.
Single-shot lamp pulse
A TP fires the alarm beacon for exactly 2 seconds on a fault edge regardless of how long the fault persists, then needs the input to drop and rise again.
Common mistakes
The mistakes below cost real time on real projects. The first three appear on every commissioning visit; the rest are the second-tier traps that surface only under load or after a cold start. Run a paired-review pass against the list before you commit any rung that uses this instruction.
- Reusing the same TON instance in two rungs corrupts both timers' .ET and .Q fields silently each scan.
- TON preset times under one scan-cycle are unreliable; round preset up to a clean multiple of the scan time.
- TOF retains its .ET value while running so any latch built around it must check .Q, not .ET below preset.
- Confusing RTO with TON in code ported from Allen-Bradley to Siemens — the retentive accumulator is not standard.
A pattern across all of these: the instruction itself is rarely the bug — the bug is in how the surrounding rung reads or writes the instruction's state. Check the rung shape first. The simulator's live trace pane shows .Q and .ET (or the instruction's equivalent state fields) on every scan, which is the fastest way to see whether the instruction is doing what you think it is.
How to practise this in the simulator
The simulator has a sandbox that lets you write a one-rung program using this instruction in under sixty seconds. Free tier covers it — open the simulator, drop the instruction onto a rung, wire two test inputs, and watch the .Q and .ET fields update in the live trace pane. The patterns above are exactly the patterns the curriculum builds on; this page is the one-page reference, the curriculum is the deliberate-practice version. Working through the curriculum's matching module gives you ten to fifteen variations on the same instruction shape, with feedback on each, and a portfolio piece at the end. The free tier is enough to verify the instruction works as documented; the Basic tier (USD 12 per month) unlocks the curriculum modules.
Start the free tier →Vendor reference
IEC 61131-3 standard is the canonical reference for the IEC 61131-3 standard form. For brand-specific quirks, Siemens Industry Online Support and Rockwell Automation Support are the canonical sources. When the standard and the vendor docs disagree, the vendor docs win for that vendor's hardware — the IEC form is the portable shape, the vendor form is what the firmware actually executes. For platform-pick decisions and longer brand context, see the Siemens and Allen-Bradley brand hubs.
What we don't claim
This site is not SAQA-registered, not MerSETA-accredited, and not an NQF-registered qualification provider. Our completion certificates are course-level only — they describe what you covered, not an NQF Level X qualification. The CCST cert from ISA is the portable industry credential we recommend; we are not an ISA cert delivery partner either, but our cert packs are CCST-aligned. The instruction reference on this page is a one-page summary of the IEC 61131-3 standard form plus vendor-specific quirks; vendor docs remain the canonical source for any production project.
Where this fits in a working week
A technician who has the timers family in muscle memory typically spends less than two minutes per rung writing one. The ones that take longer are the ones where the surrounding state machine has not been thought through; the instruction is fine, the design around it is what eats the day. The simulator's value is letting you exercise the design without paying for hardware time — write the rung, run it, watch the trace, fix the design, repeat. Twenty minutes in the sandbox saves a half-day of commissioning rework. The curriculum's matching module on the timers family takes about three to four hours of focused practice end to end and gives you the muscle memory plus the portfolio piece you can hand a hiring engineer. Petrochem, mining, FMCG, automotive, and water-utility sectors all use this family on a weekly basis; the patterns on this page are the same patterns the OEM engineering houses ship.
Load-shedding has changed the rung shapes that ship in SA. Power-recovery patterns — controlled shutdown on UPS hold, state recovery from retentive memory, sequenced restart of motor groups — sit on top of the timers family; understanding the instruction in isolation is step one, understanding how it behaves on a cold start after a 2.5-hour cut is step two. The simulator's restart-from-cut mode lets you exercise this without bricking real hardware. For institutional buyers — TVET colleges, private training providers, in-house engineering training departments — the bulk-licence option is the Teams tier, USD 199 per seat per year, minimum 5 seats. The training-centres page has the institutional pitch and the contact form.