Skip to content

BALAN v0.4.0

Choose a tag to compare

@taoman26 taoman26 released this 11 Nov 07:48
· 2 commits to main since this release
308f49a

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

使い方

  1. Connect を押し、ボードの赤い SYNC ボタン(電池ボックス内)を押す
  2. 足をボードに載せた状態(押さずに)で Calibrate
  3. Scroll Mode を選び(画面、またはトレイの右クリックメニュー)、足で操作する

起動オプション: --simulate --minimized --no-tray --no-autoconnect

詳細は docs/DESIGN.md を参照してください。