UIAPduino Pro Micro（CH32V003） を使った、子ども向けの Arduino プログラミング・ワークショップ教材です。 LEDをチカチカさせるところから、センサーとモーターを組み合わせた作品づくりまで進みます。
対象は 小学校高学年〜中学生。ブロックではなく、文字（C++）でプログラムを書く教材です。
https://taikiishii.github.io/uiapduino-workshop/
もくじページから各章を開けます。
- 1つのソース（Markdown）から、Web ページ / 発表スライド / 印刷用 PDF の3通りに使えます。
- 各ページ上部の「▶ 発表モード」で全画面プレゼン、「印刷 / PDF」でスライド形式の配布資料になります。
- コードブロックは、パソコンなら右上の「📋 コピー」でワンクリックコピーできます。
教材は共通で、進むセクションを増やすことで開催期間を変えられます。
| コース | 進む範囲 | ゴール |
|---|---|---|
| 半日（3時間） | 導入編 ＋ 基本編 b1〜b4 | スイッチ・つまみでLEDを操作できた |
| 1日（6時間） | ＋ 基本編 b5 ＋ 制御編 | くりかえしと条件を自分で書けた |
| 複数日（3時間×4回） | ＋ 発展編 | センサーで感じてモーターで動く作品を作った |
くわしい章立て・タイムテーブル・部品リストは CURRICULUM.md を参照してください。
content/ に Markdown を書いて python build.py を実行するだけで、HTML・QRコード・もくじが自動生成されます。
- この教材だけのきまり … AUTHORING.md
- 共通の書き方（記法・画像・1枚に入る量） … workshop-kit の AUTHORING.md
ビルドのしくみ（CSS・JavaScript・テンプレート・変換スクリプト）は、 ほかのワークショップ教材と共有している workshop-kit にあります。 はじめての1回だけ、となりのフォルダに置いて入れてください。
git clone https://github.com/taikiishii/workshop-kit.git ../workshop-kit
pip install -e ../workshop-kit1つの章 = 1つのフォルダ（content/ と docs/ が対称）。
site.toml… この教材だけの設定（公開URL・セクション・カードの色・コードで青くする語）content/<章>/… 各章のindex.md（編集するのはここ） とimage/index/（写真・画面キャプチャ）content/_index/… もくじページに足すブロック（refs.html/license.html）assets/… この教材だけの画像（ヘッダーのボードの絵）build.py… workshop-kit を呼ぶだけの数行docs/<章>/…build.pyが生成するindex.html/qr.svg/image/index/（GitHub Pages 配信元。直接編集しない）docs/assets/… 共通部品（workshop-kit から配置）＋site-theme.css/site-config.js（site.tomlから生成）verify/… 実機検証用の Arduino スケッチ（教材に書く値を実機で確かめるためのもの。公開教材ではない）tools/… 配線図（ブレッドボード図）を SVG で描く Python スクリプトCURRICULUM.md… カリキュラム案・ピン配置・注意点・検証プラン
章フォルダ名の頭は i=導入編 / b=基本編 / c=制御編 / e=発展編 / p=作品編 / x=付録 ＋ 連番です。
教材を書く人向けの要点です（くわしくは CURRICULUM.md §6）。
- 書き込み手順が独特 … RESETを押しながらUSBを挿す → 書き込み → 完了後もう一度RESET
- シリアルモニタが使えない …
Serial.printでのデバッグ前提にしない。値はLEDの明るさで見せる analogWriteの既定は 0〜4095 …setup()にanalogWriteResolution(8);を入れて 0〜255 にそろえる- PWM が使えるピンは限られる … 0・2・5・6・12 のみ（実測で確認）
- アナログが読めるピンも限られる … A0・A1・A2・A3・A5 のみ。A6 は図にあるが読めない
- 5Vピンは連続 約0.5A まで … USB の VBUS と直結だが、間のヒューズの溶断電流が 1A （公式が「一般的にはその半分が連続定格」と明記）。サーボ・モーターは外部電源から取る
- Flash 16KB / RAM 2KB … 大きなライブラリは載らない。教材はライブラリなしで組み立てている
- UIAPduino Pro Micro CH32V003 V1.4 — 公式ページ … 仕様・ピン配置・書き込み手順の一次情報。教材に書く事実は必ずここで裏を取ること
- 同ページ：ch32fun 開発環境 … Arduino IDE を使わないコマンドライン開発（発展）
- Arduino IDE のダウンロード
- スイッチサイエンス — ボードの購入
- ボードマネージャURL：
https://github.com/YuukiUmeta-UIAP/board_manager_files/raw/main/package_uiap.jp_index.json
文章・レイアウト・プログラムは MIT ライセンス（docs/LICENSE.txt）で公開しています。 自由に利用・改変・再配布できますが、作成者は一切の責任を負いません（無保証）。
※ 画面キャプチャ・イラスト・写真などの第三者素材は MIT の対象外で、各提供元の利用規約に従います。
※ ピン配置図（content/x3_pinout/image/index/pinout.png および content/i1_about/image/index/pinout.png）は
Yuuki U. 氏の著作物で、CC BY 4.0 で公開されているものです。
再配布・改変の際は、作者名とライセンス（https://creativecommons.org/licenses/by/4.0/ ）の表示を残してください。
Copyright © 2026 Taiki Ishii