1. MDIO-Tool 简介及安装
各位好，欢迎来到《MDIO-Tool读写PHY寄存器实战指南》的第一章。
做嵌入式开发的朋友，尤其是搞过网络通信的，对PHY芯片肯定不陌生。调试PHY芯片，说白了就是和一堆寄存器打交道。我早年做交换机项目时，为了定位一个千兆Link不稳定问题，拿着数据手册对了整整三天寄存器，眼睛都快看瞎了。那时候最头疼的事，就是没有一个趁手的工具来快速读写这些寄存器。
MDIO-Tool，就是来解决这个痛点的。
1.1 什么是MDIO-Tool
MDIO是Management Data Input/Output的缩写，说白了就是管理数据输入输出。这是IEEE 802.3标准定义的一种串行接口协议，专门用来访问以太网PHY芯片内部的寄存器。
MDIO-Tool就是一个命令行工具，让你能够通过MDIO总线，对PHY芯片进行寄存器级别的读写操作。它不是一个图形化的软件，没有花里胡哨的界面，但正是这种“纯粹”让它变得无比高效。
它的核心价值在于三点：
- 快速定位问题：PHY Link不上？速率不对？自协商失败？读一下相关寄存器，马上就能知道PHY当前的状态和配置，不用再靠猜。
- 芯片验证与调试：新拿到的PHY芯片，想要确认它的寄存器映射是否跟数据手册一致？写个值进去，读出来看看对不对，立刻就知道了。
- 自动化测试：可以编写脚本，批量读写PHY的寄存器，把复杂的调试过程自动化，节省大量人力。
我的个人习惯是：在项目初期，就把PHY的调试环境用MDIO-Tool搭建好。这样后面遇到网络问题，我就能快速登上去看一眼，而不是翻箱倒柜去找调试板或者示波器。这能救你不少时间。
1.2 MDIO-Tool的工作原理
你可能会问，MDIO-Tool是怎么跟PHY芯片通信上的？
简单来说，它的工作路径是这样的：
- 硬件层：你的主板或开发板上，有一个叫“以太网MAC”的控制器（比如我们熟悉的RTL8211、BCM5429这些），这个MAC内部集成了MDIO控制器，它有两根线：MDC（时钟线）和MDIO（数据线），直接连到PHY芯片上。
- 驱动层：在Linux内核里，有一个通用的PHY驱动框架，它会去初始化并管理这个MDIO控制器。MDIO-Tool就是通过系统提供的一些接口（比如Socket、IOCTL），跟这个内核驱动打交道。
- 应用层：你在终端敲下命令，MDIO-Tool把它打包成MDIO协议规定的帧格式，通过驱动、硬件，最终发送给PHY芯片。PHY收到后解析协议，找到对应的寄存器，执行读或写操作，再把结果原路返回。
1.3 安装MDIO-Tool
好，理论说完了，咱们来点实际的。安装MDIO-Tool其实非常简单，尤其你用的是Linux系统。嗯，这里要注意，不同发行版的包名可能略有不同。
核心要点：绝大多数嵌入式Linux系统（比如Ubuntu、Debian、Yocto、Buildroot），MDIO-Tool都已经集成在官方的包管理仓库中了，直接命令行安装即可，无需编译源码。
安装步骤（以Debian/Ubuntu为例）：
- 更新软件源：
sudo apt update - 安装MDIO-Tool工具集：
sudo apt install ethtool等等，你可能会问，不是MDIO-Tool吗？这怎么是
ethtool？原因很简单，在Linux世界里，
ethtool就是那个标准的“网络诊断与配置”瑞士军刀，它内部集成了通过MDIO总线读写PHY寄存器的能力。所以，你只要装了这个，就拥有了MDIO-Tool的核心功能。 - 验证安装：
ethtool --version如果终端打印出类似
ethtool version 5.x的信息，就说明安装成功了。
我曾经遇到过一个问题：在一款比较老的嵌入式板子上，直接apt install ethtool装不上，提示包找不到。后来发现是板子上的Linux内核版本太老（2.6.x），官方的软件源已经不维护了。最终解决方案是手动从网上下载了一个较老版本的ethtool源码，交叉编译后才搞定。
给你的建议：确保你的系统有网络连接，并且软件源是有效的。如果是在Yocto或Buildroot系统中，记得在配置时加上ethtool这个包。
1.4 基本功能介绍
安装好了，那它能干什么？我用几个最常见的场景给你说说。
我的习惯：新板子第一次上电，我都会先跑一遍ethtool eth0，看看网口的基本参数，比如速率、双工模式、Link状态。这比看板上的LED灯靠谱得多，你可以马上知道硬件链路是不是通的。
| 功能 | 命令示例 | 说明 |
|---|---|---|
| 查看网口基本信息 | ethtool eth0 |
查看支持的速率、双工模式、自协商状态。 |
| 读取指定PHY寄存器 | ethtool -r eth0 offset 0x01 |
读取PHY地址偏移为0x01的寄存器值。 |
| 写入指定PHY寄存器 | ethtool -w eth0 offset 0x1F value 0x8000 |
将值写入PHY地址偏移为0x1F的寄存器。 |
| 获取网口统计信息 | ethtool -S eth0 |
查看PHY上报的统计数据，如CRC错误、冲突次数等。 |
注意，上面的offset是PHY内部寄存器相对于其基地址的偏移量，而不是寄存器在内存中的物理地址。具体怎么算，我们后面的章节会详细讲。
1.5 常见PHY寄存器一览
最后，我列几个几乎所有PHY芯片都有的、你以后肯定离不开的寄存器。熟记它们，能帮你快速诊断网络问题。
- 寄存器0x00（控制寄存器）：可以用来软复位PHY、配置自协商、强制设置速率/双工模式等。
- 寄存器0x01（状态寄存器）：可以读到Link状态、自协商完成状态、支持的能力（速率、双工模式）。
- 寄存器0x02（PHY ID 高16位）和 0x03（PHY ID 低16位）：用来唯一标识PHY芯片的型号，比如我的PHY ID是0x001cc9b7，通过它你就能知道这颗芯片是哪个厂商的。
- 寄存器0x04（自协商广告寄存器）：配置PHY会向对端广播自己支持的能力。
- 寄存器0x05（连接伙伴能力寄存器）：读出对端设备支持的能力，这里常常能找到Link协商失败的原因。
这五个寄存器，是你调试PHY的第一步。好了，第一章节的内容差不多就这些。从安装到理解它的工作原理，再到几个核心寄存器，这条路你已经走了一半。剩下的，就是拿上这个工具，去实战了。