direwolf(1)

1DIREWOLF(1)                 General Commands Manual                DIREWOLF(1)
2
3
4

NAME

6       direwolf - Soundcard TNC for packet radio.
7
8
9

SYNOPSIS

11       direwolf [ options ] [ - | udp:9999 ]
12
13       The first audio channel can be streamed thru stdin or a UDP port.  This
14       is typically used with an SDR receiver.
15
16
17

DESCRIPTION

19       direwolf  is a software "soundcard" modem/TNC and APRS encoder/decoder.
20       It  can  be used stand-alone to receive APRS messages, as a digipeater,
21       APRStt gateway, or Internet Gateway (IGate).  It can also be used as  a
22       virtual TNC for other applications such as APRSIS32, UI-View32, Xastir,
23       APRS-TW, YAAC, UISS, Linux AX25, SARTrack, RMS Express, and  many  oth‐
24       ers.
25
26
27

OPTIONS

29       -c file
30              Read  configuration file from specified location rather than the
31              default locations.
32
33
34       -l logdir
35              Generate daily log files in specified directory.   Use  "."  for
36              current directory.
37
38
39       -L logfile
40              Generate single log file with fixed name.
41
42
43       -r n   Audio sample rate per second for first channel.  Default 44100.
44
45
46       -n n   Number of audio channels for first device.  1 or 2.  Default 1.
47
48
49       -b n   Audio sample size for first channel.  8 or 16.  Default 16.
50
51
52       -B n   Data  rate  in  bits/sec for first channel.  Standard values are
53              300, 1200, 2400, 4800, 9600.
54                     300 bps defaults to AFSK tones of 1600 & 1800.
55                     1200 bps uses AFSK tones of 1200 & 2200.
56                     2400 bps uses QPSK based on V.26 standard.
57                     4800 bps uses 8PSK based on V.27 standard.
58                     9600 bps and up uses K9NG/G3RUH standard.
59                     AIS for ship Automatic Identification System.
60                     EAS for Emergency Alert System (EAS) Specific  Area  Mes‐
61                     sage Encoding (SAME).
62
63
64       -g     Force G3RUH modem regardless of data rate.
65
66
67       -j     2400 bps QPSK compatible with Dire Wolf <= 1.5.
68
69
70       -J     2400 bps QPSK compatible with MFJ-2400.
71
72
73       -D n   Divide audio sample by n for first channel.
74
75
76       -X n   1 to enable FX.25 transmit.
77
78
79       -d x   Debug options.  Specify one or more of the following in place of
80              x.
81                     a = AGWPE network protocol client.
82                     k = KISS serial port client.
83                     n = Network KISS client.
84                     u = Display non-ASCII text in hexadecimal.
85                     p = Packet dump in hexadecimal.
86                     g = GPS interface.
87                     W = Waypoints for position or object reports.
88                     t = Tracker beacon.
89                     o = Output controls such as PTT and DCD.
90                     i = IGate
91                     h = Hamlib verbose level.  Repeat for more.
92                     m = Monitor heard station list.
93                     f = Packet filtering.
94                     x = FX.25 increase verbose level.
95
96
97       -q x   Quiet (suppress output). Specify one or more of the following in
98              place of x.
99                     h = Heard line with the audio level.
100                     d = Decoding of APRS packets.
101
102
103       -t n   Text  colors.   0=disabled.  1=default.  2,3,4,... alternatives.
104              Use 9 to test compatibility with your terminal.
105
106
107
108       -p     Enable pseudo terminal for KISS protocol.
109
110
111       -x     Send Xmit level calibration tones.
112
113
114       -U     Print UTF-8 test string and exit.
115
116
117       -S     Print Symbol tables and exit.
118
119
120       -a n   Report audio device statistics each n seconds.
121
122
123       -T fmt Time stamp format for sent and received frames.
124
125
126       -e ber Receive Bit Error Rate (BER), e.g. 1e-5
127
128

EXAMPLES

130       gqrx (2.3 and later) has the ability to send streaming audio through  a
131       UDP socket to another application for further processing.  direwolf can
132       listen over a UDP port with options like this:
133
134              direwolf -n 1 -r 48000 -b 16 udp:7355
135
136       Other SDR applications might produce audio on stdout so  it  is  conve‐
137       nient  to  pipe  into the next application.  In this example, the final
138       "-" means read from stdin.
139
140              rtl_fm -f 144.39M -o 4 - | direwolf -n 1 -r 24000 -b 16 -
141
142
143

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO