896
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 342:
Line 541: − − [functions] − 989=cop,4 ; a sample function in the functions stanza. − </pre> − − =DTMF Commands= − Function stanzas control access to DTMF commands that a user can issue from various control points in app_rot. There can be separate function stanzas defined for radio interfaces, and dial-in access. Nodes on the same Asterisk/app_rpt server can have separate (or same) function stanzas. A function stanza key/value pair has the following format: − − dtmfcommand=functionclass,[functionmethod],[parameters] − Where: − − * dtmfcommand is a DTMF digit sequence minus the start character (usually *) − * functionclass is a string which defines what class of command (see the next page) − * functionmethod defines the optional method number to use in the function class. − * functionoptions are one or more optional comma separated parameters which further define a command. − − Sample: − <pre> − 989=cop,4 ; generate test tone. − </pre> − This stanza is named (pointed to) by the [[#functions=|functions=]], link_functions=, or the phone_functions= key/value pairs in the node stanza. − − − ==Status Commands== − Status commands provide general information about the node. − {| class="wikitable" − ! 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 [[Structure of Config Files|key/value pairs]]. This COP 7 example would set touchtone *99 to enable the timeout timer. − − <pre>99 = cop,7</pre> − − Some COP commands can take multiple parameters. For example this COP 48 would send #3#607 on command. − − <pre>900=cop,48,#,3,#,6,0,7</pre> − − {| class="wikitable" − |- − ! 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) − − |} − − =Link Functions Stanza= − The link functions stanza is a named stanza [[Structure of Config Files#Settings to name other Stanzas|pointed to]] by the [[#link_functions=|link_function= key/value pair]]. Functions within this stanza are used decode DTMF commands when accessing the node via a link from another node. The traditional usage is to point link_functions= to the same stanza as named by [[#functions=|functions=]] thereby having functions from a linked node and from the local node the same. − − Sample: − <pre> − link_functions=functions ; use local functions
no edit summary
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 [https://github.com/AllStarLink/DIAL/blob/master/configs/rpt.conf rpt.conf on GitHub]).
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 [https://github.com/AllStarLink/DIAL/blob/master/configs/rpt.conf rpt.conf on GitHub]).
=DTMF Commands=
Function stanzas control access to DTMF commands that a user can issue from various control points in app_rpt. There can be separate function stanzas defined for radio interfaces, and dial-in access. Nodes on the same Asterisk/app_rpt server can have separate (or same) function stanzas. A function stanza key/value pair has the following format:
dtmfcommand=functionclass,[functionmethod],[parameters]
Where:
* dtmfcommand is a DTMF digit sequence minus the start character (usually *)
* functionclass is a string which defines what class of command (see the next page)
* functionmethod defines the optional method number to use in the function class.
* functionoptions are one or more optional comma separated parameters which further define a command.
Sample:
<pre>
989=cop,4 ; generate test tone.
</pre>
This stanza is named (pointed to) by the [[#functions=|functions=]], link_functions=, or the phone_functions= key/value pairs in the node stanza.
==Status Commands==
Status commands provide general information about the node.
{| class="wikitable"
! 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 [[Structure of Config Files|key/value pairs]]. This COP 7 example would set touchtone *99 to enable the timeout timer.
<pre>99 = cop,7</pre>
Some COP commands can take multiple parameters. For example this COP 48 would send #3#607 on command.
<pre>900=cop,48,#,3,#,6,0,7</pre>
{| class="wikitable"
|-
! 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)
|}
=Link Functions Stanza=
The link functions stanza is a named stanza [[Structure of Config Files#Settings to name other Stanzas|pointed to]] by the [[#link_functions=|link_function= key/value pair]]. Functions within this stanza are used decode DTMF commands when accessing the node via a link from another node. The traditional usage is to point link_functions= to the same stanza as named by [[#functions=|functions=]] thereby having functions from a linked node and from the local node the same.
Sample:
<pre>
link_functions=functions ; use local functions
[functions]
989=cop,4 ; a sample function in the functions stanza.
</pre>
=Node Number Stanza=
=Node Number Stanza=
<pre>
<pre>
functions=functions ;name the functions stanza 'functions'
functions=functions ;name the functions stanza 'functions'
[functions]
[functions]