Rpt.conf

Rpt.conf is where the majority of the node configuration occurs. Important node settings such as the node CW and voice ID, touchtone commands and timers are set. The default DIAL rpt.conf is well commented (see rpt.conf on GitHub).

Node Number Stanza

The node number stanza is the first stanza in rpt.conf.

[1999]    ; Replace with your assigned node number

The node number stanza contains following key/value pairs.

althangtime=

This controls the length of the repeater hang time when the alternate hang timer is selected with a control operator function. It is specified in milliseconds.

Sample:

althangtime=4000   ; 4 seconds

beaconing=

When set to 1 will send the repeater ID at the idtime interval regardless of whether there was repeater activity or not. This feature appears to be required in the UK, but is probably illegal in the US.

Sample:

beaconing=1   ;Set to 1 to beacon. Defaults to 0

callerid=

This setting allows the autopatch on the node to be identified with a specific caller ID. The default setting is as follows

callerid="Repeater" <0000000000>

Note: The value in quotes is the name of the autopatch caller, and the numbers in angle brackets are the originating telephone number to use.

context=

This setting directs the autopatch for the node to use a specific context in extensions.conf for outgoing autopatch calls. The default is to specify a context name of radio.

context=radio

controlstates=

This setting defines the name of the variable named control state stanza. Control states are an optional feature which allows groups of control operator commands to be executed all at once. To use control states, define an entry in your node stanzas to point to a dedicated control state stanza like this:

controlstates = controlstates   ; points to control state stanza

[controlstates]
0 = rptena,lnkena,apena,totena,ufena,noicd  ; Normal operation                                  
1 = rptena,lnkena,apdis,totdis,ufena,noice  ; Net and news operation                                             
2 = rptena,lnkdis,apdis,totena,ufdis,noice  ; Repeater only operation

The control state stanza (below) describes these mnemonics.

duplex=

The duplex key/value pairs sets the duplex mode for desired radio operation. Duplex mode 2 is the default if none specified.

Duplex Mode	Description
0	Half duplex with no telemetry tones or hang time. Special Case: Full duplex if linktolink is set to yes. This mode is preferred when interfacing with an external multiport repeater controller. Comment out idrecording and idtalkover to suppress IDs.
1	Half duplex with telemetry tones and hang time. Does not repeat audio. This mode is preferred when interfacing a simplex node.
2	Full Duplex with telemetry tones and hang time. This mode is preferred when interfacing a repeater.
3	Full Duplex with telemetry tones and hang time, but no repeated audio.
4	Full Duplex with telemetry tones and hang time. Repeated audio only when the autopatch is down.

Sample:

duplex = 0     ; 0 = Half duplex with no telemetry tones or hang time.

endchar=

This setting allows the end character used by some control functions to be changed. By default this is a #. The endchar value must not be the same as the funcchar default or overridden value.

erxgain=

Echolink receive gain adjustment in +/- db-volts. Used to balance Echolink recieve audio on an app_rpt node.

erxgain = -3

See Echolink How to

etxgain=

Echolink transmit gain adjustment in +/- db-volts. Used to balance Echolink transmit audio on an app_rpt node.

etxgain = 3

See Echolink How to

funcchar=

This setting can be used to change the default function starting character of * to something else. Please note that the new value chosen must not be the same as the default or overridden value for endchar=.

rxchannel=

The rxchannel key/value pair selects the radio interface. There must be only one rxchannel per node. The selections are:

Value	Description
dahdi/pseudo	No radio, used for hubs
SimpleUSB/usb_1999	SimpleUSB (limited DSP)
Radio/usb_1999	USBRadio (full DSP)
voter/1990	RTCM
Pi/1	Raspberry Pi PiTA
Dahdi/1	PCI Quad card
Beagle/1	BeagleBoard
USRP/127.0.0.1:34001:32001	GNU Radio interface USRP

Sample:

rxchannel = dahdi/pseudo     ; No radio (hub)

Note: This is selecting what is known as (in Asterisk terminology) the channel driver.

Functions Stanza

Status Commands

Status commands provide general information about the node.

Status	Status Function
1	Force ID (global)
2	Give Time of Day (global)
3	Give software Version (global)
4	Give GPS location info
5	Speak the last (dtmf) user
11	Force ID (local only)
12	Give Time of Day (local only)

COP Commands

COP (control operator) commands are privileged commands. Node admins may provide some of these to their user community based on personal preference. COP commands within rpt.conf take the general format of key/value pairs. This COP 7 example would set touchtone *99 to enable the timeout timer.

99 = cop,7

Some COP commands can take multiple parameters. For example this COP 48 would send #3#607 on command.

900=cop,48,#,3,#,6,0,7

COP	COP Function
1	System warm boot
2	System enable
3	System disable
4	Test Tone On/Off
5	Dump System Variables on Console (debug)
6	PTT (phone mode only)
7	Time out timer enable
8	Time out timer disable
9	Autopatch enable
10	Autopatch disable
11	Link enable
12	Link disable
13	Query System State
14	Change System State
15	Scheduler Enable
16	Scheduler Disable
17	User functions (time, id, etc) enable
18	User functions (time, id, etc) disable
19	Select alternate hang timer
20	Select standard hang timer
21	Enable Parrot Mode
22	Disable Parrot Mode
23	Birdbath (Current Parrot Cleanup/Flush)
24	Flush all telemetry
25	Query last node un-keyed
26	Query all nodes keyed/unkeyed
27	Reset DAQ minimum on a pin
28	Reset DAQ maximum on a pin
30	Recall Memory Setting in Attached Xcvr
31	Channel Selector for Parallel Programmed Xcvr
32	Touchtone pad test: command + Digit string + # to playback all digits pressed
33	Local Telemetry Output Enable
34	Local Telemetry Output Disable
35	Local Telemetry Output on Demand
36	Foreign Link Local Output Path Enable
37	Foreign Link Local Output Path Disable
38	Foreign Link Local Output Path Follows Local Telemetry
39	Foreign Link Local Output Path on Demand
42	Echolink announce node # only
43	Echolink announce node Callsign only
44	Echolink announce node # & Callsign
45	Link Activity timer enable
46	Link Activity timer disable
47	Reset "Link Config Changed" Flag
48	Send Page Tone (Tone specs separated by parenthesis)
49	Disable incoming connections (control state noice)
50	Enable incoming connections (control state noicd)
51	Enable sleep mode
52	Disable sleep mode
53	Wake up from sleep
54	Go to sleep
55	Parrot Once if parrot mode is disabled
56	Rx CTCSS Enable
57	Rx CTCSS Disable
58	Tx CTCSS On Input only Enable
59	Tx CTCSS On Input only Disable
60	Send MDC-1200 Burst (cop,60,type,UnitID[,DestID,SubCode]) Type is 'I' for PttID, 'E' for Emergency, and 'C' for Call (SelCall or Alert), or 'SX' for STS (ststus), where X is 0-F. DestID and subcode are only specified for the 'C' type message. UnitID is the local systems UnitID. DestID is the MDC1200 ID of the radio being called, and the subcodes are as follows: Subcode '8205' is Voice Selective Call for Spectra ('Call') Subcode '8015' is Voice Selective Call for Maxtrac ('SC') or Astro-Saber('Call') Subcode '810D' is Call Alert (like Maxtrac 'CA')
61	Send Message to USB to control GPIO pins (cop,61,GPIO1=0[,GPIO4=1].....)
62	Send Message to USB to control GPIO pins, quietly (cop,62,GPIO1=0[,GPIO4=1].....)
63	Send pre-configred APRSTT notification (cop,63,CALL[,OVERLAYCHR])
64	Send pre-configred APRSTT notification, quietly (cop,64,CALL[,OVERLAYCHR])
65	Send POCSAG page (equipped channel types only)

Nodes Stanza

[nodes]

Control States Stanza

There are several predefined nmemonics (keywords) used in the control state stanza to enable and disable the various features of the controller. These nmemonics correspond to the control operator command to be executed and most of these are the same groups of letters sent back when a single control operator command is executed on the controller.

Nmemonic	Description	COP Method
rptena	Repeater Enable	2
rptdis	Repeater Disable	3
totena	Timeout Timer Enable	7
totdis	Timeout Timer Disable	8
apena	Autopatch Enable	9
apdis	Autopatch Disable	10
lnkena	Link Enable	11
lnkdis	Link Disable	12
skena	Scheduler Enable	15
skdis	Scheduler Disable	16
ufena	User Functions Enable	17
ufdis	User Functions Disable	18
atena	Alternate Hangtime Enable	19
atdis	Alternate Hangtime Disable	20
noice	No Incoming Connections Enable	49
noicd	No Incoming Connections Disable	50
slpen	Sleep Mode Enable	51
slpds	Sleep Mode Disable	52