H9 TOOLBOX FIRMWARE · BASED ON STOCK TD-H9 V1.0.38

Upgrade your TD-H9
with H9 Toolbox

Stock v1.0.38 plus an app loader. Hold Back on the channel screen for a menu of apps that you add and remove over Bluetooth, starting with an onboard APRS client and Brick Breaker, and set your own startup image. Install it in Chrome or Edge over USB-C and restore stock at any time.

APRS / ONBOARD CLIENT

APRS on the radio's own screen.

A list of stations heard with distance and bearing, station details, a map around your GPS position, and messages, opening with the stations already in the radio's Beacon List. Send a status packet or a canned message from your callsign, confirmed with a second press. While it runs it listens on your APRS RX channel with squelch open and the speaker muted. Transmitting needs an amateur radio licence.

Stations, map & messagesFollows APRS RX/TX channelExperimental
APP MANAGER / BLUETOOTH

Add and remove apps.

Apps live on the radio's 16 MB resource chip and load into RAM when you open them, so the stock radio stays as it is. The App Manager adds, updates and removes them over Bluetooth, shows the space left, and changes your boot logo; everything is read back to verify. Brick Breaker is one of the apps, with more to come.

Open the App Manager ↗
EXPERIMENTAL · DOOM FIRMWARE

Or turn it into a Doom machine.

Freedoom's first level running as the radio's firmware: 160 × 128 at about 10–24 frames per second, PC-speaker sound effects and an 8-bit version of the E1M1 music through the speaker. While Doom is installed the radio does not work as a radio; the web flasher puts H9 Toolbox Firmware or stock back at any time. All open source: Freedoom (BSD), the DMC100-Doom engine (GPL-2.0) and the TD-H9 port.

  1. Install over USB-C. PTT + 2 mode, load Doom, back up, install: about 0.9 MB, a few minutes, every sector verified.
  2. Upload the game data over Bluetooth. The radio opens its upload screen by itself; about 1 MB, 20–25 minutes, resumable. The music is an optional extra minute.
  3. Play. 2/5 move, 4/6 turn, 1 fire, 3 use, 7 music.
Open the Doom installer ↗

Game data and music go into space on the radio's 16 MB chip that the stock firmware never uses; they can stay there when you go back to stock. Source: doom-firmware on GitHub ↗.

GET STARTED

Install in your browser.

The web flasher backs up your radio and installs H9 Toolbox Firmware over USB-C. Then the App Manager adds apps and your boot logo over Bluetooth. Use desktop Chrome or Edge.

Open the web flasher ↗

Already running Brick Breaker or an earlier H9 Toolbox build? The web flasher upgrades it directly, and can restore stock at any time. Source and build tools are on GitHub ↗.

QUESTIONS

TD-H9 custom firmware: common questions

Can I install custom firmware on the TIDRADIO TD-H9?

Yes. H9 Toolbox Firmware is free custom firmware for the TD-H9, based on the official v1.0.38 firmware. Install it from your browser with the web flasher at h9toolbox.com/firmware-update/: power the radio on while holding PTT + 2, connect it with a USB-C cable, then Connect radio, select H9 Toolbox Firmware, Backup radio, and Install.

What does H9 Toolbox Firmware add?

An app loader. Hold Back on the channel screen for a menu of apps that you add and remove over Bluetooth in the App Manager at h9toolbox.com/apps/: an onboard APRS client (station list, map, messages and sending), Brick Breaker, and more to come. The App Manager also changes the startup image (boot logo). Everything else is the stock v1.0.38 radio, and your channels and settings are not changed.

How do I add the APRS client or other apps?

Install H9 Toolbox Firmware, power the radio on normally, turn on its Bluetooth programming mode and open h9toolbox.com/apps/ in Chrome or Edge. Connect, click Add on the apps you want, then Write to radio. On the radio, hold Back on the channel screen and pick an app from the menu; RADIO returns to the normal radio.

Does the APRS app transmit?

Only when you pick a packet on its Send screen and confirm it with a second press. It sends from the callsign in the radio's APRS settings on your APRS TX channel through the radio's own transmit routine, so you need an amateur radio licence. Receiving, the map and messages never transmit.

How do I change the TD-H9 boot logo or startup screen?

Install H9 Toolbox Firmware, then open the App Manager at h9toolbox.com/apps/ (or h9toolbox.com/boot-logo/). Connect over Bluetooth, read and save the current logo, choose any PNG or JPG, and click Write. The image is converted to the radio's 160 x 128 screen and read back to verify.

How do I go back to the stock TD-H9 firmware?

Open the web flasher, connect the radio in PTT + 2 mode, select H9 Toolbox Firmware, back up the radio, and click Restore stock v1.0.38. Apps and your custom boot logo stay on the resource chip, unused, until you remove them or write the original logo back.

What do I need?

A TIDRADIO TD-H9 running official v1.0.38 (or an earlier Brick Breaker or H9 Toolbox install), a data-capable USB-C cable, and desktop Chrome or Edge. Apps and the boot logo also need the radio's Bluetooth programming mode. No software or account is required.

Is it safe?

The web flasher backs up the radio before writing, checks every sector before it erases anything, verifies every sector afterwards, can resume an interrupted install, and can restore stock at any time. Apps run only when you open them from the Back-hold menu. It is experimental and has been tested on one TD-H9, so keep your backup file.

Is H9 Toolbox affiliated with TIDRADIO?

No. H9 Toolbox is an independent, open-source project. The source and research notes are on GitHub at github.com/melidosian/h9toolbox.

RECOVERY

What if something goes wrong?

The installer only writes after checking the radio, verifies every sector, and can resume an interrupted install. Restore returns the firmware to stock v1.0.38 through the same PTT + 2 mode. Your channels and settings are never changed by the installer; back them up with the Web programmer if you like.

Open Web programmer ↗