README.md

trove: Rust firmware for Keyboardio Atreus

Experimental Rust firmware for the Technomancy/Keyboardio Atreus.

The firmware is largely based on the arduino_keyboard example from atmega-usbd, and the Kaleidoscope firmware from Keyboardio.

Build Instructions

1. Install prerequisites as described in the avr-hal README (avr-gcc, avr-libc, avrdude, ravedude).

2. Run cargo build --release to build the firmware.

3. Run cargo run --release to flash the firmware to a connected board. If ravedude fails to detect your board, check its documentation at https://crates.io/crates/ravedude.

   • This may require specifying the serial port of the keyboard (e.g. RAVEDUDE_PORT=/dev/ttyACM0 on linux).

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

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.