GEARCHANGE(9)

📦
version 2.9.4 · 4 versions
, in ubuntu resolute, ubuntu stonking

💖 GEARCHANGE 💖

okay bestie, gather round, because we're talking about gearchange — a HAL component that lets you select from one two speed ranges ✨ (yes, two ranges, that's the whole vibe). It's giving ✨gear selector✨, and honestly? iconic.

✨ SYNOPSIS ✨

The way this works is: the output is a value scaled for the selected gear, and then clamped to the min/max values for that gear. No cap.

The scale of gear 1 is assumed to be 1, so you gotta choose the scale of your output device accordingly, fr fr.

The scale of gear 2 is relative to gear 1. So like, if gear 2 runs the spindle 2.5 times as fast as gear 1, then scale2 should be set to 2.5. math queen behavior 💅

🌸 FUNCTIONS 🌸

  • gearchange.N — requires a floating-point thread 🧵

🦋 PINS 🦋

  • gearchange.N.sel bit in — the gear selection input 👑 (pick your fighter)
  • gearchange.N.speed-in float in — speed command input, come thru 🎀
  • gearchange.N.speed-out float out — the speed command headed to your DAC/PWM 🌈
  • gearchange.N.dir-in bit in — direction command input ⭐
  • gearchange.N.dir-out bit out — direction output — which may or may not be inverted for second gear, iykyk 🙈

💅 PARAMETERS 💅

  • gearchange.N.min1 float rw (default: 0) — minimum allowed speed in gear range 1 🍓
  • gearchange.N.max1 float rw (default: 100000) — maximum allowed speed in gear range 1 🍓
  • gearchange.N.min2 float rw (default: 0) — minimum allowed speed in gear range 2 💜
  • gearchange.N.max2 float rw (default: 100000) — maximum allowed speed in gear range 2 💜
  • gearchange.N.scale2 float rw (default: 1.0) — relative scale of gear 2 vs. gear 1. Since it's assumed that gear 2 is "high gear", scale2 must be greater than 1, and it will be reset to 1 if set lower 🫶
  • gearchange.N.reverse bit rw (default: 0) — set to 1 to reverse the spindle in second gear 🔥

👑 AUTHOR 👑

Stephen Wille Padnos 💖 (the moment, the icon, the legend)

📜 LICENSE 📜

GPL — periodt.

lowkey a whole serve, highkey a HAL component. go forth and gear-change, bestie 🌸🦋💅

that's the whole page, no notes. brought to you by the LinuxCNC Documentation girlies, dated 2026-03-17 — see u in the next manpage, mwah 💖✨🎀

📦 where this page comes from