RT-Thread-artpi2的drv-eth修改使用eth与设备驱动学习笔记RT-Thread问答社区

artpi2的drv-eth修改使用eth与设备驱动学习笔记

发布于 2025-05-26 11:58:18 浏览：149 订阅该版

[tocm]

# 简介

——最近在学习rtthread的使用，想要在stm32h7r的开发板上使用can功能，然后发现artpi2的eth设备驱动没法直接使用，因为初学也想找个东西实际动手做一下，就开干了。
——修改drv-eth参考了正点的h7r，还有st官方例程，基于artpi1的drv-eth上面做的改动
——hal库不要用1.1版本的！！！！！一定要升级到1.2！！！

（吐槽：stm32h7和stm32h7r就一个字母不一样，hal库改动好多，md这个1.1版本的hal库还有问题，找了三天升级到1.2就好了，怀疑可能是readdata里面的更新描述符的尾指针寄存器设置不对。）

# 使用
## 替换文件

[drv_eth.h](https://club.rt-thread.org/file_download/3754a1b639f363d1)
[drv_eth.c](https://club.rt-thread.org/file_download/fafa1821cd8ac815)

## 修改配置文件
——使用ART-PI2的工程

## 修改kconfig
——文件路径是项目/libraries/kconfig。进去翻到BSP_USING_ETH那块，替换成
```
menuconfig BSP_USING_ETH
        bool "Enable Ethernet"
        default n        
        select RT_USING_LWIP
        if BSP_USING_ETH
            config ETH_RESET_PIN
                string "ETH RESET PIN"
                default "PA.3"
        endif
        if BSP_USING_ETH
            choice
                prompt "Choose ETH PHY"
                default PHY_USING_LAN8720A
                config PHY_USING_LAN8720A
                    bool "USING LAN8720A"
                config PHY_USING_DM9161CEP
                    bool "USING DM9161CEP"
                config PHY_USING_DP83848C
                    bool "USING DP83848C"
                config PHY_USING_YT8512C
                    bool "USING YT8512C"
            endchoice
        endif
```

## 修改sconscript
——文件位置在项目/libraries/stm32h7rsxx_hal_driver/sconscript。然后进去，有两行被注释掉的关于eth的代码，修改成
```
if GetDepend(['BSP_USING_ETH']):
    src += ['Src/stm32h7rsxx_hal_eth.c']
    src += ['Src/stm32h7rsxx_hal_eth_ex.c']
```

## 修改cubemx
——这里就不多赘述了，用cubemx配置eth的引脚，模式设置为RMII，eth的输入时钟我设置为了50Mhz。正点的时钟配置有些怪，但是我用了可以正常用，怪在

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250526/05354a659d26b3b19413bb2309f57c12.png.webp)
——这里st写最大是8，但是正点弄了12，用我现在是能正常用

## 效果

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250526/075c8cf68232c2654c3c27298d611d25.png.webp)

# 修改思路

## 头文件
——我现在用的硬件是正点原子的h7r，板上的以太网phy是yt8512c，所以在头文件添加了对应的宏定义和选择，配置了kconfig，可以在rtthread studio里面选择phy的种类。调整了一些宏定义的位置和顺序，yt8512c我看手册好像是支持中断的，但是正点的板子没有把中断引出来，这部分的中断我就没测试了。（偷懒）
.
——还有添加了两个额外的宏定义ETH_RX_BUFFER_SIZE和BSP_ETH_PHY_ADDR，前面那个设置成1536主要是为了32字节对齐，后面那个是phy的地址，我初始化那块把自动找的那段函数注释掉了，如果用的话可以自己改回来。

## 源文件

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250526/94ac50dea2f482330c7b4c639425a05e.png.webp)
——源文件修改的地方比较多，修改最大的地方是读取的时候rt_stm32_eth_rx。然后我发现原来的drv-eth的rt_stm32_eth_rx函数这里pbuf-alloc申请之后next就是空的，实际上好像也只运行了一次。我就想着read时候pbuf链接起来了，这里也改了一下把数据链接起来了，不知道会不会出问题。
.
——在h7r里面读取的操作更改了很多，只用了HAL_ETH_ReadData就可以把所有信息读出来，比较坑的是里面嵌了两个需要外部覆写的函数HAL_ETH_RxAllocateCallback和HAL_ETH_RxLinkCallback。
.
——HAL_ETH_RxAllocateCallback函数简单来说就是弄片buffer内存准备给eth-dma用，我图省事就没有弄动态申请了，直接初始化时候划一片内存给这部分用。我把buffer和pbuf打包成了RX_BUFF结构体，数量和hal库里面定义的ETH_RX_DESC_CNT有关，记得如果调大了可能要改一下分散加载文件，注意32字节对其。
.
——HAL_ETH_RxLinkCallback这个我其实没有太懂为什么要这么做，我的计算机网络基础不太行，应该说没基础。这里面就是把多个以太网帧（应该没说错吧）链接起来，pbuf连起来。但是我有个地方不太明白，接收一帧最大已经是15xx字节了，还要再连接起来吗，我问deepseek他说还有以太网巨型帧9000字节，不知道是不是和这个有关。
.
——其他地方应该就没什么大修改了。

# 笔记

[rt-thread-new.zip](https://club.rt-thread.org/file_download/a6cbab618ec409df)

#结语
——小白初次学习，可能很多地方做的还不完善，如果有问题欢迎各位大佬留言指正。
最后感谢artpi群的老哥的帮助。