tiny-deck

tinygo-keebで作成したzero-kb02を使って Xxx-deckみたいにMacをちょっとだけ便利にします。

マイコン：waveshare-rp2040-zero

実装済み

• CPU・メモリ使用率をOLEDに表示する
• 使用率に応じてLEDマトリクスにバー表示する
• ロータリーエンコーダーで音量を調節する
• joystickでマウスホイールスクロール（押下中はゆっくり下スクロール）
• キー入力・長押しでレイヤーを切り替える
• macOSの通知を検知してLEDを光らせる
• USB接続でhost_daemonを自動起動する

展望

• 10キーにする

セットアップ

ファームウェア書き込み

mise run flash

ホスト常駐デーモンの自動起動 (macOS)

デバイスを USB 接続したタイミングで host_daemon を起動し、切断で終了する LaunchAgent を登録する。

mise run install

• バイナリ: ~/.local/bin/tiny-deck-host
• plist: ~/Library/LaunchAgents/com.github.rin2yh.tiny-deck.plist
• ログ: ~/Library/Logs/tiny-deck.log

通知監視のため macOS の Full Disk Access を tiny-deck-host に許可する必要がある (システム設定 → プライバシーとセキュリティ → フルディスクアクセス)。

アンインストール:

mise run uninstall

再インストール (多重起動してしまった場合の掃除付き)

plist の IOKit マッチング設定ミス等で複数プロセスが同時起動してしまった場合、 install.sh を走らせる前に稼働中のデーモンを明示的に止めてから入れ直す。

launchctl bootout "gui/${UID}/com.github.rin2yh.tiny-deck" 2>/dev/null || true
pkill -f "${HOME}/.local/bin/tiny-deck-host" || true
mise run install

背景は docs/2026-04-20-usb-attach-kernel-panic.md を参照。