stmmac 文档索引（RK3588 树）

Linux 6.1（RK3588）内核 Synopsys DWMAC / STMMAC 以太网驱动 源码分析与原理说明。

源码路径：rk3588/kernel-6.1/drivers/net/ethernet/stmicro/stmmac/（约 78 文件）。

总览文档

文档	说明
stmmac网卡驱动机制与原理详解.md	总览：分层架构、数据路径、编译产物、RK3588 关联
源码目录与模块索引.md	目录树、Makefile/Kconfig、文件职责速查

功能组专题（原理 + 实现）

编号	文档	源码重点
01	总体架构与分层设计.md	三层架构、核心数据结构、设计模式
02	stmmac_main核心驱动.md	probe/open/xmit/rx/NAPI/中断/ndo
03	hwif硬件抽象层.md	ops 表、版本探测、stmmac_hwif_init
04	dwmac4与描述符DMA.md	GMAC4 core/dma/desc、ring/chain 模式
05	Platform平台Glue层.md	stmmac_platform.c、DT 解析、PCI
06	mdio与phylink.md	MDIO 总线、phylink 链路管理
07	PTP与硬件时间戳.md	PTP 时钟、TX/RX hwtstamp
08	TC流量控制卸载.md	CBS/TAPRIO/flower/cls_u32
09	XDP与AF_XDP.md	BPF、zero-copy、xsk pool
10	ethtool与MMC统计.md	ethtool ops、MMC 硬件计数器
11	dwmac-rockchip-RK3588.md	时钟/GRF/XPCS、DT、probe 流程
12	legacyGMAC与XGMAC扩展.md	GMAC3/1000、DWXGMAC2、DWXLGMAC

源码路径

rk3588/kernel-6.1/drivers/net/ethernet/stmicro/stmmac/
include/linux/stmmac.h                          # plat_stmmacenet_data
arch/arm64/boot/dts/rockchip/rk3588*.dtsi       # gmac 节点

阅读顺序建议

速查

需求	入口
驱动 probe	stmmac_dvr_probe() → stmmac_main.c
RK3588 平台 probe	rk_gmac_probe() → dwmac-rk.c
设备 UP	stmmac_open() → __stmmac_open()
发包	stmmac_xmit() / stmmac_tso_xmit()
收包	stmmac_rx() / stmmac_rx_zc()
中断/NAPI	stmmac_dma_interrupt() → stmmac_napi_poll_rx/tx()
HW 版本选择	stmmac_hwif_init() → hwif.c
DT 兼容	rockchip,rk3588-gmac

关联文档

• 网络核心/NAPI：linuxDoc/net/09-NAPI收包轮询机制与实现详解.md
• TC/BPF/XDP：linuxDoc/net/05-调度tc-BPF与XDP机制与实现详解.md
• 数据面与 drivers 分界：linuxDoc/net/07-数据面路径与drivers分界机制与实现详解.md