セットアップガイド

開発環境セットアップ

ファームウェアビルド環境

PlatformIO をインストールする（VS Code拡張推奨）。
VS Codeでプロジェクトフォルダ（ impl/firmware_sensor または impl/firmware_repeater ）を開く。
PlatformIOツールバーから対象の環境を選択しビルドする。

ドキュメントビルド環境

Python 3.10以上をインストールする。
依存パッケージをインストールする:
```
pip install -r docs/requirements.txt
```

ドキュメントをビルドする:

sphinx-build -b html docs/source docs/build

センサーセットアップ

ハードウェア準備

Seeed Studio XIAO ESP32C3 を用意する。
NiMH電池×4本（直列）を電池ボックスに入れ、1N4007ダイオード経由で5Vピンに接続する（回路は 電源回路設計 (DES_POWER) を参照）。
分圧回路（R1=100kΩ, R2=22kΩ, ツェナー3.6V, コンデンサ）を組み、A0ピンに接続する（回路は 電圧測定回路設計 (DES_VOLT_SENSE) を参照）。
GNDを車両ボディアースに接続する（ GND共通化制約 (DES_GND) ）。

ファームウェア書き込み

impl/firmware_sensor フォルダをPlatformIOで開く。
環境 seeed_xiao_esp32c3_main を選択してビルド・書き込みする。

中継器セットアップ

ハードウェア準備

Seeed Studio XIAO ESP32C3 を用意する（センサーと同一MCU）。
エアコンの壁穴を通したUSBケーブルで給電し、窓の外側に設置する。

WiFi・GAS設定

impl/firmware_repeater/src/secrets.h.example をコピーして secrets.h を作成する:

cp impl/firmware_repeater/src/secrets.h.example impl/firmware_repeater/src/secrets.h

secrets.h にWiFi SSID・パスワードとGAS Webhook URLを記入する。

Google Apps Script (GAS) Webhook構築

Google Spreadsheet を新規作成し、A1に timestamp 、B1に voltage_mv と入力する。

メニュー「拡張機能」→「Apps Script」を開き、以下のスクリプトを貼り付ける:

function doPost(e) {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var csv = e.postData.contents;
  var rows = csv.trim().split("\n");
  for (var i = 0; i < rows.length; i++) {
    var cols = rows[i].split(",");
    sheet.appendRow(cols);
  }
  return ContentService.createTextOutput("OK");
}

「デプロイ」→「新しいデプロイ」→ 種類「ウェブアプリ」を選択する。実行するユーザーは「自分」、アクセス権は「全員」に設定しデプロイする。
表示されるURLを secrets.h の GAS_WEBHOOK_URL に設定する。

ファームウェア書き込み

impl/firmware_repeater フォルダをPlatformIOで開く。
環境 seeed_xiao_esp32c3_main を選択してビルド・書き込みする。