This repository contains the firmware source code for building a USB HID keyboard with the Pro Micro development board using hall-effect switches.

The web configurator companion is GoonBoard-Configurator.

• 1000 Hz polling rate
• Rapid trigger
• SnapTap (two modules)
• Full on-the-fly reconfigurability for:
  • Keymaps
  • Actuation points per key
  • Rapid trigger enable/sensitivity
  • SnapTap enable/keys
• NKRO Support

Since I have used the PlatformIO toolchain for the entirety of the development process, the steps using PlatformIO will be shared.

1. Install Visual Studio Code.
2. Install the PlatformIO extension.
3. Open the GoonBoard-HE workspace.
4. Click on the PlatformIO: Build button.
5. Click on the PlatformIO: Upload button.
6. Put your microcontroller into DFU mode by shorting RST and GND.
7. Wait a few seconds and your microcontroller will be recognized as GoonMandu GoonBoard with VID:PID 2B00:B1E5.

Tested with ATmega32U4 @ 16 MHz, target polling rate 1000 Hz, both SnapTap modules enabled.

Reference release: V3.250814.0

Format:

V{compat}.{YY}{MM}{DD}.{n}

• compat: Integer. This changing means that the hardware/timing compatibility or pin assignments have changed and is not physically compatible with other compat versions.
• YY: Two-digit year.
• MM: Zero-padded month.
• DD: Zero-padded day.
• n: Integer. Release number in the same day.

I will not be paying much attention to this repository once I have implemented the features I want so they will probably be ignored. If you want to build upon this repository and want clarification, please feel free to annoy me at:

Discord: goonmandu
Email: hwang [dot] mingi7 [at] gmail [dot] com

All files under src/ that do not contain a license header are licensed under the MIT License, Copyright (c) 2025 Mingi Hwang.

This firmware is built upon the Keyboard demo from the LUFA repository:

• LUFA:

  LUFA Library
  Copyright (C) Dean Camera, 2021.
  
  dean [at] fourwalledcubicle [dot] com
  www.lufa-lib.org
  
  Permission to use, copy, modify, and distribute this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that the copyright notice and this permission notice and warranty disclaimer appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.
  
  The author disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness.  In no event shall the author be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.