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

本文详细介绍了STM32HAL库中I2C通用驱动的所有函数,包括初始化、通信、中断、DMA传输、回调机制以及状态、模式和错误处理,为开发者提供了全面的参考。
摘要由CSDN通过智能技术生成

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.34 HAL_I2C_MasterRxCpltCallback

函数名HAL_I2C_MasterRxCpltCallback
函数原形void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 主机接收完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.35 HAL_I2C_SlaveTxCpltCallback

函数名HAL_I2C_SlaveTxCpltCallback
函数原形void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 从机发送完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.36 HAL_I2C_SlaveRxCpltCallback

函数名HAL_I2C_SlaveRxCpltCallback
函数原形void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 从机接收完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.37 HAL_I2C_AddrCallback

函数名HAL_I2C_AddrCallback
函数原形void HAL_I2C_AddrCallback(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode)
功能描述I2C 地址匹配回调函数
输入参数 1hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输入参数 2TransferDirection:传输方向,可以是 I2C_DIRECTION_TRANSMIT 或 I2C_DIRECTION_RECEIVE
输入参数 3AddrMatchCode:匹配的地址码
输出参数
返回值
先决条件
被调用函数

1.38 HAL_I2C_ListenCpltCallback

函数名HAL_I2C_ListenCpltCallback
函数原形void HAL_I2C_ListenCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 监听完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.39 HAL_I2C_MemTxCpltCallback

函数名HAL_I2C_MemTxCpltCallback
函数原形void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 存储器发送完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.40 HAL_I2C_MemRxCpltCallback

函数名HAL_I2C_MemRxCpltCallback
函数原形void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 存储器接收完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.41 HAL_I2C_ErrorCallback

函数名HAL_I2C_ErrorCallback
函数原形void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2

c) |
| 功能描述 | I2C 错误回调函数 |
| 输入参数 | hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体 |
| 输出参数 | 无 |
| 返回值 | 无 |
| 先决条件 | 无 |
| 被调用函数 | 无 |


1.42 HAL_I2C_AbortCpltCallback

函数名HAL_I2C_AbortCpltCallback
函数原形void HAL_I2C_AbortCpltCallback(I2C_HandleTypeDef *hi2c)
功能描述I2C 终止完成回调函数
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.43 HAL_I2C_GetState

函数名HAL_I2C_GetState
函数原形HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c)
功能描述获取 I2C 状态
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值HAL_I2C_StateTypeDef:I2C 状态
先决条件
被调用函数

1.44 HAL_I2C_GetMode

函数名HAL_I2C_GetMode
函数原形HAL_I2C_ModeTypeDef HAL_I2C_GetMode(I2C_HandleTypeDef *hi2c)
功能描述获取 I2C 模式
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值HAL_I2C_ModeTypeDef:I2C 模式
先决条件
被调用函数

1.45 HAL_I2C_GetError

函数名HAL_I2C_GetError
函数原形HAL_I2C_ErrorTypeDef HAL_I2C_GetError(I2C_HandleTypeDef *hi2c)
功能描述获取 I2C 错误
输入参数hi2c:I2C 句柄,指向一个 I2C_HandleTypeDef 结构体
输出参数
返回值HAL_I2C_ErrorTypeDef:I2C 错误类型
先决条件
被调用函数

该文档修改记录:

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

总结

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

  • 23
    点赞
  • 15
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
根据行列式的性质,行列式的某一行(列)乘以一个数然后加到另一行(列)上,行列式的值不变。因此,我们可以对第二个行列式进行变形,将第一行乘以3然后加到第二行上: \begin{vmatrix} 3a_{21}-a_{11} & 3a_{22}-a_{12} & 3a_{23}-a_{13} \\ a_{11} & a_{12} & a_{13} \\ a_{31} & a_{32} & a_{33} \end{vmatrix} = \begin{vmatrix} 3a_{21} & 3a_{22} & 3a_{23} \\ a_{11} & a_{12} & a_{13} \\ a_{31} & a_{32} & a_{33} \end{vmatrix} - \begin{vmatrix} a_{11} & a_{12} & a_{13} \\ a_{11} & a_{12} & a_{13} \\ a_{31} & a_{32} & a_{33} \end{vmatrix} 由于第二个行列式的第一行和第二行相等,因此它的值为0。因此,我们只需要计算第一个行列式: \begin{vmatrix} 3a_{21} & 3a_{22} & 3a_{23} \\ a_{11} & a_{12} & a_{13} \\ a_{31} & a_{32} & a_{33} \end{vmatrix} 将第一行除以3,得到: \begin{vmatrix} a_{21} & a_{22} & a_{23} \\ a_{11}/3 & a_{12}/3 & a_{13}/3 \\ a_{31} & a_{32} & a_{33} \end{vmatrix} 将第二行乘以3,得到: \begin{vmatrix} a_{21} & a_{22} & a_{23} \\ a_{11} & a_{12} & a_{13} \\ 3a_{31} & 3a_{32} & 3a_{33} \end{vmatrix} 由于行列式的某一行(列)乘以一个数,行列式的值也会相应地乘以这个数,因此: \begin{vmatrix} a_{21} & a_{22} & a_{23} \\ a_{11}/3 & a_{12}/3 & a_{13}/3 \\ a_{31} & a_{32} & a_{33} \end{vmatrix} = \frac{1}{3}\begin{vmatrix} a_{21} & a_{22} & a_{23} \\ a_{11} & a_{12} & a_{13} \\ a_{31} & a_{32} & a_{33} \end{vmatrix} = \frac{1}{3}(2) = \frac{2}{3} \begin{vmatrix} a_{21} & a_{22} & a_{23} \\ a_{11} & a_{12} & a_{13} \\ 3a_{31} & 3a_{32} & 3a_{33} \end{vmatrix} = 3\begin{vmatrix} a_{21} & a_{22} & a_{23} \\ a_{11} & a_{12} & a_{13} \\ a_{31} & a_{32} & a_{33} \end{vmatrix} = 3(2) = 6 因此,原行列式的值为: \frac{2}{3} - 6 = -\frac{16}{3}
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

打赏作者

常驻客栈

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

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

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

打赏作者

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

抵扣说明:

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

余额充值