4. PCM设备创建：PCM设备注册与结构体初始化

PCM（Pulse Code Modulation）设备是ALSA声卡驱动中最核心的音频数据通道。本章将深入讲解如何通过snd_pcm_new()注册PCM设备，以及如何正确初始化struct snd_pcm结构体中的关键成员。掌握这些内容是驱动移植适配的基础。

4.1 PCM设备注册流程

PCM设备的注册遵循“创建 → 初始化 → 设置操作集 → 注册”的固定流程。核心API函数为snd_pcm_new()，其原型如下：

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

struct snd_pcm *pcm;
int ret;

ret = snd_pcm_new(card, "My Audio Device", 0, 1, 1, &pcm);
if (ret < 0) {
    dev_err(card->dev, "Failed to create PCM device: %d\n", ret);
    return ret;
}

4.2 struct snd_pcm 结构体深度解析

struct snd_pcm是ALSA框架中描述PCM设备的核心结构体，其定义位于include/sound/core.h。驱动开发者需要重点关注以下成员：

4.3 PCM操作函数集（snd_pcm_ops）

struct 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);
};

static const struct snd_pcm_ops my_pcm_ops = {
    .open      = my_pcm_open,
    .close     = my_pcm_close,
    .hw_params = my_pcm_hw_params,
    .hw_free   = my_pcm_hw_free,
    .prepare   = my_pcm_prepare,
    .trigger   = my_pcm_trigger,
    .pointer   = my_pcm_pointer,
};

// 在probe函数中设置
snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &my_pcm_ops);
snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &my_pcm_ops);

4.4 PCM设备初始化完整流程

以下SVG图展示了从声卡创建到PCM设备注册的完整初始化流程：

4.5 完整代码示例：PCM设备创建与初始化

以下代码展示了在声卡驱动probe函数中创建并初始化PCM设备的完整过程：

static int my_audio_probe(struct platform_device *pdev)
{
    struct snd_card *card;
    struct snd_pcm *pcm;
    struct my_chip *chip;
    int ret;

    // 1. 创建声卡
    ret = snd_card_new(&pdev->dev, -1, NULL, THIS_MODULE,
                       sizeof(struct my_chip), &card);
    if (ret < 0)
        return ret;

    chip = card->private_data;
    chip->card = card;

    // 2. 创建PCM设备：1个播放子流，1个录音子流
    ret = snd_pcm_new(card, "my_audio_device", 0, 1, 1, &pcm);
    if (ret < 0) {
        dev_err(&pdev->dev, "Failed to create PCM: %d\n", ret);
        goto err_free_card;
    }

    // 3. 初始化PCM结构体
    pcm->private_data = chip;          // 关联硬件上下文
    strcpy(pcm->name, "My Audio PCM"); // 设置设备名称
    pcm->nonatomic = 1;                // 允许非原子上下文

    // 4. 设置操作函数集
    snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &my_pcm_ops);
    snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &my_pcm_ops);

    // 5. 设置硬件参数约束（可选，但推荐）
    // snd_pcm_hw_constraint_list() 等

    // 6. 注册声卡
    ret = snd_card_register(card);
    if (ret < 0) {
        dev_err(&pdev->dev, "Failed to register card: %d\n", ret);
        goto err_free_card;
    }

    platform_set_drvdata(pdev, card);
    return 0;

err_free_card:
    snd_card_free(card);
    return ret;
}

4.6 PCM Substream 结构体关系

理解PCM设备与substream的层级关系对驱动开发至关重要。以下SVG图展示了从声卡到DMA缓冲区的完整对象层次：

4.7 常见问题与调试技巧