Cheevotron firmware for the ModRetro Chromatic: source code
==========================================================

This is the complete source code of the firmware builds that the Cheevotron app installs on a
ModRetro Chromatic. Both are free software under the GNU General Public License version 3 (see
LICENSE in each folder); they are based on ModRetro's published Chromatic firmware.

cheevotron-chromatic-mcu-1e50ac5/
    ESP32 firmware 0.5.1 (mcu_fw.bin, partition-table.bin), commit 1e50ac5.
    Build with Espressif ESP-IDF v5.3 (https://github.com/espressif/esp-idf, tag v5.3): in an
    ESP-IDF environment run `idf.py build` in this folder. LVGL 8.4.0 comes from Espressif's
    component registry as pinned in dependencies.lock. The app installs build/partition_table/
    partition-table.bin at 0x8000 and build/mcu_fw.bin at 0x10000.

cheevotron-chromatic-6e38a40/
    FPGA design (fpga.bin), commit 6e38a40, with the Game Boy MiSTer core it uses
    (esp32t/src/Gameboy_MiSTer, commit 44f43d5; its prebuilt "releases" binaries are left out).
    Build with Gowin FPGA Designer V1.9.12.03: run `gw_sh build.tcl` in esp32t (see README.md).
    The design contains IP cores generated with Gowin's tools, among them Gowin's USB 2.0 SoftPHY,
    which Gowin supplies in encrypted form, as in ModRetro's design.
    The app writes the resulting esp32t/impl/pnr/evt1_x2.fs to the FPGA's flash as openFPGALoader
    v1.0.0 does: every line that isn't a comment ("//") contributes its '0'/'1' characters, eight
    to a byte, most significant bit first, up to the first empty line; those bytes go to flash
    offset 0.

These builds carry no warranty. Write to the address in the app's store listing with questions.
