手把手教你写一个Linux下的mdio调试工具（附完整C代码）
从零构建Linux MDIO调试工具：深入PHY寄存器操作实战
当你面对一块没有预装mii-tool或ethtool的嵌入式开发板，或者需要直接操作PHY芯片寄存器进行底层调试时，自己动手编写一个轻量级MDIO工具会成为解决问题的关键。本文将带你深入Linux内核的MII接口机制，从Socket通信到ioctl调用，完整实现一个可读写PHY寄存器的命令行工具。
1. MDIO工具开发基础与环境准备
MDIO（Management Data Input/Output）是IEEE 802.3定义的双线串行接口，用于MAC与PHY之间的管理通信。在Linux系统中，内核通过MII ioctl接口向用户空间暴露了这一能力。我们的工具本质上是一个精心设计的ioctl调用封装器。
开发环境需要准备：
- 运行Linux的开发板或PC（内核版本≥2.6）
- GCC工具链
- 基本的C编程知识
- 目标网络设备的PHY芯片手册
关键头文件包括：
#include <linux/mii.h> // MII相关数据结构 #include <sys/ioctl.h> // ioctl系统调用 #include <net/if.h> // 网络接口定义2. 核心架构设计与实现
2.1 网络接口初始化
工具首先需要绑定到特定网络接口。我们使用socket创建本地数据报套接字作为ioctl的通信通道：
int sockfd = socket(PF_LOCAL, SOCK_DGRAM, 0); if (sockfd < 0) { perror("socket creation failed"); return -1; } struct ifreq ifr; memset(&ifr, 0, sizeof(ifr)); strncpy(ifr.ifr_name, argv[1], IFNAMSIZ - 1);2.2 PHY地址自动发现
通过SIOCGMIIPHYioctl可以获取接口关联的PHY地址，这避免了手动配置的麻烦：
int ret = ioctl(sockfd, SIOCGMIIPHY, &ifr); if (ret < 0) { perror("Failed to get PHY address"); close(sockfd); return -1; } struct mii_ioctl_data *mii = (struct mii_ioctl_data*)&ifr.ifr_data; printf("Discovered PHY ID: 0x%x\n", mii->phy_id);2.3 寄存器读写实现
读写操作分别使用SIOCGMIIREG和SIOCSMIIREG命令。我们设计统一的错误处理机制：
#define CMD_READ 1 #define CMD_WRITE 2 int handle_mdio_op(int sockfd, struct ifreq *ifr, int cmd, uint16_t reg, uint16_t val) { struct mii_ioctl_data *mii = (struct mii_ioctl_data*)&ifr->ifr_data; mii->reg_num = reg; if (cmd == CMD_WRITE) { mii->val_in = val; return ioctl(sockfd, SIOCSMIIREG, ifr); } else { int ret = ioctl(sockfd, SIOCGMIIREG, ifr); if (ret == 0) { printf("REG 0x%x: 0x%04x\n", reg, mii->val_out); } return ret; } }3. 命令行接口设计
良好的CLI设计能提升工具易用性。我们支持以下命令格式：
mdio-tool <interface> read <reg> mdio-tool <interface> write <reg> <value>实现代码框架：
int main(int argc, char **argv) { if (argc < 4 || strcmp(argv[2], "read") == 0 && argc != 4 || strcmp(argv[2], "write") == 0 && argc != 5) { print_usage(argv[0]); return 1; } // 初始化socket和ifreq... if (strcmp(argv[2], "read") == 0) { uint16_t reg = strtoul(argv[3], NULL, 0); handle_mdio_op(sockfd, &ifr, CMD_READ, reg, 0); } else if (strcmp(argv[2], "write") == 0) { uint16_t reg = strtoul(argv[3], NULL, 0); uint16_t val = strtoul(argv[4], NULL, 0); handle_mdio_op(sockfd, &ifr, CMD_WRITE, reg, val); } close(sockfd); return 0; }4. 高级功能扩展
4.1 批量寄存器操作
添加批量读取功能，方便调试时扫描寄存器空间：
void scan_registers(int sockfd, struct ifreq *ifr, uint16_t start, uint16_t end) { printf("Scanning registers 0x%x-0x%x:\n", start, end); for (uint16_t reg = start; reg <= end; reg++) { if (handle_mdio_op(sockfd, ifr, CMD_READ, reg, 0) == 0) { // 输出已在handle_mdio_op中处理 } else { fprintf(stderr, "Failed to read reg 0x%x\n", reg); } } }4.2 权限处理与错误恢复
MDIO操作通常需要root权限。我们添加友好的错误提示：
if (geteuid() != 0) { fprintf(stderr, "Error: This tool requires root privileges\n"); fprintf(stderr, "Try running with sudo or as root user\n"); return -EPERM; }对于常见的错误代码，提供解释性信息：
| 错误代码 | 含义 | 建议解决方案 |
|---|---|---|
| EINVAL | 无效参数 | 检查寄存器地址是否有效 |
| ENODEV | 设备不存在 | 确认接口名称正确 |
| EIO | PHY通信错误 | 检查MDIO总线连接 |
| EPERM | 权限不足 | 以root用户运行 |
5. 编译与使用指南
使用以下命令编译工具：
gcc mdio-tool.c -o mdio-tool -Wall -Wextra实际应用示例：
- 读取PHY ID寄存器（通常为寄存器2）：
sudo ./mdio-tool eth0 read 2 - 修改PHY控制寄存器（寄存器0）的复位位：
sudo ./mdio-tool eth0 write 0 0x8000 - 扫描前16个寄存器：
sudo ./mdio-tool eth0 scan 0 15
调试技巧：
- 结合
ethtool -d的输出对比寄存器值 - 修改前务必记录原始值以便恢复
- 某些寄存器位是只读的，写入会失败