4. 声卡注册与初始化：核心 API 详解与调用流程

在 ALSA 音频框架中，声卡的生命周期由三个核心函数管理：snd_card_new() 负责创建声卡对象，snd_card_register() 将声卡注册到 ALSA 核心并暴露给用户空间，snd_card_free() 则完成资源释放。理解这三个函数的内部机制与调用顺序，是编写稳定声卡驱动的基石。

4.1 snd_card_new()：声卡对象的创建

snd_card_new() 是声卡生命周期的起点。它在内核堆中分配 struct snd_card 结构体，并完成基本字段的初始化，但此时声卡尚未对用户空间可见。

函数原型

int snd_card_new(struct device *parent, int idx, const char *xid,
                 struct module *module, int extra_size,
                 struct snd_card **card_ret);

参数详解

内部执行流程

1. 分配内存： 通过 kzalloc 分配 sizeof(struct snd_card) + extra_size 大小的内存。
2. 初始化核心字段： 设置 parent、module、id（从 xid 复制）、number（从 idx 或自动分配）。
3. 初始化链表头： 初始化 devices、controls、files 等链表，用于挂载 PCM、控制、MIDI 等子设备。
4. 初始化锁： 初始化声卡级别的读写锁和互斥体。
5. 设置电源管理： 初始化电源管理相关字段，默认状态为 SNDRV_CTL_POWER_D0（全功率）。
6. 返回声卡对象： 通过 card_ret 指针返回，调用者获得声卡引用。

4.2 snd_card_register()：声卡的注册与暴露

当声卡的所有子组件（PCM、控制、MIDI 等）都已创建并添加到声卡后，驱动调用 snd_card_register() 将声卡正式注册到 ALSA 核心层。此函数执行后，声卡对用户空间可见，应用程序可以通过 /dev/snd/ 设备节点访问声卡。

函数原型

int snd_card_register(struct snd_card *card);

注册流程

1. 创建字符设备： 调用 snd_register_device() 为声卡创建控制设备节点（/dev/snd/controlC0）。
2. 注册到 ALSA 核心： 将声卡加入全局声卡链表，分配声卡编号（如果之前未指定）。
3. 注册子设备： 遍历 card->devices 链表，为每个已添加的子设备（PCM、MIDI、定时器等）创建设备节点。
4. 创建 proc 文件： 在 /proc/asound/ 下创建声卡信息文件，如 card0、pcm0p 等。
5. 发送 uevent： 向用户空间发送 KOBJ_ADD 事件，触发 udev 自动加载固件或设置权限。
6. 标记状态： 设置 card->registered 标志位为 1，表示声卡已注册。

4.3 snd_card_free()：声卡的释放与资源回收

snd_card_free() 是声卡生命周期的终结函数。它在驱动卸载或错误恢复路径中被调用，负责释放声卡及其所有子设备占用的资源。

函数原型

int snd_card_free(struct snd_card *card);

释放流程

1. 检查注册状态： 如果声卡已注册（registered 标志为 1），先执行注销操作。
2. 注销设备节点： 移除 /dev/snd/ 下的所有设备节点，关闭用户空间的文件句柄。
3. 释放子设备： 遍历 devices 链表，调用每个子设备的析构函数（snd_device_free()）。
4. 释放控制接口： 释放所有 control 元素和 control 设备。
5. 释放 proc 文件： 移除 /proc/asound/ 下的相关条目。
6. 释放声卡内存： 调用 kfree 释放 struct snd_card 及其附加的私有数据。

变体函数

4.4 完整的声卡初始化与释放调用流程

以下代码展示了一个典型的声卡驱动中，三个核心函数的完整调用顺序：

static int my_audio_probe(struct platform_device *pdev)
{
    struct snd_card *card;
    struct my_chip *chip;
    int err;

    // 步骤1: 创建声卡对象
    err = snd_card_new(&pdev->dev, -1, "my_audio", THIS_MODULE,
                       sizeof(struct my_chip), &card);
    if (err < 0)
        return err;

    // 获取私有数据指针
    chip = snd_card_get_private(card);
    chip->card = card;

    // 步骤2: 创建 PCM 子设备
    err = snd_pcm_new(card, "my_pcm", 0, 1, 1, &chip->pcm);
    if (err < 0)
        goto error;

    // 步骤3: 创建控制接口
    err = snd_ctl_add(card, snd_ctl_new1(&my_control, chip));
    if (err < 0)
        goto error;

    // 步骤4: 注册声卡（所有子设备已就绪）
    err = snd_card_register(card);
    if (err < 0)
        goto error;

    platform_set_drvdata(pdev, card);
    return 0;

error:
    snd_card_free(card);
    return err;
}

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

4.5 常见错误与避坑指南