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/include/hal_gpio.h

@@ -0,0 +1,31 @@
+/* 单根 GPIO 的方向与电平。74HC595 的三根线、五路 PG/FLT、风扇 TACH 都走这里。 */
+#ifndef HAL_GPIO_H
+#define HAL_GPIO_H
+
+#include "hal_err.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef enum {
+    HAL_GPIO_INPUT = 0,
+    HAL_GPIO_INPUT_PULLUP,
+    HAL_GPIO_OUTPUT,
+} hal_gpio_mode_t;
+
+hal_err_t hal_gpio_config(int pin, hal_gpio_mode_t mode);
+
+/* 写一个没配成输出的脚返回 HAL_ERR_ARG，不是悄悄成功 ——
+   「把输入脚当输出用」是 PCA9555 那条禁令（计划 A6）的 GPIO 版本，
+   在宿主机测试里就要响。 */
+hal_err_t hal_gpio_write(int pin, int level);
+
+/* level 用出参，是为了把「读到低电平」和「读失败」分开。 */
+hal_err_t hal_gpio_read(int pin, int *level);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* HAL_GPIO_H */