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/host/CMakeLists.txt

@@ -5,6 +5,9 @@
 # 与 IDF 目标共享的源码只有 ../main 里的与硬件无关部分。
 # 新增一个既要上板又要被测的 .c，必须同时加进：
 #   ../main/CMakeLists.txt 的 SRCS   和   下面的 PHONERAIL_CORE_SRCS
+# HAL 里新增一路实现则要同时加进：
+#   ../components/phonerail_hal/CMakeLists.txt 的 SRCS（esp 那份）
+#   和下面的 PHONERAIL_HAL_SIM_SRCS（sim 那份）
 cmake_minimum_required(VERSION 3.16)
 project(phonerail_host C)
 
@@ -19,8 +22,22 @@ set(PHONERAIL_CORE_SRCS
     ${FW_ROOT}/main/version.c
 )
 
-add_library(phonerail_core STATIC ${PHONERAIL_CORE_SRCS})
-target_include_directories(phonerail_core PUBLIC ${FW_ROOT}/main)
+# HAL：接口在 include/，宿主机链 sim/ 的实现（esp/ 那份只有 IDF 目标编）。
+set(PHONERAIL_HAL_DIR ${FW_ROOT}/components/phonerail_hal)
+set(PHONERAIL_HAL_SIM_SRCS
+    ${PHONERAIL_HAL_DIR}/hal_err.c
+    ${PHONERAIL_HAL_DIR}/sim/sim_hal.c
+    ${PHONERAIL_HAL_DIR}/sim/hal_i2c_sim.c
+    ${PHONERAIL_HAL_DIR}/sim/hal_gpio_sim.c
+    ${PHONERAIL_HAL_DIR}/sim/hal_pwm_sim.c
+    ${PHONERAIL_HAL_DIR}/sim/hal_time_sim.c
+)
+
+add_library(phonerail_core STATIC ${PHONERAIL_CORE_SRCS} ${PHONERAIL_HAL_SIM_SRCS})
+target_include_directories(phonerail_core PUBLIC
+    ${FW_ROOT}/main
+    ${PHONERAIL_HAL_DIR}/include
+    ${PHONERAIL_HAL_DIR}/sim)
 
 # ---- 测试框架 Unity（从 ESP-IDF v5.4 原样复制到 third_party/，与上板测试同一套）
 add_library(unity STATIC ${FW_ROOT}/third_party/unity/unity.c)