User Tools

Site Tools


kb:rf.linking

RF Linking via AllStar

The Hamshack Hotline (HH) allows extensions to be tied to an RF connection to allow others to dial in and use the RF link. Hamshack Hotline offers this service to AllStar RF node owners with the intention that you, the node owner, want to allow ALL HH users the ability to connect to your node.

Note that this does not enable Autopatch from the RF connection. This is a one way connection from the HH to your RF system, basically a reverse autopatch if you will.

We are not allowing RF extensions to be created with the sole purpose of the node owner to restrict any HH user from connecting and have the extension only be accessible for the node owners exclusive use.

If you, the node owner, want exclusive use, please program a spare button on your VOIP phone to call your node direct. There is no need to use valuable HH resources to accomplish this, while forbidding all other HH users any access.

Please note that users who request an RF extension MUST also already have an active HH voice extension so that in the event there is an issue with the RF extension, we can contact you.

Creating an RF Connection to the Hamshack Hotline

To create a connection to HH, you first need to have configured an Allstar Node. Asterisk is needed to connect to the HH system as the HH system is based on Asterisk as well. There is plenty of documentation online on configuring an AllStar Node, so that is outside the scope of this document.

Also, we ask that you set up your PTT command to be *99 and release to be # in your rpt.conf file if you do not already have this setup. This will make sure that once someone dials in that they do not cause interference or problems on accident. This will also make all PTT commands uniform for the system.

*On your AllStar Node*

You will need to edit the iax.conf and extensions.conf files.

In your iax.conf you will need to configure a stanza similar to this:

[hh-your_callsign] ;Data here must match data on the next line
username=hh-your_callsign ;Data here must match data on the previous line
type=friend
context=hhphone
host=dynamic
auth=md5
secret=my_secret_password
disallow=all
allow=ulaw
transfer=no

Footnote: For your username and secret/password, you can not use special characters, Except a 'Hyphen', and those parameters are limited to 20 characters each.

In your extensions.conf you need to configure a stanza similar to below. Note that you need to change the node numbers to the node that you are having the connection dial into.

Below ia a configuration examples.

Example. If your node number is 12345, then you would use the code below:

[hhphone]  ;This MUST MATCH the "context=" parameter you used from iax.conf file
exten => 12345,n,answer()
exten => 12345,n,Playback(rpt/node)
exten => 12345,n,Playback(digits/1)
exten => 12345,n,Playback(digits/2)
exten => 12345,n,Playback(digits/3)
exten => 12345,n,Playback(digits/4)
exten => 12345,n,Playback(digits/5)
exten => 12345,n,Playback(rpt/connected)
exten => 12345,n,Rpt,12345|P

The code above does NOT announce the Caller-ID of the HH user calling your node.

Should you want the HH callers to be announced as well, then alternatively you should use the extensions.conf example below and not the one from above.

[hhphone]  ;This MUST MATCH the "context=" parameter you used from iax.conf file
exten => 12345,n,answer()
exten => 12345,n,Playback(rpt/node)
exten => 12345,n,Playback(digits/1)
exten => 12345,n,Playback(digits/2)
exten => 12345,n,Playback(digits/3)
exten => 12345,n,Playback(digits/4)
exten => 12345,n,Playback(digits/5)
exten => 12345,n,Playback(rpt/connected)
exten => 12345,n,Set(CALLSIGN=HH-${CALLERID(name)})
exten => 12345,n,rpt(12345|P|${CALLSIGN})
exten => 12345,n,Rpt,12345|P

Footnote: Hamshack Hotline policy requires users to have a connection announcement that both alerts users the connection was successful, and the AllStar node number that the user has connected to. Using the code above will accomplish this. You are allowed to customize it, should you wish to. However, if you totally remove it and users who connect to your node get no connection confirmation at all, we will ask you to re-install it. If you fail to do so, we will delete your extension.

Connecting to Hamshack Hotline

You will also need to have a Fully Qualified Domain Name [FQDN] already established that resolves to the IP address of your Trunk. We will not accept IP addresses directly, PERIOD !

In most cases, HAM VOIP has already create one for you:
node#.ip.hamvoip.org

Once you have your node configured, you will need to request an extension through the HHOPS ticketing system. This can be reached at http://apps.hamshackhotline.com:9090/

Select the “RF-Link Request” from the drop-down Help Topic menu.

You will need to make sure to include an IAX2 Dial string that includes the stanza information you setup for your node’s connections. The IAX2 Dial String looks like:

IAX2/hh-your_callsign:password@domain:port/node#

So for example:

If your callsign was: AA9XYZ
and your password was: Test-1234
and your FQDN was: 98765.ip.hamvoip.org
and your AllStar node number was: 98765

Then your IAX2 Dial String would be:

IAX2/hh-AA9XYZ:Test-1234@98765.ip.hamvoip.org:4569/98765

This is the most important part. Without this, we are not able to connect to your system.

Once your extension is provisioned, you will be contacted with your extension number to test and make sure that you can connect to your node.

Port Forwarding Note

In some cases you may need to forward UDP port 4569 in your router to point to the LAN IP address of your node. Please only forward port 4569 as UDP. Forwarding as TCP will not work.

If you have altered the standard setup to use a port other than 4569, then you would simply substitute 4569 for what ever port you are using on your node.

30 Days Inactive

Note that if this RF connection shows offline on our side for 30 days, the RF extension will be deleted. This action is designed to ensure that numbers are being utilized and therefore justified since they are a limited resource.

kb/rf.linking.txt · Last modified: 2023/01/21 21:20 by kg6baj