UIAPduino WebHID Lab

UIAPduino（HID ProMicro CH32V003）をブラウザから動かすページ集です。 インストールもアカウントも要りません。Chrome か Edge で開くだけです。

🌐 サイト URL: https://tarosay.github.io/uiap-hid-web/

何ができるか

• ブロックでプログラムを作る — URB Block Lab はブロックをつなぐと Ruby になって、基板の中で動きます（EEPROM が要ります）
• Ruby で電子工作をする — URB Lab / URB EE Lab は Ruby の構文で書いて、 ブラウザでコンパイルして基板へ転送します。数百円から始められます
• C++ を書いて練習する — キーボード・マウス・経路探索・迷路・対戦アルゴリズムの練習ページ
• デバッグする — HID Console、HID-Serial Bridge、SD カードのファイル操作
• 使い方を調べる — Arduino IDE のセットアップから書き込みまでの手順

ブロックで動かす方法はもう一つあって、トップページから Xcratch + UIAPduino にも行けます（リポジトリ）。

ブラウザとマイコンは WebHID API でドライバなしに直接やり取りします。 GitHub Pages で公開しているので、インストールは要りません。

---

デバッグ / ユーティリティ

ページ	スケッチ例	状態
HID Console	HidPrint.ino	✅ 公開中
HID-Serial Bridge	HidMonitorTest.ino / HidBridgeTest.ino	✅ 公開中
HID 接続チェック	スケッチ不要	✅ 公開中

---

UIAPduino SD（SD カード連携）

ページ	スケッチ例	状態
SD Filemanager	WebHID_SD.ino	✅ 公開中
MIDI → MIDB Converter	MidbPlayer.ino	✅ 公開中

---

URB Lab（UIAPruby）— 数百円から始めるRuby電子工作

ページ	スケッチ例	状態
URB Lab	ブラウザ内で生成（コンポーネント選択式）	✅ 公開中
URB EE Lab	ブラウザ内で生成／ビルド済みファームを直接書き込み	✅ 公開中（24FC256 / CAT24M01WI で実機確認済み）
URB Block Lab	同梱ファーム 1 本（⚙ 準備 から書き込み）	✅ 公開中（CAT24M01WI / 24FC256 で実機確認済み）

Wakayama.rb コミュニティが開発した、Ruby 構文で UIAPduino を制御できる組み込み Ruby 環境です。 mruby のビルドでは rake が必要な mrbgems の取捨選択と統合を、URB Lab はすべてブラウザ内で行います。 PC に Ruby・クロスコンパイラ等のビルド環境を整える必要はありません。

• ブラウザ内の @ruby/prism WASM で Ruby コードを AST 解析
• 独自の軽量バイトコード URB1 形式（.urb）にコンパイル
• WebHID で SD カードへ直接転送
• UIAPduino 上の TinyVM がバイトコードを逐次実行
• main.urb という名前で SD に保存すると、電源投入時に自動実行
• 使う機能（コンポーネント ≒ mrbgems）を選ぶと、対応する TinyVM ファームの .ino をブラウザが生成。Arduino IDE で書き込むだけ
• Tm（絶対周期） — every_ms 100 do … end は「前回から 100ms」ではなく 開始からの絶対時刻で起こすので、何周回しても周期がずれません。Timer で 区間の実測（ms / µs）もできます。SD 版・EE 版の両方で使えます
• インストール不要・クラウド不要

URB EE Lab — 保存先を I2C EEPROM に替えた版

URB EE Lab は、SD カードの代わりに I2C EEPROM（24FC256 32KB / CAT24M01WI 128KB）にプログラムと $変数 を保存する版です。 CAT24M01WI は A1 の配線でスレーブアドレスを 0x50/0x51 と 0x52/0x53 のどちらにもできます （24FC256 と同じバスに載せるときは 0x52 側）。 SD カードを使わないぶん SPI が丸ごと空き、その上に載る機能が増えます。

• BASE が 3,360 B 小さい（UIAPrubyVm 12,504 B → UIAPrubyEeVm 9,144 B）。 コンポーネントに使える余地が約 1.9 倍になり、Q1 + Se + Np + Ec が同時に載る
• ビルド不要で始められる — ビルド済みファームをブラウザから直接書き込めます。 Arduino IDE もボードパッケージも要りません（後述）
• Np / Nr（NeoPixel） — SPI1 が空いたことで初めて可能になった。DIN はピン 8 固定
• Se（UART） — GPS 受信やマイコン間通信に使える。ピン 15/16
• Ev / Ec（EEPROM 変数） — SD 版の Ve / Sv に相当。ファイル操作が アドレス計算 1 回になり、数値変数は約半分（+1,512 B → +820 B）
• EEPROM 変数ビューア — ブラウザから $変数 の現在値を読み出せる（読み取り専用）。画面に出ている数値配列を CSV で保存できる（添字で揃えて縦に並べる）。 配列の「全部読む」は、途中で読み込みエラーが出ても読めた要素を残して止まった要素から読み直す。 同じ位置で 10 回続けて失敗したら止まり、もう一度押すと続きから読み足す
• ピン 3(SDA) / 4(SCL) は EEPROM が占有。SD 版で塞がっていた 6・7・8・9 は解放
• I2C スレーブは使用不可（自分のプログラムを読めなくなるため）

ビルド済みファームを直接書き込む

コンポーネントを選んで .ino を生成し Arduino IDE で書き込む道に加えて、 ビルド済みのファームをブラウザから流し込む道を用意しました。 rv003usb ブートローダ（1209:B803）へ WebHID で書き込みます。

選ぶもの	中身
サーボ版（既定）	Pw + Q1 Ad Se Np Us Rn Ec
ブザー版	Tn + Q1 Ad Se Np Us Rn Ec
自分で選ぶ	従来どおり。コンポーネントを選んで .ino をビルド

Tn（ブザー）と Pw（サーボ）は同じタイマーの分周器を共有するため同時に選べません。 選ぶのは「ブザーか、サーボか」だけで、ほかは全部入りです。

ファームはページに base64 で埋め込んであり、焼く前に**生成される .ino の SHA-256 を その場で計算して突き合わせます。**食い違えば書き込まずに止まるので、 「ページだけ新しくてファームが古い」状態で焼くことがありません。

✅ 24FC256（32KB）と CAT24M01WI（128KB）の両方で実機確認済みです （プログラム転送・自動実行・$変数 と配列の読み出し・ブラウザからのファーム書き込み・NeoPixel の動作）。 CAT24M01WI は 64KB 境界（0x10000）をまたぐ読み書きも確認しました。 ピン 6 の ADC / PWM も確認しました（PWM は URB Block Lab の基板で）。 電源を切ってからの永続と、Se のマイコン間通信はこれからです。

URB Block Lab — ブロックをつないで基板に書き込む

✅ CAT24M01WI（0x50/0x51）を載せた基板で実機確認済みです。 同じロットの 2 枚で、ギャラリーの「LED 点滅」「ボタンで LED ON」を書き込んで動くことを確かめました。 ✅ 24FC256（0x50）でも実機確認済みです（ブレッドボード。変数 7 個・記録・配列の読み書き・ 配列の上限 5,410 個・大きすぎる配列と範囲外の番号のエラー）。 24FC512 は見分ける仕組みだけ入れてあり、石が手元に無いので未確認です。

URB Block Lab は、 ブロックを組むと Ruby が出てきて、それが基板の中に入るページです。子ども向けの入口として作りました。

Scratch や Smalruby との最大の違いは、プログラムが PC ではなく基板の中で動くことです。 書き込んでしまえば USB を抜いてよく、電源さえあればそのまま動き続けます （micro:bit の「ダウンロード」・PicoRuby / Arduino の「書き込み」と同じ考え方）。 だからボタンの名前も「動かす」ではなく 「基板に書き込む」 にしてあります。

• ブロック → Ruby → URB1 → EEPROM。 後段は URB EE Lab と同じ経路 （docs/lib/urb/compiler.js と docs/lib/urb/eeprom.js を両ページで共有）
• Ruby タブは読み取り専用。 書き換えたくなったら「UIAPruby で編集する ↗」で URB EE Lab へ渡す
• サーボの角度は、数を打つほかに変数でも渡せます。「サーボ ピン ◯ を〈変数〉度にする」に rand で決めた数を入れれば、動くたびに違う角度へ振れます。 ただし「サーボの設定」で決めた幅は効きません（angle は 50Hz・500〜2400µs 固定）。 両方を置いたときは、Ruby の先頭に警告コメントが出ます
• I2C の部品を読み書きできます。「I2C をはじめる」「アドレス 〈0x48〉 の 〈0x00〉 番地を 〔変数〕 に 読む」「〜番地に 〔変数〕 を 書く」の 3 つ。アドレスと番地は 16 進（0x48）でも 10 進でも書けます。値は 0〜255 の普通の数として扱えるよう、読んだあとに ×256、 書く前に ÷256 を生成側で入れています（VM では I2C の値だけ Q16.8 ではなく生のバイトで 出入りするため）。0x50〜0x53 は基板の EEPROM が使っているので、指すと警告コメントが出ます
• いまできるのは「レジスタから 1 バイト」だけです。 Wiremin 自体は n バイトの読み書きも レジスタ番号なしの送受信も持っていますが、VM に命令が出ていません。そのため対象になるのは LM75 / TMP102 の温度（MSB がそのまま ℃）、MPU-6050 の加速度・角速度（上位バイト）、 PCA9685 のような書くだけの部品です
• 8×8 の NeoPixel に絵を出せます。（2 色の「8×8 に表示 ⬛」は 2026-09-19 に引き出しから外しました。 定義は残してあるので、このブロックで保存した作品はそのまま開けます。いま引き出しにあるのは 次の項目のパレット版です）「8×8 に表示 ⬛」のマスを押す（押したままなぞる）と、 micro:bit の「LED 画面に表示」と同じ感覚で絵が描けます。色は 2 つ選べて、 えがく色とうしろの色をそれぞれブロックに持たせます（うしろの色は黒＝消灯が既定）。 テープは 64 個を縦に折り返し（蛇行）でつないである前提で、0 番は左下、左の列は下から上、 次の列は上から下です（2026-10-07 に「0 番は右上・横に折り返し」から変えました） （画面の (x, y) → テープの番号は、x が偶数なら x*8 + (7 - y)、奇数なら x*8 + y）。 出る Ruby は「うしろの色で fill → えがいたマスだけ set」なので、 命令は 6 + 5 × えがいた数 バイトで済みます（全部えがいても 331 B）。 1 マスごとに show が走って絵が描かれていく様子が見えないよう、 np.auto = false で止めてから最後に 1 回だけ送ります。 このブロックを置くと LED は 64 個として組み立てます（「NeoPixel を ◯ 個使う」で それより少なく指定していたときは、Ruby の先頭に警告コメントが出ます）
• 色を 8 つ使って絵を描くブロックもあります。「8×8 に絵を表示」は、マスが色の番号だけを 覚えます（0〜7 を 64 文字）。色そのものはブロックに並んだ 8 つの色えらび（いろ）が持つので、 描いたあとに色を変えると絵の色も変わります。面を開くと、マスの右に大きな色の見本が 2 列 × 4 段で出るので、えらんでからマスを押します。 真っ白から描きはじめます。 0 番の色（既定は白）が何も描いていないところの色で、LED も白く光ります。 「絵を消してはじめから」（前の「全部消す」）は、絵を消して真っ白にし、ずらしも戻すボタンです。 色（本体の「いろ」と、えらんでいる色）はそのまま残します（同じ色で描きなおせるように）。 8 番目の色は 「けす」（既定は明るさ 0＝光らない）で、 黒ではなく ✕ の見た目にしてあります（LED では黒は出ないので）。明るさ 0 の色は、どの番号でも この見た目になります。面を開いている間は、ブロック本体の「いろ」とボタンは薄くなって押せません。 絵を動かせます。 絵の右の十字で上下左右に 1 マスずつずらせます（8 マスまで）。 はみ出たところは見えなくなるだけで、反対へずらすと戻ります。ずらして空いたところは斜線になり、 描けません（ずらしても描ける範囲は広がりません）。LED には 0 番の色（白）で送ります。 ↻ で右に 90 度まわし、 で左右・上下に裏返します（元の絵だけが変わり、ずれはそのまま）。 は、いま見えている絵を元の絵にした新しいブロックを、 どこにもはめずにすぐ右下に置きます（斜線だったところも白になり、描けるようになります）。 ずれていないときは押せません。パラパラ漫画は、ブロックを複製して「待つ」を挟みながら並べ、 1 コマずつずらして作ります。 値は元の絵 64 文字のあとに、ずれているときだけ を付けます（前の版の 64 文字だけの値も読めます）。 は「全部塗り」しかできない（Ruby 側は 3 引数のみ）ので、 、残りを 1 マス 5 バイトで置きます。 実測で、りんごの絵（3 色）が 175 B、全部同じ色なら 25 B、8 色を総当たりにした最悪で 305 B。 プログラム領域は 10,240 B なので、ぶん入ります

複数のタブ・URB EE Lab からも同じ基板に同時につながり、どこからでも停止 / 再開できます。 ただし基板とのやり取りは 1 つずつで、ほかのタブが書き込んでいる間は、書き込み・停止・再開を断ります （「ほかのタブが基板に書き込んでいます」と出ます。終わってから押し直してください）。

コンポーネント一覧

BASE（GPIO / wait_ms / if / unless / until / case-when / loop / for / while / && / || / puts "文字列" / warn デバッグ出力 / def（引数付き最大2個） / require）= 12,964 B。 そこに必要な機能だけを足して、16 KB の Flash に収めます。

ID	内容	Flash 増分
Q1	Q16.8 固定小数点演算（四則演算・比較・case/when・ラムダ式）	+592 B
Tn	Tone — 周波数制御（ブザー・メロディ）	+476 B
Pw	PWM デューティ比（モータ・サーボ・LED調光）	+548 B
Ad	ADC アナログ入力（整数 0〜255）	+328 B
Us	超音波センサ HC-SR04（距離 cm）	+156 B
I2	I2C / Wire（SDA=pin3 / SCL=pin4・100kHz）	+1,448 B
Rn	乱数 rand / srand（引数なしの srand は電源を入れたときの RAM の中身を種にする）	+264 B
Tm	絶対周期 — ずれない周期（every_ms）と時間計測（Timer）	+384 B
Ve	変数の拡張 — 数値SD変数（$永続変数・3つ目以降の数値変数・数値配列。確認は warn）	+1,516 B
Sv	SD変数・数値出力（PRINT_REG・文字変数・to_s。Ve の機能を含む）	+2,832 B

warn 変数 は数値を DEVICE LOG へ送るデバッグ出力（Ruby の Kernel#warn = stderr に相当）。 数値の文字列化をブラウザ側で行うため Sv 不要で使えます（Q1+Sv 構成のみ Flash 16KB 超過のため非搭載 — puts/p で代替）。

UIAPruby サンプルコード

# LED チカ
led = GPIO.new(2, GPIO::OUT)
loop do
  led.toggle
  sleep(0.2)
end

# ボタンでLED制御
led    = GPIO.new(2, GPIO::OUT)
button = GPIO.new(11, GPIO::IN | GPIO::PULL_UP)
loop do
  if button.low?
    led.on
  else
    led.off
  end
end

# アナログ値で LED の点滅間隔が変わる（Ad 単独）
led = GPIO.new(2, GPIO::OUT)
sensor = ADC.new(0)   # 対応ピン: 0, 1, 12, 15, 16
loop do
  v = sensor.read     # 0〜255 の整数
  led.toggle
  wait_ms v * 2
  wait_ms 20
end

# HC-SR04 超音波距離センサ（配線: TRIG→pin3(PC1)  ECHO→pin4(PC2)  VCC→5V  GND→GND）
sonar = Ultrasonic.new(3, 4)
loop do
  puts sonar.read   # 距離 (cm) を HID コンソールへ出力（0 = 範囲外）
  sleep(0.5)
end

# $ で始まる変数は SD カードに保存され、電源を切っても残る（Sv）
$count = $count + 1
s = $count.to_s
msg = "count="
msg << s
puts msg

# def 引数付き（コンパイル時に定数として展開、Q1 不要）
def blink(pin, ms)
  led = GPIO.new(pin, GPIO::OUT)
  led.write(1)
  sleep(ms)
  led.write(0)
  sleep(ms)
end

blink(2,  0.5)
blink(10, 0.25)

# 多重代入: 2 変数を 1 行で初期化（Q1 コンポーネント必要）
led = GPIO.new(2, GPIO::OUT)
on_ms, off_ms = 200, 800

loop do
  led.on
  wait_ms on_ms
  led.off
  wait_ms off_ms
end

TinyVM 命令セット・URB1 フォーマット・ピン配置の全リファレンスは URB Lab ページ内に掲載しています。

UIAPduino ピン配置（UIAPruby 対応）

Arduino ピン	CH32V003	PWM	ADC	用途
2	PC0	✅	—	LED 出力（基板上 LED）
3	PC1	—	—	SDA（I2 コンポーネント）/ HC-SR04 TRIG 推奨
4	PC2	—	—	SCL（I2 コンポーネント）/ HC-SR04 ECHO 推奨
5	PC3	✅	—	PWM / Tone ブザー
11	PD1	—	—	タクトスイッチ
0, 1, 12, 15, 16	PA1/PA2/PD2/PD5/PD6	—	✅	アナログ入力
6	PC4	✅*	✅*	⚠ SD カード SS 専用 — 使用不可
7 / 8 / 9	PC5/PC6/PC7	—	—	⚠ SD カード SCK/MOSI/MISO 専用 — 使用不可

* ハードウェアは PWM・ADC 対応だが、SD カード搭載版では SS として占有されるため使用不可。

---

デモページ一覧

ページ	スケッチ例	状態
Echo Test	WebHIDTest.ino	✅ 公開中
Keyboard Practice	KeyboardPractice.ino	✅ 公開中
Keyboard Practice 2 — switch 文	KeyboardSwitch.ino	✅ 公開中
Mouse Practice	MousePractice.ino	✅ 公開中
Mouse Practice 2 — GetPos	MousePractice2.ino	✅ 公開中
Maze Solver	MazeSolver.ino	✅ 公開中
Snake Solver	SnakeSolver.ino	✅ 公開中
Rock Dodge	RockDodge.ino	✅ 公開中
Snake VS	SnakeVS.ino	✅ 公開中

---

各ページの機能

HID-Serial Bridge（デバッグ / ユーティリティ）

• UIAPduino の HID通信を WebCom通信（Web Serial API）経由で仮想 COM ポートへ中継するブリッジ
• com0com（仮想 COM ペアドライバ）で作った VirtualCOM 通信ペアを使い、Arduino IDE シリアルモニタ／TeraTerm・Python・C# などと UIAPduino をシリアル通信感覚でつなげる
• HID と WebCom 両方の接続が完了するとブリッジを自動開始
• HID受信モード: Protocol モード（デフォルト）と Raw Binary モードを切替可能
  • Protocol モード: 0x50/0x52 パケットをデコードしてテキスト・バイナリを WebCom 通信へ転送（HidMonitorTest スケッチ向け）
  • Raw Binary モード: 全バイトをそのまま WebCom 通信へ転送（HidBridgeTest スケッチ向け）
• モード切替でスケッチビューアが対応スケッチに自動切り替わる
• WebCom 通信 → HID通信：常に Raw。Feature Report サイズ単位でバッファリング + 30 ms タイムアウトフラッシュ
• HID 接続時に接続通知（0x01 Feature Report）を送信し UIAPduino の WaitAvailable() を解除
• Feature Report サイズをデバイスの HID ディスクリプタから自動検出
• ページ内にセットアップガイド（com0com インストール・設定・使い方）とプロトコル仕様を掲載

HID Console（デバッグ / ユーティリティ）

• Arduino の hid.Print() / hid.Println() / hid.Clear() 出力をブラウザでリアルタイム表示（緑端末 UI）
• HID 接続時に接続通知（0x01 Feature Report）を送信し UIAPduino の WaitAvailable() を解除
• 0x53 Ready 通知を受信してログ表示
• DEC / HEX / ASCII モードで任意データを送信 → Arduino 側 hid.Recv() で受け取り
• Feature Report サイズをデバイスの HID ディスクリプタから自動検出
• バイトプレビューグリッドで送信内容を確認しながら入力
• 送受信ログ（タイムスタンプ付き TX / RX）
• ページ内にプロトコル仕様を掲載

HID 接続チェック（デバッグ / ユーティリティ）

• 機器がつながらないときに、どこで止まっているかを自分で切り分けるための診断ページ。スケッチ不要・1 ファイル完結・外部ライブラリなし。機器には何も書き込まない
• **表に出すのは「チェックする」ボタン 1 つと、3 行の結果だけ。**ボタン 1 回で「ブラウザ → 機器を選べる → 機器を開ける」を続けて行い、 各行に ✔（問題なし）／！（確かめること）／✖（つまずき）を出す。全部 ✔ なら「OK　この機器はブラウザから使えます」と、何の機器だったかだけを出す
• **つまずいたら、その行に短い理由を出し、下の「くわしく」の該当する段を自動で開いて赤枠で示し、そこまでスクロールする。**各行の「くわしく」からも開ける
• ブラウザが対応していないときは、開いた瞬間に ✖ とつまずいた場所を出し、ボタンを押せなくする
• 説明は全部「くわしく」の折りたたみの中。判定の色は 緑＝問題なし／青＝いまの状態の説明／黄＝確かめること／赤＝つまずき／灰＝このページでは判定しない
  • ① ブラウザ: navigator.hid の有無 / window.isSecureContext / location.protocol / userAgent。 使えないときは、PC の Chrome・Edge で開く／https:// で開き直す、を案内（Android は別の案内）
  • ② 機器を選べる: requestDevice({ filters: [] }) をボタン 1 回につき 1 回、ほかの await より先に呼ぶ（クリック直後でないと出せないため）。 絞り込まないので、選ぶ画面がそもそも出るかが分かる。SecurityError・NotAllowedError・選ばれなかったとき、それぞれに意味と次にやることを出す。 同じ段に「このサイトで許可済みの機器」（getDevices()。開いた時点・USB の抜き挿し・チェックのあとに取り直す）
  • ③ 機器を開ける: 選んだ機器を open() してすぐ close()。開けなければ、ほかのアプリ・ほかのブラウザが使っていないか、挿し直しを案内する。 このページが開いたものだけを閉じる
  • 「UIAPduino の 2 通りの挿し方」（見出しの下の「挿し方」リンクからも開く）
    • ふだん（ボタンを押さずに挿す）… 1209:D004「UIAPduino WebHID」。arduino_core_ch32 で作ったプログラムが名乗る番号
    • 書き込みモード（ボタンを押しながら挿して、すぐ離す）… 1209:B803、OS の画面では「32V003」。UIAP が付けた番号。終わらせる処理をしない限り続く
• 入口で案内と判定が変わる。
  • ?mode=boot（URB Block Lab の「⚙ 準備」から）… 冒頭は「ファームウェアを書き込む前の確認です。ボタンを押しながら挿して、すぐ離してください」。 32V003（1209:B803）なら ✔「OK　ファームウェアを書き込める状態です」、ふだんの状態（1209:D004）や別の機器なら ！で挿し直しを案内する。 一覧に何も選ばれなかったときも、ボタンを押しながら挿し直すよう案内する
  • 印なし（トップページ・直接のリンク）… 冒頭に 2 通りの挿し方を両方出し、どちらの状態でも開ければ OK
• 名前で判定するのは、知っている番号（KNOWN の表。いまは 1209:D004・1209:B803）だけ。 それ以外の機器は「異常」と言わず、灰色で「このページが知っている番号ではありません」と生の値を出す。番号は KNOWN に 1 行足せば増やせる
• 機器ごとに productName（空文字なら「(空文字)」）/ vendorId / productId（10 進と 16 進）/ usagePage/usage（collections の全数）を表示。 失敗時は error.name と error.message の両方を出す
• 巻末に折りたたみで「しくみ」（つながるまでの 3 段階＝選べる・開ける・やり取りできる／許可はサイトごと・機器ごと／ 選ぶ画面はクリック直後だけ／UIAPduino は 2 つの機器に見える／番号の読み方）と「結果の早見表」

Echo Test

• Feature Report 送信（Web → UIAPduino）: 接続時にデバイスから Feature Report サイズを自動検出し、グリッドを動的生成
• Input Report 受信ログ（UIAPduino → Web）: エコーバックと 1 秒ごとのカウンターを表示
• スケッチソースビューア: WebHIDTest.ino をページ内でシンタックスハイライト表示

Keyboard Practice

• UIAPduino をキーボード HID として動かす 5 ステップのチュートリアル
• 各ステップのコードブロックをコメントアウトから外して書き込む練習形式
• ワークエリア（textarea）に UIAPduino がタイプした内容が流れ込み、正解と一致すると ✓ 表示
• Step 1: Keyboard.print() で文字列を入力
• Step 2: カーソルキー（KEY_LEFT_ARROW）で移動して文字を修正
• Step 3: KEY_BACKSPACE で文字を削除
• Step 4: KEY_RETURN で改行
• Step 5: KEY_HOME で行頭に移動して文字を挿入

Keyboard Practice 2 — switch 文

• Practice 1 と同じ 5 ステップを switch 文で書き直す練習
• 1 回書き込めばブラウザからステップを自由に切り替えて何度でも実行できる
• switch 文・case・break の使い方を実際に動かしながら学べる

Mouse Practice

• HID マウスの基本操作を 固定座標で練習するページ
• クリック・四角形頂点クリック・ドラッグ・円ドラッグを段階的に確認できる
• .ino に座標を直接埋め込む形式で、マウス HID の仕組みを体験できる
• hidPrint() などのスタンドアロン関数で HID コンソールへ出力

Mouse Practice 2 — GetPos（C++ クラス設計の練習）

• hid.GetPos(x, y) でカーソル座標を動的取得し、相対移動量を計算する発展版
• ブラウザウィンドウの位置・サイズに依存せず動作
• Mouse Practice の hidPrint() スタンドアロン関数を Hid クラスのメソッドとして実装し直す C++ OOP の練習
• hid.Print() / hid.Println() / hid.GetPos() / hid.Recv() を持つ Hid クラスを Hid.h / Hid.cpp に分離

SD Filemanager（SD カードファイル管理）

• UIAPduino SD に挿した SD カードの内容をブラウザからリスト表示・ファイルダウンロード
• ファイル・空のフォルダの削除に対応（コマンド CMD_DEL / CMD_RMDIR）
• SDmin.h（軽量 SD ライブラリ）を使用し、LFN（長いファイル名）にも対応
• ページ上のソースビューアで WebHID_SD.ino を確認・ダウンロード可能

MIDI → MIDB Converter（SAM2695 用 MIDI プレイヤー）

• MIDI ファイル（.mid）をドラッグするだけで .midb バイナリに変換・ダウンロード
• サーバーへのアップロード不要（ブラウザ完結）
• .midb 形式: MIDB マジック + [uint16_t 遅延ms][uint8_t データ長][MIDIバイト列] の繰り返し
• 変換後の .midb を SD カードに入れ、MidbPlayer.ino を書き込んだ UIAPduino SD に接続した SAM2695 で再生
• MIDI Format 0/1 対応・マルチトラックマージ・テンポチェンジ処理
• SAM2695（GM/GS MIDI 音源 IC）の仕様説明をページ下部に掲載

Snake Solver（経路探索アルゴリズムの練習）

• UIAPduino が 16×16 の盤面で岩を避けながら指定ステップ数伸び続けるレベル制ゲーム
• Web ページがゲームを進行し、UIAPduino は snake.sendDir(dx, dy) で次の方向を返すだけ
• 実装済みアルゴリズム: BFS 最大空間優先（岩があっても最も広い空間へ進む）
• レベルクリアごとに岩が 3 個増加、失敗しても同レベルで岩・スタート位置を変えてリトライ
• SnakeHID クラス（SnakeHID.h）に通信をカプセル化、C++ クラス設計の練習も兼ねる

Rock Dodge（リスクとリターンの判断を学ぶ）

• 落ちてくる岩をよけながら得点アイテムを拾うレベル制ゲーム（全レベル 120 ステップ固定）
• セーフティライン（画面の水色）に乗っている限り岩には絶対に当たらない。岩の湧きは毎回 「ライン上の仮想プレイヤーが生き残れること」を検証してから配置される
• ただし乗っているだけではアイテムノルマ（Lv1 で 6 個 → Lv5 で 10 個）に届かずゲームオーバー。 安全運転で取れるのは 1 面 7〜9 個なので、得点はラインを外れた先にしかない
• アイテムの得点は「ラインを何ティック外れる必要があるか（リスク d）」に連動。 得点の帯は互いに重なっているので「浅いのに高いアタリ」「深いのに安いハズレ」がある
• 壁の岩の一部が 2〜4 列つながってアイテムに変わる（隙間とは別の開口部）。奥へ入るほど高得点
• ラインから 2 列以上離れると湧きが敵対化 — 壁の隙間がラインの位置に寄り、 盤面の途中（12 行目・猶予 3 ティック）から狙い岩が降ってくる
• ★（面クリアアイテム）は得点 0 で即クリア＋ノルマ免除。深い位置に湧くので、 順調なときは踏まないように避けるのが正解
• 脱出路の仕掛け: 壁の奥のお宝には、数ティック後の壁に「そこから届く★」が 仕込まれることがある（深いお宝の約 4 割）。詰み確定に見えて狙える状況を意図的に作っている
• 配布スケッチは時空間先読みで生存＋±1 列のタダ取りまで（岩には当たらないがノルマ壁で止まる）
• ランキングは localStorage に名前つきで保存（名前は #define PLAYER_NAME）

Snake VS（対戦アルゴリズムの練習）

• 16×16 の盤面で 2 匹が毎ティック 1 マス成長し、壁・岩・どちらかの体に触れたら死亡。 生き残ったほうがラウンド勝ち。頭が同じマスに入る／頭を入れ替える動きは両者死亡＝引き分け
• vs CPU（1台）: CPU 5 段ラダー（ランダム → 貪欲 → BFS 最大空間 → ボロノイ → ボロノイ＋先読み）を 3 本勝負（2 本先取）で勝ち上がる。ランキングは撃破した最高レベル
• 2P 対戦（2台）: UIAPduino 2 台で直接対戦。5 本勝負で引き分けも 1 本として数え、 勝ち数が多いほうが勝ち（同数なら試合も引き分け）。ランキングは連勝記録 （負けても引き分けても 0 に戻るので、自然に勝ち抜き戦になる）
• 相手の体は「相手の頭の軌跡」。縮まないので、頭の座標 2 バイトを送るだけで デバイス側が相手の体を完全に復元できる（盤面全体を送る必要がない）
• スタート位置は 180° 回転対称の 6 パターンからラウンドごとにランダム。 どのパターンでも位置の有利不利が生じない（開始時の陣地が 115 対 115 で一致することを実測）
• ロックステップ進行 — 相手の CMD_DIR を待ってから次のティックへ進むので、 USB の遅延や計算時間では勝敗が決まらない（2 秒タイムアウト・3 回連続で反則負け）
• 開始時に「3・2・1・スタート」のカウントダウン。この時間で準備通信（RESET → 岩 → START）を 済ませるので、待ち時間がそのまま演出になる。2P では 2 台ぶんの準備をこの窓が吸収する
• 陣地（ボロノイ図）の可視化トグル — どちらが先に到達できるかを色分け表示。 観客に優勢が一目で伝わり、挑戦者には CPU Lv4 が何を最大化しているかが見える
• 効果音（WebAudio で合成・音源ファイル不要）とミュートトグル
• SnakeVSHID クラス（SnakeVSHID.h）に通信をカプセル化

Maze Solver（迷路探索アルゴリズムの練習）

• Web ページが生成した迷路を UIAPduino が WebHID 経由でリアルタイムに探索するゲーム
• maze.sense(x, y) / maze.moveTo(x, y) の 2 関数だけでアルゴリズムを実装できる
• スケッチに実装済みのアルゴリズム:
  • 右手法（Wall Follower）
  • DFS（深さ優先探索）
  • Greedy DFS（マンハッタン距離でゴール方向を優先する DFS）
  • BFS（幅優先探索・最短経路保証）
• WebHID 通信の詳細を MazeHID クラス（MazeHID.h）に分離し、C++ クラス設計の練習も兼ねる
• Web 側でも BFS による 回答表示（ゴールまでの最短経路をキャンバス上に緑表示）が可能

全ページ共通

• スケッチソースビューア（シンタックスハイライト・コピー・ZIPダウンロード・GitHub リンク）
  • 「ZIPダウンロード」ボタンで全ファイルを スケッチ名/スケッチ名.ino 構成の ZIP として取得。Arduino IDE でそのまま開ける
• WebHID 接続 / 切断（USB 抜き差しも navigator.hid レベルで自動検知）
• Feature Report サイズをデバイスの HID ディスクリプタから自動検出（スケッチ切り替えに対応）
• ログパネル（TX / RX / SYS）

---

必要なもの

ハードウェア

• UIAPduino (HID ProMicro CH32V003) — Board Version V1.4 以降
• USB ケーブル（デバイスと PC を接続）

ソフトウェア

• Chrome または Edge（WebHID / Web Serial API 対応ブラウザ）— これだけで使えるページもあります

• Arduino IDE 2.x（スケッチを自分でビルドする場合）

• UIAPduino ボードパッケージ（スケッチを自分でビルドする場合）— Board Manager に以下の URL を追加してインストール

  https://raw.githubusercontent.com/tarosay/board_manager_files/main/package_uiap_hid_index.json
  

  対象	必要バージョン	理由
  URB Lab（SD 版）	v1.2.15 以降	SDmin のランダムアクセス API と v1.2.7 の ADC ピン修正。v1.2.14 まではピン 11（PD1）が IO として働かない
  URB EE Lab	v1.2.15 以降	NeoPixel の回転・減光が NeoPixelmin::getPixels()（v1.2.13）を使う。v1.2.14 まではピン 11（PD1）が IO として働かない

  URB EE Lab のビルド済みファームを書き込むだけなら、Arduino IDE もボードパッケージも要りません。

• com0com（HID-Serial Bridge を使う場合のみ）— 仮想 COM ペアドライバ（Windows 用）

---

使い方

1. Arduino IDE を開き、ボードを 「HID ProMicro CH32V003」 に設定
2. Tools → USB → 使用するスケッチに合わせたモードを選択（例: Keyboard+Mouse+WebHID）
3. デモページの「ZIPダウンロード」ボタンで ZIP を取得し展開するか、コピーして Arduino IDE に貼り付け、書き込む （ZIP を展開すると スケッチ名/スケッチ名.ino の構成になり、Arduino IDE でそのまま開ける） （または File → Examples → WebHID → WebHIDTest から直接開く）
4. Chrome / Edge でサイトを開き、デモページへ移動
5. 「デバイスを選択して接続」ボタンから UIAPduino を選択 （usagePage: 0xFF00 でフィルタされるため、WebHID コレクションのみ表示されます）
6. ページ上の UI でデータ送受信を試す

---

WebHID 通信の概要

[Web ブラウザ]                              [UIAPduino]
 sendFeatureReport()  ─── EP0 ──────────►  usb_handle_user_data()
                         Control Transfer        ↓
                         32 バイト（v1.1.5 以降）  WebHID.recv()  /  hid.Recv()

 inputreport イベント  ◄─── EP3 ──────────  WebHID.send()  /  hid.Print()
                         Interrupt IN           ↑
                         8 バイト / 10ms   usb_handle_user_in_request()

方向	エンドポイント	プロトコル	サイズ
Web → デバイス	EP0	Control Transfer (Feature Report)	スケッチの recv バッファサイズに依存
デバイス → Web	EP3	Interrupt IN	8 バイト / パケット

Feature Report サイズについて
arduino_core_ch32 v1.1.5 で Feature Report サイズが 16 → 32 バイト に変更されました。
スケッチ内の WebHID.recv(buf, sizeof(buf)) に渡すバッファサイズが、
USB ディスクリプタに登録される Feature Report サイズになります。
ブラウザは接続時にディスクリプタを読み取り、そのサイズに合わせた sendFeatureReport() のみ受け付けます。
各ページはデバイス接続時にサイズを自動検出し、UI に反映します。

ボードパッケージ	Feature Report サイズ
arduino_core_ch32 v1.1.3 以前	16 バイト
arduino_core_ch32 v1.1.5 以降	32 バイト

USB Low Speed の制約
Interrupt エンドポイントの最大パケットサイズは 8 バイト固定。
16 バイト以上を返す場合は 8 バイトずつ複数回 WebHID.send() を呼ぶ。

通信インターフェイス定義

用語	区間	技術
HID通信	UIAPduino ↔ ブラウザ	USB HID（WebHID API）
WebCom通信	ブラウザ ↔ 仮想COMポート	Web Serial API
VirtualCOM通信	仮想COMペア内部（COM8 ↔ COM9）	com0com
COMモニタ通信	仮想COMポート ↔ モニタアプリ	シリアル通信

マーカーバイト一覧

マーカー	名称	方向
0x50	Print	UIAPduino → ブラウザ
0x51	GetPos	双方向
0x52	Write	UIAPduino → ブラウザ
0x53	Ready	UIAPduino → ブラウザ
0x01	接続通知	ブラウザ → UIAPduino

プロトコル仕様

Print（0x50） — hid.Print() / hid.Println() / hid.Clear()

byte	内容
0	0x50（マーカー）
1	flags: 0x80=続きあり / 0x04=クリア
2〜7	テキスト本体（最大 6 文字、0x00 埋め）

※ 改行は 0x0A をテキストに含めて送信（NL フラグは廃止）

Write（0x52） — hid.Write()

byte	内容
0	0x52（マーカー）
1	flags: 0x80=続きあり
2	ペイロード長（0〜5）
3〜7	バイナリペイロード

Ready（0x53） — hid.Ready()（任意使用）

byte	内容
0	0x53（マーカー）
1〜7	0x00（予約）

接続通知（0x01） — HID接続時にブラウザが送信

byte	内容
0	0x01（接続通知マーカー）
1〜	0x00（未使用）

UIAPduino 側の hid.WaitAvailable() がこれを検出して処理を開始する。

---

ファイル構成

docs/                           ← GitHub Pages のルート
  index.html                    ← ポータルページ（デモ一覧・WebHID 解説）
  echo.html                     ← Echo Test デモ
  keyboard.html                 ← Keyboard Practice（コメント外し形式）
  keyboard2.html                ← Keyboard Practice 2（switch 文形式）
  mouse.html                    ← Mouse Practice（固定座標）
  mouse2.html                   ← Mouse Practice 2（GetPos / Hid クラス）
  maze-solver.html              ← Maze Solver（迷路探索アルゴリズムの練習）
  snake.html                    ← Snake Solver（経路探索アルゴリズムの練習）
  rock-dodge.html               ← Rock Dodge（リスクとリターンの判断）
  snake-vs.html                 ← Snake VS（対戦アルゴリズム / vs CPU・2P 対戦）
  hid-console.html              ← HID Console（デバッグ / ユーティリティ）
  hid-serial-bridge.html        ← HID-Serial Bridge（com0com 経由シリアル中継）
  hid-test.html                 ← HID 接続チェック（ボタン 1 つの簡易チェック。requestDevice / open / getDevices と判定）
  sd-file.html                  ← SD Filemanager（SD カードファイル管理）
  midi-to-midb.html             ← MIDI → MIDB Converter（SAM2695 用）
  uiapruby.html                 ← URB Lab（コンポーネント選択式 Ruby → URB1 コンパイラ + TinyVM 実行環境）
  uiapruby-ee.html              ← URB EE Lab（保存先が I2C EEPROM の版。NeoPixel / UART / EEPROM 変数ビューア / ファーム書き込み）
  uiapruby-block.html           ← URB Block Lab（Blockly でブロックを組む子ども向けの入口。.rb で保存 / 読み込み、?rb= でギャラリーから開く）
  lib/
    prism/                      ← @ruby/prism WASM（Ruby の AST 解析）
    blockly/                    ← Blockly 一式（Apache-2.0。圧縮済みファイルをそのまま同梱）
    urb/
      compiler.js               ← Ruby AST → URB1 コンパイラ（EE Lab と Block Lab で共有）
      eeprom.js                 ← WebHID で EEPROM に読み書きする接続（同上）
    flasher/
      rv003usb_webflasher.js    ← rv003usb ブートローダへの書き込み（MIT。上流をそのまま同梱）
      sketchBins.js             ← ビルド済みファーム 6 種を base64 で内包（tools/embed-bins.mjs が生成）
      blockBin.js               ← URB Block Lab 専用ファーム 1 本（tools/build-block-bin.mjs が生成）
      rv003usb_reader.js        ← ブートローダから Flash を読み出して照合する（フラッシャから読み出し部分だけ写したもの。MIT）
      knownBins.js              ← これまでに配ったファームのハッシュ一覧（tools/gen-known-bins.mjs が生成）
  favicon.svg                   ← 全ページ共通ファビコン
  images/
    com0com.jpg                 ← com0com Setup GUI スクリーンショット
    WakayamarbLOGO.png          ← Wakayama.rb コミュニティロゴ
    24x24みかん.png             ← sv-dotart サンプルのドット絵原図
    UIAPduinoBlock.png          ← URB Block Lab のロゴ（256px 版も同梱）
    urb-block-icon-32.png       ← URB Block Lab のファビコン（ロゴのパズルのブロックだけ、32×32）
    urb_block_banner.png        ← URB Block Lab の SNS リンクカード画像（og:image、1734×907）
    urbgallery.png              ← URB ギャラリーの絵（384px 版を URB Block Lab のギャラリー案内で使用）
    UIAPDuinoICON.png           ← UIAPduino のアイコン（256px 版も同梱）
  sketches/                     ← スケッチ置き場（Arduino IDE 風サブフォルダ）
    WebHIDTest/
      WebHIDTest.ino            ← Echo Test スケッチ（16 バイト Feature Report）
    HidBridgeTest/
      HidBridgeTest.ino         ← HID-Serial Bridge テストスケッチ（Raw エコーバック）
      Hid.h                     ← Hid クラス宣言
      Hid.cpp                   ← Hid クラス実装
    HidMonitorTest/
      HidMonitorTest.ino        ← HID-Serial Bridge Protocol モード用スケッチ
      Hid.h                     ← Hid クラス宣言
      Hid.cpp                   ← Hid クラス実装
    KeyboardPractice/
      KeyboardPractice.ino      ← Keyboard Practice スケッチ（正解）
    KeyboardSwitch/
      KeyboardSwitch.ino        ← Keyboard Practice 2 スケッチ（正解）
    MousePractice/
      MousePractice.ino         ← Mouse Practice スケッチ
    MousePractice2/
      MousePractice2.ino        ← Mouse Practice 2 スケッチ
      Hid.h                     ← Hid クラス宣言
      Hid.cpp                   ← Hid クラス実装
    HidPrint/
      HidPrint.ino              ← HID Console デモスケッチ
      Hid.h                     ← Hid クラス宣言
      Hid.cpp                   ← Hid クラス実装
    MazeSolver/
      MazeSolver.ino            ← 迷路探索アルゴリズム（メインスケッチ）
      MazeHID.h                 ← MazeHID クラス（WebHID 通信を担当）
    SnakeSolver/
      SnakeSolver.ino           ← スネーク経路アルゴリズム（メインスケッチ）
      SnakeHID.h                ← SnakeHID クラス（WebHID 通信を担当）
    RockDodge/
      RockDodge.ino             ← 岩よけ＋アイテム取得アルゴリズム（メインスケッチ）
      RockDodgeHID.h            ← RockDodgeHID クラス（WebHID 通信を担当）
    SnakeVS/
      SnakeVS.ino               ← 対戦スネークアルゴリズム（メインスケッチ）
      SnakeVSHID.h              ← SnakeVSHID クラス（WebHID 通信を担当）
    WebHID_SD/
      WebHID_SD.ino             ← SD Filemanager スケッチ（32 バイト Feature Report）
    MidbPlayer/
      MidbPlayer.ino            ← MIDI (.midb) 再生スケッチ（32 バイト Feature Report）
      UIAPSerial.h              ← 軽量 USART1 クラス（宣言）
      UIAPSerial.cpp            ← 軽量 USART1 クラス（実装）
    UIAPrubyVm*/                ← URB Lab TinyVM ファーム（コンポーネント組み合わせ別の動作確認済みビルド。
                                   配布はページ内の generateIno がブラウザで生成）
    Measure_*/                  ← コンポーネント別 Flash サイズ計測用スケッチ
tools/
  gen-ino.js                    ← uiapruby.html の generateIno を抜いて .ino を出す検証用
  embed-bins.mjs                ← URB EE Lab の配布ファームを作る。generateIno →
                                   arduino-cli → .bin → base64 を一連で回し
                                   docs/lib/flasher/sketchBins.js を生成する
  gen-known-bins.mjs            ← git の履歴から配布ファームのハッシュを集め、knownBins.js を生成する
                                   （embed-bins.mjs と build-block-bin.mjs が最後に呼ぶ）
README.md

tools/embed-bins.mjs は npm run build に繋いでいません。.bin を作るには arduino-cli が要るためです。生成物はリポジトリに追跡させ、generateIno を直したときだけ リポジトリのルートで node tools/embed-bins.mjs を走らせてください。 走らせ忘れると、ページ側の SHA-256 照合が書き込みを止めます。

---

Hid クラス API

HidBridgeTest / HidMonitorTest / HidPrint スケッチで共通して使用する Hid クラスのメソッド一覧。

メソッド	プロトコル	説明
Print(const char* s)	0x50	テキスト送信（改行なし）
Print(int v)	0x50	整数送信（改行なし）
Println(const char* s = "")	0x50	テキスト送信 + 改行（0x0A）
Println(int v)	0x50	整数送信 + 改行（0x0A）
Clear()	0x50 CLEAR	画面クリア
Write(const uint8_t* buf, uint8_t len)	0x52	バイナリ送信（0x00 含むデータも正確に転送）
Send(const uint8_t* buf, uint8_t len)	Raw	マーカーなし Raw 送信
Ready()	0x53	準備完了通知（任意）
Recv(uint8_t* buf, uint8_t maxLen)	—	Feature Report 受信。戻り値: 受信バイト数
WaitAvailable(uint32_t timeoutMs = 0)	—	Feature Report 到着まで待つ。データを消費しない。0 = 無限待ち
GetPos(int16_t& x, int16_t& y)	0x51	カーソル座標取得。500 ms タイムアウト

LTO（Link Time Optimization）について
CH32V003 は Flash 16 KB。LTO が有効なため、スケッチで使用しないメソッドはビルド時に自動削除されます。

---

変更履歴

2026-10-28

URB Block Lab — 「基板のファームウェアを調べる」で、いま配っている版が「まだ公開していない版」と出ていたのを直した

• 照合表 knownBins.js は、作ったときに git の履歴にあるファームウェアにしか日付とコミットを付けない。 コミットは自分自身の番号を中に書けないので、ビルドと同じコミットに入る照合表では、いま配っている版の記録が必ず空になる。 これまでは、コミットのあとに照合表を作り直してもう一度コミットしていたが、2026-10-10 以降の 4 回でこれが抜け、 公開中のページが、いま配っている 7 本すべてを「まだ公開していない版」と出していた
• 作り直すためだけのコミットはやめた。記録が空のものは「いま配っている版」と出す。 日付とコミットは、次のビルドで照合表を作り直したときに、履歴から付く。 ビルドした日の日付で埋めることはしない（コミットした日とずれることがあり、あとで別の日付に変わるため）
• 照合するときに、ページが書き込むファームウェア（blockBin.js）を照合表に足すようにした。 照合表を作り直し忘れても、いま配っている版が「どれとも一致しない」にならない。 書き換えが要るかどうかは、もともと照合表ではなくこのファームウェアと比べて決めている
• 照合表を作り直した（いま配っている 7 本に日付とコミットが入った）。ファームウェアは変えていない（配布 bin・ファームウェアの版はそのまま）
• 実機で確かめた（今の照合表のとき／いま配っている版の記録が無いとき）

2026-10-18

URB Lab / URB EE Lab / URB Block Lab — rand で小さい数が出やすかったのを直し、範囲の外はコンパイルエラーにした

• ファームウェアは乱数の下 1 バイト（0〜255）を範囲の数で割った余りにしていたので、256 が範囲の数で 割り切れないと、小さいほうの数が 2 倍出やすかった（rand(0..199) なら 0〜55）。 余りのもとが最後の欠けた段に入ったときは捨てて引き直すようにし、どの数も同じ確率にした。 範囲の数が 256 の約数（2・4・8・…・128）のときは捨てることが無いので、srand(n) からの並びは前と同じ
• RAND 命令は範囲の両端を 1 バイトずつ送るのに、コンパイラは 256 以上を黙って下 8 ビットに切っていた。 rand(0..499) は 0〜243 になって 250 が出ず、rand(0..255) はいつも 0 になっていた。 引けるのは 0〜254（rand(n) は n が 1〜255、rand(a..b) は 0 ≦ a ≦ b ≦ 254）とし、外れたらコンパイルエラーにした。 もっと広い範囲が欲しいときは rand を 2 回使って組み合わせる。URB Block Lab の乱数ブロックの入力欄の上限は 変えていない（下げると、保存した作品を読み込んだときに黙って丸められ、エラーにならないため）
• Flash は +16〜24 B（URB EE Lab ブザー版 16,052 B / 16,064 B、サーボ版 15,996 B / 16,008 B、 URB Block Lab 15,588 B、SD 版の Rn だけの構成 12,952 B）。見積もりと表示の Rn を、SD 版は 240 B から 264 B に、 EE 版は 208 B から 232 B（引き出しの表示は +248 B から +272 B）にした
• 配布ファームウェアを作り直した（sketchBins.js・blockBin.js・knownBins.js）。 URB Block Lab のファームウェアの版を 4 に上げたので、前のファームウェアの基板には「古い版です」と出る
• docs/sketches の UIAPrubyVmRn / UIAPrubyEeVmRn も同じように直した

2026-10-11

URB Block Lab — 「基板のファームウェアを調べる」で、どれとも一致しないときも書き込みモードのままにした

• これまでは、配ったことのあるファームウェアのどれとも一致しないとき（Arduino IDE で書き込んだものなど）は 普段の動作に戻していた。書き込みたいときは、ボタンを押しながら USB を挿し直す必要があった
• URB Block Lab のページで調べるのは、URB Block Lab を使いたいとき。そこで、このページと同じ版でなければ 一致しないときも含めて書き込みモードのままにし、「ファームウェアを書き込む」へ案内する。 書き込まないときは、USB を挿し直せば普段の動作に戻る
• ファームウェアは変えていない（配布 bin・ファームウェアの版はそのまま）
• 実機で確かめた

2026-10-10 (5)

URB Lab / URB EE Lab / URB Block Lab — 引数なしの srand の種を、電源を入れたときの RAM の中身から作るようにした

• 2026-10-10 (2) で SysTick を種にしたが、電池で動かすと毎回同じ並びになった（USB につないだときだけばらばらになった）。 電源を入れてから srand までにかかる時間が、クロックの数で数えて毎回同じだからだと考えている
• 試験用のファームウェアで調べると、.bss の終わりから上の RAM は、電源を入れた直後は毎回違う値だった （起動時に 0 にされるのは .bss まで）。ただし srand の時点で読むと、それまでにスタックが毎回同じ値で 上書きしていて変わらなかった
• そこで、setup() の最初の行で .bss の終わりから今のスタックの位置までを読んで混ぜ、_seed に取っておく。 引数なしの srand（種 0）は _seed を種にする。srand(n) と、srand を置かないときの動きは変わらない
• 実機（URB EE Lab・電池）で、電源を切って 10 秒置いても、切ってすぐ入れ直しても、毎回違う並びになることを確かめた
• Flash は SysTick 版から +36〜40 B（URB EE Lab ブザー版 16,028 B / 16,040 B、サーボ版 15,976 B / 15,988 B、 URB Block Lab 15,572 B、SD 版の Rn だけの構成 12,928 B）。見積もりと表示の Rn を、SD 版は 204 B から 240 B に、 EE 版は 168 B から 208 B（引き出しの表示は +208 B から +248 B）にした
• 配布ファームウェアを作り直した（sketchBins.js・blockBin.js・knownBins.js）。 URB Block Lab のファームウェアの版を 3 に上げたので、前のファームウェアの基板には「古い版です」と出る
• docs/sketches の UIAPrubyVmRn / UIAPrubyEeVmRn も同じように直した

2026-10-10 (4)

URB Lab（SD 版）— ブザー（Tn）も PWMmin を使わない書き方にして、530〜550 B 小さくした

• URB EE Lab と同じ toneOut(pin, freq) を generateIno に置いた。SD 版はピン 6 が SD の SS 専用で Tone に使えないので、 ピン 6 の分岐は無い（対応ピンは今までどおり 0・2・5・12）
• 大きさ: Tn だけ 13,696 B → 13,164 B（−532 B）、Q1＋Tn 14,292 B → 13,744 B（−548 B）。 ページの見積もりと表示、README のコンポーネント表の Tn を +1,008 B から +476 B にした
• FQBN の pwm=default を外した（生成する .ino の先頭コメントと、ダウンロードする ZIP の sketch.yaml）
• docs/sketches/UIAPrubyVmTn と UIAPrubyVmQ1Tn も同じように直した（Measure_Tn は Flash 計測用なのでそのまま）
• 実機（Tn だけのファームウェア）で、tone・frequency・off・鳴らしたままの音の高さの変更が正しく鳴ることを確かめた
• EE 版より大きく減るのは、EE 版の toneOut にだけあるピン 6 の分岐で、GCC がピン番号で引く表（CSWTCH.*、160 B）を 作っているため。EE 版からピン 6 の分岐を外すと表が消え、ブザー版（24FC256）は 15,992 B から 15,844 B になる

2026-10-10 (3)

URB EE Lab — ブザー（Tn）を PWMmin を使わない書き方にして、ブザー版を 360 B 小さくした

• ブザー版は Flash の残りが 20〜32 B しかなかった。Tn がボードパッケージの PWMmin.h を使っていて、 ピンごとに処理を丸ごと書いた Pwm_write・Pwm_stop と、ほぼ同じ関数 2 つ（Pwm_freq_TIM1 / Pwm_freq_TIM2）が入っていたため
• generateIno に、Pw の pwmSetDuty と同じ書き方の toneOut(pin, freq) を 1 つ置いた。 ピンごとに違うのは使うタイマーとレジスタだけなので、それを変数に入れて設定は 1 回だけ書く。 周波数 0 で止めて入力フロートに戻すのは今までと同じ。対応ピンも同じ（0・2・5・6・12）
• 大きさ: ブザー版 24FC256 16,352 B → 15,992 B、CAT24M01WI 16,364 B → 16,004 B（残り 392 B / 380 B）。 ページの見積もりの Tn を 1,196 B から 836 B に、表示を +1008 B から +648 B にした
• PWMmin を使わなくなったので、FQBN の pwm=default を外した（生成する .ino の先頭コメント・ ダウンロードする ZIP の sketch.yaml・tools/embed-bins.mjs）。付けても外しても .bin は同じになることを確かめた
• 配布ファームウェアを作り直した（sketchBins.js・knownBins.js）。サーボ版は変わらない。 docs/sketches/UIAPrubyEeVmTn も同じように直した
• 実機（ブザー版）で、tone・frequency・off・鳴らしたままの音の高さの変更が正しく鳴ることを確かめた
• URB Lab（SD 版）の Tn は PWMmin のまま

2026-10-10 (2)

URB Lab / URB EE Lab / URB Block Lab — 引数なしの srand（「乱数の種をばらばらにする」）が、種をばらばらにしていなかった

• 引数なしの srand は、起動のたびに違う並びの乱数にするはずだった（Rn の仕様・ブロックの説明・サンプルのコメント）。 ところがコンパイラは種 0 を送り、ファームウェアは 0 を 1 に直すだけだったので、いつも srand(1) と同じ並びになっていた
• ファームウェア（generateIno、SD 版と EE 版の両方）: 種 0 を受け取ったら、SysTick->CNT | 1 を種にするようにした
• コンパイラ（lib/urb/compiler.js と uiapruby.html の中のもの）: srand(0) は今までどおり srand(1) と同じ並びに なるよう、1 にして送る（65536 など、下 16 ビットが 0 になる数も同じ）。種 0 を送るのは引数なしの srand だけ
• Flash は URB Block Lab のファームウェアで +8 B（15,536 B）、URB EE Lab の配布ファームウェアで +12 B （ブザー版 16,352 B / 16,364 B、サーボ版 15,936 B / 15,948 B）。見積もりと表示の Rn を、SD 版は 196 B から 204 B に、 EE 版は 156 B から 168 B（引き出しの表示は +196 B から +208 B）にした
• 配布ファームウェアを作り直した（sketchBins.js・blockBin.js・knownBins.js）。 URB Block Lab のファームウェアの版を 2 に上げたので、前のファームウェアの基板には「古い版です」と出る
• docs/sketches の UIAPrubyVmRn / UIAPrubyEeVmRn も同じように直した（Measure_Rn は Flash 計測用なのでそのまま）
• 起動のたびに本当に違う並びになるかは、実機では確かめていない

2026-10-10

URB Block Lab — 「NeoPixel の並び」で、折り返さないマトリックスも選べるようにした

• 番号が折り返さず、どの列（行）も同じ側から並ぶ 8×8・4×4 のマトリックスがあるため
• ブロックを「NeoPixel の並び 0 番は 〔左下〕 〔縦に折り返し〕」にし、2 つ目のえらびを 縦に折り返し・横に折り返し・縦に折り返さない・横に折り返さない の 4 つにした（0 番の角と合わせて 16 通り）
• 保存した作品は今までどおり読める（「縦」「横」だったものは「縦に折り返し」「横に折り返し」になる）
• 変わるのは出る Ruby の LED の番号だけ。ファームウェアは変わらない。折り返さない並びが実機で正しく動くことを確かめた
• 並びは最初に決めるものなので、NeoPixel の引き出しで「NeoPixel を ◯ 個使う」と「明るさを ◯ にする」の間に移した

2026-10-08 (2)

URB Block Lab — 「明るさを ◯ にする」を引き出しの上に移し、絵のブロックで最初に持っている色を赤にした

• NeoPixel の引き出しで、「明るさを ◯ にする」を「NeoPixel を ◯ 個使う」のすぐ下に移した。 NeoPixel を使うときは必ず「はじめに」に置くので、つかみやすいところにした。数の初期値は 30 から 10 にした
• 絵（8×8・4×4）の面を開いたときに持っている色を、5 番の青から 1 番の赤にした

2026-10-08

URB Block Lab / EE Lab — 絵のパレットを「もし」や繰り返しの中でも使えるようにした

• 今までは np.palette を if / unless / case / while / until の中に書くとエラーにしていた。 基板にはパレットという考え方が無く、np.palette は命令にならない（色はコンパイラが前もって np.paint に入れる）ため
• コンパイラ（lib/urb/compiler.js）が、パレットの表を通る道ごとに追うようにした。 if / case は道ごとに表を分け、合流したところで、道によって色が違う番号を「決まらない」にする。 break・next・return で抜けた道も、行き先で合流させる
• 繰り返しは、本体の最後で変えた色が次の周の先頭に届く。先頭の表が落ち着くまでコンパイルをやり直す （ほとんどの作品は 1 回で済む）。3.times のように回数が決まっている繰り返しは、抜けたあとに本体の最後の色を使う
• 「決まらない」番号を np.paint / np.paint_fill が使ったときだけ、エラーにした。 パレットを変えたのと同じ if や繰り返しの中で描けば、その色で描かれる。if の中から、パレットと絵を書いた関数を呼ぶこともできる
• 直した不具合: loop do の中で、絵より後ろで np.palette を変えると、次の周の絵に色が届かず、 エラーも出ずに最初の色のままだった（コンパイラが繰り返しの中を 1 回しか読んでいなかったため）。今は「決まらない」としてエラーになる
• URB Block Lab: 「もし」「〜の間 繰り返す」の中のパレットのブロックで、Ruby の先頭に出していた警告コメントをやめた。 パレットの 4 つのブロックの説明も書きかえた
• ブラウザで、if・case・loop do・while・n.times・break・return のそれぞれで色が決まること／決まらないときにエラーになること、 URB EE Lab のサンプル 45 個（コンポーネントの組み合わせ 2 通り）の命令とエラーが変わらないことを確かめた
• URB Block Lab で、4×4 のアニメーションを 3 つの関数にして、入れ子の「もし」の中から色を変えて呼ぶ作品を、実機で確認した

2026-10-07 (7)

URB Block Lab / EE Lab — n.times の中で変数を使うと、ループから抜けられなくなっていたのを直した

• 10.times の中で変数の代入や比較をすると、10.times が終わらず、そのあとの puts に進まなかった（Q1 を選んでいるとき）
• 原因: n.times は回数を R2 に数えていたが、本体の計算がその R2 を一時置き場に使って書きかえていた
• 本体をコンパイルしている間は、回数のレジスタを一時置き場に使わせないようにした。 回数は n から 0 まで減らす数え方に変えた（ループの入口で一時置き場が要らなくなり、命令も短くなった）
• 入れ子にしたときは、外側の回数が R2、内側の回数が R3 に入る。 入れ子にして数値変数を 2 つ使うとレジスタが足りないので、コンパイルエラーにした（今までは黙って回数が壊れていた）
• URB Block Lab で、NeoPixel を光らせる 10.times のあとの puts が出ることを実機で確認した

2026-10-07 (6)

URB Block Lab / EE Lab — 絵の色（パレット）を外から変えるブロックと、np.palette / np.paint / np.paint_fill を足した

• URB Block Lab に 4 つのブロックを足した（引き出しは NeoPixel の「4×4 に絵を表示」の下）。 「絵のパレット 〔▾〕 を 赤 ◯ 緑 ◯ 青 ◯ にする」「絵のパレット番号 ◯ を 赤 ◯ 緑 ◯ 青 ◯ にする」と、 色を押して選ぶ「絵のパレット 〔▾〕 を 〔色〕 にする」「絵のパレット番号 ◯ を 〔色〕 にする」
• パレット番号は 0 から 7。絵のブロックの「いろ」の左端（白）が 0、右端の ✕「けす」が 7（中で覚えている番号と同じ）
• 効くのは、そのブロックより後ろ（動く順）に置いた絵（8×8・4×4）の全部。8×8 と 4×4 で共通
• 番号の口と赤・緑・青の口は両端がへこんだ口。繰り返しの〔番号〕や関数の〔引数〕で、パレット番号も色も変えられる
• ▾ は、そのブロックで決める色で番号を描く。赤・緑・青に〔番号〕などが入っていて、動くまで色が決まらないときは灰色。 ▾ を開いた一覧は番号だけ
• 絵のブロックを、パレットで決まった色で描く。 「いろ」の見本・マス・描く面の色を、その絵のブロックに着いたときの パレットの色にする。外から決まった見本には右上に白い丸の印を付け、絵のブロックの中では色を変えられない（押しても開かない）。 通るたびに色が変わる絵は、1 回目に通るときの色で見せる。 色は、ブロックを変えるたびに今の Ruby をコンパイラに通して求める（コンパイラは each を展開し def を写すので、動く順に追える）
• コンパイラ（lib/urb/compiler.js）に 3 つ足した。 np.palette(パレット番号, 赤, 緑, 青) はコンパイラの中の表を書き換えるだけで、命令を出さない。 np.paint(LED の番号, パレット番号, 赤, 緑, 青) は、表に色があればその色、無ければ (赤, 緑, 青) で NEO_SET_RGB を出す。 np.paint_fill(パレット番号, 赤, 緑, 青) は同じ決め方で NEO_FILL を出す。 each は展開・def は写すので、表はプログラムが動く順に書き換わる。ファームウェアは変わらない
• np.palette は if / unless / case / while / until の中ではエラーにした（通るかどうかが書き込む前に分からないため）。 URB Block Lab では「もし」「〜の間 繰り返す」の中に置くと、Ruby の先頭に警告コメントも出す
• パレットのブロックが 1 つも無い作品は、絵のブロックが今までどおり np.fill / np.set を出す（出る Ruby は変わらない）
• URB EE Lab でも、この 3 つを Ruby で書ける（コンパイラが共通のため。書き方の表にも足した）
• ブラウザで、▾ の色、絵のブロックの見本・マス・描く面の色、組んだ Ruby がコンパイラを通ること、 「もし」「〜の間」でのエラーを確かめた。基板ではまだ試していない

2026-10-07 (5)

URB Block Lab — 「?」が消えることがあったのを直した

• 「展開関数を呼ぶ」を引き出しから出すと、「?」が無くなっていた（引数のある関数が選ばれているとき）。 ⊕ / ⊖ を押したときも、「展開関数を呼ぶ」「もし」「つぎの数を 順に 〔数〕 に入れて 繰り返す」の「?」が消えていた
• 原因: 「?」はブロックのいちばん下の行（⊕ の行）に付けていて、形を組み直すとその行ごと作り直していた
• 形を組み直したあとに、「?」を付け直すようにした。元に戻す・やり直す、保存して開き直したときも付いている

2026-10-07 (4)

URB Block Lab — 繰り返しの番号・関数の引数を、NeoPixel の色や番号・関数の引数に入れられるようにした（両端がへこんだ口）

• NeoPixel の色や LED の番号、展開関数の引数は、書き込む前に数に置き換わる。Ruby では np.fill(i * 10, 0, 0) や 光る(i) のように繰り返しの番号とその計算が書けて、コンパイラも通していたが、ブロックは数を打つ欄だったので書けなかった
• 新しい形の口を足した。 Zelos の 丸（数・文字）／六角形（条件）／四角（それ以外）に加えて、両端が内側にへこんだ形。 書き込む前に数が決まる値だけの口で、はまるのは「数」「繰り返しの番号」「関数の引数」「計算（＋ − × ÷）」だけ。 ふつうの変数や丸い計算ブロックは形が合わず、はまらない。逆に、へこんだ形のブロックは丸い口にもはまらない（形の意味を崩さないため）
• この口にしたのは次の 8 つ: NeoPixel の「◯ 番を 〔色〕 にする」の番号、「◯ 番を 赤 ◯ 緑 ◯ 青 ◯ にする」の番号と赤・緑・青、 「全部 赤 ◯ 緑 ◯ 青 ◯ にする」の赤・緑・青、「◯ 番を 色 ◯ 鮮やかさ ◯ 明るさ ◯ にする」の全部、 「虹を作る」のずらし、「◯ ％ 暗くする」、「明るさを ◯ にする」、それと「展開関数を呼ぶ」の引数
• 繰り返しの〔番号〕と関数の〔引数〕は、ブロックからつまんで引き出す。 「0 から 15 まで 〔番号〕 を変えながら 繰り返す」の〔番号〕、「つぎの数を 順に 〔数〕 に入れて 繰り返す」の〔数〕、 「展開関数を定義 〔手順〕 引数 〔引数〕」の〔引数〕は、へこんだ形のブロックになった。引っ張ると引っ張ったほうが写しになり、 元の場所にはすぐ新しいものが入る（Scratch の自作ブロックの引数や MakeCode と同じ）。元の場所の口には何もはめられず、消せない。 写しをその繰り返し・その関数の外に持ち出してへこんだ口に置くと、Ruby の先頭に警告コメントを出す （Ruby では each の番号は each の中、def の引数は def の中でしか見えない）
• 計算は「計算」の引き出しの「〈1〉 ＋ 〈1〉」（へこんだ形）。計算の中に計算を入れられる（250 - 番号 × 10 など）
• 「〔かず〕 に )番号( をセット」を足した（「変数」の引き出しの「〜をセット」の下）。 へこんだ形のブロックを丸い口（「◯ ミリ秒待つ」「配列の番号」「もし」の条件など）で使うときは、これでいったん変数に入れる。 「もし 〔引数2〕 = 0 なら」は「〔かず〕 に 〔引数2〕 をセット」→「もし 〔かず〕 = 0 なら」と組む （コンパイラの「もし」は左側に変数しか読めない）
• 「〔かず〕 に ◯ をセット」の〔かず〕も引き出せる。 標準の「〜をセット」と「〔かず〕 に )番号( をセット」の〔かず〕を、 欄から頭の口に入った変数のブロックに替えた。つまんで引っ張ると変数のブロック（丸い〔かず〕）の写しが出る。 ▾ で別の変数に替えるのは今までどおり。変数のブロックの右クリック「セット〜を作成」も、この形のセットを作る
• 引数のある関数を呼ぶときも、⊕ で「呼ぶ前に」の行を足せる。 今までは引数の無い関数だけだった。 引数に繰り返しの番号、「呼ぶ前に」の行に乱数を入れた変数、のように混ぜて渡せる（Ruby では r = rand(100..500) → 光る(i)）。 定義を替えて引数の数が変わっても、引数に入れてあったものと「呼ぶ前に」の行は残る（無くなった引数の口の分は消える）
• 直した不具合: ⊕ / ⊖ を押すと、「呼ぶ前に」の行に打ってあった数が 0 に戻っていた。 行を作り直すときに、つないだブロックと変数は控えていたが、打った数（影のブロック）は控えていなかった。 v = 5 と書いた行が、⊕ を押しただけで v = 0 になっていた。打った数も控えて戻すようにした
• 色の欄にあった 0〜255 などの範囲の決まりは無くなった。範囲の外の数は、コンパイラが今までどおり扱う （赤・緑・青は 256 で割った余り、％と明るさは端に寄せる）
• コンパイラ（lib/urb/compiler.js）を 1 か所直した。 書き込む前に数を決める計算が、かっこ（(番号 - 1) * 10）を 読めなかった。かっこの中が式 1 つなら、その値を使う。ふつうの変数が入っていれば今までどおりエラー。 URB EE Lab にも効く（かっこの中が数だけの式は、今までより短い命令になる）
• 前に保存した作品は、開くときにページが自動で今の形に直す （数の欄 → 数のブロック、繰り返しの番号・関数の引数・セットの変数の欄 → 番号・引数・変数のブロック）。 丸い口に置いてあった「変数」の引き出しの〔番号〕は、そのまま使える。 作品・.rb・ギャラリー・ほかのタブからの貼り付けのどれから開いても同じ。ファームウェアは変わらない
• ブラウザで、組んだブロックの Ruby がコンパイラを通ること、引き出しのマウス操作、古い作品の読み込みを確かめた。 基板ではまだ試していない

2026-10-07 (3)

URB Block Lab — 「記録の配列」（電源を切っても残る配列、Ruby の $ の配列）を足した

• 今までの「配列」は $ の無い配列（v = Array.new(24)）しか作れなかった。Ruby では def の中から外の ふつうの変数は見えないので、展開関数の中で配列を使うと「基板に書き込む」でコンパイルエラーになっていた
• 「変数」の一覧に「記録の配列 〔点数〕 を 〈4〉 個 つくる」「記録の配列 〔点数〕 の 〈0〉 番 を ⟨0⟩ にする」 「記録の配列 〔点数〕 の 〈0〉 番」の 3 つを足した。Ruby では $名前 = Array.new(個数)・$名前[i] = 値・$名前[i]。 $ の変数は def の中からも見えるので、展開関数の中で使える
• Ruby の名前は記録と同じ作り方（日本語の名前は rec ＋ハッシュ）。記録と同じ名前にはならない
• 宣言は「つくる」を置いた場所に出す（記録のように先頭へは集めない）
• 「記録と配列は合わせて 6 個まで」の数に、記録の配列も入れた。基板が範囲外の番号を知らせてきたときも、 画面の名前（「点数」など）で出す
• コンパイラとファームウェアは変わらない（$ の配列はもともと読めた）

2026-10-07 (2)

URB Block Lab / EE Lab — 動いているプログラムがあると、先に「緊急停止」を押さないと書き込めなかった

• 「ずっと」の中に wait_ms があるプログラムが動いていると、「基板に書き込む」がほとんどの場合タイムアウトした （wait_ms 500 を並べた NeoPixel のアニメーションでは、一度も書き込めなかった）
• 原因: 基板の受け取り口は 1 つで、次のコマンドが来ると上書きされる。VM が STOP を見るのは命令と命令の間だけで、 wait_ms の delay() の最中は見ない。ページは STOP の 300 ms 後に OPEN_W を送っていたので、待ちの残りが 300 ms より長いと OPEN_W が STOP を上書きし、VM は止まらないまま OPEN_W を読み捨てていた。 「緊急停止」を先に押すと通ったのは、STOP のあとに何も送らないので上書きされなかったから
• lib/urb/eeprom.js の sendProgram を、止まったのを確かめてから書き込むようにした。 まず OPEN_R で待ち受け中かを見て（止まっていれば応答が来る）、動いていれば STOP を送り、 基板から「止まりました」（0x44 の 0x19）が届くまで STOP 以外を送らずに待つ。 70 秒たっても止まらなければ、書き込まずに知らせる（wait_ms の最大は 65,535 ms）
• eeprom.js は 2 ページで共有しているので、URB EE Lab の「EEPROM に送信」にも効く
• 「■ 緊急停止」のボタンの説明から「書き込めないときにも使います」を消した
• ファームウェアは変わらない。実機で、アニメーションを動かしたまま緊急停止なしで書き込めることを確認した

2026-10-07

URB Block Lab — 4×4 の NeoPixel に絵を描くブロック「4×4 に絵を表示」と、テープのつなぎ方を決める「NeoPixel の並び」を足した

• NeoPixel の引き出しの「8×8 に絵を表示」のすぐ下に置いた。作りは 8×8 のパレット版と同じ （色 8 つ・ずらす・回す・裏返す・この絵からはじめる・絵を消してはじめから）
• テープは縦に折り返してつないである前提（0 番は左下。左の列は下から上、次の列は上から下）
• 8×8 と同じフィールド（field_neo_paint）に size: 4 を渡して使う。ずらせる量・回す・裏返すは 1 辺のマス数から決めるようにした。8×8 の値（64 文字＋@dx,dy）は変わらない
• 8×8 のテープのつなぎ方を 4×4 と同じにした（「8×8 に絵を表示」と、引き出しから外してある 2 色の「8×8 に表示」の両方）。0 番は右上・横に折り返しだったのを、0 番は左下・縦に折り返しに変えた。 パネルを横につないでいくので、縦に折り返す並びのほうが一般的なため。 今までの並びでつないだ 8×8 は、そのままだと絵が崩れて出る（左上と右下を結ぶ斜めの線で折り返した形になる）ので、 次の「NeoPixel の並び」で「右上」「横」をえらぶ。保存した作品の絵（マスの値）はそのままで、 出る Ruby の LED の番号だけが変わる。新しい並びは実機では確かめていない
• 「NeoPixel の並び 0 番は 〔左下〕 〔縦〕 に折り返し」を足した。 絵のブロック（8×8・4×4・2 色の 8×8）の テープのつなぎ方を決める設定。0 番の角（左下・左上・右下・右上）と、折り返す向き（縦＝1 列ずつ・横＝1 行ずつ）の 8 通りから選ぶ。置かないときは左下・縦
• 並びは 1 つで絵のブロック全部に効く。Ruby を作る前にページが先に探すので、絵のブロックより後ろや 「ずっと」の中に置いても効く。数えるのは動くところ（先頭の「最初だけ」「ずっと」と関数の中）にある 無効でないブロックだけ。2 つ以上あると最初の 1 つが効き、Ruby の先頭に警告コメントが出る
• LED の個数は、4×4 だけなら 16 個、8×8 もあれば 64 個に上げる
• ファームウェアは変わらない（出る Ruby は今までと同じ fill / set / show / auto）

2026-10-02 (3)

URB Block Lab — 基板のファームウェアが古いと、プログラムが始まるときに知らせる

• 24FC256 への対応（下の 2026-10-02 (2)）は、基板のファームウェアを書き込み直さないと効かない。 古いままの基板に気づけるよう、ページが自分から知らせるようにした
• ファームウェアは、プログラムを始めるたびに送る LOG_UAP_START（0x10）の 2 バイト目に、 ファームウェアの版の番号を載せる（今回が 1）。ページは、同梱ファームウェアの版 （blockBin.js の fwRev）より小さければ、ログに「基板のファームウェアが古い版です…」と出す
• 版を送らない今までのファームウェアは、同じ位置が 0 なので、同じ比べ方で古いと分かる
• 版の番号の元は uiapruby-ee.html の BLOCK_FW_REV。URB Block Lab のファームウェアの動きを変えたら 1 つ上げる。 tools/build-block-bin.mjs は、生成した ino に出た番号を blockBin.js に写す
• 分かるのはプログラムが始まったとき（「基板に書き込む」「▶ 再開」、ページを開いたまま USB を挿したとき）。 つないだだけでは分からない。引き出しが自分から開くのは最初の 1 回だけ
• ファームウェアの大きさは 15,528 B のまま。URB EE Lab の ino は変わらない
• 実機で確認した。前のファームウェアの基板に書き込むと知らせが出て、 ⚙ 準備 でファームウェアを書き込み直すと出なくなる

2026-10-02 (2)

URB Block Lab — 24FC256 でも動くようにした（変数の番地の割り当てを石で分ける）

• 24FC256（32 KB）で動くようになった。 今までは CAT24M01WI 用のスロット（21,416 B × 6 個）を そのまま使っていたので、24FC256 では 2 個目のスロットの途中から先が EEPROM の外に出ていた。 EEPROM に置く変数が 3 個以上になると（ふつうの変数だけなら 5 個目から）、EEPROM の外を読み書きしていた
• 24FC256 / 24FC512 では、変数の番地の割り当て（アドレスマップ）を新しくした。 変数領域の先頭 888 B に 6 枠（1 枠 = 変数名 20 B + 128 B）を置き、配列の要素はその後ろに 変数番号の順で隙間なく並べる。配列を使わない変数のために 1 個あたり 2 万 B を空けておく作りをやめた。 配列に入る数は、24FC256 で 5,410 個、24FC512 で 13,602 個（合計）
• CAT24M01WI は今までどおり。 番地の割り当ても動きも変えていない
• 石の見分けに 24FC512 を足した。 0x51 が応答しなければ、0 番地と 0x8000 番地の 8 B を読み比べる。 24FC256 はアドレスの最上位ビット（A15）を無視するので同じ中身が読め、24FC512 では別の中身が読める。 見分けるのは、電源を入れたときではなくプログラムを始めるたびに変えた （読み比べには 0 番地にプログラムの頭が要る。空の基板に初めて書き込んだときも見分けられる）
• 配列が入りきらないときは、始める前に止める（24FC256 / 24FC512）。 今までは検査が無く、 「配列 を 65535 個 つくる」がそのまま通って、始まるときの 0 クリアが領域の外まで書く作りだった。 基板は変数の情報を読んだ直後・0 クリアの前に合計を調べ、入りきらなければ何も書かずに止まって ログ 0x21 で知らせる。ページも、基板が石を知らせてきたあとは書き込む前に調べる
• 配列の番号が個数の外なら、その場で止める（24FC256 / 24FC512）。 ログ 0x22 で、どの配列の何番かを知らせる。 今までは番号を調べず、配列の外の番地を読み書きする作りだった
• $ の付く配列は、名前・先頭番地・要素数が同じときだけ値を残す（24FC256 / 24FC512）。 新しい割り当てでは前の配列の個数で位置がずれるので、名前だけでは残さない。 URB Block Lab のブロックには $ の付く配列が無いので、ここは実機で確かめていない
• この 3 つのチェックは、まだ CAT24M01WI には入れていない。 24FC256 で動きを固めてから移す
• URB EE Lab は変えていない。 新しい割り当てとチェックは URB Block Lab のファームウェアにだけ入る。 URB EE Lab が生成する ino は、24FC256 / CAT24M01WI 0x50 / 0x52 の 3 石 × 8 構成で、変更前と同じ
• 調べていて分かったこと: CAT24M01WI の 6 個目のスロットが、容量をはみ出している。 tools/build-block-bin.mjs は変数領域の先頭を 10,240 に差し替えるが、スロットの大きさは 2,560 のときに計算した 21,416 B のまま。6 個目は 117,320〜138,735 番地で、131,072 B を 7,664 B 超える。 6 個目の EEPROM 変数が 3,433 個より大きい配列のとき、超えた分がプログラム領域に書かれる。 CAT24M01WI は今までどおりにする段階なので、まだ直していない
• 必要な EEPROM の書き方を直した。 ⚙ 準備 の「24FC256 の基板では動きません」、ページの説明文、 SNS のカード（og:description / og:image:alt）、バナー（urb_block_banner.png）の右下の注意書き、 トップページのカードの注記を、「CAT24M01WI または 24FC256」 にした
• ファームウェアは 15,088 B → 15,528 B（残り 856 B）
• 実機で確認した。 24FC256（ブレッドボード）: 石が 24FC256 と判定されて URB EE Lab に渡る／ 変数 7 個＋配列 10 個／記録／配列の読み書き／4 個の配列の 10 番でエラー／5,410 個は通り 5,411 個はエラー。 CAT24M01WI の基板: 今までどおり動く。24FC512 は石が手元に無く、未確認

2026-10-02

URB Block Lab — EEPROM の石を、基板が起動時に自動で見分ける

• URB Block Lab のファームは、起動時に I2C の 0x51 が応答するかを見て、 応答すれば CAT24M01WI、しなければ 24FC256 と判定するようにした。 CAT24M01WI は 0x50 と 0x51 の 2 つを使い、24FC256（A0 = GND）は 0x50 だけを使うため
• 判定した石は、プログラムを始めるたびに送る LOG_UAP_START（0x10）に載せてページへ知らせる。 電源を入れたときに 1 回だけ出る LOG_EE_OK（0x01）ではなく 0x10 にしたのは、 あとから開いたページにも書き込み・再開のたびに届くようにするため
• 「UIAPruby で編集する ↗」で URB EE Lab へ渡す石は、焼いたファームの記録ではなく、基板が知らせてきた石になった。 そのタブでまだ書き込みも再開もしていないときは石を渡さず、EE Lab の選択欄はそのまま（手動で選ぶ）
• 石の自動認識は URB Block Lab だけ。URB EE Lab は選択欄で選ぶので、 EE Lab のファームは変わらない（24FC256 / CAT24M01WI 0x50 / 0x52 の 3 石 × 8 構成で、生成する ino が変わらないことを確かめた）
• 変数の置き方は、今までどおり CAT24M01WI に合わせたまま。24FC256 用の置き方はまだ決めていない
• ファームウェアは 15,064 B → 15,088 B。前の版のファームウェアは石を知らせないので、 「⚙ 準備」でファームウェアを書き込み直すまでは、EE Lab へ石が渡らない
• CAT24M01WI の基板で、EE Lab に CAT24M01WI として渡ることを実機で確認した。24FC256 の側は未確認

2026-09-29 (3)

URB EE Lab / URB Block Lab / URB Lab（SD 版）— センサの値などを 3 つ目以降の変数に入れるとエラーになっていた

• 数値変数は R0/R1 の 2 つまでがレジスタで、3 つ目からは EEPROM 変数（SD 版は SD 変数）になる。 ところが次の代入はレジスタにしか入れられず、R0/R1 が埋まっていると「数値変数は最大 2 つです (R0/R1)」で止まっていた。
  • v = sonar.read / v = sensor.read
  • d = t.ms / d = t.us
  • b = ser.read（EE 版のみ）
  • v = rand(...)
  • v = I2C.master_get(...)（SD 版は I2C.slave_get も）
  • v = 条件 ? x : y
• 正しく EEPROM / SD へ回していた v = arr[i] と同じ作りにそろえた。 レジスタが埋まっていれば一時レジスタで値を作り、VAR_STORE で EEPROM / SD 変数に書く。 必要なのは Ev / Ec（SD 版は Ve / Sv）だけで、ファームは変わらない
• $g = sensor.read のように $変数 に直接入れると、レジスタ扱いになって保存されていなかった。 ほかの $変数 と同じく、EEPROM / SD に保存されるようになった
• EEPROM / SD 変数を使えない構成では、何を選べば 3 つ目以降が使えるかをエラーに出すようにした
• 直したのは docs/lib/urb/compiler.js（URB EE Lab / URB Block Lab）と docs/uiapruby.html（SD 版）。 両ページのサンプルは、直す前とコンパイル結果が変わらないことを確かめた
• compiler.js 側は、v6 = sonar.read を 3 つ目以降の変数に入れるプログラムで、 基板への書き込み・動作まで実機で確認した。SD 版はコンパイル結果の確認のみ

2026-09-29 (2)

URB EE Lab / URB Block Lab / URB Lab（SD 版）— x = x の代入で命令を出さない

• URB Block Lab の「呼ぶ前に」で、関数が読む変数に同じ変数を入れると、Ruby に v2 = v2 が出る。 コンパイラはこれを一時レジスタ経由のコピーにしていて、値は変わらないのに 1 行で 4 命令・18 B を使っていた
• 左右が同じ変数で、その変数がすでにあるときは、命令を出さないようにした。 レジスタの変数・EEPROM / SD 変数（$変数 を含む）・文字変数・配列変数（arr = arr）が対象。 配列は 0 番目の要素を読んで書き戻す 2 命令、文字変数は自分へのコピー 1 命令が出ていた
• 要素どうしの arr[1] = arr[1] は対象外で、今までどおり命令が出る。 まだ値を入れていない変数の x = x も、今までどおりエラーになる
• 直したのは docs/lib/urb/compiler.js（URB EE Lab / URB Block Lab）と docs/uiapruby.html（SD 版）。 確認はコンパイル結果のみで、実機ではまだ

2026-09-29

URB EE Lab / URB Block Lab / URB Lab（SD 版）— duty / angle / shift に 3 つ目以降の変数を渡すとエラーになっていた

• 数値変数は R0/R1 の 2 つまでがレジスタで、3 つ目からは EEPROM 変数（SD 版は SD 変数）になる。 ところが pwm.duty(v)・servo.angle(v)・np.shift(v) はレジスタの変数しか探していなかったため、 EEPROM / SD に置かれた変数を渡すと「引数はリテラルまたは数値変数のみ対応」で止まっていた
• URB Block Lab の「展開関数」で「呼ぶ前に」の行を足すと変数が増えるので、 関数の中で duty を呼ぶと起きやすかった
• 変数をいったんレジスタに読み込んでから渡すようにした（gpio.write(v) と同じやり方）。 ファームは変わらない
• angle は、読み込んだレジスタをそのまま計算に使う。別にコピー先を取ると、 R0/R1 が埋まっているときにコピー先と計算用のレジスタが同じ R3 に重なるため
• 直したのは docs/lib/urb/compiler.js（URB EE Lab / URB Block Lab）と docs/uiapruby.html （SD 版。shift は SD 版に無い）
• compiler.js 側は、コンパイル・基板への書き込み・動作まで実機で確認した。 SD 版はコンパイル結果の確認のみ

2026-09-28 (2)

URB EE Lab / URB Block Lab — ピン 6 に出したはずの PWM が、ピン 12（A3）に出ていた

• 生成するファームの pwmSetDuty() に、ピン 6（PC4 / TIM1_CH4）の分岐が無かった。 ピン 12（PD2 / TIM1_CH1）用の else に入っていたため、PWM.new(6) やブロックの 「モーター ピン 6」で、ピン 12 に出ていた
• SD 版ではピン 6 が SS 専用で PWM に使えなかったので、分岐が作られないまま EE 版に残っていた。 EE 版はピン表でもブロックの選択肢でも、ピン 6 を PWM に使えることになっていた
• ピン 6 の分岐を足し、配布ファームのうちサーボ版 3 本と URB Block Lab を作り直した。 大きさはサーボ版 +36 B（15,924 / 15,936 B）、Block Lab +40 B（15,064 B）。 docs/sketches/UIAPrubyEeVmPw にも同じ漏れがあったので直した
• ブザー版 3 本は変わらない。Tone はボードパッケージの PWMmin.h を使っていて、 こちらは元からピン 6 に対応している
• URB Block Lab で、ピン 6 に PWM が出ることを実機で確認した

2026-09-28

URB EE Lab / URB Block Lab / URB Lab（SD 版）— ピン 11 が IO として働いていなかった

• ボードパッケージ v1.2.14 までは、ピン 11（PD1）がデバッグ用の SWIO のままで、 pinMode() しても GPIO として働かなかった（digitalWrite(11, HIGH) でも 0V）。 v1.2.15 で、pinMode() が PD1 のとき SWIO を自動で切り離すようになった
• **配布ファームを v1.2.15 で作り直した。**URB EE Lab の 6 本と URB Block Lab の 1 本。 大きさは 1 本あたり +20〜24 B（ブザー版 16,352 B で残り 32 B）
• 自分でビルドする場合の必要バージョンを v1.2.15 以降に引き上げた。 README・uiapruby.html・uiapruby-ee.html の表記と、生成する .ino の先頭コメント、 docs/sketches/ の URB スケッチ 29 本の先頭コメント （EE 版 13 本は、前から v1.2.12 のままでページとずれていた）

2026-09-27

URB Block Lab / EE Lab / Lab（SD 版）— 基板を選ぶ画面に UIAPduino 以外が出ていた

• 接続のフィルタが usagePage: 0xFF00 だけだったため、PC 内蔵の HID 機器 （実際に出たのは「HIDI2C Device」）も候補に出て、選べてしまっていた。 選ぶと「つながりました: HIDI2C Device」と出たあと、書き込みのたびに エラー: Failed to write the feature report. になる
• ほかのページと同じく VID/PID（1209:D004）で絞るようにした。 lib/urb/eeprom.js の connect() / attach() と docs/uiapruby.html の requestDevice()
• 一度許可した別の機器は、ページを開いたときの自動接続（attach()）でも選ばれなくなる

2026-09-21

HID 接続チェック（hid-test.html）を足した

• 基板がつながらないときに、どこで止まっているかを切り分けるための診断ページです。スケッチは要りません
• 講習で URB Block Lab を使ってもらったとき、ファームウェアの書き込みは全員できたのに、 「基板に書き込む」でデバイスを選ぶダイアログが出ない PC がありました。 DevTools にコードを貼ってもらう手順書では、allow pasting の壁や、1 回の貼り付けで requestDevice を 2 回呼ぶとユーザー操作の期限が切れて 2 回目が空になる事故がありました。 URL を開いてボタンを 1 回押すだけで同じことが分かるように、ページにしました
• ページを開いた時点で getDevices() を自動で実行し、許可済みの機器を出します（0 件ならそう出ます）
• ボタンを押すと requestDevice({ filters: [] }) を 1 回だけ実行します。絞り込まないので、ダイアログがそもそも出るかが分かります
• 機器の vendorId / productId（10 進と 16 進）と usagePage/usage（正常な UIAPduino は 0xFF00/0x0001）、 失敗したときの error.name と error.message を画面にそのまま出します
• 生の値を並べるだけでは、読む人が知っている前提になるので、結果を判定するページに作り直しました。 各段に判定（緑・青・黄・赤・灰）と次にやることを出し、冒頭に使い方と UIAPduino の 2 通りの挿し方 （ふだん 1209:D004／書き込みモード 1209:B803・OS の画面では「32V003」）を載せました。 書き込みモードは異常ではなく、ファームウェアを書き込むときの正しい状態として判定します
• 「④ 開けるか試す」を足しました。「選べる」までしか見ていなかったので、開くときに初めて出るエラー （ほかのアプリが使っている等）が見えませんでした。開いてすぐ閉じるだけで、何も書き込みません
• **知らない番号の機器は「異常」と言いません。**このページが一人歩きして、UIAPduino 以外の機器を調べに来る人もいるためです。 1209:D004 は arduino_core_ch32、1209:B803 は UIAP が付けた番号で、同じ CH32V003 でも別の基板・別のコアでは番号が違うことも書きました
• 巻末に「しくみ」と「結果の早見表」を折りたたみで置きました。表題は「WebHID 列挙テスト」から「HID 接続チェック」に（ファイル名は hid-test.html のまま）
• 文章が多すぎて誰も使わない、という指摘を受けて、表を「簡易チェック」だけにしました。 「チェックする」を 1 回押すと、ブラウザ → 機器を選べる → 機器を開ける を続けて行い、3 行の ✔／！／✖ と「OK」だけを出します。 つまずいたときだけ、その段のくわしい説明を自動で開きます。説明はすべて「くわしく」の折りたたみの中に移しました
• **入口で案内を変えました。**URB Block Lab の「⚙ 準備」から来る人のほとんどは、これからファームウェアを書き込む人です。 それなのに冒頭で「ボタンを押さずに挿してください」と、逆の案内をしていました。 「⚙ 準備」のボタンは hid-test.html?mode=boot を開き、ページはこの印を見て、書き込みモード（32V003）を正解として案内・判定します。 印の無いとき（トップページや Discord に貼ったリンク）は、2 通りの挿し方を両方出します。 「⚙ 準備」の節の説明も、「基板に書き込む」ではなく「ファームウェアを書き込む」でつまずいた人向けに書き直しました
• トップページの「デバッグ / ユーティリティ」に 3 枚目のカードとして載せました
• URB Block Lab の「⚙ 準備」の一番下に「基板がつながらないとき」の節と「HID 接続チェックを開く」ボタンを足し、 このページへ案内しました（ボタンの見た目は「基板のファームウェアを調べる」とそろえています）

URB Block Lab — 「⚙ 準備」のダイアログを直した

• 開くと先頭が隠れていた。 開いた瞬間にブラウザが最初のボタン「ファームウェアを書き込む」へフォーカスを移し、 そこまでスクロールするので、「はじめの準備（大人の方へ）」と手順が上に隠れていました。開いた直後に先頭へ戻します
• 外側をクリックしても閉じるようにした。 これまでは「閉じる」か Esc でしか閉じませんでした。 ただし、ファームウェアの書き込み中・調べている最中は閉じません（進み具合が見えなくなり、終わったと思って USB を抜かれるため）。 ダイアログの中で押して外で離したとき（文字を選んでいた等）も閉じません

2026-09-19

URB Block Lab — 子どもたちに使ってもらった結果から、お絵描きブロック（パレット版）を直した

• 色の見本を大きくした。 面の色の列が 20px と小さく、子どもはブロック本体の「いろ」を 押しに行っていました。マスの右に 40px の見本を 2 列 × 4 段で並べ、えらんでいる色は太い枠で少し大きく見せます。 面を開いている間は、ブロック本体の「いろ」とボタンを薄くして押せなくしました
• 真っ白から描きはじめる。 子どもはみんな、最初に白で塗りつぶしていました。 色の並びを 白・赤・橙・黄・緑・青・紫・けす に変え、0 番（何も描いていないところ）を白にしました。 開いたときに持っている色は青です
• 「全部消す」を「絵を消してはじめから」に変えた。 ずらしたあとに押すと、見えなくなっていた絵まで消えて 驚きました。ずらしも戻ることが伝わる名前にしました。色は戻しません（同じ色で描きなおせるように）
• 黒を「けす」にした。 「黒くない」と言われました。黒は消灯なので、お絵描きの黒にはなりません。 明るさ 0 の色は、どの番号でも ✕ の「けす」の見た目にしました（送る値は今までどおり 0,0,0）
• 絵を動かすボタンを足した。 右にずらした絵を 1 枚ずつ描いている子がいました。 十字でずらす（8 マスまで。はみ出た分は見えないだけで、戻すと出てくる）、↻ で右に 90 度、 ⇋ ⇅ で左右・上下のミラー、「この絵からはじめる」で見えている絵を元にした新しいブロックを作ります。 ずらして空いたマスは斜線で、描けません。ファームウェアは変えていません（ページが絵を作って、今までどおり送るだけ）
• 2 色の「8×8 に表示」は、今日使った子がいなかったので引き出しから外しました（定義は残してあります）
• 前の版で保存した作品は、色を作品の中に持っているので、見た目も LED の色も変わりません （黒だったところ＝前の版の何も描いていないところと黒は、画面では「けす」の見た目になります）

2026-09-18（2）

URB Block Lab — 色を 8 つ使って絵を描くブロック「8×8 に絵を表示」を足した

• 2 色の「8×8 に表示」はそのまま残し、パレットで描ける版を別に足しました
• マスが覚えるのは色の番号だけです（0〜7 を 64 文字）。色はブロックに並べた 8 つの色えらび（いろ）が持つので、描いたあとに色を変えると絵の色も変わります。 面を開くと下に色の列が出るので、えらんでからマスを押します（なぞってまとめて塗るのも同じ）
• 色の初期値は 黒（消灯）・白・赤・橙・黄・緑・青・紫 です
• np.fill は「全部塗り」しかできません（Ruby 側は fill(r, g, b) の 3 引数のみ）。 そこでいちばん多く使った色だけを fill でまとめ、残りを 1 マスずつ np.set で置きます。 同じ色を 2 つの番号に入れている人がいるので、番号ではなく出す RGB で数えています
• 実測：りんごの絵（3 色）が 175 B、全部同じ色なら 25 B、8 色を総当たりにした最悪で 305 B。 プログラム領域は 10,240 B なので、最悪でも 33 枚ぶん入ります
• ファームウェアは変えていません。np.fill / np.set / np.auto / np.show はすべて既存の命令です

URB Block Lab — マスを押したまま動かすと、次のキーボード操作が 1 回無視されていた

• 8×8 の面は、マウスの pointerdown で塗ったあとに来る click を「1 回捨てる」印で よけていました。押したまま別のマスへ動かすと、押したマスに click が来ないので 印が残ったままになり、次に Enter / Space で押したマスが塗られませんでした
• 印をやめ、click の detail が 0（＝キーボードから出た click）のときだけ塗るようにしました。 2 色版・パレット版の両方に入れています

2026-09-18

URB Block Lab — 色えらび・8×8 の面が、ブロックの下ではなく「ずっと」の列の下に出ていた

• 「ずっと」の中にブロックを積むと、押した面が列ぜんぶの下（入りきらないときは画面の上）に 飛んでいました。8×8 のフィールドで測ると、本当の位置は 上 374 / 下 441 なのに、 Blockly が置き場所に使った値は 上 373 / 下 714 でした
• 原因は Field.getScaledBBox() です。フィールドに枠（borderRect_）が無いと ブロックの高さ・幅で代用しますが、その高さは getHeightWidth() で 下につながったブロックを全部含みます。このページの自前フィールド（色えらび・8×8）は どちらも枠を持っていないので、両方ともずれていました
• getScaledBBox() を、自分が描いた図形の大きさを返すように差し替えました。枠を作る手もありますが、 Blockly の .blocklyEditableField > rect { fill:#fff } が見本の下に白く覗くので、 見た目を変えないこちらにしています
• あわせて、8×8 のマスとマスのすき間を押すと下のブロックに抜けて、ブロックが動き出していました。 透明な台を 1 枚敷いて、四角の中ならどこを押しても面が開くようにしました

URB Block Lab — ブロックの説明（吹き出し）の折り返しを直した

• 「テープは折り返してつないである前提です（0」で行が切れるなど、読点でも句点でもない 位置で改行されていました
• 原因は Blockly 側です。吹き出しを描く前に wrap(説明, 50) をかけ、返ってきた行を 1 行 1 個の <div> にしますが、この wrap は /\s+/ で切って組み直すので 半角スペースのある場所にしか改行を入れられません。日本語の説明にスペースは 数字や英字のまわりにしか無いため、そこで折れます。しかも切れ残った行は 50 字 （全角なら 100 字ぶんの幅）になり、そのあと画面の幅でもう一度折り返されるので、 二重に折れて不揃いになっていました
• Blockly.Tooltip.setCustomTooltip() で中身の描き方を差し替え、wrap を通さずに 文字をそのまま入れるようにしました。折り返す場所はブラウザが決めます （ブラウザは「（」を行末に置かない・「。」を行頭に置かないといった日本語の決まりを知っています）
• 幅は CSS の .blocklyTooltipDiv { max-width: min(30em, calc(100vw - 32px)) } で決め、 line-break: strict を足しました。短い説明はこれまでどおり中身なりの幅に縮みます
• Blockly.utils.string.wrap を差し替えても効きません。 圧縮版の呼び出し口は内部の関数を 直接見ていて、公開されている wrap はその写しだからです
• この変更はこのページのすべてのブロックの説明に効きます

URB Block Lab — 8×8 の NeoPixel に絵を描くブロックを足した

• NeoPixel の引き出しに 「8×8 に表示」 を足しました。ブロックの上に 8×8 の見本が乗っていて、 押すと 64 マスの面が開きます。マスを押すと裏返り、押したままなぞるとまとめて塗れます （micro:bit の「LED 画面に表示」と同じ操作です）

• 色は えがく色 / うしろの色 の 2 つで、どちらも既存の色えらび（色・鮮やかさ・明るさ）です。 色を変えると、ブロックの上の見本もその場で塗り直します。 「ついている / 消えている」と呼ぶと、消えているのに色を選べるのがおかしくなるので、 絵として見た言い方にしてあります（うしろの色の既定は黒＝消灯）

• テープは 64 個を折り返し（蛇行）でつないである前提です。0 番は右上で、上の行は右から左、 次の行は左から右へ進みます（実機で確かめた並び）。

  07 06 05 04 03 02 01 00
  08 09 10 11 12 13 14 15
  23 22 21 20 19 18 17 16
  24 25 26 27 28 29 30 31
  39 38 37 36 35 34 33 32
  40 41 42 43 44 45 46 47
  55 54 53 52 51 50 49 48
  56 57 58 59 60 61 62 63
  

  画面の (x, y) からテープの番号への変換（y が偶数なら y*8 + (7 - x)、奇数なら y*8 + x）は ブロック側で行うので、絵を描く人は折り返しを気にしなくて済みます

• 出る Ruby は np.auto = false → np.fill(うしろの色) → えがいたマスだけ np.set(番号, r, g, b) → np.show → np.auto = true です。64 マス全部を set にすると 320 B になりますが、 うしろの色を fill でまとめるので 6 + 5 × えがいた数 バイトで済みます （プログラム領域は 10,240 B。斜め線 8 個で 65 B、全部えがいても 331 B）

• np.auto をすでに「しない」にしてあるときは、auto の行を出しません（二重に止めないため）

• このブロックを置くと NeoPixel.new(64) で組み立てます。「NeoPixel を ◯ 個使う」で 64 より少なく決めていたときは、黙って書き換えると理由が分からないので、Ruby の先頭に 警告コメントを出してから 64 に上げます

• ファームウェアは変えていません。同梱ファームはもともと leds: 64（docs/lib/flasher/blockBin.js）で、 np.fill / np.set / np.auto / np.show はすべて既存の命令です

2026-09-16

URB Block Lab — OGP の説明文に、動く基板を書いた

• SNS のカードの説明が ブロックでつくる Ruby × 電子工作。UIAPduino を楽しく動かそう で、 UIAPduino さえあれば動くと読めていました。実際には EEPROM（CAT24M01WI、0x50/0x51）が要ります
• 条件が書いてあるのは ⚙ 準備（大人の方へ） の中だけで、リンクを見た人には届きません。 og:description と <meta name="description"> を ブロックをつなぐと Ruby になって、基板の中で動きます。動かすには UIAPduino と EEPROM（CAT24M01WI）が必要です。 にしました
• 基板に別名は付けません。 一度 URB Block 基板 という呼び方を README に書いていましたが、 誰も使っていない名前で、初めて見る人はそこでつまずきます。README からも消し、 CAT24M01WI の基板 のように、載っている石で言うようにしました
• バナー（urb_block_banner.png）の右下に ※ EEPROM（CAT24M01WI）も必要です を足しました。 もとからあった 3 つの文（「ブロックでつくる Ruby × 電子工作」「UIAPduino を楽しく動かそう」 「つくる・うごかす・ひろがる！」）はどれも正しいので、書き換えずに注意書きだけを足しています。 も が「UIAPduino のほかにも」を受けるので、離れた右下にあっても意味が立ちます
• 絵の大きさが 1731×909 から 1734×907 に変わったので、og:image:width / og:image:height を実寸に直しました
• og:image:alt に絵の中の文字を写しました。画像を出さない設定の人にも ※ の一行が届きます

URB Block Lab — ブロックに「?」ボタンを付けて、説明を読めるようにした

• 説明はもともと tooltip に日本語で入っていましたが、カーソルを止めてから 750ms 待たないと出ず、 少し動かすと消えて、同じブロックの上では二度と出ないため、実質読めませんでした
• ブロックの行の右端に「?」を足しました。押している間ずっと説明が出るので、落ち着いて読めます。 引き出し（ツールボックス）の中と、数値ブロックには付けていません（数はブロックとして見られていないため）
• ホバーでも出ます。止めてから 400ms に縮めました。Blockly の 750ms は圧縮版に数値が直接 埋め込まれていて Blockly.Tooltip.HOVER_MS を書きかえても効かないので、出す時刻だけこちらで持ち、 吹き出しそのものは Blockly.Tooltip.display() に描かせています
• 右クリックの「ヘルプ」は消しました。標準ブロック（もし・くりかえし等）だけが helpUrl を持っていて、 英語のドキュメントへ飛ぶためです
• 丸の地は吹き出しと同じ #feffcc。大きさは HELP_SIZE ひとつを変えれば、丸も字も位置も付いてきます

URB Block Lab — 「最初だけ」「ずっと」の 2 個目から先を無効にした

• これまでは先頭の 1 個だけを使い、2 個目から先は無警告で無視していました。置いた本人には、 なぜ Ruby に出ないのか分かりませんでした
• 2 個目から先はグレー（無効）になります。引き出しから出す・コピー貼り付け・複製・.rb の読み込み、 どの作り方でも同じです。生きているのは上にあるほうで、Ruby を作るときも同じ順で先頭を採るので、 色が付いているブロックと動くブロックが食い違いません
• Ruby の先頭にも # ⚠ 「ずっと」は 1 つだけです（2 つ目から先は動きません） と出ます
• 無効にした操作は「元に戻す」に積みません。積むと、取り消しても取り消せていないように見えるためです

URB Block Lab — ファビコンをパズルのブロックの絵にした

• これまでは全ページ共通の 🔌（favicon.svg）で、タブを見ても URB Block Lab だと分かりませんでした
• ヘッダのロゴ（images/UIAPduinoBlock.png）から緑と青のブロックだけを抜き出し、 images/urb-block-icon-32.png（32×32）を作りました。基板まで入れると 16px で穴がつぶれて、何の絵か分からなくなるためです
• ほかのページのファビコンは 🔌 のままです

URB Block Lab — 「と表示する」の出力が届いたら、下の引き出しを開くようにした

• これまで自動で開くのはエラーのときだけで、puts の出力は「▲ ログ / コンソール」を押さないと見えませんでした
• 「基板に書き込む」「▶ 再開」のあと、最初に出力が届いたときに開きます。 loop do の中で出し続けても開くのはその 1 回だけで、閉じれば次に書き込むか再開するまで開きません

URB Block Lab — タブをまたいでブロックをコピー / 貼り付けできるようにした

• Blockly のコピーはページの中に持つだけなので、別のタブには貼れませんでした
• Ctrl+C / Ctrl+X でコピーした中身を localStorage にも書き、Ctrl+V はそこから読むようにしました。 右クリックメニューにも「コピー」（ブロック）と「貼り付け」（机。右クリックした場所に置く）を足しました
• 変数の ID は書きません。 ID は作品に入ったまま受け継がれるので、同じ .rb を 2 つのタブで開くと 同じ ID ができます。ID を残すと、片方で名前を変えた変数に黙って付いてしまうためです。 名前と種類だけにして、貼り付け先で名前で探し直します
• 同じ名前で種類が違う変数（ふつうの かず と記録の かず など）があるときは、貼る側を かず2 にずらします （すでにあれば かず3）。同じものを何度貼っても、同じ かず2 に付きます
• 関数を呼ぶブロックだけを貼って関数が無いときは、今までどおり Ruby の先頭に # ⚠ 展開関数「…」が ありません と出ます。同じ名前の関数を定義するブロックを貼ると 手順2 のようにずれます

URB Block Lab — .rb を別の名前で保存しても、作品名とタブの見出しが変わらなかった

• 保存ダイアログで選んだファイル名を、作品名に戻していませんでした（「.rb を開く」は戻していました）
• 保存が済んだら、ファイル名から .rb を外して作品名にするようにしました。 保存ダイアログが出るブラウザ（Chrome / Edge）だけです。ダウンロードとして保存されるブラウザでは、 ページが付いたファイル名を知ることができません

2026-09-15

URB Block Lab — SNS にリンクを貼ったとき、画像つきのカードが出るようにした

• Discord などに URL を貼ってもカードが出ませんでした。ページに OGP タグ（og:*）が無かったためです
• uiapruby-block.html に OGP タグと twitter:card（summary_large_image）を入れました。 X・Facebook・LINE・Slack・Discord など、OGP を読むサービスで同じカードになります
  • サイト名 UIAPruby ／ タイトル URB Block Lab | UIAPruby
  • 説明 ブロックでつくる Ruby × 電子工作。UIAPduino を楽しく動かそう
  • 画像 images/urb_block_banner.png（1731×909、新規追加）
• <title> を URB Block Lab | UIAPduino から URB Block Lab | UIAPruby にしました。 タブの名前は開いた直後に JS が「作品名 | URB Block Lab」に書き換えるので見えませんが、 SNS は JS を動かさずにこちらを読むためです
• Discord などは同じ URL のカードをしばらく覚えていることがあります。 古い表示のままなら、URL の末尾に ?v=1 などを付けて貼ると読み直します

URB Block Lab — ギャラリー案内の絵から「♥24」などの数を消した

• 絵の中の作品カードに「♥24」「♥18」「♥12」が描かれていましたが、ギャラリーに「いいね」の数が付く予定はありません。 無い機能があるように見せないよう、ハートを消した絵に差し替えました（urb-gallery の一覧ページの絵と同じもの）
• images/urbgallery.png を 1448×1086 に、images/urbgallery-384.png を 384×288 に作り直しました。 384px 版は 256 色にしぼって約 36KB にしています
• 絵の縦横の比率が変わったので、uiapruby-block.html の <img> の高さを 307 から 288 にしました

2026-09-14 (3)

転送 — sendFeatureReport のリトライを 5 回から 10 回にした

• 別の PC で URB EE Lab の変数を全部読み出したとき、読み込みエラーが頻発しました
• lib/urb/eeprom.js の send() を、1 回目の送信とやり直し 9 回の合計 10 回にしました。 やり直しの前の待ちは 20 / 50 / 100 / 200 / 200 / 200 / 200 / 500 / 500ms です （倍々を続けると 10 秒を超えるので 200ms で抑え、最後の 2 回だけ長めに待つ）。 失敗が続いたときに諦めるまでの合計は、約 370ms から約 1.97 秒になります
• URB Block Lab の書き込み・停止・再開も同じ send() を使うので、同じく効きます

URB EE Lab — 変数の「全部読む」が途中で失敗しても、続きから読むようにした

• これまでは途中でエラーになると、それまでに読めた値を捨てて終わり、もう一度押すと最初から読み直していました。 そのため、エラーが出やすい PC では何度も押し直す必要がありました
• エラーで止まったら、読めた要素は残し、止まった要素の位置へ OPEN_R し直して続きを読みます。 読みかけの要素（4 バイトに満たない分）は捨てて、その要素の頭から読み直します
• 読み直しの前に 500ms 待ちます。位置を決め直す前に、遅れて届いた古い応答は捨てます
• **同じ位置で 10 回続けて失敗したら諦めます。**1 要素でも進めば数え直すので、ときどき失敗しながら 進んでいる間は止まりません。諦めたときも読めた分は表示し、「[n] 番目で止まりました」と出します
• 止まったあと（「中止」も含む）、開始位置を変えずにもう一度「全部読む」を押すと、止まった要素から読み足します。 最後まで読み足せば、一度で読めたときと同じ結果になります
• ⚠ プログラムを動かしたまま読むと、前半と後半で時点のずれた値がつながることがあります。 正確な値が欲しいときは、STOP してから読んでください

2026-09-14 (2)

URB Block Lab — 基板に入っているファームの版を調べられるようにした（大人の方へ）

• ⚙ 準備 に 「基板のファームウェアを調べる」 を足しました。書き込みモードの基板から Flash を 16 KB 読み出し、 これまでに配ったファームと照合して、どの版かを出します。読むだけで書き換えません
• 古い版や URB EE Lab のファームウェアだったときは、普段の動作に戻さず書き込みモードのままにして、 「ファームウェアを書き込む」ボタンを示します。同じか一致しないときは、普段の動作に戻します
• URB Block Lab の画面に出る「ファーム」を「ファームウェア」に揃えました

URB Block Lab — つながっていなくても「■ 緊急停止」「▶ 再開」を押せるようにした

• これまでは基板につながっていないと押せず、一度も基板を選んだことがないブラウザでは 「基板に書き込む」（押すと作品が入って動き出す）以外に基板を選ぶ方法がありませんでした。 つまり、書き込まずにプログラムを止める手段がありませんでした
• つながっていないときに押すと、基板を選んでから STOP / RUN だけを送ります。書き込みはしません
• 一度選んだことのある基板は、ページを開いた時点に加えて USB を挿した時点でも自動でつながります

URB Block Lab — 下の引き出し（ログ / コンソール）を、エラーのときだけ自動で開くようにした

• これまでは「基板に書き込む」「■ 緊急停止」「▶ 再開」を押すたびに開き、ブロックが隠れていました
• 自分から開くのは、エラーを出したとき（コンパイルエラー・書き込み失敗・基板からのエラー報告など）と、 ほかのタブが書き込み中で断ったときだけです。それ以外は「▲ ログ / コンソール」で開いてください
• 照合は各ファームのサイズ分だけの SHA-256 で行います。書き込みは bin の範囲しか書き換えないので、 その後ろに前のファームの残りがあっても影響しません
• 照合表 docs/lib/flasher/knownBins.js は、tools/gen-known-bins.mjs が git の履歴にある blockBin.js / sketchBins.js の全版から作ります（いまは 15 件）。URB EE Lab のファームも見分けられます。 embed-bins.mjs と build-block-bin.mjs が最後にこれを呼ぶので、ビルドすれば照合表も更新されます
• 読み出しは rv003usb_reader.js に分けました。同梱のフラッシャから、停止・読み出し・アプリ起動の 3 つだけを写しています。フラッシャ本体は変えていません
• 実機で確認しました（Flash のロックを解除せずに読めること、読み終えたあと普段の動作に戻ること）

EE 版ファーム — 起動待ちをさらに短くして 1 秒にした

• 2.5 秒でもまだ長く感じたため、setup() の待ちを delay(2500) → delay(1000) にしました （URB EE Lab・URB Block Lab の両方）。同梱ファーム 7 本を作り直し、URB EE Lab の説明文も「1 秒」に合わせています

2026-09-14

EE 版ファーム — 電源オンからプログラムが走るまでの待ちを 2.5 秒短くした

• setup() の delay(5000) を delay(2500) にしました（uiapruby-ee.html の generateIno）。 電源を入れてから動き出すまでの間が長かったためです。 待ちのあとに EEPROM の確認と LED 3 回点滅（900 ms）が続くのは変わりません
• URB EE Lab と URB Block Lab のファームは同じ generateIno から作っているので、両方に効きます
• 同梱ファームを 7 本とも作り直しました（sketchBins.js の 6 本と blockBin.js の 1 本）。 サイズは 7 本とも変わっていません。URB EE Lab の ZIP で出る .ino も delay(2500) になります
• URB EE Lab の画面にあった「電源投入から 5 秒後に自動実行」の説明 2 箇所も書き換えました

URB Block Lab を本運用に — 「作成中」の透かしを外した

• 0x50/0x51 版の同梱ファームを、CAT24M01WI の基板（同じロットの 2 枚）で実機確認しました。 ギャラリーの「LED 点滅」「ボタンで LED ON」が書き込んで動くことを確かめています
• ページに重ねていた「作成中」の透かしを外し、README の状態を「✅ 公開中」にしました

転送 — 2 つのタブから同時に基板とやり取りしないようにした（URB Block Lab / URB EE Lab）

• 同じ基板は複数のタブが同時に開けるため、2 つのタブで「基板に書き込む」を押すと EP0 のコントロール転送がぶつかっていました
• lib/urb/eeprom.js に Web Locks（navigator.locks）による排他を入れました。 書き込み・RUN・STOP・変数ビューアの読み出しはロックを取ってから行い、 ほかのタブがやり取り中なら待たずに断ります（「ほかのタブが基板に書き込んでいます」）
• URB Block Lab の「基板に書き込む」は、書き込みから RUN までを 1 つのロックで行います。 間にほかのタブが割り込めません
• 持っていたタブが閉じたり落ちたりしても、ロックはブラウザが外します
• 応答の取り違えも直しました。 基板の応答は開いている全部のタブに届き、 やり取りしていないタブにも溜まっていました。そのタブで後から書き込むと、 ほかのタブの古い応答を自分の応答として読んでいました。いまは自分がやり取り中でない応答は捨てます
• 効くのは同じオリジン（tarosay.github.io）のページどうしだけです。 基板は 1 台の前提で、2 台つないでいても同時には書き込めません
• 偽の基板を差し込んで、2 つのタブで確認しました（断る・書き込みが最後まで通る・ 古い応答を流し込んでも書き込みが通る・EE Lab の変数ビューアと RUN も断る）

2026-09-08

コンパイラ — sensor.read などの結果が R0 決め打ちで、変数を壊していた

• print a0.read / puts sonar.read / warn sensor.read / warn t.ms / if button.low? / if ser.available? は、読み取り結果を 必ず R0 に入れてから 出力・判定していました。 R0 は 1 つ目の数値変数が座る場所なので、その変数が読み取り値に化けます
• 実際に出た症状: 10Hz で配列に記録しながら 5 秒ごとに print i と print a0.read を出すと、 次に表示される i が毎回「前回の A0 の値 + 50」になった。表示のたびに i が A0 の値へ 置き換わり、そこから 50 回（5 秒ぶん）足されていたため。$v0[i] の書き込み先も飛ぶので、 記録した配列自体も壊れる
• 空いているテンポラリレジスタ（R2/R3）を取るように 7 箇所を修正。逆アセンブルで ADC_READ pin=1 -> R2 / GPIO_READ pin=11 -> R2 になることを確認
• if button.low? も同じバグでした。R0 に変数がある状態でボタンを見るだけで壊れます
• 回帰確認: ページのサンプル 45 本すべてがコンパイル ✓ OK （Tn と Pw、Np と Nr は排他なので 2 パスに分けて実施）

転送 — sendFeatureReport にリトライを入れた

• 配列 600 要素の読み出しは CMD_READ を 83 回送ります。EP0 コントロール転送は単発で 失敗することがあり、1 回でも落ちると読み出し全体が エラー: Failed to write the feature report. で終わっていました
• 20ms 間隔 3 回では 300 要素あたりで落ちたため、20/50/100/200ms で 5 回（合計約 370ms）に しています。every_ms の待ちは wait_ms と違って中でコマンドを見ないため、 周期 100ms のあいだデバイスがコマンドを取らないことが背景にあります
• 24FC256 の上限いっぱい（1 配列 1,253 要素 × 3 変数、CMD_READ 519 回）の読み出しが 実機で通ることを確認

URB EE Lab — 変数ビューアに CSV 保存を足した

• 画面に出ている数値配列だけを対象に、絶対添字で揃えて縦に並べます。 変数ごとに開始位置も要素数も違う（20 要素の初期表示のままの変数と、全部読んだ変数が 混ざる）ので、値の無いところは空欄になります
• 改行は CRLF、先頭に UTF-8 BOM。Excel でそのまま開けます
• 値は画面と同じ 137.00 形式（Q16.8）

URB Lab（SD 版）にも同じ修正を入れた

• docs/uiapruby.html は lib/urb/compiler.js を共有せず自前のコピーを持っているため、 レジスタ破壊のバグがそのまま残っていた。EE 版と同じ 6 箇所を修正 （SERIAL_AVAILABLE は SD 版に無いので 6 箇所）
• sendFeatureReport のリトライも入れた。SD 版は変数ビューアが無いので読み出しの負荷は 無いが、プログラム転送は CMD_WRITE を何十回も送るので同じ取りこぼしが起きる
• 命令表の PRINT_REG に整数部 0〜255 の制限を明記し、API リファレンスの GPIO_READ pin, R0 / ADC_READ pin,R0 / ULTRASONIC_READ trig,echo,R0 を 「空きレジスタ」に修正（EE 版と同じ 4 箇所）
• 確認: サンプル 41 本すべてコンパイル ✓ OK。生成された .urb のバイト列で 18 00 02（ADC_READ pin=0 → R2）・19 00 02（PRINT_REG → R2）・ 04 0b 02（GPIO_READ pin=11 → R2）になっていることを確認

URB EE Lab — ピン 6 の「実機未検証」を外した

• ピン 6（PC4 / A2）の ADC を実機で確認。ピン表の注記を削除し、 ad-read サンプルのコメントの対応ピンに 6 を追加（0, 1, 6, 12, 15, 16）

2026-09-04

「記録」（電源を切っても残る変数）のブロックを足した

• 「変数」の一覧の下に 「記録 ◯ を ◯ 増やす」「記録 ◯ を ◯ に 書きかえる」「記録 ◯」 の 3 つを足しました
• 宣言は生成側が先頭に出します。 記録は宣言しないと読めず（warn $count だけではエラー）、 さらに宣言の順が変わると EEPROM のスロットがずれて記録が消えます。 ブロックを並べ替えても順が動かないよう、変数を作った順で先頭に固定しています
• 「最初だけ」で書きかえているときは、事実だけを知らせます。 記録は電源を入れるたびに その値になります。そうしたいのか記録を残したいのかは書く人が決めることなので、 警告コメントに「こうしなさい」は書きません。「もし」で囲ってあるときは、 電源のたびにその値になるとは限らないので出しません
• 記録に 0 以外の始まりの値を持たせたいときは、 「もし ⟨記録 ◯ = 0⟩ → 記録 ◯ を ◯ に 書きかえる」で書けます
• 名前は ASCII に落とします。 URB1 は変数名を 1 文字 1 バイト（charCodeAt(0) & 0xFF）で 書くため、日本語のままだと EEPROM の中で化けて、基板の変数一覧でも読めません。 英数字だけの名前はそのまま、日本語の名前は画面の名前から作った rec**** にします （同じ名前なら いつでも同じ記録になります）
• 記録と配列は合わせて 6 個まで（EEPROM 変数の枠）。超えたら警告コメントを出します

I2C マスターのブロックを足した

• 「I2C」のカテゴリを新しく作り、「I2C をはじめる」「アドレス ◯ の ◯ 番地を 〔変数〕 に 読む」 「アドレス ◯ の ◯ 番地に 〔変数〕 を 書く」 の 3 つを置きました。 通信（シリアル）とは分けています。今後、部品ごとのブロックが増える場所になるためです
• 値の換算を生成側で入れています。 VM の I2C は値だけ Q16.8 ではなく生のバイトなので （regs[dst] = (int32_t)val; / regs[src] & 0xFF）、読んだら ×256、書く前に ÷256 して、 アナログ入力や NeoPixel の色と同じ 0〜255 にそろえました。書くほうは元の変数を割ってから 掛けて戻します（一時変数を作ると R0/R1 を食うため）
• アドレスと番地は 16 進でも 10 進でも書けます（0x48 / 72）。範囲外や数でない入力は ブロックが受け付けません。0x50〜0x53 は基板の EEPROM が使っているので警告コメントを出します
• できるのは「レジスタから 1 バイト」だけです。Wiremin は n バイトもレジスタ番号なしの 送受信も持っていますが、VM に命令が出ていないためです

番号を変えながら回す繰り返しを 2 つ足した

• 「繰り返し」に 「〈1〉 から 〈3〉 まで 〔番号〕 を変えながら 繰り返す」（(1..3).each do |i|）と 「つぎの数を 順に 〔数〕 に入れて 繰り返す」（[10, 20, 30].each do |ms|。⊕ で個数を増やす）を 足しました
• for ではなく each を出します。 Ruby では for は勧められない書き方で、 for i in 1..3 と (1..3).each do |i| は同じ 21B です。Ruby タブは読み物でもあるので each にしました
• 番号の使えるところ／使えないところを確かめました。 wait_ms i / np.set(i, …) / a[i] = i / i * 100 は通り、if i > 1 と warn i は通りません （どちらも「Q16.8: 左辺は数値変数である必要があります」等。いったん変数に入れれば通ります）
• break / next はこの 2 つの中では使えません（展開されるため break outside of loop）。 loopTypes に登録していないので、置いてもブロック側が無効にします
• なお 3.times do |i| と 1.upto(3) はコンパイラが読めないので、番号が要るときはこの 2 つを使います

問いかけのダイアログを、ページの見た目にそろえた

• 変数の名前を作る / 変える / 使っている変数を消すときに出ていたのは ブラウザの prompt / confirm で、ページの中でそこだけ素っ気ない灰色の枠でした。 「準備」と同じ形の <dialog> を用意し、Blockly.dialog.setPrompt / setConfirm / setAlert でそちらへ通しています
• ページ自身の alert / confirm（8 か所）も同じ入れ物にしました。 .rb の保存・読み込み、URB EE Lab への受け渡し、ギャラリーからの読み込みです
• 文言もそろえました。「「%1」という名前の変数名をすべて変える：」→「「%1」の名前を変える」、 「%1か所で使われている変数 '%2' を削除しますか？」→「「%2」は %1 か所で使われています。消しますか？」など
• 見出しは「入力」「確認」「お知らせ」の 3 つ。お知らせには「キャンセル」を出しません。 Esc とキャンセルは同じ扱いです

配列のブロックを足した

• 「変数」の一覧の下に 「配列 ◯ を ◯ 個 つくる」「◯ の ◯ 番 を ◯ にする」「◯ の ◯ 番」 の 3 つを足しました
• 番号は 0 から。 Ruby も C も 0 始まりなので、ブロックに打った数字と出る Ruby の数字が一致します
• **名前は専用の型（Array）**にして、普通の変数の一覧に混ざらないようにしました
• 計算のブロックの中では使えません。 b = a[i] + 1 はコンパイラが読めません （a[i] = a[i] + 1 と if a[i] > 5 は読めます）。この形を見つけたら、 Ruby の先頭に警告コメントを出します
• 個数はブロックに打った数だけ（Array.new(n) は不可）、EEPROM 変数は全部で 6 個まで （配列 1 つで 1 個ぶん）です

繰り返しに while と break / next を足した

• 「⟨条件⟩ の間 繰り返す」（while。ドロップダウンで until）と 「繰り返しを抜ける / 次の繰り返しへ」（break / next）を「繰り返し」に足しました。 それまで「◯ 回繰り返す」しかなく、回数の決まらない繰り返しが書けませんでした
• 「抜ける / 次へ」は Blockly 標準のブロックです。 ただし標準の言い回し （「ループから抜け出す」「ループの次の反復処理を続行します」）は硬いので Blockly.Msg で差し替え、 「ずっと」と「〜の間 繰り返す」を loopTypes に登録しました。登録しないと、正しく置いても 標準ブロックが自分を無効にしてしまいます
• 「〜の間 繰り返す」は独自ブロックです。 標準の controls_whileUntil は 「繰り返す：続ける条件 ⟨…⟩」と、条件より先に言葉が来て日本語の順になりません

「関数」のブロックを追加した

• def を出すブロックが 1 つも無かったので、「関数」のカテゴリを足しました。 「展開関数を定義」（引数 0 / 1 / 2 個）・「展開関数を呼ぶ」・「判定を定義 ◯ は〈条件〉」 （def 名前? … return 条件）・「判定 ◯」の 6 個です
• 名前を「展開関数」にしたのは、この処理系の def がぜんぶインライン展開だからです。 TinyVM に呼び出し・戻りの仕組みが無く、本体は呼び出しの場所へ丸ごと写されます
• コンパイラの決まりは、ブロックの形のほうで守らせています。 引数は 2 つまで・ 渡せるのは数だけ（丸い差し込み口ではなく入力欄にしてあります）・ 値を返せるのは「もし」の条件だけ（return 1 行）です
• 引数の無い関数には ⊕ で「呼ぶ前に」の行を何行でも足せます。 呼ぶ前にその変数へ値を入れておくと、 写された本体がそのまま読みます。Ruby の引数ではなく同じ変数を共有しているだけなので、 いくつでも渡せる代わりに変数の枠を使います。「呼ぶ」ブロックは 1 つで、選んだ関数が 引数付きなら数の欄に、引数なしなら変数の行に変わります
• じぶんを呼ぶ形（再帰）は出しません。 写しが終わらずコンパイラが止まらなくなるので、 呼び出しの輪を先に見つけて、Ruby の先頭に警告コメントを出します。 名前が無い呼び出しも同じ扱いです
• 名前は 1 つずつ。 同じ名前を付けると後ろに数が付きます。名前を変えると、 それを指している「呼ぶ」も一緒に付け替えます

変数のブロックを直した

• 「〈変数〉に ◯ をセット」の丸い差し込み口に影のブロック（数の 0）を入れた。 空のままで数を打ち込めませんでした。Blockly 標準の変数の一覧は 「増やす」にしか影を付けないので、registerToolboxCategoryCallback('VARIABLE', …) で足しています （Blockly 13 の Variables.flyoutCategory() が返すのは XML ではなく JSON です）
• 「〈変数〉を ◯ 増やす」から Ruby が出るようにした。F['math_change'] が無く、 置いても何も生成されていませんでした。x = x + 1 の形で出します（コンパイラは += を読みません）
• ブロックで組んだ NeoPixel の虹を流すプログラムを実機で確認しました

2026-09-03

サーボの角度を変数で渡せるようにした／比べるブロックに数を打てるようにした

• 「サーボ ピン ◯ を〈変数〉度にする」を追加。rand で決めた角度に振れます。 角度が変数だとページ側で duty を計算できないので angle(変数) をそのまま出します （コンパイラは Q1 と frequency(50) を要求。どちらも満たしています）。 「サーボの設定」の幅は効かないので、置いてあるときは先頭に警告コメントを出します
• logic_compare と math_arithmetic の丸い差し込み口に影のブロックを入れた。 空のままだと数を打ち込めず、わざわざ「計算」から数のブロックを運ぶ必要がありました

URB ギャラリーから作品を開けるようにした

• 同梱ファームを 0x50/0x51 版に戻した。 tools/build-block-bin.mjs の CHIP を M01_52 から M01 にしてリビルド（15,004 B。残り 1,380 B）

• URB Block Lab に「作成中」の透かし。 0x50/0x51 版をまだ実機で動かしていないので、 そのことを画面に出す。確認できたら消す

• ツールボックスの「変数」の下に URB ギャラリーへの入口。 別のタブで開くので、 組みかけの作品から離れません

• uiapruby-block.html?rb=<id> に対応。 urb-gallery に 並べた作品を、新しい作品として読み込みます。題名は works.json から引きます

• 渡すのは作品の id だけで、URL は渡しません。取りに行く先はページ側が固定で持っています （GALLERY_BASE = '/urb-gallery/'）。同じ tarosay.github.io の中なので、CORS は関わりません

URB Block Lab を追加 — ブロックをつないで基板に書き込む

• 新ページ docs/uiapruby-block.html。 素の Blockly（Zelos レンダラ）でブロックを組むと Ruby が出てきて、URB EE Lab と同じ経路で EEPROM に書き込まれます。 プログラムが基板の中で動くことが Scratch / Smalruby との違いで、 ボタンの名前も「動かす」ではなく 「基板に書き込む」（動かすのは電源で、ボタンではない）
• コンパイラと WebHID 接続を docs/lib/urb/ へ切り出し。uiapruby-ee.html の中にあった 2,186 行を compiler.js / eeprom.js に移し、2 ページで共有します。 両方に同じコードを置くと片方だけ古くなるためです
• .rb で保存 / 読み込み。 出てくるのはそのまま動く Ruby で、末尾に # urb-block/1 … のコメントとしてブロックを deflate + base64 で畳んで入れてあります。 読み込みはそのコメントだけを見るのでブロックの位置まで完全に復元でき、 マーカーが無ければ読み込まずに知らせます。壊れていたときは元の状態へ戻します
• 作品を複数持てる。「新しく作る」は別のタブに白紙の作品を開きます。 1 つの作品を開けるのは 1 つのタブだけで、開くときに BroadcastChannel で在席を確かめます。 作品名はブラウザのタブの見出しにもなり、.rb のファイル名にもなります
• ⚙ 準備（大人の方へ）。 ファームウェアの書き込みはヘッダから外し、手順つきのダイアログへ。 基板 1 台につき一度きりの作業で、押し間違えると基板が書き込みモードのまま残るためです
• ■ 緊急停止 / ▶ 再開。 引き出しのバーから基板を止めたり動かし直したりできます。 wait の無いループを走らせていると書き込みが通らないことがあり、その復帰用です。 どのタブからでも、URB EE Lab からでも同じ基板に効きます
• 開いた時点で基板につなぐ。navigator.hid.getDevices() を使うので選択ダイアログは出ません。 これがないと、新しいタブは一度書き込むまで puts が出てきませんでした
• 専用ファーム 1 本を同梱（tools/build-block-bin.mjs）。構成は Q1 Pw Ad Se Nr Us Rn Ev の 15,004 B（残り 1,380 B）。 ブロックが吐く Ruby は冗長になりやすいので、プログラム領域を 2,560 B → 10,240 B に拡張しています （EE_VAR_BASE は Flash にも RAM にも影響しません）

2026-08-25

URB Lab / URB EE Lab — 新コンポーネント Tm（絶対周期）を両方に追加

• sleep を並べて周期を作ると、本体にかかった時間のぶん毎周ずれていく。 every_ms は起点を持ち、「前回起点 + 周期」で進めるので誤差が累積しない。 1000 周まわしても n × 周期 がそのまま経過時刻になる
• 書き方は 2 通り。**ブロックの形 every_ms 100 do … end と、 loop do の中に置く文の形 every_ms 100。**バイトコードは同じ 1 命令
• Timer で区間の時間を測れる — t.ms（上限 89.4 秒 / 1ms）と t.us（上限 8.38 秒 / 1µs）。読んでも起点は動かないので同じ区間を両方読める。 区間を区切るのは t.reset
• **起点は「書いた場所ごと」**に持つ（共有プール 8 個）。1 つで共有すると、 入れ子にしたときに外側の周期が黙って倍になる。every_ms と Timer の起点は 完全に独立で、周期の境目で Timer が区切られることはない
• 本体が周期を超えた周は待たずに進み、起点を現在時刻にして遅れを捨てる
• 命令は EVERY_MS 0x47 / TIMER_RESET 0x48 / TIMER_MS 0x49 / TIMER_US 0x4A。 番号は決定 27（新規の未使用領域に連続確保・既存番号は使い回さない）に従う
• Flash 実測は EE 版 +580 B（BASE 9,304 → 9,884 B）、SD 版 +384 B（12,664 → 13,048 B）。 SD 版が安いのは BASE が除算ヘルパを既にリンクしているため。RAM はどちらも起点 8 個で 32 B
• EE 版の配布 bin 6 種には入っていない（ブザー版が残り 52 B しかなく、実測で溢れた）。 「自分で選ぶ」で Tm にチェックを入れて .ino をビルドする。 6 種の .bin と inoSha256 は 1 バイトも変わっていない
• サンプル 3 つを追加 — tm-blink / tm-jitter / tm-react。3 つとも Tm 単独で動く
• **2 ページで命令番号・動作・Ruby 記法は完全に同一。**どちらも実機で動作確認済み

2026-08-22

URB EE Lab — CAT24M01WI（128KB）を実機確認し、アドレスを選べるようにした

• CAT24M01WI を選択肢として開放。1Mbit EEPROM の読み書き・64KB 境界をまたぐ アクセスを実機で確認した（ee_write は 32B ページごと、ee_fill は 128B キャッシュを 境界で切り詰めながら、デバイスアドレスを 0x52 → 0x53 に切り替える）
• **スレーブアドレスを選べるようにした。**CAT24M01WI は A1 の配線で 0x50/0x51 にも 0x52/0x53 にもできる。24FC256（0x50）と同じバスに載せるときは 0x52 側を選ぶ。 「搭載する EEPROM」の選択肢は 3 つ（24FC256 / CAT24M01WI 0x50 / CAT24M01WI 0x52）
• ビルド済みファームは Tn/Pw × 石 3 種の 6 種になった。 EE_DEV_BASE は命令の即値に埋まるだけなので、Flash サイズは 1 バイトも変わらない （0x50 版と 0x52 版の .bin は 4 バイトしか違わない）
• 配線の解説を書き直した — A1 が GND なら 0x50、5V なら 0x52

2026-08-18

URB EE Lab — ビルド済みファームをブラウザから直接書き込めるようにした

• Arduino IDE もボードパッケージも不要で始められる道を追加。rv003usb ブートローダ （1209:B803）へ WebHID で書き込む。選ぶのは「ブザーか、サーボか」だけ
• ファームは Tn/Pw × 石の 4 種（当時）。base64 でページに内包し、 .bin はファイルとして置かない。生成は tools/embed-bins.mjs が generateIno → arduino-cli → .bin → base64 まで一連で行う
• 焼く前に**生成される .ino の SHA-256 を突き合わせる。**食い違えば書き込まずに止まるので、 ファームの作り直し忘れをそのまま配ることがない
• **CAT24M01WI は基板未着のため選択肢ごと無効。**自分でビルドする経路も塞いである （未検証のものを配らないための実機確認なので、抜け道を作れば意味がない）

NeoPixel を Np / Nr に分割し、SHIFT と DIM を小さくした

• Np（9 命令） = 置く・塗る・ずらす・暗くする・自動表示の切り替え。+1,392 B
• Nr（11 命令） = Np + 虹（rainbow）と hsv。+2,196 B。Np の上位集合
• SHIFT（回転）と DIM（減光）は、やりたいのがバイト列の操作なのに、1 画素ごとに 32bit へ組み立て直していた。NeoPixelmin::getPixels()（ボードパッケージ v1.2.13）で バッファに直接触れる形にし、SHIFT 208→116 B / DIM 300→124 B
• 歩数の正規化（np.shift(-1) → 11 歩）と ％ の換算はコンパイラ側へ移した。 Ruby の書き方は変わらない

np.auto = false — 自動表示を止められるようにした（NEO_AUTO 0x46、+52 B）

• 従来は NeoPixel の全命令が show() していたため、1 コマの途中経過が見えていた。 64 個だと 1 コマ描くのに 131 ms かかり、LED が 1 個ずつ埋まる様子が見える
• 止めている間は np.show だけが送る。それまで無意味だった np.show が意味を取り戻した
• サンプル np-shift / np-dim を追加（np-rainbow は Nr 用に移動）

Flash 使用量の表示を .bin 基準に直した

• arduino-cli の「スケッチが N バイト」は .text + .data しか数えず、Flash に載る .init(160 B) と .init_array(4 B) を含まない。上限との比較が 160 B 甘く出ていた
• FLASH_BASE を 9,144 → 9,304 に修正

実機確認（24FC256） — ブラウザからのファーム書き込み、NeoPixel の動作、 np.auto の効果を確認。

2026-08-16

URB EE Lab（uiapruby-ee.html）を追加 — 保存先を I2C EEPROM に替えた版

• SD カードの代わりに I2C EEPROM（24FC256 / CAT24M01WI）へプログラムと $変数 を保存
• SPI が空いたことで Np（NeoPixel） と Se（UART） を新設。 I2 は EEPROM アクセスに必須なため BASE に統合、I2C スレーブは廃止
• SD 版の Ve / Sv は Ev / Ec に改名（Sv の S は SD の S だったため）
• BASE 9,144 B / RAM 380 B — SD 版 UIAPrubyVm（12,504 B / RAM 844 B）比で −3,360 B
• EEPROM 変数ビューアを追加。6 スロットの $変数 を型・要素数・永続属性つきで表示する。 数値は Q16.8 から n.nn に変換。配列は「〇番目から全部読む」＋「中止」。読み取り専用
• CMD_OPEN_R(0x04) を 24bit アドレス指定に拡張（+24 B）。変数領域へ直接シークするため
• ⚠ **実機確認は未実施。**コンパイル（サンプル 40 本 / 全構成ビルド）とブラウザ側は検証済み

2026-07-28

Keyboard Practice の USB 設定・スケッチ例の場所の誤記を修正

• keyboard.html の記載が実態と合っておらず、ZIP をそのまま使うとコンパイルが通らない状態だった
  • Tools → USB: Keyboard+Mouse → Keyboard+Mouse+WebHID。KeyboardPractice.ino は #include <WebHID.h> を使うため、WebHID なしの kbd では WebHID.h の #error で停止する
  • ZIP に同梱する sketch.yaml の FQBN も usb=kbd → usb=kbdweb
  • File → Examples → **WebHID** → KeyboardPractice → Keyboard。 KeyboardPractice / KeyboardSwitch は libraries/Keyboard/examples/ にある （libraries/WebHID/examples/ にあるのは WebHIDTest だけ）
• keyboard2.html も同じスケッチ例の場所の誤記を修正（USB 設定は元から正しい）
• sketches/KeyboardPractice/KeyboardPractice.ino のヘッダコメントも同様に修正
• arduino-cli で検証済み: usb=kbd はビルド失敗、usb=kbdweb は成功（4712 B / 28%）

2026-07-27

Snake VS — 2P 対戦を追加 + 開始演出（カウントダウン・効果音・陣地可視化）

• 2P 対戦（UIAPduino 2 台）を同一ページにモードタブとして追加。盤面・ルール・演出・ ロックステップ進行は vs CPU と共通
  • P1/P2 を別々のボタンで接続。同じ機体の二重選択は拒否し、2 台の PLAYER_NAME が 同じなら警告（どちらの機体か判別できず記録も混ざるため）
  • 各機体へ「自分の頭 → 相手の頭」の順で送るので、2 台とも同じスケッチのまま 自分視点で考えられる。EP0 は同時に使えないので 1 台ずつ直列に送るが、 両者とも同じ盤面に対して思考するため情報の有利不利は生じない
  • 5 本勝負。引き分けも 1 本として数える（仕切り直さない）。5 本終えて勝ち数が 多いほうが勝ち、同数なら試合も引き分け。逆転不可能になった時点で打ち切る。岩は 8 個固定
  • ランキングは連勝記録。勝ちで +1、負けても引き分けても 0 に戻る
• 配布スケッチの鏡像ロックを修正（2P が成立しなかった問題）
  • 実機で「衝突すると必ず両者が死んで永遠に引き分ける」と判明。原因は 2 台とも同じスケッチを 積んでいることで、①相手の「現在の頭」しか避けない ②絶対方向の固定順で評価する ③同点を決定論で選ぶ、の 3 点により 180° 対称の配置で完全な鏡像になり中央で正面衝突 していた。配布スケッチ同士 60 戦で 54 が引き分け、その 100% が正面衝突
  • CPU 側には同じ対策を入れてあったため 1P では表面化せず、避ける側が誰もいない 2P で破綻した
  • 対策は 2 つセットで必要（実測: 相手の頭だけ避ける = 決着 10% → 次に入れるマスも避ける = 83%（ただし片側に偏る）→ 手の評価順もシャッフル = 92%・偏りなし）
  • 乱数の種は PLAYER_NAME のハッシュと開始座標から生成。P1/P2 で開始座標が入れ替わるので 2 台の名前が同じでも必ず別の乱数列になる（同名でも決着 90% を確認）
• 開始演出: 「3・2・1・スタート」のカウントダウン（1 拍 = ちょうど 1 秒。ラウンド間 2 秒 / 対戦開始・レベルアップ後 3 秒）。この時間で準備通信を覆い隠すので、待ち時間が演出になる。 カウントダウン中も岩と開始位置が見えるため、観客が配置を読む時間にもなる
• 効果音（WebAudio で合成・音源ファイル不要）: カウント / スタート / 勝ち / 負け / 引き分け / レベルアップ / 全段クリア / 衝突。ミュートトグル付き
• 決着テロップ（WIN / LOSE / DRAW とスコア）と陣地（ボロノイ図）の可視化トグル
  • 副産物として、開始時の陣地が 115 対 115 で完全一致することを確認。 180° 回転対称の公平性が勝率統計とは別の角度から裏付けられた
• バグ修正: オーバーレイのアニメを requestAnimationFrame だけで駆動していたため、 タブを裏に回すと試合が固まっていた。タイマーによるフォールバックを追加
• バグ修正: 陣地表示が 2P でも「CPU」のままだった。P1/P2 に切り替える （名前を出す案は「Tarosa 1」「Tarosa 2」が 6 文字で切られて両方「Tarosa」になり 区別できなかったため、短いタグに変更。思考時間の名前も切り詰めをやめた）

2026-07-26 (2)

Snake VS 公開 — UIAPduino のアルゴリズムが CPU と陣地を取り合う対戦スネーク

• Snake Solver の「毎ティック成長・BFS 最大空間優先」を対戦に拡張。勝利条件は生存のみ
• CPU 5 段ラダー（ランダム / 貪欲 / BFS 最大空間 / ボロノイ / ボロノイ＋深さ 2 の先読み）を 各段 3 本勝負（2 本先取）で勝ち上がる。岩は 0 / 4 / 8 / 10 / 10
• 相手の体 ＝ 相手の頭の軌跡（縮まないため）。頭の座標 2 バイトを送るだけで デバイス側が相手の体を完全に復元できる
• スタート位置は 180° 回転対称の 6 パターンからランダム。盤面が偶数幅なので x ≠ 15−x が常に成立し、2 匹が同じ行・列に並ばない（開幕の正面衝突が構造的に起きない）
• ロックステップ進行で USB 遅延では勝敗が決まらない（2 秒タイムアウト・3 連続で反則負け・ 観戦用に 1 ティック下限 200ms）
• 配布スケッチは BFS 最大空間優先（Snake Solver ヒント 4 と同じ既公開の知識）。 CPU Lv3 と互角、Lv4（ボロノイ）で止まる床実装
• RAM 最適化: bool 配列 3 枚（768B）では RAM 70% となり挑戦者のボロノイ用距離配列（512B）が 入らないため、uint8_t cell[16][16] 1 枚と座標を (y<<4)|x に詰めた bfsQ[256] に変更。 668B（32%）まで下げて挑戦者用に 1,380B を確保
• CPU の同点処理を決定論にすると、対称配置で両者が鏡像的に動いて引き分け 80〜90%、 かつ配置ごとに勝率が偏ることが判明。候補手のシャッフル＋同点ランダム選択で解決
• 引き分けの原因は 100% が正面衝突だったため、CPU に「相手が次に入れるマス」の回避を追加 （引き分け 80% → 17〜37%）
• 実測（各 60 ラウンド）: 配布スケッチ vs Lv1 = 48勝2敗 / Lv3 = 27勝23敗（互角）/ Lv4 = 3勝40敗（壁）。CPU 同士も完全単調。自己対戦の P1 勝率は 6 配置平均 47%
• LED Controller は作る予定がないため Coming Soon カードを削除

2026-07-26

Rock Dodge 公開 — 岩をよけながら得点アイテムを拾うプラクティス

• 落ちてくる岩をよけながらアイテムを拾い、スコアを競うレベル制ゲーム（全レベル 120 ステップ固定）。 プレイヤーは最下段を左右に動くだけ（1D）
• セーフティライン（仮想プレイヤー）を導入。岩の湧きはライン基準で生存を保証するため、 ラインに乗っている限り岩には当たらない。ただし乗っているだけでは アイテムノルマ（Lv1 で 6 個 → Lv5 で 10 個）に届かずゲームオーバー — 岩をよけ続けるだけでは得点は増えない設計
• アイテムの得点はリスク d（ラインを外れる必要のあるティック数）に連動。 得点の帯を互いに重ねてあるので「浅いのに高いアタリ」があり、表示された数字を読む意味がある
• 壁の岩の一部が 2〜4 列つながってアイテムに変わる（隙間とは別の開口部）。奥ほど高得点
• ラインから 2 列以上離れると湧きが敵対化 — 壁の隙間がラインの位置に寄り、 12 行目（猶予 3 ティック）から狙い岩が降る
• ★（面クリアアイテム）は得点 0 で即クリア＋ノルマ免除。1 面に最大 3 個、深い位置（d 4〜7）に湧く。 順調なときは踏まないよう避けるのが正解（★を避ける実装は避けない実装より約 20% 高得点）
• 脱出路の仕掛け: 壁の奥のお宝を置いたら、数ティック後の壁に「そこから届く★」を 約 4 割の確率で埋め込む。詰み確定に見えて狙える状況を意図的に作る
• プロトコルは CMD_TICK を列ごとのアイテム値配列にして 1 行に複数アイテムを置けるようにした （送信 21 バイトのため受信バッファは 32 バイト必須）
• 配布スケッチは時空間先読みで生存＋±1 列のタダ取りまでの床実装。岩には当たらないが ノルマ壁で止まる。採算判断はヒントで方針のみ示しコードは載せていない
• ランキングは localStorage（プロジェクタ投影での挑戦会を想定）。名前は #define PLAYER_NAME
• 実測（1〜14 面通しプレイ）: 床（配布スケッチ）= 111点 / Lv2.3 / 岩死 0 に対し、 最適実装 = 2,814点 / Lv12.3。25 倍のスコア差がつく技量勾配を確認

2026-07-12 (3)

URB Lab — 新コンポーネント Ve（変数の拡張 — 数値SD変数）を追加

• Sv（+2,832B）から数値系の機能だけを切り出した軽量コンポーネント（+1,516B）。 Sv 自体は無変更（Ve の上位互換 — ファーム出力もバイト単位で不変）
• Ve で使えるもの: $count などの数値永続変数 / 3つ目以降の数値変数（揮発・SD 自動配置）/ 数値配列（$付きで永続）。値の確認は warn（DEVICE LOG）
• puts の数値出力（PRINT_REG）・文字変数・to_s は従来どおり Sv（コンパイルエラーで案内）
• 動機は「$変数は便利だが Sv が大きすぎて他コンポーネントと併用できない」の解消。 Q1+Us+Ve = 15,132B / Q1+Rn+Ve = 15,180B — 旧 Sv では 16KB を超えて不可能だった 組み合わせが使えるようになった
• Sv と Ve を両方選択した場合は Sv に正規化（Flash 見積もりの二重加算なし・ZIP 名も Sv 単独と同一）
• サンプル2本を追加。Sv は Ve の上位互換のため、Ve のサンプルは Sv 選択時にも表示される
  • ve-blink — 電源を入れるたびに LED の点滅回数が 1 回ずつ増える $永続変数のデモ （出力命令を使わないため Q1+Ve / Q1+Sv どちらの構成でも動く）
  • ve-counter — 起動ごとに +1 する永続カウンタを warn で表示 （Q1+Sv 構成では warn がファームから省略されるため、Sv 選択時はボタン非表示）
• 参照スケッチ UIAPrubyVmVe（14,480B）/ UIAPrubyVmQ1Ve（15,020B）を追加

2026-07-12 (2)

URB Lab — サーボ angle() を 50Hz 標準タイミング化 + ファーム MUL_Q16 の乗算バグ修正

• サーボが正しく動かないバグを修正（実機症状: 0→90 指定で45°しか動かない / 135°・150°・180° が 無視または暴走）。原因は2つの複合:
  1. 旧 500Hz 設計の破綻 — パルス 1〜2ms のマッピングは SG90 系（0.5〜2.4ms = 0〜180°）の 中央半分しかカバーせず、さらに大角度では周期 2ms 内に Low ギャップがほぼ消える （180°で 8µs）ためサーボがパルス境界を認識できない
  2. ファーム MUL_Q16 の int16 キャストバグ — ±128 以上の値を含む乗算がすべて壊れる （angle 専用ではなく Ruby の a * b 全般。変数 angle が 128° 以上で不正 duty になっていた）
• angle() は 50Hz・パルス 0.5〜2.4ms に変更（Arduino Servo ライブラリの既定 544〜2400µs と ほぼ同等レンジ）。servo.frequency(50) が必須（違うとコンパイルエラーで案内）。 8bit PWM のため分解能は約 7°/ステップ。SG90 実機で 0〜180° 全域動作を確認済み
• MUL_Q16 を int32 乗算に修正（積 ±32768 未満まで正確）。Q1 系 4 スケッチ （UIAPrubyVmQ1 / Q1Pw / Q1Sv / Q1Tn）を再生成 — 書き込み済みボードは再書き込みが必要 （angle だけはコンパイラ側の演算順対策により旧ファームでも正しく動く）
• Flash: Q1 +596 → +592 B（▲4B）。Q1+Sv = 16,212 B（98%、16KB 内に収まる）
• tools/gen-ino.js の旧ファイル名（urb-lab.html）参照を修復

2026-07-12

スケッチ ZIP に sketch.yaml を同梱 — Arduino IDE 2.1+ でボード設定が自動選択される

• スケッチダウンロード ZIP を持つ全 12 ページに sketch.yaml（default_fqbn: 1行）を同梱: URB Lab / SD Filemanager / MIDI → MIDB / HID Console / Keyboard 1・2 / Mouse 1・2 / Snake Solver / Maze Solver / Echo Test / HID-Serial Bridge
• 展開した .ino を Arduino IDE 2.1 以降で開くと、ボード「HID ProMicro CH32V003」と カスタムオプション（Board Version V1.4 / USB / Optimize oslto、URB Lab の Tn 選択時は PWM default）が 自動選択され、書き込み前のボード設定作業が不要になる
• USB 設定は各ページの解説どおりに出し分け: Snake Solver・Snake VS・Rock Dodge・HID-Serial Bridge の HidMonitorTest = WebHID Only（webhid）/ HID-Serial Bridge の HidBridgeTest とその他ページ = Keyboard+Mouse+WebHID（kbdweb）/ URB Lab・SD Filemanager・MIDI → MIDB = WebHID Only（webhid）
• ボードパッケージ（v1.2.7）のインストール自体は従来どおり必要（sketch.yaml は選択のみ）。 古い IDE では無視されるだけで無害
• arduino-cli 検証済み: default_fqbn のみの yaml は --fqbn 指定あり/なしのどちらのビルドも正常 （過去にビルドを壊したのは profiles 系の記述を含む yaml で、今回の形式は問題なし）

2026-07-11 (4)

URB Lab — ラムダ式対応（コンパイル時インライン展開）+ Q1 チェック漏れ修正

• ラムダ式に対応（コンパイラのみ・VM 変更なし）。f = ->(x) { x < 15 } で定義し、 以下の場所で使用可能。呼び出し位置へコンパイル時にインライン展開されるため 実行時オーバーヘッド・追加 Flash なし
  • case d / when f / when ->(x) { x < 15 } — case 対象が引数に渡り条件として展開
  • if between.call(d, 5, 10) — if / while / until / unless / 三項演算子の条件 （複数引数・&& / || も可）
  • y = double.call(n) — 数値式（戻り値 = 本体の式の値）
  • wait_ms half.call(500) — 引数がすべて定数ならコンパイル時に計算され、 リテラルを書ける場所ならどこでも使える
  • 制約: 本体は式1つのみ / 引数は数値リテラル（定数式）または変数のみ / 再帰不可 （いずれもコンパイルエラーで案内）
• バグ修正: Q1 チェック漏れ — d = 1.0（数値代入）と if d < 15（比較演算）が Q1 未選択でもコンパイルできてしまい、BASE ファームで実行時「不明なオペコード」に なっていた（LOAD_Q16 / CMP_*_Q16 は Q1 命令）。コンパイル時に Q1 を案内するエラーを 表示するよう修正。d = sonar.read / rand / wait_ms d * 10 など Q1 不要の経路は従来どおり
• ページの API リファレンスに比較演算・case/when（値/レンジ）・ラムダ式の項を追加
• 全 36 サンプル回帰コンパイル OK（Us / Ad / Rn / I2 単独などの最小構成でも確認）

2026-07-11 (3)

URB Lab — case/when のレンジ対応 + else 節が消えるバグを修正（コンパイラのみ・VM 変更なし）

• when 0...15（終端含まず）/ when 1..3（終端含む）/ 始端なし when ..0 / 終端なし when 20.. then のレンジ比較に対応。多値との混在（when 0...3, 10）も可
• 既存オペコード CMP_LT_Q16 / CMP_GT_Q16 ×2 + 条件ジャンプに展開するだけなので ファームウェア・スケッチは無変更（Q1 コンポーネント必須）。 レンジは比較 2 回で済み、多値列挙（when 0, 1, 2, ...）よりバイトコードが大幅に小さい
• バグ修正: case 式の else 節がバイトコードから丸ごと欠落していた問題を修正 （コンパイラが Prism CaseNode の elseClause ではなく consequent を参照していたため、 case-when 導入以降 else の中身がエラーも出ずに消えていた）
• 全 36 サンプル回帰コンパイル OK

2026-07-11 (2)

URB Lab — warn デバッグ出力を追加（Sv 不要で数値を DEVICE LOG へ）

• 新オペコード WARN_REG (0x32) を BASE に追加。warn d / warn sonar.read で レジスタ生値（Q16.8 下位 24bit）を既存の hidLog パケット（type 0x20）で送信し、 数値→文字列変換はブラウザ側で実施 → Sv（+2,832B）なしでデバッグ出力が可能に
• DEVICE LOG に warn: 14 / warn: 14.25 形式で表示（整数はそのまま・小数部があれば小数表示）
• Q1+Sv 構成のみ非搭載（Flash 16KB を 72B 超過するため）。コンパイラが 「puts / p で代替」を案内するエラーを表示。Q1+Sv は従来と同一の 16,216B を維持
• hidLog() に noinline を付与（LTO のインライン展開を抑制、▲20B）
• 全 14 スケッチ再生成・再ビルド確認済み。BASE 12,888 → 12,964 B（+76B）。 各コンポーネント差分・Flash 見積もりを実測値に更新（Q1+Sv は warn 省略分 −176B 補正）

SD Filemanager / MIDI → MIDB Converter — スケッチダウンロードを ZIP 形式に統一

• 両ページのスケッチダウンロードが単一ファイル直ダウンロードのまま残っていたのを、 他ページと同じ ZIP 形式（JSZip・スケッチ名/スケッチ名.ino 構造）に変更
  • SD Filemanager: WebHID_SD.zip（WebHID_SD.ino）
  • MIDI → MIDB: MidbPlayer.zip（MidbPlayer.ino + UIAPSerial.h + UIAPSerial.cpp）
• ボタン表記も「DL」→「ZIPダウンロード」に統一。展開するとフォルダ名と .ino 名が一致し、 Arduino IDE でそのまま開ける
• 変換結果の .midb や SD カード内ファイルのダウンロードは従来どおり単体ファイルのまま

URB Lab — ボードパッケージ v1.2.7 対応・解説文の修正

• 必要ボードパッケージを v1.2.7 以降に引き上げ
  • v1.2.7 の ADC ピン割り当て修正（ADC1_IN6/IN7 → PD6/PD4）により、Ad コンポーネントの pin16 (A6) が正しい物理ピンで動作する（v1.2.6 以前は誤ったピンを読んでいた）
  • ページ内の必要ソフトウェア表記・生成 .ino ヘッダー・配布用スケッチ 14 本のヘッダーを更新
• コンポーネント Flash 増分を v1.2.7 で全再計測（BASE = 12,888 B 変化なし）
  • Ad: +324 → +328 B（ADC ピン修正の影響）
  • Sv: +2,744 → +2,828 B（print(0) 修正 = PRINT_REG が使う Print クラスの影響）
  • Q1 / Tn / Pw / Us / I2 / Rn は変化なし。全組み合わせが 16 KB 以内に収まることを実測確認 （最大は Q1+Sv の 16,216 B）
• 解説文の修正:
  • スケッチ書き込み手順に「UIAPduino のボタンを押しながら USB ケーブルを挿す」説明を追加
  • main.urb 自動実行の開始が「電源オンから 5 秒後」である旨を追記（2 箇所）
  • エディタの初期サンプルを led-blink サンプルボタンの内容（コメント付き）と一致させた

---

2026-06-29

URB Lab — ソースエディタ ファイル操作・整形・スクロール改善

• ソースエディタ ファイル操作:
  • 「開く」ボタン: .rb ファイルを読み込み（Chrome/Edge では showOpenFilePicker() でファイルハンドルを取得し上書き保存に対応）
  • ドラッグ＆ドロップ: エディタ枠に .rb ファイルをドロップして読み込み
  • 「保存」ボタン: ハンドルがあれば同じファイルに直接上書き保存、なければ同名でダウンロード
  • 「名前を付けて保存」ボタン: showSaveFilePicker() でファイル名・場所を指定して保存
  • 「クリア」ボタン: エディタをクリアしファイルハンドルもリセット
• 「整形」ボタン（Prism AST ベース）:
  • @ruby/prism WASM の AST を走査してブロック構造（do...end / if / until / while / def / class 等）に応じたインデントを算出
  • 日本語コメント等を含む場合も UTF-8 バイトオフセットで正確に行番号を算出
  • コメント行は前後の行の深度の max で補完
  • 代入演算子 = 前後のスペースを自動正規化（== / => / += 等は対象外）
  • 構文エラーがある場合は整形を中止してエラーを通知
• 自動スクロール:
  • 「コンパイル」ボタン押下後、成功・エラー問わずコンパイル結果セクションへスクロール
  • 「SD カードに送信」完了後、ファイル一覧更新完了後に DEVICE LOG の RUN ボタンへスクロール

---

2026-06-26

URB Lab — Tn の PWMmin 化（▲580B 削減）・ピンバリデーション追加

• Tn コンポーネント: tone()/noTone() を廃止し PWMmin.h で実装
  • Flash: +1,592 B → +1,012 B（▲580 B 削減）
  • FQBN に pwm=default が必要。ブラウザ生成コードに自動付加
• Pw/Tn コンパイラ: PWM.new / Tone.new で有効ピン（0/2/5/12）をチェック
  • pin 6 (PC4) は SD カード SS 専用（PIN_SS=6）のため使用不可 → コンパイルエラー
• Tn 説明文修正: 「サーボ制御」を削除（サーボは Pw の機能）

---

2026-06-13

URB Lab — 構文拡張・def 引数付き・多重代入・コンポーネントチェック完備

• 新対応構文（コンパイラのみ、TinyVM は変更なし）:
  • until cond — while の条件を反転した構文
  • case; when cond — 条件式による case 分岐（条件なし case）
  • case x; when val — 数値等値比較（Q1 必須）
  • if a && b / if a || b — 複合条件（短絡評価）
• def 引数付き対応（限定的）: 引数最大 2 個・数値リテラルのみ。コンパイル時に定数展開するため Q1 不要
  • def blink(pin, ms) ... end のように定義し blink(2, 0.5) で呼び出す
• 多重代入 a, b = 1, 2（Q1 必須）: 2 変数を 1 行で初期化
• コンポーネントチェック完備: Tn / Pw / Ad / Us / Rn のコンストラクタ・rand / srand がコンポーネント未選択時にエラーを出すよう修正
• index.html: ボードマネージャ URL 欄に「コピー」ボタンを追加

---

2026-06-12（サイト整備）

Coming Soon の整理・ブラウザ警告・戻るリンク統一

• 公開予定を整理: Mini Oscilloscope を削除（HID-Serial Bridge + Arduino IDE シリアル プロッタで役割を代替済み）。Rock Dodge はセンサ不要・C 言語のアルゴリズムのみで 何秒耐えるかを競う仕様に説明を修正。Snake Game — VS 対戦（コンピュータのレベル制・ UIAPduino 2台での人対人・ネット対戦を計画）カードを新規追加
• uiapruby.html に WebHID 非対応ブラウザ（Firefox / Safari）向けの警告バナーを追加 （コンパイルと .ino / .urb ダウンロードは利用可能な旨を併記）
• uiapruby.html / midi-to-midb.html の「← UIAPduino WebHID Lab」戻るリンクを ヘッダー最上部（左上）へ移動し、全 12 ページで位置を統一

---

2026-06-12

URB Lab 全面刷新 — コンポーネント選択式へ

• uiapruby.html を URB Lab として全面リニューアル（旧 urb-lab.html を改名。旧ページ _uiapruby.html / ruby-to-urb.html と専用スケッチ UapRunner / UIAPrubyRunner / UIAPrubyRunnerStandard は削除 — git 履歴から参照可）
• コンポーネント選択式（≒ mrbgems）: BASE 12,888 B + Q1/Tn/Pw/Ad/Us/I2/Rn/Sv の8コンポーネント から必要な機能だけを選び、TinyVM ファームの .ino をブラウザ内で生成（mruby における rake の 役割をブラウザへ移植）。Flash 見積もりをリアルタイム表示
• Sv コンポーネント: $ 永続変数（SD カード保存・電源断でも保持）・文字列変数・配列・ to_s / << 連結・PRINT_REG。24×24 ドット絵デモ（sv-dotart）
• 新コンポーネント: Tn（Tone）/ Pw（PWM デューティ・サーボ）/ I2（I2C, Wiremin.h）/ Rn（rand / srand）
• ADC 仕様変更: sensor.read が整数 0〜255 を返すように（旧 0.00〜0.99 を廃止）。 ADC を直接レジスタ制御に書き換え Flash +708 → +324 B
• バイトコード形式を URB1（.urb）に改称、自動実行ファイル名は main.urb
• SDmin v1.2.5（ボードパッケージ）のランダムアクセス API（sm_seek / sm_write_at）を 利用。ボードパッケージ v1.2.5 以降が必須
• index.html のトップ導線を「UIAPduino SD をお使いの方へ」パネルへのページ内リンクに変更

---

2026-06-05

UIAPruby — HC-SR04 超音波距離センサ対応

• UIAPrubyRunner.ino に ULTRASONIC_READ (0x1A) オペコードを追加
  • Ultrasonic.new(trig, echo) / puts sonar.read で距離 (cm) を HID コンソールへ出力
  • 推奨配線: TRIG → pin3 (PC1)、ECHO → pin4 (PC2)（ピンは任意の GPIO に変更可）
  • pulseIn() / micros() は uint64_t soft-lib を引き込むため不使用。SysTick->CNT（32bit, 48MHz）直読みで実装
  • Flash 使用量: 16,216 / 16,384 バイト（残り 168 バイト）
• uiapruby.html のコンパイラ・UI を対応
  • Ultrasonic.new(trig, echo) 認識・バイトコード生成
  • ピン表・オペコード表・リファレンス表・サンプルコード・逆アセンブル表示を更新

---

2026-06-02

UIAPruby Lab 公開・ADC 対応

• uiapruby.html を新規追加 — Ruby 構文 → UAP1 バイトコード変換・実行環境
  • @ruby/prism WASM によるブラウザ内 Ruby パーサー
  • UIAPduino TinyVM v1 向けコンパイラ（GPIO / PWM / if / loop / for / def / Q16.8 演算 / require）
  • WebHID で SD カードへ .uap 直接転送
  • HID コンソール（puts / print / p / putc 出力）
• UIAPrubyRunner.ino に ADC_READ (0x18) と PRINT_REG (0x19) オペコードを追加
  • ADC.new(pin) / puts sensor.read で ADC 値を HID コンソールへ出力
  • Flash 使用量: 16,068 / 16,384 バイト (98%)（ADC ドライバ込み）
• Wakayama.rb コミュニティロゴ（images/WakayamarbLOGO.png）をヘッダーに追加
• ボードパッケージ必要バージョンを v1.2.3 以降に更新
• TinyVM 命令表・ピン配置リファレンス・Q16.8 表記を整備

---

2026-05-22

Feature Report サイズ変更（16 → 32 バイト）対応
arduino_core_ch32 v1.1.5 で Feature Report サイズが 16 → 32 バイトに変更されたことに伴う HTML 側の修正。

• sendFeatureReport() に渡す Uint8Array のサイズを 16 → 32 バイトに修正
  対象: keyboard.html / keyboard2.html / mouse.html / mouse2.html / snake.html / maze-solver.html
• 各ページのプロトコル仕様・説明テキストに記載されていた "16 バイト" を "32 バイト" に修正
  対象: 上記 6 ページ + hid-console.html / hid-serial-bridge.html / sd-file.html（計 13 箇所）

Maze Solver — EP0 並行送信バグ修正

• startGame() を async 化し、連続する 3 回の sendFeatureReport() を逐次 await するよう修正
• inputreport イベントハンドラを非同期シリアルキュー（enqueueCommand / _flushCmdQueue）経由に変更し、EP0 の並行アクセスを防止
• sendFeature() に 3 回リトライ（20 ms 間隔）を追加

Snake Solver — setInterval 並行実行バグ修正

• setInterval + async tick() の組み合わせで前の tick 完了前に次の tick が起動するバグを修正
• tickBusy フラグを追加して tick の重複実行を防止
• sendFeature() に 3 回リトライ（20 ms 間隔）を追加

SD Filemanager — ディレクトリ削除機能追加

• ファイル一覧のフォルダ行に削除ボタンを追加
• 新コマンド CMD_RMDIR (0x0A) をブラウザ・スケッチ両側に実装（空ディレクトリのみ削除可能）
• WebHID_SD.ino に CMD_RMDIR ケースを追加
• SDmin.h に sm_rmdir() を追加（内部共通関数 _sm_del_entry() で Flash 増加を約 20 バイトに最小化）

---

2026-05-21（スケッチ ZIPダウンロード対応）

全ページのスケッチダウンロードを ZIP 形式に統一

• 「ダウンロード」ボタンを「ZIPダウンロード」に変更（全 9 ページ）
• JSZip ライブラリ（CDN）を追加し、クライアントサイドで ZIP を生成
• ZIP は スケッチ名/ フォルダ内に全ファイルを格納する Arduino IDE 対応構造
  • 例: HidPrint.zip → 展開すると HidPrint/HidPrint.ino, HidPrint/Hid.h, HidPrint/Hid.cpp
  • そのまま Arduino IDE で開いてビルド可能

---

2026-05-21

通信インターフェイスの用語定義
「Serial」という言葉の混同を避けるため、通信区間ごとに用語を定義した。
HID通信 / WebCom通信 / VirtualCOM通信 / COMモニタ通信

Hid クラスの大幅拡充（HidBridgeTest / HidMonitorTest / HidPrint 共通）

• WaitConnect() を廃止し WaitAvailable(uint32_t timeoutMs = 0) に改名
  • 実装を recv() から available() に変更し データを消費しない 設計に
  • ブラウザ接続待ちに 0x53 ビーコンを送らない仕様に確定
• Write() メソッド（0x52 プロトコル）追加
• Ready() メソッド（0x53 プロトコル）追加
• Print プロトコルの改行を 0x02 フラグ方式から 0x0A in text 方式に統一

HidMonitorTest スケッチ新規追加
Protocol モード（hid.Print/hid.Println）に特化したスケッチ。
USB: WebHID Only。WaitAvailable() + Ready() + カウンタ送信。

hid-serial-bridge.html の改修

• HID と WebCom 両接続時にブリッジを自動起動（どちらが後でも対応）
• HID接続時に接続通知（0x01 Feature Report）を送信し WaitAvailable() を解除
• HID受信モードに Protocol モード（デフォルト）と Raw Binary モードを追加
• モード切替でスケッチビューアが HidMonitorTest / HidBridgeTest に自動切り替わり
• ページ末尾に折りたたみ式プロトコル仕様セクションを追加

hid-console.html の改修

• HID接続時に接続通知（0x01 Feature Report）を送信し WaitAvailable() を解除
• 0x53 Ready 通知を受信してログ表示
• JS プロトコルハンドラを新仕様（0x0A in text）に対応しつつ旧仕様（0x02 フラグ）後方互換を維持
• ページ末尾に折りたたみ式プロトコル仕様セクションを追加

---

新しいデモページを追加するには

1. docs/ に新しい HTML ファイルを作成（例: docs/newdemo.html）
2. ページ上部に戻るリンクを追加

   <a href="index.html">← UIAPduino WebHID Lab</a>
   

3. スケッチを docs/sketches/スケッチ名/スケッチ名.ino（以降は同フォルダに .h / .cpp も追加可）として配置
4. docs/index.html にリンク付きカードを追加（Coming Soon カードがあればそれを置き換える）
5. README.md を更新 — 忘れやすいので 4 箇所すべて:
   • 「デモページ一覧」テーブルに行を追加
   • 「各ページの機能」に説明を追加
   • 「ファイル構成」に HTML とスケッチフォルダを追加
   • 「変更履歴」に日付つきで追記
6. コミット＆プッシュ → GitHub Pages に自動反映

---

関連リポジトリ

リポジトリ	説明
urb-gallery	URB ギャラリー — みんなの作品（.rb を並べて Block Lab で開く）
arduino_core_ch32	UIAPduino Arduino コア（WebHID ファームウェア含む）
board_manager_files	Board Manager 用インデックス JSON
Wakayama.rb	UIAPruby 開発元 — 和歌山発 Ruby コミュニティ

---

ライセンス

MIT License — 詳細は LICENSE を参照