13.Linux驱动基础-request_firmware升级

已于 2022-06-23 11:25:09 修改
阅读量8k 收藏 42
点赞数 4
分类专栏： 安卓驱动开发 文章标签： linux stm32 物联网
于 2021-10-05 20:12:13 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43824344/article/details/120617657
版权

文章目录

1.概述

request_firmware()：将固件以二进制文件形式存储于文件系统之中，在内核启动后再从用户空间将固件传递至内核空间，内核空间解析固件获得文件数据，最后加载至硬件设备。requeset_firmware()必须等到文件系统挂载后才能得到用户空间的固件,否则会一直阻塞到可以获取固件

2.request_firmware

此函数为固件加载的API,函数原型为：

#include <linux/firmware.h>

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

参数：

  • fw：用于保存申请到的固件数据
  • name:固件名字
  • device:申请固件的设备
  • 如果申请固件成功，函数返回0；申请固件失败，返回一个负数值（如-EINVAL、-EBUSY）。

2.1 struct firmware **fw

struct firmware结构体为，

struct firmware {
	size_t size;
	const u8 *data;
	struct page **pages;

	/* firmware loader private fields */
	void *priv;
};

其中size为解析出来的固件的大小，data为解析出来的固件数据首地址，

2.2 char *name

上面说的固件名字，如“fw.bin"这样的字符串格式。实际上这些固件会存放在一个指定的目录下，需要指定的位置在目录/drivers/base/firmware_class.c下

/* direct firmware loading support */
static char fw_path_para[256];
static const char * const fw_path[] = {
	fw_path_para,
	"/lib/firmware/updates/" UTS_RELEASE,
	"/lib/firmware/updates",
	"/lib/firmware/" UTS_RELEASE,
	"/lib/firmware",
	"/lib64/firmware",
	"/mnt/update",
	"/lib/firmware/image"
};

假如你的固件放置在vendor/firmware下，你只需要在fw_path中添加即可。如

static const char * const fw_path[] = {
	fw_path_para,
	"/lib/firmware/updates/" UTS_RELEASE,
	"/lib/firmware/updates",
	"/lib/firmware/" UTS_RELEASE,
	"/lib/firmware",
	"/lib64/firmware",
	"/mnt/update",
        "/vendor/firmware" //新增加
	"/lib/firmware/image"
};

3.3 调用原理

在调用request_firmware()时，函数在 /sys/class/firmware 下创建一个以设备名为目录名的新目录，其中包含 3 个属性:

  • loading:当固件加载时被置1，加载完毕被置0，如果被置-1则终止固件加载；
  • data:内核获取固件接口，当loading被置1时，用户空间通过该属性接口传递固件至内核空间；
  • device:符号链接，链接至/sys/devices/下相关设备目录。

当sysfs接口创建完毕，uevent会配合将固件通过sysfs节点写入内核

3.release_firmware

在固件加载成功之后，需要使用fw,函数原型为

void release_firmware(const struct firmware *fw);

4.使能固件升级宏

如果不使能下面的宏，会出现: Unknown symbol release_firmware 和: Unknown symbol request_firmware 的错误。

 Device Drivers  --->

          Generic Driver Options  --->

             <*> Userspace firmware loading support`

或者直接在.config中配置

CONFIG_FW_LOADER=y

在内核中CONFIG_FW_LOADER默认是关闭的，如果不使能这个宏，在申请fw时，会直接返回错误-EINVAL

// include/linux/firmware.h
#if defined(CONFIG_FW_LOADER) || (defined(CONFIG_FW_LOADER_MODULE) && defined(MODULE))
int request_firmware(const struct firmware **fw, const char *name,
		     struct device *device);
...
#else
static inline int request_firmware(const struct firmware **fw,
				   const char *name,
				   struct device *device)
{
	return -EINVAL;
}
...
#endif

5.具体升级示例

5.1 添加升级路径

固件放置在vendor/firmware下，在fw_path中添加，固件名字fw.cfg,将其push到vendor/firmware下

static const char * const fw_path[] = {
	fw_path_para,
	"/lib/firmware/updates/" UTS_RELEASE,
	"/lib/firmware/updates",
	"/lib/firmware/" UTS_RELEASE,
	"/lib/firmware",
	"/lib64/firmware",
	"/mnt/update",
        "/vendor/firmware" //新增加
	"/lib/firmware/image"
};

5.2 添加固件升级结点

request_firmware()函数如果在probe()中使用会一直阻塞至文件系统挂载获取固件，所以一般需要在驱动中将其封装为sysfs节点，以便在文件系统挂载后调用：

#define FIRMWARE_NAME "fw.cfg"

struct data
{
    struct work_struct work;
    bool work_func_flags;
    u8 *fw_data;
}
...
static int update_fw(struct data *data, const struct firmware *fw )
{
    //取出fw->data进行升级操作
    data->fw_data = (u8)fw->data;

    return 0;
}

static void work_func(struct work_struct *work)
{
    struct data *data =contain_of(work,struct data,data.work);
    const struct firmware *fw = NULL;
    /* 申请用户空间固件 */
    ret = request_firmware(&fw, FIRMWARE_NAME, dev);
    if (ret) 
    {
        return -ENOENT;
        goto out;
    }
    /* 升级固件至硬件设备 */
    update_fw(fw);

 
out:
    /* 释放firmware结构体 */
    release_firmware(fw);
}

static void update_start_up()
{
    if(!work_pending(data->work))
    {
        schedule_work(&data->work);
    }
    
}

static ssize_t updata_fw_store(struct device *dev,   
                    struct device_attribute *attr,   
                    const char *buf, size_t count)
{


    int ret;
    unsigned long value;

    if (kstrtoul(buf, 10, &value))
        return -EINVAL;

    if (value == 1) 
    {
	update_start_up();
    }

    return count;
}

// sys/devices/platform/update/load_fw
static DEVICE_ATTR(update_fw, S_IWUGO, NULL, update_fw_store);  

...

static int update_probe(struct platform_device *pdev)
{
	int ret;
	struct data *data;
        
        data = devm_kzlloc(data,sizeof(struct data),GFP_KERNEL)
        data->work_func_flags = false;
        
        platform_set_drvdata(pdev,data,)
      
        
	/* 创建sysfs节点 */
	ret = device_create_file(pdev, &dev_attr_update_fw);
	if (ret)
        {
            return -EINVAL;
	}
        
        INIT_WORK(&work,work_func);
	return 0;
}

static int update_remove(struct platform_device *pdev)
{
    struct data *data = platform_get_drvdata(pdev);
    if(data->work_func_flags)
    {
        cancel_work_sync(data->work);
    }
}
...

6.异步方式升级固件

request_firmware是以同步的方式进行固件升级，如果要求进行升级时不上下文不进行睡眠操作，那么会用到异步升级API来加载固件，实际上其在调用工作队列的方式进行固件升级，在前面使用request_firmware时也用了工作队列实现：request_firmware_nowait，函数原型为：

int request_firmware_nowait(
	struct module *module, bool uevent,
	const char *name, struct device *device, gfp_t gfp, void *context,
	void (*cont)(const struct firmware *fw, void *context));
  • module :模块名
  • uevent :一般置为1
  • name :固件名
  • device :申请固件的设备结构体
  • gfp :内核内存分配标志位，一般为GFP_KERNEL
  • context:私有数据指针
  • cont :回调函数
    函数原型为:
int request_firmware_nowait(
	struct module *module, bool uevent,
	const char *name, struct device *device, gfp_t gfp, void *context,
	void (*cont)(const struct firmware *fw, void *context))
{
	struct firmware_work *fw_work;

	fw_work = kzalloc(sizeof (struct firmware_work), gfp);
	if (!fw_work)
		return -ENOMEM;

	fw_work->module = module;
	fw_work->name = name;
	fw_work->device = device;
	fw_work->context = context;
	fw_work->cont = cont;
	fw_work->uevent = uevent;

	if (!try_module_get(module)) {
		kfree(fw_work);
		return -EFAULT;
	}

	get_device(fw_work->device);
	//初始化工作队列
	INIT_WORK(&fw_work->work, request_firmware_work_func);
	//调度工作队列
	schedule_work(&fw_work->work);
	return 0;
}

具体示例：

#define FIRMWARE_NAME "/vendor/firmware/fw.cfg"
...

void update_requset_fw_callback(const struct firmware *fw, void *context)
{  
    struct device *dev = context;

    if (fw != NULL) 
    {
	/* 加载固件至硬件设备 */    
        update_fw(fw, dev);
        /* 释放firmware结构体 */
	release_firmware(fw);
    }
}

static ssize_t update_fw_store(struct device *dev,   
                    struct device_attribute *attr,   
                    const char *buf, size_t count)
{

    int ret;
    unsigned long value;
    const struct firmware *fw = NULL;

    if (kstrtoul(buf, 10, &value))
    {
        return -EINVAL;
    }
    
    if (value == 1) 
    {
	/* 申请用户空间固件 */
	ret = request_firmware_nowait(THIS_MODULE, 1, FIRMWARE_NAME, 
          dev, GFP_KERNEL, dev, update_requset_fw_callback);
	if (ret) 
	{
              return -ENOENT;
         }
    }

    return count;
}
...

参考：https://blog.csdn.net/zifehng/article/details/60321966

深海带鲤鱼
关注
  • 4
    点赞
  • 踩
  • 42
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
专栏目录
request_firmware
luckywang1103的专栏
09-25 8053
获取固件的正确方法是当需要时从用户空间获取它。一定不要试图从内核空间直接打开包含固件的文件，那是一个易出错的操作, 因为它把策略(以文件名的形式)包含进了内核。正确的方法是使用固件接口: struct firmware; request_firmware(); request_firmware_nowait(); release_firmware();注意：要使用firmware，必须要在
DIR-815_FIRMWARE_1.01.ZIP
04-12
标题“DIR-815_FIRMWARE_1.01.ZIP”揭示了这是一个固件更新文件，用于DIR-815型号的路由器。固件是设备的操作系统，它包含控制设备运行的所有软件组件。这个特定的版本是1.01，意味着这可能是一个早期的更新，用于...
Linux 内核加载固件函数--request_firmware
MHD0815的博客
03-06 764
例如，它依赖于文件系统的挂载状态，如果文件系统没有挂载或者固件文件不在预期的路径下，那么固件加载就会失败。在实际驱动中，您可能需要处理更多的错误情况，实现更多的设备功能，以及提供完整的用户空间接口。此外，驱动开发者还需要确保固件文件在适当的文件系统中可用，并且具有正确的权限，以便内核能够加载它。如果固件加载成功，该固件将被保存在设备数据结构中，并且字符设备将被添加到系统中，使得用户空间程序可以通过标准的文件操作来访问该设备。：加载过的固件会被缓存，后续的请求可以直接使用缓存的固件，避免了重复加载。
linux的firmware和hal层
最新发布
dianqicyuyan的博客
05-07 382
在Android系统中，HAL通常由设备制造商提供，并由Android系统框架加载。在Linux中，固件（firmware）和硬件抽象层（Hardware Abstraction Layer，HAL）是两个不同的概念。固件是运行在硬件设备上的程序，它们通常被用来控制硬件的操作。而HAL是一种软件层，它提供了一种标准化的方式来访问硬件设备，从而使应用程序可以独立于硬件设备。固件是硬件设备的本地代码，它们通常存储在设备的非易失性存储器中，例如ROM或EEPROM中，用于控制硬件设备或执行其它操作。
request_firmware函数的使用
CLL的博客
04-14 1677
request_firmware函数主要是用来在kermnel 里给外围设备更新固件的时候，获得固件文件的。 调用此函数后，编译进系统的固件文件，就被调用内存。 当调用request_firmware 函数时，它会自动在几个固定的文件夹下搜索，查找和文件名字相同的文件，然后打开读到内存。 1.调用方法： const struct firmware *cfg; int ...
Linux驱动基础-request_firmware升级
生活需要深度
02-18 991
request_firmware()：将固件以二进制文件形式存储于文件系统之中，在内核启动后再从用户空间将固件传递至内核空间，内核空间解析固件获得文件数据，最后加载至硬件设备。实际上这些固件会存放在一个指定的目录下，需要指定的位置在目录/drivers/base/firmware_class.c下。固件放置在vendor/firmware下，在fw_path中添加，固件名字fw.cfg,将其push到vendor/firmware下。其中size为解析出来的固件的大小，data为解析出来的固件数据首地址，
iDRAC-with-Lifecycle-Controller_Firmware_40T1C_WN32_2.63.60.61_A00.zip
09-21
Lifecycle Controller则是iDRAC的一项增强特性，它允许在操作系统启动之前执行诸如安装、升级、配置等生命周期管理任务，无需额外的操作系统支持。 此压缩包文件"iDRAC-with-Lifecycle-Controller_Firmware_40T1C_...
Simba-AL00_1.1.0.392_Firmware_general_NA_05015GPW.zip
08-07
"Firmware"一词表明这是手表的操作系统或硬件驱动程序的升级包，用于提升设备性能、修复已知问题或增加新功能。 【描述】中提到的"官方完整强刷-卡刷包"，意味着这是一次官方提供的全面更新，"强刷"通常指的是强制...
iDRAC-with-Lifecycle-Controller_Firmware_DNH17_WN64_2.70.70.70_A00.EXE
05-03
idrac升级文件，最新的，t630
DELL R730 SAS-RAID_Firmware驱动（2018年1月份）
01-29
DELL R730 SAS-RAID_Firmware驱动（2018年1月份），需要的朋友自己下载。
request_firmware()——Linux固件子系统接口函数分析
热门推荐
zifehng的专栏
03-04 1万+
一些不带内置存储的设备，依赖于驱动预加载的固件才能运行，传统做法是将固件二进制码作为一个数组编译进驱动代码，这种方法图一时省力，却为后续的维护升级带来了麻烦。针对这种情况，在内核中其实早有解决办法，request_firmware()是一套成熟的固件加载方案：将固件以二进制文件形式存储于文件系统之中，在内核启动后再从用户空间将固件传递至内核解析固件，最后加载至硬件设备。
Linux驱动使用request_firmware固件子系统
TSZ0000的博客
10-31 1994
背景 在使用外围模块器件时，经常有时候会进行固件的启动加载和升级，比如LCD，TP；之前的方式是把固件转换为十六进制放在代码的数组中，在需要加载固件时传入数组名即可；但是这种数组方式不够灵活，不方便后面的固件升级，也会导致内核镜像文件变大；最近发现还有一种高级的方式：使用request_firmware固件子系统，驱动在遇到需要加载固件时，使用request_firmware接口向用户空间请求文...
[Linux]用request_firmware()加载firmware
wangyijieonline的博客
05-05 2013
Scope Linux kernel provides a function request_firmware() to load firmware binary to configure and enable devices. So here we dig it further. Usage of “request_firmware()” Declaration of request_firmware(): int request_firmware( const struct firmware **fir
request_firmware 的用法,
zhenwenxian的专栏
03-17 9023
request_firmware 的用法,struct firmware,内核，固件，usb 收藏 网上有许多说明，ldd3也有：http://www.deansys.com/doc/ldd3/ch14s08.html。对于刚使用的人来说，上面都说的笼统，说了等于没说，我总结一下：1、request_firmware在内核使用，需要文件系统支持，就是说，启动的时候如果在驱动里面的probe
linux firmware相关
DD'Notes
11-06 272
linux firmware相关 | DD'Noteshttps://notes.z-dd.net/2021/07/22/linux%20firmware%E7%9B%B8%E5%85%B3/
/var/cache/apt/archives/linux-firmware_20220329.git681281e4-0ubuntu3.14_all.deb
07-28
/var/cache/apt/archives/linux-firmware_20220329.git681281e4-0ubuntu3.14_all.deb是一个Linux固件包。它包含了用于支持硬件设备的固件文件。在构建根文件系统的过程中，安装linux-firmware软件包是必要的，因为它提供了许多硬件设备所需的固件文件。这些固件文件包括无线网卡、显卡、声卡等设备的固件。通过安装linux-firmware软件包，可以确保系统能够正确地识别和使用这些硬件设备。 #### 引用[.reference_title] - *1* *2* *3* [基于 RK3588 构建 Ubuntu 22.04 根文件系统](https://blog.csdn.net/qq_34117760/article/details/130909986)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值