113 lines
3.0 KiB
Plaintext
113 lines
3.0 KiB
Plaintext
.\" Hey, EMACS: -*- nroff -*-
|
|
.\" First parameter, NAME, should be all caps
|
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
.\" other parameters are allowed: see man(7), man(1)
|
|
.TH MINIMODEM 1 "June 22, 2011"
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
.\"
|
|
.\" Some roff macros, for reference:
|
|
.\" .nh disable hyphenation
|
|
.\" .hy enable hyphenation
|
|
.\" .ad l left justify
|
|
.\" .ad b justify to both left and right margins
|
|
.\" .nf disable filling
|
|
.\" .fi enable filling
|
|
.\" .br insert line break
|
|
.\" .sp <n> insert n+1 empty lines
|
|
.\" for manpage-specific macros, see man(7)
|
|
.SH NAME
|
|
minimodem \- software audio Bell-type or RTTY FSK modem
|
|
.SH SYNOPSIS
|
|
.B minimodem --tx
|
|
.RI [ options ]
|
|
.I {baudmode}
|
|
.br
|
|
.B minimodem --rx
|
|
.RI [ options ]
|
|
.I {baudmode}
|
|
.SH DESCRIPTION
|
|
.B minimodem
|
|
is a command-line program which generates (or decodes) audio modem tones,
|
|
emulating an old Bell-type or radio-teletype FSK modem.
|
|
The tones can be played to (or recorded from) the PulseAudio system
|
|
or to an audio file.
|
|
.PP
|
|
.B minimodem
|
|
can be used to transfer data between nearby computers using an audio
|
|
cable (or just via sound waves), or between remote computers using radio,
|
|
telephone, or another audio communications medium.
|
|
.SH "TX/RX MODE"
|
|
.TP
|
|
.B \-t, \-\-tx, \-\-transmit, \-\-write
|
|
transmit mode: generate audio tones
|
|
.TP
|
|
.B \-r, \-\-rx, \-\-receive, \-\-read
|
|
receive mode: decode audio tones
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-8, \-\-ascii
|
|
ASCII 8\-N\-1
|
|
.TP
|
|
.B \-5, \-\-baudot
|
|
Baudot 5\-N\-1.5
|
|
.TP
|
|
.B \-f, \-\-file filename.wav
|
|
encode or decode an audio file (extension sets audio format)
|
|
.TP
|
|
.B \-b, \-\-bandwidth {rx_bandwidth}
|
|
.TP
|
|
.B \-M, \-\-mark {mark_freq}
|
|
.TP
|
|
.B \-S, \-\-space {space_freq}
|
|
.TP
|
|
.B \-T, \-\-txstopbits {m.n}
|
|
.TP
|
|
.B \-V, \-\-version
|
|
print program version
|
|
.SH {baudmode}
|
|
The required \fI{baudmode}\fR parameter may be any floating-point value to
|
|
specify a baud rate, or the string "rtty".
|
|
The \fI{baudmode}\fR also implies certain other parameter defaults
|
|
depending on the rate.
|
|
.TP
|
|
.B 1200
|
|
: Bell202 1200 bps \-\-ascii
|
|
.TP
|
|
.B 300
|
|
: Bell103 300 bps \-\-ascii (auto-rx-carrier)
|
|
.TP
|
|
.B N>=100
|
|
: Bellxxx N bps \-\-ascii
|
|
.TP
|
|
.B N<100
|
|
: RTTY N bps \-\-baudot
|
|
.TP
|
|
.B rtty
|
|
: RTTY 45.45 bps \-\-baudot
|
|
.SH EXAMPLES
|
|
.TP
|
|
.B minimodem --tx 100
|
|
Transmit 100 baud tones from one computer ...
|
|
.TP
|
|
.B minimodem --rx 100
|
|
and receive 100 baud tones on another nearby computer.
|
|
.TP
|
|
.B minimodem --rx rtty
|
|
Decode amateur radio RTTY signals (listen near 14.085 MHz).
|
|
.SH NOTES
|
|
.B minimodem
|
|
does not decode AX.25 framed packets.
|
|
.PP
|
|
.B minimodem
|
|
does not support modem control ("AT") commands, nor does it produce
|
|
DTMF telephone dialing tones.
|
|
.SH AUTHOR
|
|
.B minimodem
|
|
was written by Kamal Mostafa <kamal@whence.com>.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2011 by Kamal Mostafa <kamal@whence.com>.
|
|
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|