diff --git a/Pi-Build-Setup-Document-V0.1 b/Pi-Build-Setup-Document-V0.1 new file mode 100644 index 0000000..fa282ed --- /dev/null +++ b/Pi-Build-Setup-Document-V0.1 @@ -0,0 +1,497 @@ +Raspberry Pi-Build with AmRRON Setup Script + +V0.1 + +Start out with a fresh install of Raspian Stretch + +Download the desktop version WITHOUT all the extra "recommended" software at: +https://www.raspberrypi.org/downloads/raspbian/ +The above download is very slow. Torrent is a much faster download. + +Run an SHA check on the downloaded file, to be sure the file is not corrupted. + +In terminal: +sha256sum 2018-11-13-raspbian-stretch.zip +(you may need to revise the file name based on what you actually downloaded) + +a121652937ccde1c2583fe77d1caec407f2cd248327df2901e4716649ac9bc97 (2018-11-13-raspbian-stretch.zip) +a121652937ccde1c2583fe77d1caec407f2cd248327df2901e4716649ac9bc97 (from Raspberry Pi site SHA-256) + +Verify the above numbers match exactly! + + +Unzip the file and burn it to an SD card + +A class 10 8GB card will work, For the Pi-Build we will be using 32GB class 10 SD cards. +If you are reusing an old SD card be sure to first format it to FAT32. +Instructions here: +https://www.raspberrypi.org/documentation/installation/installing-images/README.md +Or simply use Mint's USB Image Writer. + +After the image is written to the SD card, it needs to run on the Pi to expand the file system and do some basic configurations. Insert the SD card in the Pi and boot up. + +Once the pi boots up, the Pi's initial startup configuration will automatically run. Set a new password (for Pi-Build we set it to "*******"), set your location settings, enter your WI-FI AP's name and password, and then run the Operating System auto update. + +From the Pi Menu/Preferences/Recommended Software: install Libreoffice +From the Pi Menu/Preferences/Raspberry Pi Configuration / interfaces: enable VNC, Serial Port, and Serial Console. + + +Optional: Partition the 32GB SD card into two partitions + +Caution GParted is used to perform the repartitioning, and is a very powerful tool. Please read up on how to use it and double check your actions before executing. Be sure you have selected the SD card device and not the hard drive of the host machine. It would be wise to make a backup of your host machines hard drive before proceeding. Do not think this a waste of time, as you should be backing up on a regular basis. Clonezilla is recommended as this is one of the best (and free) backup - drive imager tools out there, available here: +https://clonezilla.org/ + +If you are not sure then skip this step: +Shutdown the Pi and pull the SD card to re-partition on Linux Mint Desktop machine. +Use GParted to resize the SD card home partition (/dev/sdb2) from 32GB to 14.92GB. +With the remaining 14.92GB, add a new FAT32 partition labeled "Data" +Dismount and put card back in the Pi and boot up. +If all is well then the new partition should shows up in the Filemanager as /media/pi/Data or via the Filemanager menu go/devices/USBD00:Data + +The Pi-Build SD card images are partitioned this way and a desktop shortcut is provided to easily access the new partition. + + +Disabled the Pi internal BCM283x sound device + +This is recommended but optional -your choice. The internal BCM283x is headphone output only and not useful as a radio sound device. The benefit of disabling is that there is less confusion when identifying the Signalink or the Radio's internal sound device. One possible use for the internal BCM283x sound device is to use it for incoming message alerts from FLDigi and or JS8CALL, but you would need to add an amplified speaker or have headphones plugged in. The internal BCM283x is disabled in the Pi-Build image. + +To disable the internal BCM283x sound device: +sudo nano /boot/config.txt +cursor down and find the following line: +dtparam=audio=on +and comment out the line, to look like this: +#dtparam=audio=on +save and close the file ctrl-x y enter + +Setup the Pi task bar + +Right click on the task bar and select "Add/ Remove Panel Items" +Select the "pi-hat battery indicator" if it appears and click "Remove". +Select "Minimize all Windows" click "Add" then click "Up" several times to move is position to the left. +Repeat the above procedure to add the "CPU temperature" indicator and add 2 spacers. +When done click "Close" + +Change the clock to display 24hr and show seconds by Right click on the Clock and select "Digital Clock Settings" and typing %T in the "Clock Format" box. then "OK" +To display Zulu time, change the location in Preferences + + +RaspAP + +RaspAP is not installed or configured on the the Pi-Build image. If you want to run the Pi headless using the VNC server over the internal WI-Fi, then in a terminal type: +cd Desktop +bash raspap + +Please note that RaspAP has an issue with routing that causes an internal IP routing failure of localhost (127.0.0.1) if both the eth0 (Ethernet) and wlan0 (WI-FI) are disabled. This failure will prevent all the comms apps from working properly. + +To overcome this run the desktop shortcut "Reconfig RaspAP" and follow the prompts to disable the routing. With the Routing redirect disabled, you will still be able to use the VNC over the internal WI-Fi and /or the Ethernet individually, but RaspAP will not function as a WIFI-Hotspot linking the eth0 traffic to wlan0. + +If your primary method of interfacing with the Pi is though the VNC using the Pi's built in WI-FI device and the WIFI device will aways be on, then then this will not be an issue of concern. Only if you install and configure the RaspAP and then turn off the WI-FI and Ethernet is disconnected for example you are operating in the field, preserving power and /or minimizing your RF signature profile for OPSEC. + +Now would be a good time to stop and make a backup of the SD Card. Use Clonezilla or follow the procedures here: +https://www.howtogeek.com/341944/how-to-clone-your-raspberry-pi-sd-card-for-foolproof-backup/ + +======================================================== + +Run the AmRRON-Setup-Script + +This excellent and extensive script developed by Tango Bravo-14 will install a plethora of useful programs and utilities as well as all the build tools and prerequisites for building the FLDigi suite, JS8CALL, ARDOP/ARIM and more. + +You will need git to clone this repository on your system. +Install git with: +sudo apt install git + +Now clone the repository to your local system: +git clone https://gitlab.com/amrron/setup-scripts.git + +Move into the new directory: +cd setup-scripts + +To get updates to the scripts, ensure you are in the setup-scripts directory and run: +git pull + +Running the scripts +To run a script simply type: +./filename + +Alternatively, a bash 'debug' mode can be used to see what the script is doing by running with: +bash -x filename + +If the script is not already executable, then run: +chmod +x filename + +You could also run the script by double clicking and selecting 'Run in terminal' from you file browser but any errors will simply close the session and you won't know what errored or why. +If you run into errors, please attempt again and run with bash -x to see the output. If you can provide the final section of that that shows the error along with your system information it will assist in troubleshooting. + +Read more about it in this thread: +http://amrron.proboards.com/thread/2101/raspberry-linux-amrron-updater-script + + +Install applications and utilities via the AmRRON Setup Script + +You can select just the essential communications programs that you desire or everything offered. At a minimum it is suggested to select all the options under radio. It is also suggested to use the default directory locations unless you are running the script on an existing installation with a customized directory structure. + +In a terminal: +cd setup-scripts +git pull +bash -x ./AmRRON-Setup-Script.sh + +First time you run the script, select "Enable Source Code", Thereafter select "Already Enabled" + +Next select "Update" This is a good practice to do every time you run the script, to keep the Operating system up to date. + +From here check the boxes of the categories of applications and utilities you want to install, or update. For the Pi-Build image all categories and sub options have been selected and installed. + +Proceed to the installation and be patient as it can take between 2 - 3 hours or longer depending upon your Internet speed to download and install all the applications and utilities. Subsequent updates or add ons will take considerably less time. It is suggested to check the terminal window occasionally to see if it is waiting for your password or other input, or if an error has occurred and attention is needed. The Pi should not ask you for a password unless you initially set the Pi to to require a password on boot up. Mint will ask for for your password several times throughout the process. + +When the installer script has concluded then select reboot. + +======================================================== + +Configure Trimode via the AmRRON TriMode Setup script + +TriMode; FLDigi, JS8Call and ARDOP/(g)ARIM simultaneously sharing the same radio. + +For any selection other than VOX, ensure the radio is attached to the Pi via USB cable, powered on, and CAT control port is configured and enabled. Suggest the baud rate and port parameters be set to 19200 N 8 1 If your rig is not capable of this then set the parameters accordingly and take note of them. Else the following will not work correctly. + +Study and Consider the following radio control scenarios when making your choices when running the AmRRON Trimode Setup Script: + +--------------------------------------------------------------------- + +VOX + +VOX is the method to select when using a Signalink or similar interface and manually controlling the rig. + +All three programs must be set for VOX keying. + +You will not have any CAT control of the rig - all settings will be manual. + +Do not enable rigctld (in TNC-Status app) with VOX keying, else rigctld will fail as there is no tty port defined for its use. + +There are two methods for setting up the rig: + +A. When using a Signalink or similar interface, set the rig according to the instructions provided with the the Signalink. + +B. When using a USB sound dongle or the PC's built-in sound card, set the rig for VOX operation, set the VOX delay to minimum and adjust the VOX sensitivity to reliably key with the proper level presented by the sound card for the required modulation and ALC indicator. + + +FLDigi - Configure / Rig Control / uncheck all CAT enablers + +JS8CALL - Settings / Radio / Rig Options + Rig: None + Rig Options / PTT Method: VOX + +piardopc/gARIM + automagically setup by the script + +Tri-Mode Startup + TNC-Status, check the following and click Toggle: + ARDOPC + ARDOP_GUI + PAVUCONTROL + FLDIGI Pi-Menu/ Internet/ Fldigi + JS8CALL Pi-Menu/ Sound& Video/ js8call + gARIM Pi-Menu/ Other/ gARIM + +--------------------------------------------------------------------- + +RTS + +The RTS method of keying is useful when using a USB sound dongle or the PC's built-in sound card. There is a bit less keying latency vs VOX + +All three programs must be set for RTS keying. + +You will not have any CAT control of the rig - all settings will be manual + +Do not use or enable rigctld (in TNC-Status app) with RTS keying. This will cause the rig to go into constant transmit, as rigctld will assert RTS once it acquires the the tty port. + + +FLDigi - Configure / Rig Control / Hardware PTT + check "Use separate serial port PTT + Device: /dev/ttyUSBx + check "Use RTS" + uncheck all other options + +JS8CALL - Settings /Radio /Rig Options + Rig: None + Rig Options / PTT Method: RTS + Port /dev/ttyUSBx + +piardopc/gARIM + automagically setup by the script + +Tri-Mode Startup + TNC-Status, check the following and click Toggle: + ARDOPC + ARDOP_GUI + PAVUCONTROL + FLDIGI Pi-Menu/ Internet/ Fldigi + JS8CALL Pi-Menu/ Sound& Video/ js8call + gARIM Pi-Menu/ Other/ gARIM + + +--------------------------------------------------------------------- + +CAT + +The CAT method is intended to use FLRig as the CAT / Rig controller. FLRig is far a more complete CAT/Rig controller than rigctld/Hamlib. ARDOP uses CAT keying commands and FLDigi cooperatively shares the tty port with ARDOP. JS8CALL uses the "FLRig FLRig" CAT mode to talk with FLRig, where FLRig controls the radio. + +FLRig also works very well with custom Macros in FLDigi to control rig functions such as mode and filter width, etc. + + +FLDigi - Configure / Rig Control / flrig + check "Enable flrig xcvr control with fldigi as client" + uncheck "Flrig PTT keys modem" + + +JS8CALL - Settings /Radio /Rig Options + Rig: select "FLRig FLRig" + set Poll interval to 2s + Rig Options tab select CAT + Click "Test CAT", then click "Test PTT" + + +piardopc/gARIM + automagically setup by the script + + +Tri-Mode Startup + TNC-Status, check the following and click Toggle: + ARDOPC + ARDOP_GUI + PAVUCONTROL + FLRig Pi-Menu/ Internet/ Flrig + FLDIGI Pi-Menu/ Internet/ Fldigi + JS8CALL Pi-Menu/ Sound& Video/ js8call + gARIM Pi-Menu/ Other/ gARIM + +--------------------------------------------------------------------- + +SOCAT + +The SOCAT method allows all Tri-mode programs to work cooperatively via rigctld/Hamlib. ARDOP does not have any CAT functions built in and therefore connects to SOCAT where SOCAT redirects ARDOPC's CAT key and unkey commands to rigctld. + +You will have limited CAT control of the rig, based on what rigctld/Hamlib has included for your specific rig. The IC-7300, for example, PTT and frequency control work, but filter width and other functions do not work. Your results may vary. + +FLDIGI + + Configure / Rig Control / Hamlib + check "Use Hamlib" + Rig: select "Hamlib NET rigctl (stable)" + Device type in the box: localhost:4532 + check "PTT via Hamlib command" + Click "Initialize" + +JS8CALL - Settings /Radio /Rig Options + Rig: select "Hamlib NET rigctl" + set Poll interval to 2 s + Cat Control tab type: localhost:4532 + Rig Options tab, select CAT + Click "Test CAT", then click "Test PTT" + +piardopc/gARIM + automagically setup by the script + +Tri-Mode Startup + TNC-Status, check the following and click Toggle: + RIGCTLD + ARDOPC + ARDOP_GUI + PAVUCONTROL + FLDIGI Pi-Menu/ Internet/ Fldigi + JS8CALL Pi-Menu/ Sound& Video/ js8call + gARIM Pi-Menu/ Other/ gARIM + + +--------------------------------------------------------------------- + +In a terminal: +cd setup-scripts +git pull +bash -x ./AmRRON-TriMode-Setup.sh + +Select your (pi)ardop file by clicking on the little folder icon in the top left box, then in popup window, double clicking on the the (pi)ardopc file. + +Next select the method for controlling the Push to Talk function specific for your rig, based on the method of choice from +above. + +Next select "Configure RIGCTLD". + +There are two scenarios where you will set this option to "Yes": +1. If you are using SOCAT/RIGCTLD for PTT and CAT control of the Radio, or +2. If you plan to use PAT with CAT control to utilize the ARDOP RMS Station Alias list selection and creation features, of the AmRRON-PAT-GUI script. + +Otherwise set this to "No". + +No worries, you can always rerun this script to enable RIGCTLD or make any other changes you may need. + +Next at the option "Return Status launcher to Defaults" leave this at "No" +Click OK + +At the next window, +Note: this window will not appear if you selected VOX as your PTT method + +Select the CAT serial device for your rig + +The radio typically enumerates as ttyUSB0. +Do not select ttyAMA0, this is the port for the USB GPS device. This port shows up in the list as the script polls the system to determine what ports are predefined or enumerated. +If your rig is not showing up in the CAT serial device list then the Pi did not enumerate the CAT port of the radio. Click "Cancel" then recheck your rig configuration, the USB cable and power cycle the radio and reboot the pi. +Then start this script over again. + +Select the Baud Rate appropriate for your radio. + +Select your Radio from the list. +Note: The current list of radios was created from the responses provided by the Pi-Build participants. If your rig has CAT control capability, but is not in the current list, then please contact Tango Kilo-05 to get it added to the list. +Click OK + +At the next window, +Select the RIGCTLD serial device for your rig +The radio typically enumerates as ttyUSB0 + +Select the Baud Rate appropriate for your radio. +Click OK + +The next window will appear with the parameters that will be written to the asound.conf file. +This is for informational purposes. +Click OK + +The next window lists the commands to control ardop and rigctld. +Again this is for informational purposes. You could copy the contents and past into a text file for use later use, if you have difficulty starting (pi)ardopc or rigctld and want to test these commands independently in a terminal window. +Click OK + +This script configures the application behind the desktop shortcut TNC STATUS. Double click on this shortcut to see a list of programs you can start or stop, or check the running status of. + +To start a program check its box and click "Toggle" +To check the running status of a program look for its PID (process ID) if it reports "None" then it is not running. +To stop a program uncheck its box and click "Toggle" + +==================================================== + +TriMode programs sound device settings and PulseAudio configuration + +FLDIGI + +Start FLDigi (and FLRig, or appropriate) +FLDigi Configure/ Sound Card +Select PulseAudio +Server String: leave this field empty + +RPi Menu / Sound & Video / PulseAudio Volume Control +Input Devices - set your sound device to 100% +Output Devices - set your sound device to 100% + +Recording - look for fldigi icon capture- select your soundcard device and set to 100% +Playback - look for fldigi icon playback- select your soundcard device and set to 100% + +Setup Rig TX and RX base levels +Since FLDigi needs the highest RX and TX levels to and from your sound card we will set them first and this will be the base reference for JS8CALL and ARDOP. + +Setup your rig ready to transmit at your desired RF power level into a dummy load. (as The Timtron would say Hey Dummy - use a dummy load!) + +Note: As a rule, when running digital or any continuous carrier mode (RTTY, FM, Etc), although there are some exceptions, you should set the TX power to no greater than 50% of the Rig's full rated power. Best to refer to the rig's manual to be sure. Overdriving the rig can distort the transmission, cause interference, overheat the the rig or worse burn out your $finals. + +In FLDigi click the "Tune" button on the upper right of the menu bar. This will cause FLDigi to transmit a continuous carrier. Set your Signalink TX level and /or your Rig's Mod level (if equipped) for the desired level of ALC and verify the desired RF power output. If your ALC it too high or the RF level can not be properly set then adjust the level of your sound device in the PulseAudio Volume control "Output Devices" Tab. + +Set the rig to a quiet (S-1 to S-3) section of the band and adjust the RX level until the little diamond (located on the lower right status bar left of the AFC button on FLDigi) just turns green. If it turns yellow your RX level is too high. Set your Signalink RX level and /or your Rig's RX level (if equipped) for the desired level. If your RX level can not be properly set then adjust the level of your sound device in the PulseAudio Volume control "Input Devices" Tab. + + +JS8CALL + +Start JS8Call +Menu View/ Show Waterfall Controls/ uncheck "Flatten" This will give you a better and more accurate sense of your receive signal levels. It has been noted that too much RX level will cause JS8CALL decode to fail. + +Menu File/ Settings (F2) + +Audio tab +Soundcard Input: alsa_input.usb-(name of your soundcard CODEC).analog-Stereo +Soundcard Output: alsa_output.usb-(name of your soundcard CODEC).analog-Stereo + +PulseAudio Volume Control +Recording Tab - look for the Microphone icon: QTPulseAudio icon - select your soundcard device and set to approximately 30% (adjust for ~35 dB in FT8Call CAT window lower left) + +Playback Tab - look for JS8 thunderbolt icon: QTPulseAudio icon - Note this will only appear while FT8Call is transmitting, Click the JS8CALL "Tune" button in the upper right. Select your soundcard device and set to approx 85% adjust for desired power and ALC levels. Or you can set this to 100% in Pulse Audio Volume control and adjust the JS8CALL TX level using the TX level attenuator in the lower Right. + + + +ARDOP/(g)ARIM + +Start ARDOP, (g)ARIM and ARDOP_GUI via the TNC Status App + +PulseAudio Volume Control +Recording - look for Microphone icon ALSA plug-in [ardopc] - Select your soundcard device and set to 100% + +Playback - look for the spkr icon ALSA plug-in [ardopc] - Note this will only appear while ARDOP is transmitting. Put ARDOP into transmit mode, in ARDOP_GUI / Send / Send Two Tone Test, then in PulseAudio Volume Control, select your soundcard device and set to 100%, or if necessary adjust for proper RF power and ALC levels + + + +The above steps should only need to be performed once. Upon restarting the system you will have to reset the RX volume level for JS8Call each time, as unfortunately pavucontrol does not remember application specific receive volume settings. + +Caution: Be sure to leave Pulseaudio Volume Control running. You can collapse it to the task bar, but be sure to keep it running or you will experience strange behavior with JS8CALL and ARDOP. + + +=========================================== + + +Tri-Mode Startup procedure + + +Once FLRig, FLDigi, JS8CALL and Ardop/(g)ARIM are configured with your personal information and you desire to run all three programs or any combination of them, it is advisable to start and run in this order: + +0. GPS Monitor (if no Internet) Note 1 +1. FLRig (or rigctld) Note 2 +2. FLDigi +3. PulseAudio Volume Control (pavucontrol) Note 3 +4. JS8CALL +5. ARDOPC +6. ARDOP_GUI +7. (g)ARIM + +Note 1. GPS time sync via USB GPS device, if no Internet it is available, it is advisable to use a USB GPS device to provide accurate time sync for JS8CALL and file date/ time stamps, else manually set the date and time and use the manual time sync feature in JS8CALL. This function will be described elsewhere. + +Note 2. FLRig is the preferred method to control the radio, as it covers the most extensive set of rigs and has the most comprehensive control features of all the cat programs. JS8CALL includes integrated CAT control with FLRig. FLDigi macros integrate best with FLRig providing some useful control feature via Macros. No rig control program is perfect and while we find the rigs like the IC-7300 really shine with FLRig, Rigs like the FT-891, not so. Your mileage may vary. If FLRig does not work for you then the next best is Hamlib/rigctld. See the control scenarios listed earlier. + +Note 3. PulseAudio is the key to sharing the single sound device between the three programs. Due to some quirk in the Raspian OS, it is necessary to have the PulseAudio Volume Control running before starting JS8CALL or ARDOP. + +It is advisable to use the TNC Status app to start the following: + +RIGCTLD for any need thereof +PAVUCONTROL (PulseAudio Volume Control) +ARDOPC +ARDOP_GUI + + +PAT for Winlink Email +Do NOT run PAT and ARIM at the same time, as they both use ARDOP and each in its own unique way and will conflict. +If you are currently running ardop/arim, and you want to switch to PAT, first in ARIM disconnect from the TNC, (it is not necessary to terminate (g) arim) then via the TNC Status app, toggle off ARDOP, then toggle ARDOP back on and PAT on. +When done with PAT, toggle PAT and ARDOP off, then toggle ARDOP back on and in (g)ARIM, reconnect to the TNC. + +When closing any terminal windows especially ardop, don't just click the "x" in the upper right, terminate the application with control-c !! + + +How TriMode came about + +During TREX-18 i was camped in a remote location on the south shore of Lake Superior in the Upper Peninsula of Michigan, and operating completely off-grid. This was an excellent location, being very quiet and a great vantage point where i could communicate well with the East and the West coasts and as a result wound up handling a lot or relay traffic. At times there was bursts of simultaneous traffic with several FLDigi ops on close but diverse frequencies and using different modes, as well as occasional traffic on ARDOP/ARIM. I could see activity on the waterfall, but by the time i could switch, the traffic was missed. Well this got the wheels turning - How could one monitor all these modes using one rig? Many said it can be done with windows, but like the devil i cast gates out of my life years ago and was determined to make this work on Linux. Linux is a very powerful and secure operating system and far more flexible than windows, only it takes time to lean how to use it. Oh sorry didn't mean to get into a Glock vs 1911 debate. Anyway here we are. + + +Disclaimer: TriMode is not 100% bulletproof as the three applications are not totally aware of each other. It has been observed on very rare occasion when ARDOP is in an ARQ session and JS8CALL or FLDigi heartbeat or auto reply, that ARDOP segfaults and terminates. So it would be wise before engaging in a ARDOP/ARIM ARQ session to disable in JS8Call, Heartbeat and AUTO and in FLDigi FSQ, disable Sounder and turn off FSQ-ON. + +Any Feedback / updates / corrections regarding this document, please contact Tango Kilo-05. + +73 + + + + + + + + + + + + + + + + + +