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

firmware/main/CMakeLists.txt

@@ -4,4 +4,5 @@
 idf_component_register(
     SRCS "app_main.c"
          "version.c"
-    INCLUDE_DIRS ".")
+    INCLUDE_DIRS "."
+    REQUIRES phonerail_hal)

firmware/main/app_main.c

@@ -1,11 +1,13 @@
 /* ESP32-S3 入口。只在 ESP-IDF 目标里编译，宿主机构建不包含本文件。 */
 #include "esp_log.h"
+#include "hal_time.h"
 #include "phonerail.h"
 
 static const char *TAG = "phonerail";
 
 void app_main(void)
 {
-    ESP_LOGI(TAG, "PhoneRail %s boot, %d rails", phonerail_version(),
-             PHONERAIL_RAIL_COUNT);
+    /* 引脚表与外设初始化留到 A7/A8；这里只确认 HAL 真的被链进来了。 */
+    ESP_LOGI(TAG, "PhoneRail %s boot, %d rails, t=%u ms", phonerail_version(),
+             PHONERAIL_RAIL_COUNT, (unsigned)hal_time_now_ms());
 }

firmware/main/phonerail.h

@@ -3,7 +3,7 @@
 #define PHONERAIL_H
 
 /* 固件版本。规则：<主>.<次>.<修订>-<最后完成的任务包> */
-#define PHONERAIL_FW_VERSION "0.1.0-a1"
+#define PHONERAIL_FW_VERSION "0.1.0-a2"
 
 /* 通道数。五路直供，见设计文档 §2。 */
 #define PHONERAIL_RAIL_COUNT 5