Firmware

Install the firmware. Keep the way back.

Some consoles need a small firmware update before they can share their memory with your phone. The Cheevotron app installs it over a USB-C cable, no computer needed, and it can always put the original firmware back.

No computer neededOriginal firmware back any timeIn the app

Currently supported

ModRetro Chromatic (Game Boy, Game Boy Color). The RetroUSB AVS (NES) installs the same way over its own USB cable, see the AVS guide, and so does the Game Bub (GBA and Game Boy), see the Game Bub guide; the ModRetro M64 will follow. Super Nintendo needs no firmware at all: the FXPak Pro already has USB.

You need: the Chromatic, your Android phone with the Cheevotron app, a USB-C data cable between them, and about three minutes the first time.

Step-by-step guide

No Android phone? Install it from a computer

What it does

Careful by default.

The app checks first, backs up second and writes last. Every write is read back and compared.

Checks the console

Finds exactly one Chromatic, checks the chips it expects and refuses to continue if anything looks unfamiliar.

Backs everything up

Reads both firmware chips and checks every part of the copy against the console. The backups go to your phone's Downloads folder straight away.

Installs and verifies

Writes the new firmware, reads it back to compare it, and confirms the console answers before it moves on.

Back to the original

"Restore a backup" writes your own backup back in the right order. If you made a backup of ModRetro's firmware on a computer earlier, you can import it and restore that.

Safe if something goes wrong

If a write is interrupted, by a loose cable say, the console's programming chip still answers, and the app can finish the job, even when the Chromatic doesn't start. ModRetro's own update tool remains a way back as well.

On the Game Bub

The app writes only the Game Bub's firmware and puts Cheevotron's FPGA designs on its microSD card. Its boot loader, updater and settings are never touched. The app carries Second Bedroom's original firmware and writes it back with one tap, removing the designs too; Second Bedroom's own updater remains a way back as well.

Please read: at your own risk. We test every release carefully on our own consoles, but installing community firmware is at your own risk. We can't be held responsible for damaged or unusable devices. You can go back to the original firmware at any time: the app backs up the Chromatic's first, carries the Game Bub's, and installs RetroUSB's on the AVS from the file RetroUSB offers.

Source code

Built on open-source designs

The Chromatic's and the Game Bub's firmware and the MiSTer NES core are open source (GPL-3), and so are the Game Bub's FPGA designs (CERN-OHL-S). Cheevotron's versions build on the published designs, and their full source code comes with the app: open Settings › General › Licenses and choose Save the firmware's source code.

Chromatic FPGA design

Fork of ModRetro's FPGA design with a read-only memory bridge, the unlock overlay and the battery status.

Chromatic ESP32 firmware

Fork of ModRetro's MCU firmware that streams memory over Bluetooth and draws the unlock pop-ups.

Game Bub firmware and FPGA designs

Fork of Second Bedroom's firmware and FPGA designs, with read ports into the game's memory, the Bluetooth link, the unlock pop-ups and chime, and the achievement list.

AVS firmware

Our own FPGA design for the RetroUSB AVS, built around the CPU, picture and sound parts of the MiSTer NES core, with the link to the phone, the menu on the TV and the unlock pop-ups.

The installer

Part of the app. Its programming-chip code is based on openFPGALoader (Apache-2.0); the notices are under Licenses in the app.