request_firmware

request_firmware 是 Linux 内核中用于从用户空间请求加载固件的函数，它是设备驱动开发中常用的 API 之一。

函数原型

int request_firmware(const struct firmware **fw, const char *name, struct device *device);

参数说明

• fw: 指向 struct firmware 指针的指针，用于接收加载的固件数据

• name: 请求的固件文件名

• device: 关联的设备指针，用于固件路径查找和设备特定的固件加载

返回值

• 0: 成功加载固件

• 负数: 错误码（如 -ENOENT 表示固件文件未找到）

函数功能

request_firmware 会同步地从用户空间请求固件文件，并将其加载到内核空间。具体过程：

1. 内核首先检查内置固件（编译进内核的固件）

2. 如果没有找到，则向用户空间发送 uevent 请求

3. 用户空间的 udev/hotplug 机制会处理这个请求

4. 固件通常从以下位置查找：

   • /lib/firmware/

   • /lib/firmware/<driver_version>/

   • 其他发行版特定的固件路径

使用示例

static int my_driver_probe(struct device *dev)
{
    const struct firmware *fw;
    int ret;
    
    ret = request_firmware(&fw, "my_device_fw.bin", dev);
    if (ret) {
        dev_err(dev, "无法加载固件: %d\n", ret);
        return ret;
    }
    
    // 使用固件数据
    program_device_with_firmware(fw->data, fw->size);
    
    // 释放固件
    release_firmware(fw);
    
    return 0;
}

相关函数

• request_firmware_nowait(): 异步版本，不会阻塞进程

• release_firmware(): 释放固件资源

• request_firmware_direct(): 直接从文件系统加载，不涉及用户空间帮助程序

注意事项

1. 必须在可睡眠的上下文中调用（如 probe 函数）

2. 加载的固件使用完后必须调用 release_firmware() 释放

3. 对于大型固件，考虑使用异步版本避免阻塞

4. 固件文件应该放在发行版的标准固件目录中

这个函数是 Linux 设备驱动开发中处理外设固件加载的标准方法，特别是在网络设备、GPU、各种控制器等需要固件才能正常工作的硬件驱动中广泛使用。