3f4d706c98
* Fixed typo of 'confid.h' to 'config.h' * Fixed broken links in docs * Fixed a lot of dead links * Removed all dead links that I could not find a replacement for * Placed knops links back in * Fixed plank keymaps so that they will compile for planck light * Https doesn't work on knops.io * tv44:budi now compiles * s60_x:amnesia0287 now compiles * Fixed allocation of key_combos so that narze keymap for planck can compile correctly * Disabled rgb on ergodone and infinity * Enabled tap dance so it compiles * Added return statement so it compiles * If compiling on light disable extra functionality * Properly redefined variable so it compiles * Remove remaining dead links
45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
# KMAC keyboard firmware
|
|
|
|
A Korean custom keyboard designed by Byungho Kim and the KBDMania community.
|
|
|
|
## Supported models
|
|
|
|
All the tenkeyless models should be supported.
|
|
|
|
## Bootloader
|
|
|
|
The PCB is hardwired to run the bootloader if the key at the `Caps Lock` position is held down when connecting the keyboard.
|
|
|
|
It is also possible to use Boot Magic and Command to access the bootloader.
|
|
|
|
## Quantum MK Firmware
|
|
|
|
For the full Quantum feature list, see the [documentation](https://docs.qmk.fm).
|
|
|
|
## Building
|
|
|
|
The KMAC are available with two different PCB layouts, a winkey version and a winkeyless version. A default keymap are provided for each versions of the PCB.
|
|
|
|
Depending on which PCB and keymap you would like to use, you will have to compile the firmware slightly differently. All of the commands should be run in the [qmk root](https://github.com/qmk/qmk_firmware/) folder.
|
|
|
|
### Winkey keymap
|
|
|
|
The [default keymap](keymaps/default) are designed for the winkey version of the PCB.
|
|
|
|
### Winkeyless Keymap
|
|
|
|
A [keymap](keymaps/winkeyless) for the winkeyless version of the PCB are also provided.
|
|
|
|
### Custom keymaps
|
|
|
|
To define your own keymap, copy one of the [existing keymap](keymaps) folders and give it the name of your keymap. Then check the [keymap documentation](https://docs.qmk.fm/faq_keymap.html) for details on how to modify the keymap.
|
|
|
|
To make it easy to define keymaps for the different versions of the PCB two macros are provided.
|
|
|
|
| PCB | Macro |
|
|
| -------------- | -------------- |
|
|
| Winkey PCB | `LAYOUT()` |
|
|
| Winkeyless PCB | `LAYOUT_WKL()` |
|
|
|
|
To build the firmware with a custom keymap, run `make <keymap name>`
|