This page provides instructions for a base install of Compass Linux.
Compass Linux is an update to Raspbian Linux with support for NW Digital Radio products such as the UDRC™ Raspberry Pi (audio and GPIO) hat and the UDRX™ radio.
The Compass Linux packages include a variety of amateur radio applications including, but not limited to:
- dstarrepeater (with UDRC™ and UDRX™ enhancements)
- ambeserver for the ThumbDV™ and PiDV™
- direwolf packet modem
- Xastir APRS GUI
- fldigi (soon)
Supported Raspberry Pi Processors
Compass Linux may run on older ARMv6 processors, but is not recommended or supported for Raspberry Pi devices using this processor family. ARMv6 devices include:
- Model A
- Model B
- Model A+
- Model B+
- Raspberry Pi Zero
Compass Linux is built and tested for Raspberry Pi 2 and Raspberry Pi 3 generation systems, which are recommended.
Raspberry Pi Model Hardware Comparison
Create the Boot Image
- Obtain a high quality microSD card. A Class-10 card of 8GB or more is recommended.
- Download a Compass Linux image from archive.compasslinux.org
- The full version has graphic configuration tools for those new to setting up dstarrepeater and ircddbgateway and is recommended for the new user. The raspi-config tool will allow switching between GUI and non-GUI bootup. The 'lite' version is without a GUI and will require hand editing of configuration files and management through the use of the command line.
- Unzip and copy the uncompressed image to the SD card using the procedure outlined on the Raspberry Pi site.
Boot for the First Time
- Place the microSD card in the Raspberry Pi.
- Attach a monitor and keyboard/mouse to the Raspberry Pi
- Attach Ethernet via the RJ-45 jack to your network.
- Allow the Raspberry Pi to boot up
- Login (User: pi, Password: raspberry) and update the password. It is very dangerous to keep the default password. Open a terminal and issue the command:
- You may wish to edit the /etc/hosts file and add a reference to the hostname, for example if you keep the default 'compass' hostname, add a line
- To gracefully shutdown the Raspberry Pi, you may use the command sudo halt, or reboot with sudo reboot
- Upon reboot, the image will automatically increase the filesystem to fully occupy the SD card.
- Edit the file /boot/config.txt with sudo nano or sudo vi and comment out dtparam=audio=on and add force_turbo=1, save and sudo reboot
Update All Installed Software
Open a terminal and issue the following commands:
Current libasound2 has issues, so issue
sudo apt-get remove bluez pi-bluetooth
sudo apt-mark hold libasound2 libasound2-data
sudo apt-get update
sudo apt-get upgrade # OPTIONAL
Your Compass Linux installation is complete.
You may now install applications, for example
sudo apt-get install direwolf xastir ircddbgateway
Perform any Linux configuration specific to your installation, e.g. assign specific network addresses, install favorite tools, etc. (This is beyond the scope of NW Digital Radio support, please use Linux support resources for assistance.) Do not overclock if using the GPIO system for UDRC or PiDV.
We recommend doing the minimum customization necessary until you have your applications up and running.
The newest versions of Compass / Jesse default with the SSH daemon disabled. If you want to login remotely you should enable ssh.
This can be done when creating your boot image, by mounting the /boot partition and creating an empty file named ssh - when Compass boots ssh will be running. From operating systems that support bonjour/avahi/zeroconf you should be able to ssh in using ssh firstname.lastname@example.org from a terminal window.
MS Windows users can get bonjour by installing the latest iTunes from Apple.
Alternately, you can boot your Raspberry Pi and incorporate ssh by typing the following from the command line
sudo systemctl enable ssh
sudo systemctl start ssh
This will enable automatic startup of the ssh service on reboot and start it immediately.
On the Raspberry Pi
Select option 5 Interfacing Options, then select P3 VNC, and enable Yes, save and exit.
Install the RealVNC Viewer client on your personal computer to access the VNC server on the Pi.
Note: DO NOT RUN raspi-update - it may break your install