Skip to content
joric edited this page Sep 11, 2023 · 564 revisions

This article is about Pro Micro-based Jorne firmware. For the nRFMicro firmware see jorne_ble.

Official QMK Jorne firmware

Downloads

QMK Repository

ZMK firmware

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

Unofficial QMK firmware

This is the old version, it uses Jorne keymap with the Crkbd firmware (you may just copy the keymap to Crkbd).

Downloads

This firmware supports Jian layout, OLED screens and 56 LEDs, including ambient (12 LED) versions:

Firmware repository

Layout

  • Raise + Lower + rgbrst reset and sync RGB backlighting
  • Raise + Lower + rgbtog turn RGB on and off
  • Raise + Lower + rgbmod switch between RGB modes

Uploading firmware

To upload the firmware, press Reset shortly and run this within 8 seconds (assuming COM11 is Pro Micro bootloader port, you can peek it up in reset mode using Device Manager or Dmesg):

avrdude -p atmega32u4 -P COM11 -c avr109  -e -U flash:w:crkbd_rev1_jorne.hex

Swapping halves

To swap USB cable from left to right preserving keymap you need to use #define EE_HANDS (already done) and flash EEPROM settings (.eep files). These files are part of QMK (see quantum/split_common folder), they allow to swap USB cable and support swap shortcut.

EEPROM settings for the left half, flash to the left half (eeprom-lefthand.eep):

avrdude -p atmega32u4 -P COM11 -c avr109 -U eeprom:w:eeprom-lefthand.eep

EEPROM settings for the right half, flash to the right half (eeprom-righthand.eep):

avrdude -p atmega32u4 -P COM11 -c avr109 -U eeprom:w:eeprom-righthand.eep

So you'd need to flash each half with the main firmware and then with eep settings.

Building

The firmware is compatible with crkbd keymaps (extra key can be snapped off). You can either:

To build, run make crkbd:jorne from the QMK root directory.

Misc

QMK logo editor

USB Mass Storage Bootloader

It's possible to flash USB Mass Storage bootloader and use USB Drive for updates but it costs 2Kb:

jorne-rgbm

There is also an experimental jorne-rgbm branch where I'm trying advanced RGB matrix effects such as digital rain (also see #5998). Remapping a physical RGB LEDs location is pretty complicated.

jorne-split-common

(New!) There's also an experimental jorne-split-common branch, QMK split_common based (forked from Kyria) that uses the latest split_common features (Corne is not yet converted to split_common).

References