4. ALSA 驱动初始化流程：模块入口、probe 函数、snd_card_new、snd_pcm_new、注册与释放

ALSA 音频驱动的初始化流程是驱动开发者必须掌握的核心路径。一个标准的 ALSA 驱动从内核模块加载开始，经过设备匹配、声卡对象创建、PCM 设备实例化，最终完成注册并暴露给用户空间。本章将拆解这一完整链路，并重点分析各阶段的关键 API 与资源管理策略。

4.1 模块入口与出口

每个 ALSA 驱动首先是一个内核模块，必须定义模块的加载与卸载函数。通常使用 module_init 和 module_exit 宏来注册入口和出口点。

/* 模块入口 */
static int __init my_audio_driver_init(void)
{
    return platform_driver_register(&my_audio_driver);
}
module_init(my_audio_driver_init);

/* 模块出口 */
static void __exit my_audio_driver_exit(void)
{
    platform_driver_unregister(&my_audio_driver);
}
module_exit(my_audio_driver_exit);

4.2 probe 函数：设备匹配与声卡创建起点

当平台驱动与设备树节点或平台设备名称匹配成功后，内核自动调用驱动的 probe 函数。这是 ALSA 驱动初始化的真正起点。在 probe 中，开发者需要完成以下核心步骤：

1. 获取硬件资源：通过 platform_get_resource 获取 I/O 内存、IRQ、DMA 等资源。
2. 创建声卡对象：调用 snd_card_new 分配并初始化 struct snd_card。
3. 创建 PCM 设备：调用 snd_pcm_new 创建 PCM 实例，并绑定回调函数。
4. 注册声卡：调用 snd_card_register 将声卡暴露给用户空间。

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

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

    /* 步骤2: 创建PCM设备 */
    err = snd_pcm_new(card, "my_audio_pcm", 0, 1, 1, &pcm);
    if (err < 0)
        goto err_free_card;

    /* 步骤3: 设置PCM操作回调 */
    snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &my_playback_ops);
    snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &my_capture_ops);

    /* 步骤4: 注册声卡 */
    err = snd_card_register(card);
    if (err < 0)
        goto err_free_card;

    platform_set_drvdata(pdev, card);
    return 0;

err_free_card:
    snd_card_free(card);
    return err;
}

4.3 snd_card_new：声卡对象的诞生

snd_card_new 是 ALSA 驱动中最重要的初始化函数之一。它分配并初始化 struct snd_card，该结构体是声卡的顶层容器，管理所有子设备（PCM、Control、MIDI 等）。

4.4 snd_pcm_new：PCM 设备的实例化

snd_pcm_new 在声卡对象下创建一个 PCM 设备实例。PCM 设备是音频数据流的核心通道，每个 PCM 实例可以包含一个 playback 流和一个 capture 流。

int snd_pcm_new(struct snd_card *card, const char *id, int device,
                int playback_count, int capture_count,
                struct snd_pcm **rpcm);

创建 PCM 设备后，必须通过 snd_pcm_set_ops 为每个流方向设置操作回调结构体。回调结构体 struct snd_pcm_ops 包含 open、close、ioctl、hw_params、prepare、trigger、pointer 等关键方法。

4.5 注册与释放：snd_card_register 与 snd_card_free

当所有子设备（PCM、Control、MIDI 等）都添加到声卡后，调用 snd_card_register 将声卡注册到 ALSA 核心，并创建对应的设备文件节点（如 /dev/snd/pcmC0D0p）。

释放路径通常发生在驱动卸载或 probe 失败时。snd_card_free 会递归释放声卡下的所有子设备，并注销设备文件。

4.6 错误处理与资源释放最佳实践

ALSA 驱动初始化过程中，每一步都可能失败。良好的错误处理机制是驱动稳定性的关键。推荐使用 devm_ 系列 API 简化资源管理：

• devm_snd_card_new：自动在设备分离时调用 snd_card_free。
• devm_platform_ioremap_resource：自动管理 I/O 内存映射。
• devm_request_irq：自动释放中断请求。

/* 使用 devm_ 系列 API 的简化 probe */
static int my_audio_probe_devm(struct platform_device *pdev)
{
    struct snd_card *card;
    struct snd_pcm *pcm;
    int err;

    /* devm_snd_card_new 自动管理释放 */
    err = devm_snd_card_new(&pdev->dev, -1, NULL, THIS_MODULE,
                            sizeof(struct my_chip), &card);
    if (err < 0)
        return err;

    err = snd_pcm_new(card, "my_audio_pcm", 0, 1, 1, &pcm);
    if (err < 0)
        return err;  /* devm 机制会自动释放 card */

    snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &my_playback_ops);

    err = snd_card_register(card);
    if (err < 0)
        return err;

    platform_set_drvdata(pdev, card);
    return 0;
}

4.7 初始化流程总结