- Download and install Raspberry Pi Imager: https://www.raspberrypi.com/software/
- Connect your SD card to a PC and use the following options in Raspberry Pi Imager:
- Raspberry Pi Device: Raspberry Pi Zero 2 W
- Operating System: Other -> Raspberry Pi OS (Legacy, 64-bit) Lite
- This is the Debian Bookworm derivative released 2025-11-24, considered Legacy. At the time of this update, the latest version (Debian Trixie) does not seem to operate correctly on the Pi Zero 2 W. Your mileage may vary.
- Storage: (select your SD card)
- Click "Next"
- When asked, click "Edit Settings" for Use OS customisation?
- Set hostname: "jrencoder"
- Set username and password: (your choice for both of these)
- Configure wireless LAN: (enter your Wi-Fi SSID, password, and country)
- Set locale settings: (select your timezone)
- Under the services tab, select "Enable SSH"
- If you know how to use SSH keys, paste in your public key instead of using password authentication
- Click "Save"
- Click "Yes" for "Would you like to apply OS customisation settings?"
- Click "Yes" to continue imaging
- Insert the SD card into the Pi
- Connect either the USB-C port to a charger, or the barrel jack to a 5V power supply
- Connect to the Pi over SSH. Open a terminal program on your PC and run this command:
ssh [your username]@jrencoder.local- Replace [your username] with what you chose during imaging. If this doesn't work you may need to find the Pi's IP and use that instead of the hostname.
- Run this command over SSH to install this software:
curl -sSL https://raw.githubusercontent.com/Jessecar96/wsjr-data-encoder/refs/heads/main/install.sh | bash
- Reboot the pi using this command:
sudo reboot now - When rebooted, visit the URL given at the end of the install script to visit the web UI
- Click the "Config" tab and fill in the information as desired
- Connect to the Pi over SSH. Open a terminal program on your PC and run this command:
ssh [your username]@jrencoder.local- Replace [your username] with what you chose during imaging. If this doesn't work you may need to find the Pi's IP and use that instead of the hostname.
- Run this command over SSH to update this software:
curl -sSL https://raw.githubusercontent.com/Jessecar96/wsjr-data-encoder/refs/heads/main/install.sh | bash
- Connect an AT or PS/2 keyboard (with adapter) to the front of the star
- Press Alt + F10
- The hexadecimal value after "SW" are your switches. They are 8 characters long.
- Remove the front panel
- Read the rotary switches inside from left to right, there are 8 of them