logo

qmk_firmware

custom branch of QMK firmware git clone https://anongit.hacktivis.me/git/qmk_firmware.git

readme.md (2454B)

    

  1. # Acheron Elongate rev. Delta QMK firmware repository
  3. ![](https://i.imgur.com/G9LESkUh.jpg)
  5. * Keyboard Maintainer: [Gondolindrim](https://github.com/Gondolindrim)
  6. * Hardware Supported: [open-source PCB](https://github.com/AcheronProject/Elongate) powered by STM32F072 microcontroller
  7. * Hardware Availability: as of december 2021, the group buy for Elongate is already over and extras sales are pending.
  9. ## Introduction
  11. This is the QMK firmware repository for the Elongate PCB revision Delta, which was the revision publicly sold at the group buy. Revisions Alpha and Beta were sold in private group buys and never ran publicly.
  13. The Elongate PCB is an Open-Hardware-guideline-compliant PCB which files can be found at [this repository](https://github.com/AcheronProject/Elongate). Its designer and maintainer is [Gondolindrim](https://github.com/Gondolindrim).
  15. ## How to flash
  17. ### Enter bootloader
  19. The DFU state in the bootloader can be accessed in 3 ways:
  21. * **Bootmagic reset**: Hold down the key at (0,0) in the matrix (usually the top left key or Escape) and plug in the keyboard
  22. * **Physical reset button**: press the button on the front of the PCB, next to caps lock, for at least five seconds
  23. * **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available (escape key at layer 2 in the default firmware)
  25. ## Compile firmware
  27. You can build the default layout firwmare for Elongate after setting up your build environment by using:
  29.     make acheron/elongate/delta:default
  31. After entering DFU state in your PCB, you can download the binary file generated through `dfu-util` or a GUI like QMK Toolbox.
  33. To directly flash the PCB after it is put into a DFU state, use
  35.     make acheron/elongate/delta:default:flash
  37. See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
  39. ## PCB Documentation
  41. See the [AcheronDocs](https://acheronproject.com/pcbs/elongate/) page for the ElongatePCB full documentation. You can also check the KiCad PCB files at the [Elongate GitHub repository](https://github.com/AcheronProject/Elongate).
  43. Before using the files for personal or commercial use, please read the [Acheron Open-Hardware License V1.4](https://acheronproject.com/AOHL14/) under which the Elongate PCB is published.