usbrelay(1)

🌸 usbrelay — bestie edition 🌸

okay so this is the manual page for usbrelay, and it lives in the General Commands Manual section. she's a little command with big main character energy: she controls or queries USB HID relays 💅

---

✨ SYNOPSIS ✨

usbrelay [OPTION...]  [ACTION...]

---

💖 DESCRIPTION 💖

usbrelay lets you query and set the state of USB HID electrical relays. she's basically the group chat admin of your little relay module. 🔌✨

If you don't pass any ACTION at all, she just prints the state of all the relays to stdout. no notes, just receipts. 📋

To actually flip a relay: RELID_N=[0|1] sets the N-th relay on module RELID to off (0) or on (1). that's the whole vibe check right there. 🎀

ngl, the best part is that you can do multiple actions with one command. one shot, many relays. iconique. 🔥

for example:

usbrelay REL0A_1=0 REL0A_2=1 REL0B_2=0...

okay so important thing bestie, do not skip this: the RELID must only contain the characters A-Z0-9. that's it. that's the alphabet she accepts. if your relay has illegal characters, swap in the device file as the RELID instead (peep below for how 👀).

On DCTTECH relays you can also change the Relay module ID:

RELID_0=NEWID

sets the relay RELID to NEWID. lowkey magic. ✨

or, alternatively:

/dev/hidrawX_0=NEWID

(just substitute X for the device path that shows up with the -d option 🫶)

---

🌈 OPTIONS 🌈

• -d, --debug — produces debugging output. she's telling you everything, fr fr. 🐛
• -q, --quiet — suppresses output. shhh. not a peep. 🤫
• -?, --help — prints the help menu. the classic cry for guidance. 😭
• --usage — prints a usage description. the quick lil cheat sheet. 📝
• -V, --version — prints the program version. so you know exactly which girl you're talking to. 👑

---

reminder bestie: no ACTION means she prints every relay's state. no cap. 💖

---

that's the whole page, you ate it 🍓 — written up as usbrelay, dated 24 Jan 2022, and honestly she's iconic for it. bye bestie, go flip some relays 💅✨🦋