Firmware installer
Set up your console right here.
No Android phone? Install Cheevotron's firmware on your ModRetro Chromatic or Game Bub over a USB-C cable, or set up your 3DS's SD card, in Chrome or Edge on a Windows, Mac, Linux or ChromeOS computer. The Chromatic and Game Bub then play with the Cheevotron app on your iPhone; the 3DS needs no app.
Cheevotron for more consoles: connectors and prices
You need
- A computer with Chrome or Edge (not Safari, Firefox or a phone)
- A USB-C data cable (some charging cables carry no data)
- The console, charged and switched on
- Game Bub: a microSD card in it
- About two to six minutes
The installer opens at launch
Cheevotron isn't out yet. The firmware installer and the 3DS setup open on this page together with the apps. Leave your email and we'll tell you the day.
What it does
The same careful installer as the app.
This page runs the Android app's installer in your browser, with the same checks. Nothing is uploaded: the firmware comes from cheevotron.com, and your backups stay on your computer. For the 3DS it only copies files to the SD card; the console itself isn't changed.
Checks the console
Finds exactly one console, checks the chips it expects and stops if anything looks unfamiliar.
Backs everything up
Chromatic: reads both firmware chips, checks every part against the console and saves them in your folder. Game Bub: its original firmware comes with this page.
Installs and verifies
Writes only what differs, reads it back to compare it, and waits until the console answers again.
Your computer
Windows, Mac, Linux and ChromeOS
Windows
Chrome talks to two of these USB devices only through Windows' WinUSB driver: the Chromatic's programming chip (GWU2X, USB ID 33AA:0120), and a Game Bub that still runs its original firmware (USB ID 1209:B010). With Cheevotron's firmware the Game Bub sets it up by itself, and the serial ports need nothing. If the installer can't open one of them, install WinUSB for it once:
- Download Zadig from zadig.akeo.ie and open it.
- Choose Options › List All Devices.
- Pick the device: "GWU2X" (USB ID 33AA 0120) or "Game Bub" (USB ID 1209 B010, interface 0).
- Choose WinUSB as the driver and click Install Driver (or Replace Driver).
- Unplug the console, plug it in again and reload this page.
Other software that uses that chip with its own driver (such as Gowin's programmer) may need its driver back afterwards.
macOS · ChromeOS
Nothing to set up: Chrome and Edge reach every device directly.
Linux
Chrome needs access to the USB devices. Save these lines as /etc/udev/rules.d/70-cheevotron.rules, run "sudo udevadm control --reload", then plug the console in again.
SUBSYSTEM=="usb", ATTR{idVendor}=="33aa", ATTR{idProduct}=="0120", TAG+="uaccess"
SUBSYSTEM=="usb", ATTR{idVendor}=="1209", ATTR{idProduct}=="b010", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="374e", ATTRS{idProduct}=="0101", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="303a", ATTRS{idProduct}=="1001", TAG+="uaccess" At your own risk. We test every release carefully on our own consoles, but installing community firmware is at your own risk, and we can't be held responsible for damaged or unusable devices. The installer always backs up the Chromatic's firmware first, and carries the Game Bub's original firmware, so you can go back at any time.
Source code
Built on open-source firmware
The firmware this page installs is open source. Cheevotron's versions are forks of the published designs; their complete source code is here.
ModRetro Chromatic
Download the source code (GPL-3.0)
Game Bub
Download the source code (GPL-3.0, CERN-OHL-S-2.0)
Analogue Pocket
Cheevotron GBC: Download the source code (GPL-3.0)
Cheevotron GBA: Download the source code (GPL-2.0, GPL-3.0)
The installer
Its programming-chip code is based on openFPGALoader by Gwenhael Goavec-Merou and contributors (Apache-2.0).