Repository navigation
BALAN v0.4.0
BALAN v0.4.0
Balance Board Assisted Reading And Navigation — Wii Balance Board を、足で操作する常駐スクロールアプリ。
v0.4.0 の変更点
電池が弱ったときに、ボードのセンサーが反応しなくなる問題への対応です。
- センサーが固まったときの検知と警告: 接続は生きているのに、センサーの生の値が 60 秒間まったく変化しない(または荷重のデータが 3 秒届かない)と、警告を出します。そのとき、画面とトレイの通信ランプが赤になり、状態が「Sensors frozen」になります(接続は切りません。値が戻れば緑に戻ります)
- 電池残量の%表示をやめました: 実機では、電池が切れる直前まで 98% のままで、当てになりませんでした。ボード自身が「電池残量わずか」と報告したときだけ「Battery LOW」と警告します
- 切断の原因ログ: 想定外の切断が起きたとき、接続時間、受信フレーム数、例外などをフッターと
balan.log(Windows:%APPDATA%\BALAN\、Linux:~/.config/BALAN/)に残します - ボードの電池の生の値も
balan.logに記録します
v0.3.1 までの機能(Horizontal モード、二重起動の防止、トレイのモード切替、シャットダウン時の修正)は、そのまま含みます。
モード
- Vertical(既定): 右足で進む、左足で止まる。TR = 上 / BR = 下、TL または BL が 5 kg 以上でブレーキ
- Horizontal: 右足で右へ、左足で左へ。TR/BR = 右、TL/BL = 左
荷重が 2 kg 未満は無反応、2〜3 kg が Slow、3〜4 kg が Medium、4 kg 以上が Fast(なめらかなカーブ)。
ダウンロード
| ファイル | 対象 | 状態 |
|---|---|---|
BALAN-win-x64.zip |
Windows 10/11 x64(.NET 不要、単一 exe) | 実機で動作確認済み(Horizontal・二重起動防止・トレイのモード切替・シャットダウン時の修正・センサー固まりの検知を含む) |
BALAN-linux-x64.tar.gz |
Linux x64(.NET 不要) | 実機で動作確認済み(v0.3 まで)。v0.4.0 の新機能は未テスト(下記) |
SHA-256:
e077629d0c4d03fdf8de4562eca5ec8b7695b0aa5308d29354b139e171388215 BALAN-win-x64.zip
7ffa31c7e5fc4c30b04fefe4b9a43b7e19eecdd21886b9e57fef98028efef871 BALAN-linux-x64.tar.gz
Linux 版について
Linux 版は、v0.3 までの機能(接続、スクロール、トレイなど)を、実機の Wii Balance Board で確認しました。
v0.4.0 で追加した、センサーが固まったときの検知と警告、電池の警告表示は、Linux では未テストです(Windows と共通のコードで、Windows の実機では確認済みです)。
注意: ボードが他の端末(Windows など)とペアリングされていると、接続できません。その場合は、先に相手側でペアリングを解除してください(KUNAI と同じ挙動です)。
動かない場合や不具合は、Issue で教えてください。Linux では、初回だけ権限の設定が必要です。
tar xzf BALAN-linux-x64.tar.gz && cd BALAN-linux-x64
sudo cp 99-balan.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo usermod -aG input "$USER" # ログインし直す
sudo modprobe uinput
./BALAN
使い方
- Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
- 足をボードに載せた状態(押さずに)で Calibrate
- Scroll Mode を選び(画面、またはトレイの右クリックメニュー)、足で操作する
起動オプション: --simulate --minimized --no-tray --no-autoconnect
詳細は docs/DESIGN.md を参照してください。