SJINN(1)

📦 version 1.01, in fedora 43, fedora 44

💖 SJINN(1) — the group chat manual page 💖

okay bestie, gather round — this is sjinn, aka the RS-232 control and serial communications tool, straight out of the General Commands Manual. It talks to serial ports so you don't have to. No cap. 🦋

✨ NAME ✨

sjinn — RS-232 control and serial communications 💅

✨ SYNOPSIS ✨

sjinn ption [options] ...
yes, it literally says ption, that's not me being quirky, that's the page 💀

🌸 EXAMPLE 🌸

sjinn -b600 -p7n2 -s"D" -r14 --verbose

look at her go. baud 600, 7 databits no parity 2 stopbits, send "D", read 14 chars, and be loud about it. iconic.

🎀 COMMUNICATIONS OPTIONS 🎀

  • -d, --file — [default /dev/ttyS0] the serial I/O device. this is the port you're flirting with. 🫶
  • -b, --baud — [default 9600] set the baud rate. the options are: 50,75,110,134,150,200,300,600,1200,1800,2400,9600, 19200,38400,57600,115200,230400 pick one, bestie, she's not gonna guess ✨
  • -p, --comm — [default 8N1] set databits, parity, stopbits in the form (5,6,7,8)(N,E,O)(1,2). note: it's a 3 character string, each parameter is a single character, i.e. '7N2'. mark and space parity are NOT supported — don't come for her about it. 😭
  • --xonxoff — [default off] XON/XOFF — software flow control 🌊
  • --rtscts — [default off] RTS/CTS — hardware flow control 🔌
  • --dtr — [default enabled] this one disables DTR. yes, the flag turns it off, that's the vibe, that's the design 💅
  • --rts — [default disabled] this one enables RTS. opposite energy, same icon behavior ✨
  • -s, --send STRING — write string to device 📤 note: in addition to ASCII characters the following control-chars are supported: \r \n \0 \p \h \w \\
  • -r, --read INT — read n characters from device 📥
  • -w, --wait FLOAT — [default 0.5] seconds between send & read ⏳
  • --pause FLOAT — [default = wait] wait time for pause-character, if not specified it is set to the value of the -w parameter 🫧
  • -m, --msec — specify \w and \p in milliseconds instead of seconds ⏱️

💖 FORMATTING OPTIONS 💖

  • --hex — [default=ASCII] display read buffer in hex values 🔢
  • --hex+ — [default=ASCII] display read buffer in hex + ASCII — best of both, main character energy 👑
  • --wrap INT — wrap lines at n characters 🎀
  • --trim INT — truncate lines at n characters ✂️
  • --n, --nolf — do not output the trailing new line 🙈
  • --verbose — verbose. she said what she said. 📢

⭐ OPTIONS ⭐

  • -h, --help — display this help and exit 🆘
  • -V, --version — output version and exit 🏷️

🌈 SEND STRING CONTROL-CHARACTERS 🌈

  • \\ — Back-Slash
  • \- — Minus-Sign (dash)
  • \n — LF
  • \r — CR
  • \p — Pause Delay number of seconds/mSec defined by --pause ⏸️
  • \w — Wait Delay number of seconds/mSec specified, number must be followed by a space (example: -s"cmd1\n\w.5 cmd2\n") ⌛
  • \h — Hex Mode Toggle to/from hex mode, hex codes must be 2-characters followed by a space (example: -s"command1\h9e 4c\h\n") 🔁

🦋 AUTHOR 🦋

Brian Peterson, Aspen Research Corporation (the original legend, we stan)

💀 BUGS 💀

Report bugs at <http://sourceforge.net/projects/sjinn> 🐛

🚨 WARRANTY 🚨

This is free software with ABSOLUTELY NO WARRANTY 😭 fr fr, none, zero, nada

and that's the whole page, bestie — this came out of May 2001, and the manual it lives in is SJINN(1). go forth and talk to your serial devices 💖✨🎀🦋🌸💅🫶

📦 where this page comes from