############################################################# # # # Sample configuration file for Dire Wolf # # # # Linux version # # # ############################################################# # # Extensive documentation can be found here: # Stable release - https://github.com/wb2osz/direwolf/tree/master/doc # Latest development - https://github.com/wb2osz/direwolf/tree/dev/doc # Additional topics - https://github.com/wb2osz/direwolf-doc # # The basic documentation set can also be found in # /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/ # Concise "man" pages are also available for Linux. # ######################################################################### # # # Recommended Reading for everyone: # # "Understanding APRS Packets" in https://github.com/wb2osz/aprsspec # # # ######################################################################### # # # Questions??? Join the discussion forum: https://groups.io/g/direwolf # # # This sample file does not have examples for all of the possibilities. # Consult the User Guide for more details on configuration options # and other documents for more details for different uses. # # These are the most likely settings you might change: # # (1) MYCALL - call sign and SSID for your station. # # Look for lines starting with MYCALL and # change NOCALL to your own callsign and optional SSID. # # (2) PBEACON - enable position beaconing. # # Look for lines starting with PBEACON and # modify for your location, symbol, comment, etc. # # (3) DIGIPEATER - configure digipeating rules. # # Look for lines starting with DIGIPEATER. # Most people will probably use of of the two examples. # # (4) IGSERVER, IGLOGIN - IGate server and login # # Configure an IGate client to relay messages between # radio and internet servers. # # # The default location is "direwolf.conf" in the current working directory. # On Linux, the user's home directory will also be searched. # An alternate configuration file location can be specified with the "-c" command line option. # # As you probably guessed by now, # indicates a comment line. # # Remove the # at the beginning of a line if you want to use a sample # configuration that is currently commented out. # # Commands are a keyword followed by parameters. # # Command key words are case insensitive. i.e. upper and lower case are equivalent. # # Command parameters are generally case sensitive. i.e. upper and lower case are different. # ############################################################# # # # FIRST AUDIO DEVICE PROPERTIES # # (Channel 0 or 0 + 1 if in stereo) # # # ############################################################# # # Many people will simply use the default sound device. # Some might want to use an alternative device by choosing it here. # # # Many examples of radio interfaces and PTT options can be found in: # https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf # # # Linux ALSA is complicated. See User Guide for discussion. # To use something other than the default, generally use plughw # and a card number reported by "arecord -l" command. Example: ADEVICE plughw:0,0 # Many more details and examples can be found in: # https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf ############################################################# # # # CHANNEL 0 PROPERTIES # # # ############################################################# CHANNEL 0 # # Station identifier for this channel. # Multiple channels can have the same or different names. # # It can be up to 6 letters and digits with an optional ssid in range of 1 to 15. # The APRS specification requires that it be upper case. # # Example (don't use this unless you are me): MYCALL WB2OSZ-5 # MYCALL NOCALL # # Pick a suitable modem speed based on your situation. # 1200 Most common for VHF/UHF. This is the default if not specified. # 2400 QPSK compatible with MFJ-2400, and probably PK232-2400 & KPC-2400. # 300 Low speed for HF SSB. Default tones 1600 & 1800. # EAS Emergency Alert System (EAS) Specific Area Message Encoding (SAME). # 9600 G3RUH style - Can't use Microphone and Speaker connections. # AIS International system for tracking ships on VHF. # Also uses 9600 bps so Speaker connection won't work. # # In most cases you can just specify the speed. Examples: # #MODEM 300 #MODEM 9600 MODEM 1200 # # Many options are available for great flexibility. # See User Guide for details. # # Push to Talk (PTT) can be confusing because there are so many different cases. # https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf # goes into detail about the various options. # If using a C-Media CM108/CM119 or similar USB Audio Adapter, # you can use a GPIO pin for PTT control. This is very convenient # because a single USB connection is used for both audio and PTT. # Example: PTT CM108 # There are other possibilities such as serial port RTS, Raspberry Pi GPIO pins, # and hamlib for CAT control. For more details see: # https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Radio-Interface-Guide.pdf ############################################################# # # # VIRTUAL TNC SERVER PROPERTIES # # # ############################################################# # # Dire Wolf acts as a virtual TNC and can communicate with # client applications by different protocols: # # - the "AGW TCPIP Socket Interface" - default port 8000 # - KISS protocol over TCP socket - default port 8001 # - KISS TNC via pseudo terminal (-p command line option) # # ############################################################# # # # FIXED POSIION BEACONING PROPERTIES # # # ############################################################# # # Beaconing is configured with these two commands: # # PBEACON - for a position report (usually yourself) # OBEACON - for an object report (usually some other entity) # # Each has a series of keywords and values for options. # See User Guide for details. # # Example: Change the latitude and longitude or your location # will show you about to go over Niagara Falls. # PBEACON delay=1 every=1 overlay=S symbol="digi" lat=38.857108 long=-104.811041 power=5 gain=4 comment="Packet Radio Test" via=WIDE1-1 # Run "direwolf -S" (upper case S) to get a list of symbols that can # be used rather than "canoe." Specify a unique substring of description. # # Did you know that APRS comments and messages can contain UTF-8 characters, not only plain ASCII? # #PBEACON delay=1 every=30 overlay=S symbol="digi" lat=43.077104 long=-79.075674 comment=" Did you know that APRS comments and messages can contain UTF-8 characters? \xe0\xb8\xa7\xe0\xb8\xb4\xe0\xb8\x97\xe0\xb8\xa2\xe0\xb8\xb8\xe0\xb8\xaa\xe0\xb8\xa1\xe0\xb8\xb1\xe0\xb8\x84\xe0\xb8\xa3\xe0\xb9\x80\xe0\xb8\xa5\xe0\xb9\x88\xe0\xb8\x99" #PBEACON delay=11 every=30 overlay=S symbol="digi" lat=43.077104 long=-79.075674 comment=" Did you know that APRS comments and messages can contain UTF-8 characters? \xce\xa1\xce\xb1\xce\xb4\xce\xb9\xce\xbf\xce\xb5\xcf\x81\xce\xb1\xcf\x83\xce\xb9\xcf\x84\xce\xb5\xcf\x87\xce\xbd\xce\xb9\xcf\x83\xce\xbc\xcf\x8c\xcf\x82" #PBEACON delay=21 every=30 overlay=S symbol="digi" lat=43.077104 long=-79.075674 comment=" Did you know that APRS comments and messages can contain UTF-8 characters? \xe3\x82\xa2\xe3\x83\x9e\xe3\x83\x81\xe3\x83\xa5\xe3\x82\xa2\xe7\x84\xa1\xe7\xb7\x9a" # ############################################################# # # # APRS DIGIPEATER PROPERTIES # # # ############################################################# # # Remove the "#" from the beginning of the first digipeat below for short range fill-in digi # or remove the "#" from the beginning of the second digipeat below for wide area digi. #DIGIPEAT 0 0 ^TEST$ ^WIDE1-1$ #DIGIPEAT 0 0 ^WIDE[3-7]-[1-7]$|^TEST$ ^WIDE[12]-[12]$ # See https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/APRS-Digipeaters.pdf # and User Guide for more explanation of what this means and # how it can be customized for your particular needs. # Traditional connected mode packet radio uses a different # type of digipeating. See User Guide for details. ############################################################# # # # INTERNET GATEWAY # # # ############################################################# # First you need to specify the name of a Tier 2 server. # The current preferred way is to use one of these regional rotate addresses: # noam.aprs2.net - for North America # soam.aprs2.net - for South America # euro.aprs2.net - for Europe and Africa # asia.aprs2.net - for Asia # aunz.aprs2.net - for Oceania #IGSERVER noam.aprs2.net # You also need to specify your login name and passcode. # Contact the author if you can't figure out how to generate the passcode. #IGLOGIN WB2OSZ-5 123456 # That's all you need for a receive only IGate which relays # messages from the local radio channel to the global servers. # To relay APRS "messages" from the Internet to radio, you need to add # one more option with the transmit channel number and a VIA path. #IGTXVIA 0 WIDE1-1,WIDE2-1 # For more information see # https://raw.githubusercontent.com/wb2osz/direwolf-doc/main/Successful-APRS-IGate-Operation.pdf ############################################################# # # # APRStt GATEWAY # # # ############################################################# # # Dire Wolf can receive DTMF (commonly known as Touch Tone) # messages and convert them to packet objects. Details in: # # https://raw.githubusercontent.com/wb2osz/direwolf/master/doc/APRStt-Implementation-Notes.pdf # FX25TX 1 PERSIST 63 SLOTTIME 12 RETRY 5 FRACK 3 MAXFRAME 4 PACLEN 128 DWAIT 0 TXDELAY 30 TXTAIL 15