Skip to content

jorne_ble

joric edited this page May 1, 2022 · 217 revisions

This is about wireless version. For wired version see jorne. You can also use Bluemicro or ZMK (preferred).

Firmware repository

ZMK

See https://github.com/joric/nrfmicro/wiki/ZMK

QMK

TL;DR

This keyboard uses two separate firmware files for master (left half) and slave (right half).

Master pairs to the computer via Bluetooth. Slave pairs to master automatically. To reset bonds on master or slave hold three thumb keys Raise + Lower + Shift on the selected board, press reset (power cycle the keyboard), then release the keys.

To charge the battery you have to plug USB cable in the corresponding half, TRRS cable is not used in wireless mode and it isn't wired for charging.

Layout

  • Raise + Lower + Shift also types battery voltage in mV (for debugging)

Uploading

To update firmware, plug in USB in the corresponding half (left is master, right is slave), double press reset button, drag and drop uf2 file to the USB drive, then flash the other half the same way.

Stable

(Uses flipped nRFMicro 1.1, with antenna facing up)

Latest

(Uses nRFMicro 1.3)

Building

Read https://github.com/joric/nrfmicro/wiki/QMK first.

Use provided build scripts to build uf2 binaries:

The echo dfu| plink.exe -serial com26 is to reset into bootloader, you may just press reset twice.

Status

Works

Possible Issues

  • No Bluetooth - Make sure there's #define ENABLE_STARTUP_ADV_NOLIST in the config.h.

Debugging

You can use QMK nRF52 virtual serial port for debugging nRFMicros. It runs when you plug in the USB cable (see device manager for the list of COM ports), prints debug commands, runs interactive microshell and generally makes your life easier. Send "dfu\n" to reboot into a bootloader mode and upload new firmware (you may override bootloader_jump() with sd_power_gpregret_set(0, DFU_MAGIC_UF2_RESET) to run UF2 drive). Send "help\n" for the list of available commands.

>help
reset   Reset system
adv     Start advertising
dfu     Jump to bootloader
show    Show bonded devices
del     Delete bond information
help    Show this message

Video

Pictures

References

Clone this wiki locally