Edited at

ErgoDox EZ キー配列変更メモ(Mac) 2018

More than 1 year has passed since last update.

ついにErgoDoxEZが届きましたー!!

嬉しい。

キーマップ変更を自分へのメモがてら残します。

1. GUIツールでキー配列を決める

2. GUIツールでキーボードに設定を流し込む
--- (人によってはここで終了) ---
3. 細かい設定をソースコードからコンパイルする( => 1. のソースを改造 )

自分は上記の流れが一番簡単だったと感じました。


  • Mac

  • Homebrew


1. GUIツールでキー配列を決める


キー配列をWeb上で決める

http://configure.ergodox-ez.com/keyboard_layouts/qjnvox/clone

スクリーンショット 2018-07-28 16.27.07.png

上記リンクにアクセスすると、写真のように簡単にキー配列を設定することができます。


  • 編集が終わったら、Name your layout の部分を自分の好きな名前に変更されていることを確認


  • Compile this layout をクリック


  • Download this layoutをクリック(場合によっては、タグを設定してからダウンロード)

  • ergodox_ez_firmware_~~.hex が手に入る

※※ 最後にソースコードとしてダウンロードする可能性があるので、一応このページは残しておくか、コンパイル後にDownload this layoutボタン下でにタグを設定しておきましょう。

※※ タグを設定しておくと、後から、右上のサーチから、自分のキー配列を探すことができます。


2. GUIツールでキーボードに設定を流し込む


Teensyを入手

https://www.pjrc.com/teensy/loader.html

スクリーンショット 2018-07-28 16.40.09.png

上記リンクからTeensyを入手できます。

今回はMacintoshを選択。

リンク先でTeensy Loader Disk Imageをクリックでインストーラーをダウンロードできるので、ダウンロード=>インストール


Teensyを使って、hexファイルを流し込む


1. キーボードをプログラムモードに変更する




この画面が表示されたら、クリップ等でキーボードの右上の穴の中のスイッチを押してください



成功するとTeensyの画面が次のようになります。


2. hexファイルを読み込む




左上の四角いボタンをクリックすると、ファイルを選択できるので、先ほどWeb上で設定し、ダウンロードしてきたhexファイルを選択します


3. hexファイルを流し込む


2.の画像の下向き矢印をクリックしてください。

hexファイルの書き込み(上書き)が始まります。


4. キーボードのリブート


最後に、2.の画像の右矢印をクリックしてください。

キーボードがリブートして、変更内容が反映されているはずなので、確認してください。

以上で、細かい設定をしないのであれば、キーマップ配列の変更は終わりです。 おつかれ様でした。


3. 細かい設定をソースコードからコンパイルする( => 1. のソースを改造 )


ソースコードをコンパイルして、hexファイルを作る


1. avr-gccの入手


Homebrew経由で行います

brew install avr-gcc


2. ソースコードの入手


ここにあります。

cd /path_to_workspace

git clone https://github.com/jackhumbert/qmk_firmware.git


3. コンパイルしてみる


/qmk_firmware

直下で

make clean && make keyboard=ergodox_ez keymap=default

とするとコンパイルが始まります。 成功すると、/qmk_firmwareergodox_ez_default.hexができているはずです。


4. Webで作ったソースを使う


実は一番最初に行ったWeb上で作ったキー配置ですが、hexファイルとしてだけだはなく、ソースコードとしてもダウンロードできます。

Download sourceをクリックで、

ergodox_ez_firmware_~~.c が手に入ります。 

mkdir qmk_firmwqre/keyboards/ergodox_ez/keymaps/YOUR_KEY_MAP_NAME

YOUR_KEY_MAP_NAMEはなんでもいいです。好きな名前にしましょう。

YOUR_KEY_MAP_NAME直下に 先ほどダウンロードしたergodox_ez_firmware_~~.c

を配置してください。

コンパイルします。

make clean && make keyboard=ergodox_ez keymap=YOUR_KEY_MAP_NAME

これが成功したら、qmk_firmware直下にergodox_ez_YOUR_KEY_MAP_NAME.hex

があるはずなので、これを、上記の Teensyの手順でキーボードに反映させることができます。

あとは、qmk_firmware/keyboards/ergodox_ez/keymaps/default/keymap.cのキーマップを参考にしつつ、ergodox_ez_firmware_~~.c

を改造してはコンパイルして反映させましょう!!

間違い等ございましたら教えていただけると嬉しいですm(_ _)m。


キー配列作成時に役立つリンク


参考