Skip to content

JonnyHaystack/GameKeeb-firmware

Repository files navigation

GameKeeb firmware

Firmware for GameKeeb - keyboard to GameCube adapter. Hardware information is in the main repo.

Licensing

This is a fork of Arte's pico-rectangle firmware which is licensed All Rights Reserved by Arte, and although several parts of the code have been replaced or rewritten, as of right now it still contains some significant parts from an old version of pico-rectangle. Explicit permission was obtained from Arte to use parts of his code in this way. As such, please do not distribute modified versions/forks of this firmware.

Safety information

You probably shouldn't have this adapter plugged into PC via USB and via its Gamecube port at the same time in case the different grounds cause electrical issues (probably not that high risk but I'm not an electrician).

How to program your board:

  • Download the latest release .uf2 file for your hardware revision
    • Rev 1: The original, larger, Pico-based design (unless wiring 3.3V to GP1 then use rev2 firmware)
    • Rev 2: The first two revisions of the smaller adapters with custom PCBs - there is a rev2.0 and rev2.1 which are the same except that 2.1 has an LED and 2.0 doesn't. Rev2 has the same pinout as Rev1, but with the GameCube's 3.3V line wired to a GPIO pin so that it can automatically detect if it's plugged into GameCube, and if not it will reboot into bootsel mode so that you can install updates by plugging it into a PC without having to press the bootsel button.
    • Rev2.2: the same as 2.1 but I made some changes to the pin mapping to make the trace routing cleaner, hence it requires a different firmware version
    • Flashing the wrong firmware version doesn't do any harm, so if you're not sure you can always go with trial and error
  • Plug in your Raspberry Pico to your computer via USB while holding the "BOOTSEL" white button on the board.
  • The board should appear as an external drive. Put the .uf2 of your choice in there. The board should disconnect and be ready for use.

How to remap the controls

Plug your keyboard into the GameKeeb and then plug the GameKeeb into a GameCube/Wii console or a GameCube controller adapter. Next, without having pressing any other keys, press Escape (don't hold it down) and wait 3 seconds. You should see the LED inside the adapter turn off (if your GameKeeb revision has an LED) and the controller will disconnect from the console. Next, press keys one at a time in the following order to map your desired controls:

  1. Left
  2. Right
  3. Down
  4. Up
  5. Mod X
  6. Mod Y
  7. Start
  8. C-Left
  9. C-Right
  10. C-Down
  11. C-Up
  12. A
  13. B
  14. X
  15. Y
  16. Z
  17. L
  18. R
  19. Light shield - light analog R press (for SSBM)
  20. Mid shield - mid analog R press (for SSBM)
  21. D-Pad Left
  22. D-Pad Right
  23. D-Pad Down
  24. D-Pad Up

Any unwanted inputs can be mapped to a single out-of-the-way key. After completing the sequence, the LED (if present) should blink on and off continuously on its own. At this point, you can unplug the GameKeeb and plug it back in, and it should have your new layout on it.

Troubleshooting

Not working on PC with Mayflash adapter

You need to have both of the Mayflash adapter's USB ports plugged in, otherwise it doesn't supply the 5V needed to power the keyboard.

Contact

Discord

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published