qmk_firmware/keyboards/handwired/dactyl/readme.md

40 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 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 `QK_BOOT` 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 `QK_BOOT` key, press it.
* If you lack a RESET key, press the reset button on the Teensy board itself.