Scroll to navigation

GRABSERIAL(1) General Commands Manual GRABSERIAL(1)

NAME

grabserial - Serial line reader

SYNOPSIS

grabserial

DESCRIPTION

Grabserial is a small program which reads a serial port and writes the data to standard output. The main purpose of this tool is to collect messages written to the serial console from a target board running Linux, and save the messages on a host machine.

USAGE

grabserial [options] <config_file>

OPTIONS

-h, --help
Print this message
-d, --device=<devpath>
Set the device to read (default '/dev/ttyS0')
-b, --baudrate=<val>
Set the baudrate (default 115200)
-w, --width=<val>
Set the data bit width (default 8)
-p, --parity=<val>
Set the parity (default N)
-s, --stopbits=<val>
Set the stopbits (default 1)
-x, --xonxoff
Enable software flow control (default off)
-r, --rtscts
Enable RTS/CTS flow control (default off)
-f, --force-reset
Force pyserial to reset device parameters
--endtime=<secs>
End the program after the specified seconds have elapsed.
--command=<cmd>
Send a command to the port before reading
-t, --time
Print time for each line received. The time is when the first character of each line is received by grabserial
--systime
Print system time for each line received. The time is the absolute local time when the first character of each line is received by grabserial
-m, --match=<pat>
Specify a regular expression pattern to match to set a base time. Time values for lines after the line matching the pattern will be relative to this base time.
-i, --instantpat=<pat>
Specify a regular expression pattern to have its time reported at end of run. Works mid-line.
-q, --quitpat=<pat>
Specify a regular expression pattern to end the program. Works mid-line.
-l, --launchtime
Set base time from launch of program.
-o, --output=<name>
Output data to the named file.
-v, --verbose
Show verbose runtime messages
-V, --version
Show version number and exit

Exapmle

grabserial -e 30 -t -m ^Linux version.*
This will grab serial input for 30 seconds, displaying the time for each line, and re-setting the base time when the line starting with "Linux version" is seen.

AUTHOR

This manual page was written by Nobuhiro Iwamatsu <iwamatsu@debian.org>, for the Debian GNU/Linux system (but may be used by others).
MAY 2015