Difference between revisions of "Setup Autopatch"

From "PTTLink Wiki"
Jump to navigation Jump to search
(created page)
 
Tag: visualeditor
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
[[Category:How to]]
 
[[Category:How to]]
 +
 +
The autopatch feature in app_rpt allows users on the radio to interconnect with the public switched telephone network.
 +
 +
=== Regulatory Issues ===
 +
{| class="wikitable"
 +
|Some countries which disallow third-party traffic do not allow autopatching or telephone interconnection on amateur radio frequencies. In addition, if a system is linked between one country which allows autopatching and one which doesn't, just the passing of the traffic itself across the link could be considered a violation of the rules in the prohibiting country. In countries which permit autopatching, users need be made aware of this and should take the node off-link before using the autopatch.
 +
|}
 +
 +
=== Security Issues ===
 +
{| class="wikitable"
 +
|The examples provided here do not secure the autopatch against toll fraud. A lot can be done to prevent or reduce toll fraud, but the prevention measures vary by where you are located geographically. Most of the prevention measures will be in extensions.conf, as you can write contexts to reject certain number sequences. The asterisk book in the references section should be consulted to see how to do this, Before placing any autopatch in service, please make sure you have secured your system so that toll fraud does not become an issue.
 +
|}
 +
 +
=== Selecting an ITSP ===
 +
Call termination into the public switched telephone network is a service offered by an Internet Telephone Service Provider (ITSP). This is a highly competitive business, and there are lots of ITSP's offering termination for Asterisk users. In the reference section is a link to a site which lists several ITSP's. Termination is usually provided using the SIP protocol, and IAX is also offered by a few providers.
 +
 +
When selecting an ITSP, make sure they provide setup instructions with example configurations including usernames, and passwords. Quite a few ITSP's will automatically generate a custom SIP or IAX stanza for insertion into sip.conf, or iax.conf respectively.
 +
 +
=== Configuration Files ===
 +
Three configuration files will be affected: rpt.conf, extensions.conf and iax.conf or sip.conf. The ITSP should provide a stanza for you to insert in iax.conf or sip.conf. The flow diagram below shows how each of these files are used when an outgoing autopatch call is made:
 +
 +
In the rpt.conf configuration file, a context in extensions.conf is defined in a node stanza using the context key:
 +
[1234]
 +
.
 +
.
 +
.
 +
context=autopatch      ; Aserisk context in which to place the call
 +
accountcode="MYACCT"  ; optional ACCOUNTCODE for call on Asterisk
 +
callerid="5592557827"  ; optional callerid to send for call
 +
.
 +
.
 +
.
 +
Also in the rpt.conf file, entries are added to the function table so that users can bring up or take down the autopatch:
 +
[functions]
 +
.
 +
.
 +
.
 +
6=autopatchup,noct=1,farenddisconnect=1,dialtime=20000
 +
0=autopatchdn
 +
.
 +
.
 +
.
 +
In extensions.conf, a stanza for the autopatch context is added which refers to the peer stanza in iax.conf or sip.conf. For outbound IAX connections extensions.conf
 +
[autopatch]
 +
 +
exten => _1NXXNXXXXXX,1,Dial,IAX2/peername/${EXTEN}
 +
exten => _1NXXNXXXXXX,2,Congestion
 +
For outbound SIP connections it should look like this:
 +
[autopatch]
 +
 +
exten => _1NXXNXXXXXX,1,Dial,SIP/peername/${EXTEN}
 +
exten => _1NXXNXXXXXX,2,Congestion
 +
The peer stanza you insert in iax.conf or sip.conf should preferably be provided by your ITSP. You'll want to use the stanza they identify for performing outgoing connections. A nonoperational example of an iax2 peer stanza looks like this:
 +
[peername]
 +
type=peer
 +
host=127.0.0.1
 +
secret=nunya
 +
auth=md5
 +
disallow=all
 +
allow=gsm
 +
allow=ulaw
 +
 +
=== Autopatch Options ===
 +
You may have noticed several options being passed in to the autopatchup command class.
 +
 +
This table summarizes what they do:
 +
{| class="wikitable"
 +
!Autopatch Option
 +
!Description
 +
|-
 +
|context
 +
|Override the context specified for the autopatch in rpt.conf
 +
|-
 +
|dialtime
 +
|The maximum time to wait between DTMF digits when a telephone number is being dialed. The patch will automatically disconnect if this time is exceeded. The value is specified in milliseconds.
 +
|-
 +
|farenddisconnect
 +
|When set to 1, the patch will automatically disconnect when the called party hangs up. The default is send a circuit busy tone until the radio user brings the patch down.
 +
|-
 +
|noct
 +
|When this is set to 1 the courtesy tone during an autopatch call will be disabled. The default is to send the courtesy tone whenever the radio user unkeys.
 +
|-
 +
|quiet
 +
|When set to 1, Don't send dial tone, voice responses, just try to connect the call.
 +
|}
 +
 +
== Simplex Autopatch ==
 +
For nodes with duplex set to 0 or 1, Simplex Autopatch operation is supported.
 +
 +
This is accomplished by using a VOX on the audio coming from the telephone call,
 +
 +
because of the half-duplex nature of the node. To avoid having audio from the
 +
 +
telephone call keep the transmitter engaged for extended periods of time (if there
 +
 +
is some source of continuous audio), there are two time-out values. One is the
 +
 +
Vox timeout, which is the maximum amount of time that the VOX can hold the transmitter
 +
 +
engaged, which by default is 10 seconds. The other one is the Vox recovery time, which
 +
 +
is the amount of time that the Vox is disabled during times of continuous audio, after
 +
 +
the Vox timeout, which is 2 seconds. So, during continuous audio, it transmits for
 +
 +
10 seconds, then stops for 2 seconds (so that you can transmit to it and perhaps
 +
 +
disconnect the call), then transmits for another 10 seconds, then stops for 2 seconds,
 +
 +
and so on.
 +
 +
Additionally, to prevent 'chop-off' of the first syllable or two of the audio from the
 +
 +
telephone call, we delay the audio to allow for the transmitter to start transmitting
 +
 +
and any CTCSS tones to be decoded. This delay is typically 500ms, but can be adjusted
 +
 +
via the 'simplexpatchdelay' parameter. It is specified in units of 20 milliseconds.
 +
 +
These time-out values may be overridden by using the following configuration parameters
 +
 +
located in the [<node-number>] section of rpt.conf:
 +
 +
[1999]
 +
 +
.
 +
 +
.
 +
 +
.
 +
 +
voxtimeout = 10000 ; vox timeout time in ms
 +
 +
voxrecover = 2000 ; vox recover time in ms
 +
 +
simplexpatchdelay = 25 ; Delay for transmit while in patch in 20ms increments
 +
 +
.
 +
 +
.
 +
 +
.
 +
 +
If not specified, it uses the default values as specified above.

Latest revision as of 15:39, 28 January 2019


The autopatch feature in app_rpt allows users on the radio to interconnect with the public switched telephone network.

Regulatory Issues

Some countries which disallow third-party traffic do not allow autopatching or telephone interconnection on amateur radio frequencies. In addition, if a system is linked between one country which allows autopatching and one which doesn't, just the passing of the traffic itself across the link could be considered a violation of the rules in the prohibiting country. In countries which permit autopatching, users need be made aware of this and should take the node off-link before using the autopatch.

Security Issues

The examples provided here do not secure the autopatch against toll fraud. A lot can be done to prevent or reduce toll fraud, but the prevention measures vary by where you are located geographically. Most of the prevention measures will be in extensions.conf, as you can write contexts to reject certain number sequences. The asterisk book in the references section should be consulted to see how to do this, Before placing any autopatch in service, please make sure you have secured your system so that toll fraud does not become an issue.

Selecting an ITSP

Call termination into the public switched telephone network is a service offered by an Internet Telephone Service Provider (ITSP). This is a highly competitive business, and there are lots of ITSP's offering termination for Asterisk users. In the reference section is a link to a site which lists several ITSP's. Termination is usually provided using the SIP protocol, and IAX is also offered by a few providers.

When selecting an ITSP, make sure they provide setup instructions with example configurations including usernames, and passwords. Quite a few ITSP's will automatically generate a custom SIP or IAX stanza for insertion into sip.conf, or iax.conf respectively.

Configuration Files

Three configuration files will be affected: rpt.conf, extensions.conf and iax.conf or sip.conf. The ITSP should provide a stanza for you to insert in iax.conf or sip.conf. The flow diagram below shows how each of these files are used when an outgoing autopatch call is made:

In the rpt.conf configuration file, a context in extensions.conf is defined in a node stanza using the context key:

[1234]
.
.
.
context=autopatch      ; Aserisk context in which to place the call
accountcode="MYACCT"   ; optional ACCOUNTCODE for call on Asterisk
callerid="5592557827"  ; optional callerid to send for call
.
.
.

Also in the rpt.conf file, entries are added to the function table so that users can bring up or take down the autopatch:

[functions]
.
.
.
6=autopatchup,noct=1,farenddisconnect=1,dialtime=20000 
0=autopatchdn 
.
.
.

In extensions.conf, a stanza for the autopatch context is added which refers to the peer stanza in iax.conf or sip.conf. For outbound IAX connections extensions.conf

[autopatch] 

exten => _1NXXNXXXXXX,1,Dial,IAX2/peername/${EXTEN} 
exten => _1NXXNXXXXXX,2,Congestion 

For outbound SIP connections it should look like this:

[autopatch] 

exten => _1NXXNXXXXXX,1,Dial,SIP/peername/${EXTEN} 
exten => _1NXXNXXXXXX,2,Congestion 

The peer stanza you insert in iax.conf or sip.conf should preferably be provided by your ITSP. You'll want to use the stanza they identify for performing outgoing connections. A nonoperational example of an iax2 peer stanza looks like this:

[peername]
type=peer 
host=127.0.0.1 
secret=nunya
auth=md5 
disallow=all 
allow=gsm 
allow=ulaw

Autopatch Options

You may have noticed several options being passed in to the autopatchup command class.

This table summarizes what they do:

Autopatch Option Description
context Override the context specified for the autopatch in rpt.conf
dialtime The maximum time to wait between DTMF digits when a telephone number is being dialed. The patch will automatically disconnect if this time is exceeded. The value is specified in milliseconds.
farenddisconnect When set to 1, the patch will automatically disconnect when the called party hangs up. The default is send a circuit busy tone until the radio user brings the patch down.
noct When this is set to 1 the courtesy tone during an autopatch call will be disabled. The default is to send the courtesy tone whenever the radio user unkeys.
quiet When set to 1, Don't send dial tone, voice responses, just try to connect the call.

Simplex Autopatch

For nodes with duplex set to 0 or 1, Simplex Autopatch operation is supported.

This is accomplished by using a VOX on the audio coming from the telephone call,

because of the half-duplex nature of the node. To avoid having audio from the

telephone call keep the transmitter engaged for extended periods of time (if there

is some source of continuous audio), there are two time-out values. One is the

Vox timeout, which is the maximum amount of time that the VOX can hold the transmitter

engaged, which by default is 10 seconds. The other one is the Vox recovery time, which

is the amount of time that the Vox is disabled during times of continuous audio, after

the Vox timeout, which is 2 seconds. So, during continuous audio, it transmits for

10 seconds, then stops for 2 seconds (so that you can transmit to it and perhaps

disconnect the call), then transmits for another 10 seconds, then stops for 2 seconds,

and so on.

Additionally, to prevent 'chop-off' of the first syllable or two of the audio from the

telephone call, we delay the audio to allow for the transmitter to start transmitting

and any CTCSS tones to be decoded. This delay is typically 500ms, but can be adjusted

via the 'simplexpatchdelay' parameter. It is specified in units of 20 milliseconds.

These time-out values may be overridden by using the following configuration parameters

located in the [<node-number>] section of rpt.conf:

[1999]

.

.

.

voxtimeout = 10000 ; vox timeout time in ms

voxrecover = 2000 ; vox recover time in ms

simplexpatchdelay = 25 ; Delay for transmit while in patch in 20ms increments

.

.

.

If not specified, it uses the default values as specified above.