Power management IC

Power management IC 表示仓库主要维护电源转换、调压、监测或供电控制类芯片的驱动边界，并把这些电源语义当作独立主题来维护。这里的主语不是 generic embedded 外设，而是会直接改变供电行为的 PMIC / buck-boost / regulation 类器件。

它通常和 Async embedded、Embedded Rust、I2C 一起出现，但不替代这些 Topic：Power management IC 解释的是电源配置面、状态语义和安全默认值，其他 Topic 解释运行时、驱动生态或总线协议（projects/sc8815-rs.md、projects/tps55288-rs.md）。

当 README、crate 描述、project snapshot 或代码结构明确表明仓库围绕 PMIC、buck-boost、regulator、power monitor 等芯片维护驱动时使用。若只是电池管理、USB PD 或一般传感器的一部分，则要优先判断是否应归到更具体 Topic。

如果一个改动会影响寄存器配置面、输出电压/电流语义、ADC/status 解释、错误处理、默认安全值或 async/logging 扩展方式，就应该命中本 Topic。

• Emphasis on clear configuration surfaces and safe defaults (projects/sc8815-rs.md)
• Optional async and embedded logging are common to match firmware runtime choices (projects/tps55288-rs.md)
• 应优先提供清晰的 typed configuration 和安全默认值。对 PMIC 类芯片，模糊的魔数接口会让后续维护者难以判断某次改动是否会改变供电行为。
• async support 和 embedded logging 适合作为扩展层，但电源语义本身应与执行模型解耦，避免同步/异步两套实现各自漂移。
• 回答此 Topic 时，要说明它究竟控制什么电源面：升降压、限流、状态监测还是告警/ADC。否则“电源管理芯片”会宽到失去指导性。
• PMIC driver 经常需要在“保持薄封装”和“暴露足够配置语义”之间取平衡。这个 Topic 应鼓励 typed enums/config，而不是只暴露原始寄存器接口（projects/sc8815-rs.md）。

• projects/sc8815-rs.md：适合说明 typed configuration、ADC/status 语义和 power IC driver 的稳定接口应该怎样长成，尤其是哪些配置应该提升成明确类型，而不是继续埋在原始寄存器值里。
• projects/tps55288-rs.md：适合说明 buck-boost 类器件如何把 async/logging 作为扩展能力，而不是核心语义，同时提醒维护者电源路径配置不应因为执行模型变化而拥有两套真相。

• 只因为芯片“和电源有关”就打这个 Topic，会把 battery management、USB PD controller 和 generic monitor 混在一起。
• 把 Power management IC 当成整个仓库的总括标签，忽略 Async embedded、Embedded Rust、I2C 等相邻 Topic，会让后续 Agent 无法判断真正要看的是供电语义、总线行为还是运行时模型。
• 只提供裸寄存器接口、不保留配置和状态语义，会让 driver 看似通用，实则不可维护。
• 忽略默认安全值和输出范围，也会把最危险的电源改动变成“代码编译通过就算过”。

• projects/sc8815-rs.md
• projects/tps55288-rs.md
• skills/style-playbook/references/data/topics/power-management-ic.json