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 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
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: Putty or MobaXterm
Change the default password ”raspberry” to something else, the command below change the password to ”newpassword”.
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.
If you can not reconnect to the new static ip address, something is wrong. Try power off/on, or connect a monitor.
latest 17.12.1 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
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
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 v22.214.171.124 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 v126.96.36.199 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.
Congratulations! You have successfully installed SvxLink! Now the fun begins. You should read the Post installation stuff chapter.
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