1. RK平台网络调试概述
各位好，我是老周。做嵌入式网络调试这些年，从早期的ARM9一路折腾到现在的RK3588，踩过的坑确实不少。今天咱们先聊聊RK平台网络调试的整体面貌——说白了，就是让你知道手里有什么工具、面对什么问题、该从哪儿下手。
1.1 RK平台网络架构简介
瑞芯微RK系列的网络架构，我习惯把它分成三层来看：
- 硬件MAC层：RK芯片内部集成的GMAC（Gigabit MAC）控制器，支持RGMII/RMII/MII接口。RK3568/RK3588用的是DesignWare的IP核，和ST、NXP那些平台同源，但寄存器布局有差异。
- DMA与描述符环：数据从MAC到内存走的是DMA通道。RK平台默认用双描述符环（Tx/Rx各一个），每个描述符指向一个sk_buff。我记得第一次调RK3399的网卡时，发现描述符环深度只有256，大流量下很容易丢包。
- 驱动与协议栈：Linux内核中的
stmmac驱动框架，配合RK的PHY驱动（通常是Realtek RTL8211系列或裕太微的YT8512）。上层走的是标准TCP/IP协议栈。
核心要点：RK平台的网络瓶颈往往不在MAC本身，而在DMA描述符环配置和PHY的MDIO通信稳定性上。这是我调了十几个项目后的体会。
下面这张图是我自己画的RK平台网络数据流简图，帮你快速建立整体认知：
1.2 调试工具链概览
做RK平台网络调试，工具链我分三类：内核级、用户态、硬件辅助。下面这个表格是我自己整理的，你直接拿去用：
| 类别 | 工具/命令 | 用途 | 我常用的场景 |
|---|---|---|---|
| 内核级 | ifconfig/ip |
查看接口状态、IP配置 | 确认网卡是否up、有无IP |
ethtool |
查看/修改网卡参数、统计信息 | 查协商速率、丢包计数、ring buffer大小 | |
perf/ftrace |
内核函数级追踪、中断分析 | 定位驱动层延迟、中断分布 | |
| 用户态 | ping/iperf3 |
连通性测试、吞吐量测试 | 基础功能验证、性能基准 |
tcpdump/tshark |
抓包分析 | 排查重传、窗口缩放、TCP异常 | |
netstat/ss |
查看socket状态、连接队列 | 检查listen backlog溢出 | |
| 硬件辅助 | 逻辑分析仪 | 抓取RGMII/RMII总线时序 | PHY与MAC之间数据错位 |
| 示波器 | 测量时钟、数据信号质量 | 排查眼图问题、时钟抖动 |
我的小习惯：每次拿到一块新的RK板子，我第一件事就是跑ethtool -S eth0看统计信息。如果rx_dropped或tx_dropped不为0，说明驱动或硬件层面已经有问题了，上层调得再好也白搭。
1.3 常见网络问题分类
根据我这些年处理过的RK平台网络问题，大致可以归为以下几类。每个类别我都附了一个真实案例：
1.3.1 驱动与硬件适配问题
- PHY无法Link up：最常见。RK3588搭配裕太微YT8512时，MDIO通信时序不匹配，导致PHY ID读不到。我曾经花了两天排查，最后发现是设备树中
phy-mode写成了rgmii，而实际硬件走的是rgmii-id。 - MAC与PHY速率协商失败：强制1000M时正常，自适应就掉到100M。这通常是PHY的寄存器配置问题。
- DMA描述符环溢出：高吞吐场景下，描述符环深度不够，驱动来不及回收。我遇到过RK3568在iperf3打流时，
tx_dropped每秒涨几百个。
1.3.2 协议栈与性能问题
- TCP吞吐量上不去：RK3588千兆网口，iperf3只能跑到400Mbps。排查后发现是中断亲和性没设置，所有中断都落在CPU0上。
- UDP丢包严重：视频流场景下，UDP包大量丢失。我调过的一个项目，最后发现是套接字接收缓冲区太小，
rmem_default只有212KB。 - 连接建立缓慢：TCP三次握手延迟高，通常是listen backlog队列溢出，或者SYN Flood保护机制误触发。
1.3.3 应用层与配置问题
- DNS解析超时：RK平台默认的
resolv.conf配置了不稳定的DNS服务器。 - 防火墙规则误拦截：iptables/nftables规则配置不当，导致特定端口不通。
- 网络服务异常：DHCP客户端获取不到IP，或者NTP同步失败。
避坑指南：我曾经在一个量产项目中，发现同一批RK3568板子，有的网口正常，有的Link up后频繁断连。排查到最后，是PCB layout时RGMII时钟线等长没做好，导致信号质量差。软件调了三天，最后发现是硬件问题——所以遇到网络问题，先确认硬件，别一股脑扎进代码里。
1.4 本章小结
这一章我们梳理了RK平台网络调试的三大块：架构、工具、问题分类。说白了，就是让你知道：
- 数据从应用层到网口，经过了哪些环节
- 每个环节用什么工具去查
- 常见问题长什么样，该往哪个方向排查
后面几章，我会带着你一步步搭建调试环境，然后逐个击破这些典型问题。嗯，咱们先把基础打牢。