G32S10 MAC LL 接口

1. LL 接口规范

ll_mac.h 中全部接口均为 static inline，通过 mac_regs_t * 直接访问寄存器。LL 层不检查 macx 是否为 NULL，不维护软件状态、不缓存寄存器值，不裁剪入参位域；有读副作用的寄存器（如 DMA_MFOCR）按硬件语义执行。

1.1 实例、版本与能力

1.2 MAC 配置、过滤、流控与中断 mask

补充说明：MAC_ISR 读操作可能带硬件清除语义，LL 不做额外处理；LL 没有提供 MAC_IMR 的按位 set/clear 接口，需要调用方自己读改写。

1.3 MAC 地址寄存器

1.4 MDIO 接口

补充说明：ll_mac_mdio_start() 不做参数检查，PA/GR/CR/GW/GB 必须由调用方拼好；事务是否完成只能通过 ll_mac_mdio_is_busy() 或中断状态间接判断。

1.5 DMA 总线模式与描述符基地址

说明：两个描述符基地址寄存器都只保存 32 位地址，超出 32 位的系统地址不能直接用于 DMA。

1.6 DMA 状态、操作模式与中断使能

说明：ll_mac_dma_clear_status() 只能清除 MAC_DMA_SR_CLEARABLE_MASK（0x0001E7FF）覆盖的位，调用方应只清除自己已处理的位。

1.7 DMA poll demand、RX watchdog、计数与诊断

补充说明：poll demand 只是“重新查描述符”的门铃，不代表发送/接收已完成，完成状态必须通过描述符 OWN 位或 DMA_SR 判断；DMA_MFOCR 的读清副作用意味着只在需要统计/调试时读取，且每次读取都会丢失上一次计数；DMA_AHBSR 是瞬时 AHB master 状态快照，AXWHSTS 会随总线活动快速变化。

1.8 DMA 当前指针

说明：当前指针寄存器是只读诊断信息，会随 DMA 运行变化，不能代替描述符 OWN 位的完成判断。

1.9 LL 使用约定

• 整寄存器写接口（ll_mac_set_frame_filter、ll_mac_set_flow_control、ll_mac_set_interrupt_mask、ll_mac_dma_set_bus_mode、ll_mac_dma_set_operation_mode、ll_mac_dma_set_interrupt_enable、ll_mac_dma_set_rx_watchdog、ll_mac_mdio_start）会覆盖寄存器全部位。

• 有读清语义的寄存器：DMA_MFOCR；MAC_ISR 为只读寄存器，读操作是否带清除语义以硬件手册为准。

• LL 不负责时钟、复位、cache 维护和中断注册。

2. 寄存器映射与位域约定

2.1 寄存器布局

保留区间：0x0028-0x002C、0x0050-0x06FC、0x073C-0x075C、0x0768-0x077C、0x0788-0x0FFC、0x1028、0x1030-0x1044。

2.2 MAC_CR（0x0000）

HAL 初始化置位组合：

#define MAC_CR_CORE_INIT_MASK   (MAC_CR_JD_MASK | MAC_CR_PS_MASK | MAC_CR_ACS_MASK | MAC_CR_BE_MASK)

2.3 MAC_FFR（0x0004）

2.4 MAC_HTHR/MAC_HTLR、GMII_AR/GMII_DR

说明：MAC_HTHR/MAC_HTLR 只有寄存器与位域定义，HAL/LL 未提供访问函数。

2.5 MAC_FCR（0x0018）与 MAC_VTR（0x001C）

说明：MAC_VTR 只有位域定义，HAL/LL 未提供 VLAN 配置函数。

2.6 MAC_ISR（0x0038）与 MAC_IMR（0x003C）

2.7 MAC 地址寄存器

2.8 DMA_BMR（0x1000）

2.9 DMA_TPDR/DMA_RPDR、DMA_RDLAR/DMA_TDLAR

说明：LL 的 ll_mac_dma_poll_tx()/ll_mac_dma_poll_rx() 固定写 1。

2.10 DMA_SR（0x1014）

可清除位集合：

#define MAC_DMA_SR_CLEARABLE_MASK      ((uint32_t)0x0001E7FFU)

0x0001E7FF 覆盖 TI、TPS、TU、TJT、OVF、UNF、RI、RU、RPS、RWT、ETI、FBI、ERI、AIS、NIS，不包含 GLPII、TTI、GPI、GMI、GLI、EB、TS、RS。写 1 清除，写 0 无影响。

2.11 DMA_OMR（0x1018）

辅助 mask：

#define MAC_DMA_OMR_TTC_CLEAR_MASK     ((uint32_t)0xFFFE3FFFU)
#define MAC_DMA_OMR_RTC_CLEAR_MASK     ((uint32_t)0xFFFFFFE7U)

HAL 初始化写入值：TSF | RSF | OSF；启动时追加 ST | SR，停止时清除 ST | SR。

2.12 DMA_IER（0x101C）

HAL 使用的中断使能组合：

#define MAC_DMA_IER_NORMAL_IRQ_MASK      (MAC_DMA_IER_NIE_MASK | MAC_DMA_IER_RIE_MASK | MAC_DMA_IER_TIE_MASK)
#define MAC_DMA_IER_ABNORMAL_IRQ_MASK    (MAC_DMA_IER_AIE_MASK | MAC_DMA_IER_FBE_MASK | MAC_DMA_IER_UNE_MASK)

2.13 DMA_MFOCR、DMA_RIWTR、DMA_AHBSR 与当前指针

说明：DMA_MFOCR 为读清寄存器，读取会清除计数与 overflow 标志。

2.14 HWFR（0x1058）

2.15 未封装的寄存器区域

以下寄存器在 mac_regs.h 中有完整布局和位域定义，但 HAL 与 LL 都没有提供访问函数，只能由调用方直接操作 mac_regs_t 或按硬件手册实现：