RTL8306MB交换芯片驱动移植：GPIO模拟MDC/MDIO与SDK裁剪实战

1. 项目缘起与整体设计思路RTL8306MB 这颗芯片在嵌入式圈子里算是老熟人了六口百兆交换支持 VLAN、QoS、端口镜像价格便宜量又足大量国产路由、工业网关、NVR 里面都能见到它的身影。但真正上手做移植的时候很多人会卡在第一步这颗芯片的 SDK 到底怎么跑起来官方给的参考代码往往绑定了特定平台寄存器访问层写得云里雾里MDC/MDIO 时序又跟主控 GPIO 对不上折腾几天连芯片 ID 都读不出来。我自己前前后后做过三四个基于 RTL8306MB 的项目主控从 STM32 到国产 RISC-V 都有最开始也是被 MDC/MDIO 的时序坑得够呛。后来摸索出一套用普通 GPIO 模拟 MDC/MDIO 的通用方案不依赖任何硬件外设只要主控能控制两个引脚的高低电平、能读一个引脚的状态就能把 SDK 跑通。这套方案的好处是移植性极强换主控只需要改几个宏定义逻辑层完全不用动。这篇文章就是把这套流程完整拆开讲清楚。适合正在做交换芯片驱动移植的嵌入式工程师也适合想了解 MDC/MDIO 底层时序的初学者。我会从整体架构讲起然后逐层拆解 GPIO 模拟的时序细节、SDK 的裁剪方法、寄存器读写封装最后给出完整的实操步骤和踩坑记录。你跟着走一遍基本能在一个下午内把芯片 ID 读出来第二天把 VLAN 配通。1.1 为什么选择 GPIO 模拟而不是硬件外设很多主控自带 MAC 或者专用 MDIO 控制器理论上用硬件外设更省 CPU。但实际项目里硬件 MDIO 有几个绕不开的问题。第一是引脚复用冲突主控的 MDIO 引脚往往跟其他功能复用一旦被占用就得重新规划整个引脚表。第二是时序兼容性RTL8306MB 的 MDIO 时序对建立时间和保持时间有要求某些主控的硬件 MDIO 时钟分频粒度太粗调不到合适的频率。第三是调试便利性硬件外设出问题只能看寄存器GPIO 模拟可以直接用示波器或者逻辑分析仪抓波形一眼就能看出问题在哪。GPIO 模拟的代价是 CPU 占用。MDC 频率一般跑在 1MHz 到 2.5MHz 之间每次读写大概几十个时钟周期对于配置寄存器的场景来说完全够用。只有在需要频繁轮询链路状态的时候才需要考虑优化但那种场景下也可以用定时器中断来驱动不一定非要硬件外设。提示如果你的主控 GPIO 翻转速度能到 10MHz 以上GPIO 模拟 MDC 跑到 2.5MHz 毫无压力。实测 STM32F103 用寄存器直接操作 GPIOMDC 可以稳定跑到 5MHzRTL8306MB 也能正常响应。1.2 SDK 移植的整体分层架构我把整个移植工作分成四层从下到上依次是GPIO 抽象层、MDC/MDIO 时序层、寄存器访问层、SDK 适配层。这样分层的好处是每一层职责单一换平台的时候只需要改最底下两层。GPIO 抽象层负责把主控的 GPIO 操作封装成统一的接口比如mdio_gpio_init()、mdc_set_high()、mdc_set_low()、mdio_set_output()、mdio_set_input()、mdio_read()。这一层是唯一跟具体主控相关的部分换芯片只改这里。MDC/MDIO 时序层实现标准的 MDIO 帧格式包括前导码、起始码、操作码、PHY 地址、寄存器地址、 turnaround、数据段。这一层完全用 GPIO 抽象层的接口来拼时序不涉及任何硬件寄存器。寄存器访问层把 MDC/MDIO 帧封装成rtl8306_read_reg()和rtl8306_write_reg()两个函数上层 SDK 只调这两个函数。SDK 适配层是官方 SDK 的裁剪和适配把原本依赖特定平台的代码替换成我们自己的寄存器访问接口。这种分层方式看起来多写了一些代码但后期维护和换平台的时候省下来的时间远超前期投入。我有个项目从 STM32 换到 GD32只改了 GPIO 抽象层的十几个宏定义半天就搞定了。2. MDC/MDIO 时序细节与 GPIO 模拟要点MDC/MDIO 是 IEEE 802.3 定义的 management interface电气特性上 MDC 是时钟MDIO 是双向数据线。RTL8306MB 支持 Clause 22 和 Clause 45 两种帧格式配置交换功能用 Clause 22 就够了。Clause 22 的帧格式是固定的 32 位前导码加 32 位帧内容总共 64 个 MDC 周期。2.1 Clause 22 帧格式逐位拆解一个完整的 Clause 22 读操作帧长这样前 32 位全是 1 的前导码接着是 2 位起始码012 位操作码10表示读、01表示写5 位 PHY 地址5 位寄存器地址2 位 turnaround最后 16 位数据。写操作没有 turnaround 的第二个位数据段直接由主控驱动。这里有几个容易搞错的地方。第一是前导码RTL8306MB 要求至少 32 个连续的 1少一个都可能不响应。第二是 PHY 地址RTL8306MB 的 PHY 地址由硬件引脚决定通常是 0 到 7 之间的某个值具体要看原理图上的 strapping 电阻。第三是 turnaround读操作时主控要先释放 MDIO 线然后由芯片驱动如果主控释放不及时就会冲突。我在实际调试的时候遇到过一个诡异问题读寄存器偶尔返回全 1偶尔正常。用逻辑分析仪抓波形发现主控在 turnaround 阶段没有及时把 MDIO 切成输入导致芯片驱动的时候跟主控的输出缓冲打架。后来在切换方向之前加了一个 MDC 周期的延时问题就消失了。2.2 GPIO 模拟的时序参数计算MDC 频率的选择要考虑两个因素芯片的最大支持频率和主控 GPIO 的翻转速度。RTL8306MB 的 MDC 最大频率是 12.5MHz但实际用 1MHz 到 2.5MHz 就足够了太快反而容易受信号完整性影响。假设主控主频 72MHzGPIO 翻转一次需要 2 个时钟周期那么 MDC 半周期至少需要 4 个时钟周期才能保证稳定。MDC 频率 72MHz / (2 * 4) 9MHz这是理论上限。实际用的时候我会留足余量把 MDC 跑到 2MHz 左右半周期 18 个时钟周期波形非常干净。具体实现的时候我用一个mdio_delay()函数来控制半周期延时。这个函数可以用空循环实现也可以用__NOP()指令。空循环的循环次数需要根据主控主频和编译器优化等级来调整最好用示波器实测一下 MDC 频率。static void mdio_delay(void) { for (volatile int i 0; i MDIO_DELAY_CNT; i) { __NOP(); } }MDIO_DELAY_CNT这个值需要根据实际情况调整。我的经验是先在 10 左右试然后用示波器看 MDC 频率如果太高就加大太低就减小。注意编译器优化等级会影响空循环的实际执行时间-O2和-O0下同样的循环次数可能差好几倍。2.3 MDIO 方向切换的注意事项MDIO 是双向线主控需要能在输出和输入之间切换。用 GPIO 模拟的时候切换方向涉及到 GPIO 模式寄存器的修改这个操作本身需要几个时钟周期如果切换太频繁会影响时序。我的做法是在帧开始之前把 MDIO 设成输出前导码、起始码、操作码、PHY 地址、寄存器地址、turnaround 的第一个位都在这期间发送。然后在 turnaround 的第二个位之前切换成输入等待芯片驱动数据。读完之后再切回输出为下一帧做准备。这里有个细节切换方向之后最好加一个短暂的延时让 GPIO 电平稳定下来再采样。我一般加一个 MDC 半周期的延时实测下来很稳。注意有些主控的 GPIO 在切换方向的时候会产生毛刺如果芯片对毛刺敏感可以在 MDIO 线上加一个 22 欧姆的串联电阻或者把 MDC 频率降下来。3. SDK 裁剪与寄存器访问层实现官方 SDK 通常包含大量跟特定平台相关的代码直接编译肯定过不了。我的做法是先通读一遍 SDK 的目录结构找出核心的寄存器定义和配置函数把平台相关的部分全部替换掉。3.1 SDK 目录结构与核心文件识别RTL8306MB SDK 一般包含这几个部分寄存器定义头文件、PHY 驱动、交换核心驱动、VLAN 配置、QoS 配置、端口镜像、示例代码。其中寄存器定义头文件和交换核心驱动是必须的其他部分可以根据项目需求裁剪。寄存器定义头文件通常叫rtl8306_reg.h或者类似的名字里面定义了所有寄存器的地址和位域。这个文件一般不需要改直接拿来用。交换核心驱动通常叫rtl8306_drv.c里面包含了芯片初始化、端口配置、VLAN 配置等函数。这个文件需要改的是寄存器读写接口把原本调用平台特定函数的代码替换成我们自己的rtl8306_read_reg()和rtl8306_write_reg()。PHY 驱动部分如果项目里不用外部 PHY可以整个删掉。VLAN 和 QoS 部分按需保留。3.2 寄存器读写函数的封装寄存器读写函数是整个移植的核心我把它写成这样uint16_t rtl8306_read_reg(uint8_t phy_addr, uint8_t reg_addr) { uint16_t data 0; int i; mdio_set_output(); mdc_set_low(); /* 发送 32 位前导码 */ for (i 0; i 32; i) { mdio_set_high(); mdc_pulse(); } /* 发送起始码 01 */ mdio_set_low(); mdc_pulse(); mdio_set_high(); mdc_pulse(); /* 发送操作码 10 (读) */ mdio_set_high(); mdc_pulse(); mdio_set_low(); mdc_pulse(); /* 发送 5 位 PHY 地址 */ for (i 4; i 0; i--) { if (phy_addr (1 i)) { mdio_set_high(); } else { mdio_set_low(); } mdc_pulse(); } /* 发送 5 位寄存器地址 */ for (i 4; i 0; i--) { if (reg_addr (1 i)) { mdio_set_high(); } else { mdio_set_low(); } mdc_pulse(); } /* Turnaround: 释放 MDIO */ mdio_set_input(); mdc_pulse(); mdc_pulse(); /* 读取 16 位数据 */ for (i 15; i 0; i--) { mdc_set_high(); mdio_delay(); if (mdio_read()) { data | (1 i); } mdc_set_low(); mdio_delay(); } mdio_set_output(); return data; }写操作的逻辑类似区别是操作码用01turnaround 只有一位数据段由主控驱动。这里有个优化点前导码的 32 个 1 可以用循环展开来加速但实测下来循环版本在 2MHz MDC 下完全够用没必要为了省几个周期把代码写得很难看。3.3 芯片 ID 读取与验证移植完成之后第一步是读芯片 ID 验证通信是否正常。RTL8306MB 的芯片 ID 寄存器地址是 0x00 和 0x01PHY 地址通常是 0x00 到 0x07 之间的某个值。uint16_t id_high rtl8306_read_reg(phy_addr, 0x02); uint16_t id_low rtl8306_read_reg(phy_addr, 0x03); printf(Chip ID: 0x%04X%04X\n, id_high, id_low);RTL8306MB 的 ID 应该是 0x001CC0xx 之类的值具体要看数据手册。如果读出来是全 0 或者全 1说明通信有问题需要检查接线、PHY 地址、时序参数。我遇到过读出来 ID 对但寄存器读写不稳定的情况后来发现是 MDC 频率太高降到 1MHz 就正常了。所以如果遇到奇怪的问题先把 MDC 降速试试。4. 完整实操流程与调试记录这一章我把整个移植过程按步骤拆开从环境准备到功能验证每一步都给出具体的操作和注意事项。4.1 硬件连接与引脚确认首先确认硬件连接。RTL8306MB 的 MDC 和 MDIO 引脚通常标在原理图上找到它们跟主控的连接关系。如果原理图上没有明确标注可以用万用表测通断找到主控上对应的 GPIO。MDC 是主控输出到芯片的时钟MDIO 是双向数据线。有些设计会在 MDIO 上加一个上拉电阻这个电阻是必须的因为 MDIO 在空闲状态需要保持高电平。如果原理图上没有上拉电阻需要在主控端开启内部上拉或者外部补一个 4.7k 的上拉。PHY 地址由芯片的 strapping 引脚决定通常在原理图上会标注。如果没有标注可以逐个 PHY 地址试从 0 到 7 遍历一遍能读出正确 ID 的就是对的。4.2 GPIO 抽象层的实现GPIO 抽象层的实现跟具体主控相关我用 STM32 的 HAL 库举个例子#define MDC_PORT GPIOA #define MDC_PIN GPIO_PIN_1 #define MDIO_PORT GPIOA #define MDIO_PIN GPIO_PIN_2 static void mdc_set_high(void) { HAL_GPIO_WritePin(MDC_PORT, MDC_PIN, GPIO_PIN_SET); } static void mdc_set_low(void) { HAL_GPIO_WritePin(MDC_PORT, MDC_PIN, GPIO_PIN_RESET); } static void mdio_set_output(void) { GPIO_InitTypeDef init {0}; init.Pin MDIO_PIN; init.Mode GPIO_MODE_OUTPUT_PP; init.Pull GPIO_NOPULL; init.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(MDIO_PORT, init); } static void mdio_set_input(void) { GPIO_InitTypeDef init {0}; init.Pin MDIO_PIN; init.Mode GPIO_MODE_INPUT; init.Pull GPIO_PULLUP; HAL_GPIO_Init(MDIO_PORT, init); } static void mdio_set_high(void) { HAL_GPIO_WritePin(MDIO_PORT, MDIO_PIN, GPIO_PIN_SET); } static void mdio_set_low(void) { HAL_GPIO_WritePin(MDIO_PORT, MDIO_PIN, GPIO_PIN_RESET); } static uint8_t mdio_read(void) { return HAL_GPIO_ReadPin(MDIO_PORT, MDIO_PIN) GPIO_PIN_SET ? 1 : 0; }用 HAL 库的好处是可移植性好缺点是速度慢。如果 MDC 频率上不去可以把 HAL 调用换成直接操作寄存器static void mdc_set_high(void) { MDC_PORT-BSRR MDC_PIN; } static void mdc_set_low(void) { MDC_PORT-BSRR (uint32_t)MDC_PIN 16; }直接操作寄存器可以把 MDC 频率提高好几倍实测 STM32F103 用寄存器操作能跑到 5MHz 以上。4.3 SDK 集成与编译配置把 SDK 的核心文件拷贝到项目里然后修改寄存器读写接口。具体做法是在 SDK 的驱动文件里找到原本的读写函数把它们替换成我们的rtl8306_read_reg()和rtl8306_write_reg()。如果 SDK 里用了很多平台相关的类型定义比如uint16、uint32之类的需要在头文件里做兼容typedef unsigned char uint8; typedef unsigned short uint16; typedef unsigned int uint32;编译的时候注意头文件路径把 SDK 的 include 目录加到编译器的搜索路径里。如果遇到重复定义的问题检查一下是不是跟主控的库冲突了。4.4 功能验证与常见问题排查芯片 ID 读出来之后下一步是验证端口配置。先读一下端口状态寄存器看看链路是否正常。然后配置 VLAN把几个端口划到同一个 VLAN 里测试数据转发。常见问题我整理了一个速查表现象可能原因排查方法读出来全是 0MDIO 没上拉、PHY 地址错、时序太快检查上拉电阻、遍历 PHY 地址、降低 MDC 频率读出来全是 1MDIO 线断路、芯片没供电测 MDIO 对地电压、检查芯片供电ID 正确但寄存器读写不稳定时序余量不足、方向切换太慢降低 MDC 频率、在方向切换后加延时写寄存器后读出来没变写操作码错、turnaround 处理错用逻辑分析仪抓波形对比数据手册端口不转发数据VLAN 配置错、端口没使能读 VLAN 寄存器和端口控制寄存器我踩过最坑的一个问题是 MDIO 上拉电阻没焊读出来全是 0查了半天以为是时序问题。后来用万用表一测MDIO 线对地电压是 0才发现是硬件问题。所以遇到通信问题先确认硬件没问题再查软件。提示逻辑分析仪是调试 MDC/MDIO 的利器几百块的那种就够了。抓波形的时候把 MDC 和 MDIO 同时接上对比数据手册的时序图一眼就能看出问题在哪。5. 移植后的优化与扩展思路基础功能跑通之后还有一些优化和扩展可以做。这些不是必须的但能让代码更健壮、更好维护。5.1 提高 MDC 频率的几种方法如果项目对配置速度有要求可以尝试提高 MDC 频率。方法有几个把 HAL 库调用换成直接寄存器操作、把mdio_delay()的循环次数减小、用编译器的-O2优化。但要注意频率越高对信号完整性的要求越高MDIO 线上的上拉电阻和串联电阻要选合适。我一般会把 MDC 频率做成可配置的宏调试的时候用低频稳定之后再逐步提高。这样万一出问题改一个宏就能降速不用重新编译整个工程。5.2 寄存器访问的缓存与批量操作SDK 里有些配置需要连续写多个寄存器如果每次都走完整的 MDC/MDIO 帧效率比较低。可以在寄存器访问层加一个缓存把连续的写操作合并成一次帧传输。不过 RTL8306MB 的寄存器地址不连续合并的收益有限我一般不做这个优化。读操作倒是可以加缓存比如链路状态寄存器不需要每次都读可以定时刷新。但要注意缓存一致性写寄存器之后要清掉对应的缓存。5.3 多芯片级联的地址管理有些项目里会用到多颗 RTL8306MB 级联这时候 PHY 地址的管理就很重要。每颗芯片的 PHY 地址不能冲突通常通过 strapping 引脚设置。软件上可以把 PHY 地址做成一个数组每个芯片对应一个地址读写的时候指定芯片索引。级联的时候还要注意 MDC/MDIO 总线的负载多颗芯片并联会增加容性负载可能导致波形变差。如果遇到通信不稳定可以降低 MDC 频率或者在每颗芯片的 MDIO 线上加串联电阻。5.4 移植到其他交换芯片的通用性这套 GPIO 模拟 MDC/MDIO 的方案不只适用于 RTL8306MB其他支持 Clause 22 的交换芯片也能用。区别主要在 PHY 地址、寄存器定义和初始化流程。把寄存器访问层和 SDK 适配层分开换芯片的时候只需要改 SDK 适配层底下的时序层完全不用动。我后来用同样的方案移植过 RTL8367 和 MT7530基本上半天就能跑通。所以这套分层架构的投入是值得的。最后分享一个小技巧调试 MDC/MDIO 的时候可以先写一个简单的测试程序只读芯片 ID不跑 SDK。这样能把问题范围缩小到硬件和时序层排除 SDK 的干扰。等 ID 读出来了再逐步集成 SDK 的其他功能。这个顺序能省很多调试时间。