SvxlinkBuilder

<h1>Menu build for Raspberry Pi - Repeater or Hotspot node. EchoLink MetarInfo and SVXReflector Options</h1> <h2> Pour l'instruction en Français, README_FR.md. Para instrucción en español README_ES.md. Per le istruzioni in Italiano README_IT.md.</h2> <h3>Introduction</h3> This SVXLink build presently contains a connection only to the svxportal-uk (SvxReflector) only . If this changes then so will this introduction. You can leave it without, and install an svxreflector later through the Dashboard. The connection to the svxreflector provides connectivity using pseudo-talkgroups to other nodes and repeaters on the network. for more information select this link http://portal.svxlink.uk:81. This build now contains an automatic three minute timeout for RF users. This is to educate users to keep their speech from being too long. This timeout mechanism does not block the user whilst speaking, but superimposes a series of pip-tones with the emission, that are terminated, when the speaker releases the PTT. The squelch mechanism detects this, and sends "Time-out" verbally on the transmission, before issuing a "K" for continued use of the repeater. <h3>For users of the SA818 device</h3> There will be opportunity to select the programming of it during the installation progress. This is particularly important for the users of the uSvxCard with uDraCard from F8ASB and for the Guru-Rf Hotspot. For users of these devices, extra care and instructions may be required. Watch for them below. <h3>Your First Steps</h3> The Requirements: A Raspberry Pi of any mark, a USB Soundcard, and an interface card (or a modified USB Soundcard and no interface). One or two transceivers. Experience with Shell Commands will help, but is not essential. If you are suitably experienced, you will be able to modify the installation once it is complete. But this system will provide you with a working system, and you can then modify it to your own needs should you want to. There are very few other raspberry images that work succesfully for this type of build, where there is a potential for using the application in several directions. An image is fixed, leaving you with a lot of puzzling. This is not an image, but a menu-driven easy build. This New SVXLINKBUILDER uses an apt install, especially created to avoid the long and tedious approach of a compilation. <h2>Always use Raspberry OS Bookworm Lite (Debian 12) 32 Bit then you won't go wrong.</h2> Using Raspberry Pi Imager, select the Raspberry Pi OS (32-bit) Lite image. But ensure your user name is 'pi' and nothing else. The Imager will also allow you to configure your password, and WiFi if required. Ensure that the tab permitting SSH is enabled. <h3>Before running the software</h3> There are a number of available interface boards that have a variety of uses, either as a hotspot or a repeater, or even a fill-in receiver/transceiver for an existing SVXLink repeater. The settings in this build are for either a homebrew interface board using GPIOD 23/17/8 for the Receive COS and GPIOD 24/18/7 for the PTT controller, or a fully modified CM-108 that can use 'udev' and drive the PTT and COS from the modification components. There is an also intermediate version for the CM-108 where only the transmit modification has been done that will you use 'udev' for the transmit, and give you options for the receive GPIOD 23/17/8. There is also an option for your own GPIO port selection. This will be particularly useful for the users of the various hotspots, like the F8ASB or RF-Guru. The previous images for these devices are quite rigid, whereas this builder gives you the opportunity to fully integrate the up-to-date add-ons. The When using the GPIO and GPIOD Pins, an earth pin is also require, so using this combination for example, pins 14,16 and 18 are all adjacent and ideally placed for these functions. Pin 14 is the Earth, Pin 16 is GPIO 23 and Pin 18 is GPIO 24. For a second set of transceivers, you can consider GPIO 17 and 18 as COS & PTT for those. A copy of the design for an interface can be found on g4nab.co.uk. There is also a link to a web page showing the modification instructions for a CM-108 USB Sound Card. <h2>The programming of the SDCard</h2> As discussed, start with a download of Raspberry OS Bookworm Lite from RaspberryPi.org. Use a 8 or 16 GB MicroSD Card and transfer the image to the card, best using the Raspberry Pi Image builder from the same source. You MUST make the user 'pi' - PLEASE DO NOT DEVIATE from this advice, as you will get issues. You can however use your own password. There are versions of Raspberry Pi Imager for all operating systems. It allows for full WiFi usage. Do not forget the SSH tab in 'Services'. In the first box device select 'No Filtering' In the second box Choose OS select 'Raspberry Pi OS (Other)' then 'Raspberry Pi Os 32 Bit' under which you will see 'Debian Bookworm with no desktop environment'. Select this Now select Choose Storage where you will be invited to select the sdcard. In Next Complete the 'edit' box, but pi must be the user. If this is not correct, then your install will fail. You can have any password you like. You can set your Wi-Fi settings here if your wish. Always check the SSH box on the second tab of the next box, otherwise that will also cause your installation to fail. you can use a password or set a key if you wish. Once complete, eject the card and install it in the raspberry pi and power it up. Enter the user pi and your password. First perform sudo apt update && sudo apt upgrade -y before proceeding, then sudo apt install -y git <h2>Users of a usvxcard and the udracard from Juan Hagen F8ASB and the RF-Guru need to follow this additional step before the build. Other users skip to the next paragraph (The Build).</h2> Using the sudo raspb-config in the terminal, ensure that the serial interface is first enabled. Reboot the system and then log back in as the user pi and run the following commands in the terminal: sudo nano /boot/firmware/config.txt Add the following lines to the end of the file: dtoverlay=pi3-miniuart-bt enable_uart=1 Save the file. then sudo raspi-config and enable the second part of the serial port only Now reboot on closong the rasp-config login again as the user pi and run the following commands in the terminal: sudo apt install git -y git clone https://github.com/f5vmr/seeed-voicecard cd seeed-voicecard sudo ./install.sh This will install the audio drivers for the usvxcard and udracard. You can now proceed to the next step. There will be a further step to program the SA818 card, during the install process. <h2>The Build</h2> This script will also install a dummy sound card for the use of a Web Socket Step 1: sudo apt install -y git as without this you cannot download from the GitHub. Step 2: sudo git clone https://github.com/f5vmr/svxlinkbuilder.git . Step 3: At the prompt type ./svxlinkbuilder/preinstall.sh You need no input at this stage, until the system shutsdown for a reboot. It will take a while to complete, about 20 minutes. Step 4: Login again and at the prompt type ./svxlinkbuilder/install.sh Here you will be required to respond to a number of questions in the menu. They will guide you through the installation, all the way to run-time. You will need to know before you begin 1. The status of your transceiver, whether the PTT and COS are Active High or Active Low. The GPIO pin numbers. 2. The status and type of your USB soundcard, modified, partly modified or unmodified. With a fully modified usb soundcard, there is no reason that would prevent this installation on another Linux based computer running Debian 12. It has to be Debian 12, or some of the features will fail. 3. Decide The callsign of your node.Do not use additional symbols or numbers at this stage. The callsign should be of standard notation. 4. If you have decided to install EchoLink, then have ready your registration information. 5. If you wish to use ModuleMetarInfo, the Airport Weather application, then read about the ICAO codes, and discover the major airports around you. It will not work for airports that do not provide a weather service in real time. 6. If you wish to explore the ModulePropagationMonitor, then this can be installed later. Remember note everything down before you proceed. Everything else will be constructed for you <h2>Beginning the install</h2> The script will compile the running configuration as you proceed. It can only be run once, due to the nature of the program. Allow yourself an uninterupted period of 30 minutes, to answer the questions put to you, and the accompanying install. A Raspberry Pi 3 or 4 will take less time, and a Raspberry Pi zero possibly slightly longer. However the Raspberry Pi Zero will present a challenge due to the lack of an external USB socket. I have NOT included the installation of the waveshare sound system, if you are using a Pi-Hat interface. Hopefully there should be no reported error. I have just completed a build on a raspberry pi 3A from card format to working node in about 25 minutes, with no errors. For the American User, the en_US Voice files will be pulled if you select 'English - USA' from the menu. I hope that there will be someone out there that can add to the code for Portuguese. During the compilation, you will be notified of the Active IP Address of your

Svxlinkbuilder

Install / Use

README

SvxlinkBuilder