12KEMP V2.1 is a 12 key 4 by 3 macropad, that features a Xiao SEEED Studio RP2040 with vial-qmk support, a clickable rotary encoder, a completely custom pcb with hot-swap support for 3/5-pin regular MX switches, as well as a complete case. All related files are in this repo, and you may create any form of case to mount the pcb onto, though it may take some time. Additionally, a bill of materials (BOM) is included.
I made this project, 1. for school, and 2. for the hackclub blueprint event.
In order to install the firmware on the SEEED Studio RP2040 (RP2350 is not supported in QMK yet), hold the boot button on the microcontroller while plugging it into your computer. Once plugged in, a USB Mass Storage Device should appear. Download and move the .uf2 firmware file to the device. After the firmware has been put on the flash, the microcontroller should restart automatically. The firmware has now been installed.
In order to use this project, one can either download Vial from get.vial.today, or use their web interface. When plugged in, the device should show up on the top in a little dropdown. (Web users may have to manually select the device when setting up) If necessary, select the device from the dropdown. Now you can manually change what each key on the macropad does, simply by clicking the key you want to change and selecting what you want it to do from the bottom. You can change what keys on the other layers do as well, by just clicking the numbers right under the dropdown on the left.
Copyright 2025 William C.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License atat
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.nse.
