because minicom is not that good
Go to file
xenia c760bf2fb3 graceful sigint 2021-05-12 18:02:01 -04:00
megacom graceful sigint 2021-05-12 18:02:01 -04:00
.flake8 fix some typing errors 2021-05-12 16:02:35 -04:00
.gitignore Initial commit 2021-05-12 14:51:47 -04:00
Makefile Initial commit 2021-05-12 14:51:47 -04:00
README.md add logging option 2021-05-12 17:56:31 -04:00
setup.py initial commit 2021-05-12 15:41:58 -04:00

README.md

megacom

because minicom sucks

installation

it's a standard setuptools project, clone this repo, then do

pip3 install --user .

or for development

pip3 install --user -e .

usage

usage: megacom [-h] [-b BAUD] [-m MODE] [-l LOGFILE] [tty]

Alternative console-based UART client

positional arguments:
  tty                   Path to UART device [/dev/ttyUSB0]

optional arguments:
  -h, --help            show this help message and exit
  -b BAUD, --baud BAUD  UART baud rate [115200]
  -m MODE, --mode MODE  UART mode string [8N1]
  -l LOGFILE, --logfile LOGFILE
                        file to log to

sudo

to avoid using sudo, add yourself to the uucp group (on arch) or dialout group (ubuntu/debian), and make sure you don't have ModemManager installed

if you have ModemManager installed it's likely you will need to use sudo. if you absolutely need ModemManager on your system, try stopping it with sudo systemctl stop ModemManager, then unplugging and replugging UART devices. once you're done using megacom, you can restart ModemManager with sudo systemctl start ModemManager, if it was previously running

keyboard shortcuts

CTRL-A is the escape character. CTRL-A + Q quits megacom. CTRL-A + CTRL-A sends a literal CTRL-A

there will be more keyboard shortcuts later, hopefully

baud

any standard baud rate (as an integer) which is supported by pyserial can be used. usually you want the default (115200)

mode strings

composed of bytesize, parity, and stopbits. usually you want the default (8N1)

the following options are supported

  • bytesize: 8, 5, 6
  • parity: N (none), E (even), O (odd), M (mark), S (space)
  • stopbits: 1, 1.5, 2

examples:

8N1
5E2
6S1.5

windows

untested. it might work tho. don't expect windows to be actively supported because serial on windows is extremely annoying. just use WSL