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

最新推荐文章于 2024-04-26 10:07:11 发布
最新推荐文章于 2024-04-26 10:07:11 发布
阅读量862 收藏 22
点赞数 21
分类专栏： 介绍STM32标准库及HAL库函数说明及函数的使用方法 文章标签： stm32 嵌入式硬件 单片机 HAL库 函数说明 ETH
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_50808730/article/details/137411498
版权

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

常驻客栈
关注
  • 21
    点赞
  • 踩
  • 22
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
HT1621B_STM32_HAL-master_stm32ht1621b_stm32hal_
09-30
stm32单片机 LCD驱动HT1621B
STM32以太网接口的配置和使用方法详解
weixin_66608063的博客
01-29 1272
一般来说，PHY芯片的接口信号包括RMII或MII接口，需要与STM32微控制器的相应接口进行连接，并且还需要提供相应的时钟信号。在"Peripherals"选项卡中选择"ETH"（Ethernet）选项，然后进行相应的配置，包括时钟配置、DMA配置、中断配置等。对于以太网接口的中断处理，还需要编写对应的中断服务函数。在实际应用中，还可以根据具体需求进行更加灵活和复杂的配置和操作，包括网络协议栈的支持、数据包过滤、数据处理等功能。☁ 愿你的生命中有够多的云翳,来造就一个美丽的黄昏。✅作者简介：热爱科研的。
A13 STM32_HAL库函数 之 HAL-ETH通用驱动 -- B -- 所有函数的介绍及使用
qq_50808730的博客
04-12 764
以上就是A13 STM32_HAL库函数 之 HALETH通用驱动 – B – 所有函数的介绍及使用的内容。有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。创作不容，如果文档对您有帮助，记得给个赞。
【HAL库】STM32CubeMX开发----STM32F103/F207/F407----目录
MQ0522的博客
10-19 3058
【HAL库】STM32CubeMX开发----STM32F407----目录
STM32F429第六篇之stm32f4xx_hal_gpio
我想想的博客
09-10 2824
文章目录前言主要功能与使用方法功能使用方法 前言 本文主要介绍HAL库中Stm32F429的GPIO用法。主要参考资料： STM32F439xx HAL USER Manual 关于GPIO寄存器相关知识，可以参阅stm32F4xx中文参考手册，里面对于硬件底层以及寄存器有详细的介绍，本文不再详细展开。在使用HAL库的时候，即使不了解底层硬件和寄存器知识，同样可以完成项目的开发。此处，只需要了解HAL库驱动函数的使用方法即可。了解驱动函数的使用方法可以通过以下两种途径： 阅读源程序和其中的注释 阅读用
STM32F4 - MQTT_HAL库MQTT函数_esp8266mqtt_stm32f4库函数_stm32MQTT库_MQTT
10-02
基于MQTT协议的库函数，详细说明如何使用。
IIC_LCD1602 STM32-HAL驱动程序-硬件IIC
11-11
STM32F103C8T6驱动LCD(带PCF8574转接板，IIC驱动)，利用CUBEMAX生成，HAL库硬件IIC.
STM32_HOST_UVC_Camera-master.zip
01-09
声明：本例程并非本人所有，但找...本资源以HAL库+LL库，基于IAR平台，实现STM32F4驱动UVC摄像头例程，可直接运用于STM32F429+LTDC显示屏。可根据LCD驱动接口进行驱动替换。亲测F407ZGT6+fsmc进行LCD显示视频fps为15。
00-STM32F4xx_HAL_DRIVERS.7z
07-22
00-STM32F4xx_HAL_DRIVERS.7z
b站江科大stm32笔记（持续更新）
Xkccsdn147的博客
04-13 2509
笔记
STM32 ULINK
m0_73640344的博客
04-23 233
此外，ULINK 还可以用于对目标设备进行固件编程和更新，包括烧录程序、擦除存储器、更新固件等操作。总的来说，ULINK 是一种专业、高效的嵌入式系统调试和仿真工具，为 ARM Cortex-M 微控制器的开发和调试提供了方便、快捷的解决方案。：ULINK 提供了丰富的调试功能，包括设置断点、单步执行、观察变量和寄存器、跟踪程序执行流程等，帮助开发人员快速定位和解决问题。：ULINK 具有简单、直观的用户界面和操作流程，使得开发人员能够轻松进行调试和编程操作，适用于各种开发经验和水平的用户。
STM32几种库的比较，HAL、标准库、LL库！
Kyle_Chan_zMH的博客
04-17 1505
HAL库适合快速开发和易用性要求较高的应用，LL库适合对性能和实时性要求较高的应用，而标准库适合通用的数据处理和算法实现。其中包括HAL库、LL库和标准库（C标准库）。当涉及到STM32微控制器的软件开发时，选择合适的库取决于项目的需求和开发者的偏好。例子：假设我们要编写一个程序，控制STM32微控制器上的LED灯，同时读取来自外部温度传感器的数据，并通过串口发送到计算机上进行显示。例子：假设我们要编写一个程序，控制STM32微控制器上的电机，以特定的时序和延迟进行旋转，并实时监测电机的位置和速度。
学习STM32第十六天
dabuding666的博客
04-18 2670
学习RTC实时时钟相关知识
stm32 hid自定义接收发送程序开发过程记录
最新发布
anlog的专栏
04-26 853
使用CubeMX 生成 USB从机 Custom HID 工程（STM32F407ZE ）_stm32f407 hid bug-CSDN博客。错误的修改位置（由于原有模板已经在外部定义了此参数，因此不能再这里修改，否则会出错，程序死机）USB鼠标HID描述符以及数据格式_hidusb输出的数据类型-CSDN博客。USB协议详解第10讲（USB描述符-报告描述符）-CSDN博客。修改设备描述符大小为35（上面一共35个字符）修改报告描述符（默认的描述符无法传输数据）修改发送buf大小（注意必须在此处修改）
学习STM32第十五天
dabuding666的博客
04-17 1600
学习STM32F4XX硬件SPI外设
STM32学习和实践笔记（19）：按键控制实验（用STM32的外部中断的方式实现）
qq_37191547的博客
04-23 266
花了两小时，对照着视频的讲解，终于成功做完这个实验~~
STM32的Flash读写保护
anlog的专栏
04-26 278
STM32的Flash读写保护，SWD引脚锁的各种解决办法汇总（2020-03-10）-腾讯云开发者社区-腾讯云 (tencent.com)2024年4月26日。
STM32点灯大师（点了一颗LED灯，轮询法）
m0_52883102的博客
04-24 356
最后就是点击。
STM32g单片机HAL库函数HAL_FLASHEx_Erase代码及解析
05-27
以下是STM32G单片机HAL库函数HAL_FLASHEx_Erase的代码实现及解析： ```c HAL_StatusTypeDef HAL_FLASHEx_Erase(FLASH_EraseInitTypeDef *pEraseInit, uint32_t *SectorError) { uint32_t nbSectorsToErase = 0U; uint32_t sectorErrorTmp; uint32_t sectorErrorMask; HAL_StatusTypeDef status = HAL_OK; /* Check the parameters */ assert_param(IS_FLASH_TYPEERASE(pEraseInit->TypeErase)); assert_param(IS_FLASH_BANK_EXCLUSIVE(pEraseInit->Banks)); assert_param(IS_FLASH_NBSECTORS(pEraseInit->NbSectors)); /* Wait for last operation to be completed */ status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if (status != HAL_OK) { return status; } /* Clear OPTVERR bit set on virgin samples */ __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_OPTVERR); /* Get the number of sectors to erase from 1st sector*/ nbSectorsToErase = pEraseInit->NbSectors; /* Check if there are any sectors to erase */ if (nbSectorsToErase == 0U) { return HAL_ERROR; } /* Initialize sectorErrorMask to 0 */ sectorErrorMask = 0U; /* Erase by sector by sector to have a higher granularity than the page erase */ while (nbSectorsToErase > 0U) { /* Fill EraseInit structure*/ pEraseInit->TypeErase = FLASH_TYPEERASE_SECTORS; /* Select the bank to erase */ if (pEraseInit->Banks == FLASH_BANK_1) { pEraseInit->Bank = FLASH_BANK_1; } #if defined(FLASH_BANK_2) else if (pEraseInit->Banks == FLASH_BANK_2) { pEraseInit->Bank = FLASH_BANK_2; } #endif /* FLASH_BANK_2 */ /* Get the sector to erase */ uint32_t sectorNb = FLASH_SECTOR_0; for (uint32_t i = 0; i < FLASH_SECTOR_NUMBER; i++) { if (pEraseInit->Sector & (1UL << i)) { sectorNb = i; break; } } pEraseInit->Sector = sectorNb; /* Call the erase module */ HAL_FLASHEx_Erase_IT(pEraseInit); /* Wait for last operation to be completed */ status = FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); /* If the erase operation is completed, disable the SER Bit */ CLEAR_BIT(FLASH->CR, FLASH_CR_SER); if (status != HAL_OK) { /* In case of error, stop erase procedure and return the faulty sector */ sectorErrorMask |= (1UL << sectorNb); /* Save the error code */ sectorErrorTmp |= status; } else { /* No error occurred in sector erase operation sectorErrorMask is reset */ sectorErrorMask = 0U; } /* Decrement number of sectors to erase */ nbSectorsToErase--; /* Point on next sector */ pEraseInit->Sector = (uint32_t)(pEraseInit->Sector << 1U); } /* Return the erase status */ if (SectorError != NULL) { *SectorError = sectorErrorTmp; } if (sectorErrorMask != 0U) { status = HAL_ERROR; } return status; } ``` HAL_FLASHEx_Erase函数的实现过程如下： 1. 检查输入参数pEraseInit是否合法。该结构体包含了要擦除的Flash扇区的相关信息，如起始地址、扇区数量和擦除方式等。 2. 等待上一次Flash操作（如写入或擦除）完成，并且清除OPTVERR标志位。如果等待超时，则返回错误。 3. 计算需要擦除的Flash扇区数量，并且检查是否有扇区需要擦除。如果扇区数量为0，则直接返回错误。 4. 循环执行Flash扇区擦除操作，直到所有需要擦除的扇区都被擦除。具体的操作包括： - 将需要擦除的扇区信息填入FLASH_EraseInitTypeDef结构体中，并且调用HAL_FLASHEx_Erase_IT函数执行擦除操作。 - 等待Flash擦除操作完成，并且检查是否有错误发生。如果发生了错误，则保存错误信息，但是继续执行擦除操作直到所有需要擦除的扇区都被擦除。 - 将擦除完成的扇区数量减1，继续执行下一个扇区的擦除操作。 5. 返回擦除操作的结果。如果有错误发生，则返回错误代码；否则，返回HAL_OK表示操作成功。 需要注意的是，该函数执行期间会禁止中断，并且解锁Flash，并且在函数执行完毕之后会恢复中断，并且重新锁定Flash。因此，在调用该函数之前，需要确保中断不会影响到Flash的操作，并且需要适当地设置Flash的保护等级以避免意外修改Flash。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

常驻客栈

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值