DIREWOLF(1) | General Commands Manual | DIREWOLF(1) |
NAME¶
direwolf - Soundcard TNC for packet radio.
SYNOPSIS¶
direwolf [ options ] [ - | udp:9999 ]
The first audio channel can be streamed thru stdin or a UDP port. This is typically used with an SDR receiver.
DESCRIPTION¶
direwolf is a software "soundcard" modem/TNC and APRS encoder/decoder. It can be used stand-alone to receive APRS messages, as a digipeater, APRStt gateway, or Internet Gateway (IGate). It can also be used as a virtual TNC for other applications such as APRSIS32, UI-View32, Xastir, APRS-TW, YAAC, UISS, Linux AX25, SARTrack, RMS Express, and many others.
OPTIONS¶
- -c file
- Read configuration file from specified location rather than the default locations.
- -l logdir
- Generate daily log files in specified directory. Use "." for current directory.
- -L logfile
- Generate single log file with fixed name.
- -r n
- Audio sample rate per second for first channel. Default 44100.
- -n n
- Number of audio channels for first device. 1 or 2. Default 1.
- -b n
- Audio sample size for first channel. 8 or 16. Default 16.
- -B n
- Data rate in bits/sec for first channel. Standard values are 300, 1200, 2400, 4800, 9600.
1200 bps uses AFSK tones of 1200 & 2200.
2400 bps uses QPSK based on V.26 standard.
4800 bps uses 8PSK based on V.27 standard.
9600 bps and up uses K9NG/G3RUH standard.
AIS for ship Automatic Identification System.
EAS for Emergency Alert System (EAS) Specific Area Message Encoding (SAME).
- -g
- Force G3RUH modem regardless of data rate.
- -j
- 2400 bps QPSK compatible with Dire Wolf <= 1.5.
- -J
- 2400 bps QPSK compatible with MFJ-2400.
- -D n
- Divide audio sample by n for first channel.
- -X n
- 1 to enable FX.25 transmit.
- -d x
- Debug options. Specify one or more of the following in place of x.
k = KISS serial port client.
n = Network KISS client.
u = Display non-ASCII text in hexadecimal.
p = Packet dump in hexadecimal.
g = GPS interface.
W = Waypoints for position or object reports.
t = Tracker beacon.
o = Output controls such as PTT and DCD.
i = IGate
h = Hamlib verbose level. Repeat for more.
m = Monitor heard station list.
f = Packet filtering.
x = FX.25 increase verbose level.
- -q x
- Quiet (suppress output). Specify one or more of the following in place of x.
d = Decoding of APRS packets.
- -t n
- Text colors. 0=disabled. 1=default. 2,3,4,... alternatives. Use 9 to test compatibility with your terminal.
- -p
- Enable pseudo terminal for KISS protocol.
- -x
- Send Xmit level calibration tones.
- -U
- Print UTF-8 test string and exit.
- -S
- Print Symbol tables and exit.
- -a n
- Report audio device statistics each n seconds.
- -T fmt
- Time stamp format for sent and received frames.
- -e ber
- Receive Bit Error Rate (BER), e.g. 1e-5
EXAMPLES¶
gqrx (2.3 and later) has the ability to send streaming audio through a UDP socket to another application for further processing. direwolf can listen over a UDP port with options like this:
direwolf -n 1 -r 48000 -b 16 udp:7355
Other SDR applications might produce audio on stdout so it is convenient to pipe into the next application. In this example, the final "-" means read from stdin.
rtl_fm -f 144.39M -o 4 - | direwolf -n 1 -r 24000 -b 16 -
SEE ALSO¶
More detailed information is in the PDF files at https://github.com/wb2osz/direwolf/tree/master/doc/.
Applications in this package: aclients, atest, cm108, decode_aprs, direwolf, gen_packets, kissutil, ll2utm, log2gpx, text2tt, tt2text, utm2ll