In memory of Red PE1RRR, We’ll keep the packets flying. Thanks my friend.
Credits PE1RRR.
DOWNLOAD
WARNING: Cooling
The use of this image is at own risk. Active (fan) or large area heatsink cooling is required to keep the RPI from overheating. For example, a heat sink case such as this one is sufficient if there is adequate airflow around the unit.
While the image does not by default overclock your RPI4, it is necessary to put the RPI into Performance Mode, which will make it run hotter. Overclocking is highly recommended but is a manual step you must take full responsibility for.
Before You Start
- Network is handled by DHCP. The SSH system is not running by default and this must be manually activated to generate host keys for the system using the
raspi-config
tool. - Having the SSH system enabled will let you log in from a remote system (using PuTTY for example) on your own network, making it a lot easier to transfer copy & paste instructions from this document.
- You will still need a display, a keyboard and a mouse connected for initial setup.
- This document is not perfect, it is a work in progress.
- The image is the first of its kind so it isn’t perfect either.
- This document has already been updated with additional steps that must be taken to make it fully operational.
- The image requires at least a 16GB SDCard (8.3GB used) and will auto-resize to the full capacity first on boot up. 16GB is recommended because it is quicker to make a backup of should you wish to do so in the future.
- Download 2.3GB
WRITING THE IMAGE TO SD CARD
Windows
Writing the image to SD Card is usually quite well documented by the general Raspberry Pi online documentation. It is possible to use Windows tools such as the RPI Imager, however the image file you download may need to be decompressed first using a tool such as WinRAR or 7zip.
Linux
You will need to know which device path your SDCard appears as e.g /dev/sda
for the dd command. The image is compressed and will need to be unpacked:
gzip -d rpi4-console-dist.img.gz
Send the image to the SD Card using dd: Be sure that /dev/sdb is your SD card and not your internal hard disk!
sudo dd if=/path-to-the-image/rpi4-console-dist.img of=/dev/sdb bs=16M status=progress
First Boot
Upon first boot the image will resize itself to fit the full capacity of the SD card and then auto-restart the system.
Second Boot
Second boot will eventually present a black screen on the display connected (how useful, this will be addressed possibly in an updated image). If there is no signal then you may have the HDMI connector in the wrong port.
Plug in a mouse and hold right-click on the screen to open the pop up menu. From there, open the Terminal Emulator application.
Will this be a desktop system for you?
This install has been created to be as light as possible on the hardware while keeping plenty of tools available, as such there is no toolbar installed by default, so you may want to install the tint2
package if you wish to actually use this system as a desktop.
sudo apt install tint2
Open /home/pi/.config/autostart.sh
, it will not exist.
Fill it with the contents:
# tint2 -- provides panel, systray, clock & taskbar
tint2 &
After installing tint2
, a reboot is required for it to run at next logon.
Change the Password
Once logged in you should change the default password to something else using the passwd
command on a new terminal line and hit enter. You will be prompted through the process. The current login is: pi
and the password is: raspberrypi
Enable Secure Shell (SSH)
By default SSH is disabled as host keys need to be generated for your host that are unique and cannot be shared via an image file. So open up the raspi-config
tool and navigate to (3) Interface Options, then select (2) SSH and Enable it.
sudo raspi-config
Bug Fixes
Updated 2023-04-21- There is a bug that needs to be fixed in the provided /home/pi/.asoundrc file, while the system will still function it is necessary to fix this oversight as it will undoubtedly improve performance.
Open the /home/pi/.asoundrc file and find the string ‘44000’, this needs to be adjusted to ‘48000’. The section of code it is in is shown below, marked ‘Correction applied here’
pcm.dmix0 {
type dmix
ipc_key 60000
ipc_key_add_uid false # let multiple users share
ipc_perm 0666 # IPC permissions for multi-user sharing (octal, default 0600)
slave {
pcm "hw:3,0"
rate 48000 # Correction applied here.
}
}
Overclocking
If you do have adequate cooling, it is highly recommended to overclock to get the best performance, editing /boot/config.txt
to set it to 2GHz which is from experience so far, safe and stable. Locate the #arm_freq
parameter in the config.txt
file and add the following below it:
over_voltage=6
arm_freq=2000
Performance Mode
And edit /etc/rc.local
to force performance mode at boot:
sudo nano /etc/rc.local
Insert the following one-liner BEFORE the ‘exit 0
’ line in /etc/rc.local
echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor
Enable Realtime Thread Priority
Tweaks to the host operating system file /etc/security/limits.conf
@audio - rtprio 95
@audio - memlock 512000
@audio - nice -19
The rtpriosetting is the maximum priority a user of the audio group can run a task. The memlock setting is the maximum amount of memory that a member of the audio group can lock with a realtime task. This should be less than the maximum physical amount of memory, some recommend it to be half. nice is the minimum “nice level” a task can be run as (the willingness of a task to give up it’s cpu time).
ALSA Project (https://www.alsa-project.org/wiki/Low_latency_howto)
If not using ‘pi
’ user, ensure that your user ID is in the audio group in /etc/groups
After a reboot, verify that the new limits are working with:
ulimit -r
pi@raspberrypi:~/bin $ ulimit -r
95
VARA and ARDOP realtime Thread Priority
Background: Launch VARA with highest priority (99)- is required to compensate for some since discovered latency issues.
When issued as root, the chrt
tool overrides the policy set earlier in the limits.conf
, running the process as rt
(realtime) which will reflect in the indicated priority listing when displayed in the top
process monitor program.
Example:
sudo chrt -p 99 `pgrep VARA.exe`
Will modify the thread priority to realtime, on the fly. Using ‘top
’, look at the PRI
column and it should now be ‘rt
’ instead of default ‘20
’.
A modified script that will fork chrt
into a background subshell, wait 20 seconds while VARA is launched, and then adjusts the process priority of VARA.exe is required.
The following script tweak is needed for the RPI4 TNC image for both the ARDOP and VARA TNCs:
File: /home/pi/bin/startvara
#!/bin/bash
cd /home/pi/bin
DISPLAY=:2
export DISPLAY
(sleep 20; sudo chrt --pid 99 `pgrep VARA.exe` ) &
/usr/local/bin/wine /home/pi/.wine/drive_c/VARA/VARA.exe
File: /home/pi/bin/startardop
!/bin/bash
cd /home/pi/bin/
(sleep 10; sudo chrt --pid 99 `pgrep piardopc` ) & /home/pi/bin/piardopc 8515 ARDOP2IN ARDOP2OUT
Enable the TNCs
By default, none of the TNCs are started automatically, but can be enabled to do so:
sudo systemctl enable vara
sudo systemctl enable ardop
sudo systemctl enable ardop-gui
sudo systemctl enable qtsm
sudo service vara start
sudo service ardop start
sudo service ardop-gui start
sudo service qtsm start
View the TNCs
To view the running TNCs, attach VNC Viewer to Display “2”.
So long as you have RealVNC client installed on a remote system, such as another Raspberry Pi, or an iPad you can connect to the screen running the TNCs for monitoring purposes. You don’t have to keep the VNC open, they will run happily in the background.
From Terminal: Note: omit the brackets if providing an IP address.
vncviewer [optional IP address]:2
Login is “pi
“, the password is “raspberrypi
” unless you have already changed it)
VNC Idle Timeout
By default the VNC will timeout after 3600s (an hour) which can be annoying if you want to leave it open on another desktop to monitor. If you have the tint2
toolbar installed it will be possible to locate annd open the VNC server UI on the desktop and then open up Expert
settings to adjust IdleTimeout
to 0
.
Alternatively, open /home/pi/.vnc/.config.d/Xvnc
and append the following line:
IdleTimeout=0
Configuring the QtSoundModem TNC
Due to an oversight on my part, QtSoundModem.ini
has the CWID setting enabled with my callsign so you will need to set the timer from 15 minutes to 0. This will be fixed in the next release of the image.
Additionally good info to know beforehand- due to how QtSoundModem GUI config dialog saves settings, the manually configured sound devices do not appear in the dropdown lists because they are “virtual”, therefore the dsnoop
/dmix
devices that come preconfigured with the image will be overwritten if the dialog is used to change any configuration parameters(!)
The best practice is to edit the ini
file in a text editor manually.
To recap, the QtSoundModem.ini
file is read-only on purpose. The application tries to write back to the file on each shutdown/closure which causes problems for our special audio sharing setup between the different TNCs, so editing the file must be done by hand, not via the GUI.
With editors like vim, a force-write !wq
will write-quit & ignore read-only warning. Easy peasy.
I don’t use nano myself but I know a lot of people do, BUT I don’t know if it i will allow you to do this the same way. If not offered the option when you attempt to overwrite a read-only file, then you can temporarily change the file permission level after stopping the service:
sudo service qtsm stop
cd /home/pi/bin
chmod 644 QtSoundModem.ini
nano QtSoundModem.ini
Make the edits to:
CWIDCall=
CWIDInterval=0
Save and close, then change the permissions back to read-only.
chmod 444 QtSoundModem.ini
Then restart the QtSoundModem’s
service:
sudo service qtsm start
TCP Port Defaults
Bear in mind that my ‘defaults
’ here are in fact not factory setting defaults.
By default my following ports are set:
QtSoundModem
- KISS: 7777
- AGW: 6666
ARDOP
- 8015
VARA
- 8300
- 8301 (data)
OTHER INCLUDED TOOLS/TODOS
Winelink
It’s not a typo, Winelink: VARA on Linux was accomplished courtesy of The Winelink Project on GitHub.
VARA HF 4.7.3 introduced anti-piracy obfuscation to the build which as added so much overhead that it will no longer work on Linux. It is therefore advised to not update to this version.
As of VARA HF version 4.7.5, the aforementioned was removed from the code and functionality has been restored.
[optional] Disable Paket61 socat for TNC2 emulator
sudo systemctl disable paket
sudo service paket stop
[optional] flrig – Radio Head Control
TODO – building and installing.
The source code is located in /home/pi/src
, it is already pre-built, so you can already install it with sudo make install
from the flrig-version
’s subdirectory.
However, because its an old alpha build by now, a fresh build from new source would be better. If you do go ahead an install the tool, it will begin to auto-start due to the systemd
service powering it up as soon as it finds /usr/local/bin/flrig
binary.
You can stop/start FLRig with sudo service flrig stop/start
QtTermTCP – Packet Terminal
Edit /home/pi/bin/startqtterm
and change the DISPLAY
variable to the desktop which you need, usually :0
if a local monitor connected to HDMI, in our use case you can direct the display to the virtual TNC’s desktop which is running on desktop :2
.
See QtTermTCP for a tutorial video for setting it up with a node.
You can start the program as a service. If QtTermTCP crashes or you close it, systemd
will auto-restart the application.
sudo service qtterm start
To have QtTermTCP auto-start on every boot:
sudo systemctl enable qtterm
THIS CONCLUDES THE TNC BANK SETUP
Now just go to your BPQ32 node and define all the ports to each of the TNCs with the appropriate drivers for each TNC type. Good luck! If you get stuck, ask on the groups.io, or try this Google magic search keyword term for official documentation:
cantab uz7ho
cantab qtsoundmodem
cantab VARA
Ok Ok I will get around to making that document soon. Bookmark my website please and also – consider a donation to my beer/host fund if you feel like it. This document took many hours to write and hours of testing and its still not finished!
ALSO INCLUDED IN THE IMAGE
DOSBOX Toys
Not meant for 3rd Parties – provided for educational purposes only.
Please note that there is no toolbar installed, you may want to install the tint2
package if you wish to actually use this system as a desktop.
sudo apt install tint2
How it works
As this image is dual-purpose, this image is also capable of running old packet applications for fun, but due to performance requirements must not be used if running the system as a TNC-bank.
On this image is DOSBOX with various packages preconfigured to use a virtual serial port pipe to the box with a BPQ32 node running on the local network This is downright complicated and because of this, it is not really recommended for 3rd party use but tinkerers might like it.
Each program such as “superpacket
” or “winpack
” relies on a listening serial device on a remote BPQ32 based node. Each application has a unique TCP port put aside, and reciprocal listeners must be set up for each port on the remote node box.
The TCP listeners direct the traffic to a pseudo serial device that the node is configured to attach to when it is started. It then talks to the socket using KISS mode, and the applications on the other end are doing the same, with a couple of exceptions.
Caveats
If you leave a BPQ32 node with KISS ports enabled linked to socat pseudo serial services, the node will assume traffic is being sent to them and will then wait for responses. If you run the node long enough with the reciprocal applications themselves not running, this will cause that port’s KISS buffer in the node to get full and cause the whole node to stop responding entirely. Eek. So don’t leave the ports configured on the node if you had enough of running the DOS apps!
ON THE NODE SYSTEM
Here are some examples for BPQ32:
PORT
PORTNUM=17
HIDE=0
ID=TCP KISS port 8004
TYPE=ASYNC
PROTOCOL=KISS
FULLDUP=0
COMPORT=/home/pi/port-8004
SPEED=19200
CHANNEL=A
QUALITY=192 ; Quality factor applied to node broadcasts heard on
MINQUAL=230
; this port, unless overridden by a locked route
; entry. Setting to 0 stops node broadcasts
FRACK=5000 ; Level 2 timout in milliseconds
RESPTIME=1000 ; Level 2 delayed ack timer in milliseconds
RETRIES=5 ; Level 2 maximum retry value
MAXFRAME=6 ; Max outstanding frames (1 thru 7)
PACLEN=128 ; Default max packet length for this port.
; PACLEN is ignored for APRS packets
L3ONLY=0 ; 1=No user downlink connects on this port
DIGIFLAG=1 ; Digipeat: 0=OFF, 1=ALL, 255=UI Only
USERS=10 ; Maximum number of L2 sessions, 0 = no limit
UIONLY=0
ENDPORT
PORT
PORTNUM=18
HIDE=0
ID=TCP KISS port 8006
TYPE=ASYNC
PROTOCOL=KISS
FULLDUP=0
COMPORT=/home/pi/port-8006
SPEED=19200
CHANNEL=A
MINQUAL=10
QUALITY=244 ; Quality factor applied to node broadcasts heard on
; this port, unless overridden by a locked route
; entry. Setting to 0 stops node broadcasts
FRACK=8000 ; Level 2 timout in milliseconds
RESPTIME=2000 ; Level 2 delayed ack timer in milliseconds
RETRIES=10 ; Level 2 maximum retry value
MAXFRAME=3 ; Max outstanding frames (1 thru 7)
PACLEN=100 ; Default max packet length for this port.
; PACLEN is ignored for APRS packets
L3ONLY=0 ; 1=No user downlink connects on this port
DIGIPORT=0 ; Port on which to send digi'd frames (0 = same port)
USERS=10 ; Maximum number of L2 sessions, 0 = no limit
UIONLY=0
ENDPORT
The serial port listeners on the node box (remote) are run from some start scripts, for example:
For PORT 17 (tcp 8004
):
#!/bin/bash
socat -d -d PTY,raw,echo=0,link=/home/pi/port-8004-stay PTY,raw,echo=0,link=/home/pi/port-8004 &
while true
do
socat -d -d open:/home/pi/port-8004-stay,nonblock,echo=0,raw TCP4-LISTEN:8004,reuseaddr,fork
sleep 1
done
# End
For PORT 18 (tcp 8006
):
#!/bin/bash
socat -d -d PTY,raw,echo=0,link=/home/pi/port-8006-stay PTY,raw,echo=0,link=/home/pi/port-8006 &
sleep 3
while true
do
socat -d -d open:/home/pi/port-8006-stay,nonblock,echo=0,raw TCP4-LISTEN:8006,reuseaddr,fork
sleep 1
done
# End
ON YOUR DOSBOX SYSTEM
The image has the reciprocal couplings for each of these tcp ports provided as linux services, these can be turned on automatically.
The following ports with self explanatory service names are available:
port-2704 port-8004 port-8005 port-8006 port-8007 port-8009 port-8011
Each has a script in /home/pi/bin/
and needs modifying to change the IP address to the one of your BPQ32 node box.
The above services corrleate to the the various different preconfigured dosbox packages that I have set up for different packet radio applications.
They all run on different TCP ports so that it is actually possible to interconnect the applications through the node. e.g. connect from Winpack to the node, then from the node connect to the SuperPacket application (if it is also running).
Caveat
It is not wise to configure too many kiss-TNC ports as it can have a detrimental effect on the node, sometimes causing BPQ32 to lock up intermittently if you leave the applications closed for a measure of time.
For the purposes of this document I have limited examples to just two:
Port 17 (tcp 8004) and 18 (tcp 8006) respectively for “superpacket” and “winpack”, but there are others defined in the system services already that can be enabled and used if you chose to add extra ports to the node using Port 17 or 18 as examples to iterate up to maximum of Port 32.
For reference
Serial Port Tunnels (client side) – enable and start syntax:
sudo systemctl enable port-8004
sudo systemctl enable port-8006
Start:
sudo service port-8004 start
sudo service port-8006 start
Monitoring
Each port that is started opens a ‘screen’ session for debugging. Each screen session is easily identifiable using “screen -r”
pi@console:~ $ screen -r
There are several suitable screens on:
5915.Port8004 (07/23/2022 11:16:56 AM) (Detached)
5093.Port8006 (07/23/2022 11:08:14 AM) (Detached)
To view the console’s output:
Example:
screen -r Port8006
CTRL-A
then D
will detatch the console.
APPLICATIONS
Winpack
Winpack is configured to use DOS BPQ as the communications layer, and utilizes the KISS interface to talk to my remote node. The node’s “socat” serial port is listening on TCP port 8006, using the socat setup described above. This allows the DOSBOX instance to communicate with the node that is on a remote host. The nodes talk to each other via NETROM, the example port setup shown earlier in the document demonstrates that NETROM is enabled and is sending as many nodes as possible on that port. When successfully linked, the Winpack terminal should show a lot of NETROM activity from broadcasts.
The schametic is like this:
LinBPQ Node -- [Kiss Port 17] -- [Serial Socat Listener Port 8006] <-network-> [Remote Serial Socat Connector] <—-> [DOSBOX-Staging] <—-> [DOS BPQCODE.DLL] <--> [Windows 3.11] <--> [Winpack 6.80]
To configure your own callsign you must edit the following file:
/home/pi/dosprogs/BPQ/BPQCFG.TXT
When the ‘winpack
‘ script is run it will launch DOSBOX and run the BPQCFG.EXE
automatically before auto-booting Windows, this converts the configuration TXT into binary for the BPQCODE
to use. Winpack is preconfigured to use the resident BPQ node.
Winpack’s own callsign configuration is pretty straight forward and self explanatory.
Superpacket
Superpacket, on the other hand, is a complex RTFM situation, only for those with the edge! You’re on your own. But it is damn near perfect for multitrack train drifting, on packet radio.
The Other Apps
Apps confirmed and preconfigured to work in the image:
- Paket 6.1 (paket) – requires the TNC2 emulator port setup, see below.
- Baycom (baycom) – works via a TFPCX KISS emulator TSR
- Winpack 6.80 (winpack) – uses NETROM, use the examples given in this document.
- SuperPacket 9.2 (sp) – uses KISS, see the examples given in this document
- New Packet Generation 2.0 (npg)
- TST Host (tsthost)
- BPQ 4.09 (DOS) – is called by
Winpack
and will require separate configuration. - TheDraw has been included to provide access for text drawing.
- EasyTERM PMS (DOS based frontend for BPQ from circa 1994, not to be confused with UZ7HO software) Requires DOSBOX config to be updated- see download below:
Take a look in /home/pi/.config/dosbox
for the various config files for the applications.
To recap, each DOS application requires a unique BPQ KISS port (or TNC2 emulator) to be configured.
For KISS, see the Ports examples above, they can be used as templates to enable the other applications.
I was able to get Winpack, Superpacket, Baycom, TSTHost, NPG and Paket61 all talking at the same time. It was insane and I am sure the RPI4 cried for mercy.
Enable Paket61 socat for TNC2 emulator
Example TNCPORT for Paket (find a clear spot in the bpq32.cfg
configuration file).
TNCPORT
COMPORT=/home/pi/port-8011
TYPE=TNC2
CHANNELS=4
CONOK=1
ECHO=0
AUTOLF=1
ENDPORT
Enable and start the socat services for Paket61
sudo systemctl enable paket
sudo service paket start