direwolf/man1/gen_packets.1

113 lines
2.5 KiB
Groff

.TH GEN_PACKETS 1
.SH NAME
gen_packets \- Generate audio file for AX.25 frames.
.SH SYNOPSIS
.B gen_packets -o
.I wav-file-out
[ \fIoptions\fR ] [ \fItext-file\fR | - ]
.RS
.P
\fIwav-file-out\fR is the result. The -o option is required.
.P
\fItext-file\fR may contain AX.25 packets in the standard monitoring format. Use "-" to read from stdin. If not specified, a default builtin message will be used.
.RE
.SH DESCRIPTION
\fBgen_packets\fR is a test application which converts text to AX.25 audio for testing packet decoders.
It is very flexible allowing a wide range of audio sample rates, data speeds, and AFSK tones. It will even generate the scrambled signals commonly used for 9600 baud operation.
.SH OPTIONS
.TP
.BI "-a " "n"
Signal amplitude in range of 0 - 200%. Default 50. Note that 100% is corresponds to signal peaks of +/- 16383 so we have plenty of headroom to avoid saturation.
.TP
.BI "-b " "n"
Bits / second for data. Default is 1200.
.TP
.BI "-B " "n"
Bits / second for data. Proper modem selected for 300, 1200, 9600.
.TP
.BI "-g"
Scrambled baseband rather than AFSK.
.TP
.BI "-m " "n"
Mark frequency. Default is 1200.
.TP
.BI "-s " "n"
Space frequency. Default is 2200.
.TP
.BI "-r " "n"
Audio sample Rate. Default is 44100.
.TP
.BI "-n " "n"
Generate specified number of frames with increasing noise. (For built-in message only.)
.TP
.BI "-o " "file"
Send output to .wav file.
.TP
.B "-8"
8 bit audio rather than 16.
.TP
.B "-2"
2 channels of audio rather than 1.
.SH EXAMPLES
.P
.B gen_packets -o x.wav
.P
.RS
With all defaults, a built-in test message is generated
with standard Bell 202 tones used for packet radio on ordinary
VHF FM transceivers.
.RE
.P
.B gen_packets -o x.wav -g -b 9600
.PD 0
.P
.PD
.B gen_packets -o x.wav -B 9600
.P
.RS
Both of these are equivalent. "-B 9600" automatically selects scrambled baseband rather than AFSK.
.RE
.P
.B gen_packets -o x.wav -m 1600 -s 1800 -b 300
.PD 0
.P
.PD
.B gen_packets -o x.wav -B 300
.P
.RS
Both of these generate 200 Hz shift, 300 baud, suitable for HF SSB transceiver.
.RE
.P
.B echo -n "WB2OSZ>WORLD:Hello, world!" | gen_packets -a 25 -o x.wav -
.P
.RS
Read message from stdin and put quarter volume sound into the file x.wav.
.RE
.P
.SH SEE ALSO
More detailed information is in the pdf files in /usr/local/share/doc/direwolf, or possibly /usr/share/doc/direwolf, depending on installation location.
Applications in this package: aclients, atest, decode_aprs, direwolf, gen_packets, ll2utm, log2gpx, text2tt, tt2text, utm2ll