GMAC接口（4）——实战：从零构建DWC_ether_qos驱动

1. 硬件复位与PHY初始化

在嵌入式网络开发中，GMAC控制器与PHY芯片的配合就像一对舞伴，需要先完成"热身动作"才能流畅协作。以常见的RTL8211F PHY为例，硬件复位是最容易被忽视但至关重要的第一步。我曾在项目中发现，跳过硬件复位直接进行软件配置，会导致PHY状态不稳定，出现间歇性丢包问题。

硬件复位的本质是通过GPIO发送一个持续10ms以上的低电平脉冲。具体操作可以参考以下代码片段：

// 假设PHY_RST连接到GPIO3_5 #define PHY_RESET_GPIO 3, 5 void phy_hard_reset(void) { gpio_set_direction(PHY_RESET_GPIO, GPIO_OUTPUT); gpio_set_level(PHY_RESET_GPIO, 0); // 拉低复位 delay_ms(15); // 保持15ms确保可靠复位 gpio_set_level(PHY_RESET_GPIO, 1); // 释放复位 delay_ms(100); // 等待PHY稳定 }

复位完成后，需要通过MDIO接口与PHY建立通信。这里有个坑要注意：不同PHY的寄存器页切换机制可能不同。以RTL8211F为例，需要先写入Page选择寄存器（0x1F），再进行后续配置。实测发现，每次MDIO操作后最好加入1ms延时，否则可能出现访问失败。

2. 控制器初始化三部曲

2.1 软复位操作

GMAC控制器的软复位就像电脑的重启键，可以清除所有不稳定状态。通过设置DMA_Mode.SWR位为1触发软复位，但很多开发者容易忽略复位完成的判断。正确的做法应该是：

gmac->DMA_Mode |= (1 << 0); // 置位SWR while(gmac->DMA_Mode & (1 << 0)); // 等待SWR自动清零

2.2 中断管理策略

在初始化阶段关闭所有中断是个好习惯，可以避免配置过程中的意外中断干扰。但要注意，MAC和DMA的中断使能寄存器是分开的，需要分别处理：

gmac->MAC_Interrupt_Enable = 0; // 关闭MAC所有中断 gmac->DMA_CH0_Interrupt_Enable = 0; // 关闭DMA通道0中断

2.3 时钟域同步

GMAC控制器通常运行在多个时钟域，配置前需要确保时钟稳定。我在Cortex-A53平台上遇到过因为时钟未就绪导致配置失效的问题，后来增加了以下检查：

while(!(gmac->DMA_Status & (1 << 2))); // 等待DMA时钟域稳定

3. DMA引擎深度配置

3.1 总线优化技巧

DMA作为数据搬运工，其总线配置直接影响传输效率。推荐配置如下：

• 使能地址对齐（AAL=1）：避免非对齐访问的性能损失
• 禁用固定突发（FB=0）：让DMA自动优化突发长度
• 设置PBL=8：平衡延迟和吞吐量的黄金值

gmac->DMA_SysBus_Mode = (1 << 12) | (8 << 1); // AAL=1, PBL=8

3.2 通道专属配置

发送和接收通道需要独立优化。实测发现，TxPBL和RxPBL设置为不同值有时能获得更好性能：

gmac->DMA_CH0_Tx_Control = (8 << 11); // TxPBL=8 gmac->DMA_CH0_Rx_Control = (4 << 14); // RxPBL=4

4. MTL层精细化调优

4.1 队列调度算法

MTL层的队列调度直接影响QoS表现。对于普通应用，建议：

• 关闭WRR权重轮询（WRR=0）
• 禁用严格优先级（SR=0）
• 采用简单FIFO模式

gmac->MTL_Operation_Mode = 0; // 全部使用默认FIFO

4.2 存储转发模式

启用存储转发(TSF/RSF=1)虽然会增加少量延迟，但能显著提高稳定性。特别是在以下场景必备：

• 不同速率设备互联时
• 存在线路干扰的环境
• 需要完整错误检查的场合

// 配置TxQ0 gmac->MTL_TxQ0_Operation_Mode = (1 << 21) | (4 << 16); // TSF=1, TQS=4(4096B) // 配置RxQ0 gmac->MTL_RxQ0_Operation_Mode = (1 << 21) | (4 << 20); // RSF=1, RQS=4(4096B)

5. MAC层核心配置

5.1 MAC地址设置

MAC地址需要分两次写入32位寄存器，注意字节序问题。我推荐使用这个工具函数：

void set_mac_address(uint8_t *mac) { gmac->MAC_Address0_Low = (mac[3]<<24)|(mac[2]<<16)|(mac[1]<<8)|mac[0]; gmac->MAC_Address0_High = (mac[5]<<8)|mac[4]; }

5.2 速率与双工模式

MAC_Configuration寄存器的配置需要与PHY实际协商结果一致。一个常见的错误是硬编码速率设置，正确做法应该读取PHY状态寄存器后动态配置：

uint32_t phy_status = read_phy_register(1); gmac->MAC_Configuration = ((phy_status & (1<<13)) ? (1<<14) : 0) // FES | ((phy_status & (1<<8)) ? (1<<11) : 0); // DM

6. 描述符环实战构建

6.1 接收描述符环

接收描述符环就像快递柜，需要提前准备好足够格子。推荐使用4个描述符（N=4）的环形结构，每个描述符关联一个2KB的缓冲区：

struct dma_desc { uint32_t buf1_addr; uint32_t buf2_addr; uint32_t buf_len; uint32_t flags; } __attribute__((packed)); struct dma_desc rx_ring[4]; uint8_t rx_buf[4][2048]; void setup_rx_descriptors(void) { for(int i=0; i<4; i++) { rx_ring[i].buf1_addr = (uint32_t)rx_buf[i]; rx_ring[i].flags = (1<<31) | (1<<30); // IOC=1, BUF1V=1 } gmac->DMA_CH0_RxDesc_List_Address = (uint32_t)rx_ring; gmac->DMA_CH0_RxDesc_Tail_Pointer = (uint32_t)&rx_ring[3]; }

6.2 发送描述符环

发送描述符环需要支持链式操作，关键是要正确设置首尾标志：

struct dma_desc tx_ring[4]; void setup_tx_descriptors(void) { for(int i=0; i<4; i++) { tx_ring[i].flags = (i==0 ? (1<<29) : 0) // FD=1 for first | (i==3 ? (1<<28) : 0); // LD=1 for last } gmac->DMA_CH0_TxDesc_List_Address = (uint32_t)tx_ring; }

7. 数据收发实战

7.1 发送数据流程

发送数据就像寄快递，需要三步操作：

1. 填写快递单（描述符）
2. 把包裹放上车（设置OWN位）
3. 发车（启动DMA）

int send_packet(uint8_t *data, int len) { static int tx_idx = 0; // 等待描述符可用 while(tx_ring[tx_idx].flags & (1<<31)) { // 可加入超时处理 } // 设置描述符 tx_ring[tx_idx].buf1_addr = (uint32_t)data; tx_ring[tx_idx].buf_len = len | (1<<30); // B1L=len, IOC=1 // 移交控制权 tx_ring[tx_idx].flags |= (1<<31); // OWN=1 // 更新尾指针触发传输 gmac->DMA_CH0_TxDesc_Tail_Pointer = (uint32_t)&tx_ring[tx_idx]; tx_idx = (tx_idx + 1) % 4; return 0; }

7.2 接收数据处理

接收数据要定期检查描述符状态，类似查看快递柜：

int receive_packet(uint8_t *buf) { static int rx_idx = 0; if(!(rx_ring[rx_idx].flags & (1<<31))) { // OWN=0表示数据就绪 uint32_t len = rx_ring[rx_idx].buf_len & 0x3FFF; memcpy(buf, rx_buf[rx_idx], len); // 回收描述符 rx_ring[rx_idx].flags = (1<<31) | (1<<30); // OWN=1, BUF1V=1 gmac->DMA_CH0_RxDesc_Tail_Pointer = (uint32_t)&rx_ring[rx_idx]; rx_idx = (rx_idx + 1) % 4; return len; } return -1; // 无数据 }

8. 中断驱动优化

虽然轮询方式简单，但实际项目中推荐使用中断驱动。需要精心设计中断处理流程：

void gmac_irq_handler(void) { uint32_t dma_status = gmac->DMA_Status; // 处理接收中断 if(dma_status & (1<<6)) { // RI=1 while(receive_packet(rx_temp_buf) > 0) { // 交给协议栈处理 } gmac->DMA_Status = (1<<6); // 清除中断标志 } // 处理发送完成中断 if(dma_status & (1<<0)) { // TI=1 // 可进行发送统计等操作 gmac->DMA_Status = (1<<0); } }

在最近的一个工业网关项目中，采用这种驱动架构后，即使在80%网络负载下也能稳定实现950Mbps的吞吐量。关键是要确保描述符环足够大（建议不少于8个），并且中断处理中不要做耗时操作。