Echolink - svxlink-logo.png Server

Contents:
  1. Background Understanding of the svxlink project
  2. TCP/IP Ports Setup
  3. Install the svxlink-server Package
  4. Install svxlink Sounds
  5. Managing the Serial Devices for svxlink
  6. Managing the Sound Devices for svxlink
  7. Stereo Channels
  8. Other Serial Related parameters
  9. Test the Initial Install and Sound Output
  10. Setup the the Configuration Parameters for Echolink Operation
  11. Editing ModuleEcholink.conf
  12. Starting and Stopping SVXLink
  13. Radio - Tait T2015 with T2000-UIS Interface Card
  14. Interface Cable Construction
  15. Audio Connection and Considerations
  16. I/O Signal Matrix to DB9 Pinouts
  17. Tait 2015 Configuration Steps
  18. Sound Card Modifications
  19. Configuration of the VK4RBA-R Echolink Server
  20. IP_ALLOW in ModuleEcholink.conf
  21. CQiNet
  22. EchoLib
  23. Voice Announcement
  24. Usefull Commands
  25. GPIO Configuration
  26. References

[Top][Home]
Related Pages:
  1. Tait-Radio Line-Interface-Kits T-2000-UIS-AM2K-UIS.pdf
  2. Tait-Radios

[Top][Home]

The SvxLink Server AUDIO_CHANNEL Specify the audio channel to use. SvxLink can use the left/right stereo channels as two mono channels. Legal values are 0 or 1is a general purpose voice services system, developed by Tobias Blomberg, by SM0SVX which when connected to a transceiver, can act as both an advanced repeater system and can also operate on a simplex channel. One could call it a radio operating system since it sits between the hardware (transceiver) and the applications (modules) and handle basic system services as well as input and output.
Source:https://www.svxlink.org/

svxlink-server.jpg

6 These are my note from my experiences installing SVXLink on a Raspberry Pi 4 Model B Rev 1.2 with 4Gb RAM running Buster Raspbian GNU/Linux 10

[Top][Home]


Background Understanding of the svxlink project

There is a lot of information on this page. It is worth reading in order to get a background uderstanding of how the svxlink package operated.

https://github.com/sm0svx/svxlink/wiki/InstallationInstructions

[Top][Home]


TCP/IP Ports Setup

svxlink/EchoLink requires that your router or firewall allow inbound and outbound UDP to ports 5198 and 5199, and outbound TCP to port 5200. If you are using a home-network router, you will also need to configure the router to "forward" UDP ports 5198 and 5199 to the PC on which EchoLink is running.

Update the port fowarding in the access modem to point these ports to the IP address of the device running the svxlink server.

AUDIO_CHANNEL Specify the audio channel to use. SvxLink can use the left/right stereo channels as two mono channels. Legal values are 0 or 1 The " " command should show 5200, 5298, 5199 ports as open.


The nmap command should show the ports as open. ou will not see the internal IP but the selected device will be servicing the ports if they are open.



[Top][Home]


Install the svxlink-server Package

At date of writing the is the Debian Package, svxlink-server (17.12.2-4) and on the RPi Buster we will be installing for the arm64 architeture.:


[Top][Home]


Install svxlink Sounds

English Language Pack for SvxLink Server

This is an english language pack for SvxLink Server created using the Heather voice from the Acapela Box service.

NOTE CAREFULLY These are raw files which cannot be used directly with svxLink Server. They must first be processed using the filter_sounds.sh script to get the correct format.

Also, note that this is a commercial service and ever syllable has to be paid for. The prefered option is to download processed sound files from the releases page.Check here for the latest release: https://github.com/sm0svx/svxlink-sounds-en_US-heather/releases

Download the pre processed sound bites. Always check for the latest release.

At time of writing this is 19.09: https://github.com/sm0svx/svxlink-sounds-en_US-heather/releases/tag/19.09.99.1



[Top][Home]


Managing the Serial Devices for svxlink

Determine the USB to Serial Device (UART):



Edit svxlink.conf


see: http://www.svxlink.org/doc/man/man5/svxlink.conf.5.html#CONFIGURATION%20VARIABLES
for more detail son editinf sxvlink.conf.

[Top][Home]

Managing the Sound Devices for svxlink

Determine the Sound cards and their devices:



[Top][Home]

Stereo Channels

Edit AUDIO_CHANNEL in both [Rx1] and [Tx1] stanza in svxlink.conf.

AUDIO_CHANNEL Specify the audio channel to use. SvxLink can use the left/right stereo channels as two mono channels. Legal values are 0 or 1. Which channel is used for TX and which is used for X depends on how the cable is wired to the sound card jack. See Interface Cable Construction for how I have elected to wire the cable. The config settings must reflect the physical cable wiring.

[Top][Home]


Other Serial Related parameters

SQL_DET in [Rx1] Specifies the type of squelch detector to use. Possible values are: VOX, CTCSS, SERIAL, EVDEV, SIGLEV, PTY, GPIO or HIDRAW. I will use VOX.

PTT_PORT in [Tx1]

[Top][Home]


Test the Initial Install and Sound Output

In svxlink.conf in the [SimplexLogic] stanza set RX=NONE Only use this to test sounds as it directs audio out to computer default audio out device and not the device the radio is connected to. Start svxlink manually and issue the "*#" command:
[Top][Home]


Setup the the Configuration Parameters for Echolink Operation

Radio-Transceivers/Tait-Radios/Tait-Radios.html#T2000-UIS This is a way of testing that svxlink is operating and able to access the sound files:



svxlink.conf should look like this::


[Top][Home]


Edit ModuleEchoLink.conf



[Top][Home]

Starting and Stopping SVXLink



[Top][Home]

Radio - Tait T2015 with T2000-UIS Interface Card

A Tait T2015 with a T2000-UIS interface card was available for use. See the Tait radio page here, Tait-Line-Interface-Kits for more details on this model Tait radio

Link Setting:

LinkSet ToFunctionOptions
LK12-3LINE OUT Flat / De-emphasised1-2 Flat / 2-3 De-emphasised
LK2INMIC AUDIO to LINE OUTIN = YES / OUT = NO
LK3OUTBEEP to LINE OUTIN = YES / OUT = NO
LK4OUTLINE IN to LINE OUT Side ToneIN = YES / OUT = NO
LK51-2GATE OUT Source 1-2 BUSY + RX GATE
2-3 BUSY ONLY
2-4 TRUNKED BUSY
LK62-3LINE IN Flat / Pre- emphasised1-2 Flat / 2-3 Pre-emphasised
LK7INLINE IN to Volume & SpeakerIN = YES / OUT = NO
LK8INLINE IN Flat / Pre- emphasisedIN= Pre-emphasised / OUT = Flat
LK9INLINE IN 1 600 Terminated IN = YES / OUT = NO
LK10INLINE IN 2 600 Terminated IN = YES / OUT = NO
LK11OUT OUTLINE OUT, LINE IN, GATE OUT and PTT IN Control OUT = NONE
1-2 AUX SW
2-3 CALL SW
LK12OUTRX/TX Disabling IN = YES / OUT = NO
LK13OUTRX Disable IN = TX ONLY/ OUT = NO
LK14OUTGATE OUT PhaseOUT = Active Lo / IN = Active Hi
LK15OUTPTT IN PhaseOUT = Active Lo / IN = Active Hi
LK162-3GATE OUT Relay Phase1-2 N.C. / 2-3 N.O.
LK17OUTGATE OUT Common to Ground IN = GROUNDED / OUT = NOT
LK181-2I/O Signals matrix line 11 - Volts Source1-2 +13.8V SW / 2-3 +13.8V UNSW
or OUT = NONE
LK19INOPTO Coupler OptionIN = Yes / OUT = NO
LK2020TX Tail TimerIN = Yes / OUT = NO
LK212-3External Line Source1-2 /Emrgncy / 2-3 RX/TX Disabling
LK22 ** Not FoundLINE OUT 1 output impedanceIN = Very Low / OUT = 600 OHMS


Source: T-2000-UIS-AM2K-UIS.pdf

[Top][Home]

Interface Cable Construction

The Tait 9 pin Interface board is described here: T-2000-UIS-AM2K-UIS.pdf [local]

The Dongle end of the cable requires a female DB9 to plug into the Serial UART (usually a USB to Serial Dongle):

usb-to-serial-sm.jpg

Tail DB9 Pinouts:

DB9-F Pin No
(Radio Interface)
ColourFunction
Set in Config
To DB9-M Pin No
(Serial Port/UART)
1BlueDCD
2No ConnectionTX
3No ConnectionTX
4YellowDTR
5RedSignal GND
6No ConnectionDSR
7GreenRTS
8No ConnectionCTS
9No ConnectionRI


The Radio end of the cable is a male DB9 to plug into the Tait I/O Board (T2000-UIS S21 port). The pin outs are:

Tait-IO-port-2-sm.jpg

Tait Inferface Cable:

DB9 ColourConnected toUART SignalDescriptionI/O Tait Terminology
Pin 1WhiteAudio Out Cable
3.5mm Jack
Discriminator Audio Out from Radio
To mic input on sound card
OutLINE OUT 1
Pin 2BlueSerial UARTDCDRadio Busy IndicatorOut /GATE OUT 1
Pin 3No ConnectionGround-GROUND
Pin 4YellowSerial UARTDTRPTTIn/PTT IN 1
Pin 5RedAudio CableTransmit AudioInLINE IN 1
Pin 6Bare WireAudio In Cable
3.5mm Jack
Audio In GroundLINE IN 2
Pin 7GreenSerial UARTRTSNo Connect/PTT IN 2
Pin 8WhiteSerial UARTSignal GNDData MuteIn/GATE OUT 2
Pin 9Bare WireMic CableMic GroundAudio Out GroundOutLINE OUT 2


[Top][Home]
rect audio device.

Audio Connection and Considerations

Note that the sounds cards are, at mininium, two channel or stereophonic devices and the Radios are single channel or monaural devices, so only one channel is used+. Which channel is used is determined by the wiring and the setting in configuration in the svxlink.conf configuration file unde the relevant [Rx] stanza. The left stereo channel is Channel

The is can be tested with the speaker-test utility.

3mm-audio.jpeg
3.5-TRS-Audio-Male

Audio OUT from Radio on 3.5mm TRS Style Stereo Jack Audio Connections
Plugs into Microphone on sound card:

JackAudio SignalNameColourPin on Radio's DB9
TipLeft ChannelChannel 0White5
RingRight ChannelChannel 1RedNo Connect
SleeveAudio GroundCommonBare Wire6


Audio IN to Radio on 3.5mm TRS Style Stereo Jack Audio Connections
Plugs into Headphone on sound card:


JackAudio SignalNameColourPin on Radio's DB9
TipLeft ChannelChannel 0White1
RingRight ChannelChannel 1RedNo Connect
SleeveAudio GroundCommonBare Wire9

NOTE: Make sure that the CHANNEL=0 (left stereo channel) is set in svxlink.conf if using this wiring configuration.

[Top][Home]

I/O Signal Matrix to DB9 Pinouts

This is the standard layout and as set up in the Radio used in this project.

matrix-to-db9.png

[Top][Home]


Tait 2015 Configuration Steps

Step to configure the Tait Radio for SVXlink Server operation.

  1. Program the T2015 as required, i.e. Tx/Rx frequencies, etc.
  2. Confirm the T2015 is fully functional (i.e. test Tx/Rx and adjust if required)
  3. If no CTCSS is required, adjust microphone deviation for 5Khz (on a 25Khz channel) or if using CTCSS, 4.5Khz (on a 25Khz channel)
  4. Adjust sub audio deviation (if used) for 500Hz (on a 25Khz channel)
  5. If fitted remove R513 (0 ohm resistor) on Logic PCB linking options connector S14 Pin 5 (PTT-TO-OPT) and S14 pin 6 (PTT-FRM-OPT)
  6. On the UIT board, modify the I/O signals and I/O Pins matrix (changes are highlighted) as follows. RSSI Output on Pin 7 is optional.
  7. Modify the Link Settings as set out above.
  8. Connect / fit the A2000-UIT to the T2000 series II transceiver.


[Top][Home]

Sound Card Modifications

Cheap sound cards have a COB (black blob on the PCB) so any extra GPIO lines cannot be accessed, if they even exist. They do have status LEDs

[Top][Home]


Configuration of the VK4RBA-R Echolink Server

Leigh VK4LAH did an excellent job building and testing this svxlink Echolink server for the Brisbane Amateur Radio Club based at Roachdale, Brisbane. Futher testing is being conduced and some reconfiguration and fine tuning is anticitated.

Notes on this configuration:
Hardware employed on this site is a Raspberry Pi 3B, USB2 C-Media C108A sound card, and a prolific USB to serial cable. The radio transceiver is a Tait T2020 with a T2000-UIS interface card. There is a short RF link to the VK4RBA repeater station. In this configuration the Server is operating in simplex mode.

Serial pinouts in use are:

Some issues controlling the with the serial output When RTS is pulled low, the radio will transmit with the setting PTT_PIN=!RTS as the radio is using DTR as the reference.

At this stage the gate signal (pin 2) is not being actuated by the Serial Interface. It was attempted to use DCD to ground. This didn’t work because the A2000-UIS card needs a reference and it is suggestion to use the RTS or DTR signal. This interferes with the PTT function, so VOX was used.

The [Rx1] stanza of svxlink.conf:



sudo systemctl start svxlink sudo systemctl stop svxlink Monitor the system via the svxlink log. tail -f /var/log/svxlink The [Tx1] stanza of svxlink.conf:


[Top][Home]


IP_ALLOW in ModuleEcholink.conf

The IP_ALLOW in ModuleEcholink.conf is used to let clients on the local network to setup an EchoLink (voice) connection without being authenticated. Use this to run Qtel, connecting to your own node.

[Top][Home]


CQiNet

The SVXLink relied on the work done by CQiNet in decipering the Echolink Protocol

http://cqinet.sourceforge.net/index.shtml

EchoLib

EchoLib classes documentation:

http://www.svxlink.org/doxygen/echolib/index.html

[Top][Home]

Voice Announcement

Search for a Text to Speech site similar to this one and enter the required text. Select a site that allow for the downloading of an audio file. I selected "Australian/Nicole" on this site for the language and accent. After listening and making changes I save the mp3 file. For example I have to add spaces between somew of the characters VK4RBA to make it sound more naturally spoken.

https://ttsmp3.com/



[Top][Home]


Usefull Commands

sudo systemctl start svxlink
sudo systemctl stop svxlink
tail -f /var/log/svxlink
man svxlink
man svxlink.conf

[Top][Home]

GPIO Configuration











[Top][Home]

References

Man page for svxlink.conf:
http://www.svxlink.org/doc/man/man5/svxlink.conf.5.html#CONFIGURATION%20VARIABLES

The Wiki pages for SvxLink:
https://github.com/sm0svx/svxlink/wiki

https://jeff9v1as.files.wordpress.com/2015/04/how-to-install-svxlink-on-raspberry-pi.pdf

This is better resource:
http://np2wj.com/echolink-node-on-raspberry-pi-using-svxlink-part-1

http://www.pakhams.com/index.php?option=com_content&view=article&id=178:pi3echolink&catid=45:misc&Itemid=158 cd /usr/share/svxlink/sounds/

This is a quick instruction on how to install svxlink from source code. An easier way is to use pre-compiled packages already available in the latest Raspbian release.

Instruction on how to install svxlink from source code:
https://github.com/sm0svx/svxlink/wiki/installSRCHwRpi

These instructions explain how to install SvxLink on a Raspberry Pi, with pre-compiled packages from the official Raspbian software repository.

Instruction on how to install svxlink from the official Raspbian software repository:
https://github.com/sm0svx/svxlink/wiki/InstallBinRaspbian

Make SVXlink Tell 24h Time / UTC:
https://www.florian-wolters.de/blog/2017/08/11/make-svxlink-tell-24h-time-slash-utc/

[Top][Home]


Glenn Lyons VK4PK
glenn@LyonsComputer.com.au
Ver:gnl20200806 - pre published v0.9