I2S#
I2S (Inter-IC Sound) 驱动 | sample:
src/application/samples/peripheral/i2s/
学习目标#
理解 I2S 的 BCLK、WS、SDI 和 SDO 信号及左右声道帧结构
掌握 I2S 主机和从机的初始化、格式配置与引脚复用流程
能够在主机模式下使用
uapi_i2s_write_data()发送双声道数据,并在从机模式下通过接收回调读取数据
基本概念#
I2S 总线简介#
I2S 是面向数字音频的同步串行总线。主机提供位时钟和声道选择信号,数据按左、右声道依次传输。
flowchart LR
M[WS53 I2S 主机] -->|BCLK 位时钟| C[Codec 或 I2S 从机]
M -->|WS 左右声道选择| C
M -->|SDO 发送数据| C
C -->|SDI 接收数据| M
信号 |
作用 |
|---|---|
BCLK/CLK |
每个音频数据位的同步时钟 |
WS/LRCLK |
标识当前传输的是左声道还是右声道 |
SDO |
WS53 向外发送的串行音频数据 |
SDI |
WS53 从外部接收的串行音频数据 |
音频格式参数#
参数 |
WS53 案例配置 |
说明 |
|---|---|---|
工作模式 |
标准 I2S( |
使用标准左右声道帧格式 |
数据位宽 |
24-bit |
每个声道使用 24 位有效数据 |
声道数 |
2 |
左、右双声道 |
采样边沿 |
上升沿 |
在 BCLK 上升沿采样数据 |
时钟分频 |
24 |
由 |
主机与从机#
模式 |
时钟来源 |
案例行为 |
|---|---|---|
主机 |
WS53 输出 BCLK 和 WS |
周期发送左右声道测试数据;当前主机 Sample 未启动接收 |
从机 |
外部主机提供 BCLK 和 WS |
启动读取,在回调中打印左右声道数据 |
涉及 API#
API |
用途 |
头文件 |
|---|---|---|
|
初始化 I2S 并注册接收回调 |
|
|
配置主从模式、位宽、声道和时钟 |
|
|
发送左右声道数据 |
|
|
启动 I2S 接收 |
|
|
去初始化指定 I2S 总线 |
|
案例说明#
案例简介#
WS53 提供主机和从机两个 I2S Sample。主机案例构造递增的左右声道数据并周期发送;从机案例启动接收,收到数据后通过回调分别打印左右声道内容。
当前案例使用普通 I2S 收发接口,不配置 DMA,也不演示 LLI 链式传输。
功能规格#
规格项 |
说明 |
|---|---|
主机源码 |
|
从机源码 |
|
总线编号 |
|
数据位宽 |
24-bit |
声道 |
左、右双声道 |
传输长度 |
|
传输方式 |
普通 I2S 写入/中断接收,不使用 DMA/LLI |
主机发送周期 |
任务等待 500ms 后发送,再延时 1000ms |
案例流程#
flowchart TD
A[配置 I2S 引脚复用] --> B[uapi_i2s_deinit]
B --> C[uapi_i2s_init 注册接收回调]
C --> D[uapi_i2s_set_config]
D --> E{主机还是从机}
E -->|主机| F[准备左右声道测试数据]
F <--> G[uapi_i2s_write_data]
E -->|从机| H[uapi_i2s_read_start]
H --> I[回调打印左右声道数据]
案例操作指导#
第一步:配置案例#
启用 ENABLE_PERIPHERAL_SAMPLE、SAMPLE_SUPPORT_I2S,再选择 SAMPLE_SUPPORT_I2S_MASTER 或 SAMPLE_SUPPORT_I2S_SLAVE。总线编号和传输长度可通过 Kconfig 配置。
第二步:连接设备#
两端必须共地,并按所选模式连接:
运行 WS53 主机 Sample 时,将 WS53 输出的 BCLK、WS 接到从机对应输入,并将 WS53 的 SDO 接到从机 SDI。当前主机 Sample 只发送,不需要连接反向数据线。
运行 WS53 从机 Sample 时,由外部主机提供 BCLK、WS,并将外部主机 SDO 接到 WS53 SDI。
第三步:编译和烧录#
fbb build ws53_liteos_app
fbb flash ws53_liteos_app
第四步:验证#
主机日志周期输出 i2s master write start!。从机收到数据后,回调按 l: 0x...、r: 0x... 打印左右声道值。没有外部时钟和配套设备时,从机不会产生有效接收日志。
关键配置#
配置项 |
默认值 |
说明 |
|---|---|---|
|
0 |
主机使用的 I2S 总线 |
|
0 |
从机使用的 I2S 总线 |
|
32 |
每个声道的传输数据数量 |
|
24 |
I2S 时钟分频值 |
|
|
单声道有效数据位宽 |
|
|
双声道传输 |
WS53 I2S Sample 在启用低功耗功能时会调用
uapi_lpc_set_type(PM_NO_SLEEP),防止传输期间进入当前 I2S 尚不支持的低功耗状态。
代码详解#
1. 配置 I2S 格式#
主机和从机使用同一套音频格式,仅 drive_mode 不同:
i2s_config_t config = {
.drive_mode = MASTER,
.transfer_mode = STD_MODE,
.data_width = TWENTY_FOUR_BIT,
.channels_num = TWO_CH,
.timing = NONE_TIMING_MODE,
.clk_edge = RISING_EDGE,
.div_number = I2S_DIV_NUM,
.number_of_channels = I2S_NUMBER_OF_CHANNELS,
};
sio_porting_i2s_pinmux();
uapi_i2s_deinit(CONFIG_I2S_MASTER_BUS_ID);
uapi_i2s_init(CONFIG_I2S_MASTER_BUS_ID, app_i2s_rx_callback);
uapi_i2s_set_config(CONFIG_I2S_MASTER_BUS_ID, &config);
主机源码虽然向 uapi_i2s_init() 传入了接收回调,但没有调用 uapi_i2s_read_start(),因此当前主机 Sample 不会启动接收;从机源码调用该接口后才真正使能 RX。
2. 主机发送双声道数据#
static uint32_t g_app_left_data[CONFIG_I2S_TRANSFER_LEN];
static uint32_t g_app_right_data[CONFIG_I2S_TRANSFER_LEN];
static i2s_tx_data_t g_app_write_data = {
.left_buff = g_app_left_data,
.right_buff = g_app_right_data,
.length = CONFIG_I2S_TRANSFER_LEN,
};
while (1) {
osal_msleep(I2S_TASK_DURATION_MS);
osal_printk("i2s master write start!\r\n");
uapi_i2s_write_data(CONFIG_I2S_MASTER_BUS_ID, &g_app_write_data);
uapi_tcxo_delay_ms(TCXO_DELAY_MS);
}
3. 从机接收回调#
void app_i2s_rx_callback(uint32_t *left_buff,
uint32_t *right_buff, uint32_t length)
{
for (uint32_t i = 0; i < length; i++) {
osal_printk("l: 0x%0x\r\n", left_buff[i]);
osal_printk("r: 0x%0x\r\n", right_buff[i]);
}
}
uapi_i2s_read_start(CONFIG_I2S_SLAVE_BUS_ID);
接收回调应避免耗时处理。实际音频应用中,建议将数据转交给任务或缓冲队列,避免逐样本打印导致数据丢失。