openFPGA 1.2 Changelog

Framework Feature Compatibility

Now that openFPGA is out of beta, core authors can make sure users have the proper minimum version of the framework necessary to run a core. The framework.version_required value in core.json can be changed to “1.2” — and future versions — to remind users who haven’t upgraded that they will be unable to run the core until they do so.

Cartridge adapter support & audio

Cores can now optionally require or support any inserted Analogue cartridge adapters during the boot process, receiving notice with the new Target command [00B1 OS Notify: Cartridge Adapter]. Additionally, a ‘Play Cartridge’ option can be added to the file browser that will skip loading any slot 0 assets and direct the core to use the cartridge instead. Power to the cartridge is controlled more closely.

Digitized line-level analog audio is now available to the core from the cartridge (pin 31), using the existing I2S audio bus.

Other new features

APF will inform a core about whether Pocket is being played through the Dock or not, with Host command [00B2 OS Notify: Docked State]. A new Target command [0152 Debug event log] will let cores write a time-stamped 32-bit number to the debug log during runtime. Finally, a data slot can specify that it should be loaded from a different platform’s Assets folder—if the filename is defined in data.json. Recall that each core can specify up to 4 supported platforms. This way, multiple cores servicing multiple platforms could share some common assets.

Documentation Updates

Detailed changes and improvements