Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 17 additions & 6 deletions docs/studuino-mode/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
> **🆕 Smalruby 独自** — upstream に存在しない、Smalruby のために新規追加された機能

- **Smalruby ランタイム対応**: ❌(smalruby3 gem では動かない。プログラムを hex にして Studuino に書きこむ、ブラウザ専用の機能)
- **デフォルト表示**: —(拡張機能ではなく「モード」。Studuino の拡張機能のメニューから入る)
- **デフォルト表示**: —(拡張機能ではなく「動かし方」。アーテックロボ(Studuino)の拡張機能の中で選ぶ)

> **🚧 このページはすべて設計(これから作る)**。まだ実装していない。このあとの sub-issue
> (🧱 infra の Lambda と GUI)は、このページを正として実装する。実装して形が変わったら、
Expand Down Expand Up @@ -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.`(ふりがなは「アーテックロボ」)。

### ねらい

- 計測・制御のシステムは、パソコンから離れて動くのがふつう。単体で動かせると、問題解決の作品
Expand Down Expand Up @@ -72,9 +84,9 @@ Studuino の拡張機能そのもの(通常モード。パソコンにつな

### モード切替の条件と確認のダイアログ(M6・S11)

- **使えないブロックがあると、モードを変えられない**(通常 → Studuino も、Studuino → 通常も)。
- 通常 → Studuino: 通常のブロック(見た目など)が残っていると切り替えられない。
- Studuino → 通常: Studuino モード専用の部品のブロックは、通常モードには無いので切り替えられない。
- **使えないブロックがあると、Studuino モードに変えられない**(通常 → Studuino)。
- 通常のブロック(見た目など)が残っていると切り替えられない。
- Studuino → 通常は、ブロックが 1 組なので、書きこまないと動かないブロックを使っていなければそのまま切り替わる。
- 切り替えを選んだとき、使えないブロックがあれば次のダイアログを出す:
- 本文:「使えないブロックが n 個あるので切り替えられません」
- ボタン: [ブロックを見る][すべて消して切り替える][やめる]
Expand Down Expand Up @@ -579,8 +591,7 @@ prod に出す前に回答を待つ必要は無い。

## 人間・実装で決めること

- `extensionStorage` のキーと、部品のブロックをどの拡張機能に置くか(Studuino の拡張機能 `smalrubotS1` に
Studuino モード専用の opcode を足すか、別の拡張機能にするか)。#2212・#2216。
- `extensionStorage` のキーの名前。部品のブロックは `smalrubotS1` に足す(M1・M4 で決まった)。#2212・#2216。
- 補正値を入出力の設定のどこで変えるか。#2215。
- タッチセンサーを真偽のブロックにするか(本家は丸い値のブロック)。#2216。

Expand Down