A6：PCA9555 驱动 + 「接地脚永远是输入」的硬约束

U23 @ 0x20，16 个脚全部是输入：5×EFUSE_FLT# + 5×EFUSE_PGOOD + BUCK_PG
+ INA_ALERT + 4 个焊死在地上的备用脚（P0_7 / P1_5~7）。位表与地址从
.claude/pcb1-parts.json 的真实焊盘网络逐脚核回来，与设计文档 §17.2 一致。

驱动根本不提供「把某个脚配成输出」的接口（和 sr595.h 不提供「抬 OE#」同一条
规矩），方向字一律过 pca9555_dir_safe()，不安全直接 abort。原因是 PCA9555 的
Output Port 寄存器复位值是 0xFF —— 把接地脚配成输出的那一刻它就输出高电平，
而真器件既不报错也不 NAK，只是发烫。

三种极性（FLT# 低有效 / PGOOD 高有效 / INA_ALERT 低有效）各自只在一个函数里
出现一次；上层问「有没有故障」，不许自己去 & 位。

sim 侧新增按 datasheet 建模的假 PCA9555：Output 复位 0xFF、输入按位合成、
接地脚被驱动时记短路、INT# 只被「读输入端口」清除。为此给假 I²C 总线加了一个
窃听钩子（POST_WRITE / PRE_READ）—— 通用寄存器表模拟不了「配成输出就对地
短路」这类事，以后再有这种器件照这个挂。

验收：8 条 ctest（81 用例）全绿；idf.py build 通过，pca9555.c.obj 在。
12 个「一定会被写出来的错」逐个注进去跑过，全部变红。

Co-Authored-By: Claude Opus 5 <[email protected]>

这个提交包含在：

zhou yang

2026-09-07 06:28:11 +08:00

共同撰写人

Claude Opus 5

父节点 ab37f9dc49

当前提交 eb3df9ff49

共修改 12 个文件，包含 962 行新增和 59 行删除

									
										firmware/main/phonerail.h
									
		+1
		-1
	
												查看文件
												
				@@ -3,7 +3,7 @@

				#define PHONERAIL_H

				/* 固件版本。规则：<主>.<次>.<修订>-<最后完成的任务包> */

				#define PHONERAIL_FW_VERSION "0.1.0-a5"

				#define PHONERAIL_FW_VERSION "0.1.0-a6"

				/* 通道数。五路直供，见设计文档 §2。 */

				#define PHONERAIL_RAIL_COUNT 5