リリースノート¶
各リリースで何が変わったかを、新しい順に記録しています。ファームウェアは 書き込みツール から入れます。 動いている版はシステムメニューの About で確認できます。 Studio は常に最新のものが動きます。
書き込むとフラッシュの内容は /home も含めて置き換わります。残したいものは先に取り出して
おいてください (コンソール)。
開発中 (3.0.0 の後)¶
まだリリースには入っていません。開発中の版 (と、それから作っている Studio) の今の姿で、このサイトの各ページはこちらに合わせてあります。
変わったこと: アプリの書き方¶
3.0.0 向けに書いたアプリは、少し直す必要があります。
- ファイルの末尾に起動のコードを書きません。 ファイルが定義した
FmrbAppの子クラスを ランタイムが起動します。末尾のMyApp.new.start(とbegin/rescue) は消してください。 子クラスが 2 つ以上あるファイルは、記述にclass = "MyApp"と書いて起動するものを名指しします。 決まらないときや起動中の例外は、理由がエラーウィンドウに出ます。 → Hello World @gfxはアプリの描画領域の左上から描きます。 枠のあるウィンドウでは枠の内側、枠なしではウィンドウの左上、 全画面では画面の左上です。@user_area_x0と@user_area_y0は無くなったので、@user_area_x0 +の足し算を消してください。マウスのev[:x]/ev[:y]、スプライト、UI 部品も 同じ原点です。ウィンドウの座標が要るときはev[:wx]/ev[:wy]とwindow_gfxを使います。 → 描画- 本体を変えるメソッドは
FmrbSystemへ。 本体の設定を変える 34 個のクラスメソッド (reboot、set_wallclock、WiFi・BLE・電源・音量の設定など) はFmrbSystem.<名前>になりました。FmrbApp.<名前>には、アプリが読むものが残ります。 → アプリ clear_timeはclear_timerになりました。- 記述を
.rbの中に。.app.tomlのキーは、ファイル先頭の#---fmrbコメントにも書けます。 両方あるときは.app.tomlのキーが勝ちます。 → アプリ設定 - Lua のアプリは本体が用意するアプリシェルの上で動きます。
on_create/on_update/on_eventを 定義し、グローバルのgfxで描きます。 → ほかの言語 - Lua と MicroPython も Ruby の引数の順に。 Lua の
gfx:draw_textは(x, y, text, color)に なり、大きさは関数 (FmrbApp.user_area_width()・user_area_height()・window_width()・window_height()) になりました。MicroPython の_fmrb.read_fileと_fmrb.file_sizeはFmrbFileに替わり、gfx.clear()には色が要ります。 → ほかの言語
新しいこと¶
- 漢字変換。SD カードの辞書を使って、かな入力から変換します。 → デスクトップ
- 画面から WiFi。Network の画面から Wi-Fi のページを開き、ネットワークを選んでパスワードを 打ちます。5 つまで覚え、届く範囲でいちばん強いものにつなぎます。 → WiFi につなぐ
- ウィンドウメニュー。タイトルバーの右クリックで、送る・読み直し・閉じる。
- 枠なしのウィンドウ (
window_frame = "none") と、見本のアバター。 → アプリ設定 - Asterism の通信の決まり (wire protocol) 2 (asterism gem 0.14.0)。接続がオブジェクトになり、 トピックは型を宣言し、特定のオーナーを持たないデータは共有スペース (shared place) に置きます。3.0.0 とは通信の互換が ありません。 → ネットワーク
- 端末の間でファイルとアプリを送る (Asterism)。受け取るかどうか、誰から受け取るかは
「受け取り」アプリで決めます。Shell の
moveはamoveになり、asend・anodes・areceiveが 加わりました。 → Shell のコマンド - Linux 版: 画面全体の CRT 風の表示、電源メニューのログアウト、タッチパッドのタップと タッチパネル、TLS のルータへの接続、arm64 のパッケージ。 → Linux 版
- WebAssembly のアプリ。C・TinyGo・Rust・Zig で書いて WebAssembly にコンパイルしたアプリが、
ESP32-P4 の基板、Linux 版、シミュレータ、Studio の WAMR の上で、Ruby のアプリと同じ関数を使って
動きます (ESP32-S3 の基板では動きません)。SDK は
family-mruby-sdk です。各言語の同じ tour の
アプリが
/app/tinygo・/app/rust・/app/zig・/app/cに入り、Studio のページに投げ込んだ アプリもそこで動きます。 → WebAssembly のアプリ - 全部の言語に 1 つの定義。アプリが呼ぶ関数は、ファームウェアの型定義から Ruby・Lua・MicroPython・
WebAssembly のどれにも生成します。Lua には音、ログ、クリップボード、時計、ウィンドウの状態、
ファイルが加わり、MicroPython には
FmrbGfxの残り (円弧、get_pixel、マスク、blend_rectなど)、FmrbApp.uptime_ms()、64 ビットの整数が加わりました。 → ほかの言語 FmrbFile。パスでファイルを丸ごと読む・書く・追記する・一覧する・消す。どの言語でも同じです。 → ファイル・I/O- 起動の演出を一新。ブラウン管のテレビのようにロゴが出て、5 度上がる和音が鳴り、2.7 秒 かかっていたデスクトップまでが約 1.2 秒になりました。 → デスクトップ
- エラーウィンドウはクリックのほか
Return・Escでも閉じます。Monitor に WebAssembly の ランタイムのページ、Shell のpsに ENGINE の欄、ランチャーに言語ごとのアイコンが加わりました。 - ストレージを小さく。スプライト、タイルシート、壁紙、アイコンはパレットの PNG になり
(
SpriteImage#load_bmpとTileSheetは BMP に加えて PNG も読みます)、声は IMA-ADPCM の WAV に なりました (play_wavで鳴ります)。ESP32-P4 の基板では、日本語フォントを専用のパーティションに 移しました。 → 画像・アイコンファイル、 音声、ハードウェア /homeを WiFi で。ファイルのエンドポイントが鍵も含めてすべてのパスを扱うので、書き込みの前に/homeを退避し、あとで戻せます。 → 遠隔画面、 セキュリティ/app/testと「歩いて進む」は、どの基板のイメージにも公開のブラウザ版にも入れないようにしました。 WiFi で基板に送れます。
3.0.0 — 2026-11-07¶
Modern、Retro、画面の無い小型機、Linux 版、Studio が対象です。
新しいこと¶
- Linux 版。Linux のパソコンで 1 つのプログラムとして動く Family mruby です。GitHub の
リリースに amd64 の
.deb(Ubuntu 26.04 以降) があり、ログイン画面で選びます。 → Linux 版 - 画面の無い小型機。M5Stack StickS3 と AtomS3R が、Asterism のネットワーク上で 1 つのアプリを 動かします。Web Installer から書き込めます。
- 動いているアプリを運ぶ。
movable = trueを宣言したアプリは、イメージに書いて、同じ端末でも 別の端末でも続きから動かせます。 → アプリ - Asterism。同じネットワークの端末どうしが Ruby のオブジェクトを呼び合います。ゲームのホストを使う卓の アプリとして、ヒデ雀 (麻雀)・オセロ・お絵かきが入りました。 → 標準アプリ
- 全画面の高解像度。
fullscreen_hires = trueのアプリは、Modern とスタジオで全画面の間だけ 640x360 で動きます。 - 消音と音量。メニューバーのスピーカーを押すと本体全体が消音になり、Config に 0〜10 の 音量があります。どちらも覚えておきます。全機種と Studio で同じです。 → デスクトップ
- デスクトップのアイコン。Launcher、Editor、Shell、File Manager といくつかのアプリが壁紙に 並びます。ランチャーの右クリックのメニューで置いたり外したりできます。 → デスクトップ
- 電源ボタンがメニューバーの右端に付きました。Reset はシステムメニューからここへ移りました。
- BLE設定受付。本体で開く数分間だけ、Web コンソールが WiFi・Asterism の設定とキーを
読み書きできます。それ以外のときにリモートから読まれることはありません。読み上げサービスの
API キーは、サービスの一覧から
/home/secrets.tomlへ移りました。 → システムサービス - エディタのフォント。View → Font で 8・12・16 ピクセルから選べ、
/home/editor.tomlに 残ります。 - クリップボードを 1 つに。全アプリで共有し、Linux 版では PC の、Studio ではページの
クリップボードとつながります。
FmrbApp.clipboard/FmrbApp.set_clipboard。 - アプリの画面向けの小さな道具。
@gfxのfit_text・wrap_text・draw_text_lines・draw_buttonと、画面をまるごと描くときのFmrbUI::HitAreas。 → 描画、UI 部品 - アプリの設定と状態。
app_settings(/home) とapp_state(/tmp)。File Manager は閉じたときの フォルダで開き直します。 → アプリ FmrbAudio#main_volume=で曲だけの音量を変えられます。 → 音声- 大きさを変えられるウィンドウには、右下の角につかむための三角が出ます。File Manager は 削除の前に確認します。
- ランチャーの探し直しは、タイトルバーの 再読込 ボタン (か
F5) になりました。
変わったこと¶
- ESP32-S3 の端末のアプリのメモリ。プールは全部で 3 つ (通常 1 つと大きい方 2 つ) で、 同時に動くユーザアプリは 3 つまでです。 → 制約事項
- WiFi の設定は
/home/wifi.tomlを先に、無ければ/etc/wifi.tomlを読みます。 - 実機の HTTPS は、全部入りの証明書の束ではなく、絞ったルート証明書の組を信頼します。
更新するとき¶
core と graphics-audio のファームウェアは同じ版でなければなりません。Retro では両方のチップに 書き込んでください。開発版の漢字変換で使う辞書は 3.0.0 には含まれていません。
2.1.0 — 2026-09-09¶
対象: Modern、Retro、シミュレータ、Studio。
新しくできること¶
- Family mruby スタジオ。 ファームウェアを WebAssembly にして公開しました。デスクトップ もエディタも音源も、何も入れずにブラウザのタブで動きます。 → Studio
- アプリの店。 ランチャーの先頭に並びます。公開されている一覧を WiFi で取ってきて、
本体に載るものを示し、
/app/usrに入れます。実機 2 種とブラウザのどれでも動きます。 - 本体が自分でやること (Modern)。 小さな常駐サービスが動きます。時計はネットワークから 自分を合わせ、本体は自分のアドレスを知らせ、頼めば喋ります。一覧は書き換えられるファイル です。→ システムサービス
- 色を変えられる。 ウィンドウ枠・デスクトップ・エディタ・シェルが、どれもシステムのテーマから色を
とります。どの色も
/home/colors.tomlに名前で書いて上書きできます。シェルのcolorコマンドが代わりに書いてくれます。→ 配色 - どのアプリが何を開くかを 1 枚の表で決める。
.mdは資料として開き、.nsfは音楽 プレーヤーで開き、.rbは動きます。→ ファイルの関連付け - 新しいアプリ。 PicoRabbit は Markdown で書いた資料を発表します。Robo Explorer は ロボットの頭脳を書かないと解けない迷路です。Modern には動画再生・マイクの音を見るアプリ・ 6 軸センサの表示が加わりました。→ 標準アプリ
- エディタの日本語。
Ctrl+Spaceでかな入力、漢字の表示、そして全画面のエディタ。 - 全メソッドのヘルプ。 エディタの
F1が 577 個すべてに答えます (2 段構え)。 - UI 部品。 ボタン、一覧、チェックボックスなどをアプリから使えます。 → UI 部品
FmrbNet.request。 アプリを止めずに取ってきます。実機でもブラウザでも同じ書き方です。 → ネットワーク- マウスのホイール。 エディタ・シェル・ログ・ファイル選択が送れます。
- WiFi 越しのファイルとアプリが Retro でも。
/fsと/appは 2 機種とも答えます。 Modern だけのものは画面です。→ 遠隔画面 - 実機が自分で名乗る。 MAC から作った
fmruby-XXXXXX.localです。fmruby.localにも 引き続き答えます。→ WiFi につなぐ boot_splashとstartup_app。 起動時のロゴと音をとばす、あるいはデスクトップが出たら すぐ 1 つのアプリを開く。→ デスクトップ- WAV の再生 (Modern)。
play_wavが音源の上にファイルを重ねて鳴らします。 /homeはあなたのもの。 サンプル・スプライト・音・資料は/usr/shareに移り、/homeは空の状態で出荷します。→ ファイル・I/O
変わったこと¶
on_eventでsuper(ev)を呼ぶ必要がなくなりました。基底クラスは自分の状態を@_付きの 名前に持ち、@running/@nameはrunning?/nameで読みます。2.0 向けに書いたアプリは そのまま動きます (古いsuper(ev)は空のメソッドに届くだけです)。 → FmrbApp- テーマの見本は
light/dark/cyberpunkになりました。classicは無くなり、それが 指していた配色がlightです。 - 落ちものパズルのサンプルは BlockGame になりました。変わったのは名前だけです。
flappy.rbは、他のアプリと同じflappy.app.rbになりました。- Studio はページ側で配色を選ばなくなりました。本体の Config でテーマを選びます。
- Modern のアプリ用プールは 1024 KB、
large_memory = 1で 2048 KB になりました。Retro は 変わりません。→ 制約事項 app_spawn_margin_kbで、アプリを起動するときにシステム側へ残す内蔵 RAM を決められます。 → システム設定
更新するときは¶
Retro は 2 つのチップとも書き込んでください
2 つのチップの間の通信仕様が 4 から 5 に変わり、検査は厳密です。2.0.x の
fmruby-graphics-audio と 2.1.0 の fmruby-core の組み合わせでは起動しません。
書き込みツール から両方を
書き込んでください。→ ファームウェアの更新
Modern は 1 チップ構成なので、Tab5 のファームウェアだけで済みます。
2.0.1 — 2026-08-08¶
保守のためのリリースです。開発機が残したキャッシュがフラッシュの中身に混ざらなくなり、
[[launcher_exclude]] でアプリの分類ごとランチャーから隠せるようになり、Retro の壁紙が
シミュレータと同じように WROVER へ届くようになりました。
通信仕様は 2.0.0 と同じ 4 なので、2.0.0 の実機には片方のチップだけの書き込みで足ります。
2.0.0 — 2026-08-07¶
2 つ目の機種が加わったリリースです。
新しくできること¶
- Modern (ESP32-P4)。 市販の M5Stack Tab5 をブラウザから書き込んで使います。内蔵の液晶、 スピーカー、タッチ、WiFi がそのまま使えます。→ Modern
- 遠隔画面。 Tab5 が自分の画面を WiFi で配信し、同じネットワークのブラウザからパソコンの キーボードとマウスで操作できます。→ 遠隔画面
- FMRuby BASIC。 Family BASIC 互換の言語です。専用のテキスト画面、スプライト、音を 持ちます。→ MicroPython と BASIC
- MicroPython。
.pyのファイルが普通のアプリとして動きます。 - MIDI。 Tab5 の GROVE 端子からのシリアル MIDI 出力、Ruby からの MML、標準 MIDI ファイルの 再生。→ MIDI
- 実機の上のデバッガ。 エディタからブレークポイントと変数を見られます。同じものを パソコンから BLE や TCP 経由でも使えます。→ デバッグ
Ctrl+Tab。 動いているアプリを切り替え、全画面のアプリはその場に退避します。 → デスクトップ- アプリごとのスタック。
.app.tomlのtask_stack_kbで、既定より多く要るアプリに 割り当てられます。→ アプリの設定 - カーネルとデスクトップの標準エンジンが Spinel (事前コンパイル) になり、起動時の走査が 13 秒から 7.8 秒になりました。
- ファイルの置き方が今の形になりました (
/app、/usr/share、/etc、/var。/dataは 廃止)。 - Tab5 のタッチで、2 本指のタップが右クリックになりました。
更新するときは¶
Retro は 2 つのチップとも書き込んでください。通信仕様が 3 から 4 に変わっています。
1.0.0 — 2026-05-19¶
最初のリリースです。Retro (narya-board) で、デスクトップ、ランチャー、エディタ、シェル、 タイルマップ、角の丸いウィンドウが動きます。パソコン側のブラウザで動くスプライトエディタと マップエディタも付いています。