1tio(1)                      General Commands Manual                     tio(1)
2
3
4

NAME

6       tio - a simple TTY terminal I/O application
7
8

SYNOPSIS

10       tio [<options>] <tty-device>
11
12

DESCRIPTION

14       tio  is a simple TTY terminal application which features a straightfor‐
15       ward commandline interface to easily connect to TTY devices  for  basic
16       input/output.
17
18

OPTIONS

20       -b, --baudrate <bps>
21
22              Set baud rate [bps] (default: 115200).
23
24       -d, --databits 5|6|7|8
25
26              Set data bits (default: 8).
27
28       -f, --flow hard|soft|none
29
30              Set flow control (default: none).
31
32       -s, --stopbits 1|2
33
34              Set stop bits (default: 1).
35
36       -p, --parity odd|even|none
37
38              Set parity (default: none).
39
40       -o, --output-delay <ms>
41
42              Set  output  delay  [ms]  inserted  between  each sent character
43              (default: 0).
44
45       -n, --no-autoconnect
46
47              Disable automatic connect.
48
49              By default tio automatically connects to the provided device  if
50              present.  If  the  device is not present, it will wait for it to
51              appear and then connect. If the connection is lost  (eg.  device
52              disconnects),  it  will wait for the device to reappear and then
53              reconnect.
54
55              However, if the --no-autoconnect option is  provided,  tio  will
56              exit  if  the device is not present or an established connection
57              is lost.
58
59
60       -l, --log <filename>
61
62              Log to file.
63
64
65       -m, --map <flags>
66
67              Map (replace, translate) special characters on input or  output.
68              The following mapping flags are supported:
69
70
71
72              INLCR   Map NL to CR on input.
73
74              IGNCR   Ignore CR on input.
75
76              ICRNL   Map  CR  to  NL  on input (unless IGNCR is
77                      set).
78
79              ONLCR   Map NL to CR-NL on output.
80
81              OCRNL   Map CR to NL on output.
82
83              If defining more than one flag, the flags must  be
84              comma separated.
85
86
87       -v, --version
88
89              Display program version.
90
91       -h, --help
92
93              Display help.
94
95

KEYS

97       In  session,  the following key sequences are intercepted
98       as tio commands:
99
100       ctrl-t ?        List available key commands
101
102       ctrl-t b        Send  serial  break  (triggers  SysRq  on
103                       Linux, etc.)
104
105       ctrl-t c        Show  configuration  (baudrate, databits,
106                       etc.)
107
108       ctrl-t h        Toggle hexadecimal mode
109
110       ctrl-t l        Clear screen
111
112       ctrl-t q        Quit
113
114       ctrl-t s        Show TX/RX statistics
115
116       ctrl-t t        Send ctrl-t key code
117
118

EXAMPLES

120       Typical use is without options. For example:
121
122              tio /dev/ttyUSB0
123
124       Which corresponds to the commonly used options:
125
126              tio  -b  115200  -d  8  -f  none  -s  1  -p   none
127              /dev/ttyUSB0
128
129       It  is  recommended  to connect serial tty devices by ID.
130       For example:
131
132              tio
133              /dev/serial/by-id/usb-FTDI_TTL232R-3V3_FTGQVXBL-if00-port0
134
135       Using serial devices by ID ensures that tio automatically
136       reconnects  to the correct serial device if the device is
137       disconnected and then reconnected.
138
139

WEBSITE

141       Visit https://tio.github.io
142
143

AUTHOR

145       Written by Martin Lund <martin.lund@keep-it-simple.com>.
146
147
148
149                                 November 2017                          tio(1)