QMK/keyboards/handwired/dactyl/readme.md

40 lines
1.3 KiB
Markdown
Raw Normal View History

2020-03-23 10:48:11 +01:00
# Dactyl
See https://github.com/adereth/dactyl-keyboard
The Dactyl uses the [Teensy Loader](https://www.pjrc.com/teensy/loader.html).
Linux users need to modify udev rules as described on the [Teensy
Linux page]. Some distributions provide a binary, maybe called
`teensy-loader-cli`.
[Teensy Linux page]: https://www.pjrc.com/teensy/loader_linux.html
To flash the firmware:
- Build the firmware with `make handwired/dactyl:<keymapname>`, for example `make handwired/dactyl:default`
- This will result in a hex file called `handwired_dactyl_<keymapname>.hex`, e.g.
`handwired_dactyl_default.hex`
- Start the teensy loader.
- Load the .hex file into it.
- Put the Teensy in firmware-loading mode:
* If your current layout has a RESET key, press it.
* If you lack a RESET key, press the reset button on the Teensy board itself.
- Click the button in the Teensy app to download the firmware.
To flash with ´teensy-loader-cli´:
- Build the firmware as above
- Run `<path/to/>teensy_loader_cli -mmcu=atmega32u4 -w handwired_dactyl_<keymapname>.hex`
- If you like, you can do both at once: `make handwired/dactyl:<keymapname>:teensy`
- Put the Teensy in firmware-loading mode:
* If your current layout has a RESET key, press it.
* If you lack a RESET key, press the reset button on the Teensy board itself.