Doom on your TD-H9
Freedoom's first level, playable on the radio with sound effects and music. This replaces the radio firmware while it is installed: the TD-H9 is a Doom machine until you restore stock or H9 Toolbox Firmware with the web flasher. Everything is open source: Freedoom (BSD), the DMC100-Doom engine (GPL-2.0) and the TD-H9 port.
Tested on one TD-H9 from macOS. The radio cannot transmit or receive while Doom is installed. A failed install can leave the radio unable to boot; the radio's own recovery modes (PTT + 2 for this page, or hold 3 at power-on once Doom is installed) and a backup file are your way back. Your channels and settings are not touched.
What goes onto the radio: the Doom firmware (about 0.9 MB, USB, a few minutes), Freedoom E1M1 game data (about 1 MB, Bluetooth, about 20–25 minutes) and the music (29 KB, Bluetooth, about a minute). Game data and music go into space the stock firmware never uses, and stay there if you reinstall.
Install over USB-C
- Doom firmware .fw · USBNot loaded
- Doom code at 0xEA000 · USBNot loaded
- Game data Bluetooth · step 02Not loaded
- Music Bluetooth · step 02 · optionalNot loaded
- Turn the radio off and connect a data-capable USB-C cable.
- Hold PTT + 2 while powering on. The screen stays blank and the top LED turns green.
- Click Connect radio and choose the JieLi HID device.
- Click Back up radio and keep the file it saves.
- Tick the box and click Install Doom. About 0.9 MB, a few minutes; every sector is checked afterwards.
The install writes the Doom code at 0xEA000 first (inert until the firmware uses it), then only the firmware sectors that differ. If it stops, click Install again: it continues where it left off.
Upload the game data over Bluetooth
- Unplug USB and power the radio on. With no game data it shows BLUETOOTH UPLOAD by itself. (To upload again later, hold 2 while powering on.)
- Click Connect Bluetooth and choose the radio (TD-H9…).
- Click Upload game data: about 1 MB, 20–25 minutes; keep this tab open. Interrupted? Upload again and it resumes.
- Optional: click Upload music for the E1M1 track as an 8-bit chiptune (29 KB, about a minute). It has its own slot and does not touch the game data.
Remove Doom data from the radio
Erases the game data and the music from the radio's 16 MB chip (only the sectors their upload records list) and reads them back as erased. Use it when you go back to the radio firmware and want that space empty again. Needs the same Bluetooth connection: Doom upload mode (hold 2) or H9 Toolbox Firmware.
Play
Power-cycle the radio. It shows GAME DATA OK, SOUND ON and MUSIC ON, then starts E1M1.
| Key | Action |
|---|---|
| 2 / 5 | Forward / back |
| 4 / 6 | Turn left / right |
| 1 | Fire |
| 3 | Use (doors, switches) |
| 7 | Music on / off |
At power-on: hold 2 for Bluetooth upload mode, hold 3 for USB update mode. To get the radio back, put it in PTT + 2 mode and use the web flasher to install H9 Toolbox Firmware or restore stock v1.0.38; the game data and music can stay where they are.