feat(comm): 1.6.22 稀疏写 ESC + 1.6.23~24 pmDrive 电源管理; LAN9252 性能审计报告

GD32E508_DCU_APP/comm/esc_lan9252.h

@@ -46,6 +46,18 @@ public:
      *  驱动高读回低 => ECAT_NRST 被按死在复位,LAS9252 永在复位态。 */
     static uint8_t nrstDrive(uint8_t action);
 
+    /** @brief 诊断:LAN9252 芯片级电源管理(休眠/唤醒,SPI 0xA2 action 30+ 转发到此)。
+     *  @param op 0=读状态 1=进 D1 2=进 D2 3=进 D3(先两 PHY General Power Down) 4=手动唤醒
+     *  @return 打包状态字节 bit0=READY bit1=PM_SLEEP_EN bit3:2=PM_MODE;
+     *          唤醒 op 另有 1=成功 0=超时;0xEE=无效 op;0xE1=HBI 总线未就绪。
+     *  @note DS 6.3:PMT_CTRL(0x084) PM_MODE[31:29] 选档 + PM_SLEEP_EN(bit28) 进入,
+     *        两字段必须分两次写。D1/D2/D3 下主机接口停摆、EtherCAT 通信中断(主站
+     *        wkc 报错),唤醒后 PM_MODE/PM_SLEEP_EN 自清、寄存器配置保留、READY 回高
+     *        (正常 ≤2ms)。D3 最深(晶振/PLL 全关)且手册要求先置两 PHY BMCR.PowerDown
+     *        (经 ESC 核心 MII 管理 0x0510 间接访问,PHY A 地址模式相关 0/2 运行期判定),
+     *        唤醒后本函数自动恢复 PHY 上电,链路重新自协商需数秒。 */
+    static uint8_t pmDrive(uint8_t op);
+
     /**
      * @brief 读取 ESC 芯片 ID(INIT-ONLY,供 init 打印诊断用)。
      * @return uint32_t 32-bit 芯片 ID(期望值 0x87654321)。
@@ -102,6 +114,7 @@ private:
     static bool s_busReady;  /**< init 完整成功(EXMC+IDX 探针+BYTE_TEST)后置位。 */
     static bool s_coreReady; /**< EEPROM 加载完成、EtherCAT 核心使能后置位(1.5.39)。 */
     static bool s_resetDone; /**< hardwareReset 已执行门控(防二次复位清掉 SSC 配置)。 */
+    static bool s_pmPhyDown; /**< pmDrive 进 D3 时两 PHY 已被置 PowerDown,唤醒后需恢复。 */
 };
 
 #endif /* COMM_ESC_LAN9252_H */