当前位置:   article > 正文

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

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

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
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43

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 – 所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/从前慢现在也慢/article/detail/618762
推荐阅读
相关标签
  

闽ICP备14008679号