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

最新推荐文章于 2025-06-08 20:30:51 发布
最新推荐文章于 2025-06-08 20:30:51 发布
阅读量1.7k 收藏 34
点赞数 28
CC 4.0 BY-SA版权
分类专栏： 介绍STM32标准库及HAL库函数说明及函数的使用方法 文章标签： stm32 嵌入式硬件 单片机 I2C 函数介绍 常驻客栈 HAL库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_50808730/article/details/137421938
本文详细介绍了STM32HAL库中I2S接口的各种通用驱动函数，包括初始化、反初始化、数据传输、中断和DMA操作，以及相应的回调函数和状态管理。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

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

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日第一次发布，介绍了该博客驱动所有函数的介绍及使用

总结

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

STM32F103标准库开发---SPI实验---W25Qxx系列外部Flash芯片
MQ0522的博客
08-09 3024
W25Qxx 系列 Flash 存储器可以为用户提供存储解决方案。擦写周期多达10W次，可将数据保存达20年之久，支持2.7~3.6V的电压，支持标准的SPI，还支持双输出/四输出的SPI，最大SPI时钟可达80Mhz。W25Qxx 系列 Flash 存储器是为系统提供一个最小空间、最少引脚，最低功耗的串行Flash存储器，比普通的串行Flash存储器更灵活，性能更优越。功耗低，正常工作状态下电流消耗0.5mA，掉电状态下电流消耗1uA。.....................
【STM32开发之寄存器版】（十五）-数字音频接口I2S基础知识
Daemon.Chen的博客
11-04 2302
I2S是一种3引脚的同步串行接口通讯协议。它支持四种音频标准，包括飞利浦I2S标准MSB和LSB对齐标准以及PCM标准。它在半双工通讯中，可以工作在主和从2种模式下。当它作为主设备时，通过接口向外部的从设备提供时钟信号。I2S协议主要用于音频处理器、音频解码器、蓝牙音频设备、多声道音频系统等领域。
STM32F407 HAL库 I2S DMA 使用详解及优缺点分析
04-25 948
STM32F407 的 HAL 库 I2S 模块适合快速开发音频应用，但在高性能或资源受限场景下需权衡 HAL 的便利性与效率。建议在复杂项目中使用 HAL 完成原型设计，再逐步优化关键部分（如 DMA 中断服务）以提升性能。
STM32实现i2s通信
05-09
stm32作为cpu 控制i2s 对收到的音频信息进行模拟和数字的转换。
音视频——I2S 协议详解
最新发布
君鼎的博客
06-08 1440
音视频协议——I2S
【STM32 HAL库】全双工I2S+双缓冲DMA的使用
目标：MVP
07-17 4045
使用CubeIDE实现I2S发数据。
STM32第二十课（I2S，HAL）
Huskar_Liu的博客
12-22 6744
WAV 即 WAVE 文件， 标准格式化的 WAV 文件和 CD 格式一样，也是 44.1K 的取样频率， 16 位量化数字，因此在声音文件质量和 CD 相差无几！ WAV 一般采用线性 PCM（脉冲编码调制）编码， WAV 是由若干个 Chunk 组成的。 RIFF WAVE Chunk、Format Chunk、 Fact Chunk(可选)和 Data Chunk。 每个 Chunk 由块标识符、数据大小和数据三部分组成， 块标识符由 4 个 ASCII 码构成，数据大小则标出紧跟其后的数据的长度（单
stm32入门教程—i2s
09-28 2342
在实际应用中，你可能还需要考虑音频数据的存储和播放，比如使用SD卡存储音频文件，并通过I2S接口播放。在实际应用中，你可能还需要考虑音频数据的存储和播放，比如使用SD卡存储音频文件，并通过I2S接口播放。6. 初始化结构体：使用I2S_InitTypeDef结构体配置I2S参数，包括模式、标准、数据格式、主时钟输出使能、采样频率和空闲电平选择。1. I2S引脚配置：首先需要配置STM32的I2S引脚，包括SCK（时钟线）、WS（字选择线）和SD（数据线）。// 初始化I2S和DMA。
STM32个人笔记-I2S
weixin_47077788的博客
03-27 9000
现实存在的声音是模拟量，这对声音保存和长距离传输造成很大的困难，一般的做法是把模拟量转成对应的数字量保存，在需要还原声音的地方再把数字量的转成模拟量输出。模拟量转换成数字量，3个过程：采样、量化和编码。蓝线的距离就是采样信号的周期，即对应一个采样频率（Fs）。Fs越高，采样信号越符合曲线，但采样数据量也会越大，一般使用44.1KHzFs即可得高保真的声音。蓝线长度就是源声音的量化值。量化位数表示每个采样点用多少位数代表数据范围，常用的有16bit、24bit和32bit等。
CY8C24123A-24SXI的技术参数
12-13
产品型号:CY8C24123A-24SXI工作电压(V):2.4~5.25速度(MHz):24Flash(字节):4KRAM(字节):256SMP:无数字PSoC模块:2-Basic 2-Comms模拟PSoC模块:6:2-CT 4-SCI/O:6封装/温度(℃):8(150 Mil)SOIC/-40~85价格/1片(套):暂无...
VMware-VMvisor-Installer-7.0.0-15843807.x86_64-DellEMC_Customized-A00.iso
05-24
戴尔oem版vmware vsphere esxi7.0，最新 VMware-VMvisor-Installer-7.0.0-15843807.x86_64-DellEMC_Customized-A00.iso 需要的下载
PyPI 官网下载 | invenio_communities-1.0.0a24-py2.py3-none-any.whl
02-09
**PyPI 官网下载 | invenio_communities-1.0.0a24-py2.py3-none-any.whl** 在Python的世界里，PyPI（Python Package Index）是官方的第三方Python软件包仓库，它为全球的Python开发者提供了一个集中地来发布、查找...
AR9331 I2S驱动程序源码
02-27
AR9331 I2S Linux 驱动程序源码
STM32关于I2S音频开发资料.zip
07-21
里面包含六个文件 STM32 微控制器上的 PDM 音频软件解码.pdf STM32L4 sigma delta数字滤波器模块(DFSDM)介绍.pdf STM32L4串行音频接口模块(SAI)介绍.pdf 基于STM32_I2S的音频应用开发介绍.pdf 利用DFSDM开发PDM麦克风应用介绍.pdf 如何将PDM数字麦克风连接到STM32单片机.pdf
VMware-VMvisor-Installer-7.0.0.update01-16850804.x86_64-DellEMC_Customized-A00
10-16
ESXi 7.0 U1安装CD的DellEMC自定义映像 ESXi 7.0 U1内部版本号：16850804 戴尔版本：A00 戴尔发布日期：2020年10...-与以前的版本相比，驱动程序发生了变化：yes -基本软件仓库：VMware-ESXi-7.0U1-16850804-depot.zip
关于STM32的I2S通信飞利浦协议和MSB协议
叶大鹏的专栏
08-10 8262
关于STM32的I2S通信飞利浦协议和MSB协议 最近公司一个项目要用到CODEC芯片来做语音的采集和输出，驱动是用的STM32F405的I2S接口。之前没有深入的了解过I2S的知识，只是大概的知道它是一种用于传输音频数据的总线。本来以为没什么难的，实际用下来其实也没感觉有有什么特别的。但是还是在使用的过程中把自己坑了一把。 CODEC芯片型号是MAX9867，主要的应用场合是手机和助听器...
STM32CubeMX+MDK通过I2S接口进行音频输入输出（全双工读写一个DMA回调）
逍遥游的博客
04-07 5382
目前有一个关于通过STM32F411CEUx的I2S总线接口控制SSS1700芯片进行音频输入输出的研究。SSS1700 是具有片上振荡器的 3S 高度集成的USB音频控制器芯片。SSS1700 功能支持96 KHz 24 位采样率，带外部音频编解码器（24 位/96KHz I2S 输入和输出）并具有内置立体声16/24位ADC、立体声16/24位DAC、耳机驱动、五段硬件均衡器、音频 PLL、USB 时钟振荡器和 USB FS 控制器加上 PHY。
STM32 基础系列教程 16 - I2S(模拟)
热门推荐
张十三的博客
04-15 2万+
前言 学习stm32 I2S接口使用，学会用I2S接口收发数据,学习I2S总线相关知识， I2S(Inter—IC Sound)总线, 又称 集成电路内置音频总线，是飞利浦公司为数字音频设备之间的音频数据传输而制定的一种总线标准，该总线专门用于音频设备之间的数据传输，广泛应用于各种多媒体系统。它采用了沿独立的导线传输时钟与数据信号的设计，通过将数据和时钟信号分离，避免了因时差诱发的失真，...
STM32第二十二课（I2S，HAL，cubemx）
Huskar_Liu的博客
12-24 3890
本文使用cubemx生成尽可能多的代码。
hal库如何配置i2s时钟频率
02-12
### 使用STM32 HAL库配置I2S时钟频率 #### 配置I2S时钟源 对于STM32系列微控制器，I2S外设依赖于特定的时钟源来工作。通常情况下，这些时钟源可以是PLL（锁相环）、HSI（内部高速RC振荡器）或HSE（外部高速晶体）。为了确保I2S能够正常运行并达到所需的采样率，必须先正确配置其时钟源。 在大多数应用中，推荐使用PLL作为I2S的时钟输入，因为这能提供更稳定和精确的时间基准[^1]。具体来说，在基于STM32F407这样的设备上，可以通过调整PLL参数使系统时钟(SYSCLK)达到最大值168 MHz，并进一步通过分频得到适合I2S使用的频率[^3]。 #### 初始化I2S模块与时钟设置 要初始化I2S接口及其关联的SPI硬件资源，需调用`HAL_I2S_Init()`函数前完成必要的RCC(Restart and Clock Control)寄存器编程以设定合适的时钟路径与频率分配给I2S外设。下面是一个简单的例子展示如何利用HAL库来进行基本的I2S初始化： ```c // 定义 I2S handle 结构体实例 I2S_HandleTypeDef hi2s; void MX_I2S3_Init(void) { // 设置 I2S 的模式和其他属性... // 这里省略了其他成员变量的具体赋值 /* 初始化 I2S */ if (HAL_I2S_Init(&hi2s) != HAL_OK) { Error_Handler(); } } ``` 需要注意的是，在实际项目开发过程中，应该根据具体的芯片型号查阅官方数据手册以及参考手册中的详细说明来决定最适合的应用场景下的最佳实践方法[^2]。 #### 调整I2S时钟频率 当涉及到改变I2S的工作速率即采样频率时，则需要修改相应的定时器预分频系数或者更改PLL输出到APB/APBX总线上用于驱动I2S部分的比例因子。例如，如果希望获得48kHz的标准音频采样率，就需要计算出恰当的分频数值使得最终产生的位周期符合这一标准。 此外，还可以借助CubeMX工具自动生成初始代码框架，它可以帮助开发者快速搭建起包含所需外设在内的工程模板文件夹结构，从而简化手动编写复杂配置的过程。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

常驻客栈

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

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

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

打赏作者

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

抵扣说明：

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

余额充值