A2：HAL 接口（i2c/gpio/pwm/time）+ sim 与 ESP 两套实现

接口在 components/phonerail_hal/include/，宿主机链 sim/、ESP32-S3 链 esp/
（IDF v5.4 新版 i2c_master / gpio / LEDC / esp_timer）。

sim 提供 A3 起要用的假板子控制面：假 I²C 器件（寄存器表 + 大端 + 指针自增）、
可注入 NAK / 器件失联、GPIO 外部驱动与写计数、虚拟时钟。

组件名不叫 hal —— ESP-IDF 自己有 components/hal（driver 依赖它），同名会盖掉。

验收：bash host/test.sh → 3 条 ctest 全过；build_idf.ps1 → 编过且零警告。

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01QYuExfgyYa6DzRRcUso8M8

固件开发计划.md

@@ -133,7 +133,7 @@ firmware/
 │   ├── evlog.c           事件环形缓冲（§10.7）
 │   └── thermal.c         风扇闭环（§10.3）
 ├── components/
-│   ├── hal/              i2c / gpio / pwm / time 的**接口**
+│   ├── phonerail_hal/    i2c / gpio / pwm / time 的**接口**（`include/`）
 │   │   ├── esp/          真实实现（ESP-IDF）
 │   │   └── sim/          模拟实现（宿主机）
 │   └── drv/              ina226 / dac63204 / pca9555 / hc595 / lm75
@@ -144,6 +144,11 @@ firmware/
 **HAL 只抽象四样东西：I²C 事务、GPIO 电平、PWM/定时、单调时钟。**
 不要抽象得更多 —— 抽象层每多一个概念，后面每次会话都要多读一遍。
 
+> ⚠️ **组件名不能叫 `hal`**（A2 实测）：ESP-IDF 自己有一个 `components/hal`，
+> `driver` 依赖它，同名会被工程里的这个盖掉。所以目录是 `phonerail_hal`。
+> 头文件名 `hal_i2c.h` / `hal_gpio.h` / `hal_pwm.h` / `hal_time.h` 不冲突
+> （IDF 那个的头都在 `hal/` 前缀下）。
+
 ### 4.2 决定二：先写模拟器（A2 + A3 之前）
 
 没有模拟器，每个任务包的「验收」都只能写成「等板子到了再说」，