A21 STM32_HAL库函数 之 I2c通用驱动程序 -- B -- 所有函数的介绍及使用

最新推荐文章于 2024-07-25 10:46:39 发布
最新推荐文章于 2024-07-25 10:46:39 发布
阅读量1.1k 收藏 11
点赞数 17
分类专栏： 介绍STM32标准库及HAL库函数说明及函数的使用方法 文章标签： stm32 单片机 嵌入式硬件 函数说明 HAL库 常驻客栈 I2C
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_50808730/article/details/137421284
版权
本文详细介绍了STM32HAL库中I2C接口的各种通用驱动函数，包括初始化、通信、中断和DMA传输，以及相应的中断处理和错误回调机制。
摘要由CSDN通过智能技术生成

A21 STM32_HAL库函数 之 I2c通用驱动程序 -- B -- 所有函数的介绍及使用

1 该驱动函数预览

序号函数名描述
1HAL_I2C_Init()初始化I2C总线。
2HAL_I2C_DeInit()反初始化I2C总线。
3HAL_I2C_MspInit()初始化MCU外设相关的I2C引脚或资源。
4HAL_I2C_MspDeInit()反初始化MCU外设相关的I2C引脚或资源。
5HAL_I2C_Master_Transmit()主机发送数据到I2C设备。
6HAL_I2C_Master_Receive()主机从I2C设备接收数据。
7HAL_I2C_Slave_Transmit()从I2C设备发送数据到主机。
8HAL_I2C_Slave_Receive()从I2C设备接收主机发送的数据。
9HAL_I2C_Master_Transmit_IT()使用中断发送数据到I2C设备。
10HAL_I2C_Master_Receive_IT()使用中断从I2C设备接收数据。
11HAL_I2C_Master_Sequential_Transmit_IT()使用中断连续发送数据到I2C设备。
12HAL_I2C_Master_Sequential_Receive_IT()使用中断连续从I2C设备接收数据。
13HAL_I2C_Slave_Transmit_IT()使用中断从I2C设备发送数据到主机。
14HAL_I2C_Slave_Receive_IT()使用中断从I2C设备接收主机发送的数据。
15HAL_I2C_Slave_Sequential_Transmit_IT()使用中断连续从I2C设备发送数据到主机。
16HAL_I2C_Slave_Sequential_Receive_IT()使用中断连续从I2C设备接收主机发送的数据。
17HAL_I2C_EnableListen_IT()启用I2C设备的监听模式，并使用中断处理监听事件。
18HAL_I2C_DisableListen_IT()禁用I2C设备的监听模式。
19HAL_I2C_Master_Transmit_DMA()使用DMA发送数据到I2C设备。
20HAL_I2C_Master_Receive_DMA()使用DMA从I2C设备接收数据。
21HAL_I2C_Master_Abort_IT()使用中断终止I2C主机模式下的传输。
22HAL_I2C_Slave_Transmit_DMA()使用DMA从I2C设备发送数据到主机。
23HAL_I2C_Slave_Receive_DMA()使用DMA从I2C设备接收主机发送的数据。
24HAL_I2C_Mem_Write()写入I2C外设的存储器。
25HAL_I2C_Mem_Read()从I2C外设的存储器读取数据。
26HAL_I2C_Mem_Write_IT()使用中断写入I2C外设的存储器。
27HAL_I2C_Mem_Read_IT()使用中断从I2C外设的存储器读取数据。
28HAL_I2C_Mem_Write_DMA()使用DMA写入I2C外设的存储器。
29HAL_I2C_Mem_Read_DMA()使用DMA从I2C外设的存储器读取数据。
30HAL_I2C_IsDeviceReady()检测I2C设备是否准备好。
31HAL_I2C_EV_IRQHandler()I2C事件中断处理程序。
32HAL_I2C_ER_IRQHandler()I2C错误中断处理程序。
33HAL_I2C_MasterT

xCpltCallback() | I2C主机发送完成回调函数。 |
| 34 | HAL_I2C_MasterRxCpltCallback() | I2C主机接收完成回调函数。 |
| 35 | HAL_I2C_SlaveTxCpltCallback() | I2C从机发送完成回调函数。 |
| 36 | HAL_I2C_SlaveRxCpltCallback() | I2C从机接收完成回调函数。 |
| 37 | HAL_I2C_AddrCallback() | I2C地址匹配回调函数。 |
| 38 | HAL_I2C_ListenCpltCallback() | I2C监听模式完成回调函数。 |
| 39 | HAL_I2C_MemTxCpltCallback() | I2C存储器发送完成回调函数。 |
| 40 | HAL_I2C_MemRxCpltCallback() | I2C存储器接收完成回调函数。 |
| 41 | HAL_I2C_ErrorCallback() | I2C错误回调函数。 |
| 42 | HAL_I2C_AbortCpltCallback() | I2C终止完成回调函数。 |
| 43 | HAL_I2C_GetState() | 获取I2C总线的状态。 |
| 44 | HAL_I2C_GetMode() | 获取I2C总线的模式。 |
| 45 | HAL_I2C_GetError() | 获取I2C总线的错误状态。 |

以下是使用模板：

#include "stm32f4xx_hal.h"

int main(void) {
    // HAL初始化
    HAL_Init();
    
    // 初始化MCU外设相关的I2C引脚或资源
    HAL_I2C_MspInit();
    
    // 初始化I2C总线
    HAL_I2C_Init();
    
    // 进行其他操作...
    
    // 主机发送数据到I2C设备
    HAL_I2C_Master_Transmit();
    
    // 主机从I2C设备接收数据
    HAL_I2C_Master_Receive();
    
    // 从I2C设备发送数据到主机
    HAL_I2C_Slave_Transmit();
    
    // 从I2C设备接收主机发送的数据
    HAL_I2C_Slave_Receive();
    
    // 使用中断发送数据到I2C设备
    HAL_I2C_Master_Transmit_IT();
    
    // 使用中断从I2C设备接收数据
    HAL_I2C_Master_Receive_IT();
    
    // 使用DMA发送数据到I2C设备
    HAL_I2C_Master_Transmit_DMA();
    
    // 使用DMA从I2C设备接收数据
    HAL_I2C_Master_Receive_DMA();
    
    // I2C事件中断处理程序
    HAL_I2C_EV_IRQHandler();
    
    // I2C错误中断处理程序
    HAL_I2C_ER_IRQHandler();
    
    // 获取I2C总线的状态
    uint32_t i2cState = HAL_I2C_GetState();
    
    // 获取I2C总线的模式
    uint32_t i2cMode = HAL_I2C_GetMode();
    
    // 获取I2C总线的错误状态
    uint32_t i2cError = HAL_I2C_GetError();
    
    // 反初始化I2C总线
    HAL_I2C_DeInit();
    
    // 反初始化MCU外设相关的I2C引脚或资源
    HAL_I2C_MspDeInit();
    
    return 0;
}

1.12 HAL_I2C_Master_Sequential_Receive_IT

函数名HAL_I2C_Master_Sequential_Receive_IT
函数原形HAL_StatusTypeDef HAL_I2C_Master_Sequential_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
功能描述通过中断以顺序传输方式从 I2C 从机接收数据
输入参数 1hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输入参数 2DevAddress：从机地址
输入参数 3pData：指向存储接收数据的缓冲区
输入参数 4Size：要接收的数据长度
输入参数 5XferOptions：传输选项
输出参数无
返回值HAL_StatusTypeDef：接收状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.13 HAL_I2C_Slave_Transmit_IT

函数名HAL_I2C_Slave_Transmit_IT
函数原形HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
功能描述通过中断发送数据到 I2C 主机

输入参数 1 | hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体 |
| 输入参数 2 | pData：指向要发送的数据缓冲区 |
| 输入参数 3 | Size：要发送的数据长度 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：传输状态，可以是 HAL_OK 或 HAL_ERROR |
| 先决条件 | 无 |
| 被调用函数 | 无 |

1.14 HAL_I2C_Slave_Receive_IT

函数名HAL_I2C_Slave_Receive_IT
函数原形HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
功能描述通过中断从 I2C 主机接收数据
输入参数 1hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输入参数 2pData：指向存储接收数据的缓冲区
输入参数 3Size：要接收的数据长度
输出参数无
返回值HAL_StatusTypeDef：接收状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.15 HAL_I2C_Slave_Sequential_Transmit_IT

函数名HAL_I2C_Slave_Sequential_Transmit_IT
函数原形HAL_StatusTypeDef HAL_I2C_Slave_Sequential_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
功能描述通过中断以顺序传输方式发送数据到 I2C 主机
输入参数 1hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输入参数 2pData：指向要发送的数据缓冲区
输入参数 3Size：要发送的数据长度
输入参数 4XferOptions：传输选项
输出参数无
返回值HAL_StatusTypeDef：传输状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.16 HAL_I2C_Slave_Sequential_Receive_IT

函数名HAL_I2C_Slave_Sequential_Receive_IT
函数原形HAL_StatusTypeDef HAL_I2C_Slave_Sequential_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions)
功能描述通过中断以顺序传输方式从 I2C 主机接收数据
输入参数 1hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输入参数 2pData：指向存储接收数据的缓冲区
输入参数 3Size：要接收的数据长度
输入参数 4XferOptions：传输选项
输出参数无
返回值HAL_StatusTypeDef：接收状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.17 HAL_I2C_EnableListen_IT

函数名HAL_I2C_EnableListen_IT
函数原形HAL_StatusTypeDef HAL_I2C_EnableListen_IT(I2C_HandleTypeDef *hi2c)
功能描述使能 I2C 的监听模式
输入参数hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输出参数无
返回值HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.18 HAL_I2C_DisableListen_IT

函数名HAL_I2C_DisableListen_IT
函数原形HAL_StatusTypeDef HAL_I2C_DisableListen_IT(I2C_HandleTypeDef *hi2c)
功能描述禁用 I2C 的监听模式
输入参数hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输出参数无
返回值HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.19 HAL_I2C_Master_Transmit_DMA

函数名HAL_I2C_Master_Transmit_DMA
函数原形HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size)
功能描述通过 DMA 发送数据到 I2C 从机
输入参数 1hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输入参数 2DevAddress：从机地址
输入参数 3pData：指向要发送的数据缓冲区
输入参数 4Size：要发送的数据长度
输出参数无
返回值HAL_StatusTypeDef：传输状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.20 HAL_I2C_Master_Receive_DMA

函数名HAL_I2C_Master_Receive_DMA
函数原形HAL_Status

TypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size) |
| 功能描述 | 通过 DMA 从 I2C 从机接收数据 |
| 输入参数 1 | hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体 |
| 输入参数 2 | DevAddress：从机地址 |
| 输入参数 3 | pData：指向存储接收数据的缓冲区 |
| 输入参数 4 | Size：要接收的数据长度 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：接收状态，可以是 HAL_OK 或 HAL_ERROR |
| 先决条件 | 无 |
| 被调用函数 | 无 |

1.21 HAL_I2C_Master_Abort_IT

函数名HAL_I2C_Master_Abort_IT
函数原形HAL_StatusTypeDef HAL_I2C_Master_Abort_IT(I2C_HandleTypeDef *hi2c)
功能描述通过中断终止 I2C 主机的传输
输入参数hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输出参数无
返回值HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

1.22 HAL_I2C_Slave_Transmit_DMA

函数名HAL_I2C_Slave_Transmit_DMA
函数原形HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size)
功能描述通过 DMA 发送数据到 I2C 主机
输入参数 1hi2c：I2C 句柄，指向一个 I2C_HandleTypeDef 结构体
输入参数 2pData：指向要发送的数据缓冲区
输入参数 3Size：要发送的数据长度
输出参数无
返回值HAL_StatusTypeDef：传输状态，可以是 HAL_OK 或 HAL_ERROR
先决条件无
被调用函数无

该文档修改记录：

修改时间修改说明
2024年4月30日第一次发布，介绍了该博客驱动所有函数的介绍及使用

总结

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

常驻客栈
关注
  • 17
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
写STM32 的I2c库函数
weixin_39770778的博客
12-27 7264
I2c协议：I2c是一种双向串行通讯标准，常用于嵌入式系统中。利用I2c总线可以利用有限的I/O接口来扩展多功能的外围设备。主要由SCL(时钟线)和SDA(数据线组成)
STM32F4 HAL库函数手册(英文版)
12-23
**外设驱动**：详述了包括ADC（模拟数字转换器）、DAC（数字模拟转换器）、SPI（串行外围接口）、I2C（集成电路间通信）、UART（通用异步收发传输器）、CAN（控制器局域网络）、Timers（定时器）等在内的多种外设的...
STM32_HAL_I2C_串行接口
qq_59527512的博客
06-04 1002
I2C（Inter-Integrated Circuit）是一种由飞利浦公司（现恩智浦半导体）开发的串行通信协议，用于连接低速外围设备。I2C总线只需要两根线（SDA：串行数据线，SCL：串行时钟线）就可以实现多个设备之间的数据交换。在任何时刻，只有一个主设备控制总线。（不能同时存在多个主设备）起始条件。
STM32 HAL库 硬件IIC 从机一些问题整理
最新发布
huaxiu5的博客
07-25 469
二、如果用地址回调函数HAL_I2C_AddrCallback()，这个回调函数触发后，会关闭中断，需要再次开启中断，才能继续监听。需要特别注意开启监听中断的位置，有人在这个回调函数里直接开启，我测试了一下，不行，开启失败；还有人，把开启监听放在主循环里，一直不断轮询去开启，大力出奇迹，这样确实可以用，但是经过测试发现有时候会丢失，不能触发回调函数。，在HAL_I2C_ListenCpltCallback()函数中开启，才是最优解。
STM32之I2C总线知识和HAL库函数
sealsystem的博客
02-14 3127
I2C总线知识和STM32 HAL库函数
STM32 HAL库函数学习 I2C篇
s2014201506的博客
06-18 1万+
本篇内容讲述STM32的硬件IIC功能。
STM32 HAL库 STM32CubeMX -- I2C（IIC）
Dir_x的博客
02-15 7374
STM32 HAL库 STM32Cube MX配置 IIC I2C 协议简介 HAL库函数介绍
STM32学习之I2C
热门推荐
孔祥锐
10-20 3万+
stm32 i2c通信 [操作寄存器+库函数] 作者：Changing发表时间：07-12 22:01分类：电子相关No Comments I2C总线是由NXP（原PHILIPS）公司设计，有十分简洁的物理层定义,其特性如下： 只要求两条总线线路：一条串行数据线SDA，一条串行时钟线SCL；每个连接到总线的器件都可以通过唯一的地址和一直存在的简单的主机/从机关系软件设定地址，
STM32.zip_STM32 库函数_stm32_stm32-_函数 STM32_库函数 stm32
09-14
STM32的库函数覆盖了众多功能，包括GPIO（通用输入输出）、TIM（定时器）、ADC（模数转换器）、SPI（串行外围接口）、UART（通用异步收发传输器）、I2C（集成电路间通信）、DMA（直接存储器访问）、CAN（控制器局域...
STM32F4开发指南-库函数版本_V1_STM32F4开发指南_STM32F4开发手册_stmf4库函数_stm32f4库函数
09-10
在实际开发中，开发者需要了解STM32F4的外设接口，如GPIO（通用输入输出）、ADC（模拟数字转换器）、DMA（直接内存访问）、SPI/I2C（串行通信协议）、TIM（定时器）、USART（通用同步/异步收发传输器）等。...
STM32F1HAL库函数手册.zip
08-27
STM32F1HAL库函数手册是一份详细的技术文档，主要针对STMicroelectronics的STM32F1系列微控制器，提供了高效应用层（HAL）库的全面指南。这个库是为简化开发者的工作而设计的，它提供了一套与具体硬件接口无关的高级...
基于STM32，hal库，使用CubeMX进行开发的硬件I2C代码。SSD1306屏幕和SHT20传感器
09-16
STM32的硬件I2C不好用，很多人在开发I2C的过程中，使用的是软件I2C进行调试。其实这么多年的改进，以及ST公司库函数的不断升级，现在可以比较方便的调用I2C，不过CubeMX的函数生成存在小问题，导致硬件i2c使用依然不方便。 本资源则是调试好的代码。大家可以参考其中的代码，并且祝大家能够顺利使用硬件i2c
普通IO口模拟I2C接口
09-27
普通IO口模拟I2C驱动，可支持单字节读写，应用于NRF52832上，可对IO口进行更改，按代码注释修改
基于 STM32单片机（库函数版本）+ ATK-2MD4850步进电机驱动器实验软件源码.zip
06-16
在本实验中，我们主要探讨的是如何利用STM32单片机的库函数版本来控制ATK-2MD4850步进电机驱动器，从而实现对步进电机的精确控制。STM32单片机是意法半导体（STMicroelectronics）推出的基于ARM Cortex-M内核的微...
A22 STM32_HAL库函数 之 I2c通用驱动程序 -- C -- 所有函数的介绍及使用
常驻客栈的博客--嵌入式EtherCAT
04-16 1347
以上就是该博客驱动所有函数的介绍及使用的内容。有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。创作不容，如果文档对您有帮助，记得给个赞。
hal库源码分析（i2c篇）
thelastyouy的博客
04-17 1212
在学习i2c，uart，spi这样的通信协议的时候，不知道小伙伴们有没有这样的感受，明明硬件协议部分可以理解，hal库给的函数也会调用，为什么总有些无法触碰到底层的感觉。原因就是hal库做的太好了，他把通过寄存器实现通信逻辑的部分全都封装好了。而要真正学懂通信一个通信协议的话，最好的实现方法就是看hal库的源码，看到底是怎么通过配置寄存器来实现完美的通信协议的。废话少说，直接来看i2c。
STM32F1HAL库的I2C应用注意事项
weixin_30575309的博客
11-12 911
因为要用到I2C和流量传感器通信，也是第一次使用，直接使用stm32F1 HAL库来实现初始化，在STM32F10E评估板上直接和传感器通信，一次性成功通过。 当把调试好的流量计驱动程序往实际的板子上应用的时候发现会死等在某一处如下： while(__HAL_I2C_GET_FLAG(hi2c, Flag) != RESET) { /* Check for the ...
I2C协议介绍以及HAL库实现I2C对SHT30温湿度采样
m0_51429770的博客
11-06 3445
I2C总线是Philips公司在八十年代初推出的一种串行、半双工的总线，主要用于近距离、低速的芯片之间的通信。12C Bus(IIC, Inter-Integrated Circuit Bus)是由一根数据线SDA用于收发数据，一根时钟线SCL用于通信双方时钟的同步，利用上拉电阻将它们拉成高电平(表示总线空闲)，其典型的电压准位为+3.3V或+5V，具有电路简单、连接线少、控制简单、通信速率高等优点。
HAL_I2C_SlaveTxCpltCallback
01-31
HAL_I2C_SlaveTxCpltCallback是一个I2C从设备发送完成的回调函数。在这个回调函数中，你可以执行一些其他操作。在这个特定的例子中，回调函数中还调用了HAL_I2C_Slave_Receive_IT函数，用于启动I2C从设备的接收操作。 以下是HAL_I2C_SlaveTxCpltCallback的代码示例： ```c void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *I2cHandle) { //发送完成回调函数 //一些其他操作 HAL_I2C_Slave_Receive_IT(&I2cHandle, i2c_slave_recv, I2C_REC_BYTES); //一些其他操作 } ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

常驻客栈

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

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

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

打赏作者

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

抵扣说明：

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

余额充值