BI4OAE

How to Build an MMDVM Hotspot with Pi-Star: A Complete Setup Guide

2026-10-18 · Digital Modes

The digital voice dilemma

DMR, D-STAR and C4FM all solve the technical side of digital voice — clean audio, error correction, talkgroups and time slots. None of them solve the practical side: you need a repeater that covers you. Digital repeater coverage is uneven almost everywhere, concentrated on a few high points in major cities. If you live slightly outside those shadows, or simply want reliable operation from inside the house, you end up in the familiar trap: radio bought, network account registered, and still nothing to talk to.

The standard fix is to shrink the repeater down to a box that sits on your desk.

What an MMDVM hotspot actually is

MMDVM stands for Multi-Mode Digital Voice Modem, an open-source project by Jonathan Naylor (G4KLX). In hotspot form it is a small add-on board for a Raspberry Pi that behaves like a miniature repeater: it talks to your handheld over the air on one side, and to the internet on the other.

The signal path is short:

Your handheld → MMDVM hotspot → home broadband → internet → BrandMeister or another digital network → operators worldwide

Press the PTT at your desk and you may be heard by someone in New York, Tokyo or London. Without the hotspot, a handheld with no repeater in range is a brick. One hotspot can serve several modes at once — DMR, D-STAR, C4FM and others, depending on what you enable.

The hardware

Three things matter:

Add a 16 GB or larger Class 10 microSD card (about ¥15) and the little IPEX-to-SMA antenna pigtail the board expects. A complete minimum build — used 3B+, board, supply — lands near ¥260 (about US$36); a tidier setup with a 4B, heatsinks and a case reaches roughly ¥430 (US$60). An OLED display for ¥10-15 is worth it: seeing mode, time slot and traffic at a glance beats opening a browser.

The only genuinely fiddly step is soldering: header pins, the antenna connector and the power wires all need an iron. One mistake is so common it deserves a warning — fit a right-angle antenna connector. The straight version solders up fine and then the case will not close, and desoldering that connector afterwards is miserable.

Two software paths

Pi-Star is the classic choice: mature, stable, straightforward to configure, and it runs comfortably even on a single-core Pi Zero. WPSD (W0CHP’s Pi-Star Dash) is the community-maintained successor with a more modern dashboard and more features, but it can feel sluggish on the original Zero. Both use the same MMDVMHost stack underneath, so the configuration logic is nearly identical. Beginners should start with Pi-Star; switch later if you want the newer interface.

Installing the image

Download the correct image from pistar.uk and write it to the SD card with Balena Etcher or Raspberry Pi Imager. Before ejecting the card, configure Wi-Fi: drop a wpa_supplicant.conf file with your SSID and password into the root of the card’s boot partition. This is the step that breaks most first builds, for two reasons. First, a typo in the file means no network. Second, the Raspberry Pi only has a 2.4 GHz Wi-Fi radio — it physically cannot join a 5 GHz network, no matter what the router offers.

Insert the card, connect the antenna, power up and wait two or three minutes. Then open http://pi-star.local or http://pi-star/ in a browser. Default credentials are pi-star and raspberry. If the page will not load, the Wi-Fi configuration is wrong about nine times out of ten.

Configuring the hotspot

On the Configuration page, the fields that matter:

Apply each section as you go — changes take effect per block, and it is easy to fill in four sections and forget the last Apply button.

Setting up the handheld

The radio side is short:

The quickest verification is an echo test on talkgroup 9990. Key up briefly, then watch the Pi-Star dashboard: an RF activity line should appear at the bottom, and a moment after you release, you should hear your own voice played back. If you hear the echo, the entire chain — handheld, hotspot, internet, network — is working.

Troubleshooting and one non-negotiable

Common failures, in rough order of frequency:

And the point that cannot be skipped: a hotspot is a transmitting station. It requires a valid amateur licence, a frequency permitted by your local band plan, and the minimum power needed for the job. A few milliwatts covers an apartment comfortably — there is no reason to run more. A hotspot transmitting outside its allocation or at unlicensed power is not a toy; it is an illegal station, and enforcement treats it that way.

Built properly, the whole thing costs less than a mid-range handheld and quietly hands you the entire digital voice world from the corner of a desk. For many operators it is the first digital contact they ever make.

References

Chinese-language archive of this site: /zh/