Description:
Route a given input tone source to the speaker on the DTMF board. If no argument is given,
then the status of the current paths will be given. If 'ON' or 'OFF' is given all input
sources will be routed/unrouted to the speaker at once. If the input channel is given the
status for that input will be given. If the input channel and 'ON' or 'OFF' is given the
speaker will play/not play tones on that input.
Form:
Command Handler: DPID
SPEAKERPATH|SRP|SP [INPUT SOURCE] [ARGUEMENT]
Argument List:
Terse Verbose Description
NONE ON All paths or [INPUT SOURCE] path will be routed to the speaker.
NONE OFF All paths or [INPUT SOURCE] path will be unrouted from the speaker.
Response:
MODIFY SPEAKERPATH RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes modify responses (empty line)
DISPLAY SPEAKERPATH RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, followed by
"[ARGUMENT] = [VALUE]\r\n", or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, followed by
"[TERSE NUMERIC VALUE]\r\n", or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes display responses (empty line)
Examples:
Verbose command to retrieve all buffers:
*.DPID SPEAKERPATH <enter>
Response is: ?
OK
Speaker 1 OFF
OK\r\n
Speaker 2 OFF
OK\r\n
Speaker 3 OFF
OK
Speaker 4 OFF
OK
Speaker 5 OFF
OK
Speaker 6 OFF
OK
Speaker 7 OFF
OK
Speaker 8 OFF
OK
Speaker 9 OFF
OK
Speaker 10 OFF
OK
Speaker 11 OFF
OK
Speaker 12 OFF
Terse command to retrieve all current settings:
*.DPID SP <enter>
Response is: ?
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
0
OFF
Verbose command to retrieve speaker status for a given INPUT SOURCE:
*.DPID SPEAKERPATH 1 <enter>
Response is: ?
OK
Speaker 1 OFF
Terse command to retrieve speaker status for a given INPUT SOURCE:
*.DPID SP 1 <enter>
Response is: ?
0
OFF
Verbose command to set all speaker paths to ON:
*.DPID SPEAKERPATH ON <enter>
Response is: ?
OK
Terse command to set all speaker paths to ON:
*.DPID SP ON <enter>
Response is: ?
0
Verbose command to set all speaker paths to OFF:
*.DPID SPEAKERPATH OFF <enter>
Response is: ?
OK
Terse command to set all speaker paths to OFF:
*.DPID SP OFF <enter>
Response is: ?
0
Verbose command to set an [INPUT SOURCE] speaker paths to ON:
*.DPID SPEAKERPATH 3 ON <enter>
Response is: ?
OK
Terse command to set an [INPUT SORUCE] speaker paths to ON:
*.DPID SP 3 ON <enter>
Response is: ?
0
Verbose command to set an [INPUT SOURCE] speaker paths to OFF:
*.DPID SPEAKERPATH 3 OFF <enter>
Response is: ?
OK
Terse command to set an [INPUT SORUCE] speaker paths to OFF:
*.DPID SP 3 OFF <enter>
Response is: ?
0
Notes:
The speakerpath command depends on RS232 communication between the GEM and DTMF board.
Routing all inputs to the speaker at the same time will not damage the board or speaker.
However as more inputs are routed to the speaker at the same time the signal will be
attenuated. Therefore it will the speaker will not sound as loud as more paths are routed
at the same time.