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

常驻客栈2024-04-13 8:23

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

  • [1 通用定时器（TIM）预览](#1 通用定时器（TIM）预览)
    • [1.11 HAL_ETH_TxCpltCallback](#1.11 HAL_ETH_TxCpltCallback)
    • [1.12 HAL_ETH_RxCpltCallback](#1.12 HAL_ETH_RxCpltCallback)
    • [1.13 HAL_ETH_ErrorCallback](#1.13 HAL_ETH_ErrorCallback)
    • [1.14 HAL_ETH_ReadPHYRegister](#1.14 HAL_ETH_ReadPHYRegister)
    • [1.15 HAL_ETH_WritePHYRegister](#1.15 HAL_ETH_WritePHYRegister)
    • [1.16 HAL_ETH_Start](#1.16 HAL_ETH_Start)
    • [1.17 HAL_ETH_Stop](#1.17 HAL_ETH_Stop)
    • [1.18 HAL_ETH_ConfigMAC](#1.18 HAL_ETH_ConfigMAC)
    • [1.19 HAL_ETH_ConfigDMA](#1.19 HAL_ETH_ConfigDMA)
    • [1.20 HAL_ETH_GetState](#1.20 HAL_ETH_GetState)
  • 该文档修改记录：
  • 总结

1 通用定时器（TIM）预览

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

使用模板：

c 复制代码 
#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.11 HAL_ETH_TxCpltCallback

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

1.12 HAL_ETH_RxCpltCallback

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

1.13 HAL_ETH_ErrorCallback

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

1.14 HAL_ETH_ReadPHYRegister

函数名 HAL_ETH_ReadPHYRegister
函数原形 uint32_t HAL_ETH_ReadPHYRegister(ETH_HandleTypeDef *heth, uint16_t PHYRegAddr)
功能描述 读取以太网 PHY 寄存器的值
输入参数 1 heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输入参数 2 PHYRegAddr：PHY 寄存器地址
输出参数 无
返回值 uint32_t：PHY 寄存器的值
先决条件 无
被调用函数 无

1.15 HAL_ETH_WritePHYRegister

函数名 HAL_ETH_WritePHYRegister
函数原形 void HAL_ETH_WritePHYRegister(ETH_HandleTypeDef *heth, uint16_t PHYRegAddr, uint32_t PHYValue)
功能描述 写入以太网 PHY 寄存器的值
输入参数 1 heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输入参数 2 PHYRegAddr：PHY 寄存器地址
输入参数 3 PHYValue：要写入的值
输出参数 无
返回值 无
先决条件 无
被调用函数 无

1.16 HAL_ETH_Start

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

1.17 HAL_ETH_Stop

函数名 HAL_ETH_Stop
函数原形 HAL_StatusTypeDef HAL_ETH_Stop(ETH_HandleTypeDef *heth)
功能描述
复制代码 
              | 停止以太网模块                                                 |

| 输入参数 | heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体 |

| 输出参数 | 无 |

| 返回值 | HAL_StatusTypeDef：停止结果，可以是 HAL_OK 或 HAL_ERROR |

| 先决条件 | 无 |

| 被调用函数 | 无 |

1.18 HAL_ETH_ConfigMAC

函数名 HAL_ETH_ConfigMAC
函数原形 HAL_StatusTypeDef HAL_ETH_ConfigMAC(ETH_HandleTypeDef *heth, ETH_MACInitTypeDef *macconf)
功能描述 配置以太网 MAC 地址
输入参数 1 heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输入参数 2 macconf：MAC 初始化配置，指向一个 ETH_MACInitTypeDef 结构体
输出参数 无
返回值 HAL_StatusTypeDef：配置结果，可以是 HAL_OK 或 HAL_ERROR
先决条件 无
被调用函数 无

1.19 HAL_ETH_ConfigDMA

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

1.20 HAL_ETH_GetState

函数名 HAL_ETH_GetState
函数原形 HAL_ETH_StateTypeDef HAL_ETH_GetState(ETH_HandleTypeDef *heth)
功能描述 获取以太网当前状态
输入参数 heth：以太网句柄，指向一个 ETH_HandleTypeDef 结构体
输出参数 无
返回值 HAL_ETH_StateTypeDef：当前状态，可能的值有 HAL_ETH_STATE_RESET、HAL_ETH_STATE_READY 或 HAL_ETH_STATE_BUSY
先决条件 无
被调用函数 无

该文档修改记录：

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

总结

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

相关推荐
计蒙不吃鱼20 分钟前
星闪开发之Server-Client 指令交互控制红灯亮灭案例解析（SLE_LED详解）
嵌入式硬件·物联网·iot·星闪·星闪开发
想搞嵌入式的小白1 小时前
STM32 NVIC中断控制器
stm32·单片机·嵌入式硬件·nvic
A-花开堪折1 小时前
Android7 Input（十）View 处理Input事件pipeline
android·嵌入式硬件
深圳市尚想信息技术有限公司2 小时前
【深尚想】OPA855QDSGRQ1运算放大器IC德州仪器TI汽车级高速8GHz增益带宽的全面解析
单片机·嵌入式硬件
陕西艾瑞科惯性技术有限公司3 小时前
让飞行姿态 “可感知”：为什么无人机需要三轴陀螺仪？
嵌入式硬件·机器学习·机器人·无人机·pcb工艺
代码总长两年半3 小时前
STM32----IAP远程升级
stm32·单片机·嵌入式硬件
广药门徒3 小时前
STM32手册上标称的18MHz GPIO翻转速度和你实际测量到的速度之间的差异是预期之内且合理的
单片机·嵌入式硬件
广药门徒3 小时前
在使用一些不用驱动大电流的设备就可以用stm32的自己的上下拉但是本身上下拉不就是给iicspi这些他通信给信号的吗中怎么还跟驱动能力扯上了有什么场景嘛
stm32·单片机·fpga开发
jz_ddk4 小时前
[zynq] Zynq Linux 环境下 AXI BRAM 控制器驱动方法详解（代码示例）
linux·运维·c语言·网络·嵌入式硬件
天天爱吃肉82185 小时前
【十年技术演进深度解构：车载充电机(OBC)将成为新能源汽车的“能源大脑”】
python·嵌入式硬件·算法·汽车·能源
热门推荐
01从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑02KGG转MP3工具|非KGM文件|解密音频03YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】04VMware虚拟机安装Win7专业版保姆级教程（附镜像包）05DeepSeek各版本说明与优缺点分析06【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！07山东大学2024深度学习期末考试回忆08wandb使用遇到的一些问题09组基轨迹建模 GBTM的介绍与实现（Stata 或 R）10Coze扣子平台完整体验和实践（附国内和国际版对比）