I got my CardPuter ADV and found Doom on M5Burner — flashed it, got a black screen. Tried other versions, the game loaded but the keyboard was completely dead. Just the demo loop playing with no input.

Turns out all existing Doom firmwares use the old 74HC138 GPIO keyboard driver from the original CardPuter. The ADV uses a TCA8418 I2C keyboard controller — completely different hardware. GitHub issues #3 and #10 reported this, but no one had fixed it.

So I forked the repo, rewrote the keyboard driver for TCA8418, fixed the partition table (custom 6 MB layout), and upgraded to ESP-IDF v5.5.1.

Everything works now — keyboard input, sound effects, music, save/load, cheats. Should be the first Doom firmware that actually runs on CardPuter ADV.

Pre-built binaries & source code:
https://github.com/MAXXTANG/CardPuterAdvancedDoom

Original upstream by zspuspoki:
https://github.com/zspuspoki/CardPuterAdvancedDoom

Hackster.io project page:
https://www.hackster.io/hanjourney/cardputer-adv-doom-firmware-fix-port-d900fd

Hope this helps other ADV owners who want to play Doom!