# parking_radar 驗證紀錄

- 日期：2026-11-17（Asia/Taipei, UTC+8），模擬執行時間約 08:35–08:38 UTC+8
- 作業系統：Linux x86_64
- **驗證等級：已編譯（arduino-cli 1.6.0）、本機模擬器實測（SimulIDE 1.1.0-SR2，2026-11-17；HC-SR04 為模擬器內建元件，以電壓設定距離，非實體聲波）。未在實體硬體上測試。**

## 1. 編譯

| 項目 | 版本 |
|---|---|
| arduino-cli | 1.6.0（commit 50a0e80da） |
| 核心 | arduino:avr 1.8.8 |
| 編譯器 | avr-gcc 7.3.0-atmel3.6.1-arduino7 |
| 板型 | arduino:avr:uno |
| 外部函式庫 | 無（只用 pulseIn、tone、noTone、millis） |

指令：`arduino-cli compile --fqbn arduino:avr:uno --output-dir build parking_radar`

結果（compile-uno.log）：
```
Sketch uses 5184 bytes (16%) of program storage space. Maximum is 32256 bytes.
Global variables use 262 bytes (12%) of dynamic memory, leaving 1786 bytes for local variables. Maximum is 2048 bytes.
```
parking_radar.ino.hex sha256：a7161888fd93ec9654be21e04e34e0be6b60142e6d98fa25d5ec9d47a2eaf302

## 2. SimulIDE 模擬

- SimulIDE 1.1.0-SR2（Linux 64，官方下載 https://simulide.com/p/download110/ ，GPLv3）
  - 檔案 SimulIDE_1.1.0-SR2_Lin64.tar.gz，sha256 957b95822c7d1fb9153afce0a8e0ffe2ba5550e27d2f6f2a7d8ac083c992e9b5
  - 在 SimulIDE 圖形介面開啟電路檔，按下「電源」開始模擬，再擷取畫面。
- 電路（make_circuit.py 產生，成品為 parking_radar.sim1）：Arduino Uno（mega328，16 MHz）、SimulIDE 內建 HC-SR04（TRIG→D8、ECHO→D9）、Audio Out 設為 Buzzer 模式（D3）、三顆 LED 各串 220Ω（D5 綠、D6 黃、D7 紅）、Logic Analyzer（D3、D8、D9，200 ms/格）。
- SimulIDE 的 HC-SR04 以「Dist.」腳的電壓代表距離：1 V = 1 m（官方元件說明 https://simulide.com/p/component-list/ ）。**沒有真實聲波**。
- 序列輸出：電路中的 SerialPort 元件接到電腦的虛擬序列埠，以 9600 8N1 記錄成 serial-logs/serial-*.log。
- 每個案例模擬約 10 秒（畫面顯示「Real Speed 約 100%」，即模擬時間≈真實時間）。

### 結果

| 案例 | 設定電壓 → 距離 | 序列埠讀值（cm） | zone | LED | 邏輯分析儀量到的嗶聲起點間隔 | 預期 | 判定 |
|---|---|---|---|---|---|---|---|
| d500 | 5.00 V → 500 cm | 495.7 | CLEAR | 全暗 | 無嗶聲 | 不叫 | 通過 |
| d150 | 1.50 V → 150 cm | 148.7–148.8 | CLEAR | 全暗 | 無嗶聲 | 不叫 | 通過 |
| d080 | 0.80 V → 80 cm | 79.4 | FAR | 綠 | 600, 600 ms | 600 ms | 通過 |
| d040 | 0.40 V → 40 cm | 39.7 | MID | 黃 | 300（一次 293）ms | 300 ms | 通過 |
| d030 | 0.30 V → 30 cm | 29.8 | MID | 黃 | 300 ms | 300 ms | 通過 |
| d018 | 0.18 V → 18 cm | 17.4–17.9 | NEAR | 紅 | 147–153 ms | 150 ms | 通過 |
| d010 | 0.10 V → 10 cm | 9.6–9.7 | STOP | 紅 | 連續方波（長音） | 長音 | 通過 |
| d006 | 0.06 V → 6 cm | 5.8–5.9 | STOP | 紅 | 連續方波（長音） | 長音 | 通過 |
| d000 | 0.00 V → 0 cm | 1.9–2.0 | STOP | 紅 | 連續方波（長音） | 長音 | 通過（模型最小約 2 cm） |

- 嗶聲間隔是從邏輯分析儀截圖量的（每格 200 ms = 30 px，解析度約 ±7 ms），每聲長度量到約 60 ms（程式設定 50 ms，誤差來自截圖解析度與 loop 週期）。
- 觀察：讀值比設定距離低約 0.6–3%（例如 150 cm 讀成 148.7 cm、18 cm 讀成 17.4–17.9 cm）。原因未查證（可能來自 pulseIn 的計時方式或模擬器模型），不能拿來推論實機誤差。
- 原始資料：serial-logs/serial-d*.log（序列埠紀錄，數字為公分）、la-d*.png（邏輯分析儀截圖）、parking_radar.sim1（電路檔）。

## 3. 沒有測到的

- 實體 Arduino、實體 HC-SR04、實體蜂鳴器與 LED（全部未測）
- 真實聲波：反射面材質（布、海綿等軟表面）、角度、多重反射、溫度造成的聲速變化
- 電源與電氣：5V 供電壓降、電流、雜訊、接觸不良、杜邦線長度
- 蜂鳴器實際音量與音色
- 有源蜂鳴器版本：把 `ACTIVE_BUZZER` 改成 `true` 後只編譯過（4464 bytes，13%；），沒有模擬

## 除錯案例（2026-11-17 追加，SimulIDE 1.1.0-SR2，距離固定 30 cm = 0.30 V，每案約 12 秒）

| 案例 | 韌體 | 電路 | 序列埠 | D3 蜂鳴器／LED | 紀錄檔 |
|---|---|---|---|---|---|
| debug-swap | parking_radar.ino（正確） | TRIG↔ECHO 對調 | `dist_cm=none zone=CLEAR` | 無輸出／全暗 | serial-logs/serial-debug-swap.log、debug-swap.png |
| debug-noecho | parking_radar.ino（正確） | ECHO 未接 | `dist_cm=none zone=CLEAR` | 無輸出／全暗 | serial-logs/serial-debug-noecho.log |
| debug-naive-noecho | debug/naive_no_timeout.ino | ECHO 未接 | `dist_cm=0.0 zone=STOP`，約每 0.75 s 一行 | 持續高電位（長音）／紅燈 | serial-logs/serial-debug-naive-noecho.log、debug-naive-noecho.png |
| debug-naive-normal | debug/naive_no_timeout.ino | 正確 | `dist_cm=29.8 zone=MID` | 300 ms 間隔／黃燈 | serial-logs/serial-debug-naive-normal.log |
| debug-forgot-half | debug/forgot_half.ino | 正確 | `dist_cm=59.6 zone=FAR` | 600 ms 間隔／綠燈 | serial-logs/serial-debug-forgot-half.log、debug-forgot-half.png |
| debug-wrong-unit | debug/wrong_unit.ino | 正確 | `dist_cm=298.1 zone=CLEAR` | 無輸出／全暗 | serial-logs/serial-debug-wrong-unit.log、debug-wrong-unit.png |

編譯大小：naive_no_timeout 5,134 bytes、forgot_half 5,172 bytes、wrong_unit 5,184 bytes（arduino-cli 1.6.0、arduino:avr 1.8.8）。
限制：模擬器未接線的腳位不會浮接，無法重現實機的雜訊亂跳；硬體端原因（接觸不良、供電、雜訊、角度、軟表面）未在本紀錄中測試。
