4、ALSA内核框架：核心结构体与操作集

好，咱们今天来聊聊ALSA内核框架的核心部分。说实话，这部分内容我当年刚接触时也觉得有点绕，但一旦理清了脉络，你会发现它其实非常清晰。ALSA的架构设计，说白了就是一套精心组织的链表和结构体体系。

4.1 snd_card：一切开始的地方

snd_card是整个ALSA设备的根节点。你可以把它想象成一个“设备容器”——每个声卡对应一个snd_card实例。我在项目中遇到过有人试图在一个snd_card里塞两个完全不同的音频控制器，结果调试时各种诡异问题。嗯，这里要注意：一个物理声卡通常对应一个snd_card，但一个snd_card可以包含多个PCM、Control、MIDI等子设备。

核心要点：snd_card是ALSA设备模型的顶层抽象，负责管理所有子设备。

创建snd_card的接口很简单：

struct snd_card *card;
int err = snd_card_new(device, index, id, THIS_MODULE, extra_size, &card);
if (err < 0) {
    // 处理错误
}

我个人习惯在extra_size参数里带上私有数据结构，这样一次分配就能搞定，省得后面再搞内存泄漏。你想想看，驱动里最烦人的不就是内存管理吗？

4.2 snd_device链：设备的管理艺术

每个子设备（PCM、Control等）在ALSA内部都被抽象成一个snd_device节点。这些节点通过链表串联在snd_card上。为什么用链表？因为设备的注册顺序和注销顺序是相反的——后注册的先注销，链表天然支持这种LIFO行为。

我曾经在调试一个USB音频设备时，发现卸载驱动时系统崩溃。查了半天，原来是某个设备注销时依赖的资源已经被前面的设备释放了。从那以后，我特别强调设备注册顺序的重要性。

我的经验：注册子设备时，尽量把依赖关系理清楚。如果设备A依赖设备B，那就先注册B，再注册A。这样注销时A先被销毁，B后销毁，一切安好。

snd_device的结构体定义大致如下：

struct snd_device {
    struct list_head list;    // 链表节点
    struct snd_card *card;   // 所属的snd_card
    snd_device_type_t type;  // 设备类型
    void *device_data;       // 设备私有数据
    struct snd_device_ops *ops; // 设备操作函数
};

注册一个设备到链上，调用snd_device_new()即可。注销时，ALSA会遍历链表，依次调用每个设备的ops->dev_free()回调。

4.3 snd_pcm：PCM设备的灵魂

snd_pcm是ALSA中最核心的子设备之一。它代表一个PCM数据流通道。每个snd_pcm实例包含两个子流：播放（playback）和录音（capture）。当然，也可以只支持其中一个。

创建snd_pcm的典型代码：

struct snd_pcm *pcm;
int err = snd_pcm_new(card, name, device_index, playback_count, capture_count, &pcm);
if (err < 0) {
    // 处理错误
}

这里playback_count和capture_count指定了播放和录音的子流数量。大多数简单设备都是1个播放、1个录音。但我在项目中遇到过需要多个子流的场景，比如一个声卡同时支持多路音频输出。

注意：snd_pcm_new只是创建了PCM设备的骨架，真正的硬件操作函数还没有绑定。这一步只是分配了结构体和初始化了内部链表。

4.4 snd_pcm_ops：操作集，驱动的心脏

snd_pcm_ops是驱动开发者最需要关注的结构体。它定义了PCM设备的所有硬件操作回调。说白了，你的驱动能不能正常工作，就看这些回调实现得怎么样。

结构体定义如下：

struct snd_pcm_ops {
    int (*open)(struct snd_pcm_substream *substream);
    int (*close)(struct snd_pcm_substream *substream);
    int (*ioctl)(struct snd_pcm_substream *substream, unsigned int cmd, void *arg);
    int (*hw_params)(struct snd_pcm_substream *substream, struct snd_pcm_hw_params *params);
    int (*hw_free)(struct snd_pcm_substream *substream);
    int (*prepare)(struct snd_pcm_substream *substream);
    int (*trigger)(struct snd_pcm_substream *substream, int cmd);
    snd_pcm_uframes_t (*pointer)(struct snd_pcm_substream *substream);
    int (*copy_user)(struct snd_pcm_substream *substream, int channel, unsigned long pos, void __user *buf, unsigned long count);
    int (*copy_kernel)(struct snd_pcm_substream *substream, int channel, unsigned long pos, void *buf, unsigned long count);
    int (*fill_silence)(struct snd_pcm_substream *substream, int channel, unsigned long pos, unsigned long count);
    struct page *(*page)(struct snd_pcm_substream *substream, unsigned long offset);
    int (*mmap)(struct snd_pcm_substream *substream, struct vm_area_struct *vma);
    int (*ack)(struct snd_pcm_substream *substream);
};

这里我挑几个关键的回调说说：

  • open/close：打开和关闭PCM子流。我建议在open里做资源预分配，close里做清理。别把资源分配放到hw_params里，否则用户空间乱调参数时你会很头疼。
  • hw_params：设置硬件参数，比如采样率、格式、通道数。这个回调可能会被多次调用，要做好参数校验。
  • trigger：启动、停止、暂停PCM传输。这个回调在原子上下文中执行，不能睡眠。我曾经在这里调了msleep()，结果系统直接死锁，教训深刻。
  • pointer：返回当前硬件DMA的位置。这个回调必须准确，否则音频会出现卡顿或杂音。

我的建议：实现pointer回调时，最好用硬件寄存器直接读取当前位置，不要用软件计数。软件计数在中断丢失时会累积误差，导致音频不同步。

4.5 注册与注销流程

好了，结构体和操作集都准备好了，接下来就是注册和注销。流程其实很清晰：

注册流程

  1. 调用snd_card_new()创建snd_card实例。
  2. 调用snd_pcm_new()创建PCM设备，并绑定到snd_card。
  3. 设置snd_pcm->ops指向你的snd_pcm_ops实例。
  4. 设置snd_pcm->private_data指向你的私有数据结构。
  5. 调用snd_card_register()注册整个声卡。

代码示例：

static int my_audio_probe(struct platform_device *pdev)
{
    struct snd_card *card;
    struct snd_pcm *pcm;
    int err;

    // 1. 创建snd_card
    err = snd_card_new(&pdev->dev, SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1,
                       THIS_MODULE, sizeof(struct my_chip), &card);
    if (err < 0)
        return err;

    // 2. 创建PCM设备
    err = snd_pcm_new(card, "my_audio", 0, 1, 1, &pcm);
    if (err < 0)
        goto err_pcm;

    // 3. 设置操作集
    pcm->ops = &my_pcm_ops;
    pcm->private_data = card->private_data;

    // 4. 设置PCM设备名称
    strcpy(pcm->name, "My Audio Device");

    // 5. 注册声卡
    err = snd_card_register(card);
    if (err < 0)
        goto err_register;

    platform_set_drvdata(pdev, card);
    return 0;

err_register:
    snd_pcm_free(pcm);
err_pcm:
    snd_card_free(card);
    return err;
}

注销流程

注销就简单多了，调用snd_card_free()即可。ALSA会自动遍历snd_device链表，依次销毁所有子设备。

static int my_audio_remove(struct platform_device *pdev)
{
    struct snd_card *card = platform_get_drvdata(pdev);
    snd_card_free(card);
    return 0;
}

注意：snd_card_free()会等待所有PCM流关闭后才真正释放资源。如果你的驱动在卸载时还有应用程序在使用音频设备，这个调用会阻塞。我建议在驱动卸载前先通知用户空间程序停止使用。

4.6 总结

嗯，到这里ALSA内核框架的核心内容就讲完了。我们来回顾一下：

  • snd_card：声卡的根容器，管理所有子设备。
  • snd_device链：子设备的链表，支持有序注册和注销。
  • snd_pcm：PCM设备的抽象，包含播放和录音子流。
  • snd_pcm_ops：硬件操作回调集，驱动开发的核心工作。
  • 注册/注销流程：先创建card，再创建子设备，最后注册；注销时只需释放card。

我个人觉得，理解这些结构体的关系比背代码更重要。你想想看，只要理清了“card包含device，device包含pcm，pcm包含ops”这条线，写驱动时思路就会清晰很多。下一章我们会深入PCM数据流的运行时管理，到时候再聊。

← 上一章 📖 返回目录 下一章 →