Line 1: |
Line 1: |
− | The chan_echolink channel driver allows AllStar nodes to register on and communicate with the EchoLink network. The following information is originally from [http://docs.allstarlink.org/drupal/node/12 echolink.conf]. | + | [[Category:Node Configuration]] |
| + | [[Category:How to]] |
| + | The chan_echolink channel driver allows PTTLink nodes to register on and communicate with the EchoLink network. The following information is originally from [http://docs.pttlink.org/drupal/node/12 echolink.conf]. |
| | | |
| =echolink.conf= | | =echolink.conf= |
− | With the addition of the chan_echolink Asterisk channel driver direct connections to and from echolink to Asterisk/app_rpt are now supported. No other programs (e.g. rtpDir, or the link box) are required. With chan_echolink, EchoLink nodes become part of the AllStar link number space. | + | With the addition of the chan_echolink Asterisk channel driver direct connections to and from echolink to Asterisk/app_rpt are now supported. No other programs (e.g. rtpDir, or the link box) are required. With chan_echolink, EchoLink nodes become part of the PTTLink number space. |
| | | |
− | From an app_rpt/Allstar node, Echolink connections look just like Allstar/App_rpt connections except the Echolink node numbers have been prefixed with a 3 and padded out to 7 digits with leading zeroes. For instance, if you want to connect to Echolink node 1234 on your app_rpt system you would dial *3 followed by 3001234. If you have a 6 digit Echolink node number 123456, you would dial *3 followed by 3123456. As you can see we have reserved Allstar node numbers with a leading 3 for the Echolink number space. | + | From an app_rpt/PTTLink node, Echolink connections look just like PTTLink/App_rpt connections except the Echolink node numbers have been prefixed with a 3 and padded out to 7 digits with leading zeroes. For instance, if you want to connect to Echolink node 1234 on your app_rpt system you would dial *3 followed by 3001234. If you have a 6 digit Echolink node number 123456, you would dial *3 followed by 3123456. As you can see we have reserved PTTLink node numbers with a leading 3 for the Echolink number space. |
| | | |
| For users originating from an Echolink node using Echolink supplied software, nothing changes for them, they just dial the 4 or 6 digit Echolink node number assigned to your app_rpt system and they get connected! | | For users originating from an Echolink node using Echolink supplied software, nothing changes for them, they just dial the 4 or 6 digit Echolink node number assigned to your app_rpt system and they get connected! |
Line 27: |
Line 29: |
| To activate the Echolink channel driver, all that's required is a properly formatted configuration file. A base configuration file has been included with Both ACID and Limey Linux and is located in /usr/src/configs/examples/echolink. Copy this file to /etc/asterisk, and edit it to match your callsign, password and node number assignment from Echolink.org. The sample echolink.conf file is as follows: | | To activate the Echolink channel driver, all that's required is a properly formatted configuration file. A base configuration file has been included with Both ACID and Limey Linux and is located in /usr/src/configs/examples/echolink. Copy this file to /etc/asterisk, and edit it to match your callsign, password and node number assignment from Echolink.org. The sample echolink.conf file is as follows: |
| | | |
− | <pre> | + | <syntaxhighlight lang="ini"> |
| [el0] | | [el0] |
| confmode=no ; Conference mode | | confmode=no ; Conference mode |
− | call=W6ABC-R ; Change this to your callsign! | + | call=W6ABC-R ; Change this to your callsign! |
− | pwd=XXXXX ; Change this to your password! | + | pwd=XXXXX ; Change this to your password! |
| name=echolinkusername ; Change this to your real name! | | name=echolinkusername ; Change this to your real name! |
| qth=echolink-location ; Change this to your actual QTH! | | qth=echolink-location ; Change this to your actual QTH! |
Line 37: |
Line 39: |
| maxstns=20 ; The maximum 'at-once' connections allowed/supported (see ** below) | | maxstns=20 ; The maximum 'at-once' connections allowed/supported (see ** below) |
| node=123456 ; Change this to the assigned 'ECHOLINK' node# | | node=123456 ; Change this to the assigned 'ECHOLINK' node# |
− | astnode=2345 ; Change this to your active Allstar node number! | + | astnode=2345 ; Change this to your active PTTLink node number! |
− | context=radio-secure ; The allstar context (leave the default unless you have good reason to change) | + | context=radio-secure ; The PTTLink context (leave the default unless you have good reason to change) |
| server1=server1.echolink.org | | server1=server1.echolink.org |
| server2=server2.echolink.org | | server2=server2.echolink.org |
Line 48: |
Line 50: |
| lat=34.74978 ; Latitude in decimal degrees | | lat=34.74978 ; Latitude in decimal degrees |
| lon=-92.27666 ; Longitude in decimal degrees | | lon=-92.27666 ; Longitude in decimal degrees |
− | power=0 ; 0=0W, 1=1W, 2=4W, 3=9W, 4=16W, 5=25W, 6=36W, 7=49W, 8=64W, 9=81W (Power in Watts) | + | power=0 ; 0=0W, 1=1W, 2=4W, 3=9W, 4=16W, 5=25W, 6=36W, 7=49W, 8=64W, 9=81W (Power in Watts) |
− | height=0 ; 0=10' ,1=20',2=40',3=80' ,4=160' ,5=320' ,6=640' ,7=1280',8=2560',9=5120' (AMSL in Feet) | + | height=0 ; 0=10' ,1=20',2=40',3=80' ,4=160' ,5=320' ,6=640' ,7=1280',8=2560',9=5120' (AMSL in Feet) |
− | gain=7 ; Gain in db (0-9) | + | gain=7 ; Gain in db (0-9) |
− | dir=0 ; 0=omni, 1=45deg, 2=90deg, 3=135deg, 4=180deg, 5=225deg, 6=270deg, 7=315deg, 8=360deg (Direction) | + | dir=0 ; 0=omni, 1=45deg, 2=90deg, 3=135deg, 4=180deg, 5=225deg, 6=270deg, 7=315deg, 8=360deg (Direction) |
− | </pre> | + | </syntaxhighlight> |
| | | |
| ** How many stations will your node support ? The 2 most particular factors will be how much CPU/Memory power you have | | ** How many stations will your node support ? The 2 most particular factors will be how much CPU/Memory power you have |
Line 60: |
Line 62: |
| | | |
| == Node Stanza Keys == | | == Node Stanza Keys == |
| + | Note the below go in the node stanza in rpt.conf, not echolink.conf |
| + | |
| {| class="wikitable" | | {| class="wikitable" |
| !Key | | !Key |
Line 66: |
Line 70: |
| |- | | |- |
| |eannmode | | |eannmode |
− | |0 = do not announce Echolink nodes at all, 1 = announce only the node number (Allstar-translated), 2 = announce only the call of the echolink station, 3 = announce both | + | |0 = do not announce Echolink nodes at all, 1 = announce only the node number (PTTLink-translated), 2 = announce only the call of the echolink station, 3 = announce both |
| |1 | | |1 |
| |- | | |- |
Line 95: |
Line 99: |
| The audio gain going to and coming from the Echolink system may be set from within a Node Stanza as follows: | | The audio gain going to and coming from the Echolink system may be set from within a Node Stanza as follows: |
| | | |
− | <pre> | + | <syntaxhighlight lang="ini"> |
| erxgain=-3.0 ; defaults to -3.0 db | | erxgain=-3.0 ; defaults to -3.0 db |
| etxgain=3.0 ; defaults to 3.0 db. | | etxgain=3.0 ; defaults to 3.0 db. |
− | </pre> | + | </syntaxhighlight> |
| | | |
| =Debugging= | | =Debugging= |
Line 119: |
Line 123: |
| =Miscellaneous= | | =Miscellaneous= |
| ==Connectivity Issues== | | ==Connectivity Issues== |
− | When debugging EchoLink connectivity issues with your AllStar node, remember the following: | + | When debugging EchoLink connectivity issues with your PTTLink node, remember the following: |
− | *Never run the EchoLink application from your mobile device (cell phone/tablet/etc) using the '''same network''' as your AllStar node. This will lead to problems with one or the other not being able to connect to/register/use the EchoLink servers or other EchoLink nodes. (This also applies to running the Windows application on the same network as your AllStar node). | + | *Never run the EchoLink application from your mobile device (cell phone/tablet/etc) using the '''same network''' as your PTTLink node. This will lead to problems with one or the other not being able to connect to/register/use the EchoLink servers or other EchoLink nodes. (This also applies to running the Windows application on the same network as your PTTLink node). |
− | *If using the EchoLink application on your mobile device (cell phone/tablet/etc), make sure that the EchoLink application is '''not set to run/is not running in the background'''. Having the application running in the background can cause problems with your AllStar node not being able to connect to/register/use the EchoLink servers or other EchoLink nodes. | + | *If using the EchoLink application on your mobile device (cell phone/tablet/etc), make sure that the EchoLink application is '''not set to run/is not running in the background'''. Having the application running in the background can cause problems with your PTTLink node not being able to connect to/register/use the EchoLink servers or other EchoLink nodes. |
| | | |
− | <pre> | + | <syntaxhighlight lang="text"> |
− | Note: Same network refers to the the Public IP address that both your AllStar node AND the device running the EchoLink application are using -- even if they are on different subnets internally. The Public IP is what the EchoLink servers/network sees and uses when communicating with your node/device. | + | Note: Same network refers to the the Public IP address that both your PTTLink node AND the device running the EchoLink application are using -- even if they are on different subnets internally. The Public IP is what the EchoLink servers/network sees and uses when communicating with your node/device. |
− | </pre> | + | </syntaxhighlight> |
| | | |
| ==Caveats== | | ==Caveats== |
Line 149: |
Line 153: |
| | | |
| ==Remote Commands== | | ==Remote Commands== |
− | The following '''''remote text commands''''' can be sent to the chan_echolink driver running on your AllStar link node using ''netcat'': | + | The following '''''remote text commands''''' can be sent to the chan_echolink driver running on your PTTLink node using ''netcat'': |
| | | |
| {| class="wikitable" | | {| class="wikitable" |
Line 160: |
Line 164: |
| | o.rec || Turn on/off recording | | | o.rec || Turn on/off recording |
| |} | | |} |
− |
| |
− | [[Category:Node Configuration]]
| |