Gino_driver_eth

1. 简介

本工程是 GD32H77D Gino 开发板的 ENET1 RMII 以太网参考工程，用于单独学习、配置和验证 Ethernet、RMII 与 TCP/IP 分层。独立工程只启用该功能需要的驱动和组件，可作为应用开发和功能集成的参考。

主参考设备：e0。

所有示例均保留 uart1 作为 FinSH/MSH 控制台，串口参数为 115200-8-N-1；PC4 LED 用于运行指示。

当前工程包含以下 MSH 命令：

lwIP 的 pbuf 通过 RT-Thread eth_device 交给 ENET1。发送端复制 pbuf 链并把 DMA 描述符 ownership 交给硬件；接收中断只通知网络线程，线程复制有效帧并把描述符归还 DMA。PHY 线程负责地址检测、自动协商和链路状态。

一次完整的数据路径如下：

socket/SAL -> lwIP -> e0 eth_device -> ENET DMA -> RMII -> PHY -> 网线

协议层只定义通信或数据处理规则，最终仍需要控制器时钟、引脚复用、中断/DMA 和上层状态机共同工作。扫描到设备、注册了总线或编译通过，都不能替代完整的数据传输验证。

工程使用 GD32H77D ENET1 RMII，PHY 默认地址 2，PC12 接收 50 MHz REF_CLK。ENET DMA 使用专用描述符和缓冲区完成帧收发，MDIO/MDC 用于 PHY 寄存器管理和自动协商。

驱动注册 RT-Thread eth_device 和 e0 netdev。接收中断调用 eth_device_ready 唤醒网络线程，lwIP 提供 IP/TCP/UDP，SAL 向应用提供统一 socket，ifconfig 查看网络配置，ping 检查网络连通性。

主参考设备：e0。设备是否已注册可先通过 list_device 和 gino_device_probe 判断；更上层的文件系统、网络或 GUI 组件还需继续验证其挂载、链路或刷新状态。

ENET1 使用 RMII，默认 PHY 地址 2；PHY 必须向 PC12 提供 50 MHz 参考时钟。

默认控制台：UART1，PA2/PA3，AF7，115200-8-N-1。

以下源码路径以 SDK 仓库中的工程目录为基准：

建议先阅读 applications/main.c 和 applications/device_probe.c，再沿数据路径进入对应驱动、组件或软件包。示例保留 MSH 命令，便于在不改动应用代码的情况下观察设备注册和运行状态。