qmk/keyboards/handwired/dactyl
Nick Brassel 9c2ca00074
QMK CLI Environment bootstrapper (#25038)
Co-authored-by: Joel Challis <git@zvecr.com>
Co-authored-by: Pascal Getreuer <getreuer@google.com>
2025-11-28 00:36:49 +11:00
..
keymaps Remove deprecated RGB_ and Mouse keycodes (#25444) 2025-07-11 11:05:41 -06:00
config.h Move TAPPING_TOGGLE to data driven (#21360) 2023-06-24 17:10:22 +10:00
dactyl.c
dactyl.h
keyboard.json Remove empty url fields (#25181) 2025-04-22 17:59:00 +01:00
matrix.c i2c: rename read/write register functions (#22905) 2024-01-16 02:26:40 +00:00
readme.md QMK CLI Environment bootstrapper (#25038) 2025-11-28 00:36:49 +11:00
rules.mk Data-Driven Keyboard Conversions: H, Part 2 (#23525) 2024-04-15 19:22:31 +01:00

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 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.