jorne_ble

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

• https://github.com/joric/qmk_firmware/tree/nrf52-jorne (nrf52 jorne fork)
• https://github.com/joric/qmk_firmware/tree/nrf52-jorne/keyboards/jorne_ble (just a keyboard folder to copy)

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

• http://www.keyboard-layout-editor.com/#/gists/df19fba80500d1179dfda8c41b9f221a

• 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)

• master.uf2 (left half)
• slave.uf2 (right half)

Latest

(Uses nRFMicro 1.3)

• master.uf2 (left half)
• slave.uf2 (right half)

Building

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

Use provided build scripts to build uf2 binaries:

• https://github.com/joric/qmk_firmware/blob/nrf52-jorne/keyboards/jorne_ble/build.cmd
• https://github.com/joric/qmk_firmware/blob/nrf52-jorne/keyboards/jorne_ble/build_slave.cmd

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

Status

Works

• Bluetooth master/slave, pairing, resetting bonds (hold 3 thumb keys on power on)
• OLED screen (merged from https://github.com/sekigon-gonnoc/qmk_firmware/pull/13)
• RGB and RGB sync, see https://github.com/sekigon-gonnoc/qmk_firmware/issues/28

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

• https://imgur.com/a/T2GXaLw

References

• https://github.com/joric/nrfmicro (nRFMicro board)
• https://github.com/joric/jorne (Jorne keyboard hardware)
• https://github.com/sekigon-gonnoc/qmk_firmware/tree/nrf52 (original fork)
• https://blog.ottijp.com/2019/10/12/corne-cherry-ble-wireless/ (BMP + Corne, in Japanese)
• https://github.com/ottijp/qmk_firmware/tree/nrf52/keyboards/crkbd_ble (another nrf52 fork for BMP + Corne)