Version 1.04

FRANK Prince v1.04

Changes

• Replaced pico-extras dependency with standalone PIO + DMA I2S audio driver
• Fixed audio distortion: attenuated mixer channels and added master volume control
• Fixed MIDI cached playback to do additive mixing with SFX (was overwriting)
• Added staging ring buffer for reliable audio without DMA stalls
• release.sh now accepts version from command line
• Fixed version display zero-padding (1.03 not 1.3)

Firmware files

Each UF2 is named frank-prince_mX_CPU_PSRAM_1_04.uf2:

• M1 / M2 — board GPIO layout
• 252 / 378 / 504 — CPU clock in MHz
• 100 / 133 / 166 — PSRAM clock in MHz

Version 1.03

New Features

• Level Select: Press Alt+F1..F12 on title screen to start at levels 1-12, Alt+Shift+F1 for level 13, Alt+Shift+F2 for level 14
• Cheat Mode Toggle: Press Alt+Esc during gameplay to enable/disable cheats

Bug Fixes

• Shadow Prince Rendering: Fixed XOR blitting for 8-bit indexed surfaces on RP2350 - shadow prince now renders correctly instead of rainbow/striped colors
• F-Key Scancodes: Fixed PS/2 keyboard driver incorrectly adding 0x1E offset to F-key HID codes
• Title Screen Input: Fixed title screen starting immediately when pressing Shift (now allows Alt+Shift+Fn key combinations)

Changes

• Game Data Directory: Renamed from data to prince - update your SD card accordingly
• Documentation: Updated README with complete cheat keys list and direct download link for prince.zip

Upgrade Notes

• Rename data folder to prince on your SD card, OR
• Download the new prince.zip and extract to SD card root

Version 1.02

Fix PS/2 keyboard sticky key bug on FIFO overflow

• When PIO FIFO overflowed, clearHidKeys() was called but the key handler was never notified. This caused the application to think keys were still pressed, resulting in 'sticky' actions like the prince running endlessly

• Now properly notifies the key handler after clearing keys and returns early to prevent processing an empty FIFO

Thanks @DnCraptor - fixed M2 GPIO pins

Version 1.01

New Features

1. OPL Sound Fixed — FM synthesis audio now works correctly, providing authentic AdLib music and sound effects
2. USB HID Keyboard Support — Play with a USB keyboard in addition to PS/2
3. Start Screen — Animated start screen with blue/cyan Prince of Persia theme, displaying version, board variant, and system info
4. Unpacked Game Data Support — Detects both packed (PRINCE.DAT) and unpacked (extracted directories) game data formats

Bug Fixes

1. Fixed screen flickering using double buffering
2. Fixed game data detection giving false "not found" errors
3. Improved filesystem initialization and error handling
4. Various stability improvements

Version 1.00

• Fully working port to RP2350
• HDMI video implemented
• I2S music and sound implemented