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

最新推荐文章于 2025-04-25 09:06:47 发布
最新推荐文章于 2025-04-25 09:06:47 发布
阅读量1.6k 收藏 33
点赞数 28
分类专栏： 介绍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日第一次发布，介绍了该博客驱动所有函数的介绍及使用

总结

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

【STM32 HAL库】全双工I2S+双缓冲DMA的使用
目标：MVP
07-17 3847
使用CubeIDE实现I2S发数据。
stm32入门教程—i2s
09-28 2157
在实际应用中，你可能还需要考虑音频数据的存储和播放，比如使用SD卡存储音频文件，并通过I2S接口播放。在实际应用中，你可能还需要考虑音频数据的存储和播放，比如使用SD卡存储音频文件，并通过I2S接口播放。6. 初始化结构体：使用I2S_InitTypeDef结构体配置I2S参数，包括模式、标准、数据格式、主时钟输出使能、采样频率和空闲电平选择。1. I2S引脚配置：首先需要配置STM32的I2S引脚，包括SCK（时钟线）、WS（字选择线）和SD（数据线）。// 初始化I2S和DMA。
STM32H7 HAL库错误内容！！！
原初引力
03-03 2288
stm32H7 hal库错误内容汇总： 1. HAL_StatusTypeDef HAL_I2S_Transmit_IT(I2S_HandleTypeDef *hi2s, uint16_t *pData, uint16_t Size) 函数内部有一个判断 if (hi2s->State == HAL_I2S_STATE_READY) { __HAL_UNLOCK(hi2s); ...
STM32CubeMX使用详解及优缺点分析(以I2S为例)
最新发布
04-25 1113
STM32CubeMX 是 ST 官方推出的图形化配置工具，用于快速生成 STM32 微控制器的初始化代码（包括 HAL 库配置）。其核心功能包括：引脚分配与复用：可视化配置 GPIO 功能。时钟树配置：图形化设置系统时钟、外设时钟（如 PLL、HSE、HSI）。外设初始化：自动生成 HAL 库外设初始化代码（如 I2S、SPI、DMA）。中间件集成：支持 FreeRTOS、FatFS、USB 等中间件的快速配置。项目管理：生成 Keil、IAR、STM32CubeIDE 等工程文件。
STM32实现i2s通信
05-09
stm32作为cpu 控制i2s 对收到的音频信息进行模拟和数字的转换。
STM32第二十课（I2S，HAL）
Huskar_Liu的博客
12-22 6661
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
weixin_47077788的博客
03-27 8741
现实存在的声音是模拟量，这对声音保存和长距离传输造成很大的困难，一般的做法是把模拟量转成对应的数字量保存，在需要还原声音的地方再把数字量的转成模拟量输出。模拟量转换成数字量，3个过程：采样、量化和编码。蓝线的距离就是采样信号的周期，即对应一个采样频率（Fs）。Fs越高，采样信号越符合曲线，但采样数据量也会越大，一般使用44.1KHzFs即可得高保真的声音。蓝线长度就是源声音的量化值。量化位数表示每个采样点用多少位数代表数据范围，常用的有16bit、24bit和32bit等。
【STM32开发之寄存器版】（十五）-数字音频接口I2S基础知识
Daemon.Chen的博客
11-04 2117
I2S是一种3引脚的同步串行接口通讯协议。它支持四种音频标准，包括飞利浦I2S标准MSB和LSB对齐标准以及PCM标准。它在半双工通讯中，可以工作在主和从2种模式下。当它作为主设备时，通过接口向外部的从设备提供时钟信号。I2S协议主要用于音频处理器、音频解码器、蓝牙音频设备、多声道音频系统等领域。
关于STM32的I2S通信飞利浦协议和MSB协议
叶大鹏的专栏
08-10 8205
关于STM32的I2S通信飞利浦协议和MSB协议 最近公司一个项目要用到CODEC芯片来做语音的采集和输出，驱动是用的STM32F405的I2S接口。之前没有深入的了解过I2S的知识，只是大概的知道它是一种用于传输音频数据的总线。本来以为没什么难的，实际用下来其实也没感觉有有什么特别的。但是还是在使用的过程中把自己坑了一把。 CODEC芯片型号是MAX9867，主要的应用场合是手机和助听器...
eeprom.zip
09-04
1. 示例代码：可能有C或C++语言编写的示例程序，展示了如何使用STM32F407IGT6的HAL库来驱动A24C512进行读写操作。 2. 配置文件：可能包含工程配置文件，如Keil MDK或GCC的Makefile，帮助用户编译和调试代码。 3. ...
STM32安全特性分析：确保机器人操作的安全性与可靠性
确保机器人操作的安全性与可靠性](https://opengraph.githubassets.com/4542f23e4422eb31b96d888d032e0f5a08c719a212cd159b88597a24a6261608/Delay-n-days/Intelligent-access-control-system-based-on-stm32) ...
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
STM32CubeMX+MDK通过I2S接口进行音频输入输出（全双工读写一个DMA回调）
逍遥游的博客
04-07 5078
目前有一个关于通过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 3752
本文使用cubemx生成尽可能多的代码。
STM32：I2S驱动WM8978
热门推荐
wangzibigan的博客
03-12 2万+
最近项目中使用STM32F4驱动音频IC：WM8978。 WM8978为DAC+ADC芯片，本身并不具备编解码的功能，一方面，可通过I2S接口接收PCM数据，转为模拟信号输出，此为DAC过程，即放音；一方面，可接收模拟信号转为数字信号，通过I2S接口传输给MCU，此为ADC过程，即录音。WM8978还使用I2C接口配置其工作参数，比如音量，EQ，3D环绕等。WM8978本身可直连1W/8欧的小喇...
I2S相关
Kudo_chitose的博客
11-21 3455
I2S 一、简介 I2S（Inter IC Sound）又称集成电路内置音频总线，是一种数字音频设备间的音频数据传输总线标准，该总线专责于音频设备之间的数据传输。采用独立导线传输和时钟信号分离避免因时差引发失真。 二、I2S特点 支持全双工/半双工通信支持主/从模式设置 8位可编程线性预分频器,可实现精确的音频采样频率(8~192Khz)支持16位/24位/32位数据格式 数据包帧固定为16位(仅16位数据帧)或32位(可容纳16/24/32位数据帧)可编程时钟极性 支持MSB对齐(左对齐)、LSB对齐(右
linux i2s应用程序,SEP4020上完成了I2S的驱动
weixin_33205791的博客
05-02 700
为了实现mp3播放，我们最近在sep4020上完成了i2s的驱动，主要经验总结如下：1.首先是要在probe函数里进行一系列的初始化，这些初始化对于i2s是很重要的，而且很多●配置操作codec的L3的gpio口线；L3接口相对于一个混音器控制接口，也就是对应在驱动中的mixer结构体，在这里我们需要利用3根gpio口线实现对L3的控制，以下是初始化代码：*(volatil...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

常驻客栈

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

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

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

打赏作者

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

抵扣说明：

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

余额充值