====== Installation instruction for Raspbian ======


This instruction explains how to install SvxLink with packages from the Raspbian official software repository. It does not cover all parts of the installation and configuration in detail, but is supposed to be easy to understand with limited knowledge and experience of Linux.

**Note:** Please browse through the instruction quickly, before you begin.


==== Download and install image ====
Download the image, Raspbian Stretch:
[[https://www.raspberrypi.org/downloads/raspbian/]]

//**Details:**
The official Raspbian installation instruction can be found here.
[[https://www.raspberrypi.org/documentation/installation/installing-images/README.md]] //

Download the image installation program **"Etcher"** and install the image on the card:
[[https://etcher.io/]]

Before inserting the SD-card in the Raspberry, **enable ssh**. Add a file named "ssh" in the root of the SD-card.
[[https://www.raspberrypi.org/documentation/remote-access/ssh/]]

Insert the SD-card and boot the Raspberry. The Raspberry PI will start with DHCP enabled (automatically request an ip-address from your local router). Find the ip-address of the raspberry pi, and logon. 
//**Details:**
[[https://www.raspberrypi.org/documentation/remote-access/ip-address.md]]//

==== Login and password ====
If you have a monitor and keyboard connected to your Raspberry, just logon at the prompt after it has started. You can also connect via ssh, without a monitor and keyboard connected. Good tools for SSH on Windows are: [[http://www.putty.org/|Putty]] or [[https://mobaxterm.mobatek.net/download.html|MobaXterm]]

**username:** pi

**password:** raspberry

Change the default password "raspberry" to something else, the command below change the password to "newpassword".
  passwd newpassword

==== Set static ip-address ====
 
Optionally set a static ip address by editing the dhcpcd.conf file. See the example in the bottom of the file. You can use "nano" editor. To save and exit the editor, press ctrl-x and answer Y to save:

  sudo nano /etc/dhcpcd.conf

Now is a good time to reboot your Raspberry.

  sudo reboot
  
If you can not reconnect to the new static ip address, something is wrong. Try power off/on, or connect a monitor.

==== Install svxlink ====

The 15.11+20171207~git445-380e5333-1 <del>**latest** 17.12.1</del> SvxLink release is not available directly in in the Raspbian Stretch image, but in the "testing" software repository (Buster release). To install the latest release, we temporarily add the Buster software repository and install SvxLink.
  sudo echo 'deb http://mirrordirector.raspbian.org/raspbian/ buster main' >> /tmp/svxlink.list
  sudo mv /tmp/svxlink.list /etc/apt/sources.list.d/
  sudo apt-get update

**Note:** Do NOT upgrade your complete system. We only want the SvxLink applications from the "buster" release!

Now install the svxlink-server package. The apt-get command will automatically select other packages needed for SvxLink to run.

  sudo apt-get -t buster install svxlink-server
  
Now remove the buster repository again.

  sudo rm /etc/apt/sources.list.d/svxlink.list

=== Install SvxLink sounds ===

Next install the English sounds for SvxLink with the following commands.

  cd /usr/share/svxlink/sounds/
  sudo wget https://github.com/sm0svx/svxlink-sounds-en_US-heather/releases/download/14.08/svxlink-sounds-en_US-heather-16k-13.12.tar.bz2
  sudo tar xvjf svxlink-sounds-en_US-heather-16k-13.12.tar.bz2
  sudo ln -s en_US-heather-16k en_US

==== Basic test of the SvxLink Installation ====

It is now time to do some basic tests of the SvxLink installation. Do NOT connect any extra USB-sound card, just connect a speaker to the 3.5mm audio output. The Speaker will be our TX. Since the Raspberry does not have a Microphone input, we need to disable the default RX (RX=NONE).

Edit the main SvxLink configuration file:

  sudo nano /etc/svxlink/svxlink.conf
  
In the SimplexLogic section, change the RX to NONE, and set your CALLSIGN.
  
  [SimplexLogic]
  TYPE=Simplex
  RX=NONE
  TX=Tx1
  MODULES=ModuleHelp,ModuleParrot,ModuleEchoLink,ModuleTclVoiceMail
  CALLSIGN=SK3W

For the 15.11+20171207~git445-380e5333-1 SvxLink package we also need to change owner of two directories.

  sudo chown svxlink:daemon /var/spool/svxlink/qso_recorder
  sudo chown svxlink:daemon /var/spool/svxlink/voice_mail

SvxLink is normally started from the a start script, but as a test it can be started on the command prompt. We start the program as the svxlink user. You will see some errors on missing configuration for echolink, this can be configured later. 

  sudo -u svxlink svxlink
  
  pi@raspberrypi:/usr/share/svxlink/sounds $ sudo -u svxlink svxlink
  SvxLink v1.5.99.17 Copyright (C) 2003-2017 Tobias Blomberg / SM0SVX
  SvxLink comes with ABSOLUTELY NO WARRANTY. This is free software, and you are
  welcome to redistribute it in accordance with the terms and conditions in the
  GNU GPL (General Public License) version 2 or later.
  
  Using configuration file: /etc/svxlink/svxlink.conf
  --- Using sample rate 48000Hz
  
  Starting logic: SimplexLogic
  Loading RX: NONE
  Loading TX: Tx1
  Loading module "ModuleHelp" into logic "SimplexLogic"
        Found /usr/lib/arm-linux-gnueabihf/svxlink/ModuleHelp.so
        Module Help v1.0.0 starting...
  Loading module "ModuleParrot" into logic "SimplexLogic"
        Found /usr/lib/arm-linux-gnueabihf/svxlink/ModuleParrot.so
        Module Parrot v1.1.1 starting...
  Loading module "ModuleEchoLink" into logic "SimplexLogic"
        Found /usr/lib/arm-linux-gnueabihf/svxlink/ModuleEchoLink.so
        Module EchoLink v1.3.99.1 starting...
  *** ERROR: Please set the EchoLink callsign (ModuleEchoLink/CALLSIGN) to a real callsign
  *** ERROR: Initialization failed for module ModuleEchoLink in logic SimplexLogic
  Loading module "ModuleTclVoiceMail" into logic "SimplexLogic" 
         Found /usr/lib/arm-linux-gnueabihf/svxlink/ModuleTcl.so
        Module Tcl v1.0.1 starting...
  SimplexLogic: Event handler script successfully loaded.
  
Enter *# on the keyboard, and you should hear your SimplexLogic identify itself in the speakers.

  SimplexLogic: digit=*
  SimplexLogic: digit=#
  Tx1: Turning the transmitter ON
  Tx1: Turning the transmitter OFF

Stop SvxLink by pressing ctrl-c. If the volume is too low, use alsamixer to increase the volume.

==== Configuration ====

Congratulations! You have successfully installed SvxLink! Now the fun begins.
You should read the [[https://github.com/sm0svx/svxlink/wiki/InstallationInstructions#Postinstallstuff|Post installation stuff]] chapter.


==== Good to know ====
The normal way to start and stop SvxLink on Rasbian is via scripts.

  sudo systemctl start svxlink
  sudo systemctl start svxlink
  
Monitor the system via the svxlink log.

  tail -f /var/log/svxlink
  
All manuals are available from the command prompt.

  man svxlink
  man svxlink.conf