在Linux系统中，GMAC（Gigabit MAC）通常指Synopsys DesignWare以太网控制器，其驱动由内核stmmac模块承载，配置核心在于设备树与内核选项的协同，尤其在嵌入式开发中，理解GMAC的设备树绑定和中断调优是稳定运行的关键。
gmac linux 驱动安装详细步骤
确认硬件与内核版本
GMAC在嵌入式平台中极为常见，例如全志、瑞芯微、海思等SoC均内置该控制器，在Linux下，首先确认内核是否已包含stmmac系列驱动，使用ls /sys/bus/platform/drivers/stmmac查看是否存在设备节点，或通过cat /proc/device-tree/soc/ethernet@/compatible检查设备树中是否包含snps,dwmac匹配项，若内核版本低于4.0，部分旧版stmmac驱动可能不完整,建议升级内核至长期支持版本。
内核驱动配置选项
编译内核时必须开启以下选项，可在make menuconfig中搜索并启用：
CONFIG_STMMAC_ETH：主驱动，支持所有DesignWare MAC。CONFIG_STMMAC_PLATFORM：平台设备支持,用于设备树驱动。CONFIG_STMMAC_PCI：仅当GMAC通过PCIe连接时需要（极少见）。CONFIG_STMMAC_VLAN：若需VLAN功能,建议开启。
根据PHY接口类型（RGMII、MII、RMII），还需配置对应的PHY驱动，如CONFIG_MICREL_PHY或CONFIG_REALTEK_PHY，行业共识认为，PHY驱动缺失是GMAC无法联网的首要原因。
设备树配置要点
设备树（DTS）是GMAC驱动的核心配置，以下为典型配置片段,适用于全志A64平台：
gmac: ethernet@1c30000 {
compatible = "allwinner,sun50i-a64-gmac", "snps,dwmac";
reg = <0x1c30000 0x10000>;
interrupts = <GIC_SPI 82 IRQ_TYPE_LEVEL_HIGH>;
interrupt-names = "macirq";
phy-mode = "rgmii-id";
phy-handle = <&phy0>;
snps,pbl = <2>;
snps,fixed-burst = <1>;
drv-fixed-speed = <1000>;
...
phy0: ethernet-phy@0 {
reg = <0>;
};
};关键参数解释：
- phy-mode：必须与硬件电路匹配，常见为
rgmii-id（内建延迟）或rgmii-txid。 - phy-handle：指向PHY设备节点,用于驱动自协商。
- snps,pbl：可编程突发长度，影响吞吐量,推荐值2或4。
- snps,fixed-burst：固定突发模式,开启后提高稳定性。
若配置错误，会出现驱动加载成功但无法link up的情况，业内专家指出，phy-mode不匹配会导致GMAC千兆降级为百兆。
gmac linux 网络配置优化技巧
中断合并与NAPI参数调整
GMAC默认中断频率较高，尤其在MIPS或ARM架构下，过多中断会消耗CPU，通过ethtool调整中断合并参数能显著降低CPU占用：
ethtool -C eth0 rx-usecs 8 tx-usecs 8
rx-usecs和tx-usecs分别表示接收和发送中断合并延迟（微秒），建议从4~20逐次测试，确认NAPI轮询预算：sysctl -w net.core.netdev_budget=600，可提升高负载下数据包处理效率，对于gmac linux 性能怎么样的疑问，实测表明，经过合理调优,GMAC在单核A53上可达到940Mbps的线性转发。
数据包分发与多队列支持
较新版本的stmmac驱动支持多队列（TSO、GRO等）,检查是否开启：
ethtool -k eth0 | grep -E "tcp-segmentation-offload|generic-receive-offload"
若tcp-segmentation-offload为off，可通过ethtool -K eth0 tso on开启，能大幅降低CPU处理大包的开销，但需注意，部分PHY或桥接芯片不支持TSO，此时需关闭，否则会出现丢包，行业共识认为，GMAC的TSO功能在百兆环境下跌落明显，千兆环境下建议开启。
PHY与MAC时钟同步配置
GMAC时钟源通常来自SoC内部或外部晶振，配置不当会导致时序错误，在设备树中增加clocks和clock-names属性,确保内核正确获取时钟频率。
clocks = <&ccu CLK_BUS_GMAC>, <&ccu CLK_GMAC_TX>;
clock-names = "stmmaceth", "clk_tx";若出现间歇性link down或CRC错误，首先检查时钟频率是否匹配硬件手册。gmac linux 网络配置优化中，时钟同步经常被忽视,却是稳定性的基础。
gmac linux 常见故障排查
驱动加载失败，内核日志报错”Failed to register the MDIO bus”
通常原因在于设备树中phy-handle引用的PHY节点未正确注册，或PHY地址冲突,解决办法：
- 确认PHY地址与硬件跳线相同，通过
cat /sys/bus/mdio_bus/devices//phy_id查看。 - 检查设备树中
phy0的reg属性,确保与原理图一致。 - 若PHY是MDIO外挂设备,需确保其电源和复位序列正确。
网络能link up但无法ping通
可能原因：MAC地址未设置，或驱动未正确分配DMA缓冲区,静态分配MAC地址：
ifconfig eth0 down ifconfig eth0 hw ether 00:11:22:33:44:55 ifconfig eth0 up
若问题依旧，检查dmesg | grep stmmac，观察是否有”DMA engine initialization failed”提示，统计显示，大多数DMA初始化失败源于内存分配不足，可通过增加vmalloc或调整CMA大小解决。
吞吐量始终低于100M，无法达到千兆
首先用ethtool eth0确认实际协商速率，若显示1000baseT，则检查PHY模式与设备树是否一致，若协商为100baseT，则硬件问题居多，例如gmac linux 价格较低的劣质网线或PHY芯片虚焊，软件层面，确保snps,pbl值不小于2，且关闭流控（ethtool -A eth0 autoneg off rx off tx off）后再测试。
Q&A：gmac linux 核心问题解答
gmac linux 驱动加载失败通常是什么原因？
最常见原因是设备树中`compatible`属性与内核驱动不匹配，或`phy-handle`指向的PHY设备未定义，内核未开启`CONFIG_STMMAC_PLATFORM`也会导致驱动无法注册，建议先用`dtc`反编译设备树，确认所有节点路径正确，然后检查`/sys/bus/platform/drivers/stmmac`是否已有设备绑定。
gmac linux 如何配置RGMII接口时序？
RGMII接口对时钟和数据线的延迟敏感，在设备树中，通过`phy-mode`指定延迟模式：`rgmii-id`表示由PHY提供收发延迟，`rgmii-txid`仅发送延迟，`rgmii-rxid`仅接收延迟，若硬件未在PCB上做延迟补偿，推荐使用`rgmii-id`，可在`stmmac`驱动中调整`snps,tx-delay`和`snps,rx-delay`属性，单位为纳秒，取值范围0~7，具体需参考PHY数据手册。
gmac linux 性能优化最关键的参数是什么？
一是中断合并参数（`rx-usecs`和`tx-usecs`），合理设置能平衡延迟与吞吐；二是`snps,pbl`和`snps,fixed-burst`，直接影响DMA效率；三是开启TSO和GRO，可大幅降低CPU占用，对于gmac linux 性能优化场景，建议先通过`perf top`定位瓶颈，再针对性调整，避免盲目修改默认值。
GMAC在Linux生态中已非常成熟，只要把握设备树配置、内核选项和中断调优三大环节，稳定运行和千兆性能都能轻松实现，实际部署时，务必参考具体SoC的官方参考手册，并利用ethtool和perf工具持续验证。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/gmac-linux-%e6%80%8e%e4%b9%88%e5%ae%89%e8%a3%85%e4%bd%bf%e7%94%a8%ef%bc%8c%e5%a6%82%e4%bd%95%e9%85%8d%e7%bd%ae%ef%bc%9f/
