https://github.com/wose/ferro-dactyl

A BluePill (STM32F103) based Dactyl-Manuform build with keyberon powered firmware written in Rust
https://github.com/wose/ferro-dactyl

dactyl embedded keyboard rust

Last synced: about 1 month ago
JSON representation

A BluePill (STM32F103) based Dactyl-Manuform build with keyberon powered firmware written in Rust

• Host: GitHub
• URL: https://github.com/wose/ferro-dactyl
• Owner: wose
• License: apache-2.0
• Created: 2020-07-06T17:04:52.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-06-16T22:16:49.000Z (about 2 years ago)
• Last Synced: 2024-07-01T17:33:00.697Z (2 months ago)
• Topics: dactyl, embedded, keyboard, rust
• Language: Rust
• Homepage:
• Size: 6.35 MB
• Stars: 13
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

• awesome-dactyl - ferro-dactyl: A BluePill (STM32F103) based Dactyl-Manuform build with keyberon powered firmware written in Rust

README

        
# Ferro Dactyl

![Logo](./images/logo.png)

> A BluePill (STM32F103) based [Dactyl-Manuform] build with [keyberon] powered

> firmware written in Rust. 

![Ferro Dactyl](./images/ferro-dactyl.png)

[Dactyl-Manuform]: https://github.com/20lives/Dactyl-Manuform

[keyberon]: https://github.com/TeXitoi/keyberon

## Layout

I'm using a [AdNW] based Layout. This is a work in progress.

![Layout](./images/layout.png)

You can take the layout definition from the [layout folder] and play with it

over at [Keyboard Layout Editor]. Or use [this link].

[AdNW]: http://www.adnw.de/

[layout folder]:layout/

[Keyboard Layout Editor]: http://www.keyboard-layout-editor.com/

[this link]: http://www.keyboard-layout-editor.com/#/gists/5a7d56aa6b7ebb05c0e3928ac5250a80

## Hardware

The [STLs] are generated using [20lives Dactyl-Manuform fork]. I'm using a 5x6

version.

[STLs]: stl/

[20lives Dactyl-Manuform fork]:  https://github.com/20lives/Dactyl-Manuform

## Firmware

The firmware uses the [keyberon] library.

```shell

curl https://sh.rustup.rs -sSf | sh

rustup target add thumbv7m-none-eabi

sudo apt-get install gdb-arm-none-eabi openocd

git clone https://github.com/wose/ferro-dactyl.git

cd ferro-dactyl

# connect ST-Link v2 to the blue pill and the computer

# openocd in another terminal

cargo run --release

```

See `keyberons` [building instructions] for more info.

[building instructions]: https://github.com/TeXitoi/keyberon/blob/master/BUILDING.md

## License

Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or

  http://www.apache.org/licenses/LICENSE-2.0)

- MIT license ([LICENSE-MIT](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.