Family mruby コンソール¶

BLE で実機につながるブラウザのクライアントです。ファイル、ログの実時間表示、スプライトと地図の編集、デバッグ用の操作ができます。入れるものはありません。

必要なもの¶

BLE通信できるPC
Web Bluetooth 対応ブラウザ ( Chrome / Edge )（Firefox / Safari は不可）

クライアントの起動¶

ブラウザで以下を開きます。

https://family-mruby.github.io/console/

接続手順¶

基板の電源を入れて起動完了を待つ（数秒）
ブラウザでクライアントを開く
画面の「Connect」ボタンをクリック
ブラウザの BLE デバイス選択ダイアログから「Family-mruby-XXXXXX」を選択
「ペア設定」ボタンを押す（OS によっては「接続」と表示）

コンソール接続

BLE は電波の届く範囲の誰にでも開いています

この機械はペアリングも暗号化も行いません。そのおかげで Windows の Web Bluetooth が素直に繋がるのですが、同時に、繋いでくる相手に何も求めないということでもあります。電波の届く範囲でブラウザを開いた人は誰でも、ボード上のファイルを読み書きし、ログを読み、アプリを起動したり止めたりできます。Retro なら Config の ble_auto_start を off にして起動時に立ち上げないようにできますが、Modern の BLE は常に起動し、動作中に止める手段はありません。セキュリティも参照してください。

Windows でうまく繋がらない場合

Windows の Bluetooth スタックは古いペアリング情報を保持して接続を妨げる場合があります。OS の Bluetooth 設定で既存の Family-mruby-* を削除してから再接続を試してください（本機はペアリングを保持しないため）。

ファイルのアップロード（PC → 基板）¶

コンソール接続

クライアントで配置先ディレクトリへ移動
PC のエクスプローラからファイルをブラウザにドラッグ&ドロップ
完了を待つ

ファイルのダウンロード（基板 → PC）¶

クライアントでファイルを表示
ダウンロードアイコンをクリック
PC の標準のファイル保存ダイアログで保存先を指定

アップロード後の反映¶

アプリファイル (.app.rb / .app.toml) を /app/<dir>/ にアップロードしただけでは、ランチャーには即座には現れません。次のいずれかで反映できます:

ランチャーを開いて右クリック — タイトルバーが「Rescanning...」になり、1〜2 秒で新アプリが表示される
本体を再起動 — 起動時のスキャンで自動的に乗る

詳細は Hello World ▸ ランチャーで反映するを参照。

クライアントでできること¶

上部に 5 つのタブがあります。

タブ	用途
Files	フラッシュの中を見る。ドラッグして送る、取り出す、名前を変える、ファイルやフォルダを作る・消す
Logs	実機のログを流しながら表示。部分一致で絞り込めます
Sprite	RGB332 のスプライト表をブラウザで編集して書き戻す
Map	タイル地図を編集する
Debug	動いているアプリの一覧 (`ps`)、終了、場所を指定しての起動、生のデバッグコマンド送信

Debug タブは遠隔デバッガと同じデバッグ用サービスにつながっています。反応しなくなったアプリを落とすだけなら、停止点も接続も要らないこちらが一番速いです。

動いているアプリが並んだ Debug タブ

両機種で使えます¶

Retro だけでなく Modern でも動きます。Modern では BLE を ESP32-C6 が担当します。

違うのは、同時に何が動かせるかです。Modern の C6 は BLE と WiFi を一緒に受け持つので、コンソールと遠隔画面を同時に使えます。Retro の ESP32-S3 は無線が 1 系統なので、BLE と WiFi はどちらか一方です。WiFi につなぐを参照してください。

そもそもブラウザの一覧に出てこない場合は、BLE が動いていない可能性があります。Config の ble_auto_start を確認するか、システムメニューから手で起動してください (手動起動は Retro のみ。Modern の BLE は常に起動します)。

注意事項¶

大きいファイル¶

通信速度はあまり早くないため、大きなファイルは転送に時間がかかります。

同時接続¶

同時に接続できるクライアントは 1 台です。別のブラウザで接続する場合は先に切断してください。