build guide

この記事は自作キーボードキット Arabica3/7のビルドガイドです。
※現在遊舎工房で販売されているキットはすべてv1.3.1ですのでこのページを参考にして組み立ててください。
v1.2基板のビルドガイドはこちら

parts

キット内容物

※一部予備が含まれています

名称	数量	備考
PCB	2	リバーシブル
スイッチプレート	2	"
ボトムプレート	2	"
チルトプレート	2	"
Promicroカバー	2	"
ハイプロプレート	2
TRRSジャック	2
タクトスイッチ	2	リセットスイッチ用
スペーサ M2 8mm	20
ネジ M2※	40
ダイオード	44	スルーホール
Kailh PCBソケット	44	CheryMX用
ゴム足	10

※現在のバージョンでは表側用の低頭ネジと裏側用の鍋ネジに分かれています

別途用意する必要のあるもの

名称	数量	備考
キースイッチ	44	MX互換
キーキャップ	44	キースイッチに合うもの
ProMicro	2	コンスルー使用可
スタビライザー	2	小指キー用 2U
microUSBケーブル	1	PCとの接続用
TRRSケーブル	1	左右の接続用

オプション

名称	数量	備考
SMDダイオード	44	1N4148W
SK6812mini	44	Backlight用
デジタルLEDテープ	2	Underglow用
配線材	6	Underglow用
OLEDモジュール	2
4pinピンヘッダ	2	OLED用
4pinピンソケット	2	OLED用

組み立て

PCBはリバーシブルです。どちらを左/右にしてもかまいません。
基本的に左右の実装は同じですが、Pro microの位置とSK6812miniの向きは間違えやすいので注意してください。

1.ダイオードを半田付けする

PCBの片面にダイオードを半田付けします(このあとの説明ではダイオードを実装する面を裏側とします)。
実装する場所は下図の赤い枠で囲われた部分です。四角い方のパッドがマイナスです。
※ダイオードには極性があります。黒い線が入っている方がマイナスなので向きを間違えないよう注意してください。

1-A.スルーホールのダイオード(キット付属)を使う場合

PCB上の穴に合わせて足を折り曲げます。

ダイオードを穴に通します。黒い線が入っている側がPCB上の四角いパッドに来るようにします。

裏返して半田付けします。

飛び出している足をニッパーで切ります。

1-B.SMDのダイオード(別売り)を使う場合

パッドの片側に予備はんだをします。

ダイオードを載せ半田付します。
向きに注意（ダイオードは印が付いている側、PCBはスルーホール用のパッドが四角い側がカソードです）

2.バックライトLEDを半田付けする(オプション)

バックライトに用いるSK6812miniは熱に弱く、実装難易度が高いため、温度調節可能な半田ごてとフラックスを使うことを推奨します。

フルカラーバックライトLEDを使用する場合

PCBの裏側から図の赤い枠で囲われた部分にSK6812miniを実装します。
PCB上の四角で囲われたパッド(図の赤く塗りつぶされたパッド)が+5Vです。

写真のように+5VのパッドにSK6812miniの一番大きいパッドが当たるように置き、パッドにフラックスを塗ります。
※+5Vのパッドは左右で位置が異なるので注意してください。

半田ごての温度を220℃～250℃に設定し、こて先に溶かしたはんだをパッド上になびるようにしてはんだを盛ります

3.OLEDモジュール用ジャンパとピンヘッダ(オプション)

OLEDモジュールを使う場合

下図の赤い枠で囲われた部分にはんだを盛ってジャンパします。この作業は__表側のみ__行います。

次に、OLED用のピンヘッダを図の位置に実装します。表から差し込み、裏返して半田付けします。

4.タクトスイッチ、TRRSジャックを半田付けする

TRRSジャック、タクトスイッチをPCBの表側に実装します。

5. ProMicroを実装する

ProMicroを図の位置の表側に実装します。PCB上の白い枠で囲われた列(図の赤く塗りつぶされた穴)にピンヘッダを差し込みます。
ピンヘッダは通常のものに加えてスプリングピンヘッダ(コンスルー)も利用できます。

5-A.コンスルーを使う場合

コンスルーは上下があります。

コンスルーをPCBの先ほどの図の位置に差し込みます。下の写真のようにコンスルーの窓が同じ方向を向くように差し込むことが推奨されています。このとき、コンスルーとPCBは半田付けしないでください。

差し込んだコンスルーの上にProMicroを平対面が上になるよう乗せ、コンスルーとProMicroを半田付けします。

5-B.コンスルーを使わない場合

ピンヘッダとPCBを半田付けし、さらにその上にProMicroを裏面(平たい方)を上にして半田付けします。

飛び出した足はニッパーで切り取ります。

6.PCBソケットを半田付けする

PCBソケットをPCBの裏側の図の位置に実装します。

まず、パッドにはんだを盛ります。

次に、ソケットを載せ、側面からこて先をあててはんだを溶かし取り付けます。このとき、ソケットが浮かないようにで押さえながら作業してください。

7. OLEDモジュールを実装する(オプション)

OLEDモジュールを使う場合

手順3で取り付けたピンソケットにOLEDモジュール用ピンヘッダを差し込みます。

さらにその上にOLEDモジュール用をのせ、ピンヘッダとモジュールを半田付けします。OLEDモジュールが傾かないよう押さえながら半田付けしてください。

8.OLEDおよびバックライトLEDの動作確認(オプション)

OLEDモジュールの動作確認

ファームウェアの章を参考にArabica3/7のファームウェアを書き込みます。
正しく取り付けられていればOLEDモジュールが点灯し、左手側にはレイヤー状態と入力履歴が、右手側にはロゴが表示されます。
ソケットを取り付けた部分のパッドをショートさせたとき、OLEDの表示が変わってPCに文字が入力されれば動作確認は完了です。

バックライトLEDの動作確認

ファームウェアの章を参考にファームウェアの書き込み環境を用意し、以下のコマンドでLEDテスト用のファームウェアを書き込みます。

~~$ make helix:led_test:avrdude~~
現在は
$ qmk flash -kb helix -km led_test

正しく取り付けられていればLEDが赤、緑、青で点滅します。SK6812miniは数珠つなぎ状に信号を伝達していくので、動作しないものがあるとその後に接続されているLEDもすべて点灯しなくなります。
LEDが点灯しない原因は以下のいずれかです

点灯していないLEDの半田付けにミスがある
点灯していないLED自身が壊れている
点灯していないLEDの前の番号のLEDのDOUTが基板と接続されていない

LEDの接続順は下図の通りです。これを参考に半田付けの見直しを行ってください。

9. スタビライザーをはめ込む

2Uキー用のスタビライザーをPCBにはめ込みます。

10. ProMicroカバー用スペーサーを取り付ける

ProMicro付近の穴にスペーサーを後ろから5mmのネジで止めます。

。

11. プレートにスイッチをはめ込む

スイッチプレートの4つの角にだけスイッチをはめ込みます。

12. プレートとPCBを合わせる

スイッチの足がPCBソケットにささるようにスイッチプレートとPCBを合わせます。

13. スイッチをはめ込む

残りのスイッチをはめ込みます。
ソケットに差し込む際にスイッチの足が曲がっているとうまくささらず、折れてしまうことがあるので注意してください。

14. Promicroカバーを取り付ける

手順10で取り付けたスペーサーにPromicroカバーを取り付けます。

15. プレートを合わせる

ボトムプレートにスペーサーを取り付け、PCBと合わせたスイッチプレートをボトムプレートに乗せます。さらにハイプロプレートを重ねてねじどめします。ハイプロプレートの取り付けには長い方のねじをつかいます。
※ハイプロプレートは非常に壊れやすいので、保護紙を剥がしてからスイッチ穴の部分を切り離し、すぐに取り付けてください。

16. キーキャップを取り付ける

キーキャップをはめます。

17. ゴム足をつける

ボトムプレート底面に付属のゴム足を貼り付けます。
もしくは、ペデスタルプレート、チルトプレート利用することも出来ます(現在データ配布のみで販売は行っていません)。

ファームウェア

QMK firmwareの準備

__ファームウェアの本家mergeについて(2020/5/18追記)__

Arabica3/7のファームウェアが[QMK本家](https://github.com/qmk/qmk_firmware)にマージされました。別途キーボード用のファームウェアをダウンロードする必要はありません。下記の手順に従ってファームウェアを導入してください。また、それに伴いファームウェアにいくつか変更を加えているため、古いファームウェアとはわずかに仕様が異なります。例えば、QMK本家の方針で`keymap.c`でキーコードを定義する際の`KC_`を省略するマクロは削除されています。`KC_`マクロを用いたファームウェアも[別途用意してあります](#追加キーマップ)。

こちらを参考にしてファームウェアを書き込むための環境を用意します。
~~WindowsではMSYS2、MacではhomebrewなどのLinuxコマンドラインを扱うツールが必要です。~~
従来のコマンドラインからの利用も可能ですが、新規に環境構築を行う場合はQMK MSYSを使用する方法が簡単です。リンク先の指示に従ってインストールと準備を行ってください

ファームウェアを書き込む

PCにProMicroを接続したあと、

$ cd qmk_fimware
でQMK firmwareのフォルダを開きます。
別の場所にQMK firmwareを保存している場合は $ cd (保存場所) で開きます。
(既に開いている場合は不要です)

次に、
$ qmk flash -kb arabica37/rev1 -km default
でコンパイルと書き込みを行います。

Waiting for USB serial port - reset your controller now (Ctrl+C to cancel).....

という表示が出たら、キーボードのリセットボタンを押します。ProMicroの種類によっては二度押しもしくは長押しする必要があります。
(組み立て前に書き込みを行う場合は、ピンセット等を使いRSTピンをGNDに落とします)

以上でデフォルトファームウェアの書き込みが完了です。
同様にしてもう片手側にも書き込みます。二回目以降は左右を接続しマスター側に書き込みを行うだけでアップデートできます。

以前のバージョンのQMK_firmwareでのファームウェアセットアップと書き込みの方法

$ git clone https://github.com/qmk/qmk_firmware.git
でQMK Firmwareをダウンロードし、
$ cd qmk_firmware
$ util/qmk_install.sh
として準備完了です。

ファームウェアを書き込む

PCにProMicroを接続したあと、

$ cd qmk_fimware
でQMK firmwareのフォルダを開きます。

次に、
$ make arabica37/rev1:default:avrdude
でビルド、書き込みを開始します。

Detecting USB port, reset your controller now...

という表示が出たら、キーボードのリセットボタンを押します。ProMicroの種類によっては二度押しもしくは長押しする必要があります。
(組み立て前に書き込みを行う場合は、ピンセット等を使いRSTピンをGNDに落とします)

avrdude.exe done. Thank you.

と出たら書き込み完了です。同様にしてもう片手側にも書き込みます。二回目以降は左右を接続しマスター側にがわに書き込みを行うだけでアップデートできます。

キーマップを変更する

・追加キーマップ

標準ではDefaultキーマップのみが用意されていますが、それとは別に、こちらにカスタマイズされたファームウェアとキーマップを用意しています。こちらのファームウェアは、QMK本家のものと異なり、キーマップを設定する際のKC_を省略出来るようになっています。

rev1/rev1.hを新しい物に置き換え、libフォルダおよびkeypmapsフォルダの中身を追加することで追加キーマップを使えるようになります。
フォルダ全体をそのまま置き換えたり、別名のフォルダを作っても構いません(別フォルダに保存する場合はコンパイル時に指定するキーボード名を対応する場所にしてください)。

現在は、標準的なキーボードと同様のQWERTY配列のjp_qwertyと、より効率的な入力を目指して作られたCOLEMAK配列のjp_colemakの二つが用意されています。

書き込みのときは
$ make arabica37/rev1:(キーマップ名):avrdude
で書き込むキーマップを選択します。
現在のバージョンのQMKでは
qmk compile -kb arabica37/rev1:(キーマップ名):avrdude
でコンパイル、
qmk flash -kb arabica37/rev1:(キーマップ名):avrdude
で書き込みを行います。

キーマップの名称は、keymapsフォルダ直下のキーマップフォルダの名前です。

・オリジナルのキーマップを設定する

Defaultキーマップもしくは追加キーマップを複製し、キーマップフォルダ内のkeymap.cを編集することで、自由にキーマップを定義することが出来ます。
キーマップファイルの編集の詳細ついては、長くなるためここでは解説しません。別の記事を参考にしてみてください。

追加キーマップではLAYOUT_kcを使っているためKC_を省略した形で記述できます。KC_で始まらないキーコードの再定義はlib/keycode_exchanger.hにまとめてありますが、keymap.cに直接書き連ねることも可能です。

・OLEDモジュールのロゴを変更する

デフォルトでは、スレイブ側(右手側)のOLEDモジュールにはArabica3/7のロゴが表示されますがこの表示も自由に変更することが可能です。
OLEDモジュールの表示はlib/glicdfont.cで設定されています。
OLEDに表示したい画像ファイル(JPEGもしくはPNG)を用意したら、guri3氏のHelix OLED Dot Makerで変換する方法が簡単です。
変換したファイルをlibフォルダに入れ、keymaps/(キーマップ名)/config.hの#define OLED_FONT_Hにパスを設定することでディスプレイを変更出来ます。