Skip to content

feat(studuino-mode): Studuino に書きこむ体験(旗=書きこみ・停止=中断・ファームウェアに戻す) #2219

Open

Description

@smalruby3-editor-bot

なにをするか

Studuino に書きこむ体験を作る。1 つのボタン(とステージの緑の旗)で「検査 → hex を作る(Lambda)→ 書きこむ(Web Serial の STK500v1)」を進め、終わったら案内を出す。書きこんだあと通常モードでつないだら、ファームウェアに戻す道も作る。

進め方の約束

決まったこと(#2163 の本文が正)

  • S13 = A +コメント: 1 つのボタン → 1 つのモーダルで進み具合を出し、終わったら「USB を抜いて電池をつなぐと動きます」。書きこむ前に旗の数(M4)と使えないブロック(M6)を検査。Studuino モードでは緑の旗=書きこみ、停止=書きこみの中断として扱う。
  • 書きこみはいまの仕組み(packages/scratch-gui/src/lib/smalrubot-firmware-flasher.js)を使う。
  • M7 = A: 通常モードでつないだとき、ファームウェアでないと分かったら「パソコンから操作するためのプログラムを書きもどしますか」と出して、ボタン 1 つで書きもどす(いまのファームウェアの hex を使う)。
  • S9 = A: C++ は見せない。ただし Studuino ライブラリは GPL なので、書きこみのモーダルに「使っているライブラリとライセンス(ソースの入手方法)」を出す。生成した C++ を保存できるようにするかは、アーテック社の回答(chore(studuino-mode): 【人間の作業】Studuino ライブラリのライセンスと使い方をアーテック社に確認する #2211)と docs で決めたとおり(epic(studuino): Studuino モード(プログラムを hex にして Studuino 単体で動かす) #2163 の「S7 ライブラリのライセンスの確認」の注意 1)。
  • Lambda の URL は環境変数(webpack の DefinePlugin)。足すなら .github/workflows/ci-cd.yml の 2 つのビルド(本番・preview)にも(.claude/rules/env-file.md。workflow は Bot の権限外なので人間の作業として書き出す)。
  • Lambda のエラー(上限・拒否・コンパイル失敗)を子どもにわかる言葉で出す。

テスト

  • 進み具合の状態は reducer / 純粋関数で単体テスト。モーダルは integration テスト(Lambda と Web Serial はモック)。関係するファイルだけ。
  • 実機での確かめ(書きこんで USB を抜き、電池で動く)は人間(DoD の引き継ぎ)。

DoD

  • 実機で、書きこんだプログラムが単体で動く。旗=書きこみ・停止=中断が効く。通常モードに戻ってファームウェアを書きもどせる。docs とスクリーンショット。

親 EPIC: #2163 。

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