From 24b817e3b122b36d4816366711ae67fa1a4c5788 Mon Sep 17 00:00:00 2001 From: "smalruby3-editor-bot[bot]" <297607354+smalruby3-editor-bot[bot]@users.noreply.github.com> Date: Thu, 19 Nov 2026 11:49:16 +0000 Subject: [PATCH] docs(studuino-mode): keep one extension and choose how to run it Reflect M1-M4 of the review: the Studuino mode is a way to run the ArtecRobo (Studuino) extension, not another extension. Blocks and the port settings are shared between the two ways. Co-Authored-By: Claude Opus 5.5 --- docs/studuino-mode/README.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/docs/studuino-mode/README.md b/docs/studuino-mode/README.md index ad1208bdba..eb47b6afa4 100644 --- a/docs/studuino-mode/README.md +++ b/docs/studuino-mode/README.md @@ -3,7 +3,7 @@ > **🆕 Smalruby 独自** — upstream に存在しない、Smalruby のために新規追加された機能 - **Smalruby ランタイム対応**: ❌(smalruby3 gem では動かない。プログラムを hex にして Studuino に書きこむ、ブラウザ専用の機能) -- **デフォルト表示**: —(拡張機能ではなく「モード」。Studuino の拡張機能のメニューから入る) +- **デフォルト表示**: —(拡張機能ではなく「動かし方」。アーテックロボ(Studuino)の拡張機能の中で選ぶ) > **🚧 このページはすべて設計(これから作る)**。まだ実装していない。このあとの sub-issue > (🧱 infra の Lambda と GUI)は、このページを正として実装する。実装して形が変わったら、 @@ -35,6 +35,18 @@ Studuino <──(ブラウザ: Web Serial・STK500v1。いまのファームウ Studuino の拡張機能そのもの(通常モード。パソコンにつないで動かす)は [`docs/extension-smalrubot-s1/`](../extension-smalrubot-s1/) を参照。このページは Studuino モードだけを書く。 +### 拡張機能は 1 つ(M1〜M4) + +- 拡張機能は **アーテックロボ(Studuino)1 つ**(`smalrubotS1`)。Studuino モードを別の拡張機能にしない。 + 違いは **動かし方** だけで、「つないで動かす(通常モード)」と「Studuino に書きこむ(Studuino モード)」を + 拡張機能の中で選ぶ。 +- **ブロックは 1 組**。ポートを選べる部品のブロックは、どちらの動かし方でも使う(通常モードで動かすときに + ファームウェアのコマンドで足りるかは、部品のブロックの sub-issue で確かめる)。書きこまないと動かないものだけ、 + Studuino モードのときにパレットに出す。 +- **ポートの設定は 1 つ**(動かし方にかかわらず)。既定は教科書のロボットカーの配線。いまのブロック + (ポートが決まっているもの)もこの設定を使い、練習用の基板も同じ設定で表示する。 +- Ruby は `studuino.`(ふりがなは「アーテックロボ」)。 + ### ねらい - 計測・制御のシステムは、パソコンから離れて動くのがふつう。単体で動かせると、問題解決の作品 @@ -72,9 +84,9 @@ Studuino の拡張機能そのもの(通常モード。パソコンにつな ### モード切替の条件と確認のダイアログ(M6・S11) -- **使えないブロックがあると、モードを変えられない**(通常 → Studuino も、Studuino → 通常も)。 - - 通常 → Studuino: 通常のブロック(見た目など)が残っていると切り替えられない。 - - Studuino → 通常: Studuino モード専用の部品のブロックは、通常モードには無いので切り替えられない。 +- **使えないブロックがあると、Studuino モードに変えられない**(通常 → Studuino)。 + - 通常のブロック(見た目など)が残っていると切り替えられない。 + - Studuino → 通常は、ブロックが 1 組なので、書きこまないと動かないブロックを使っていなければそのまま切り替わる。 - 切り替えを選んだとき、使えないブロックがあれば次のダイアログを出す: - 本文:「使えないブロックが n 個あるので切り替えられません」 - ボタン: [ブロックを見る][すべて消して切り替える][やめる] @@ -579,8 +591,7 @@ prod に出す前に回答を待つ必要は無い。 ## 人間・実装で決めること -- `extensionStorage` のキーと、部品のブロックをどの拡張機能に置くか(Studuino の拡張機能 `smalrubotS1` に - Studuino モード専用の opcode を足すか、別の拡張機能にするか)。#2212・#2216。 +- `extensionStorage` のキーの名前。部品のブロックは `smalrubotS1` に足す(M1・M4 で決まった)。#2212・#2216。 - 補正値を入出力の設定のどこで変えるか。#2215。 - タッチセンサーを真偽のブロックにするか(本家は丸い値のブロック)。#2216。