1. 嵌入式网络硬件架构:MAC与PHY的“黄金搭档”
很多刚接触嵌入式网络开发的朋友,可能会觉得网络驱动很神秘,代码一大堆,协议又复杂。其实,剥开这层复杂的外衣,它的硬件核心就是两个部分:MAC和PHY。你可以把它们想象成一对默契的搭档,一个负责“动脑子”,一个负责“动手脚”。
MAC,全称是媒体访问控制器,它通常集成在SoC芯片内部,是网络的大脑。它的主要工作是按照以太网协议,把上层传下来的数据打包成帧,或者把从PHY收上来的数据帧拆包,交给上层处理。它决定了数据包的格式、发送的时机、冲突的检测等逻辑层面的东西。简单说,MAC就是那个定规矩、发号施令的“指挥官”。
PHY,全称是物理层接口收发器,它是一个独立的芯片,负责“动手”。它把MAC发过来的数字信号,转换成能在网线上跑的模拟电信号;反过来,把从网线上收到的微弱模拟信号,还原成清晰的数字信号交给MAC。它处理的是电压、电流、时钟同步、信号整形这些物理层面的脏活累活。你可以把它理解为负责“冲锋陷阵”的“士兵”。
那么,这对搭档是怎么连接的呢?这就引出了我们今天要重点聊的RGMII接口。在早期的嵌入式设备上,百兆网络(10/100M)常用MII或RMII接口。MII接口需要16根信号线,布线复杂;RMII精简到了7根线,是它的“瘦身版”。但随着对网速要求的提高,千兆网络(10/100/1000M)成为主流,对应的接口就是GMII和它的精简版RGMII。
RGMII接口非常巧妙,它在保持125MHz时钟频率不变的前提下,通过在时钟的上升沿和下降沿都采样数据,将数据线从GMII的8根减少到了4根(TXD[3:0]和RXD[3:0]),极大地简化了硬件设计。正点原子的STM32MP157开发板,就是通过RGMII接口连接内部的MAC和外部的PHY芯片(如RTL8211F或YT8511C)。除了这组高速数据通道,SoC还需要一个低速的管理通道来配置和读取PHY的状态,这就是MDIO接口,它只有两根线(MDC时钟和MDIO数据),很像I2C,用于读写PHY内部那几十个寄存器。
所以,一个典型的嵌入式网络硬件链路是这样的:应用数据 -> Linux网络协议栈 -> MAC控制器 -> RGMII接口 -> PHY芯片 -> 网络变压器 -> RJ45网口。理解了这个数据流向,再看驱动代码,就不会觉得是一团乱麻了。
2. 深入PHY芯片:驱动网络的“无名英雄”
PHY芯片虽然看起来不起眼,但它的工作至关重要。前面提到,IEEE 802.3标准规定了PHY芯片前16个寄存器的功能,这保证了不同厂商的PHY在基础功能上是一致的,Linux内核也因此有了通用的PHY驱动。但就像手机除了通话还有拍照、游戏等特色功能一样,现在的PHY芯片也有很多增强特性,这就需要厂商提供特定的驱动。
以正点原子开发板用过的两颗PHY为例。V1.2版本用的RTL8211F-CG,是瑞昱的经典千兆PHY。我们来看看它几个关键的配置点。首先是PHY地址,MAC通过MDIO总线可以管理多个PHY,靠的就是不同的地址。RTL8211F通过PHYAD[2:0]三个引脚来设置地址,范围是0x1到0x7。在原理图上,这三个引脚可能和RGMII的信号线复用,需要仔细查看数据手册和原理图来确定。比如,如果PHYAD2接高电平(1),PHYAD1和PHYAD0接地(0),那么地址就是0b100,也就是0x4。
另一个重点是RGMII接口的电平。RGMII接口通常有1.8V、2.5V、3.3V等不同电平标准,必须和SoC的IO电平匹配。RTL8211F通过CFG_EXT、CFG_LDO0、CFG_LDO1这三个引脚来配置。根据正点原子的原理图,这三个引脚被配置为3.3V电平,所以在驱动中我们不需要做额外的电平转换处理。
而V1.3及以后版本换成了YT8511C,这颗国产PHY芯片性价比很高。它的配置方式略有不同。它的PHY地址由PHYADDR[2:0]设置,对应的是LED_AC、RXD1和RXD0引脚。在正点原子的板上,这三个引脚都被下拉,所以地址是0x0。这里有个坑需要注意:YT8511C默认不输出125MHz的参考时钟!这对于RGMII接口的千兆模式是必须的。因此,我们必须在驱动中,通过写它的一个扩展寄存器(地址0x0C),将bit[2:1]设置为11,来使能125MHz时钟输出。如果不做这一步,网络很可能无法建立千兆连接。
在实际驱动开发中,我们最常打交道的PHY寄存器是BMCR(基本模式控制寄存器,地址0x0)和BMSR(基本模式状态寄存器,地址0x1)。BMCR的bit[12]是自动协商使能位,我们通常要置1,让PHY和交换机自动协商速率和双工模式。而BMSR则告诉我们当前的状态:比如bit[2]表示链接是否建立(Link Established),bit[5]表示自动协商是否完成。驱动里需要不断地(或通过中断)去读取这些位,来判断网络链路的状态。
3. Linux网络驱动核心:net_device与sk_buff
如果说MAC和PHY是硬件核心,那么net_device和sk_buff就是Linux网络驱动的软件灵魂。理解了它们,你就能看懂一大半的驱动代码。
net_device结构体在内核中代表一个网络设备,它非常庞大,包含了设备的所有信息。驱动开发者的主要工作,就是分配并初始化这个结构体,然后把它注册到内核中。怎么申请呢?对于以太网设备,我们通常用alloc_etherdev_mqs这个函数。它会自动分配一个net_device,并把名字设为“eth%d”(比如eth0, eth1),同时调用ether_setup函数做一些通用的以太网设备初始化。
struct net_device *ndev;
ndev = alloc_etherdev_mqs(sizeof(struct my_private_data), TX_QUEUE_NUM, RX_QUEUE_NUM);
if (!ndev) {
return -ENOMEM;
}
申请到net_device后,最关键的是填充它的操作集——netdev_ops。这是一个充满了函数指针的结构体,驱动的工作就是实现这些回调函数。最重要的几个包括:
ndo_open:当用户执行ifconfig eth0 up时调用。在这里,我们要初始化MAC的DMA、配置PHY、使能中断、启动发送队列。ndo_stop:对应ifconfig eth0 down。在这里关闭DMA、停掉PHY、释放资源。ndo_start_xmit:这是数据发送的入口。当上层有数据包要发送时,最终会调用到这里。参数是一个sk_buff指针,我们需要把这个skb中的数据,通过DMA搬运到MAC的发送FIFO中。ndo_set_mac_address:用于修改网卡的MAC地址。ndo_do_ioctl:处理IOCTL命令,比如我们常用的ethtool工具查询网卡状态,就是通过这个函数进来的。
另一个核心是sk_buff,它是内核中网络数据包的载体。无论是发送还是接收,数据都被封装在sk_buff里。你可以把它想象成一个智能的“数据集装箱”。这个集装箱有头部(head)、数据起始指针(data)、数据结束指针(tail)和集装箱尾部(end)。sk_buff提供了一系列操作函数来高效地管理这个集装箱:
skb_put:在数据区尾部扩展空间,用于添加数据(比如添加协议尾部)。skb_push:在数据区头部扩展空间,用于添加协议头部(比如添加MAC头)。skb_pull:从数据区头部移除数据,用于剥离协议头部(比如去掉MAC头,将IP层数据暴露出来)。skb_reserve:在数据区头部预留空间,通常在一开始分配skb时调用,为后续添加协议头预留位置。
在驱动发送函数ndo_start_xmit中,我们拿到的是一个已经包含了TCP/IP、MAC头等所有信息的完整sk_buff。我们的任务就是把它从内存发送到网线上。而在中断接收函数中,我们从MAC的接收FIFO里读到原始数据,需要自己构造一个sk_buff,把数据放进去,然后调用netif_rx或napi_schedule将这个skb提交给上层网络协议栈去处理。
4. 实战:解析STM32MP1的GMAC驱动框架
理论说了这么多,我们拿一个真实的驱动——ST官方为STM32MP1写的GMAC驱动——来拆解一下,看看这些东西是怎么组合在一起的。驱动源码主要位于 drivers/net/ethernet/stmicro/stmmac/dwmac-stm32.c。
首先看设备树。这是现代Linux驱动的标配,它描述了硬件信息。在stm32mp157.dtsi中,定义了GMAC的基本节点,但状态是disabled。在板级设备树文件(如stm32mp157d-atk.dts)中,我们需要启用并补充细节:
ðernet0 {
status = "okay";
pinctrl-0 = <ðernet0_rgmii_pins_a>;
pinctrl-1 = <ðernet0_rgmii_pins_sleep_a>;
pinctrl-names = "default", "sleep";
phy-mode = "rgmii-id";
phy-handle = <&phy0>;
max-speed = <1000>;
mdio {
#address-cells = <1>;
#size-cells = <0>;
compatible = "snps,dwmac-mdio";
phy0: ethernet-phy@0 {
reg = <0>;
};
};
};
这里的关键属性:
phy-mode = "rgmii-id":指明使用RGMII接口,且由PHY芯片提供RX和TX方向的时钟延迟(-id后缀的含义)。这是保证千兆时序稳定的关键。phy-handle:指向具体的PHY节点。max-speed = <1000>:协商的最大速率。mdio子节点:定义了MDIO总线和PHY,reg = <0>表示这个PHY的地址是0。
驱动入口是stm32_dwmac_probe函数。它的工作流程非常清晰:
- 获取资源:通过
stmmac_get_platform_resources从设备树获取内存、中断等资源。 - 解析配置:
stmmac_probe_config_dt函数解析设备树,填充一个核心结构体plat_stmmacenet_data。这个结构体包含了MAC地址、PHY接口模式、最大速度、PHY总线信息等所有配置。 - 初始化硬件:调用
stm32_dwmac_init。这里会执行一个关键操作:根据phy-mode属性,通过stm32_ops->set_mode函数去配置STM32MP1的SYSCFG寄存器,正确设置RGMII的引脚模式和时钟延迟参数。这一步如果配错,网络可能完全不通或者速度不稳。 - 注册MDIO总线和PHY:调用
stmmac_mdio_register。它会创建并注册一个mii_bus(MDIO总线),并遍历总线上的PHY地址。当找到我们的PHY(地址0)后,调用get_phy_device和phy_device_register,将PHY设备注册到内核的PHY子系统。PHY子系统的通用驱动或厂商特定驱动就会去探测并初始化这颗PHY芯片。 - 注册网络设备:最后调用
stmmac_dvr_probe,这个函数内部会创建net_device,设置好netdev_ops,并最终调用register_netdev,把我们这个网络接口“eth0”注册进内核。
至此,一个完整的网络设备驱动就加载好了。你可以通过ifconfig -a看到它。
5. 数据收发与NAPI机制:效率的奥秘
网络驱动最核心的任务就是高效地收发数据包。STM32MP1的驱动采用了NAPI机制来提升接收效率。NAPI混合了中断和轮询的优点:在数据量小时用中断快速响应,数据量大时关闭中断,改用轮询批量处理,避免中断风暴。
在驱动初始化时(stmmac_dvr_probe内部),会通过netif_napi_add注册两个NAPI轮询函数:
netif_napi_add(ndev, &priv->napi, stmmac_napi_poll, NAPI_POLL_WEIGHT);
这里的stmmac_napi_poll函数,在实际实现中会分别处理发送完成和接收数据。
发送流程相对直接:
- 上层协议栈调用
dev_queue_xmit,最终触发我们驱动netdev_ops里的ndo_start_xmit函数。 - 在这个函数里,驱动将
sk_buff中的数据地址和长度告诉MAC的DMA发送描述符。 - 启动DMA,硬件自动将数据从内存搬运到MAC的发送FIFO,再通过RGMII接口发给PHY。
- 发送完成后,MAC产生一个发送完成中断。
- 在中断处理函数中,驱动会调度NAPI(调用
napi_schedule),在软中断上下文中执行stmmac_napi_poll来清理已发送的sk_buff,释放资源。
接收流程是NAPI的用武之地:
- 当PHY接收到数据,通过RGMII传给MAC,MAC的DMA将数据写入接收缓冲区,并产生一个接收中断。
- 在接收中断处理函数中,并不直接处理数据,而是简单地调用
napi_schedule,标记NAPI需要被处理,然后禁用进一步的接收中断。 - 内核在稍后的软中断环境中,调用我们注册的
stmmac_napi_poll函数。 - 在
poll函数中,驱动轮询DMA的接收描述符环,将一个个已经收到数据的描述符对应的数据包取出,封装成新的sk_buff,然后通过netif_receive_skb提交给上层网络协议栈(如IP层、TCP层)。 - 一轮
poll处理结束后,如果描述符环里还有数据,就继续处理;如果处理完了,就调用napi_complete,并重新使能接收中断,等待下一次数据到来。
这种“中断触发+轮询处理”的模式,在高流量负载下能显著降低CPU中断开销,提高吞吐量。这也是为什么在ifconfig里看到网卡统计信息中,中断次数(interrupts)可能并不高,但数据包数量(packets)却很大的原因。
6. 调试与排错:驱动工程师的日常
网络驱动调不通是家常便饭。我根据自己踩过的坑,总结了一套调试流程。首先,确保硬件连接正确,用万用表量一下PHY的电源、复位引脚、晶振是否起振。然后,在驱动加载阶段,关注内核dmesg日志。
第一步,看PHY探测是否成功。 加载驱动后,你应该能看到类似这样的日志:
stm32-dwmac 5800a000.ethernet: IRQ eth_lpi not found
stm32-dwmac 5800a000.ethernet: User ID: 0x10, Synopsys ID: 0x37
stm32-dwmac 5800a000.ethernet: DWMAC4/5
stm32-dwmac 5800a000.ethernet: Ring mode enabled
stm32-dwmac 5800a000.ethernet: DMA HW capability register supported
stm32-dwmac 5800a000.ethernet: RX Checksum Offload Engine supported
stm32-dwmac 5800a000.ethernet: COE Type 2
stm32-dwmac 5800a000.ethernet: TX Checksum insertion supported
stm32-dwmac 5800a000.ethernet: Wake-Up On Lan supported
stm32-dwmac 5800a000.ethernet: Normal descriptors
stm32-dwmac 5800a000.ethernet: Ring mode enabled
stm32-dwmac 5800a000.ethernet: Enable RX Mitigation via HW Watchdog Timer
libphy: stmmac-0:00 - Link is Up - 1000/Full - flow control rx/tx
最后一行“Link is Up - 1000/Full”是PHY驱动打印的,表明PHY被成功探测,并且自动协商为千兆全双工模式。如果没看到PHY相关的信息,或者显示“stmmac-0:00 - Link is Down”,那问题可能出在MDIO通信、PHY地址不对、或者PHY本身没工作。
第二步,检查接口是否注册成功。 运行ifconfig -a,应该能看到eth0接口。如果没有,可能是net_device注册失败,检查probe函数的返回值。
第三步,链路通了但ping不通。 这可能是软件配置问题。首先确认IP地址设置正确:ifconfig eth0 192.168.1.100 netmask 255.255.255.0 up。然后抓包分析,使用tcpdump -i eth0 -n查看是否有ARP请求发出、是否有回复。如果本机没发ARP,可能是路由表问题;如果发了ARP但没回复,检查对端设备或交换机。还有一个常见坑是防火墙,记得在开发板上用iptables -F清空规则试试。
第四步,使用ethtool工具深入诊断。 ethtool是网络驱动调试的神器。
ethtool eth0:查看网卡基本能力和当前链接状态(速度、双工、自协商)。ethtool -S eth0:查看详细的网络统计信息,包括收发包数量、错误计数(如rx_length_errors,rx_crc_errors)。如果rx_crc_errors一直增长,很可能是RGMII时序有问题,时钟或数据线有干扰。ethtool -d eth0:可以dump出MAC控制器内部所有寄存器的值,用于比对数据手册,排查硬件配置错误。
第五步,针对RGMII的专项检查。 千兆RGMII对时序要求苛刻。除了在设备树中正确设置phy-mode为rgmii-id,还需要确认PCB走线是否满足等长要求。有时候需要根据实际硬件情况,在驱动中微调RX/TX的延迟参数。这些参数可能在设备树中通过rx-internal-delay-ps和tx-internal-delay-ps属性来设置,或者像某些平台,需要在PHY的扩展寄存器里配置。对于YT8511C,务必确认125MHz时钟输出已使能,这个坑我踩过,现象就是协商不到千兆,只能到百兆。
驱动调试是个耐心活,需要结合硬件信号测量(用示波器看RGMII时钟和数据线)、软件日志分析和数据手册对照,一步步缩小范围。当你第一次看到ping通的那一刻,那种成就感是无与伦比的。
708



被折叠的 条评论
为什么被折叠?



