This community firmwarw has been tested with Cornix using ZMK and provides full split-role configuration, battery power management, and Bluetooth central/peripheral setup per ZMK split guidelines

• 52 keys full layout keymap, since v2.0
• ec11 encoder, since v2.2
• no-SD image, since v2.3
• rgb since v3

Cornix shield has 2 RGB LEDs on each side, controled by PWM in the stock firmware.

The replacement solution is adapting the RGB indicator module to light up these RGBs, to achieve the same effect as the stock firmware, which uses the RGB LEDs to indicate battery status and connection status.

But it is not supported yet in this repository. PR is welcome!

Cornix Split Tented Low‑Profile Ergo Keyboard (Jezail Funder)

Cornix is a Corne‑inspired split ergonomic keyboard featuring a compact 3×6 column‑staggered layout with six thumb‑cluster keys (three per half). It offers adjustable tenting angles at 10°, 18°, and 25°, allowing users to reduce wrist strain and find a custom ergonomic alignment

• Split, column‑staggered layout (3×6 + thumb cluster layout).
• Adjustable tenting support at 10°, 18°, 25° (hardware‑based, no firmware hacks).
• Kailh Choc V2 hot‑swap sockets and support for LAK or LCK low‑profile keycaps.
• Dual‑mode connectivity: Wired USB‑C or Bluetooth wireless (left half as master).
• Firmware: Fully VIAL‑supported for keymaps and layer customization, stock firmware is RMK.
• Premium CNC‑machined aluminum chassis, custom damping foam, and portable storage pouch.

this project owner is RMK contributor too, support RMK https://rmk.rs/ please

-- The original RMK firmware removed the SoftDevice, so before flashing zmk.uf2, you need to restore the SoftDevice first. For specific steps, please refer to bootloader/README.md. --

Since v2.3 this board' flash partitions has updated, removed SD (reducing sd partitionsize size from 150K to 4K), so You can flash firmware directly.

You may need to reset fw by reset.uf2 from ealier version

You can rollback to stock firmware by flash orgin uf2 file, backup files under rmkfw/

If you’re new to ZMK and don’t want to deal with west.yml or module management, you can simply use this repository directly to customize your firmware.

1. Fork or Clone This Repository

   • Click Fork in the top right to copy this repo to your GitHub account, or
   • Run git clone locally.

   Forking is recommended, because GitHub Actions will automatically build your firmware.

2. Edit Your Keymap

   • Locate the keymap file in config/cornix.keymap (or whichever .keymap file you want to customize).
   • You can edit it directly or use the ZMK Keymap Editor:
     • Open the editor and load your .keymap file.
     • Make changes with the visual editor.
     • Download the updated file and replace it in your repository.
     • Commit and push the changes to GitHub.

3. Build with GitHub Actions

   • After pushing, GitHub Actions will automatically run the build.
   • Once the workflow finishes, go to Actions → your latest run → Artifacts and download the firmware (.uf2) files.

4. Flash Your Keyboard

   • Put your board into UF2 bootloader mode (usually by double-tapping the reset button).
   • Drag and drop the .uf2 file onto the mounted drive.

• Beginners to ZMK
• Users who only want to customize keymaps
• Anyone who doesn’t need to modify drivers or hardware definitions

This section will guide you through building the Cornix ZMK firmware from scratch using the official ZMK firmware development process.

Before starting, ensure you have the following:

• A GitHub account Git installed on your system
• Basic understanding of Git and GitHub
• Your Cornix keyboard PCBs ready

1. Create a new repository using the official ZMK config template:

   • Visit: https://github.com/zmkfirmware/unified-zmk-config-template
   • Click "Use this template" → "Create a new repository"
   • Name your repository (e.g., cornix-zmk-config)
   • Choose "Public" or "Private" as preferred
   • Click "Create repository"

2. Clone your new repository locally:

   git clone https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git
   cd YOUR_REPO_NAME

3. Initialize ZMK development environment:

   west init -l config/
   west update
   west zephyr-export

Important: You should thoroughly read the ZMK documentation before proceeding, as ZMK firmware development has a learning curve.

• ZMK Customization Guide: https://zmk.dev/docs/customization
• ZMK Configuration: https://zmk.dev/docs/user-setup

After initializing your zmk-config repository, follow the steps in the next section to integrate the Cornix shield.

For users with existing zmk-config, add this repository dependency via west.yml and pull the latest version via west update:

Edit the config/west.yml file, add to the manifest/remotes section:

remotes:
  - name: zmkfirmware
    url-base: https://github.com/zmkfirmware
  - name: cornix-shield
    url-base: https://github.com/hitsmaxft
  - name: urob
    url-base: https://github.com/urob

Add to the manifest/projects section:

projects:
  - name: zmk
    remote: zmkfirmware
    revision: main
    import: app/west.yml
  - name: zmk-keyboard-cornix
    remote: cornix-shield
    revision: main
  - name: zmk-helpers
    remote: urob
    revision: main

west update

Edit the build.yaml file, add:

include:
  # Use cornix with dongle
  - board: cornix_dongle
    shield: cornix_dongle_eyelash dongle_display
    snippet: studio-rpc-usb-uart
    artifact-name: cornix_dongle

  - board: cornix_ph_left
    # shield: cornix_indicator
    artifact-name: cornix_left_for_dongle

  # Use cornix without dongle
  - board: cornix_left
    # shield: cornix_indicator
    artifact-name: cornix_left

  - board: cornix_right
    # shield: cornix_indicator
    artifact-name: cornix_right

  - board: cornix_right
    shield: settings_reset
    artifact-name: reset

Use your preferred method to build

• no need to recovery the sd since 2.3
• falsh reset.uf2 both side of cornix
• flash left and right uf2 files
• reset both side at the same time.

Flash the generated .uf2 files to the corresponding microcontroller:

• Left half: build/left/zephyr/zmk.uf2
• Right half: build/right/zephyr/zmk.uf2

If you prefer to build this project locally without adding it as a dependency in your west.yaml, you can use the ZMK_EXTRA_MODULES cmake argument.

1. Have a working ZMK development environment set up
2. Clone this repository to a local directory

1. Clone this repository:

   git clone https://github.com/hitsmaxft/zmk-keyboard-cornix.git

2. Configure your ZMK build with the extra module:

   Edit your .west/config file and add the cmake argument under the [build] section:

   [build]
   cmake-args = -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DZMK_EXTRA_MODULES=/full/absolute/path/to/zmk-keyboard-cornix

   Replace /full/absolute/path/to/zmk-keyboard-cornix with the actual absolute path where you cloned this repository.

3. Build the firmware:

   west build -b cornix_e73 -- -DSHIELD=cornix_main_left
   west build -b cornix_e73 -- -DSHIELD=cornix_right

This method allows you to use the Cornix shield without modifying your existing ZMK configuration's west.yaml file.