This guide is intended for Pabile Keyboards featuring Pro Micro ATMEGA32U4 microcontrollers. Please note that flashing new firmware will erase all existing configurations on the controller, so ensure you have a backup or a copy of your settings before proceeding.
The instructions provided are tailored for Microsoft Windows. While non-Windows users can use this guide as a reference, be aware that the process may vary for other operating systems.
Software Required: You will need QMK Toolbox to flash the firmware to your keypad. Although there are other methods for flashing firmware, this guide will focus on using QMK Toolbox.
Firmware File: Each keypad requires a specific firmware file. These files are provided in a .hex format and can be found here. Download the firmware that matches your keypad model.
Reset Button: The reset button is located at the bottom of the keypad. To press the reset button, use a small blunt tool such as a toothpick, as it is accessible through a small hole. Some keypads may have been released without a physical reset button—use tweezers for these models.
To update the firmware, your keypad/controller needs to enter the bootloader state, where it can accept new firmware. Follow these methods to enter bootloader mode:
For Keypads Running VIA/VIAL Firmware:
Unplug the USB cable from the keypad.
Press and hold the top-left key (e.g., "Q" for models like P40, P42). For a visual demonstration, see this video.
Reconnect the USB cable to the keypad and your PC while continuing to hold the key.
Release the key once the computer detects the device (indicated by a "device plugged in" sound).
For New or Unresponsive Pro Micro Controllers: Press the reset button on the keypad directly.
If the Reset Button Method Fails: Double-tap the reset button quickly (two rapid presses).
Important: The bootloader state is active for only 8 seconds. Ensure you flash the firmware within this window, or the keypad will revert to normal operation.
The reset button is usually located beneath the bottom casing of the keypads, accessible through a small hole. This button is designed to connect (ground) the RST and GND pins on the controller. When these pins are grounded, the controller will enter bootloader mode, allowing it to accept new firmware.
On the left is the reset button of P9v1.
Grounding GND and RST pins with tweezer will put the keypad to bootloader state.
For pads showing back (bottom) side of the Pro Micro microntroller, GND and RST pins are shown on the right. Grouding these pins will enter bootloader sate.
Bootloader state will show as new COM port in Windows' Device Manager. QMK Toolbox automatically detects this COM number.
With QMK Toolbox open, reset the keypad. QMK Toolbox will display the text in yellow line. Or something similar to: *** Caterina device connected. Arduino LLC ....
Under Local file, click on Open to locate and select your firmware file.
Under Microcontroller, select atmega32u4.
Check Auto-Flash.
Refer to the instructions above for details on how to reset the keypad or enter bootloader mode.
Once the keypad enters bootloader mode, QMK Toolbox will automatically flash the firmware if the "Auto-Flash" option is enabled.
A successful flash will display output similar to the example on the right. If the flashing process fails, check the error messages for details. Common issues are often related to timing, as the bootloader is only active for 8 seconds.
Video posted below shows how to flash a P9v2 macropad by press-holding the top left most key (R0C0).
Test keypad using Vial's matrix tester or a notepad. If all keys register, you may proceed to configure your keypads. Backup VIAL layouts (default configuration) can be found here - select the layout applicable to the keypad and load it using Vial configurator.
Older Pro Micro controllers with micro USB ports are generally easier to flash, with a straightforward bootloader entry process. However, newer versions featuring USB Type-C ports may be more challenging to reset. If you encounter difficulties, try resetting the controller twice quickly; this method often resolves the issue. [Source]
There were instances that flashing with QMK Toolbox fails. Using AVERDUDESS to flash firmware fixed this issue.
Ensure you are using USB data cables for flashing firmware. If the keypad functions correctly with the cable connected, it is suitable for firmware updates.
Date updated: 26JAN23 rev-14AUG24