QMK_firmwareで自作キーボードのキーマップの変更

# はじめに
先日はじめての自作キーボード**Mint60**を作成し，その際キーマップを変更したときの手順をまとめています．

**Mint60**の制作については，また後日まとめて出そうと思います．

# 目標
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/487681/1bb8df24-09e4-ac82-1a62-502b6e602644.png)

この初期のキーマップから
- aキーの横のCapsLock→Ctrl
- 左半分の下段を左からESC,Ctrl,Alt,Command,Space
- 右半分の下段を左からSpace,Command,Alt,←,↓,→
に変更します．

普段はMacBookで使っていこうと思っているので,Spaceの横はCommandキーを置いています．Windowsで使うときは，CommandとAltを入れ替えて使う予定です．

CapsLockは使わないキーなのでファームウェア上でCtrlに置き換えることで排除します．

# 変更手順
1. QMK Firmware　をクローンしてくる．
2. QMK FirmWare  のビルド環境を作る．
3. キーマップの変更
4. ビルド
5. 左右のPro Microに書き込む．

が大まかな流れになります．

## QMK Firmwareをクローンしてくる．
ターミナルなどで下のコマンドをたたくと，Githubからクローンしてきます．
``$ git clone https://github.com/qmk/qmk_firmware
``
クローンが終わったら**qmk_firmware**に移動しましょう．

## QMK FirmWare  のビルド環境を作る．
ビルドに必要なものをインストールしてくれるスクリプトがあるので，これを実行してビルド環境を作ります．
``$ ./util/qmk_install.sh
``

## キーマップの変更
今回Mint60のキーマップを変更するのでMint60での方法を書きますが，ほかでもあまりやっていることは変わらないです．mint60のところを自分の自作キーボードに書き換えればできます．

Mint60のキーマップは,keyboards/mint60/keymapsの中にあって，defaultとeucalynの二種類があると思います．

```terminal:
$ ls keyboards/mint60/keymaps
default eucalyn
```
eucalynはMint60の製作者のゆかりさんが考えた配列です．

キーマップをいじるためにdefaultをコピーして書き換えます．

```terminal:
$ cp -r keyboards/mint60/keymaps/default keyboards/mint60/keymaps/custom_for_mac
```

custom_for_macのところは自分でわかる好きな文字列にして大丈夫です．

``keyboards/mint60/keymaps/custom_for_mac/keymap.c``を好きなエディタを用いて書き換えます．

内部で書かれてるマクロの定義は,``tmk_core/common/keycode.h``の中に書かれているので，わからなくなったらここのを確認してみましょう．

書き換えた結果僕は下のようになりました．

```c:keymap.c
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
  [0] = LAYOUT( \
    KC_GRV,  KC_1,    KC_2,    KC_3,    KC_4,    KC_5,      KC_6,    KC_7,    KC_8,    KC_9,    KC_0,    KC_MINS, KC_EQL,    KC_BSPC,  \
    KC_TAB,    KC_Q,    KC_W,    KC_E,    KC_R,    KC_T,      KC_Y,    KC_U,    KC_I,    KC_O,    KC_P,    KC_LBRC, KC_RBRC, KC_BSLS,  \
    KC_LCTL,     KC_A,    KC_S,    KC_D,    KC_F,    KC_G,      KC_H,    KC_J,    KC_K,    KC_L,    KC_SCLN, KC_QUOT,        KC_ENT,   \
    KC_LSFT,       KC_Z,    KC_X,    KC_C,    KC_V,    KC_B,      KC_N,    KC_M,    KC_COMM, KC_DOT,  KC_SLSH, KC_RSFT,   KC_UP,  MO(1),   \
    KC_ESC,    KC_LCTL,    KC_LALT,    KC_LGUI,    KC_SPC,        KC_SPC, KC_RGUI,  KC_RALT,               KC_LEFT,KC_DOWN,KC_RGHT \
  ),
  [1] = LAYOUT( \
    KC_ESC,  KC_F1,   KC_F2,   KC_F3,   KC_F4,   KC_F5,     KC_F6,   KC_F7,   KC_F8,   KC_F9,   KC_F10,  KC_F11,  KC_F12,    KC_DEL, \
    RGB_TOG,   RGBRST,  RGB_HUI, RGB_SAI, RGB_VAI, XXXXXXX,   XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, \
    XXXXXXX,     RGB_MOD, RGB_HUD, RGB_SAD, RGB_VAD, XXXXXXX,   XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX,        XXXXXXX, \
    _______,       XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX,   XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, XXXXXXX, _______, KC_PGUP, _______, \
    XXXXXXX,   _______,    _______,    _______,    XXXXXXX,       XXXXXXX, XXXXXXX, XXXXXXX,                   KC_HOME, KC_PGDN, KC_END \
  )
};
```

## ビルド

```terminal
$ make mint60:custom_for_mac
```
を実行してファームウェアのビルドをします．

## 左右のPro Microに書き込む．
ビルドしたものをPro Microに書き込みます．
まずパソコンとキーボードを接続して，下のコマンドをたたきます．

```terminal
$ make mint60:custom:avrdude
```
すると,デバイスの検知が始まるので，キーボードについているリセットボタンを押すと検知され，自動的に書き込みが始まると思います．

書き込みが終わったら完了です．

(補足)
左右のキーボードに書き込んで，確認したところなぜか左右のキーマップが逆転する事態が発生した．もう一度書き込みなおしたらなおったので，もしかすると書き込むときの順番が関係あるのかも知れない．

#おわりに
ファームウェアの書き込みは，難しそうと思ってましたが以外に簡単にできました．

レイヤー機能があるのでもっといかせるようにキーマップを魔改造していきたいですね．