sterm.man

   1 .\" vim: ft=groff
   2 .\" Manpage for sterm.
   3 .TH sterm 1 "16 September 2016" "16102015"
   4 .SH NAME
   5 sterm \- simple serial terminal
   6 .SH SYNOPSIS
   7 sterm [OPTION]... DEVICE
   8 .SH DESCRIPTION
   9 .PP
  10 sterm is simple program for communication over serial line. It can be
  11 used in scripts or directly as interactive terminal. It also allows to
  12 control DTR and RTS signals with command line options.
  13 .PP
  14 In interactive mode all keys (including '^C') are sent trough the
  15 serial connection. To exit the program there is special key
  16 sequence: '<Enter>~.'
  17 .SH OPTIONS
  18 .TP
  19 \fB\-c\fR
  20 Enter command mode. See COMMAND MODE section below.
  21 .TP
  22 \fB\-d[PULSE]\fR
  23 Make pulse on DTR. The PULSE parameter (see below) specifies the
  24 length of the pulse and its polarity.
  25 .TP
  26 \fB\-e\fR
  27 Ignore '~.' escape sequence. Be aware that this locks your terminal to
  28 sterm, the only way to exit sterm is is to kill it from other
  29 terminal. This can be desirable in scripts, specially if you are
  30 sending binary data trough serial terminal.
  31 .TP
  32 \fB\-n\fR
  33 Don't switch user's terminal to raw mode. This is useful if you want
  34 to use '^C' to exit sterm or to use line buffering/editing features of
  35 TTYs.
  36 .TP
  37 \fB\-r[PULSE]\fR
  38 Make pulse on RTS. The PULSE parameter (see below) specifies the
  39 length of the pulse and its polarity.
  40 .TP
  41 \fB\-s <baudrate>\fR
  42 Set serial like baudrate to the given value. Here are few common
  43 values: 4800, 9600, 19200, 115200. For full list of supported
  44 baudrates see source files or test what is acceptable.
  45
  46 .TP
  47 \fB\-v\fR
  48 Be verbose.
  49 .SH PULSE
  50
  51 Options \fB\-d\fR and \fB\-r\fR take an optional argument PULSE that
  52 specifies pulse length and polarity. PULSE can be one of the
  53 following:
  54
  55 a number
  56 .RS
  57 Absolute value of the number specifies the length of the pulse in
  58 milliseconds and sign, which can be either '+' or '-', corresponds to
  59 positive or negative polarity.
  60 .RE
  61
  62 \'+' or '-'
  63 .RS
  64 This corresponds to +1 and -1.
  65 .RE
  66
  67 empty
  68 .RS
  69 This corresponds -1.
  70 .RE
  71
  72 .SH COMMAND MODE
  73 Command mode allows you to generate arbitrary combinations of pulses
  74 on DTR and RTS signals. The commands are read from standard input and
  75 are white-space separated. The following commands are understood.
  76
  77 .I dtr PULSE
  78 .RS
  79 Generate a pulse on DTR. The PULSE argument is described in PULSE
  80 section.
  81 .RE
  82 .I rts PULSE
  83 .RS
  84 Generate a pulse on RTS. The PULSE argument is described in PULSE
  85 section.
  86 .RE
  87 .I go
  88 .RS
  89 Exit command mode and enter normal sterm operation.
  90 .RE
  91
  92 Any other input in the command mode raises an error and causes the
  93 program to exit.
  94
  95 .SH BUGS
  96 No known bugs.
  97
  98 .SH SEE ALSO
  99 .BR minicom (1),
 100 .BR cu (1),
 101 .BR gtkterm (1).
 102 .SH AUTHOR
 103 Michal Sojka (sojkam1@fel.cvut.cz)