TON(9)

💅 TON(9) — the IEC TON timer, bestie edition

okay so this is a HAL component called ton (short for the IEC TON timer, not the other ton, we don't talk about the other ton 🌸). what does it do? it delays the rising edge on a signal. that's it. that's the whole job. and it does it beautifully. ✨

it lives in section 9 of the manual, and it's a HAL Component, so you already know it's giving real-time electronics girlie energy. 👑

---

✨ NAME ✨

ton — IEC TON timer — delay rising edge on a signal 💖

like. the signal goes up, and ton is like "hold on babe, not yet" and then after the delay it goes up too. lowkey iconic behaviour honestly.

---

🎀 SYNOPSIS 🎀

loadrt ton [count=N|names=name1[,name2...]]

so you load it with loadrt, and then you either say count=N (gimme N of these please, don't care what they're called) or names=name1[,name2...] (gimme these exact ones, i have a naming vision 💅). you can't do both — pick a lane bestie 🫶

---

🦋 FUNCTIONS 🦋

• ton.N — Update the timer. that's the function, that's what it does. heads up though: this one requires a floating-point thread — it will NOT run in an integer thread, so don't even try it, it's not that kind of party. 😭

the .N is the instance number, okay? so if you loaded count=3 you get ton.0, ton.1, ton.2. multiple timers, multiple vibes, no cap.

---

🌈 PINS 🌈

• ton.N.in bit in — the input signal. this is the thing you're watching. when it rises, the timer starts, and the whole countdown drama begins. 👀
• ton.N.q bit out — the output signal. this is the glow-up of the input, just... later. delayed by the delay. time is a construct and ton is the construct's manager. ⏰
• ton.N.et float out — elapsed time since rising edge, in seconds. so you can literally watch the seconds tick by. main character countdown energy. it's giving suspense. 🍓

---

🌸 PARAMETERS 🌸

• ton.N.pt float rw — delay time in seconds. read-write, so you can change your mind mid-run, we support that here. 💜 this is the "how long are we waiting" dial and you are the DJ. 🎧

---

🌟 AUTHOR 🌟

Chad Woitas. yes, an actual real person wrote this, go give them their flowers 💐

---

👑 LICENSE 👑

GPL. the good one. the free one. use it, share it, keep it free. periodt. 💖

---

little reminder bestie: the N in all those pin and function names is the instance, so every timer you spin up gets its own in, q, et, pt, and its own ton.N function to update it. no shared state, no drama, no cross-talk. we love a clean boundary. 🧚

anyway that's the whole page, you understood all of it, you're literally a HAL girlie now, i'm so proud of you 🥹

---

with love, from the LinuxCNC Documentation, dated 2026-03-17 — that's the LinuxCNC Documentation gals, version date and all, signing off 🎀✨ bye bestie!! 🫶