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       -e, --local-echo
61
62              Enable local echo.
63
64
65       -l, --log <filename>
66
67              Log to file.
68
69
70       -m, --map <flags>
71
72              Map (replace, translate) special characters on input or  output.
73              The following mapping flags are supported:
74
75
76
77              ICRNL       Map CR to NL on input (unless IGNCR is
78                          set).
79
80              IGNCR       Ignore CR on input.
81
82              INLCR       Map NL to CR on input.
83
84              INLCRNL     Map NL to CR-NL on input.
85
86              OCRNL       Map CR to NL on output.
87
88              ODELBS      Map DEL to BS on output.
89
90              ONLCRNL     Map NL to CR-NL on output.
91
92              If defining more than one flag, the flags must  be
93              comma separated.
94
95
96       -v, --version
97
98              Display program version.
99
100       -h, --help
101
102              Display help.
103
104

KEYS

106       In  session,  the following key sequences are intercepted
107       as tio commands:
108
109       ctrl-t ?        List available key commands
110
111       ctrl-t b        Send  serial  break  (triggers  SysRq  on
112                       Linux, etc.)
113
114       ctrl-t c        Show  configuration  (baudrate, databits,
115                       etc.)
116
117       ctrl-t e        Toggle local echo mode
118
119       ctrl-t h        Toggle hexadecimal mode
120
121       ctrl-t l        Clear screen
122
123       ctrl-t q        Quit
124
125       ctrl-t s        Show TX/RX statistics
126
127       ctrl-t t        Send ctrl-t key code
128
129

EXAMPLES

131       Typical use is without options. For example:
132
133              tio /dev/ttyUSB0
134
135       Which corresponds to the commonly used options:
136
137              tio  -b  115200  -d  8  -f  none  -s  1  -p   none
138              /dev/ttyUSB0
139
140       It  is  recommended  to connect serial tty devices by ID.
141       For example:
142
143              tio
144              /dev/serial/by-id/usb-FTDI_TTL232R-3V3_FTGQVXBL-if00-port0
145
146       Using serial devices by ID ensures that tio automatically
147       reconnects  to the correct serial device if the device is
148       disconnected and then reconnected.
149
150

WEBSITE

152       Visit https://tio.github.io
153
154

AUTHOR

156       Written by Martin Lund <martin.lund@keep-it-simple.com>.
157
158
159
160                                   June 2018                            tio(1)