400ca2d035
* Change _delay_ms/us() to wait_ms/us() * Switch to platform-agnostic GPIO macros * Add AVR spi_master and migrate Adafruit BLE code * Set verbose back to false * Add clock divisor, bit order and SPI mode configuration for init * Add start and stop functions * Move configuration of mode, endianness and speed to `spi_start()` * Some breaks here would be good * Default Adafruit BLE clock divisor to 4 (2MHz on the Feather 32U4) * Remove mode and divisor enums * Add some docs * No hr at EOF * Add links in sidebar |
||
---|---|---|
.. | ||
_summary.md | ||
hardware_avr.md | ||
hardware_drivers.md | ||
hardware_keyboard_guidelines.md | ||
hardware.md | ||
newbs_best_practices.md | ||
newbs_building_firmware_configurator.md | ||
newbs_building_firmware.md | ||
newbs_flashing.md | ||
newbs_getting_started.md | ||
newbs_learn_more_resources.md | ||
newbs_testing_debugging.md | ||
newbs.md | ||
README.md |
Firmware Quantum Mechanical Keyboard
¿Qué es el firmware QMK?
QMK (Quantum Mechanical Keyboard) es una comunidad open source que mantiene el firmware QMK, QMK Toolbox, qmk.fm, y estos documentos. El firmware QMK es un firmware para teclados basado en tmk_keyboard con algunas características útiles para controladores Atmel AVR, y más específicamente, la línea de productos OLKB, el teclado ErgoDox EZ, y la línea de productos Clueboard. También ha sido portado a chips ARM chips usando ChibiOS. Lo puedes utilizar para manejar tu propio teclado ya sea cableado a mano o basado en una PCB personalizada.
Cómo conseguirlo
Si estás pensando en contribuir con un keymap, teclado, or característica a QMK, la manera más sencilla es hacer un fork del repositorio en Github, y clonar tu repositorio localmente para hacer los cambios, subirlos, y abir un Pull Request desde tu fork.
De cualquier manera, también puedes descargarlo directamente en formatos (zip, tar), o clonarlo via git (git@github.com:qmk/qmk_firmware.git
), o https (https://github.com/qmk/qmk_firmware.git
).
Cómo compilar
Antes de poder compilar, necesitarás instalar un entorno para el desarrollo de AVR y/o ARM. Una vez hayas completado este paso, usarás el comando make
para compilar un teclado y keymap con la siguiente notación:
make planck/rev4:default
Este ejemplo compilaría la revisión rev4
del teclado planck
con el keymap default
. No todos los teclados tienen revisiones (también llamados subproyectos o carpetas), en ese caso, se puede omitir:
make preonic:default
Cómo personalizar
QMK tiene montones de características para explorar, y una buena cantidad de documentación de referencia en la que sumergirse. Se pueden sacar provecho de la mayoría de las características modificando tu keymap, y cambiando los keycodes.