蓝牙HID驱动：中断处理与性能优化工程实践 - 第3节

3.1 蓝牙HID驱动初始化全景

蓝牙HID驱动的初始化是驱动生命周期中的第一个关键阶段，它决定了设备能否被内核正确识别、资源能否合理分配、电源管理策略能否生效。本章围绕驱动注册、探测函数、设备树匹配与电源管理初始化四个核心环节展开，构建完整的初始化流程视图。

3.2 驱动注册：从模块入口到内核绑定

蓝牙HID驱动通常以 platform_driver 或 serio_driver 的形式注册到内核。驱动注册的入口是 module_init 宏，它指定了驱动初始化函数。

3.2.1 驱动结构体定义

驱动核心结构体 struct platform_driver 包含 probe、remove、shutdown 回调以及 ID 表。对于蓝牙HID，还需要绑定电源管理操作集。

static const struct of_device_id bt_hid_of_match[] = {
    { .compatible = "broadcom,bcm43438-bt", .data = &bcm43438_data },
    { .compatible = "realtek,rtl8822cs-bt", .data = &rtl8822cs_data },
    { }
};
MODULE_DEVICE_TABLE(of, bt_hid_of_match);

static struct platform_driver bt_hid_driver = {
    .probe  = bt_hid_probe,
    .remove = bt_hid_remove,
    .shutdown = bt_hid_shutdown,
    .driver = {
        .name = "bt_hid",
        .of_match_table = bt_hid_of_match,
        .pm = &bt_hid_pm_ops,
    },
};

module_platform_driver(bt_hid_driver);

3.2.2 驱动注册流程步骤

3.3 设备树匹配：硬件拓扑的解析与绑定

设备树（Device Tree）是嵌入式 Linux 描述硬件拓扑的标准方式。蓝牙HID驱动通过 of_match_table 与 DTS 节点进行匹配，获取中断号、GPIO、时钟、电源域等资源。

3.3.1 DTS 节点示例

一个典型的蓝牙HID设备树节点包含以下关键属性：

&uart0 {
    status = "okay";
    
    bluetooth {
        compatible = "broadcom,bcm43438-bt";
        reg = <0>;
        max-speed = <3000000>;
        clocks = <&clk32k 0>;
        clock-names = "lpo";
        device-wakeup-gpios = <&gpio 10 GPIO_ACTIVE_HIGH>;
        host-wakeup-gpios = <&gpio 11 GPIO_ACTIVE_HIGH>;
        interrupt-parent = <&gpio>;
        interrupts = <11 IRQ_TYPE_EDGE_RISING>;
        vbat-supply = <&vcc_3v3>;
        vddio-supply = <&vcc_1v8>;
    };
};

3.3.2 匹配过程与资源获取

当内核发现设备树节点与驱动的 of_match_table 中的 compatible 值匹配时，会调用驱动的 probe 函数。在 probe 中，通过以下 API 获取资源：

3.4 探测函数：设备初始化的核心战场

probe 函数是驱动初始化的核心，负责分配私有数据结构、初始化 HCI 设备、注册 HID 子系统、配置中断以及初始化电源管理。一个典型的蓝牙HID probe 函数包含以下步骤：

3.4.1 probe 函数骨架

static int bt_hid_probe(struct platform_device *pdev)
{
    struct device *dev = &pdev->dev;
    struct bt_hid_data *data;
    int ret, irq;

    // 1. 分配私有数据结构
    data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
    if (!data)
        return -ENOMEM;
    platform_set_drvdata(pdev, data);

    // 2. 获取设备树资源
    irq = platform_get_irq(pdev, 0);
    if (irq < 0)
        return irq;
    data->host_wake_gpio = devm_gpiod_get(dev, "host-wakeup", GPIOD_IN);
    if (IS_ERR(data->host_wake_gpio))
        return PTR_ERR(data->host_wake_gpio);

    // 3. 初始化 HCI 设备
    data->hdev = hci_alloc_dev();
    if (!data->hdev)
        return -ENOMEM;
    hci_set_drvdata(data->hdev, data);
    data->hdev->bus = HCI_UART;
    data->hdev->open  = bt_hid_open;
    data->hdev->close = bt_hid_close;
    data->hdev->send  = bt_hid_send;

    // 4. 注册 HID 设备
    ret = hci_register_dev(data->hdev);
    if (ret < 0)
        goto err_free_hdev;

    // 5. 配置中断
    ret = devm_request_threaded_irq(dev, irq, NULL,
                    bt_hid_irq_handler,
                    IRQF_TRIGGER_RISING | IRQF_ONESHOT,
                    "bt_hid_wake", data);
    if (ret)
        goto err_unregister_hdev;

    // 6. 初始化电源管理
    pm_runtime_set_active(dev);
    pm_runtime_enable(dev);
    pm_runtime_set_autosuspend_delay(dev, 2000);
    pm_runtime_use_autosuspend(dev);

    dev_info(dev, "Bluetooth HID driver initialized\n");
    return 0;

err_unregister_hdev:
    hci_unregister_dev(data->hdev);
err_free_hdev:
    hci_free_dev(data->hdev);
    return ret;
}

3.4.2 probe 函数执行顺序与依赖关系

3.5 电源管理初始化：低功耗的基石

蓝牙HID设备对功耗敏感，电源管理初始化在 probe 函数末尾执行，主要完成 runtime PM 的启用和唤醒源的配置。

3.5.1 runtime PM 初始化步骤

1. 设置初始状态：pm_runtime_set_active(dev) 将设备标记为活动状态，避免在 probe 过程中触发不必要的挂起。
2. 启用 runtime PM：pm_runtime_enable(dev) 开启 runtime PM 框架，之后内核可以根据使用情况自动挂起/唤醒设备。
3. 配置自动挂起延迟：pm_runtime_set_autosuspend_delay(dev, delay_ms) 设置空闲延迟，避免频繁挂起唤醒导致性能抖动。
4. 启用自动挂起：pm_runtime_use_autosuspend(dev) 启用自动挂起模式，设备空闲超过延迟时间后自动进入低功耗。

3.5.2 电源管理操作集定义

static int bt_hid_suspend(struct device *dev)
{
    struct bt_hid_data *data = dev_get_drvdata(dev);
    
    // 保存设备状态
    data->irq_enabled = false;
    disable_irq(data->irq);
    
    // 配置唤醒中断
    if (device_may_wakeup(dev)) {
        enable_irq_wake(data->irq);
    }
    
    // 关闭 HCI 控制器
    hci_suspend_dev(data->hdev);
    
    return 0;
}

static int bt_hid_resume(struct device *dev)
{
    struct bt_hid_data *data = dev_get_drvdata(dev);
    
    // 恢复 HCI 控制器
    hci_resume_dev(data->hdev);
    
    // 恢复中断
    if (device_may_wakeup(dev)) {
        disable_irq_wake(data->irq);
    }
    data->irq_enabled = true;
    enable_irq(data->irq);
    
    return 0;
}

static const struct dev_pm_ops bt_hid_pm_ops = {
    SET_SYSTEM_SLEEP_PM_OPS(bt_hid_suspend, bt_hid_resume)
    SET_RUNTIME_PM_OPS(bt_hid_suspend, bt_hid_resume, NULL)
};

3.6 初始化流程的完整性检查

在驱动开发中，初始化阶段的错误往往在后续运行时才暴露。建议在 probe 函数末尾加入自检逻辑，验证关键资源是否就绪：

static int bt_hid_init_checks(struct bt_hid_data *data)
{
    // 检查中断是否已注册
    if (!data->irq_enabled) {
        dev_err(data->dev, "IRQ not enabled after probe\n");
        return -EINVAL;
    }
    
    // 检查 HCI 设备状态
    if (!hci_dev_test_flag(data->hdev, HCI_UP)) {
        dev_err(data->dev, "HCI device not up after probe\n");
        return -ENODEV;
    }
    
    // 检查电源管理状态
    if (!pm_runtime_enabled(data->dev)) {
        dev_warn(data->dev, "Runtime PM not enabled\n");
    }
    
    return 0;
}