Thanks to visit codestin.com
Credit goes to github.com

Skip to content

cloudgazing/qubit

Repository files navigation

Qubit

Keyboard firmware with a variety of features, for different microcontrollers.

Note

This project is still work in progress, those features are still being worked on :).

Chips supported:

  • RP2040
  • STM32F411

Note

RA version 2025-07-21 has an issue with reading env values from cargo config. This affects the import_device macro used in qubit's build.rs. Use version 2025-07-14 until that issue is fixed.

Building the firmware

Requirements

  1. Rust. The recommended install method comes with cargo out of the box.
  2. Build tools. These can be installed by running cargo install cargo-make flip-link.

After installing all the required tools simply run cargo make build --author <author name> --model <model name> to build for one of the supported devices. (building using a toml configuration file is not yet implemented)

Flashing

The easiest way to flash the firmware is using a probe. This project uses probe-rs to help with that. To install with cargo, run cargo install probe-rs-tools --locked.

Eg. flashing for STM32F411:

probe-rs run --chip STM32F411CEUx target/thumbv7em-none-eabihf/debug/qubit`

Flashing without a probe

For RP2040 specifically elf2uf2-rs can be used to turn the binary into a UF2 file. Run

cargo install --git https://github.com/StripedMonkey/elf2uf2-rs

to install it and

elf2uf2-rs target/thumbv6m-none-eabi/debug/qubit qubit.uf2

to convert it, then drag and drop it on the mounted device.

TODO:

  • finish writing instructions for building the firmware
  • switch between NKRO and 6KRO at runtime
  • add LED support
  • add storage support
  • add support for other components
  • extend support different type of devices
  • other stuff

License

This project is licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependency Licenses

Some dependencies of this project are licensed under different terms.

See COPYRIGHT for details.

About

Open-source keyboard firmware.

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages