当前位置： 首页 > news >正文

A12 STM32_HAL库函数 之 HAL-ETH通用驱动 -- A -- 所有函数的介绍及使用

news 2025/7/20 14:44:27

A12 STM32_HAL库函数 之 HAL-ETH通用驱动 -- A -- 所有函数的介绍及使用

  • 1 通用定时器（TIM）预览
    • 1.1 HAL_ETH_Init
    • 1.2 HAL_ETH_DeInit
    • 1.3 HAL_ETH_DMATxDescListInit
    • 1.4 HAL_ETH_DMARxDescListInit
    • 1.5 HAL_ETH_MspInit
    • 1.6 HAL_ETH_MspDeInit
    • 1.7 HAL_ETH_TransmitFrame
    • 1.8 HAL_ETH_GetReceivedFrame
    • 1.9 HAL_ETH_GetReceivedFrame_IT
    • 1.10 HAL_ETH_IRQHandler
  • 该文档修改记录：
  • 总结

1 通用定时器（TIM）预览

序号函数名描述
1HAL_ETH_Init()初始化以太网控制器。
2HAL_ETH_DeInit()反初始化以太网控制器。
3HAL_ETH_DMATxDescListInit()初始化以太网DMA发送描述符列表。
4HAL_ETH_DMARxDescListInit()初始化以太网DMA接收描述符列表。
5HAL_ETH_MspInit()初始化MCU外设相关的以太网控制器引脚或资源。
6HAL_ETH_MspDeInit()反初始化MCU外设相关的以太网控制器引脚或资源。
7HAL_ETH_TransmitFrame()传输以太网帧。
8HAL_ETH_GetReceivedFrame()获取接收到的以太网帧。
9HAL_ETH_GetReceivedFrame_IT()异步获取接收到的以太网帧，使用中断处理接收完成。
10HAL_ETH_IRQHandler()以太网控制器中断处理程序。
11HAL_ETH_TxCpltCallback()以太网发送完成回调函数。
12HAL_ETH_RxCpltCallback()以太网接收完成回调函数。
13HAL_ETH_ErrorCallback()以太网错误回调函数。
14HAL_ETH_ReadPHYRegister()读取PHY寄存器。
15HAL_ETH_WritePHYRegister()写入PHY寄存器。
16HAL_ETH_Start()启动以太网控制器。
17HAL_ETH_Stop()停止以太网控制器。
18HAL_ETH_ConfigMAC()配置以太网MAC。
19HAL_ETH_ConfigDMA()配置以太网DMA。
20HAL_ETH_GetState()获取以太网控制器状态。

使用模板：

#include "stm32f4xx_hal.h"int main(void) {// HAL初始化HAL_Init();// 初始化MCU外设相关的以太网控制器引脚或资源HAL_ETH_MspInit();// 初始化以太网控制器HAL_ETH_Init();// 进行其他操作...// 启动以太网控制器HAL_ETH_Start();// 启动DMA传输HAL_ETH_TransmitFrame();// 获取接收到的以太网帧HAL_ETH_GetReceivedFrame();// 异步获取接收到的以太网帧，使用中断处理接收完成HAL_ETH_GetReceivedFrame_IT();// 以太网中断处理程序HAL_ETH_IRQHandler();// 获取以太网控制器状态uint32_t ethState = HAL_ETH_GetState();// 停止以太网控制器HAL_ETH_Stop();// 反初始化以太网控制器HAL_ETH_DeInit();// 反初始化MCU外设相关的以太网控制器引脚或资源HAL_ETH_MspDeInit();return 0;
}

1.1 HAL_ETH_Init

函数名HAL_ETH_Init
函数原形HAL_StatusTypeDef HAL_ETH_Init(ETH_HandleTypeDef* heth)
功能描述初始化以太网模块
输入参数heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数无
返回值HAL_StatusTypeDef：初始化结果，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.2 HAL_ETH_DeInit

函数名HAL_ETH_DeInit
函数原形HAL_StatusTypeDef HAL_ETH_DeInit(ETH_HandleTypeDef* heth)
功能描述反初始化以太网模块
输入参数heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数无
返回值HAL_StatusTypeDef：反初始化结果，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.3 HAL_ETH_DMATxDescListInit

函数名HAL_ETH_DMATxDescListInit
函数原形void HAL_ETH_DMATxDescListInit(ETH_HandleTypeDef *heth, ETH_DMADescTypeDef *DMATxDescTab, uint8_t *TxBuffer, uint32_t BufferSize)
功能描述初始化以太网 DMA 发送描述符列表
输入参数 1heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输入参数 2DMATxDescTab：指向 DMA 发送描述符列表的指针
输入参数 3TxBuffer：发送缓冲区的指针
输入参数 4BufferSize：发送缓冲区大小
输出参数无
返回值无
先决条件无
被调用函数无

1.4 HAL_ETH_DMARxDescListInit

函数名HAL_ETH_DMARxDescListInit
函数原形void HAL_ETH_DMARxDescListInit(ETH_HandleTypeDef *heth, ETH_DMADescTypeDef *DMARxDescTab, uint8_t *RxBuffer, uint32_t BufferSize)
功能描述初始化以太网 DMA 接收描述符列表
输入参数 1heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输入参数 2DMARxDescTab：指向 DMA 接收描述符列表的指针
输入参数 3RxBuffer：接收缓冲区的指针
输入参数 4BufferSize：接收缓冲区大小
输出参数无
返回值无
先决条件无
被调用函数无

1.5 HAL_ETH_MspInit

函数名HAL_ETH_MspInit
函数原形void HAL_ETH_MspInit(ETH_HandleTypeDef* heth)
功能描述初始化以太网外设（底层驱动的 MSP 初始化回调函数）
输入参数heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数无
返回值无
先决条件无
被调用函数无

1.6 HAL_ETH_MspDeInit

函数名HAL_ETH_MspDeInit
函数原形void HAL_ETH_MspDeInit(ETH_HandleTypeDef* heth)
功能描述反初始化以太网外设（底层驱动的 MSP 反初始化回调函数）
输入参数heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数无
返回值无
先决条件无
被调用函数无

1.7 HAL_ETH_TransmitFrame

函数名HAL_ETH_TransmitFrame
函数原形HAL_StatusTypeDef HAL_ETH_TransmitFrame(ETH_HandleTypeDef *heth, uint32_t FrameLength)
功能描述以太网发送数据帧
输入参数 1heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输入参数 2FrameLength：要发送的数据帧长度
输出参数无
返回值HAL_StatusTypeDef：发送结果，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.8 HAL_ETH_GetReceivedFrame

函数名HAL_ETH_GetReceivedFrame
函数原形HAL_StatusTypeDef HAL_ETH_GetReceivedFrame(ETH_HandleTypeDef *heth)
功能

描述 | 获取以太网接收到的数据帧 |
| 输入参数 | heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：获取结果，可以是 HAL_OK 或 HAL_ERROR |
| 先决条件 | 无 |
| 被调用函数 | 无 |

1.9 HAL_ETH_GetReceivedFrame_IT

函数名HAL_ETH_GetReceivedFrame_IT
函数原形HAL_StatusTypeDef HAL_ETH_GetReceivedFrame_IT(ETH_HandleTypeDef *heth)
功能描述在中断中获取以太网接收到的数据帧
输入参数heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数无
返回值HAL_StatusTypeDef：获取结果，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.10 HAL_ETH_IRQHandler

函数名HAL_ETH_IRQHandler
函数原形void HAL_ETH_IRQHandler(ETH_HandleTypeDef *heth)
功能描述以太网中断服务函数
输入参数heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数无
返回值无
先决条件无
被调用函数无

该文档修改记录：

修改时间修改说明
2024年4月12日第一次发布，介绍了 A12 STM32_HAL库函数 之 HALETH通用驱动 – A – 所有函数的介绍及使用

总结

以上就是A12 STM32_HAL库函数 之 HALETH通用驱动 – A – 所有函数的介绍及使用的内容。
有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。
创作不容，如果文档对您有帮助，记得给个赞。

http://www.lryc.cn/news/337261.html

相关文章：

  • Linux从入门到精通 --- 1.初始Linux
  • linux使用docker实现redis主从复制和哨兵模式
  • 新版chrome 解决在http协议下无法调用摄像头和麦克风的问题（不安全）
  • 机器学习入门项目二（逻辑回归）
  • C++类引用的好处
  • 从零自制docker-9-【管道实现run进程和init进程传参】
  • 全量知识系统 程序详细设计 之 三种“活物” 之1（QA百度搜索 ）
  • QT 线程之movetothread
  • 如何处理ubuntu22.04LTS安装过程中出现“Daemons using outdated libraries”提示
  • 跟TED演讲学英文：The inside story of ChatGPT‘s astonishing potential by Greg Brockman
  • mybatis05：复杂查询：（多对一，一对多）
  • 微电网优化：基于肝癌算法(Liver Cancer algorithm, LCA)的微电网优化（提供MATLAB代码）
  • VUE_H5页面跳转第三方地图导航，兼容微信浏览器
  • 智慧安全运营：智能化运维，确保服务无忧
  • R-tree总结
  • Python 与机器学习，在服务器使用过程中，常用的 Linux 命令包括哪些？
  • js通过Object.defineProperty实现数据响应式
  • docker最简单教程（使用dockerfile构建环境）
  • Vue2 —— 学习（三）
  • Qt Creator 12.0.2 debug 无法查看变量的值 Expression too Complex
  • LeetCode-Java：303、304区域检索（前缀和）
  • 出海业务的网络安全挑战
  • 蓝桥杯考前准备— — c/c++
  • 【MATLAB源码-第4期】基于MATLAB的1024QAM误码率曲线，以及星座图展示。
  • 数据结构-----枚举、泛型进阶（通配符？)
  • 线上问题监控 Sentry 接入全过程
  • 【数据库（MySQL）基础】以MySQL为例的数据库基础
  • 权限修饰符，代码块，抽象类，接口.Java
  • CSS设置文本
  • 【svg】—— java提取svg中的颜色