DVSwitch Installation and User GuideVersion 1.61

Table of ContentsIntroduction.1Getting Started.2How to install DVSwitch-Server on a Raspberry Pi.3DVSwitch Server Configuration.4Main Menu.4Initial Configuration.5Advanced Configuration.7Configure Other Stanzas.7TG/Ref DB Management.8Ad Hoc Menu & Macro.9Additional DMR Networks.10DVS Tools Menu.11Clone RPi SD Card.11Configure ini. files.11Update & Upgrade.11Language.12Restart DVSwitch Services.12Shutdown RPi Server.12Appendix A: DVSwitch Mobile Android Client.A-1Basic Configuration.A-1Dialer Screen.A-1Accounts Tab.A-2Mode Select Screen.A-3Talkgroup Listing.A-4Status Display.A-5Config Screen.A-6Macros Window.A-7Advanced Configuration.A-8Main Menu.A-8DMR Server Selection.A-8Setting Audio Levels.A-9Manage TG/Ref DB.A-10Tools Menu.A-10Appendix B: pyUC (python USRP Client).B-1Introduction.B-1Features.B-1Install Instructions by Platform.B-1Windows 10.B-1Linux.B-4Mac.B-6Configuration.B-7Using pyUC to Access DVSwitch.B-8The Main Screen.B-8Settings and About.B-9DVSwitch Installation and User Guide Version 1.61Page i

Table of Contents(Continued)Advanced Configuration.B-10Main Menu.B-10DMR Server Selection.B-10.B-11AUDIO GAIN Setup.B-11Manage TG/Ref DB.B-12Tools.B-13Appendix C: System Monitor.C-1Appendix D: Dashboard.D-1Appendix E: Installing DVSwitch on an existing Linux installation.E-1DVSwitch Installation and User Guide Version 1.61Page ii

IntroductionDVSwitch is a Client-Server application for Amateur Radio Digital Voice. The application provides a“Server” component which runs on a Raspberry Pi (RPi) or other Linux platform. It can also beinstalled on a cloud server running Linux. The server component is distributed as an RPi image with allfeatures and functions installed. Therefore, no additional modules or programs need to be downloadedor installed for a Raspberry Pi. There are two clients available for DVSwitch. An Android client isavailable on the Google App store for virtually any type of Android device. In addition, the pythonUSRP Client (pyUC) is available to use on Windows, Linux or Mac. Installation instructions for theServer and all Clients are provided in this document.DVSwitch supports all current Digital Voice modes with no additional hardware with the exception ofD-Star. For D-Star, an external hardware Vocoder such as the Northwest Digital ThumbDV dongle.For other modes, the software Vocoder included in DVSwitch provides high quality audioWhile DVSwitch has been in use for sometime but the installation was somewhat complex and wasmostly used by computer “geeks”. With this release, an average ham can be up and running in lessthan 10 minutes. This release provides many new features including the ability to switch modesdynamically, customize Talk Group, Room, and Reflector lists from either the server or client anddynamically switch among DMR networks such as Brandmeister, TGIF, QRM, etc.The basic components of the system are shown in the following diagram:DVSwitch Installation and User Guide Version 1.61Page 1

Getting StartedWhen installing for the first time, it is recommended that the user first print the following table andgather all the equipment and information needed to get the server up and running.CCS7/DMR IDNXDN IDTo operate on the DMR system, you need to register with anauthentication and routing system called CCS7 (CallsignCommunication System, 7-digit). For website DMR and NXID registration for North America,South America, Asia and Oceania go to:! All Europe and Africa DMR Registrations must use the website registration.D-Star RegistrationTo register your Callsign with the D-Star network go to: Registration.html.Hardware VocoderAn external hardware Vocoder is not required. The software Vocoderused in the DVSwitch-Server (i.e., MD-380-emulator) does a goodjob but does not support D-Star. The software Vocoder can be usedfor testing D-Star however it will not produce communicationsquality audio in that format.The DV3000/ThumbDV is one of the best Vocoder available( ). If you have one available use it. It isone of the best Vocoder to use for D-Star, DMR, YSF and NXDN.Raspberry PiThe DVSwitch-Server has been tested with the Raspberry Pi ModelB Rev. 2, RPi3 Model B and RPi 4, RPi’s, particularly the RPi 4, run relatively hot. Consequently,we advise a clear plastic vented case with a built-in fan. Thesecases are inexpensive and many are even supplied with heatsinks. Since the RPi does not have a power switch, we alsorecommend a power cable with an On/Off switch.MicroSD CardWe recommend using a 16 GB or 32 GB class 10 MicroSD card.Format the MicroSD card using any software available, such as .SDMemory card Formatter The actual DVSwitch image is less than 3GB so unless you are planning to install a lot of other software, thesmaller card is adequate.DVSwitch-Server ImageDownload the DVSwitch-Server software. It will be a zip file.Download the official image sh (write) the image onto the MicroSD. There are many good SDcard imaging tools. The option we recommend is balenaEtcher.Etcher is cross-platform, open source, and easy to use. Etcher willalso flash the DVSwitch-Server image directly from the zip file.DVSwitch Installation and User Guide Version 1.61Page 2

How to install DVSwitch-Server on a Raspberry PiInsert the MicroSD card flashed with the DVSwitch server image created above into the RaspberryPi, connect it to you home network, power it up and go through the configuration process. Youmust have a network connection (either Ethernet or WiFi) in order to use DVS. You can connecteither via method 1 below or methods 2 and 3.1 The easiest way to get the server connected is to use an Ethernet patch cable, plug it into yourhome router or switch and connect from another computer using SSH.2 PuTTY is a highly recommended free open source SSH client.To connect using PuTTY you will need to find the DVSwitch-Server IP address.In a web browser navigate to your routers IP address (e.g. andbrowse to the list of connected devices. Look for the IP of the Raspberry Pirunning dvswitch server.Another way to find the IP address of the Pi is to use an IP scanner such asadvanced ip scannerThe standard port for SSH is 22,When using an SSH Telnet client, make sure the remote character translation is set to “UTF-8”,If using the Windows PuTTY SSH client this setting can be accessed via the “Category”window (i.e., Window Translation Remote character set - drop down list).3 If you don’t want go the SSH route, simply connect a monitor and keyboard.4 If your RPi server does not have an Ethernet connection to your home network (i.e., hardwired),to enable wireless networking use the raspi-config tool.From the command line, enter “sudo raspi-config” and select “Network Options”.Select “Wireless LAN”, enter your country, network “SSID” identifier and“passphrase”.Select “Finish” and after a few seconds the RPi will be connected to your wireless homenetwork.5 Once you are connected to the Raspberry Pi either via ssh or a monitor and keyboard, you willsee a command prompt. Enter “dvswitch” as your login(no quotes). The initial password isalso “dvswitch” (no quotes). You will then be required to change your password. After thepassword is changed and you log back in, you will see another command prompt.6 At the command prompt enter “dvs” to begin the configuration process.You will