This commit is contained in:
wb2osz 2023-03-05 15:06:07 +00:00
parent 8cb73d2507
commit 8a978876bd
1 changed files with 27 additions and 16 deletions

View File

@ -29,16 +29,21 @@
%C%# Extensive documentation can be found here: %C%# Extensive documentation can be found here:
%C%# Stable release - https://github.com/wb2osz/direwolf/tree/master/doc %C%# Stable release - https://github.com/wb2osz/direwolf/tree/master/doc
%C%# Latest development - https://github.com/wb2osz/direwolf/tree/dev/doc %C%# Latest development - https://github.com/wb2osz/direwolf/tree/dev/doc
%C%# Additional topics - https://github.com/wb2osz/direwolf-doc
%C%# %C%#
%W%# The complete documentation set can also be found in the doc folder. %W%# The basic documentation set can also be found in the doc folder.
%L%# The complete documentation set can also be found in %L%# The basic documentation set can also be found in
%L%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/ %L%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
%L%# Concise "man" pages are also available for Linux. %L%# Concise "man" pages are also available for Linux.
%M%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/ %M%# /usr/local/share/doc/direwolf/ or /usr/share/doc/direwolf/
%M%# Concise "man" pages are also available for Mac OSX. %M%# Concise "man" pages are also available for Mac OSX.
%C%# %C%#
%C%# Questions??? Join the discussion forum: https://groups.io/g/direwolf
%C%#
%C%#
%C%# This sample file does not have examples for all of the possibilities. %C%# This sample file does not have examples for all of the possibilities.
%C%# Consult the User Guide for more details on configuration options.%C%# %C%# Consult the User Guide for more details on configuration options
%C%# and other documents for more details for different uses.
%C%# %C%#
%C%# These are the most likely settings you might change: %C%# These are the most likely settings you might change:
%C%# %C%#
@ -231,14 +236,14 @@
%C%# It can be up to 6 letters and digits with an optional ssid. %C%# It can be up to 6 letters and digits with an optional ssid.
%C%# The APRS specification requires that it be upper case. %C%# The APRS specification requires that it be upper case.
%C%# %C%#
%C%# Example (don't use this unless you are me): MYCALL WB2OSZ-5 %C%# Example (don't use this unless you are me): MYCALL WB2OSZ-5
%C%# %C%#
%C% %C%
%C%MYCALL N0CALL %C%MYCALL N0CALL
%C% %C%
%C%# %C%#
%C%# Pick a suitable modem speed based on your situation. %C%# Pick a suitable modem speed based on your situation.
%C%# 1200 Most common for VHF/UHF. Default if not specified. %C%# 1200 Most common for VHF/UHF. This is the default if not specified.
%C%# 2400 QPSK compatible with MFJ-2400, and probably PK232-2400 & KPC-2400. %C%# 2400 QPSK compatible with MFJ-2400, and probably PK232-2400 & KPC-2400.
%C%# 300 Low speed for HF SSB. Default tones 1600 & 1800. %C%# 300 Low speed for HF SSB. Default tones 1600 & 1800.
%C%# EAS Emergency Alert System (EAS) Specific Area Message Encoding (SAME). %C%# EAS Emergency Alert System (EAS) Specific Area Message Encoding (SAME).
@ -263,6 +268,10 @@
%C% %C%
%C%#DTMF %C%#DTMF
%C% %C%
%C%# Push to Talk (PTT) can be confusing because there are so many different cases.
%C%# Radio-Interface-Guide.pdf in https://github.com/wb2osz/direwolf-doc
%C%# goes into detail about the various options.
%C%
%L%# If using a C-Media CM108/CM119 or similar USB Audio Adapter, %L%# If using a C-Media CM108/CM119 or similar USB Audio Adapter,
%L%# you can use a GPIO pin for PTT control. This is very convenient %L%# you can use a GPIO pin for PTT control. This is very convenient
%L%# because a single USB connection is used for both audio and PTT. %L%# because a single USB connection is used for both audio and PTT.
@ -290,6 +299,7 @@
%C%#PTT COM1 RTS %C%#PTT COM1 RTS
%C%#PTT COM1 RTS -DTR %C%#PTT COM1 RTS -DTR
%L%#PTT /dev/ttyUSB0 RTS %L%#PTT /dev/ttyUSB0 RTS
%L%#PTT /dev/ttyUSB0 RTS -DTR
%C% %C%
%L%# %L%#
%L%# On Linux, you can also use general purpose I/O pins if %L%# On Linux, you can also use general purpose I/O pins if
@ -301,7 +311,7 @@
%L% %L%
%L%#PTT GPIO 25 %L%#PTT GPIO 25
%L% %L%
%C%# The Data Carrier Detect (DCD) signal can be sent to the same places %C%# The Data Carrier Detect (DCD) signal can be sent to most of the same places
%C%# as the PTT signal. This could be used to light up an LED like a normal TNC. %C%# as the PTT signal. This could be used to light up an LED like a normal TNC.
%C% %C%
%C%#DCD COM1 -DTR %C%#DCD COM1 -DTR
@ -374,7 +384,6 @@
%C%# %C%#
%C%# 0 - Don't try to repair. %C%# 0 - Don't try to repair.
%C%# 1 - Attempt to fix single bit error. (default) %C%# 1 - Attempt to fix single bit error. (default)
%C%# ... see User Guide for more values and in-depth discussion.
%C%# %C%#
%C% %C%
%C%#FIX_BITS 0 %C%#FIX_BITS 0
@ -399,15 +408,21 @@
%C%# Example: %C%# Example:
%C%# %C%#
%C%# This results in a broadcast once every 10 minutes. %C%# This results in a broadcast once every 10 minutes.
%C%# Every half hour, it can travel via two digipeater hops. %C%# Every half hour, it can travel via one digipeater hop.
%C%# The others are kept local. %C%# The others are kept local.
%C%# %C%#
%C% %C%
%C%#PBEACON delay=1 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" via=WIDE1-1,WIDE2-1 %C%#PBEACON delay=1 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" via=WIDE1-1
%C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" %C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
%C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA" %C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W power=50 height=20 gain=4 comment="Chelmsford MA"
%C% %C%
%C% %C%#
%C%# Did you know that APRS comments and messages can contain UTF-8 characters, not only plain ASCII?
%C%#
%C%#PBEACON delay=1 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W 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"
%C%#PBEACON delay=11 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W 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"
%C%#PBEACON delay=21 every=30 overlay=S symbol="digi" lat=42^37.14N long=071^20.83W 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"
%C%#
%C%# With UTM coordinates instead of latitude and longitude. %C%# With UTM coordinates instead of latitude and longitude.
%C% %C%
%C%#PBEACON delay=1 every=10 overlay=S symbol="digi" zone=19T easting=307477 northing=4720178 %C%#PBEACON delay=1 every=10 overlay=S symbol="digi" zone=19T easting=307477 northing=4720178
@ -448,12 +463,6 @@
%C%# See User Guide for more explanation of what this means and how %C%# See User Guide for more explanation of what this means and how
%C%# it can be customized for your particular needs. %C%# it can be customized for your particular needs.
%C% %C%
%C%# Filtering can be used to limit was is digipeated.
%C%# For example, only weather weather reports, received on channel 0,
%C%# will be retransmitted on channel 1.
%C%#
%C%
%C%#FILTER 0 1 t/wn
%C% %C%
%C%# Traditional connected mode packet radio uses a different %C%# Traditional connected mode packet radio uses a different
%C%# type of digipeating. See User Guide for details. %C%# type of digipeating. See User Guide for details.
@ -487,6 +496,7 @@
%C%# without sending it over the air and relying on someone else to %C%# without sending it over the air and relying on someone else to
%C%# forward it to an IGate server. This is done by using sendto=IG rather %C%# forward it to an IGate server. This is done by using sendto=IG rather
%C%# than a radio channel number. Overlay R for receive only, T for two way. %C%# than a radio channel number. Overlay R for receive only, T for two way.
%C%# There is no need to send it as often as you would over the radio.
%C% %C%
%C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=R lat=42^37.14N long=071^20.83W %C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=R lat=42^37.14N long=071^20.83W
%C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=T lat=42^37.14N long=071^20.83W %C%#PBEACON sendto=IG delay=0:30 every=60:00 symbol="igate" overlay=T lat=42^37.14N long=071^20.83W
@ -502,6 +512,7 @@
%C%# The IGate function will limit the number of packets transmitted %C%# The IGate function will limit the number of packets transmitted
%C%# during 1 minute and 5 minute intervals. If a limit would %C%# during 1 minute and 5 minute intervals. If a limit would
%C%# be exceeded, the packet is dropped and message is displayed in red. %C%# be exceeded, the packet is dropped and message is displayed in red.
%C%# This might be low for APRS Thursday when there is abnormally high activity.
%C% %C%
%C%IGTXLIMIT 6 10 %C%IGTXLIMIT 6 10
%C% %C%