cck0

ZMK firmware config for the CCK_BALL 4x6 split keyboard.

This repository contains a maintained firmware configuration for a real CCK_BALL 4x6 build. It is used to build and maintain left/right keyboard firmware with GitHub Actions, and is kept public as a reference for other CCK_BALL, ZMK, and custom split-keyboard users.

Hardware

• Keyboard: CCK_BALL 4x6
• MCU: nice!nano v2
• ZMK board target: nice_nano//zmk
• Firmware: ZMK
• Build: GitHub Actions

Included

• Left and right shield builds
• Settings reset build
• ZMK Studio support
• Basic firmware build workflow
• Public documentation for keymap, flashing, and troubleshooting notes

Build Targets

Firmware is built from the matrix in build.yaml:

• nice_nano//zmk + cck_ball_left
• nice_nano//zmk + cck_ball_right
• nice_nano//zmk + settings_reset

The physical controller is a nice!nano v2. The build target uses the current ZMK / Zephyr 4.1 board naming convention, where nice!nano v2 builds as nice_nano//zmk.

The right-side build also enables ZMK Studio support with the studio-rpc-usb-uart snippet and CONFIG_ZMK_STUDIO.

Documentation

• Keymap notes
• Flashing notes
• Troubleshooting notes
• Roadmap

Build Workflow

Firmware is built with GitHub Actions.

1. Push changes to this repository.
2. Open the Actions tab.
3. Run or inspect the firmware build workflow.
4. Download the generated firmware artifact.
5. Flash the matching firmware to each side of the keyboard.
6. Use the settings_reset build when persistent settings need to be cleared.

Why This Exists

This is a focused hardware firmware configuration repository. It is small by design, but correctness matters: keymap, shield, manifest, driver, and build settings can directly affect whether the firmware builds and whether the physical keyboard works correctly.

I keep this repository public so other CCK_BALL or ZMK users can study a working split-keyboard configuration, understand the build setup, and adapt parts of it for their own hardware.

Planned Improvements

• Add a clearer layer-by-layer keymap table
• Add more detailed flashing and recovery notes
• Add troubleshooting examples for common ZMK build issues
• Keep firmware build settings easier to review
• Publish tagged firmware configuration snapshots

Photos