AXISTEST(9)

💖 AXISTEST(9) 💖

okay bestie, so this is a HAL component page (that's the manual name, she's from the HAL Component family 💅), and it's literally the test-your-axis toy. axistest exists so you can poke at an axis and see what it does — it's used IN PnCconf and nowhere near as scary as it sounds. Let's get into it 🫶

---

✨ NAME ✨

axistest — used to allow testing of an axis. Used IN PnCconf. periodt.

---

🌸 SYNOPSIS 🌸

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

load it in with loadrt, give it a count or a list of names, and she's up.

---

🦋 FUNCTIONS 🦋

• axistest.N.update — this one requires a floating-point thread, no cap. so pls make sure you're running it on a thread that can do floats or she will simply not.

---

💅 PINS 💅

every pin gets N in the name, where N = whichever instance you're talking to.

• axistest.N.jog-minus (bit, in) — drive it TRUE and the axis jogs in its negative ('minus') direction. nudge nudge 🫶
• axistest.N.jog-plus (bit, in) — drive it TRUE and she jogs in her positive direction. slay ✨
• axistest.N.run (bit, in) — drive it TRUE and the axis runs near its current position_fb with a trapezoidal velocity profile. that's the fancy walk 🚶♀️💨
• axistest.N.maxvel (float, in) — maximum velocity. the speed limit, bestie 🚦
• axistest.N.amplitude (float, in) — approximate amplitude of positions to command during 'run'.
• axistest.N.dir (s32, in) — direction from central point to test: 0 = both, 1 = positive, 2 = negative. pick your lane 🎀
• axistest.N.position-cmd (float, out) — out here doing her thing, no description given 💀
• axistest.N.position-fb (float, in) — same, icon behavior only 💅
• axistest.N.running (bit, out) — she's up, she's running.
• axistest.N.run-target (float, out) — vibe: target.
• axistest.N.run-start (float, out) — where the run started, fr.
• axistest.N.run-low (float, out) — the low end.
• axistest.N.run-high (float, out) — the high end.
• axistest.N.pause (s32, in) (default: 0) — pause time for each end of run, in seconds. lil breather at both ends 😮‍💨

---

🎀 PARAMETERS 🎀

• axistest.N.epsilon (float, rw) (default: .001) — read/write, she's editable.
• axistest.N.elapsed (float, r) — current value of the internal timer. read-only, just observing 👀

---

👑 AUTHOR 👑

Chris S. Morley — the legend herself.

---

🌈 LICENSE 🌈

GPL — free as a butterfly, protected as a queen.

---

⚠️ heads up: axistest is for testing. it's the practice-mode axis, not your production queen. use her to check stuff works, not to run your machine forever. iykyk 🙈

---

okay that's the whole page, no skips no shortcuts, we ate and left no crumbs 💖

and for the cute sign-off: this lil doc came from the LinuxCNC Documentation, dated 2026-03-17, and the page is AXISTEST(9). go forth and slay your axis tests, bestie ⭐🧚💜