Important

リポジトリを移動しました。

https://github.com/nazo6/rktk/tree/master/keyboards/keyball61-rp2040

keyball-embassy-rp2040

ProMicro RP2040用のRust(+Embassy)製Keyballファームウェアです。

紹介記事: RustとEmbassyでKeyballのファームウェアを作った

ステータス

基本的なキースキャン機能とレイヤ機能を実装しています。keyboard/keymap.rsを編集することでキーマップを変更できます。

既知の不具合

• 左右間の通信が不安定なことがある
• メディアキーが効かない

ビルド

1. elf2uf2-rsをインストール

cargo install elf2uf2-rs

2. BOOTSELボタンを押しながらProMicro RP2040をUSBに接続
3. src/config.example.rsをsrc/config.rsにコピー
4. src/keyboard/keymap.example.rsをsrc/keyboard/keymap.rsにコピー
5. 実行

cargo run --release

Tip

このファームにはダブルリセットでBOOTSELに入る機能が内蔵されているため、以降はBOOTSELボタンを押しながら差す必要はありません。

Note

通常のProMicroのようにハードウェアでダブルリセットを検知しているわけではないので、ダブルタップが早すぎると検知されません。

進行状況

基本機能

• 基本的なキースキャンとUSB HIDへの出力
• PMW3360によるマウス入力とUSB HIDへの出力
• 分割キーボード間通信(partial)
  • 半二重通信によるバイト列の送受信
  • postcardによるバイト列のシリアライズ/デシリアライズ
  • master側でのデータの受信と処理
• OLEDディスプレイ
  • 文字表示
  • ステータス表示
  • 画像表示
  • せっかく容量があるのでアニメーションとか表示したい
• LED(ws2812)
  • とりあえずなんか光る
  • きれいに光らせる

やらなければならないこと

• master/slave判定をちゃんとする(今はマウスあるかどうかで判定している)
• PMW3360のSPI通信の安定化(なぜか認識されないことが多々ある)
• sendの失敗検知と再送信
• OLED未接続時にpanicしないようにする
• master側がまあまあ熱くなるのを直す

やりたいこと

• 高度なキーマップ機構(レイヤなど)
• 左トラックボール対応

将来の展望

• Keyball61以外の対応
• Vial対応
• BLE Micro Pro対応(NRF52なのでできないことはなさそう？)

CREDITS

これらの先人がいなければここまで作れませんでした。

• もろもろ参考
  • keyball-rs
• ダブルリセットでBOOTSEL
  • https://github.com/Univa/rumcake/blob/2fa47dce9ab2b2406dd5465ccc9ce7b23e5ffdb0/rumcake/src/hw/mod.rs
• PMW3360ドライバ関連
  • https://github.com/kndndrj/mouse/tree/8c3cf4707cc392c16c91dc11e53f954f0fd820f1/firmware-rust/mouse-libs/src/pmw3360
• 分割キーボード間半二重通信
  • QMK Firmware
  • rusty-dilemma