qmk_firmware/keyboards/handwired/bluepill

BluePill handwired

Keyboards using a BluePill controller (generic Chinese STM32F103C8T6) and based on the KC64 of Xydane.

Keyboard Maintainer: FPazos, but I hope to leave the project in better hands. Hardware Supported: Bluepill STM32F103C8T6 Hardware Availability: Everywhere

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

make handwired/bluepill/bluepill70:default

See build environment setup then the make instructions for more information.

{% hint style='info' %} Read everything before using it for something {% endhint %}

Introduction

First of all thanks to Xydane at GeekHack for his advice and his repository, without it you couldn't be reading this.

That's was an attempt to create a firmware using an STM32F103C8T6, and in a "future", also developing a revision for split keyboards. But... As I'm mainly a web developer I didn't even get to debug the controller, not to speak about ChibiOS. So I just structured everything, created a working 70% layout and leave the project to someone with more knowledge and patience.

Resistor fix

If you want to use the Bluepill USB port, it's very likely that you need to solder a 1.8 kΩ between PA12 and 3.3V. That depends on the PC's motherboard but I needed, more info here.

No bootloader

Neither Xydane or I used the bootloader, the code for it is commented and you can use it if you want. I didn't achieve to run it and just used a serial programmer (FTDI, ST-LINK).

Adding layouts and revisions

If you want to create new layouts just add them to the keymaps folder. If you prefer to develop a more complex revision just copy the bluepill70 folder, rename it and create a new keymap in /keymap.c (I tried to divide the project even more but it didn't worked).

Pinout

That's the pinout;

	A5	A15	  A10	A9	A8	B15	 B14  B13	B12	 B11  B10  B1	B0		A7		A6		
B9	ESC| F1 | F2 | F3 | F4 | F5 | F6 | F7 | F8 | F9 | F10| F11| F12| PSC| PGU| PGD
B8	GRA| 1  | 2  | 3  | 4  | 5  | 6  | 7  | 8  | 9  | 0  | '  | ¡  |   BCKS  | DEL
B7	TAB| Q  | W  | E  | R  | T  | Y  | U  | I  | O  | P  | `  | +  |         | HOM
B6	CAP| A  | S  | D  | F  | G  | H  | J  | K  | L  | Ñ  | ´  | Ç  |   ENTER | END
B5	LSI| <  | Z  | X  | C  | V  | B  | N  | M  | ,  | .  | -  |   RSHIF | UP | FNT
A4	LCT| WIN| ALT|               ESPACE             | ALG| FN | RCT| LEF| DOW| RIG

And the wiring:

It also uses: PC13: Caps Lock led. PA1: Backlight.