NAME

       tio - a simple TTY terminal I/O application

SYNOPSIS

       tio [<options>] <tty-device>

DESCRIPTION

       tio is a simple TTY terminal application which features a straightforward commandline interface to easily
       connect to TTY devices for basic input/output.

OPTIONS

       -b, --baudrate <bps>

              Set baud rate [bps] (default: 115200).

       -d, --databits 5|6|7|8

              Set data bits (default: 8).

       -f, --flow hard|soft|none

              Set flow control (default: none).

       -s, --stopbits 1|2

              Set stop bits (default: 1).

       -p, --parity odd|even|none

              Set parity (default: none).

       -o, --output-delay <ms>

              Set output delay [ms] inserted between each sent character (default: 0).

       -n, --no-autoconnect

              Disable automatic connect.

              By default tio automatically connects to the provided device if present.  If  the  device  is  not
              present,  it  will  wait  for it to appear and then connect. If the connection is lost (eg. device
              disconnects), it will wait for the device to reappear and then reconnect.

              However, if the --no-autoconnect option is provided, tio will exit if the device is not present or
              an established connection is lost.

       -e, --local-echo

              Enable local echo.

       -l, --log <filename>

              Log to file.

       -m, --map <flags>

              Map  (replace,  translate)  special characters on input or output. The following mapping flags are
              supported:

              ICRNL       Map CR to NL on input (unless IGNCR is set).

              IGNCR       Ignore CR on input.

              INLCR       Map NL to CR on input.

              INLCRNL     Map NL to CR-NL on input.

              OCRNL       Map CR to NL on output.

              ODELBS      Map DEL to BS on output.

              ONLCRNL     Map NL to CR-NL on output.

              If defining more than one flag, the flags must be comma separated.

       -v, --version

              Display program version.

       -h, --help

              Display help.

KEYS

       In session, the following key sequences are intercepted as tio commands:

       ctrl-t ?        List available key commands

       ctrl-t b        Send serial break (triggers SysRq on Linux, etc.)

       ctrl-t c        Show configuration (baudrate, databits, etc.)

       ctrl-t e        Toggle local echo mode

       ctrl-t h        Toggle hexadecimal mode

       ctrl-t l        Clear screen

       ctrl-t q        Quit

       ctrl-t s        Show TX/RX statistics

       ctrl-t t        Send ctrl-t key code

EXAMPLES

       Typical use is without options. For example:

              tio /dev/ttyUSB0

       Which corresponds to the commonly used options:

              tio -b 115200 -d 8 -f none -s 1 -p none /dev/ttyUSB0

       It is recommended to connect serial tty devices by ID. For example:

              tio /dev/serial/by-id/usb-FTDI_TTL232R-3V3_FTGQVXBL-if00-port0

       Using serial devices by ID ensures that tio automatically reconnects to the correct serial device if  the
       device is disconnected and then reconnected.

WEBSITE

       Visit https://tio.github.io

AUTHOR

       Written by Martin Lund <martin.lund@keep-it-simple.com>.

                                                    June 2018                                             tio(1)