summaryrefslogtreecommitdiffstats
path: root/keyboards/kmac/readme.md
blob: cd181a5f68a348d01fe706e110885afd03579866 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# 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>`