qmk_firmware/keyboards/handwired/dactyl
Zach White c0dcee96a8
Initial list of keyboards to exclude from CI (#11213)
2020-12-21 15:38:39 +01:00
..
keymaps
.noci Initial list of keyboards to exclude from CI (#11213) 2020-12-21 15:38:39 +01:00
config.h
dactyl.c
dactyl.h
i2cmaster.h
info.json
matrix.c Port DEBUG_MATRIX_SCAN_RATE to core (#7029) 2019-10-15 13:32:52 +01:00
readme.md
rules.mk Cleanup rules.mk for 32U4 keyboards, H (#7030) 2019-10-20 12:51:37 -07:00
twimaster.c Normalise include statements in keyboard code (#11185) 2020-12-16 14:27:23 +11:00

readme.md

Dactyl

See https://github.com/adereth/dactyl-keyboard

The Dactyl uses the Teensy Loader.

Linux users need to modify udev rules as described on the Teensy Linux page. Some distributions provide a binary, maybe called teensy-loader-cli.

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.