Skip to content

SERIAL.md

Latest commit

 

History

History
40 lines (27 loc) · 1.39 KB

SERIAL.md

File metadata and controls

40 lines (27 loc) · 1.39 KB

serial_log.py

Bidirectional serial console with logging. Auto-detects common USB-UART adapters (e.g. Tigard, FTDI). Runs via uv with no manual dependency install.

Usage

./serial_log.py              # auto-detect adapter, pick channel interactively
./serial_log.py -c 0         # skip prompt, use UART (channel 0)
./serial_log.py -b 9600      # custom baud rate (default: 115200)
./serial_log.py -o boot.log  # custom log file (default: logs/serial_TIMESTAMP.log)
./serial_log.py -p /dev/...  # skip auto-detection, use specific port

Ctrl+] to quit. Ctrl+C passes through to the target.

External input

By default, a named pipe is created at /tmp/serial.pipe. Other processes can send commands to the serial device:

printf 'uname -a\n' > /tmp/serial.pipe

Disable with --no-pipe, or change the path with --pipe /tmp/other.pipe.

Reading the log

logs/latest.log is a symlink that always points to the current session's log file (all logs are written to the logs/ directory):

tail -f logs/latest.log      # follow output from another terminal
cat logs/latest.log          # read the full log

Notes

  • Log file is written continuously
  • On macOS, only cu.* devices are used (tty.* block on open waiting for DCD)
  • Multi-channel adapters: channel 0 = UART, channel 1 = JTAG/SWD