ttysig(1)

💖 ttysig — Serial Line Signal Controller 💖

okay bestie, welcome to ttysig(1) — yes that's the manual page, and yes I'm about to make serial ports cute. sit down, grab a boba, we're doing hardware handshakes today 🫶

✨ NAME ✨

ttysig — Serial Line Signal Controller

like, it's a little tool that pokes at the wires on your serial line and tells you what they're doing. very demure. very mindful. 💅

🌸 SYNOPSIS 🌸

ttysig [options]

that's it. that's the whole vibe. no files, no arguments, just options. iconic honestly ⭐

🦋 DESCRIPTION 🦋

so here's the tea ☕ — ttysig lets you interactively control serial line output signals, specifically:

• Request To Send
• Data Terminal Ready

and also read the current value of all control signals, which are:

• Request To Send
• Clear To Send
• Data Set Ready
• Data Terminal Ready
• Data Carrier Detect
• Ring Indicator

so you can flip the ones you own and peek at the ones the other side is holding. it's giving "let me see what you're doing over there" 🔥

Also, for the record: this program is part of the Qualcomm Atheros Powerline Toolkit. If you want the big-picture overview plus install instructions, go read the AMP man page. no cap, that's where the lore lives 📚

💜 OPTIONS 💜

• -s device — pick which serial device you wanna talk to. the default is the serial console device /dev/ttyS0. yeah, it just assumes. bold of it honestly 🙈
• -D value — set the serial control line DTR high if value is non-zero, and low otherwise. like, literally any nonzero number means high, bestie. it's not picky 🎀
• -I — interactive mode. you get a lil prompt and you type commands at it. this is the main character mode, fr fr 👑
• -R value — set the serial control line RTS high if value is non-zero, and low otherwise. same deal as -D ✨
• -r — print the serial control line status to stdout. and listen, the ordering matters: this happens after -R and -D. so it reflects what you just set. no, it will not time travel 🕰️
• -?,--help — print the program help summary on stdout. this option takes precedence over other options on the command line. it wins. periodt 💅
• -?,--version — print program version information on stdout. this one also takes precedence over other options on the command line. and here's a lil pro tip from the original: use this option when sending screen dumps to Atheros Technical Support so they know exactly which version of the Linux Toolkit you're using. help them help you, bestie 🫶

⚠️ heads up: both -?,--help and -?,--version take precedence over other options on the command line. so if you stack them with other flags, don't be surprised when it just prints and dips. that's the rule, I don't make them 💀

🌈 EXAMPLES 🌈

okay this example is so cute. it sets DTR high and RTS low right at program start. then the user interactively prints the current control signal values, and then sets DTR low. and since no serial devices are specified, the program defaults are used 😌

$ ./ttysig -I -D 1 -R 0
command (D #, R #, r, q): r
RTS: -V
CTS: -V
DSR: -V
DTR: +V
DCD: -V
RI : -V
command (D #, R #, r, q): D 0
command (D #, R #, r, q):

see how DTR: +V after -D 1? and then D 0 drops it. the prompt literally tells you your moves: D #, R #, r, q. it's giving helpful friend energy 🌸

🔍 SEE ALSO 🔍

• amp(1)
• int6kdetect(1)
• int6kuart(1)

go read those too, they're the extended universe 🦋

🎀 CREDITS 🎀

Nathaniel Houghton 💖

okay that's the whole page, you ate that. stay hydrated, check your RTS before you ship, and remember: open-plc-utils-0.0.3, from November 2013, brought to you by the Qualcomm Atheros Open Powerline Toolkit. mwah 💋✨