Please help to improve this guide. Edit the page here.
- Status Led‘s (blue solid state)
- Which and what changes
- How to enter bootloader mode
- How to compile/use ZMK
- Create a ZMK Puchi-BLE board
- How to compile/use QMK nrf52 fork
- How to flash a firmware
- What batteries are supported
- Puchi-BLE supports 1S LiPo batteries (4.2V)
- Only use LiPo batteries with a protection circuit, because the Puchi-BLE has no low voltes (discharge) protection for batteries
- A 301230 (3.0 x 12 x 30 mm) LiPo battery fit between 4.5mm tall pin sockets
- Connect the battery to B+ (red) and B- (black ), or RAW (red) and GND (black) (these pairs of pins are internally connected)
- Avoid reverse polarity (nRF52840 chip is usually destroyed first)
- Note that a few keyboards have RAW and VCC pins connected together (namely Helix and Gherkin), and will kill the controller (RAW pin is for the charger only). You may just not solder RAW pin to the keyboard as a workaround.
I don't offer LiPo batteries in the shop, because of the German strict law.
A customized Adafruit nRF52 Bootloader is flashed on the Puchi-BLE.
Here you can find the changes from the original Adafruit nRF52 Bootloader.
The Bootloader binary already contain the Bluetooth stack (a.k.a SoftDevice).
Press RESET (short RST with GND) twice within 500ms.
The blue led will start slowly dimming and a Mass Storage (NRF52BOOT) should appear in your file explorer.
Now you can copy the ZMK UF2 firmware file on it. After copying the UF2 file to the Mass Storage, the Puchi-BLE will automatically reboot and load the new firmware.
- Red solid: power connected
- Blue 2x blinking: restart
- Blue slow flashing (every 3sec):
waiting for bluetooth connection
- Blue fast flashing:
- Blue off:
connected via bluetooth
- Blue slow dimming: USB Mass Storage mode, for firmware update
- Blue solid: ?
Build UF2 firmware file for Corne left side ...
west build -p -d build/left -b puchi_ble_v1 -- -DSHIELD=corne_left
After a successful build, you can find the UF2 firmware file in the
... and right side.
west build -p -d build/right -b puchi_ble_v1 -- -DSHIELD=corne_right
More information about 'Building For Split Keyboards' here.
Here you can find the precompiled firmware files (UF2) for the Corne and Lily58 keyboard.
Detailed documentation by Joric
|Puchi-BLE||nRFMicro 1.3+||nice!nano||ProMicro||Left||Right||ProMicro||nice!nano||nRFMicro 1.3+||Puchi-BLE|
- P0.18 - RESET
- P1.10 - BLUE_LED (P0.15 on nice!nano)
- P1.09 - POWER_PIN (EXT_VCC control, P0.13 on nice!nano) (1-off, 0-on)
- P0.04 - BATTERY_PIN (analog battery voltage in mV, 820kΩ/2MΩ)
P0.31, P0.29, P0.02, P1.15, P1.13, P1.10, P0.30, P0.28, P0.03, P1.14, P1.12, P1.11, P0.10, P0.09, P1.07, P1.06, P1.05, P1.04, P1.03, P1.02, P1.01
P0.00, P0.01, P0.26, P0.27, P0.04, P0.05, P0.06, P0.07, P0.08, P1.08, P1.09, P0.11, P0.12, P0.14, P0.16, P0.18, P0.19, P0.21, P0.23, P0.25, P0.13, P0.15, P0.17, P0.20, P0.22, P0.24, P1.00
Detailed pin information can be found on the Nordic Infocenter.
- Do i need a TRRS cable to connect the split keyboard halfs?
- No, the slave side connects wireless to the master side. Optional you can use a cable (no charge over TRRS cable).
- What's the battery life?
- Approximately 2weeks with a 100mAh battery (no oled, or led‘s).
- Is there a lag while typing?
- Bluetooth devices can reach a latency of 1.3 ms. Lower latency means more power drain and reduce the battery life.
- Is it possible to switch between Bluetooth devices?
- Yes, QMK and ZMK have support for up to 5 Bluetooth profiles.
- What batteries work with the Puchi-BLE?
- LiPo batteries with 1S. Also important is that the LiPo batterie has a protection circuit
- Are batteries available in the shop?
- No, due to the german law, i don’t offer batteries in the shop. You can get LiPo batteries on Ebay and Aliexpress.
- What are the EXT_VCC and EXT_GND? Are they the same pins as VCC and GND?
- Yes. Power output is sofware-controlled to save battery (RGB LEDs draw up to 1 mA each when off).