Beginners Guide

From "PTTLink Wiki"
Jump to navigation Jump to search

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.

533x533px

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 pttlink

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 pttlink-menu as the example below shows.

sudo pttlink-menu

This will load the PTTLink configuration menu.

Ptt main menu.png

PTTLink software setup

Choose option <1>.

Ptt main menu.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.

Ptt repeater password prompt.png

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.

Ptt root password prompt.png


Now let's set time zone <Ok>.

Ptt timezone setup.png

Choose the node's continent.

Ptt geo area.png

Choose the node's city.

Ptt time zone.png

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

Ptt by default.png

Type the new host name and hit <Enter>.

Ptt hostname prompt.png

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

Ptt domain prompt.png

Say <Ok> to this message.

Ptt existing hostname.png

Now you can make your network settings <Ok>.

Ptt setting for dhcp.png

Just say <Ok> to this message.

Ptt you can network.png

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

Ptt network setup.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.

Ptt dhcp or static.png

Just say <Ok> to this message.

Ptt commented out.png

As you already selected DHCP now select <Back> to continue.

Ptt dhcp or static.png

Just say <Ok> to this message.

Ptt you will now move.png

Just say <Ok> to this message.

Ptt importing the.png

Choose option <A1>.

Ptt a menu a1.png

Choose option <N1>.

Ptt n menu n1.png

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

Ptt node number prompt.png

Choose option <N2>.

Ptt n menu n2.png

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

Ptt node password prompt.png

Choose option <N3>.

Ptt n menu n3.png

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

Ptt call sign prompt.png

Choose option <N4>.

Ptt n menu n4.png

Choose option <I1>.

Ptt i menu i1.png

Just say <Ok> to this message.

Ptt enable simpleusb.png

Choose option <N5>.

Ptt n menu n5.png

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

Ptt duplex type.png

Choose option <N6>.

Ptt 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'.

Ptt manager password prompt.png

Just say <Ok> to this message.

Ptt setting new.png

Just say <Ok> to this message.

Ptt creating basic.png

Choose option <N9>.

Ptt n menu n9.png

Just say <Ok> to this message.

Ptt setting repeaters.png

Just say <Ok> to this message.

Ptt enabling pttlink.png

Just say <Ok> to this message.

Ptt setting the node.png

Just say <Ok> to this message.

Ptt setting node.png

Just say <Ok> to this message.

Just say <Ok> to this message.

Ptt setting duplex.png

Just say <Ok> to this message.

Ptt node number.png

Choose option <Back>.

Ptt n menu back.png

Choose option <AZ>.

Ptt a menu az.png

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

Ptt review.png

Choose <Yes> to backup your configuration.

Ptt backup and save.png

Just say <Ok> to this message.

Ptt your original.png

Just say <Ok> to this message.

Ptt new configuration.png

Just say <Ok> to this message.

Ptt asterisk reload.png

Choose option <Exit>.

Ptt a menu exit.png

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

Ptt exit.png

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

Ptt select menu at login.png

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

sudo pttlink-menu
Ptt you may.png

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

Ptt setup is complete.png

PTTLink Audio settings with SimpleUSB

type sudo ptlink-menu like the example bellow:

sudo pttlink-menu

Choose option <4>.

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 off 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

If your radio, need PTT and/or COS/CTCSS polarity to be inverted go to the mail PTTLink menu and choose option <6>.

Choose option <I>.

Ptt configuration menu i.png

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

PTT invert:

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

0 = Ground to Transmit.

1 = Open to Transmit.

Ptt invertptt.png

COS/CTCSS invert:

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

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

no = No carrier detection at all.

usb = Cor line active Hi.

usbinvert = Cor 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>.

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


At this point your node should be up and running.

Port forwarding

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.


Allmon2 Setup.

Allmon2 web control.

TBD

DTMF control.

TBD