Helixビルドログ

OLEDまわりはんだ付け

ここもビルドガイドの通りです。ただ、OLEDソケットはTRRSジャックやリセットスイッチよりも背が低い部品なので、それらより先にOLEDソケットをはんだ付けしたほうがやりやすかったかも？　私はやりにくかったのでProMicroを一旦外してはんだ付けしました。

ソケットをはんだ付けし終わったら、ProMicroを装着してから、その上に被さるようにOLEDピンヘッダとディスプレイを装着します。装着後にOLEDディスプレイとOLEDピンヘッダをはんだ付けします。こうするとピンヘッダが傾かないのではんだ付けしやすいです。

プレートに絶縁シールを貼り付け

私が買ったキットはステンレスプレートなので、このままだとプレートに電流が通ってショートします。
そのため、プレートに絶縁シールを貼ります。貼るプレートはキースイッチをはめる穴が空いているプレートで、PCBに面する側に貼ります。シールにLとRが示してあるので、それを確認しつつ、プレート - シール - PCBの順で合わせてみて向きが問題ないかもあわせて確認すると確実です（最初片方を逆に貼りそうになった）

↓の写真だとわかりにくいですが、右上に「R」の文字があります。

なお、ボトムプレート（キースイッチ用の穴が空いてないやつ）はスペーサーによりPCBと接しないので絶縁シールは不要です。

キースイッチはめ→はんだ付け

写真のようにプレートとPCBを合わせて、キースイッチをはめていきます。ステンレスだからか固くて結構つらかったですが、キースイッチがプレートにひっかかるツメの部分をちょっと押してからはめると多少楽でした。

はめ終わるとこんな感じになります。

きちんと全部のキースイッチの足がPCBから出ているのを確認してから、はんだ付けします。私は片手ずつキースイッチを押してきっちりはまっていることを確認してからはんだしていきましたが、わりと簡単に浮くので、1個ずつ押さえる→はんだづけする、を繰り返したほうが安全かもしれません。

ここまでで組み立てはほぼ終わりで、あとはスペーサーやねじでプレートをPCBに留めて、キーキャップをはめるだけです。その前に、PCBにファームウェアを書き込んだりして動作確認をしました。

動作確認

TRRSケーブルをジャックに差してから 左手側のProMicroにUSBケーブルを差し、動作確認します。USBケーブルを差した側が左手と認識されるので間違えないようにします。先程書き込んだLEDテスト用のファームウェアはデフォルトのキーマップになっていたので、デフォルトのキーマップ定義をGitHubで見ながら確認しました。

ファームウェアいじり（OLEDディスプレイの表示変更）

デフォルトのファームウェアのディレクトリをコピー（今回は keyboards/helix/rev2/keymaps/default を keyboards/helix/rev2/keymaps/hyoshihara04 にコピー）してから自分用にファームウェアを変更します。やったのはキーマップの変更とOLEDの表示内容の変更です。前者については割愛して、ここでは後者について書きます。

HelixはデフォルトのキーマップだとWin/Macに接続した時のために一部キーの動作を変更するキーが割り当てられています。そのキーを押してキーの動作が変わると、それに合わせて左側のOLEDディスプレイにWin/Macを表わすロゴが表示されるようになっています。が、私はmacにしか接続する予定がなかったので、 推しのアイドルの顔文字 好きな顔文字を常に表示するようにしました。また、右側もついでに変えてみたくなったので 推しのアイドルグループのマーク 好きな柄を表示するようにしました。いじってはみたかったがネタがなかった。

まず Helixのファームウェアのガイド を元にフォントの元になるファイルを変更しました。
最終的なフォントは以下のようになりました。もともとあったロゴを上書きする形で追加しています。

その後はファームウェアのコードを変更します。
左側は keymap.c の render_status() 関数の中で描画されていたので、その中でキーの動作変更に合わせて表示を変えている部分を顔文字が出るように修正しました。書き込む値はどういう根拠で計算してるのかよくわからなかったのですが、もともとあったロゴの位置から計算しました。実際のコードはこんな感じです。

  static char logo[2][7]={{0x95,0x96,0x97,0x98,0x99,0x9a,0},{0xb5,0xb6,0xb7,0xb8,0xb9,0xba,0}};
  matrix_write(matrix, logo[0]);
  matrix_write_P(matrix, PSTR("\n"));
  matrix_write(matrix, logo[1]);

右側は同じ keymap.c の render_logo() 関数の中で描画されていたので、こちらも左側と同様に書き換えます。 0x20 は空白で、省くと☆がくっつきます。

  static char logo[2][20]={
  {0x9b,0x9c,0x9d,0x20,0x9b,0x9c,0x9d,0x20,0x9b,0x9c,0x9d,0x20,0x9b,0x9c,0x9d,0x20,0x9b,0x9c,0x9d,0},
  {0xbb,0xbc,0xbd,0x20,0xbb,0xbc,0xbd,0x20,0xbb,0xbc,0xbd,0x20,0xbb,0xbc,0xbd,0x20,0xbb,0xbc,0xbd,0}
  };

  matrix_write(matrix, logo[0]);
  matrix_write_P(matrix, PSTR("\n"));
  matrix_write(matrix, logo[1]);

両方とも、配列の初期化時の要素数を修正するのを忘れないようにします（数が合ってないとビルド時にエラーで止まります）
変更したら次のコマンドを実行してビルドと書き込みをします。

$ make helix/rev2:hyoshihara04:avrdude

両手とも書き込んだら、USBケーブルを抜いて、TRRSケーブルで左右を繋ぎ、改めてUSBケーブルを左手側のProMicroに接続して動作確認して完了です。TRRSケーブルを差したままでUSBケーブルを抜き差しすると予期しないところに電流が通って最悪壊れるらしいので注意します。

完成してから写真を撮ったので保護プレートがついてたりキーキャップがすでにはまっていたりしますが、OLEDは↓のように表示されます。（ Layer: ○○○ の ○○○ のところは現在のレイヤーによって変わります）

プレートねじ止め&キーキャップはめ

OLED保護用とボトム用のプレートを、ビルドガイド通りスペーサーをはさみつつねじ止めします。表面保護のシートを剥がすのにいつも苦戦します。
その後、カスタマイズしたキーマップにあわせてキーキャップをはめます。購入したキーキャップだと一部キーは対応するものがないので、別のキー用のもので代用します。

完成

使ってみての感想

ステンレスなので割とずっしりしてます。少々押してもずれない。
最近使っていたのがErgo42だったので、数字キー行があるキーボードを久々に使っているのですが、便利だと思う一方で、わざわざ遠くまで指を伸ばさなくても、別レイヤーでホームポジションの近くに設定した数字を押している時もあります。Emacsとかで同時押しするときは数字キーあった方が便利かなと思うのですが、慣れの問題のような気もします。
あと Default , Lower , Raise , Adjust （キーボード自体の調整用のキーがあるレイヤー）の4レイヤーを設定しているのですが、このキー数だとレイヤー数は3つで十分な感じがしてきました。というのも、押したいキーが大体 Default と Lower にあるせいで多分1回も Raise レイヤーを使っていない……。もっとキー数減らしてレイヤーも Default と Lower と Adjust だけで私は十分かもしれない、ということがわかりました。この辺はOSやどういう作業をするのかで結構変わりそうです。
ただ、それだとErgo42でいいという話になりそうなんですが、そもそも最下段も若干余ってるので、3行＋親指で押すキーがいくつかあれば私の場合はいいのかも？　ということに気づいたのでまた別のキーボードを作る予定です。最終的には設計から自分でやりたい。