Skip to content

Building HamPi from source

Jump to bottom
Dave Slotter edited this page Dec 9, 2020 · 4 revisions
  1. Make sure you have an internet connection available to your Linux PC and Raspberry Pi.
  2. Make sure you have Ansible version 2.8 or later installed on your Linux PC.
  3. Download the Git repository to your local Linux PC:

git clone https://github.com/dslotter/HamPi.git

  1. Populate HamPi/files directory with the SDRplay driver installer (specifically listed under "Legacy software" as "RSP Control Library + Driver API 2.13 built June 20, 2018" and JTDX (Raspberry Pi) specifically listed as "JTDX v2.2.0-rc152" (must be manually downloaded) as well as the ham radio wallpapers in HamPi/files/usr/share/rpd-wallpapers. Specifically these files should be present for the Raspberry Pi build:

In HamPi/files:

SDRplay_RSP_API-RPi-2.13.1.run

jtdx-2.2.0-rc152_u_armhf.deb

In HamPi/files/usr/share/rpd-wallpaper:

2300H_1600x1200_AM.jpg

Elecraft K3s Transceiver.jpg

W1AW_Fall.jpg

7300_Wallpaper_1600x1200.jpg

FTDX 9000.jpg

When all else fails - amateur radio.jpg

7610_Wallpaper_1600x1200.jpg

World CQ Zones.gif

7800_1600x1200.jpg

ICOM IC-9100.jpg

Worlds Largest Radio Telescope.jpg

AMSATALTLOGO.png

ID31APlus_1600x1200.jpg

baofeng.jpg

ARES.png

InTheCommunity_Wallpaper_1600x1200.jpg

cubesat2.jpg

ARISS pic 1.jpg

Kenwood TS-2000.jpg

dstar_1600x1200.jpg

ARRL We Do That.jpg

Kenwood TS-590.jpg

hf_1600x1200.jpg

Amateur Radio World Map and DXCC Country List.jpg

Moonbounce.jpg

j-38 key.jpg

Antennas Major Design Types.jpg

R30_Wallpaper_1600x1200.jpg

morse-code.jpg

Band_Chart_Image_for_ARRL_Web.jpg

Space Antenna.jpg

r8600_Wallpaper_1600x1200.jpg

Callsign Prefix List International.jpg

Van mobile radio.jpg

raspberry-pi-logo.png

DSTAR2_1600x1200_AM.jpg

Very Large Array.jpg

DSTAR_Wallpaper_1600x1200.jpg

W100AW.jpg

HamPi Desktop Wallpaper.png

NOTE: You are responsible for finding these wallpapers on the web.

  1. Update the HamPi/files/etc/hampi-release file with the release number for the build. If distributing your own HamPi release variant, please make sure to change these notes as to reflect this is a HamPi variant / fork. That will help prevent confusion. Thanks!

  2. Download "Raspberry Pi OS (32-bit) with desktop and recommended software" from https://www.raspberrypi.org/downloads/raspberry-pi-os/

  3. Take a fresh microSD card (or a SSD) and flash the downloaded Raspberry Pi OS (32-bit) with desktop and recommended software to it.

  4. Create a SSH key and copy that SSH key using ssh-copy-id to the Raspberry Pi.

ssh-keygen

ssh-copy-id pi@<ip_address>

  1. Edit the "hosts" file in the local copy of the HamPi Git Repo to point to the Raspberry Pi's IP address.
  2. Run the BASH script, "run_HamPi_playbook". (At the completion of the Ansible run, the SSH key copied over in step 5 will be removed.)

./run_HamPi_playbook

When I created HamPi on a Raspberry Pi 4B with 4GB RAM using a fast broadband connection and heatsink/fan on the Pi and also using a microSD card, it took about seven and a half hours to create the build. Be patient, and regularly check in on the progress -- sometimes external websites, which the HamPi build is dependent on, go down.

Clone this wiki locally