Difference between revisions of "Beginners Guide"

From "PTTLink Wiki"
Jump to navigation Jump to search
m
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
[[Category: How to]]
 
PTTLink for beginners.
 
PTTLink for beginners.
  
Line 4: Line 5:
  
 
Go to https://pttlink.org/ and click on  the '''<Login/Sign Up>''' link.
 
Go to https://pttlink.org/ and click on  the '''<Login/Sign Up>''' link.
[[File:Ptt site menu login.png|none|thumb|545x545px]]Next click the '''<Sign Up>''' link.[[File:Ptt_site sign up.png|none|thumb|311x311px]]
+
 
 +
[[File:Ptt site menu login.png|none|thumb|545x545px]]
 +
 
 +
Next click the '''<Sign Up>''' link.
 +
 
 +
[[File:Ptt_site sign up.png|none|thumb]]
  
 
== Download PTTLink image file ==
 
== Download PTTLink image file ==
Line 12: Line 18:
 
Go to [[Main_Page#Downloads|wiki.pttlink.org]] scroll down to the Downloads section and select the appropriate image for the type of system you will use.
 
Go to [[Main_Page#Downloads|wiki.pttlink.org]] scroll down to the Downloads section and select the appropriate image for the type of system you will use.
  
[[File:ptt download.png|frameless|border|533x533px]]
+
[[File:ASL download.png|none|thumb]]
  
 
Write the image file to media. Either a USB memory stick, CD or DVD, or a microSD card (Raspberry Pi).
 
Write the image file to media. Either a USB memory stick, CD or DVD, or a microSD card (Raspberry Pi).
Line 19: Line 25:
  
 
You will need to login to your account at [https://pttlink.org/ https://PTTLink.org/]
 
You will need to login to your account at [https://pttlink.org/ https://PTTLink.org/]
[[File:ptt site menu login.png|none|thumb|579x579px]]
+
[[File:Ptt site menu login.png|none|thumb|579x579px]]
  
 
Click on  <'''Login/Sign Up>'''  as shown in the image above.
 
Click on  <'''Login/Sign Up>'''  as shown in the image above.
  
[[File:ptt site login.png|none|thumb|308x308px]]
+
[[File:Ptt site login.png|none|thumb]]
  
 
== Create a Server ==
 
== Create a Server ==
Line 41: Line 47:
  
 
At the top of the page,  click '''<Portal>''' and then on '''<Node Settings>'''.  
 
At the top of the page,  click '''<Portal>''' and then on '''<Node Settings>'''.  
[[File:Ptt site node settings.png|none|thumb|356x356px]]
+
[[File:Ptt site node settings.png|none|thumb|565x565px]]
  
 
Then click '''<Continue...>'''.
 
Then click '''<Continue...>'''.
  
[[File:ptt site request node number 1.png|none|thumb|494x494px]]
+
[[File:ptt site request node number 1.png|none|thumb]]
  
 
Then click '''<Request>'''.
 
Then click '''<Request>'''.
  
[[File:ptt site request node number 2.png|none|thumb|800x800px]]
+
[[File:ptt site request node number 2.png|none|thumb|424x424px]]
  
 
Select which server you would wish to have a node number assigned to.
 
Select which server you would wish to have a node number assigned to.
  
 
A comment of 'additional node on same server'  would be appropriate if you are requesting a second node number.
 
A comment of 'additional node on same server'  would be appropriate if you are requesting a second node number.
[[File:ptt site request node number 3.png|none|thumb|800x800px]]
+
[[File:ptt site request node number 3.png|none|thumb|673x673px]]
  
 
Once your node number request(s) are processed you will receive an email.
 
Once your node number request(s) are processed you will receive an email.
Line 69: Line 75:
  
 
Fill in the information for you node and click '''<Submit>'''.
 
Fill in the information for you node and click '''<Submit>'''.
[[File:ptt node settings form.png|none|thumb|800x800px]]
+
[[File:ptt site node settings form.png|none|thumb|800x800px]]
  
 
Write down your node number, password and the call sign you assigned for the node as you will use them to configure your PTTLink system.
 
Write down your node number, password and the call sign you assigned for the node as you will use them to configure your PTTLink system.
  
== Install and configure PTTLink to your computer ==
+
 
 +
== Install and configure PttLink to your computer ==
  
 
Consult your owners manual or your favorite internet search engine for how to install an image for your computer system.
 
Consult your owners manual or your favorite internet search engine for how to install an image for your computer system.
Line 79: Line 86:
 
Install the PTTLink disk image to your computer.  Insert the appropriate media for your system and boot the computer.
 
Install the PTTLink disk image to your computer.  Insert the appropriate media for your system and boot the computer.
  
When the login prompt appears enter the user ID of '''repeater''' and press '''<Enter>'''.
+
When the login prompt appears enter the user ID of  
 +
 
 +
'''repeater'''  
 +
 
 +
and press '''<Enter>'''.
  
Enter the default password of  '''pttlink'''
+
Enter the default password of
 +
  '''allstarlink'''
  
 
Follow the on screen instructions for the initial password change.
 
Follow the on screen instructions for the initial password change.
Line 87: Line 99:
 
For users familiar with the linux operation system you may proceed to edit the system manually.
 
For users familiar with the linux operation system you may proceed to edit the system manually.
  
For users not familiar with linux and PTTLink, at the Linux CLI (command line interface)
+
For users not familiar with linux and PttLink, at the Linux CLI (command line interface)
  
Type  '''sudo pttlink-menu'''  as the example below shows.
+
Type  '''sudo asl-menu'''  as the example below shows.
  
sudo pttlink-menu
+
repeater@repeater:~$ sudo asl-menu
  
 
This will load the PTTLink configuration menu.
 
This will load the PTTLink configuration menu.
[[File:ptt menu 1.png|none|thumb|640x640px]]
+
[[File:Asl menu main screen.png|none|thumb|640x640px]]
  
 
== PTTLink software setup ==
 
== PTTLink software setup ==
  
 
Choose option '''<1>'''.
 
Choose option '''<1>'''.
[[File:Ptt first time.png|none|thumb|640x640px]]
+
[[File:002_first_time.png|none|thumb|640x640px]]
 +
 
 +
Since it is your first time setup, answer  '''<Yes>''' so you can setup a "'''root'''" password. Don't forget to write down your user an password.
 +
[[File:003_password.png|none|thumb|640x640px]]
  
 
Setup now will ask if you want to change "'''repeater'''" account password with you should already changed at first time login so answer '''<No>''', unless you want to change it again. Do not forget to write it down.
 
Setup now will ask if you want to change "'''repeater'''" account password with you should already changed at first time login so answer '''<No>''', unless you want to change it again. Do not forget to write it down.
[[File:Ptt repeater password prompt.png|none|thumb|640x640px]]
+
[[File:004_repeater_password.png|none|thumb|640x640px]]
 
 
Next, cause it is your first time setup, answer  '''<Yes>''' so you can setup a "'''root'''" password. Don't forget to write down your user and password.
 
[[File:Ptt root password prompt.png|none|thumb|640x640px]]
 
 
 
  
Now let's set time zone '''<Ok>'''.
+
Now lets set time zone '''<Ok>'''.
[[File:Ptt timezone setup.png|none|thumb|640x640px]]
+
[[File:005_timezone.png|none|thumb|640x640px]]
  
 
Choose the node's continent.
 
Choose the node's continent.
[[File:Ptt geo area.png|none|thumb|640x640px]]
+
[[File:006_continent.png|none|thumb|640x640px]]
  
 
Choose the node's city.
 
Choose the node's city.
[[File:Ptt time zone.png|none|thumb|640x640px]]
+
[[File:007_city.png|none|thumb|640x640px]]
  
 
Next you can change the name of you host name, the default is '''repeater'''.
 
Next you can change the name of you host name, the default is '''repeater'''.
[[File:Ptt by default.png|none|thumb|640x640px]]
+
[[File:008_message.png|none|thumb|640x640px]]
 +
 
 +
Answer '''<Yes>''' to be able to make changes.
 +
[[File:009_edit_hostname.png|none|thumb|640x640px]]
  
 
Type the new host name and hit '''<Enter>'''.
 
Type the new host name and hit '''<Enter>'''.
[[File:Ptt hostname prompt.png|none|thumb|640x640px]]
+
[[File:010_hostname.png|none|thumb|640x640px]]
  
 
If you want to set up a domain, type it and hit '''<Enter>'''.
 
If you want to set up a domain, type it and hit '''<Enter>'''.
[[File:Ptt domain prompt.png|none|thumb|640x640px]]
+
[[File:011_domain_name.png|none|thumb|640x640px]]
  
 
Say '''<Ok>''' to this message.
 
Say '''<Ok>''' to this message.
[[File:Ptt existing hostname.png|none|thumb|640x640px]]
+
[[File:012_message.png|none|thumb|640x640px]]
  
 
Now you can make your network settings '''<Ok>'''.
 
Now you can make your network settings '''<Ok>'''.
[[File:Ptt setting for dhcp.png|none|thumb|640x640px]]
+
[[File:013_dhcp.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt you can network.png|none|thumb|640x640px]]
+
[[File:014_network.png|none|thumb|640x640px]]
  
 
To choose between DHCP or Static IP say '''<Yes>'''.
 
To choose between DHCP or Static IP say '''<Yes>'''.
[[File:Ptt network setup.png|none|thumb|640x640px]]
+
[[File:015_dhcp_static.png|none|thumb|640x640px]]
  
 
Use '''<D>''' for DHCP or  '''<nowiki><S></nowiki>'''.  for Static, if you choose Static, you will be asked to enter it next, for this example DHCP is in use.
 
Use '''<D>''' for DHCP or  '''<nowiki><S></nowiki>'''.  for Static, if you choose Static, you will be asked to enter it next, for this example DHCP is in use.
[[File:Ptt dhcp or static.png|none|thumb|640x640px]]
+
[[File:016_dhcp_static.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt commented out.png|none|thumb|640x640px]]
+
[[File:017_message.png|none|thumb|640x640px]]
 
 
As you already selected DHCP now select '''<Back>''' to continue.
 
[[File:Ptt dhcp or static.png|none|thumb|640x640px]]
 
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt you will now move.png|none|thumb|640x640px]]
+
[[File:018_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt importing the.png|none|thumb|640x640px]]
+
[[File:019_message.png|none|thumb|640x640px]]
  
 
Choose option '''<A1>'''.
 
Choose option '''<A1>'''.
[[File:Ptt a menu a1.png|none|thumb|640x640px]]
+
[[File:020_a_menu_a1.png|none|thumb|640x640px]]
  
 
Choose option '''<N1>'''.
 
Choose option '''<N1>'''.
[[File:Ptt n menu n1.png|none|thumb|640x640px]]
+
[[File:021_n_menu_n1.png|none|thumb|640x640px]]
  
 
Type the node number for your node. Yes the one you previously wrote down from PTTLink site.
 
Type the node number for your node. Yes the one you previously wrote down from PTTLink site.
[[File:Ptt node number prompt.png|none|thumb|640x640px]]
+
[[File:022_node_number.png|none|thumb|640x640px]]
  
 
Choose option '''<N2>'''.
 
Choose option '''<N2>'''.
[[File:Ptt n menu n2.png|none|thumb|640x640px]]
+
[[File:023_n_menu_n2.png|none|thumb|640x640px]]
  
 
Type the node password for your node. Yes the one you previously wrote down from PTTLink site.
 
Type the node password for your node. Yes the one you previously wrote down from PTTLink site.
[[File:Ptt node password prompt.png|none|thumb|640x640px]]
+
[[File:024_node_password.png|none|thumb|640x640px]]
  
 
Choose option '''<N3>'''.
 
Choose option '''<N3>'''.
[[File:Ptt n menu n3.png|none|thumb|640x640px]]
+
[[File:025_n_menu_n3.png|none|thumb|640x640px]]
  
 
Type the call sign for your node. Yes the one you previously wrote down from PTTLink site.
 
Type the call sign for your node. Yes the one you previously wrote down from PTTLink site.
[[File:Ptt call sign prompt.png|none|thumb|640x640px]]
+
[[File:026_callsign.png|none|thumb|640x640px]]
  
 
Choose option '''<N4>'''.
 
Choose option '''<N4>'''.
[[File:Ptt n menu n4.png|none|thumb|640x640px]]
+
[[File:027_n_menu_n4.png|none|thumb|640x640px]]
  
 
Choose option '''<I1>'''.
 
Choose option '''<I1>'''.
[[File:Ptt i menu i1.png|none|thumb|640x640px]]
+
[[File:028_i_menu_i1.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt enable simpleusb.png|none|thumb|640x640px]]
+
[[File:029_message.png|none|thumb|640x640px]]
  
 
Choose option '''<N5>'''.
 
Choose option '''<N5>'''.
[[File:Ptt n menu n5.png|none|thumb|640x640px]]
+
[[File:030_n_menu_n5.png|none|thumb|640x640px]]
  
 
If your node will be a simplex node type '''<1>'''.
 
If your node will be a simplex node type '''<1>'''.
 
If your node is a repeater controller type '''<2>'''.
 
If your node is a repeater controller type '''<2>'''.
[[File:Ptt duplex type.png|none|thumb|640x640px]]
+
[[File:031_rptr_mode.png|none|thumb|640x640px]]
  
 
Choose option '''<N6>'''.
 
Choose option '''<N6>'''.
[[File:Ptt n menu n6.png|none|thumb|640x640px]]
+
[[File:032_n_menu_n6.png|none|thumb|640x640px]]
  
 
Type a new password, this will be used to have access from the nodes web site Allmon2, the default password is 'llcgi'.
 
Type a new password, this will be used to have access from the nodes web site Allmon2, the default password is 'llcgi'.
[[File:Ptt manager password prompt.png|none|thumb|640x640px]]
+
[[File:033_password.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt setting new.png|none|thumb|640x640px]]
+
[[File:034_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt creating basic.png|none|thumb|640x640px]]
+
[[File:036_message.png|none|thumb|640x640px]]
  
 
Choose option '''<N9>'''.
 
Choose option '''<N9>'''.
[[File:Ptt n menu n9.png|none|thumb|640x640px]]
+
[[File:037_n_menu_n9.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt setting repeaters.png|none|thumb|640x640px]]
+
[[File:038_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt enabling pttlink.png|none|thumb|640x640px]]
+
[[File:039_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt setting the node.png|none|thumb|640x640px]]
+
[[File:040_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt setting node.png|none|thumb|640x640px]]
+
[[File:041_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt enabling the.png|none|thumb|640x640px]]
+
[[File:042_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt setting duplex.png|none|thumb|640x640px]]
+
[[File:043_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt node number.png|none|thumb|640x640px]]
+
[[File:044_message.png|none|thumb|640x640px]]
  
 
Choose option '''<Back>'''.
 
Choose option '''<Back>'''.
[[File:Ptt n menu back.png|none|thumb|640x640px]]
+
[[File:045_n_menu_back.png|none|thumb|640x640px]]
  
 
Choose option '''<AZ>'''.
 
Choose option '''<AZ>'''.
[[File:Ptt a menu az.png|none|thumb|640x640px]]
+
[[File:046_a_menu_az.png|none|thumb|640x640px]]
  
Review what you wrote down with what you have configured on your system and press '''<Enter>'''.
+
Review what you wrote down with what you have configured on your systemand press '''<Enter>'''.
[[File:Ptt review.png|none|thumb|640x640px]]
+
[[File:047_review.png|none|thumb|640x640px]]
  
 
Choose '''<Yes>''' to backup your configuration.
 
Choose '''<Yes>''' to backup your configuration.
[[File:Ptt backup and save.png|none|thumb|640x640px]]
+
[[File:048_backup.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt your original.png|none|thumb|640x640px]]
+
[[File:049_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt new configuration.png|none|thumb|640x640px]]
+
[[File:050_message.png|none|thumb|640x640px]]
  
 
Just say '''<Ok>''' to this message.
 
Just say '''<Ok>''' to this message.
[[File:Ptt asterisk reload.png|none|thumb|640x640px]]
+
[[File:051_message.png|none|thumb|640x640px]]
  
 
Choose option '''<Exit>'''.
 
Choose option '''<Exit>'''.
[[File:Ptt a menu exit.png|none|thumb|640x640px]]
+
[[File:052_a-menu_exit.png|none|thumb|640x640px]]
  
 
Answer '''<Yes>''', because we already saved our configuration.
 
Answer '''<Yes>''', because we already saved our configuration.
[[File:Ptt exit.png|none|thumb|640x640px]]
+
[[File:053_exit.png|none|thumb|640x640px]]
  
 
If you want to automatically start your system with this menu answer '''<Yes>''', if not then '''<No>'''.
 
If you want to automatically start your system with this menu answer '''<Yes>''', if not then '''<No>'''.
[[File:Ptt select menu at login.png|none|thumb|640x640px]]
+
[[File:054_select_menu_sartup.png|none|thumb|640x640px]]
  
If you answer was '''<No>''', remember you can come back to this menu typing  '''sudo pttlink-menu'''  as the following example:
+
If you answer was '''<No>''', remember you can come back to this menu typing  '''sudo asl-menu'''  as the following example:
  
sudo pttlink-menu
+
repeater@repeater:~$ sudo asl-menu
  
[[File:Ptt you may.png|none|thumb|640x640px]]
+
[[File:055_message.png|none|thumb|640x640px]]
  
 
Now your node will reboot to apply all the changes we have done, so say '''<Ok>'''.
 
Now your node will reboot to apply all the changes we have done, so say '''<Ok>'''.
[[File:Ptt setup is complete.png|none|thumb|640x640px]]
+
[[File:056_reboot.png|none|thumb|640x640px]]
  
 
== PTTLink Audio settings with SimpleUSB ==
 
== PTTLink Audio settings with SimpleUSB ==
 +
Once you've hooked up a radio with your desired interface, it's time to test and tune the audio from the radio.
  
type  '''sudo ptlink-menu'''  like the example bellow:
+
type  '''sudo asl-menu'''  like the example below:
  
sudo pttlink-menu
+
repeater@repeater:~$ sudo asl-menu
  
 
Choose option '''<4>'''.
 
Choose option '''<4>'''.
[[File:Ptt menu 4.png|none|thumb|640x640px]]
+
[[File:101_asl_menu_4.png|none|thumb|640x640px]]
  
 
With option '''<F>''', will trigger PTT few times on your radio for testing, you should also listen a test tone.
 
With option '''<F>''', will trigger PTT few times on your radio for testing, you should also listen a test tone.
Line 286: Line 298:
 
To achieve that, you can type values between 0 and 999 and press '''<Enter>''' to apply the new value. The system will Tx a test tone for 5 seconds. If you do not set any value and hit '''<Enter>''', you will exit this function keeping the last typed value on RAM.
 
To achieve that, you can type values between 0 and 999 and press '''<Enter>''' to apply the new value. The system will Tx a test tone for 5 seconds. If you do not set any value and hit '''<Enter>''', you will exit this function keeping the last typed value on RAM.
  
Do not forget to turn off the tone generator by pressing once again '''<T>'''.
+
Do not forget to turn of the tone generator by pressing once again '''<T>'''.
  
 
Once you are happy with your settings, type '''<W>''' and '''<Enter>'''.
 
Once you are happy with your settings, type '''<W>''' and '''<Enter>'''.
  
 
To exit from this menu type '''<0>''' (zero) and hit '''<Enter>'''.
 
To exit from this menu type '''<0>''' (zero) and hit '''<Enter>'''.
 
  
 
== PTT and COS polarity settings ==
 
== PTT and COS polarity settings ==
  
If your radio, need PTT and/or COS/CTCSS polarity to be inverted go to the mail PTTLink menu and choose option '''<6>'''.
+
Your radio may require PTT and/or COS/CTCSS polarity to be inverted to work properly.  To do this, go to the main ASL menu and choose option '''<6>'''.
[[File:Ptt menu 6.png|none|thumb|640x640px]]
+
[[File:103_asl_menu_6.png|none|thumb|640x640px]]
  
 
Choose option '''<nowiki><I></nowiki>'''.
 
Choose option '''<nowiki><I></nowiki>'''.
[[File:Ptt configuration menu i.png|none|thumb|640x640px]]
+
[[File:104_config_menu_i.png|none|thumb|640x640px]]
  
You will be logger to a text file where you will need to find and edit some values:
+
You will be taken to a text file where you will need to find and edit some values:
  
 
PTT invert:
 
PTT invert:
  
Search for the line beginning with '''invertptt ='''  and change its value as follows:
+
Search for the line begining with '''invertptt ='''  and change its value as follows:
  
'''0''' = Ground to Transmit.
+
'''0''' = Ground to Transmit (most common).
  
 
'''1''' = Open to Transmit.
 
'''1''' = Open to Transmit.
[[File:Ptt invertptt.png|none|thumb|640x640px]]
+
[[File:Ptt_invertptt.png|none|thumb|640x640px]]
  
 
COS/CTCSS invert:
 
COS/CTCSS invert:
  
Search for the line beggining with '''carrierfrom ='''  and change its value as follows.
+
Search for the line beginning with '''carrierfrom ='''  and change its value as follows.
  
Search for the line beggining with '''ctcssfrom ='''  and change its value as follows.
+
Search for the line beginning with '''ctcssfrom ='''  and change its value as follows.
  
 
'''no''' = No carrier detection at all.
 
'''no''' = No carrier detection at all.
  
'''usb''' = Cor line active Hi.
+
'''usb''' = COR (COS) line active Hi.
  
'''usbinvert''' = Cor line active Low.
+
'''usbinvert''' = COR (COS) line active Low.
[[File:Ptt invertcarrier.png|none|thumb|640x640px]]
+
[[File:Ptt_invertcarrier.png|none|thumb|640x640px]]
  
 
After making your changes type '''<CTRL> + <X>''' and then type '''<Y>''' followed by '''<Enter>'''. You will be back to the previous menu and choose '''<Back>'''.
 
After making your changes type '''<CTRL> + <X>''' and then type '''<Y>''' followed by '''<Enter>'''. You will be back to the previous menu and choose '''<Back>'''.
  
 
Choose Option '''<9>'''.
 
Choose Option '''<9>'''.
[[File:Ptt menu 9.png|none|thumb|640x640px]]
+
[[File:107_asl_menu_9.png|none|thumb|640x640px]]
 +
 
 +
Choose option '''<G>''' to restart PTTLink software and apply changes. Choose '''<Back>''', repeat your audio test if needed.
 +
[[File:108_diag_menu_g.png|none|thumb|640x640px]]
 +
 
 +
== Ensure the nodelist is downloading ==
 +
Before your node will connect it needs to have the nodelist available.  This file will automatically be downloaded by systems support scripts and placed into /var/lib/asterisk/rpt_nodes.
 +
 
 +
If for some reason your node never downloads the nodelist, it may mean you are missing the required support scripts and configuration.
 +
 
 +
=== Add missing NodeUpdate.sh and NodeNameUpdate.sh scripts ===
 +
Copy the following if you are missing the scripts below in /usr/local/bin and do not have contab entries that call them
 +
 
 +
* Copy the following to /usr/local/bin/NodeUpdate.sh
 +
<syntaxhighlight lang="sh">
 +
#!/bin/bash
 +
#
 +
# A cron job script for downloading the extnodes file with error reporting
 +
#
 +
#
 +
# This is intended to be run from cron every 5 min
 +
#  Copyright 2018 Bryan Fields
 +
#  Licensed under the GNU GPLv2
 +
 
 +
URL="http://register.pttlink.org/cgi-bin/gennodes.php"
 +
FILEPATH=/var/lib/asterisk
 +
 
 +
#sleep for a random time of 0-300 seconds
 +
#sleep $[( $RANDOM % 299 )  + 1 ]s
 +
 
 +
 
 +
# use curl in silent and compressed mode, connect timeout of 5 and
 +
# -f for fail with an error code of 22 on server errors
 +
#-m 20 is a max time for the whole process of 20 seconds
 +
curl -s --compressed --connect-timeout 5 -f -m 20 -o /tmp/rpt_extnodes-temp $URL
 +
#curl --connect-timeout 5 -f -m 20 -o /tmp/rpt_extnodes-temp $URL
 +
exitcode=$?
 +
if [ "$exitcode" = "0" ]; then
 +
    grep -q extnodes /tmp/rpt_extnodes-temp
 +
        if [ $? -eq "0" ] ;then
 +
            chmod 700 /tmp/rpt_extnodes-temp
 +
            cp /tmp/rpt_extnodes-temp $FILEPATH/rpt_extnodes-temp
 +
            mv -f $FILEPATH/rpt_extnodes-temp $FILEPATH/rpt_extnodes
 +
            whenandwhere=`grep "Generated at" /tmp/rpt_extnodes-temp |cut -c2-100`
 +
            #don't print out on good run
 +
    #echo "NodeUpdate installed a new nodes list $whenandwhere"
 +
    logger -i "NodeUpdate installed a new nodes list $whenandwhere"
 +
        else
 +
            #echo "NodeUpdate failed to parse node list; node list not updated"
 +
    logger -i "NodeUpdate failed to parse node list; node list not updated"
 +
            exit 1
 +
        fi
 +
 
 +
else
 +
    #echo "NodeUpdate could not get nodes list from server"
 +
    logger -i "NodeUpdate could not get nodes list from server"
 +
    exit 1
 +
fi
 +
exit 0
 +
</syntaxhighlight>
 +
* Copy the following to /usr/local/bin/NodeNameUpdate.sh
 +
<syntaxhighlight lang="sh">
 +
#!/bin/bash
 +
#
 +
# A cron job script for downloading custom node announcements with error reporting
 +
#
 +
# This is intended to be run from cron every 8 hours and will randomly insert a delay from 0-8 hours
 +
#
 +
#  Copyright 2018 Bryan Fields
 +
#  Licensed under the GNU GPLv2
 +
 
 +
URL="rsync://rsync.pttlink.org/connect-messages"
 +
FILEPATH="/var/lib/asterisk/sounds/rpt/nodenames"
 +
 
 +
#sleep for a random time of 0-28800 seconds (8 hours)
 +
sleep $[ ( $RANDOM % 28799 )  + 1 ]s
 +
 
 +
#assign the filesUpdated var with the number of files changed by rsync.  This is nasty, but it works.
 +
 
 +
filesUpdated=`rsync -a --stats $URL $FILEPATH |grep "Number of regular files transferred" | cut -c 38-50`
 +
exitcode=$?
 +
if [ "$exitcode" = "0" ]; then
 +
    if [ "$filesUpdated" = "0" ]; then
 +
echo "NodeNameUpdate run with no updates"
 +
logger -i "NodeNameUpdate run with no updates"
 +
    elif [ "$filesUpdated" > "0" ]; then
 +
echo "NodeNameUpdate updated $filesUpdated nodenames"
 +
        logger -i "NodeNameUpdate updated $filesUpdated nodenames"
 +
    fi
 +
else
 +
    echo "NodeNameUpdate failed"
 +
    logger -i "NodeUpdate failed"
 +
    exit 1
 +
fi
 +
exit 0
 +
</syntaxhighlight>
 +
* Add entries to crontab
 +
<syntaxhighlight lang="text">
 +
0 0,8,16 * * * root /usr/local/bin/NodeNameUpdate.sh > /dev/null 2>&1
 +
*/5 * * * * root /usr/local/bin/NodeUpdate.sh > /dev/null 2>&1
 +
01 03 * * * cd /var/www/html/allmon2; ./astdb.php
 +
</syntaxhighlight>
 +
 
 +
== PTTLink Configuration Updates ==
 +
Run the following commands to add PTTLink server address.
 +
 
 +
<pre>
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/rc.updatenodelist
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/NodeNameUpdate.sh
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/NodeUpdate.sh
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/rpt.conf
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/iax.conf
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/extensions.conf
  
Choose option '''<G>''' to restar PTTLink software and apply changes. Choose '''<Back>''', repeat your audio test if needed.
+
sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/astdb.php
[[File:Ptt system menu g.png|none|thumb|640x640px]]
+
sudo sed -i 's/Allstar /PTTLink / g' /var/www/html/allmon2/header.inc
 +
sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/link.php
  
 +
sudo service asterisk restart
 +
</pre>
  
At this point your node should be up and running.
+
Edit the following file with:
  
== Port forwarding ==
+
<pre>
 +
sudo nano /usr/local/sbin/astdb.php
 +
</pre>
  
 +
Replace line:
  
You will need to forward port 4569 on your ISP modem. As there are many brands and modems, it is not possible to show a step to step guide.
+
<pre>
 +
$url = "https://allstarlink.org/cgi-bin/allmondb.pl";
 +
</pre>
  
 +
with:
  
== Allmon2 Setup. ==
+
<pre>
 +
$url = "http://allmondb.pttlink.org";
 +
</pre>
  
*[[PttLink Allmon2 Install]] - Allmon2 setup.
+
Restart your system.
  
== Allmon2 web control. ==
+
sudo reboot
  
TBD
+
At this point your node should be up and running.
  
== DTMF control. ==
+
== Allmon2 Setup. ==
  
TBD
+
*[[Allmon2 Install]] - Allmon2 setup.

Latest revision as of 17:52, 18 April 2022

PTTLink for beginners.

The first step is to create an account.

Go to https://pttlink.org/ and click on the <Login/Sign Up> link.

Ptt site menu login.png

Next click the <Sign Up> link.

Ptt site sign up.png

Download PTTLink image file

While you are awaiting the verification of your account (usually within 24 hours) you may download one of the image files for you computer system you will use to run your PTTLink node.

Go to wiki.pttlink.org scroll down to the Downloads section and select the appropriate image for the type of system you will use.

ASL download.png

Write the image file to media. Either a USB memory stick, CD or DVD, or a microSD card (Raspberry Pi).

Login to your account

You will need to login to your account at https://PTTLink.org/

Ptt site menu login.png

Click on <Login/Sign Up> as shown in the image above.

Ptt site login.png

Create a Server

You will need to create a "server" : Click on <Portal> then <Server Settings>.

Ptt site server settings.png

Click on <Add a new server>.

Please take the time to read the instructions on each page.

Then click <Proceed with Server Setup> if needed.

Fill in all of the information and click <Submit> at the bottom of the page.

Ptt site server settings form.png

Request a Node number

At the top of the page, click <Portal> and then on <Node Settings>.

Ptt site node settings.png

Then click <Continue...>.

Ptt site request node number 1.png

Then click <Request>.

Ptt site request node number 2.png

Select which server you would wish to have a node number assigned to.

A comment of 'additional node on same server' would be appropriate if you are requesting a second node number.

Ptt site request node number 3.png

Once your node number request(s) are processed you will receive an email.

Edit Node settings

Log into your account on https://pttlink.org/

Click <Portal> then <Node settings>.

The PTTLink node numbers that have been assigned to you are displayed here.

Select which node you wish to view/edit.

Fill in the information for you node and click <Submit>.

Ptt site node settings form.png

Write down your node number, password and the call sign you assigned for the node as you will use them to configure your PTTLink system.


Install and configure PttLink to your computer

Consult your owners manual or your favorite internet search engine for how to install an image for your computer system.

Install the PTTLink disk image to your computer. Insert the appropriate media for your system and boot the computer.

When the login prompt appears enter the user ID of

repeater 

and press <Enter>.

Enter the default password of

allstarlink

Follow the on screen instructions for the initial password change.

For users familiar with the linux operation system you may proceed to edit the system manually.

For users not familiar with linux and PttLink, at the Linux CLI (command line interface)

Type sudo asl-menu as the example below shows.

repeater@repeater:~$ sudo asl-menu

This will load the PTTLink configuration menu.

Asl menu main screen.png

PTTLink software setup

Choose option <1>.

002 first time.png

Since it is your first time setup, answer <Yes> so you can setup a "root" password. Don't forget to write down your user an password.

003 password.png

Setup now will ask if you want to change "repeater" account password with you should already changed at first time login so answer <No>, unless you want to change it again. Do not forget to write it down.

004 repeater password.png

Now lets set time zone <Ok>.

005 timezone.png

Choose the node's continent.

006 continent.png

Choose the node's city.

007 city.png

Next you can change the name of you host name, the default is repeater.

008 message.png

Answer <Yes> to be able to make changes.

009 edit hostname.png

Type the new host name and hit <Enter>.

010 hostname.png

If you want to set up a domain, type it and hit <Enter>.

011 domain name.png

Say <Ok> to this message.

012 message.png

Now you can make your network settings <Ok>.

013 dhcp.png

Just say <Ok> to this message.

014 network.png

To choose between DHCP or Static IP say <Yes>.

015 dhcp static.png

Use <D> for DHCP or <S>. for Static, if you choose Static, you will be asked to enter it next, for this example DHCP is in use.

016 dhcp static.png

Just say <Ok> to this message.

017 message.png

Just say <Ok> to this message.

018 message.png

Just say <Ok> to this message.

019 message.png

Choose option <A1>.

020 a menu a1.png

Choose option <N1>.

021 n menu n1.png

Type the node number for your node. Yes the one you previously wrote down from PTTLink site.

022 node number.png

Choose option <N2>.

023 n menu n2.png

Type the node password for your node. Yes the one you previously wrote down from PTTLink site.

024 node password.png

Choose option <N3>.

025 n menu n3.png

Type the call sign for your node. Yes the one you previously wrote down from PTTLink site.

026 callsign.png

Choose option <N4>.

027 n menu n4.png

Choose option <I1>.

028 i menu i1.png

Just say <Ok> to this message.

029 message.png

Choose option <N5>.

030 n menu n5.png

If your node will be a simplex node type <1>. If your node is a repeater controller type <2>.

031 rptr mode.png

Choose option <N6>.

032 n menu n6.png

Type a new password, this will be used to have access from the nodes web site Allmon2, the default password is 'llcgi'.

033 password.png

Just say <Ok> to this message.

034 message.png

Just say <Ok> to this message.

036 message.png

Choose option <N9>.

037 n menu n9.png

Just say <Ok> to this message.

038 message.png

Just say <Ok> to this message.

039 message.png

Just say <Ok> to this message.

040 message.png

Just say <Ok> to this message.

041 message.png

Just say <Ok> to this message.

042 message.png

Just say <Ok> to this message.

043 message.png

Just say <Ok> to this message.

044 message.png

Choose option <Back>.

045 n menu back.png

Choose option <AZ>.

046 a menu az.png

Review what you wrote down with what you have configured on your systemand press <Enter>.

047 review.png

Choose <Yes> to backup your configuration.

048 backup.png

Just say <Ok> to this message.

049 message.png

Just say <Ok> to this message.

050 message.png

Just say <Ok> to this message.

051 message.png

Choose option <Exit>.

052 a-menu exit.png

Answer <Yes>, because we already saved our configuration.

053 exit.png

If you want to automatically start your system with this menu answer <Yes>, if not then <No>.

054 select menu sartup.png

If you answer was <No>, remember you can come back to this menu typing sudo asl-menu as the following example:

repeater@repeater:~$ sudo asl-menu

055 message.png

Now your node will reboot to apply all the changes we have done, so say <Ok>.

056 reboot.png

PTTLink Audio settings with SimpleUSB

Once you've hooked up a radio with your desired interface, it's time to test and tune the audio from the radio.

type sudo asl-menu like the example below:

repeater@repeater:~$ sudo asl-menu

Choose option <4>.

101 asl menu 4.png

With option <F>, will trigger PTT few times on your radio for testing, you should also listen a test tone.

Next, with option <2>, you can adjust the audio levels from your radio to your node node with the aim of an on-screen level meter.

With another radio transmit a test tone or voice and type values between 0 and 999 followed by <Enter> to apply them, if you do not set any value and hit <Enter>, you will exit this function keeping the last typed value on RAM.

Next, type option <T>, you can toggle a tone generator to adjust your node to radio audio levels, so type it once to turn it on.

Now typing option <3>, will allow you to adjust the audio from your node to your Tx radio.

To achieve that, you can type values between 0 and 999 and press <Enter> to apply the new value. The system will Tx a test tone for 5 seconds. If you do not set any value and hit <Enter>, you will exit this function keeping the last typed value on RAM.

Do not forget to turn of the tone generator by pressing once again <T>.

Once you are happy with your settings, type <W> and <Enter>.

To exit from this menu type <0> (zero) and hit <Enter>.

PTT and COS polarity settings

Your radio may require PTT and/or COS/CTCSS polarity to be inverted to work properly. To do this, go to the main ASL menu and choose option <6>.

103 asl menu 6.png

Choose option <I>.

104 config menu i.png

You will be taken to a text file where you will need to find and edit some values:

PTT invert:

Search for the line begining with invertptt = and change its value as follows:

0 = Ground to Transmit (most common).

1 = Open to Transmit.

Ptt invertptt.png

COS/CTCSS invert:

Search for the line beginning with carrierfrom = and change its value as follows.

Search for the line beginning with ctcssfrom = and change its value as follows.

no = No carrier detection at all.

usb = COR (COS) line active Hi.

usbinvert = COR (COS) line active Low.

Ptt invertcarrier.png

After making your changes type <CTRL> + <X> and then type <Y> followed by <Enter>. You will be back to the previous menu and choose <Back>.

Choose Option <9>.

107 asl menu 9.png

Choose option <G> to restart PTTLink software and apply changes. Choose <Back>, repeat your audio test if needed.

108 diag menu g.png

Ensure the nodelist is downloading

Before your node will connect it needs to have the nodelist available. This file will automatically be downloaded by systems support scripts and placed into /var/lib/asterisk/rpt_nodes.

If for some reason your node never downloads the nodelist, it may mean you are missing the required support scripts and configuration.

Add missing NodeUpdate.sh and NodeNameUpdate.sh scripts

Copy the following if you are missing the scripts below in /usr/local/bin and do not have contab entries that call them

  • Copy the following to /usr/local/bin/NodeUpdate.sh
#!/bin/bash
#
# A cron job script for downloading the extnodes file with error reporting
# 
#
# This is intended to be run from cron every 5 min
#  Copyright 2018 Bryan Fields
#  Licensed under the GNU GPLv2

URL="http://register.pttlink.org/cgi-bin/gennodes.php"
FILEPATH=/var/lib/asterisk

#sleep for a random time of 0-300 seconds
#sleep $[( $RANDOM % 299 )  + 1 ]s


# use curl in silent and compressed mode, connect timeout of 5 and
# -f for fail with an error code of 22 on server errors
#-m 20 is a max time for the whole process of 20 seconds
curl -s --compressed --connect-timeout 5 -f -m 20 -o /tmp/rpt_extnodes-temp $URL
#curl --connect-timeout 5 -f -m 20 -o /tmp/rpt_extnodes-temp $URL
exitcode=$?
if [ "$exitcode" = "0" ]; then
    grep -q extnodes /tmp/rpt_extnodes-temp
        if [ $? -eq "0" ] ;then
            chmod 700 /tmp/rpt_extnodes-temp
            cp /tmp/rpt_extnodes-temp $FILEPATH/rpt_extnodes-temp
            mv -f $FILEPATH/rpt_extnodes-temp $FILEPATH/rpt_extnodes
            whenandwhere=`grep "Generated at" /tmp/rpt_extnodes-temp |cut -c2-100`
            #don't print out on good run
	    #echo "NodeUpdate installed a new nodes list $whenandwhere"
	    logger -i "NodeUpdate installed a new nodes list $whenandwhere"
        else
            #echo "NodeUpdate failed to parse node list; node list not updated"
	    logger -i "NodeUpdate failed to parse node list; node list not updated"
            exit 1
        fi

else
    #echo "NodeUpdate could not get nodes list from server"
    logger -i "NodeUpdate could not get nodes list from server"
    exit 1
fi
exit 0
  • Copy the following to /usr/local/bin/NodeNameUpdate.sh
#!/bin/bash
#
# A cron job script for downloading custom node announcements with error reporting 
#
# This is intended to be run from cron every 8 hours and will randomly insert a delay from 0-8 hours
#
#  Copyright 2018 Bryan Fields
#  Licensed under the GNU GPLv2

URL="rsync://rsync.pttlink.org/connect-messages"
FILEPATH="/var/lib/asterisk/sounds/rpt/nodenames"

#sleep for a random time of 0-28800 seconds (8 hours)
sleep $[ ( $RANDOM % 28799 )  + 1 ]s

#assign the filesUpdated var with the number of files changed by rsync.  This is nasty, but it works.

filesUpdated=`rsync -a --stats $URL $FILEPATH |grep "Number of regular files transferred" | cut -c 38-50`
exitcode=$?
if [ "$exitcode" = "0" ]; then
    if [ "$filesUpdated" = "0" ]; then
	echo "NodeNameUpdate run with no updates"
	logger -i "NodeNameUpdate run with no updates"
    elif [ "$filesUpdated" > "0" ]; then
	echo "NodeNameUpdate updated $filesUpdated nodenames"
        logger -i "NodeNameUpdate updated $filesUpdated nodenames" 
    fi
else
    echo "NodeNameUpdate failed"
    logger -i "NodeUpdate failed"
    exit 1
fi
exit 0
  • Add entries to crontab
0 0,8,16 * * * 	root /usr/local/bin/NodeNameUpdate.sh > /dev/null 2>&1
*/5 * * * * 	root /usr/local/bin/NodeUpdate.sh > /dev/null 2>&1
01 03 * * * cd /var/www/html/allmon2; ./astdb.php

PTTLink Configuration Updates

Run the following commands to add PTTLink server address.

sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/rc.updatenodelist
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/NodeNameUpdate.sh
sudo sed -i 's/allstarlink.org/pttlink.org/g' /usr/local/bin/NodeUpdate.sh
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/rpt.conf
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/iax.conf
sudo sed -i 's/allstarlink.org/pttlink.org/g' /etc/asterisk/extensions.conf

sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/astdb.php
sudo sed -i 's/Allstar /PTTLink / g' /var/www/html/allmon2/header.inc
sudo sed -i 's/allstarlink.org/pttlink.org/g' /var/www/html/allmon2/link.php

sudo service asterisk restart

Edit the following file with:

sudo nano /usr/local/sbin/astdb.php

Replace line:

$url = "https://allstarlink.org/cgi-bin/allmondb.pl";

with:

$url = "http://allmondb.pttlink.org";

Restart your system.

sudo reboot 

At this point your node should be up and running.

Allmon2 Setup.