STM32以太网调试实战：从Nucleo-F767ZI原理图到LWIP ping通

1. 拿到Nucleo-F767ZI之后先别急着点生成代码很多人拿到Nucleo-F767ZI这块板子的第一反应是打开STM32CubeMX选好芯片型号然后直奔Connectivity选项卡去勾ETH。我当初也是这么干的结果在生成的工程里折腾了整整两天PHY死活协商不上ping都ping不通。后来才发现问题根本不在软件配置上而是我从一开始就忽略了硬件层面几个要命的细节。Nucleo-F767ZI这块板子在以太网这块的设计比较特殊。它板载了一颗LAN8742A的PHY芯片通过RMII接口和STM32F767ZIT6的MAC层连接。RMII相比MII少了将近一半的信号线但代价是参考时钟的要求更严格。板子上给PHY和MAC提供的50MHz时钟来自同一个源——ST-LINK那侧的MCO输出经过一个时钟缓冲器分出来的。这意味着如果你在CubeMX里把时钟树配错了RMII的REF_CLK就直接废了PHY连最基本的链路建立都做不到。所以我的建议是在打开CubeMX之前先把板子的原理图翻出来看一遍。Nucleo-F767ZI的原理图在ST官网能下到重点看三个地方PHY的地址配置引脚、RMII的信号连接、复位和电源引脚。这三处任何一处理解错了后面软件怎么调都是白搭。这篇文章我会按照实际调试的顺序来写先从原理图里挖出那些CubeMX界面上看不到的信息再讲时钟树和引脚配置的坑然后是PHY初始化和LWIP的对接最后是实测中遇到的各种奇怪现象和排查思路。适合已经上手过STM32、但对以太网外设不太熟悉的开发者也适合那些CubeMX点了一遍但网络死活不通的朋友。2. 原理图里藏着的三个关键信息CubeMX不会告诉你2.1 PHY地址到底是多少LAN8742A的SMIStation Management Interface也就是MDIO/MDC那套地址是由PHYAD[0]引脚在上电复位时锁存的。Nucleo-F767ZI的原理图上LAN8742A的PHYAD0引脚通过一个电阻拉高或拉低决定了它的SMI地址。我翻原理图确认过这块板子上LAN8742A的PHY地址是0x00。这个值在CubeMX里配置ETH外设的时候需要填进去但CubeMX的ETH配置界面里并没有一个叫“PHY Address”的显眼输入框——它藏在Parameter Settings选项卡的PHY Address字段里默认值就是0。如果你用的是自己画的板子PHY地址可能不同一定要根据原理图上的PHYAD引脚接法来确认。提示LAN8742A的SMI地址范围是0x00到0x1F由PHYAD[4:0]五个引脚决定。Nucleo-F767ZI上只用了PHYAD0其余接地所以地址就是0x00。2.2 RMII的REF_CLK从哪来这是最容易踩坑的地方。RMII接口需要一个50MHz的参考时钟这个时钟可以来自MAC侧STM32输出给PHY也可以来自PHY侧PHY输出给STM32。Nucleo-F767ZI的设计是PHY提供REF_CLK给MAC。具体来说板子上有一颗25MHz的晶振连接到LAN8742APHY内部PLL倍频到50MHz然后通过REF_CLK引脚输出给STM32的PA1引脚。PA1在STM32F767上的复用功能就是ETH_RMII_REF_CLK。这意味着在CubeMX里配置PA1的时候必须把它设为ETH_RMII_REF_CLK的复用模式而不是普通的GPIO输入。如果你漏了这一步STM32的MAC层收不到参考时钟ETH外设初始化会直接失败HAL_ETH_Init返回HAL_ERROR。2.3 复位引脚和电源使能LAN8742A有一颗复位引脚NRSTNucleo-F767ZI上它连接到了STM32的某个GPIO上。具体是哪个引脚不同版本的板子可能不一样我手上这块是PG3不同批次可能不同务必以你手头板子的原理图为准。这个复位引脚在CubeMX里不需要特殊配置但你在写PHY初始化代码的时候需要先拉低再拉高给它一个复位脉冲否则PHY可能处于不确定状态。另外LAN8742A的电源使能引脚也是通过GPIO控制的同样需要确认原理图上的连接。我一般会在CubeMX里把这两个GPIO都配成输出模式初始电平设成复位有效低电平然后在代码里手动控制复位时序。这样比依赖PHY的上电复位更可靠。3. CubeMX里的时钟树配置一步错步步错3.1 RMII_REF_CLK的时钟源选择在CubeMX的Clock Configuration界面里有一个容易被忽略的选项ETH的RMII参考时钟来源。这个选项在Connectivity → ETH → Parameter Settings里叫做RMII clock source有两个选项External和Internal。Nucleo-F767ZI必须选External因为REF_CLK是PHY提供的。如果你选了InternalSTM32会尝试从自己的PLL输出50MHz给PHY但板子上PA1已经硬连到PHY的REF_CLK输出了两边打架结果就是时钟信号混乱PHY工作不正常。这个选项在CubeMX的界面上不太显眼我第一次配的时候完全没注意到默认就是External算是运气好。但如果你用的是自己设计的板子PHY不提供REF_CLK那就必须选Internal并且确保STM32的PA1配置为ETH_RMII_REF_CLK输出模式。3.2 主时钟和ETH时钟的联动STM32F767的ETH外设挂载在AHB1总线上它的时钟来自PLL的Q输出或者外部PHY时钟。在CubeMX里当你选了External RMII clock source之后ETH的时钟就直接来自PA1引脚输入的50MHz不需要PLL额外输出。但这里有个隐藏的坑PA1引脚的时钟输入需要使能SYSCFG时钟。CubeMX在生成代码的时候会自动加上__HAL_RCC_SYSCFG_CLK_ENABLE()但如果你手动改过初始化顺序可能会漏掉。我遇到过一种情况ETH初始化偶尔成功偶尔失败后来发现是SYSCFG时钟使能被放在了ETH初始化之后导致PA1的复用功能没有正确映射。正确的顺序是先使能SYSCFG时钟再配置GPIO复用最后初始化ETH外设。CubeMX生成的代码默认就是这个顺序但如果你在MX_ETH_Init之前插入了自己的GPIO初始化代码就要特别注意。3.3 时钟树参数的实际计算假设你用Nucleo-F767ZI板载的8MHz晶振来自ST-LINK的MCO经过PLL配置到216MHz的系统时钟。ETH的RMII时钟是50MHz来自PHY不经过PLL。但**MDIO的时钟MDC**是由AHB1时钟分频得到的分频系数在ETH_MACCR寄存器里配置。MDC的时钟频率范围是1MHz到2.5MHz根据IEEE 802.3标准。STM32F767的AHB1时钟是216MHz分频系数最小是42对应约5.14MHz最大是1024对应约210kHz。实际上HAL库的HAL_ETH_Init会根据你传入的ETH_MACConfigTypeDef结构体里的MDCClockDiv字段来配置。我一般设成AHB1时钟/102对应约2.1MHz在标准范围内。这个值在CubeMX的ETH配置界面里没有直接暴露需要在生成的代码里手动改heth.Init.MDCClockDiv或者调用HAL_ETH_SetMDIOClockRange。4. 引脚配置的细节不只是勾选那么简单4.1 RMII引脚清单和复用编号Nucleo-F767ZI的RMII接口用了以下引脚引脚功能复用编号PA1ETH_RMII_REF_CLKAF11PA2ETH_MDIOAF11PA7ETH_RMII_CRS_DVAF11PC1ETH_MDCAF11PC4ETH_RMII_RXD0AF11PC5ETH_RMII_RXD1AF11PB11ETH_RMII_TX_ENAF11PB12ETH_RMII_TXD0AF11PB13ETH_RMII_TXD1AF11PG3PHY复位GPIO输出-CubeMX在你勾选ETH外设并选择RMII模式后会自动把这些引脚配好。但PG3不会自动配置因为它是普通GPIO需要你手动在GPIO选项卡里设置。4.2 GPIO速度和输出类型的讲究RMII的TX和REF_CLK信号频率是50MHzGPIO的输出速度必须设成Very High。CubeMX默认可能会设成Low或Medium这会导致信号边沿变缓PHY采样出错。我实测过用Medium速度时ping的丢包率大概在5%左右改成Very High之后丢包率降到0。MDIO和MDC的频率低得多MDC最高2.5MHz用默认的Low速度就够了。但为了统一我一般把ETH相关的所有GPIO都设成Very High省得漏掉。PHY复位引脚PG3是普通GPIO输出速度设成Low就行初始电平设成Low复位有效然后在代码里延时一段时间后再拉高。4.3 那些CubeMX不会自动配置的引脚除了PG3之外还有几个引脚需要留意PHY的电源使能引脚Nucleo-F767ZI上LAN8742A的电源是常通的不需要GPIO控制。但如果你用的是自己画的板子可能需要一个GPIO来控制PHY的电源。PHY的中断引脚LAN8742A有一颗中断输出引脚可以连接到STM32的外部中断输入。Nucleo-F767ZI上没有连接所以CubeMX里不需要配置。但如果你要用中断方式处理链路状态变化就需要自己接线并在CubeMX里配置EXTI。5. PHY初始化和LWIP对接的实战细节5.1 HAL_ETH_Init到底做了什么CubeMX生成的代码里MX_ETH_Init函数会调用HAL_ETH_Init。这个函数做的事情包括复位ETH外设的MAC层配置MAC的工作模式全双工/半双工、100M/10M配置MDIO时钟分频读取PHY的ID寄存器确认PHY存在配置PHY的工作模式自协商、速度、双工模式使能MAC的收发功能其中第4步和第5步是通过SMI接口读写PHY寄存器实现的。如果PHY地址配错了或者MDIO/MDC引脚没配好HAL_ETH_Init会返回HAL_ERROR并且heth.Instance-MACMIIAR寄存器的值会异常。我遇到过一次HAL_ETH_Init返回错误的情况排查后发现是MDC时钟分频设得太小导致MDC频率超过了PHY能接受的上限。LAN8742A的MDC最高频率是12.5MHz有些资料写的是2.5MHz但实测12.5MHz也能工作但为了稳定还是按标准来控制在2.5MHz以内。5.2 PHY自协商的等待逻辑HAL_ETH_Init里会调用HAL_ETH_WritePHYRegister和HAL_ETH_ReadPHYRegister来配置PHY的自协商。自协商的过程需要时间通常几十毫秒到几百毫秒。HAL库里的等待逻辑比较简单就是轮询PHY的BSRBasic Status Register寄存器的自协商完成位。但这里有个坑如果PHY的复位没有做好自协商可能永远完不成。我遇到过一种情况PHY的复位引脚在CubeMX里配成了高电平初始结果PHY一直处于复位状态自协商自然完不成。后来把初始电平改成低然后在代码里手动拉高问题解决。正确的复位时序是// 假设PHY复位引脚是PG3 HAL_GPIO_WritePin(GPIOG, GPIO_PIN_3, GPIO_PIN_RESET); // 拉低复位 HAL_Delay(10); // 保持至少10ms HAL_GPIO_WritePin(GPIOG, GPIO_PIN_3, GPIO_PIN_SET); // 释放复位 HAL_Delay(100); // 等待PHY稳定这段代码要放在MX_ETH_Init之前否则PHY还没准备好HAL_ETH_Init里的PHY读写就会失败。5.3 LWIP的配置要点CubeMX里可以勾选LWIP中间件然后配置IP地址、子网掩码、网关等参数。这里有几个容易出问题的地方第一PHY的地址和LWIP里的PHY地址要一致。LWIP的ethernetif.c里会调用HAL_ETH_Init而HAL_ETH_Init用的PHY地址来自heth.Init.PHYAddress。这个值在CubeMX的ETH配置里设置默认是0。如果你在LWIP里改了PHY地址但ETH配置里没改两边不一致PHY读写就会失败。第二LWIP的DHCP和静态IP选择。如果你用静态IP确保IP地址和你的路由器在同一网段。我一开始设了192.168.1.100但路由器是192.168.0.1网段结果ping不通排查了半天才发现是网段不对。第三LWIP的内存配置。STM32F767有512KB的RAMLWIP的默认内存配置比较保守可以适当调大。在lwipopts.h里MEM_SIZE默认是1600字节可以调到4096或更大。PBUF_POOL_SIZE默认是16可以调到32。这些参数影响网络吞吐量调大之后TCP传输速度明显提升。5.4 中断优先级和DMA描述符ETH外设的中断优先级在CubeMX的NVIC配置里设置。我一般设成5数值越小优先级越高比SysTick的优先级低比普通外设高。这样网络中断不会打断系统 tick但又能及时响应。DMA描述符的配置在HAL_ETH_Init里自动完成但描述符的内存对齐有要求。STM32F767的ETH DMA描述符需要4字节对齐HAL库会自动处理。但如果你自己定义了描述符数组记得加上__attribute__((aligned(4)))。6. 实测中遇到的奇怪现象和排查思路6.1 ping不通但PHY链路显示已建立这是最常见的问题。PHY的链路状态寄存器显示Link Up但ping不通。可能的原因有IP地址配置错误检查IP、子网掩码、网关是否和路由器匹配。MAC地址冲突如果局域网里有另一台设备用了相同的MAC地址会导致通信异常。STM32的MAC地址默认是从UID生成的一般不会冲突但如果你手动设了一个固定的MAC地址就要注意。防火墙或路由器设置有些路由器会隔离有线设备或者开启了AP隔离功能。我遇到过一次PHY链路正常但ping不通最后发现是网线的问题。那根网线是旧的只有两对线通100M模式需要四对线全通。换了一根网线就好了。所以排查的时候先换根网线试试成本最低。6.2 丢包严重或传输速度慢如果ping能通但丢包严重或者TCP传输速度很慢可能的原因有GPIO速度设置不对RMII的TX和REF_CLK引脚速度必须设成Very High。MDC时钟分频不合适MDC频率太高会导致PHY寄存器读写错误。LWIP内存配置太小PBUF_POOL_SIZE和MEM_SIZE太小会导致频繁丢包。中断优先级冲突ETH中断被其他高优先级中断打断太频繁。我实测下来把GPIO速度改成Very High、MDC分频设成102、PBUF_POOL_SIZE调到32之后ping的丢包率从5%降到了0TCP传输速度从几百KB/s提升到了几MB/s。6.3 HAL_ETH_Init返回HAL_ERROR这个错误的排查思路是检查PHY地址是否正确对照原理图。检查MDIO和MDC引脚是否配置为AF11复用模式。检查PHY复位时序是否正确。检查MDC时钟分频是否在合理范围内。用示波器或逻辑分析仪抓MDC和MDIO的波形看是否有信号。我遇到过一次HAL_ETH_Init返回错误用逻辑分析仪抓波形发现MDC根本没有输出。后来发现是PC1引脚被其他外设占用了CubeMX里虽然配了ETH_MDC但另一个外设也用了PC1导致复用冲突。在CubeMX的引脚视图里冲突的引脚会显示黄色警告仔细看就能发现。6.4 链路状态不稳定时通时断如果PHY的链路状态寄存器显示Link Up和Link Down交替出现可能的原因有电源不稳定PHY的供电电压波动会导致链路不稳定。检查板子上的电源滤波电容是否正常。REF_CLK信号质量差50MHz的参考时钟如果边沿不够陡PHY可能无法稳定锁定。检查PA1引脚的配置和PCB走线。网线接触不良RJ45接口松动或网线水晶头氧化。我遇到过一种情况板子放在桌上时链路正常一碰就断。后来发现是RJ45接口的焊点有虚焊重新焊接后问题解决。所以如果链路时通时断先检查硬件连接再查软件配置。7. 几个能省下大量时间的实操技巧7.1 用CubeMX的引脚视图快速排查冲突CubeMX的引脚视图Pinout View里如果某个引脚被多个外设占用会显示黄色或红色警告。在配置ETH的时候先把所有RMII引脚在引脚视图里找一遍确认没有冲突。特别是PA1、PA2、PA7、PC1、PC4、PC5、PB11、PB12、PB13这几个引脚有些可能被其他外设默认占用了。7.2 在main函数里加PHY寄存器打印在MX_ETH_Init之后加一段代码读取PHY的ID寄存器和状态寄存器打印出来确认PHY工作正常uint32_t phy_id 0; HAL_ETH_ReadPHYRegister(heth, 0, PHY_ID1_REG, phy_id); printf(PHY ID1: 0x%04X\r\n, phy_id); HAL_ETH_ReadPHYRegister(heth, 0, PHY_BSR_REG, phy_id); printf(PHY BSR: 0x%04X\r\n, phy_id);LAN8742A的ID1寄存器值应该是0x0007ID2是0xC0F1左右。如果读出来是0xFFFF或0x0000说明SMI通信有问题。7.3 用LWIP的统计信息定位问题LWIP提供了统计信息接口可以在lwipopts.h里使能LWIP_STATS然后在代码里调用stats_display()打印统计信息。能看到收发包数量、丢包数量、内存分配失败次数等对定位问题很有帮助。7.4 注意CubeMX版本和固件包的匹配STM32CubeMX的版本和STM32CubeF7固件包的版本要匹配。我用过CubeMX 6.5配F7固件包1.17.0生成的代码里ETH初始化部分有bugHAL_ETH_Init里的PHY地址被硬编码成了0不管CubeMX里设的是什么。后来升级到CubeMX 6.8配固件包1.17.2问题解决。所以如果遇到奇怪的初始化问题先检查一下CubeMX和固件包的版本。8. 从原理图到ping通我的完整检查清单每次调试新的以太网配置我都会按这个清单过一遍原理图确认PHY型号、PHY地址、REF_CLK方向、复位引脚、电源引脚。CubeMX配置ETH模式选RMII、RMII clock source选External、PHY地址填对、引脚复用选AF11、GPIO速度设Very High。时钟树配置系统时钟216MHz、AHB1不分频、MDC分频设102。复位时序PHY复位引脚先低后高延时足够。LWIP配置IP地址和路由器同网段、MAC地址不冲突、内存参数调大。硬件检查网线完好、RJ45接口焊接牢固、电源稳定。调试输出打印PHY ID和BSR寄存器、用LWIP统计信息定位问题。这套流程走下来大部分问题都能在半小时内定位。最怕的是跳过原理图直接配CubeMX那样出了问题根本不知道从哪查起。以太网这个东西硬件和软件的耦合太紧密了任何一边出问题都表现为“ping不通”没有清晰的排查思路很容易陷入死胡同。最后说一个我踩过的坑有一次调试了一整天各种配置都检查了就是ping不通。最后发现是网线插在了路由器的WAN口上而不是LAN口。WAN口和LAN口在不同的网段当然ping不通。换到LAN口秒通。所以排查的时候先从最简单的物理连接开始别一上来就怀疑代码。