Add handwired/positron/12pad keyboard by juarendra · Pull Request #26362 · qmk/qmk_firmware

juarendra · 2026-07-24T16:32:59Z

Description

Adds the Positron Electronic 12pad: an open-source 12-key hotswap macropad with a rotary encoder, per-key RGB (WS2812), sold in Indonesia.

MCU: STM32F401 (WeAct Blackpill, development_board: blackpill_f401)
3x5 matrix (12 keys + encoder push), COL2ROW
1 rotary encoder with encoder map
12x WS2812 RGB matrix
USB VID/PID: 0x1209:0x2012, requested at pid.codes (Add 1209/2012: Positron Electronic 12pad pidcodes/pidcodes.github.com#1249)
Hardware/source: https://github.com/juarendra/12pad-QMK-VIA

Types of Changes

Checklist

My code follows the code style of this project: C
I have read the PR Checklist document and have made the appropriate changes.
My change requires a change to the documentation.
I have updated the documentation accordingly.
I have read the CONTRIBUTING document.
I have added tests to cover my changes.
I have tested the changes and verified that they work and don't break anything (as well as I can manage).

zvecr · 2026-07-24T17:26:47Z

Please remove this file.

zvecr · 2026-07-24T17:26:53Z

Please remove this file.

zvecr · 2026-07-24T17:27:48Z

+
+#define WEAR_LEVELING_LOGICAL_SIZE 4096
+#define WEAR_LEVELING_BACKING_SIZE 8192


Suggested change

#define WEAR_LEVELING_LOGICAL_SIZE 4096

#define WEAR_LEVELING_BACKING_SIZE 8192

zvecr · 2026-07-24T17:28:17Z

+/* Copyright 2024 Juarendra Ramadhani <jrjuarendra@gmail.com>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */


Suggested change

/* Copyright 2024 Juarendra Ramadhani <jrjuarendra@gmail.com>

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 2 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <http://www.gnu.org/licenses/>.

*/

// Copyright 2026 juarendra

// SPDX-License-Identifier: GPL-2.0-or-later

zvecr · 2026-07-24T17:28:34Z

+VIA-enabled firmware:
+
+    qmk compile -kb positron/12pad -km via
+


Suggested change

VIA-enabled firmware:

qmk compile -kb positron/12pad -km via

zvecr · 2026-07-24T17:28:56Z

+* Hardware Supported: WeAct Blackpill STM32F401 (USB Type-C)
+* Hardware Availability: [Positron Electronic](https://github.com/juarendra/12pad-QMK-VIA)
+
+Making the firmware (after copying this folder to `qmk_firmware/keyboards/positron/12pad`):


Suggested change

Making the firmware (after copying this folder to `qmk_firmware/keyboards/positron/12pad`):

Make example for this keyboard (after setting up your build environment):

zvecr · 2026-07-24T17:29:15Z

+* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available
+
+Flash with [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases), `qmk flash`, or `dfu-util` directly:
+
+    dfu-util -a 0 -d 0483:df11 -s 0x08000000:leave -D positron_12pad_via.bin
+
+## VIA
+
+The device is auto-detected by [VIA](https://usevia.app/) once the definition is merged upstream.
+For manual sideload use
+[`12pad_via_definitions.json`](../../../12pad_via_definitions.json) via the Design tab.


Suggested change

* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available

Flash with [QMK Toolbox](https://github.com/qmk/qmk_toolbox/releases), `qmk flash`, or `dfu-util` directly:

dfu-util -a 0 -d 0483:df11 -s 0x08000000:leave -D positron_12pad_via.bin

## VIA

The device is auto-detected by [VIA](https://usevia.app/) once the definition is merged upstream.

For manual sideload use

[`12pad_via_definitions.json`](../../../12pad_via_definitions.json) via the Design tab.

* **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available

zvecr · 2026-07-24T17:43:13Z

Your hardware repo does not contain files for a PCB. Is this handwired?

…drop chconf.h and rules.mk

juarendra · 2026-07-24T18:05:08Z

Yes, this is handwired — the 12 hotswap sockets and the encoder are wired point-to-point to a WeAct Blackpill F401 dev board. Wiring diagram: https://github.com/juarendra/12pad-QMK-VIA/blob/main/DOC/WIRING%20MACROPAD%2012PAD%20BY%20POSITRON%20ELEKTRONIK.drawio.pdf

I've applied all the review suggestions in ecfdf72:

removed chconf.h and rules.mk
moved MIDI to features.midi and wear leveling to eeprom.wear_leveling.backing_size in keyboard.json
SPDX license header in config.h
simplified readme.md

Happy to move the keyboard under keyboards/handwired/ if that's the preferred location — just let me know.

zvecr · 2026-07-24T18:56:44Z

Happy to move the keyboard under keyboards/handwired/ if that's the preferred location — just let me know.

Yes, this must be moved.

QMK review requires handwired boards under keyboards/handwired/ (qmk/qmk_firmware#26362). Update CI and docs paths accordingly. BREAKING CHANGE: build target is now handwired/positron/12pad; binaries are named handwired_positron_12pad_<keymap>.bin.

juarendra · 2026-07-24T19:05:04Z

Done — moved to keyboards/handwired/positron/12pad in 1e400b5, readme build targets updated to match.

zvecr · 2026-07-26T15:51:04Z

Please stop converting this from draft. We will require the PR to pid.codes to be merged first, and it being draft stops this PR from being accidentally processed.

Add positron/12pad keyboard

37a474e

github-actions Bot added keyboard keymap labels Jul 24, 2026

Apply QMK formatting

5e78a3f

zvecr requested changes Jul 24, 2026

View reviewed changes

zvecr added the awaiting_pr Relies on another PR to be merged first label Jul 24, 2026

zvecr marked this pull request as draft July 24, 2026 17:33

Apply review feedback: move MIDI and wear leveling to keyboard.json, …

ecfdf72

…drop chconf.h and rules.mk

juarendra requested a review from zvecr July 24, 2026 18:40

Move to handwired/positron/12pad

1e400b5

juarendra force-pushed the add-positron-12pad branch from 754c497 to 1e400b5 Compare July 24, 2026 19:04

juarendra changed the title ~~Add positron/12pad keyboard~~ Add handwired/positron/12pad keyboard Jul 24, 2026

juarendra marked this pull request as ready for review July 25, 2026 00:21

zvecr marked this pull request as draft July 25, 2026 12:17

drashna approved these changes Jul 26, 2026

View reviewed changes

juarendra marked this pull request as ready for review July 26, 2026 15:00

zvecr marked this pull request as draft July 26, 2026 15:49


		#define WEAR_LEVELING_LOGICAL_SIZE 4096
		#define WEAR_LEVELING_BACKING_SIZE 8192

	Making the firmware (after copying this folder to `qmk_firmware/keyboards/positron/12pad`):
	Make example for this keyboard (after setting up your build environment):

Uh oh!

Uh oh!

Conversation

juarendra commented Jul 24, 2026

Description

Types of Changes

Checklist

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

zvecr Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

zvecr commented Jul 24, 2026

Uh oh!

juarendra commented Jul 24, 2026

Uh oh!

zvecr commented Jul 24, 2026

Uh oh!

juarendra commented Jul 24, 2026

Uh oh!

zvecr commented Jul 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

zvecr commented Jul 26, 2026 •

edited

Loading