Hero Image

Updating PiStar to add M17 support

This guide should help you set up your ZUMspot Rpi HAT + RPi Zero to work with M17 mode.


  • flash the microsd card with this disk image, we recommend BalenaEtcher; you have to unzip the image first (7-zip is fine),
  • boot up the device with the microsd card in, then wait for it to start its WiFi access point,
  • find out what the IP address of the device is, try using "Advanced IP Scanner"*,
  • use PuTTY to connect to the raspberry pi over ssh; the login is pi-star,
  • run sudo nano /etc/wpa_supplicant/wpa_supplicant.conf,
  • add the following lines:
  • press Ctrl-O to overwrite, then Enter to confirm, finally Ctrl-X to exit the editor,
  • reboot the device with sudo reboot,
  • wait for it to login to your access point, then use its IP address to access the configuration webpage,
  • go to Admin -> Update; let the process finish,
  • use ssh again to access raspberry pi,
  • run the following chain of commands:
    sudo apt-get update
    sudo apt-get install gcc-arm-none-eabi gdb-arm-none-eabi libstdc++-arm-none-eabi-newlib libnewlib-arm-none-eabi
    git clone https://github.com/juribeparada/MMDVM_HS
    cd MMDVM_HS
    git submodule init
    git submodule update
  • run nano Config.h and edit the file, depending on the modem you are using (press Ctrl-O, then Enter, then Ctrl-X to save and exit),
  • run
    sudo pistar-watchdog.service stop
    sudo systemctl stop mmdvmhost.timer
    sudo systemctl stop mmdvmhost.service
    make clean
    sudo make mmdvm_hs_hat
  • done

*Linux users can use nmap -sP ... instead

Your hotspot is ready to roll. Under Linux, use ssh in the terminal instead of PuTTY and dd to flash the image (BalenaEtcher is fine too!). You might also want to set the correct display settings (if your board has one). For the Zumspot RPi HAT, I had to select 115200 baud /dev/ttyAMA0 UART and "OLED type-6". Don't forget to enable M17 in the dashboard (and select an appropriate reflector).

Big thanks to Chip W0CHP for his marvellous work.


  1. Chip's W0CHP PiStar-dash website
  2. Updating MMDVM, by Michael Clemens, DK1MI (ex DL6MHC)