设备树常用的其他 OF操作函数

凌肖战

已于 2024-01-18 23:34:21 修改

阅读量922

点赞数 21

分类专栏： Linux驱动学习文章标签： linux arm开发

于 2024-01-11 01:56:09 首次发布

本文链接：https://blog.csdn.net/wojiaxiaohuang2014/article/details/135516495

版权

Linux驱动学习专栏收录该内容

218 篇文章 28 订阅

订阅专栏

一. 简介

前面几篇学习了设备树常用的 OF操作函数，文章地址如下：

设备树常用 OF 操作函数说明一-CSDN博客

设备树常用 OF 操作函数说明二-CSDN博客

本文继续学习设备树常用的一些其他的 OF操作函数。

二. 设备树常用的其他 OF操作函数

下面学习设备树其他的 OF操作函数。

1. of_device_is_compatible 函数

of_device_is_compatible 函数用于查看节点的 compatible 属性是否有包含 compat 指定的字

符串，也就是检查设备节点的兼容性，函数原型如下：

int of_device_is_compatible(const struct device_node *device, const char *compat)

函数参数和返回值含义如下：

device ：设备节点。

compat ：要查看的字符串。

返回值： 0 ，节点的 compatible 属性中不包含 compat 指定的字符串；正数，节点的 compatible

属性中包含 compat 指定的字符串。

2. of_get_address 函数

of_get_address 函数用于获取地址相关属性，主要是“ reg ”或者“ assigned-addresses ”属性值，函数原型如下：

const __be32 *of_get_address(struct device_node *dev, 
int index, 
u64 *size,
 unsigned int *flags)

函数参数和返回值含义如下：

dev ：设备节点。

index ：要读取的地址标号。

size ：地址长度。

flags ：参数，比如 IORESOURCE_IO 、 IORESOURCE_MEM 等

返回值： 读取到的地址数据首地址，为 NULL 的话表示读取失败。

3. of_translate_address 函数

of_translate_address 函数负责将从设备树读取到的地址转换为物理地址，函数原型如下：

u64 of_translate_address(struct device_node *dev, const __be32 *in_addr)

函数参数和返回值含义如下：

dev ：设备节点。

in_addr ：要转换的地址。

返回值： 得到的物理地址，如果为 OF_BAD_ADDR 的话表示转换失败。

4. of_address_to_resource 函数

IIC 、 SPI 、 GPIO 等这些外设都有对应的寄存器，这些寄存器其实就是一组内存空间， Linux 内核使用 resource 结构体来描述一段内存空间，因此，用 resource 结构体描述的都是设备资源信息， resource 结构体定义在文件 include/linux/ioport.h 中，定义如下：

struct resource {
	resource_size_t start;
	resource_size_t end;
	const char *name;
	unsigned long flags;
	struct resource *parent, *sibling, *child;
};

对于 32 位的 SOC 来说， resource_size_t 是 u32 类型的。其中 start 表示开始地址， end 表示结束地址， name 是这个资源的名字， flags 是资源标志位，一般表示资源类型，可选的资源标志定义在文件 include/linux/ioport.h 中。

大家一般最常见的资源标志就是 IORESOURCE_MEM 、 IORESOURCE_REG 和

IORESOURCE_IRQ 等。接下来我们回到 of_address_to_resource 函数，此函数看名字像是从设备树里面提取资源值，但是本质上就是将 reg 属性值，然后将其转换为 resource 结构体类型，函数原型如下所示：

int of_address_to_resource(struct device_node *dev, 
 int index,
 struct resource *r)

函数参数和返回值含义如下：

dev ：设备节点。

index ：地址资源标号。

r ：得到的 resource 类型的资源值。

返回值： 0 ，成功；负值，失败。

三. 总结

关于设备树常用的 OF 函数就先讲解到这里， Linux 内核中关于设备树的 OF 函数不仅仅只有前面讲的这几个，还有很多 OF 函数我们并没有讲解，这些没有讲解的 OF 函数要结合具体的驱动，例如，获取中断号的 OF 函数、获取 GPIO 的 OF 函数等等，这些 OF 函数我们在后面的驱动实验中再详细的讲解。