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/components/phonerail_hal/hal_err.c

@@ -0,0 +1,14 @@
+#include "hal_err.h"
+
+const char *hal_err_str(hal_err_t err)
+{
+    switch (err) {
+    case HAL_OK:          return "OK";
+    case HAL_ERR_ARG:     return "ARG";
+    case HAL_ERR_NAK:     return "NAK";
+    case HAL_ERR_TIMEOUT: return "TIMEOUT";
+    case HAL_ERR_BUS:     return "BUS";
+    case HAL_ERR_STATE:   return "STATE";
+    }
+    return "?";
+}