在嵌入式開發(fā)中，RK（瑞芯微）平臺憑借高性能、高兼容性廣泛應(yīng)用于物聯(lián)網(wǎng)、工業(yè)控制等場景，而以太網(wǎng)作為核心通信接口，其穩(wěn)定性直接決定了設(shè)備的可用性。但實際開發(fā)中，我們常會遇到初始化失敗、網(wǎng)絡(luò)不通、丟包等問題，排查起來耗時費力。

本文基于RK官方以太網(wǎng)問題排查手冊，梳理了7類核心故障的現(xiàn)象表現(xiàn)、排查邏輯與實操方案，涵蓋從開機初始化到吞吐量優(yōu)化的全流程，幫你快速定位問題、高效解決。

一、以太網(wǎng)初始化失?。洪_機就報錯？從PHY和配置入手

現(xiàn)象表現(xiàn)

開機Log中出現(xiàn)明確報錯，如：

?No PHY found（未找到PHY芯片）

?Cannot attach to PHY（無法掛載PHY）

?MDIO device at address 1 is missing（PHY地址不匹配）

排查步驟

1.檢查MDC/MDIO引腳配置

MDC/MDIO是主控與PHY通信的關(guān)鍵引腳，優(yōu)先確認(rèn)IOMUX寄存器值是否正確（需對照硬件原理圖），同時用示波器測試波形：MDC時鐘頻率需小于2.5MHz，波形無異常抖動。

2.驗證PHY供電與復(fù)位

?確保PHY芯片供電正常（如3.3V/1.8V，需匹配芯片規(guī)格書）；

?檢查Reset IO配置：必須連接主控的3.3V IO（配置成1.8V會直接報錯），且復(fù)位時序需滿足PHY datasheet要求（可用示波器觀察上電后Reset腳是否有有效復(fù)位信號）。

1.匹配PHY地址（軟件與硬件一致）

若Log提示“address X missing”，說明軟件配置的PHY地址與硬件實際地址不匹配：

?推薦將DTS中PHY地址修改為通用廣播地址0，配置示例：

&mdio0 { rgmii_phy0: phy@0 { compatible = "ethernet-phy-ieee802.3-c22"; reg = <0x0>; // PHY地址設(shè)為0 }; };

二、DMA Initialization Failed：時鐘錯誤是“元兇”

現(xiàn)象表現(xiàn)

Log中出現(xiàn)DMA初始化失敗報錯，如：

?rk_gmac-dwmac fe1c0000.ethernet: Failed to reset the dma

?stmmac_open: Hw setup failed

排查核心：時鐘信號與配置

DMA依賴穩(wěn)定的時鐘，需從“硬件信號”和“軟件配置”雙向驗證：

1.檢查時鐘引腳與IOMUX

?執(zhí)行命令查看引腳復(fù)用配置，確認(rèn)時鐘腳未被占用：

find / -name pinmux-pins cat pinmux-pins

?用示波器測量時鐘引腳：確保有正常時鐘輸出，頻率、幅度符合硬件設(shè)計（如百兆PHY常用25MHz，千兆常用125MHz）。

1.確認(rèn)時鐘樹與使能狀態(tài)

?查看時鐘樹信息，驗證目標(biāo)時鐘是否使能、頻率是否正確：

busybox find / -name clk_summary cat clk_summary

?檢查CRU寄存器（時鐘控制單元），確保時鐘路徑無阻斷。

1.百兆PHY時鐘方向配置（關(guān)鍵?。?/span>

若使用百兆PHY，需保證“硬件方向”與“軟件配置”相反：

?硬件PHY設(shè)為input→主控DTS中GMAC配置為output（推薦）；

?硬件PHY設(shè)為output→主控DTS中GMAC配置為input。

參考文檔：《Rockchip_Developer_Guide_Linux_GMAC_Mode_Configuration_CN》

三、網(wǎng)絡(luò)不通：有eth節(jié)點但ping不通？分千兆/百兆排查

前提條件

Log無報錯，ifconfig能看到ethx節(jié)點（如eth0），但無法ping通同網(wǎng)段IP或外網(wǎng)。

1.若為千兆PHY：先測百兆，再查delay

步驟1：先驗證百兆是否正常（縮小問題范圍）

千兆不通常與信號延遲（tx/rx delay）相關(guān)，先固定百兆測試：

?臨時固定百兆（重啟失效）：

ethtool -s eth0 autoneg off speed 100 duplex full

?永久固定百兆（修改DTS）：在GMAC節(jié)點中加入：

max-speed = <100>; //強制百兆模式

?若固定百兆后能正常link（串口打印link is up 100M/full），說明問題在千兆信號延遲。

步驟2：千兆不通→校準(zhǔn)tx/rx delay

?優(yōu)先使用官方工具掃回環(huán)，獲取正確delay值：

echo 1000 > phy_lb_scan #掃描回環(huán)，生成delay參數(shù)

?將掃描結(jié)果填入DTS，重新編譯燒錄（參考文檔：《Rockchip_Developer_Guide_Linux_GMAC_RGMII_Delayline_CN.pdf》）。

?特殊情況：若PHY /交換機無法自動掃描，需手動微調(diào)delay值（以5為步進，范圍0x0~0x60）。

2.若為百兆PHY：優(yōu)先查硬件與DTS

?檢查時鐘輸出：確保25M/50M時鐘正常（幅值、頻率達標(biāo)）；

?重新核對IOMUX復(fù)用：避免引腳沖突（如GMAC引腳被復(fù)用為UART）；

?驗證電源域：PHY所在電源域（如AVDD、DVDD）電壓穩(wěn)定；

?時鐘方向：同“DMA時鐘錯誤”中的百兆PHY配置規(guī)則。

四、自協(xié)商失?。簾o法link？查引腳、測波形、驗PHY

現(xiàn)象表現(xiàn)

插網(wǎng)線后無link up打印，或自協(xié)商后速率異常（如千兆降為百兆但仍不通）。

排查步驟

1.逐引腳核對IO復(fù)用

用pinmux-pins文件逐一對照GMAC所有引腳（如TXD、RXD、TXC、RXC），確保無復(fù)用錯誤：

cat /sys/devices/platform/xxx.ethernet/pinmux-pins # xxx為GMAC基地址

1.循環(huán)讀取PHY寄存器，驗證通信

?找到PHY寄存器路徑：

find / -name phy_registers

?循環(huán)讀取寄存器，觀察值是否正常（全0xffff或全0→硬件信號問題）：

while true; do cat /sys/devices/platform/fe300000.ethernet/mdio_bus/stmmac-0/stmmac-0:01/phy_registers done

?拔插網(wǎng)線，檢查寄存器1的bit5（自協(xié)商標(biāo)志位）和bit2（link狀態(tài)位）是否變化：無變化→PHY未正常工作。

1.驗證PHY自身狀態(tài)

?檢查PHY電源、復(fù)位、晶體（如25MHz）是否正常；

?用示波器測MDI信號：正常PHY應(yīng)輸出鏈路脈沖信號，若無→MDI±接線反或PHY故障；

?排查MDI相關(guān)信號問題：如鏈路過長、ESD結(jié)電容過大（會導(dǎo)致信號衰減）。

五、丟包/吞吐量不達標(biāo)：從delay、優(yōu)化配置入手

標(biāo)準(zhǔn)速率參考

?百兆以太網(wǎng)：吞吐量需≥90M/bps；

?千兆以太網(wǎng)：吞吐量需≥900M/bps。

先測吞吐量：用iperf定位問題

測試ARM發(fā)送（PC接收）

?PC端（需關(guān)閉防火墻）：

iperf.exe -s -w 1M #啟動服務(wù)端，窗口大小1M

?ARM端：

iperf -c 192.168.50.169 -i 1 -w 1M -t 10 -l 16000 #連接PC，測試10秒

測試ARM接收（PC發(fā)送）

?ARM端：

iperf -s -w 1M

?PC端：

iperf -c 192.168.50.108 -i 1 -w 1M -t 10 -l 16000

優(yōu)化方案（按優(yōu)先級排序）

1.千兆不達標(biāo)→校準(zhǔn)tx/rx delay

同“網(wǎng)絡(luò)不通”中的千兆delay校準(zhǔn)步驟（優(yōu)先自動掃回環(huán)）。

2.定頻CPU與DMC（提升硬件性能）

將CPU和內(nèi)存控制器（DMC）設(shè)為性能模式，避免降頻導(dǎo)致的處理瓶頸：

# DMC定頻performance echo performance > /sys/devices/platform/dmc/devfreq/dmc/governor # CPU0定頻performance（多核心可依次配置） echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor

1.中斷與隊列優(yōu)化（負(fù)載均衡）

?中斷遷移：將eth中斷從CPU0移到大核（如RK3588的CPU3）：

#查看eth0中斷號（假設(shè)為234） cat /proc/interrupts #將中斷234移到CPU3（16進制0x8對應(yīng)CPU3） echo 8 > /proc/irq/234/smp_affinity

?隊列分布：將RX/TX隊列分配到多核心處理：

echo f > /sys/class/net/eth0/queues/rx-0/rps_cpus echo f > /sys/class/net/eth0/queues/tx-0/xps_cpus

1.增大協(xié)議緩沖區(qū)（UDP吞吐低適用）

#調(diào)整TCP/UDP緩沖區(qū)大小 echo 1048576 > /proc/sys/net/core/wmem_max echo 1048576 > /proc/sys/net/core/rmem_max echo "4096 1048576 1048576" > /proc/sys/net/ipv4/tcp_rmem echo "4096 1048576 1048576" > /proc/sys/net/ipv4/tcp_wmem #用sysctl生效配置 sysctl -w net.core.rmem_max=2048000 sysctl -w net.core.wmem_max=2048000

1.關(guān)閉硬件校驗（TCP TX異常適用）

若TCP丟包但UDP正常，嘗試關(guān)閉硬件checksum：

#關(guān)閉eth0的RX/TX硬件校驗 ethtool --offload eth0 rx off tx off #查看校驗狀態(tài) ethtool --show-offload eth0

六、串口一直打印link up/down：循環(huán)報錯？查時鐘、EEE、網(wǎng)線

核心原因

PHY持續(xù)接收錯誤數(shù)據(jù)，導(dǎo)致鏈路反復(fù)斷開/重連。

排查步驟

1.EEE模式問題→合入對應(yīng)補丁

若開啟了EEE（節(jié)能模式），部分PHY會因兼容性問題觸發(fā)link波動，需合入RK官方的EEE補?。?lián)系FAE獲?。?。

2.PHY時鐘配置錯誤→設(shè)為output模式

優(yōu)先將主控配置為時鐘輸出模式（穩(wěn)定性更高），避免PHY時鐘輸入異常導(dǎo)致的鏈路波動。

3.物理層問題→換網(wǎng)線、查接觸

?網(wǎng)線水晶頭接觸不良是常見誘因，更換一根認(rèn)證網(wǎng)線測試；

?用示波器測MDI信號，排除信號衰減或干擾。

1.PHY寄存器驗證

同“自協(xié)商失敗”中的循環(huán)讀寄存器方法，觀察拔插網(wǎng)線時寄存器值是否正常變化，若異常→硬件信號故障。

七、交換機（Switch）相關(guān)問題：以RTL836x為例

適用場景

使用RTL8367RB/RTL8367S等交換機芯片，需通過RGMII與RK主控連接。

關(guān)鍵前提（硬件+軟件）

1.硬件接線：RGMII交叉連接

主控MAC與交換機MAC的RGMII引腳需交叉對接：

?交換機TXD [3:0] →主控RXD [3:0]

?交換機RXD [3:0] →主控TXD [3:0]

?交換機TXC →主控RXC，交換機TX_CTL →主控RX_CTL

1.軟件配置：PHY ID設(shè)為29

RK交換機驅(qū)動默認(rèn)PHY ID為29，需將硬件交換機的地址ID改為29，且MDIO引腳需上拉：

#define MDC_MDIO_PHY_ID 29 /*固定PHY ID為29 */

1.獲取官方補丁

從RK FTP下載RTL836x補?。?/span>

?FTP地址：ftp://www.rockchip.com.cn

?賬號：rkwifi，密碼：Cng9280H8t

?路徑：05-補丁Patch/rtl8367_switch/rk3568_rk3588/

排查步驟

1.先驗證交換機自身功能

交換機引出的2個網(wǎng)口接2臺PC（同網(wǎng)段靜態(tài)IP），若PC間無法ping通→交換機本身故障：

?檢查交換機電源、晶體（如25MHz）、復(fù)位引腳；

?核對硬件上下拉配置（參考芯片datasheet）。

1.再驗證主控與交換機通信

?若主控Log報“找不到PHY”或“DMA錯誤”，參考本文第一、二章節(jié)排查；

?區(qū)分交換機型號：RTL8367RB用EXT_PORT1作為RGMII，RTL8367S用EXT_PORT0，需在代碼中修正：

// RTL8367S需改為EXT_PORT0 ret = rtk_port_macForceLinkExt_set(EXT_PORT0, MODE_EXT_RGMII, &abi);

1.千兆不通→手動調(diào)delay

交換機暫不支持自動掃回環(huán)，可嘗試以下delay組合（單位：十六進制）：

tx_delay	rx_delay
0x0	0x10
0x10	0x0
0x10	0x10
0x20	0x20

?若上述值無效，以5為步進在0x0~0x60范圍內(nèi)微調(diào)，修改寄存器（以RK356x為例）：

#查看delay寄存器（0xfdc60380）：bit15-8=rx delay，bit7-0=tx delay io -4 0xfdc60380 #寫入值（如rx=0x10，tx=0x0，高16位為使能） io -4 0xfdc60380 0xffff0010

總結(jié)：RK網(wǎng)絡(luò)排查的核心邏輯

RK平臺以太網(wǎng)問題排查遵循“從上層到下層，從軟件到硬件”的原則：

1.先看開機Log：是否有初始化、DMA、PHY相關(guān)報錯（定位到具體章節(jié)）；

2.再查功能節(jié)點：ifconfig是否有ethx，拔插網(wǎng)線是否有link打??；

3.分層測試：先測百兆再測千兆，先測本地再測外網(wǎng)，逐步縮小范圍；

4.工具輔助：用示波器測時鐘/ MDI信號，用iperf測吞吐量，用寄存器驗證通信。

你在RK平臺網(wǎng)絡(luò)開發(fā)中還遇到過哪些疑難問題？歡迎在評論區(qū)留言討論，一起踩坑避坑！