📚 ナレッジ集

スタックちゃん開発で詰まったポイント・調べたこと・電子工作の基礎を、後で見返して理解できる形 で残していくページ群。

読む順番（電子工作はじめての人向け）

1. 01-hardware-basics.md — そもそも CoreS3 / スタックちゃんとは何か、USB-C を繋ぐと何が起きるか
2. 02-platformio-setup.md — PlatformIO ってなに、ビルド・書き込みの仕組み
3. 03-serial-monitor.md — シリアルモニタの読み方、リセットボタンの意味

トラブル事典（ハマったら引く）

症状	ページ
pio pkg install が pyexpat の symbol not found で落ちる	troubleshooting/macos-libexpat.md
avr/interrupt.h: No such file でビルド失敗	troubleshooting/varspeedservo-esp32.md
pio device monitor が Operation not supported by device	troubleshooting/pio-monitor-tty.md

用語辞典

用語	一言で
ESP32-S3	スタックちゃんの「脳みそ」のCPUチップ。Wi-Fi/Bluetooth 内蔵。
CoreS3	M5Stack 社が ESP32-S3 を載せて作ったモジュール製品名（K151のベース）。
PlatformIO	マイコン用の「ビルド・書き込みツールキット」。Mac で書いたコードをスタックちゃんに送る道具。
ファームウェア (firmware)	マイコンに書き込む「OS兼アプリ」のこと。電源を入れたら勝手に動き出すプログラム。
フラッシュ書き込み	ファームウェアをマイコンの不揮発メモリに焼く操作。USB経由でやる。
シリアル	マイコンと PC が1本のケーブルで会話する古典的な通信方式。printfデバッグはこれ経由で見る。
UART	シリアル通信の電気的な規格名。USBの内側で UART に変換されて CoreS3 と話している。
サーボ	角度指定で動くモーター。スタックちゃんの首振りに使う。

書き込みルール（自分用メモ）

• ハマったら 症状 → 原因 → 対処 の3点セットで troubleshooting/ にファイルを追加する
• 専門用語は初出時に必ず1行で説明する（「ESP32 とは…」みたいに）
• なるべく「なぜそうなるのか」を書く。コピペで動いても理解は進まない