Information and community source code for Monstargear XO87 Hot-Swap and Solderable PCBs

The Hot-Swap board has been officially added to QMK, but this repo will stay active to provide information, prebuilt firmware hex files, and the latest testing source code. The Soldered board firmware is only in beta.

WARNING

This firmware is not compatible with the old factory firmware. If you are using the old factory firmware you will require an ISP reflash of your board. If you are unsure which firmware your board is using, please check here or stop by Monstargear's Discord before attempting to flash your board. The maintainers of this firmware and Monstargear will not be responsible for issues caused by incorrect flashes. Please ask if you are unsure! Suggestions and PRs are welcome.

If you wish to compile your own firmware, you can download QMK from https://github.com/qmk/qmk_firmware. Simply drop the monstargear folder into the qmk keyboards folder and run make monstargear/xo87/rgb:production. Both version of the keyboard are now officially part of QMK. Alternatively, you can use the prebuilt firmware provided here if you do not with to build your own or customize the keyamps. You can then use an ISP flasher to send the production firmware to the board. After you are running this firmware, you can rebuild and flash via bootloader like normal. DO NOT FLASH THE OLD FIRMWARE ONCE YOU ARE USING THE NEW FIRMWARE! Flashing the old firmware over the new firmware will cause your keyboard to become unresponsive and require you to reflash with ISP again.

If you are on the old firmware and using an ISP flasher, please flash the file "monstargear_xo87_rgb_via_production.hex". This file contains both the firmware and bootloader.

If you are already on the newer firmware please use the file name "monstargear_xo87_rgb_via.hex". This file is able to be used through QMK toolbox. If you prefer to use Vial instead of VIA, you can flash "monstargear_xo87_rgb_vial.hex" which is compiled with support for both tools.

To do.

• Clean up and organize LED layout/pattern strangeness
• Update documentation
• Find a way to flash from factory firmware without ISP flashing
• Support for controlling individual LEDs
• Support for soldered version of PCB - Partial
• Full support for LED matrix on soldered board