📚 课程目录第2章 ALSA用户空间接口

2. ALSA 用户空间接口：字符设备文件、/dev/snd/ 目录结构、控制接口

ALSA 在用户空间通过标准的字符设备文件暴露音频功能。应用程序通过 open()、close()、read()、write() 和 ioctl() 系统调用与内核音频驱动交互。理解 /dev/snd/ 目录下的设备文件结构，是编写用户空间音频程序的第一步。

2.1 /dev/snd/ 目录结构

当 ALSA 驱动加载成功后，会在 /dev/snd/ 目录下创建一组字符设备文件。每个设备文件代表一个特定的音频功能接口。

  关键概念： ALSA 设备命名遵循 类型C序号D子设备 的格式。例如 pcmC0D0c 表示：PCM 类型、Card 0、Device 0、capture（录音）方向。

设备文件	类型	主设备号	次设备号范围	功能描述
`controlC0`	控制接口	116	0	音量控制、开关、路由配置
`pcmC0D0p`	PCM 播放	116	0-3	数字音频 playback 数据流
`pcmC0D0c`	PCM 录音	116	4-7	数字音频 capture 数据流
`pcmC0D1p`	PCM 播放	116	8-11	第二个 PCM 设备的播放流
`timer`	定时器	116	12	音频定时器接口
`seq`	音序器	116	13	MIDI 音序器接口

实践提示： 使用 ls -l /dev/snd/ 命令可以查看当前系统的 ALSA 设备列表。如果设备文件缺失，通常意味着驱动加载失败或设备树配置错误。

2.2 字符设备文件与主次设备号

ALSA 使用主设备号 116 统一标识其字符设备驱动。次设备号用于区分不同的逻辑功能和设备实例。内核通过次设备号在驱动内部查找对应的 struct snd_minor 结构体，从而路由到正确的处理函数。

# 查看 /dev/snd/ 下的设备文件及其设备号
$ ls -l /dev/snd/
crw-rw---- 1 root audio 116,  0 3月  15 10:00 controlC0
crw-rw---- 1 root audio 116,  4 3月  15 10:00 pcmC0D0c
crw-rw---- 1 root audio 116,  0 3月  15 10:00 pcmC0D0p
crw-rw---- 1 root audio 116, 12 3月  15 10:00 timer

次设备号的分配规则如下：

control 接口：次设备号 = 设备索引（通常为 0）。
PCM 播放：次设备号 = 设备索引 × 16 + 子设备偏移（0-3）。
PCM 录音：次设备号 = 设备索引 × 16 + 子设备偏移（4-7）。
timer 接口：固定次设备号 12。
seq 接口：固定次设备号 13。

2.3 控制接口（controlC0）

控制接口是用户空间与 ALSA 驱动进行非数据流交互的主要通道。它不传输音频样本数据，而是用于查询和修改音频设备的配置参数。

控制接口支持的核心 ioctl 命令：

ioctl 命令	功能	传入/传出数据结构
`SNDRV_CTL_IOCTL_PVERSION`	获取 ALSA 协议版本	`int`
`SNDRV_CTL_IOCTL_CARD_INFO`	获取声卡基本信息	`struct snd_ctl_card_info`
`SNDRV_CTL_IOCTL_ELEM_LIST`	枚举所有控制元素	`struct snd_ctl_elem_list`
`SNDRV_CTL_IOCTL_ELEM_INFO`	获取单个控制元素的详细信息	`struct snd_ctl_elem_info`
`SNDRV_CTL_IOCTL_ELEM_READ`	读取控制元素的当前值	`struct snd_ctl_elem_value`
`SNDRV_CTL_IOCTL_ELEM_WRITE`	写入控制元素的新值	`struct snd_ctl_elem_value`

注意事项： 控制接口的 ioctl 调用是同步的。在写入音量或切换路由时，驱动会立即更新硬件寄存器。频繁调用控制接口可能引入微秒级的延迟，不适合实时控制场景。

2.4 PCM 设备文件（pcmC0D0p / pcmC0D0c）

PCM 设备文件是音频数据流的主通道。p 后缀表示 playback（播放），c 后缀表示 capture（录音）。应用程序通过 read()/write() 系统调用传输音频样本数据，通过 ioctl() 配置采样率、格式、通道数等参数。

PCM 设备文件的关键 ioctl 命令：

SNDRV_PCM_IOCTL_HW_PARAMS：设置硬件参数（采样率、格式、周期大小等）。
SNDRV_PCM_IOCTL_SW_PARAMS：设置软件参数（开始阈值、停止阈值等）。
SNDRV_PCM_IOCTL_PREPARE：准备 PCM 流，重置 DMA 指针。
SNDRV_PCM_IOCTL_START：启动 PCM 数据传输。
SNDRV_PCM_IOCTL_DRAIN：等待播放缓冲区数据全部输出。
SNDRV_PCM_IOCTL_DROP：立即停止 PCM 流，丢弃缓冲区数据。

// 用户空间打开 PCM 播放设备的典型流程
int fd = open("/dev/snd/pcmC0D0p", O_RDWR);
if (fd < 0) {
    perror("open pcm device failed");
    return -1;
}

// 设置硬件参数
struct snd_pcm_hw_params *params;
snd_pcm_hw_params_alloca(&params);
snd_pcm_hw_params_any(fd, params);
snd_pcm_hw_params_set_access(fd, params, SND_PCM_ACCESS_RW_INTERLEAVED);
snd_pcm_hw_params_set_format(fd, params, SND_PCM_FORMAT_S16_LE);
snd_pcm_hw_params_set_channels(fd, params, 2);
unsigned int rate = 48000;
snd_pcm_hw_params_set_rate_near(fd, params, &rate, 0);
snd_pcm_hw_params(fd, params);

// 准备并启动
ioctl(fd, SNDRV_PCM_IOCTL_PREPARE);
ioctl(fd, SNDRV_PCM_IOCTL_START);

2.5 用户空间接口与 DMA 传输的协同关系

下图展示了用户空间通过字符设备文件与内核 DMA 传输引擎之间的数据流和协同关系：

  协同要点：
  数据路径： 用户空间通过 write() 将音频样本写入 PCM 设备文件 → ALSA 核心层将数据拷贝到 DMA 缓冲区 → DMA 引擎自动将数据搬运到硬件 FIFO。
控制路径： 用户空间通过 ioctl() 操作 controlC0 设备文件 → ALSA 控制中间层调用驱动注册的 kcontrol 回调 → 驱动通过 I2C/SPI 更新编解码器寄存器。
同步机制： DMA 传输完成后触发中断 → 中断处理函数更新硬件指针 → ALSA 核心层通过 poll() 或 mmap 同步通知用户空间。

2.6 设备文件访问权限与多进程管理

ALSA 设备文件的默认权限为 crw-rw----，属主为 root:audio。用户需要加入 audio 组才能访问音频设备。

场景	权限要求	说明
单进程独占 PCM 设备	读写权限	默认行为，一个 PCM 设备文件同时只能被一个进程打开用于数据流
多进程共享控制接口	读写权限	controlC0 允许多个进程同时打开，通过 `ioctl` 并发访问
dmix/dsnoop 插件共享	读写权限	ALSA 插件层在用户空间实现软件混音，底层仍独占 PCM 设备
非 audio 组用户	无权限	`open()` 返回 `EACCES` 错误

调试技巧： 使用 strace -e openat,ioctl aplay test.wav 2>&1 | grep /dev/snd 可以追踪应用程序打开 ALSA 设备文件的过程，快速定位权限或设备路径问题。