Skip to content

epic(studuino): スモウルボットS1 の拡張機能を Studuino としてリニューアルし、練習用の基板を入れる #2162

Open
9 of 10 issues completed

Description

@smalruby3-editor-bot

なにをするか

拡張機能「スモウルボットS1」を Studuino(アーテック)の拡張機能としてリニューアルし、あわせて 実機が無くても動かせる「練習用の基板」(ソフトウェアの基板)を入れる。

中学 3 年「計測・制御」のコース(#2158)は、この EPIC のあとに Studuino を使って作る。

なぜ

  • スモウルボットは知名度が低い。Studuino で計測・制御の授業ができると、先生に伝わるようにしたい。
  • 教科書は「センサー」「仕事を行う部分」などの一般的な言葉で書かれているが、いまのブロックは「右のセンサー」のようにロボットの部品の名前になっている。
  • 基板がつながっていないと、センサーの値は 0 のままで、LED・モーター・サーボの命令は何もしない。そのため、レッスンの「できた」の判定ができない。2 人で 1 台・自宅・欠席の補習でも進められるようにしたい。

決まっていること(人間の指示・2026-11-18)

  • 今のブロックはそのまま使う(互換を保つ)。表示は「右のセンサー」ではなく、教科書などの一般的な書き方に合わせたセンサー名にする。
  • 新しいブロックを足すことと、既存のブロックのドロップダウンの選択肢を増やすことで、Studuino の部品を一般的な名前で扱えるようにする。
  • 教科書の例にある部品(超音波センサーなど)が Studuino に無いのは、しょうがない。
  • 練習用の基板(設計ページ Q5 = A):
    • 基板の見た目は重要ではない。
    • 各センサーの値(変えられる)・サーボのいまの角度・モーターの正転/逆転/停止がわかる程度でよい。
    • 実機がつながっていないときは、ブロックの命令がこの基板に届き、センサーのブロックはこの基板の値を返す。
  • 判定に使う「命令とセンサーの値の記録」をどうするかは、feat(lessons): 中学 3 年「計測・制御」のコース(ワークシート・教科書連動) #2158 の設計ページの Q6 で決める(実機でも練習用の基板でも、同じ記録で判定する案)。

決まったこと(設計の相談・2026-11-19)

設計のページ https://claude.ai/artifact/RGmK1RHWRRu1whrgmmeNGN の人間の答え(2026-11-19 0 時)。

  • E1 = A 互換: 同じ拡張機能のまま、名前を「Studuino」にする。中の ID(smalrubotS1)・opcode・Ruby の書き方(メソッド)は変えない。前の作品はそのまま開ける。
  • E2 = A 名前と絵: 名前は「Studuino(スタディーノ)」。絵は自分たちで描いた基板の絵(アーテック社の写真やロゴは使わない)。アーテック社に一言伝える(人間の作業)。
    • 人間が Gemini で描いた画像(tmp/to-ai-files/Gemini_Generated_Image_23a33523a33523a3.jpeg・人間の手元。リポジトリにはまだ入れない)をベースにしてライブラリの絵を作る。
  • E3 = A ポート: いまの決まった配置(S1 の配置: A0/A1 LED、A2 タッチ、A4/A5 赤外線(フォトリフレクタ)、A6 光、A7 音、M1/M2 DC モーター、D10 サーボ)のまま。名前だけ一般的にする。既存のブロックは挿すポートが部品ごとに固定なので、それに従う。
  • E4 = A センサー名: 教科書の一般的な名前を先に、部品名をかっこで:「光センサー (A6)」「赤外線センサー(フォトリフレクタ)(A4)」「タッチセンサー (A2)」「音センサー (A7)」。
  • E5 ブロックと選択肢: 新しく増やすのは基本的に Studuino モード用のブロック。通常モードにはできる限りブロックを追加しない。選択肢だけ増やして、「左のセンサー」もあるし「赤外線センサー(フォトリフレクタ)(A4)」もある、というようにする。
  • E6 = A ロボットカー: ロボットのブロック(前進させる・アームを曲げる等)は残したまま、パレットの後ろの方に「ロボットカー」の見出しをつけてまとめる。名前は「車を前進させる」など一般的に。通常モードではブロックを追加せずに、極力互換性を保つ。
  • E7 = A 練習用の基板の形: ステージの下(または横)に、たためるパネル。値は数字と簡単な印、センサーはスライダーとボタン。
  • E8 = A 切りかえ: 実機がつながっていなければ自動で練習用の基板。つながったら実機(パネルに「いまは練習用の基板」と出す)。
  • E9 = C Ruby: 書き出しは全部 studuino. に、読みこみは smalrubot_s1. も受けつける。
  • feat(lessons): 中学 3 年「計測・制御」のコース(ワークシート・教科書連動) #2158 の設計から: 判定のため、拡張機能が出した命令(LED・モーター・サーボの角度)と読んだセンサーの値を記録し、実機でも練習用の基板でも同じ事実で判定する(Q6 = A)。手元にセンサーが無いときは代わりのセンサーでも「できた」(Q7)。練習用の基板の見た目は重要でなく、各センサーの値・サーボのいまの角度・モーターの正転/逆転/停止がわかる程度でよい(Q5)。
  • 順番(人間の指示): まず拡張機能のちょっとした修正(名前・選択肢・見出し・Ruby)と練習用の基板を実装する。Studuino モード(epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163)は設計だけ進め、実装はそのあと。

まだ決めること(設計で詰める)→ 上の「決まったこと(2026-11-19)」で決まった

  • 拡張機能の名前と、ライブラリでの見せ方(「Studuino」の名前や画像を使ってよい範囲。商標・画像の扱いを確かめる)。
  • ポートとセンサー・部品の対応(例: A2 タッチ・A4/A5 反射・A6 光・A7 音、M1/M2 の DC モーター、D9〜D12 のサーボ、LED)を、どこまでブロックで選べるようにするか。
  • 既存の作品(Smalrubot S1 のブロックを使った sb3・Ruby)との互換の保ち方。opcode と Ruby の書き方は変えず、表示だけを変える方針でよいか。
  • 練習用の基板を、ステージの横のパネルにするか、ポップアップにするか。

参考

  • いまの拡張機能: packages/scratch-vm/src/extensions/scratch3_smalrubot_s1/、docs は docs/extension-smalrubot-s1/README.md。
  • 練習用の基板の考え方は、チャットのコースの「練習相手」(ブラウザの中で折り返すにせのメッシュの相手)と同じ。
  • 計測・制御のワークシート(全国共通・10 時間): notes/education/units/d3-keisoku-seigyo-10h/(リポジトリの外)。

関係

設計のページ

https://claude.ai/artifact/RGmK1RHWRRu1whrgmmeNGN (#2162 と #2163 をいっしょに相談する。答えはページの db に保存)

進め方

  1. 設計(ブロックとセンサー名の一覧・互換の方針・練習用の基板の形)を artifact で人間と詰める。
  2. sub-issue に分ける(docs → 名前とブロックの追加 → 練習用の基板 → 命令とセンサーの値の記録)。

sub-issue(2026-11-19 に分けた)

実装の順番の目安(依存は各 Issue の本文に書いた):

  1. docs(studuino): Studuino リニューアルの方針(名前・選択肢・ロボットカー・Ruby・練習用の基板・記録)を docs に書く #2187 docs: Studuino リニューアルの方針
  2. feat(studuino): 拡張機能の名前を「Studuino(スタディーノ)」にし、ライブラリの絵を自作の基板の絵にする #2188 名前「Studuino(スタディーノ)」とライブラリの絵(Gemini の画像をベースにした自作の基板の絵)
  3. feat(studuino): センサー名を教科書の名前にして選択肢を足し、ロボットのブロックを「ロボットカー」の見出しにまとめる #2189 センサー名の選択肢を足す(E4・E5)と「ロボットカー」の見出し(E6)
  4. feat(ruby): Studuino の Ruby を studuino. で書き出し、smalrubot_s1. も読みこむ #2190 Ruby の studuino. 書き出しと smalrubot_s1. 読みこみ(E9。feat(studuino): センサー名を教科書の名前にして選択肢を足し、ロボットのブロックを「ロボットカー」の見出しにまとめる #2189 のあと)
  5. feat(studuino): 実機がつながっていないとき、命令とセンサーを練習用の基板(VM)に切りかえる #2191 練習用の基板(VM の中の仮の基板と自動切りかえ・E8。feat(studuino): センサー名を教科書の名前にして選択肢を足し、ロボットのブロックを「ロボットカー」の見出しにまとめる #2189 のあと)
  6. feat(studuino): 練習用の基板のパネル(たためる・センサーのスライダーとボタン・LED/モーター/サーボの状態) #2192 練習用の基板のパネル(E7。feat(studuino): 実機がつながっていないとき、命令とセンサーを練習用の基板(VM)に切りかえる #2191 のあと)
  7. feat(studuino): 拡張機能が出した命令と読んだセンサーの値を記録する(レッスンの判定用) #2193 命令とセンサーの値の記録(レッスンの判定用・feat(lessons): 中学 3 年「計測・制御」のコース(ワークシート・教科書連動) #2158 Q6。feat(studuino): 実機がつながっていないとき、命令とセンサーを練習用の基板(VM)に切りかえる #2191 のあと、feat(studuino): 練習用の基板のパネル(たためる・センサーのスライダーとボタン・LED/モーター/サーボの状態) #2192 と並行可)

#2188 と #2189 は #2187 のあと並行してよい(どちらも locale と拡張機能の index.js を触るので、マージのときのぶつかりに注意)。

Activity

  1. smalruby3-editor-bot commented on Nov 18, 2026

    @smalruby3-editor-bot
    Author

    人間から(2026-11-19。#2211 にも同じ内容):

    • アーテック社に聞くことは、いつか確認する。それを待たずに作ってしまってよい。
    • アーテック社の担当者のスタンス: 広めてくれるなら使ってよい。ただし、悪いことに使ったり、Studuino を自分のもののように使ったりするのは NG。アーテック社のものであることがわかるようにすれば OK。
    • 商標の表記(アーテック社の表記): 「ロボット製作に特化した Arduino 互換基板 Studuino®(スタディーノ)」。スモウルビーで名前を出すところでは、Studuino が株式会社アーテックの登録商標であり、アーテック社の製品であることがわかるようにする(例: 「Studuino®(スタディーノ)は株式会社アーテックの登録商標です」)。
    • arduino-cli のボード設定: 人間の手元に Arduino IDE 用の設定がある(arduino_ide_settings_ver17x.zip、arduino_ide_settings_ver16x_18x.zip。リポジトリには入れない)。feat(infra): Studuino の hex を作る Lambda の土台(arduino-cli+ライブラリのコンテナ・API Gateway・Origin 制限・上限・計測) #2209(Lambda)でこれを読んで、arduino-cli の FQBN・ボード定義を決める。
    • 残りの質問(表記のないファイルのライセンス、サーバーでのコンパイルと hex の提供、公式の配布元)は、topic topic/studuino-2163 を作ったときに、確認用のページでまとめて人間に見せる。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions