5. Now you need to configure dixprs using the example configuration file.
It is located at /usr/local/dixprs and we use the config-kiss.txt sample.
We will rename it to config.txt. This file (config.txt) will be called when dixprs starts.
$ sudo cp /usr/local/dixprs/config-kiss.txt /usr/local/dixprs/config.txt
6. The config.txt file is human readable and needs to be edited with a text editor like nano or leafpad. Below are the key parts of the config.txt needed for a TNC-PI
####################
[RADIO]
# Mandatory parameters
# Interface type
INTERFACE=KISS
# Serial port
PORT=/dev/ttyAMA0
# Serial port speed
SPEED=19200
After adapting your personal data, such as call sign etc, pay attention to the radio part. It should look as follows: Changes marked as %%%% FILL YOUR DATA HERE %%%% should be filled with your specific information. For optional parameters remove the leading # and include the appropriate parameter value.
<y/n> – use y or 1 to enable, n or 0 to disable
<str> – ASCII text, case sensitive
<call> – callsign with optional SSID, case insensitive
<fv> – floating point value with decimal point
<n> – integer number
<xy> – two-letters string, case sensitive
<host> – domain name or IP address
<adrlst> – comma separated list of host IP and port addresses in ip:port format, e.g. 127.0.0.1:8889
[GENERAL]
# Mandatory parameters
# Your callsign with SSID
CALLSIGN= %%%% FILL YOUR DATA HERE %%%%
# Degrees; West is negative, East is positive
LONGITUDE= %%%% FILL YOUR DATA HERE %%%%
easy to do from aprs.fi – use the decimal like LONGITUDE=06.7580 SAME FOR LATITUDE
# Degrees; South is negative, North is posittive
LATITUDE= %%%% FILL YOUR DATA HERE %%%%
# Optional parameters
# Station height above the see level in meters; no default
#ASL= %%%% FILL YOUR DATA HERE %%%%
# Owner name and contact; no default
#OWNER=<str>
# Spool directory to import packets; no default
#SPOOL=<path>
# Station symbol; default is S#
# SYMBOL
# UDP port base number; default is 31110
#UDPBASE=<n>
# Beacon frequency in minutes; default is 30
#BCNTIME=<n>
# Beacon text; %v replaced with actual version string; default is %v
# Used as default for ISGW and RADIO
#BCNTXT=<str>
# Select km/mi on monitor and in DX list; default is y (km)
#METRIC=<y/n>
# Max number of digis passed for local stations
# Used as message gating condition for gating to Rf
# Default value is 2
#LOCALHOPS=<n>
# Range in km within messages gated to Rf
# If defined, checked after hop count (local) check
# No default
#MSGRANGE=<fv>
#################################################################
# #
# IS gateway settings; remove this section to disable GW #
# #
#################################################################
[ISGW]
# Mandatory parameters
# Domain name of IS server to connect
host=rotate.aprs2.net %%%% HOST SHOULD BE LIKE THIS %%%%
# Optional parameters
# Port number; default is 14580
#PORT=<n>
# Filter; default is r/@/150
# @ is replaced with station position
#FILTER=<str>
#################################################################
# #
# WRB server settings; remove this section to disable it #
# #
#################################################################
[WEBSERVER]
# Mandatory parameters
# WEB server port, no default
port=9999
#################################################################
# #
# Radio port configuration settings; repeat section for #
# multiple ports #
# #
#################################################################
[RADIO]
# Mandatory parameters
# Interface type
INTERFACE=KISS %%%% SHOULD BE LIKE THIS %%%%
# Serial port
PORT=/dev/ttyAMA0 %%%% SHOULD BE LIKE THIS %%%%
# Serial port speed
SPEED=19200 %%%% SHOULD BE LIKE THIS %%%%
# Optional parameters
# Modem speed, default is 1200
#SIGNALRATE=1200
# Enable/disable NWS WX bulletin and object gating from IS to Rf
# Disabled by default
#GATENWS=<y/n>
# Enable/disable BOM WX bulletin and object gating from IS to Rf
# Disabled by default
# GATEBOM=<y/n>
# Descripton of port; no default
DESCRIPTION=TNC-PI KISS 19200 %%%% CAN BE LIKE THIS %%%%
# Via used to send locally generated packets; default is WIDE1-1,WIDE2-2
#AXVIA=<lst>
# Digipeaters processed with WIDEn-n algorithm; default is WIDE1,WIDE2
#WIDEN=<lst>
# Blacklisted stations; they are not digipeated, not gated; default is NOCALL,N0CALL
#BLACKLIST=<lst>
# PHG string, do not mix with range; no default
#PHG=<str>
# Range value in miles, do not mix with PHG; no default
RNG=30
# Enable/disable transmission; change it to PTTON=1 to enable transmission; default is no
PTTON=1 %%%% CAN BE LIKE THIS %%%%
# Gate locally generated frames to IS gateway; default is no
# Useful for rx-only radio ports
# Experimental, use carefully
# GATELOCAL=<y/n>
# Gate digipeated frames to IS gateway; default is no
# Experimental, use carefully
# GATEDIGI=<y/n>
# Beacon text; %v replaced with actual version string; default is %v
#BCNTXT=<str> %%%%PLACE YOUR OWN BEACON STRING HERE%%%%
# Enable/disable digipeater; default is enabled
#DIGIPEATER=<y/n>
# KISS TNC setup parameters 0…255; no defaults
# Use to setup TNC by DIXPRS
#TXD=<n>
#PPERSIST=<n>
#SLOTTIME=<n>
#TXTAIL=<n>
#DUPLEX=<n>
# Below these are the traffic shaping settings for gating messages
# From IS to Rf
#
# For advanced users only; do not change if you do not know how
# traffic shaping works and if you do not have good reason !!!
# Traffic shaping high treshold, default is 0.75
#TRAFFICHIGH=<fv>
# Traffic shaping low treshold, default is 0.5
#TRAFFIClow=<fv>
# Traffic shaping transmission delay, default is 5.0 sec
#TRAFFICDELAY=<fv>
# Comma separated list of addresses to send received/transmitted frames
# in hostip:port format. No default.
# UDPCC=<adrlst>
Now save your modified config.txt file and you’re ready to test dixprs operation.
Click HERE to learn how to test your DIXPRS configuration.