Family mruby コンソール¶
PCのブラウザから Bluetooth Low Energy (BLE) 経由で基板内のファイルを読み書きするツールです。
Web ブラウザから操作できます。
必要なもの¶
- BLE通信できるPC
- Web Bluetooth 対応ブラウザ ( Chrome / Edge )(Firefox / Safari は不可)
クライアントの起動¶
ブラウザで以下を開きます。
https://family-mruby.github.io/console/
接続手順¶
- 基板の電源を入れて起動完了を待つ(数秒)
- ブラウザでクライアントを開く
- 画面の 「Connect」ボタン をクリック
- ブラウザの BLE デバイス選択ダイアログから 「Family-mruby-XXXXXX」 を選択
- 「ペア設定」ボタンを押す(OS によっては「接続」と表示)

Windows でうまく繋がらない場合
Windows の Bluetooth スタックは古いペアリング情報を保持して接続を妨げる場合があります。OS の Bluetooth 設定で 既存の Family-mruby-* を削除 してから再接続を試してください(本機はペアリングを保持しないため)。
ファイルのアップロード(PC → 基板)¶

- クライアントで配置先ディレクトリへ移動
- PC のエクスプローラからファイルをブラウザにドラッグ&ドロップ
- 完了を待つ
ファイルのダウンロード(基板 → PC)¶
- クライアントでファイルを表示
- ダウンロードアイコンをクリック
- PC の標準のファイル保存ダイアログで保存先を指定
アップロード後の反映¶
アプリファイル (.app.rb / .app.toml) を /app/<dir>/ にアップロードしただけでは、ランチャーには即座には現れません。次のいずれかで反映できます:
- ランチャーを開いて右クリック — タイトルバーが「Rescanning...」になり、1〜2 秒で新アプリが表示される
- 本体を再起動 — 起動時のスキャンで自動的に乗る
詳細は Hello World ▸ ランチャーで反映する を参照。
注意事項¶
大きいファイル¶
通信速度はあまり早くないため、大きなファイルは転送に時間がかかります。
同時接続¶
同時に接続できるクライアントは 1 台です。別のブラウザで接続する場合は先に切断してください。
トラブル¶
デバイスが見つからない¶
- 基板の電源が入っているか
- 基板を再起動して数秒待つ
- OS 側で別のブラウザ・タブが繋がっていないか
Connect が動かない¶
- Chrome / Edge を使っているか(Firefox / Safari は未対応)
- HTTPS または
localhostでクライアントを開いているか
関連¶
- 自作アプリの転送先: Hello World
- ファイルシステム構造: ファイル・I/O