A24 STM32_HAL库函数 之 I2s通用驱动 -- A-- 所有函数的介绍及使用

2024-04-19 02:36

本文主要是介绍A24 STM32_HAL库函数 之 I2s通用驱动 -- A-- 所有函数的介绍及使用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

A24 STM32_HAL库函数 之 I2s通用驱动 -- A-- 所有函数的介绍及使用

  • 1 该驱动函数预览
    • 1.1 HAL_I2S_Init
    • 1.2 HAL_I2S_DeInit
    • 1.3 HAL_I2S_MspInit
    • 1.4 HAL_I2S_MspDeInit
    • 1.5 HAL_I2S_Transmit
    • 1.6 HAL_I2S_Receive
    • 1.7 HAL_I2S_Transmit_IT
    • 1.8 HAL_I2S_Receive_IT
    • 1.9 HAL_I2S_Transmit_DMA
    • 1.10 HAL_I2S_Receive_DMA
  • 该文档修改记录:
  • 总结

1 该驱动函数预览

序号函数名描述
1HAL_I2S_Init()初始化I2S接口。
2HAL_I2S_DeInit()反初始化I2S接口。
3HAL_I2S_MspInit()初始化MCU外设相关的I2S引脚或资源。
4HAL_I2S_MspDeInit()反初始化MCU外设相关的I2S引脚或资源。
5HAL_I2S_Transmit()通过I2S接口发送数据。
6HAL_I2S_Receive()通过I2S接口接收数据。
7HAL_I2S_Transmit_IT()使用中断发送数据通过I2S接口。
8HAL_I2S_Receive_IT()使用中断接收数据通过I2S接口。
9HAL_I2S_Transmit_DMA()使用DMA发送数据通过I2S接口。
10HAL_I2S_Receive_DMA()使用DMA接收数据通过I2S接口。
11HAL_I2S_DMAPause()暂停I2S DMA传输。
12HAL_I2S_DMAResume()恢复I2S DMA传输。
13HAL_I2S_DMAStop()停止I2S DMA传输。
14HAL_I2S_IRQHandler()I2S中断处理程序。
15HAL_I2S_TxHalfCpltCallback()I2S发送半完成回调函数。
16HAL_I2S_TxCpltCallback()I2S发送完成回调函数。
17HAL_I2S_RxHalfCpltCallback()I2S接收半完成回调函数。
18HAL_I2S_RxCpltCallback()I2S接收完成回调函数。
19HAL_I2S_ErrorCallback()I2S错误回调函数。
20HAL_I2S_GetState()获取I2S接口的状态。
21HAL_I2S_GetError()获取I2S接口的错误状态。

以下是使用模板:

#include "stm32f4xx_hal.h"int main(void) {// HAL初始化HAL_Init();// 初始化MCU外设相关的I2S引脚或资源HAL_I2S_MspInit();// 初始化I2S接口HAL_I2S_Init();// 进行其他操作...// 通过I2S接口发送数据HAL_I2S_Transmit();// 通过I2S接口接收数据HAL_I2S_Receive();// 使用DMA发送数据通过I2S接口HAL_I2S_Transmit_DMA();// 使用DMA接收数据通过I2S接口HAL_I2S_Receive_DMA();// I2S中断处理程序HAL_I2S_IRQHandler();// 获取I2S接口的状态uint32_t i2sState = HAL_I2S_GetState();// 获取I2S接口的错误状态uint32_t i2sError = HAL_I2S_GetError();// 反初始化I2S接口HAL_I2S_DeInit();// 反初始化MCU外设相关的I2S引脚或资源HAL_I2S_MspDeInit();return 0;
}

1.1 HAL_I2S_Init

函数名HAL_I2S_Init
函数原形HAL_StatusTypeDef HAL_I2S_Init(I2S_HandleTypeDef *hi2s)
功能描述初始化 I2S 外设
输入参数hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.2 HAL_I2S_DeInit

函数名HAL_I2S_DeInit
函数原形HAL_StatusTypeDef HAL_I2S_DeInit(I2S_HandleTypeDef *hi2s)
功能描述反初始化 I2S 外设
输入参数hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.3 HAL_I2S_MspInit

函数名HAL_I2S_MspInit
函数原形void HAL_I2S_MspInit(I2S_HandleTypeDef *hi2s)
功能描述初始化 I2S 外设的 GPIO、时钟和 DMA 配置
输入参数hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.4 HAL_I2S_MspDeInit

函数名HAL_I2S_MspDeInit
函数原形void HAL_I2S_MspDeInit(I2S_HandleTypeDef *hi2s)
功能描述反初始化 I2S 外设的 GPIO、时钟和 DMA 配置
输入参数hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.5 HAL_I2S_Transmit

函数名HAL_I2S_Transmit
函数原形HAL_StatusTypeDef HAL_I2S_Transmit(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size, uint32_t Timeout)
功能描述通过 I2S 外设发送数据
输入参数 1hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输入参数 2pData:指向发送数据的缓冲区
输入参数 3Size:要发送的数据长度
输入参数 4Timeout:超时时间
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.6 HAL_I2S_Receive

函数名HAL_I2S_Receive
函数原形HAL_StatusTypeDef HAL_I2S_Receive(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size, uint32_t Timeout)
功能描述通过 I2S 外设接收数据
输入参数 1hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输入参数 2pData:指向接收数据的缓冲区
输入参数 3Size:要接收的数据长度
输入参数 4Timeout:超时时间
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.7 HAL_I2S_Transmit_IT

函数名HAL_I2S_Transmit_IT
函数原形HAL_StatusTypeDef HAL_I2S_Transmit_IT(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size)
功能描述使用中断方式通过 I2S 外设发送数据
输入参数 1hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输入参数 2pData:指向发送数据的缓冲区
输入参数 3Size:要发送的数据长度
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.8 HAL_I2S_Receive_IT

函数名HAL_I2S_Receive_IT
函数原形HAL_StatusTypeDef HAL_I2S_Receive_IT(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size)
功能描述使用中断方式通过 I2S 外设接收数据
输入参数 1hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输入参数 2pData:指向接收数据的缓冲区
输入参数 3Size:要接收的数据长度
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.9 HAL_I2S_Transmit_DMA

函数名HAL_I2S_Transmit_DMA
函数原形HAL_StatusTypeDef HAL_I2S_Transmit_DMA(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size)
功能描述使用 DMA 方式通过 I2S 外设发送数据
输入参数 1hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输入参数 2pData:指向发送数据的缓冲区
输入参数 3Size:要发送的数据长度
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.10 HAL_I2S_Receive_DMA

函数名HAL_I2S_Receive_DMA
函数原形HAL_StatusTypeDef HAL_I2S_Receive_DMA(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size)
功能描述使用 DMA 方式通过 I2S 外设接收数据
输入参数 1hi2s:I2S 句柄,指向一个 I2S_HandleTypeDef 结构体
输入参数 2pData:指向接收数据的缓冲区
输入参数 3Size:要接收的数据长度
输出参数
返回值HAL_StatusTypeDef:操作状态,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

该文档修改记录:

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

总结

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

这篇关于A24 STM32_HAL库函数 之 I2s通用驱动 -- A-- 所有函数的介绍及使用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/916428

相关文章

gitlab安装及邮箱配置和常用使用方式

《gitlab安装及邮箱配置和常用使用方式》:本文主要介绍gitlab安装及邮箱配置和常用使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1.安装GitLab2.配置GitLab邮件服务3.GitLab的账号注册邮箱验证及其分组4.gitlab分支和标签的

SpringBoot3应用中集成和使用Spring Retry的实践记录

《SpringBoot3应用中集成和使用SpringRetry的实践记录》SpringRetry为SpringBoot3提供重试机制,支持注解和编程式两种方式,可配置重试策略与监听器,适用于临时性故... 目录1. 简介2. 环境准备3. 使用方式3.1 注解方式 基础使用自定义重试策略失败恢复机制注意事项

nginx启动命令和默认配置文件的使用

《nginx启动命令和默认配置文件的使用》:本文主要介绍nginx启动命令和默认配置文件的使用,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录常见命令nginx.conf配置文件location匹配规则图片服务器总结常见命令# 默认配置文件启动./nginx

在Windows上使用qemu安装ubuntu24.04服务器的详细指南

《在Windows上使用qemu安装ubuntu24.04服务器的详细指南》本文介绍了在Windows上使用QEMU安装Ubuntu24.04的全流程:安装QEMU、准备ISO镜像、创建虚拟磁盘、配置... 目录1. 安装QEMU环境2. 准备Ubuntu 24.04镜像3. 启动QEMU安装Ubuntu4

使用Python和OpenCV库实现实时颜色识别系统

《使用Python和OpenCV库实现实时颜色识别系统》:本文主要介绍使用Python和OpenCV库实现的实时颜色识别系统,这个系统能够通过摄像头捕捉视频流,并在视频中指定区域内识别主要颜色(红... 目录一、引言二、系统概述三、代码解析1. 导入库2. 颜色识别函数3. 主程序循环四、HSV色彩空间详解

Windows下C++使用SQLitede的操作过程

《Windows下C++使用SQLitede的操作过程》本文介绍了Windows下C++使用SQLite的安装配置、CppSQLite库封装优势、核心功能(如数据库连接、事务管理)、跨平台支持及性能优... 目录Windows下C++使用SQLite1、安装2、代码示例CppSQLite:C++轻松操作SQ

Python常用命令提示符使用方法详解

《Python常用命令提示符使用方法详解》在学习python的过程中,我们需要用到命令提示符(CMD)进行环境的配置,:本文主要介绍Python常用命令提示符使用方法的相关资料,文中通过代码介绍的... 目录一、python环境基础命令【Windows】1、检查Python是否安装2、 查看Python的安

Python并行处理实战之如何使用ProcessPoolExecutor加速计算

《Python并行处理实战之如何使用ProcessPoolExecutor加速计算》Python提供了多种并行处理的方式,其中concurrent.futures模块的ProcessPoolExecu... 目录简介完整代码示例代码解释1. 导入必要的模块2. 定义处理函数3. 主函数4. 生成数字列表5.

Python中help()和dir()函数的使用

《Python中help()和dir()函数的使用》我们经常需要查看某个对象(如模块、类、函数等)的属性和方法,Python提供了两个内置函数help()和dir(),它们可以帮助我们快速了解代... 目录1. 引言2. help() 函数2.1 作用2.2 使用方法2.3 示例(1) 查看内置函数的帮助(

Linux脚本(shell)的使用方式

《Linux脚本(shell)的使用方式》:本文主要介绍Linux脚本(shell)的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录概述语法详解数学运算表达式Shell变量变量分类环境变量Shell内部变量自定义变量:定义、赋值自定义变量:引用、修改、删