Update the PyGamer Bootloader

Update the PyGamer Bootloader to prevent a problem with MacOS 10.14.4 and to fix button problems.

Your PyGamer may need its bootloader updated, especially if you're using MakeCode Arcade or if you're using MacOS.

Starting with MacOS 10.14.4, Apple changed how USB devices are recognized on certain Macs. This caused a timing problem with boards that were loaded with a MakeCode program, preventing the PYGAMERBOOT drive from appearing. Also the A and B buttons will be reversed in MakeCode if your bootloader is too old.

Updating Your PyGamer Bootloader

To see if you need to update your bootloader, get the UF2 boot drive to appear on your board. If you're running MakeCode, click the reset button once. If you're running CircuitPython or an Arduino program, double-click the reset button.

When you see PYGAMERBOOT, click thePYGAMERBOOT drive in the Finder and then double-click the INFO_UF2.TXT file to see what's inside.

(The screenshots below are for CPLAYBOOT, but PYGAMERBOOT will be similar.)

The bootloader version is listed in INFO_UF2.TXT. In this example, the version is "V2.0.0-adafruit.5".

If the bootloader version you see is smaller than "v3.6.0", you need to update. For instance, the bootloader above needs to be upgraded.

Download the latest version of the PyGamer bootloader updater here:

The bootloader updater will be named update-bootloader-arcade_pygamer-v3.6.0.uf2 or some later version. Drag that file from your Downloads folder onto the bootloader drive: ARCADE-D5, GAMERBOOT, or PYGAMERBOOT.

After you drag the updater onto the boot drive, the red LED on the board will flicker as the bootloader is updated. The NeoPixels will flash and turn green again. A few seconds later, PYGAMERBOOT will appear in the Finder. After that, you can click onPYGAMERBOOT and double-click INFO_UF2.TXT again to confirm you've updated the bootloader.

Oh no, I updated MacOS already and I can't see the boot drive!

If your Mac has already been updated to MacOS 10.14.4 and now you can't see a boot drivein the Finder, you need to find another computer that will work. Not all upgraded Macs will fail to show the boot drive: older ones can work. Or find a Mac that hasn't been upgraded yet. Any Windows 10 or Linux computer should work for upgrading your bootloader. Windows 7 computers will need drivers installed, but then can work.

This guide was first published on May 25, 2019. It was last updated on May 25, 2019. This page (Update the PyGamer Bootloader) was last updated on Sep 16, 2019.