3. PWM控制器注册流程详解：从 pwmchip_add() 函数入口开始

PWM 控制器的注册是整个 PWM 子系统初始化的核心环节。当 PWM 控制器驱动（如 pwm-imx.c、pwm-sun4i.c）在 probe 阶段调用 pwmchip_add() 时，内核会执行一套标准化的注册流程，将硬件控制器抽象为内核可管理的 pwm_chip 设备。本节将深入分析该函数的内部调用链，涵盖设备创建、ID 分配、sysfs 接口创建等关键步骤。

3.1 pwmchip_add() 函数入口与核心数据结构

pwmchip_add() 定义在 drivers/pwm/core.c 中，其原型为：

int pwmchip_add(struct pwm_chip *chip)
{
    return pwmchip_add_with_polarity(chip, PWM_POLARITY_NORMAL);
}

该函数是 pwmchip_add_with_polarity() 的简单封装。核心参数 struct pwm_chip 是 PWM 控制器的抽象描述，其关键字段如下表所示：

3.2 内部调用链全景：从入口到完成

pwmchip_add_with_polarity() 的内部调用链可分为 5 个主要阶段。下面的 SVG 流程图展示了完整的注册路径：

3.3 阶段1：ID 分配 — pwmchip_find_free_base()

内核维护一个全局的 PWM 编号空间，每个 PWM 通道在系统中拥有唯一的 pwm_id。ID 分配的核心函数是 pwmchip_find_free_base()，其工作流程如下：

1. 检查 chip->base 值： 如果驱动已指定 base >= 0，则直接使用该值并验证是否与现有 ID 冲突。
2. 动态分配（推荐）： 如果 base == -1，内核遍历已注册的 pwm_chips 链表，寻找第一个可用的连续 npwm 个 ID 区间。
3. 分配策略： 采用“从 0 开始，首次适配”算法，确保 ID 空间紧凑。
4. 加锁保护： 整个分配过程在 pwm_lock 互斥锁保护下进行，防止并发注册导致 ID 冲突。

3.4 阶段2：设备创建 — device_register()

ID 分配完成后，内核调用 device_register(&chip->dev) 将 PWM 控制器注册为内核设备模型中的一个节点。该步骤涉及以下子操作：

设备创建阶段会触发 uevent 发送到用户空间，如果 udev/mdev 规则复杂，可能引入额外延迟。在启动优化场景中，可通过 devtmpfs 挂载和精简 udev 规则来减少此阶段耗时。

3.5 阶段3：PWM 设备数组分配 — alloc_pwms()

内核为每个 PWM 通道分配一个 struct pwm_device 结构体，并初始化其关键字段：

static int alloc_pwms(struct pwm_chip *chip)
{
    unsigned int i;
    struct pwm_device *pwm;

    chip->pwms = kcalloc(chip->npwm, sizeof(*pwm), GFP_KERNEL);
    if (!chip->pwms)
        return -ENOMEM;

    for (i = 0; i < chip->npwm; i++) {
        pwm = &chip->pwms[i];
        pwm->chip = chip;
        pwm->hwpwm = i;
        pwm->pwm = chip->base + i;
        pwm->state.polarity = PWM_POLARITY_NORMAL;
        pwm->state.period = 0;
        pwm->state.duty_cycle = 0;
        pwm->state.enabled = false;
        mutex_init(&pwm->lock);
    }
    return 0;
}

该阶段的时间复杂度为 O(n)，其中 n = chip->npwm。对于具有 8 个通道的典型 PWM 控制器，此阶段耗时约 5~10 μs，主要开销来自 kcalloc 的内存分配和 mutex_init 的锁初始化。

3.6 阶段4：sysfs 接口创建 — pwmchip_sysfs_export()

这是整个注册流程中 最耗时的阶段，也是后续优化的重点。sysfs 接口的创建过程如下：

1. 创建设备目录： 在 /sys/class/pwm/pwmchipN/ 下创建目录结构。
2. 创建属性文件： 为每个 PWM 通道创建 export、unexport 控制文件。
3. 创建通道子目录： 当用户通过 export 导出通道时，动态创建 pwmX/ 子目录及其属性文件（period、duty_cycle、polarity、enable 等）。
4. 权限设置： 设置文件权限为 0644，所有者 root。

3.7 阶段5：链表插入与完成

最后一步是将初始化完成的 pwm_chip 插入全局链表 pwm_chips：

mutex_lock(&pwm_lock);
list_add_tail(&chip->list, &pwm_chips);
mutex_unlock(&pwm_lock);

此操作在 pwm_lock 保护下执行，时间复杂度为 O(1)。插入完成后，PWM 控制器对其他内核模块可见，可以通过 pwm_get() 或 of_pwm_get() 获取 PWM 通道。

3.8 完整注册流程时序总结

下表汇总了 pwmchip_add() 各阶段的调用函数、耗时分布和优化潜力：