2024年5月11日发(作者：)

fdt_getprop函数详解

fdt_getprop函数是一个非常重要的Linux内核函数，它可以实

现树格式数据结构（flattened device tree）与系统设备之间的双

向通信。本文介绍此函数的基本功能和实现细节，力求帮助读者更好

地了解它以及它能够实现的效果。

1. fdt_getprop函数的定义和用法

fdt_getprop函数是一个Linux内核函数，它可以从树格式数据

结构中获取指定节点的指定属性值。它的定义如下：

int fdt_getprop(const void *fdt, int nodeoffset, const

char *name, void *buf, int buflen);

它接受五个参数：

（1）fdt是树格式数据结构的头指针；

（2）nodeoffset是指定节点在树格式数据结构中的偏移量；

（3）name是指定要获取属性值的属性名；

（4）buf是接收属性值内容的缓存空间；

（5）buflen是buf的空间大小。

fdt_getprop的执行结果是将指定节点的指定属性值内容复制到

buf中，它的返回值是属性值的实际长度，如果失败，则返回

-FDT_ERR_NOTFOUND（-5）。

2. fdt_getprop函数的实现原理

fdt_getprop函数是一个C函数，它是通过调用树格式数据结构

中的fdt_get_property函数来实现的。

- 1 -

fdt_get_property接受以下两个参数：

（1）fdt：树格式数据结构的头指针；

（2）nodeoffset：指定节点在树格式数据结构中的偏移量。

fdt_get_property函数首先会根据fdt和nodeoffset的参数来

获取指定节点的节点头，然后，会遍历该节点的所有属性，比较属性

名和name参数所指定的属性名是否相同，如果相同，则将该属性值

复制到buf中，并返回实际复制到buf中的属性值长度；如果不相同，

则继续遍历当前节点的其他属性；如果所有属性都没有找到，则返回

-FDT_ERR_NOTFOUND（-5），表示未找到指定的属性值。

3. fdt_getprop函数的典型应用场景

应用程序编程中，fdt_getprop函数的主要作用是实现系统设备

与树格式数据结构之间的双向通信。

比如，在系统启动过程中，Linux内核需要根据flattened device

tree（树格式数据结构）进行设备初始化，此时，内核会首先调用

fdt_getprop函数根据树格式数据结构获取指定节点的指定属性值，

然后根据获取到的属性值，来决定如何进行设备的初始化。

另外，fdt_getprop函数还可以被开发者用来编写各种设备驱动，

如PCI，USB，网络设备驱动，以及设备树设备驱动等，以支持任意

外设的正确加载和运行。

4. fdt_getprop函数的局限性

尽管fdt_getprop函数功能强大，但是它也有一些局限性，特别

是当要获取的属性值比较复杂时，它有可能会出现效率低下，因为它

- 2 -

只能按照节点来进行查找。

另外，frd_getprop函数只能读取可配置的属性值，不能读取扩

展的属性值，因此开发者在写设备驱动程序时，需要特别注意这一点。

5.论

以上就是本文关于fdt_getprop函数的详解，它是一个Linux内

核函数，它的功能是根据树格式数据结构获取指定节点的指定属性值，

它的实现原理是通过调用树格式数据结构中的fdt_get_property函

数来实现的，它可以帮助开发者实现系统设备与树格式数据结构之间

的双向通信，并可以用于开发设备驱动程序，但是它也有一定的局限

性，因此开发者在使用它时需要格外注意。

- 3 -