.\"                                      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 MULTIMON 1 "June 19, 2000"
.\" 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
multimon \- program to decode radio transmissions
.SH SYNOPSIS
.B multimon
.RI [ options ]\ [input_file]
.SH DESCRIPTION
This manual page documents briefly the
.B multimon
command.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
The \fBmultimon\fP software can decode a variety of digital transmission modes commonly found on UHF radio. A standard PC soundcard is used to acquire the signal from a transceiver. The decoding is done completely in software. Currently, the following modes are supported:
.PP
.TP
    * AX.25
          o 1200 Baud AFSK
          o 2400 Baud AFSK (2 variants)
          o 4800 Baud HAPN
          o 9600 Baud FSK (G3RUH)
.TP
    * POCSAG
          o 512 Baud
          o 1200 Baud
          o 2400 Baud
.TP
    * Miscellaneous
          o DTMF
          o ZVEI
          o SCOPE
.PP
An arbitrary set of the above modes may run concurrently on the same input signal (provided the CPU power is sufficient), so you do not have to know in advance which mode is used. Note however that some modes might require modifications to the radio (especially the 9600 baud FSK and the POCSAG modes) to work properly.
.PP
AX.25 - Amateur Packet Radio protocol datagram format
.br
POCSAG (Post Office Code Standards Advisory Group) is a common paging transmission format.
.br
DTMF - Dual Tone Multi Frequency. Commonly used in in-band telephone dialing.
.br
ZVEI- The German Electrical and Electronic Manufacturers' Association - paging tone format.
.br
SCOPE - show samples in a rudimentary oscilloscope display on an X server.
.PP
Multimon does not decode Morse code signals.
.SH OPTIONS
.TP
.B  \-t <type>
input file type (any other type than raw requires sox)
.br
allowed types: raw aiff au hcom sf voc cdr dat smp wav maud vwe
.TP
.B  \-a <demod>
add demodulator
.TP
.B  \-s <demod>
subtract demodulator
.TP
.B  \-v <num>
verbosity level (0-10)
.TP
.B  \-q
quiet output messages
.PP
Where <demod> is one of:
POCSAG512 POCSAG1200 POCSAG2400 EAS AFSK1200 AFSK2400 AFSK2400_2 HAPN4800 FSK9600 DTMF ZVEI SCOPE
.br
The \-a and \-s options may be given multiple times to specify the desired list of demodulators.
.SH EXAMPLE
Decode signal modulations from a sound file /tmp/message.wav without using a SCOPE display:
.br
multimon \-s SCOPE \-t wav /tmp/message.wav
.PP
With no input file specified, the program listens directly to the sound card using the /dev/dsp interface.
So to decode (only) DTMF tones on the sound card input:
.br
multimon -a DTMF
.SH NOTICE
Please note that monitoring commercial services may be prohibited in some countries, this software should therefore
only be used to monitor the amateur radio service.
.SH SEE ALSO
.BR gen(1)
.BR http://www.qsl.net/kb9mwr/projects/pager/Two-Tone%20Pager%20Decoding%20Using%20Multimon.pdf
.SH BUGS
The DTMF and ZVEI decoders have more frequent spurious detection reports.
.SH AUTHOR
This manual page was written by A. Maitland Bottoms <bottoms@debian.org>,
for the Debian GNU/Linux system (but may be used by others).