深圳网站推广优化,从哪里下载wordpress,wordpress出现的常见问题,东莞网络推广服务平台前言#xff1a; 设备树描述了设备的详细信息#xff0c;这些信息包括数字类型的、字符串类型的、数组类型的#xff0c; 我们在编写驱动的时候需要获取到这些信息。Linux 内核给我们提供了一系列的函数来获取设备树中的节点或者属性信息#xff0c;这一系列的函数都有一个…前言 设备树描述了设备的详细信息这些信息包括数字类型的、字符串类型的、数组类型的 我们在编写驱动的时候需要获取到这些信息。Linux 内核给我们提供了一系列的函数来获取设备树中的节点或者属性信息这一系列的函数都有一个统一的前缀“of_”所以在很多资 料里面也被叫做 OF 函数。这些 OF 函数原型都定义在 include/linux/of.h 文件中。 一、查找节点的 OF 函数 设备都是以节点的形式“挂”到设备树上的因此要想获取这个设备的其他属性信息必 须先获取到这个设备的节点。Linux 内核使用 device_node 结构体来描述一个节点此结构体定 义在文件 include/linux/of.h 中定义如下
struct device_node
{const char *name; /* 节点名字 */const char *type; /* 设备类型 */phandle phandle;const char *full_name; /* 节点全名 */struct fwnode_handle fwnode;struct property *properties; /* 属性 */struct property *deadprops; /* removed 属性 */struct device_node *parent; /* 父节点 */struct device_node *child; /* 子节点 */struct device_node *sibling; struct kobject kobj;unsigned long _flags;void *data;#if defined(CONFIG_SPARC) const char *path_component_name; unsigned int unique_id; struct of_irq_controller *irq_trans;#endif
};
与查找节点有关的 OF 函数有 5 个我们依次来看一下。 1.of_find_node_by_name 函数 of_find_node_by_name 函数通过节点名字查找指定的节点函数原型如下
struct device_node *of_find_node_by_name(struct device_node *from,
const char *name); 函数参数和返回值含义如下 from开始查找的节点如果为 NULL 表示从根节点开始查找整个设备树。name要查找的节点名字。返回值找到的节点如果为 NULL 表示查找失败。 2.of_find_node_by_type 函数 of_find_node_by_type 函数通过 device_type 属性查找指定的节点函数原型如下
struct device_node *of_find_node_by_type(struct device_node *from, const char *type)
参数和返回值 from开始查找的节点如果为 NULL 表示从根节点开始查找整个设备树。type要查找的节点对应的 type 字符串也就是 device_type 属性值。返回值找到的节点如果为 NULL 表示查找失败。 3.of_find_compatible_node 函数
of_find_compatible_node 函数根据 device_type 和 compatible 这两个属性查找指定的节点 函数原型如下
struct device_node *of_find_compatible_node(struct device_node *from, const char *type, const char *compatible) 函数参数和返回值含义如下 from开始查找的节点如果为 NULL 表示从根节点开始查找整个设备树。type要查找的节点对应的 type 字符串也就是 device_type 属性值可以为 NULL表示 忽略掉 device_type 属性。compatible要查找的节点所对应的 compatible 属性列表。返回值找到的节点如果为 NULL 表示查找失败 4.of_find_matching_node_and_match函数
of_find_matching_node_and_match 函数通过 of_device_id 匹配表来查找指定的节点函数原 型如下
struct device_node *of_find_matching_node_and_match(struct device_node *from, const struct of_device_id *matches, const struct of_device_id **match) 函数参数和返回值含义如下 from开始查找的节点如果为 NULL 表示从根节点开始查找整个设备树。matchesof_device_id 匹配表也就是在此匹配表里面查找节点。match找到的匹配的 of_device_id。返回值找到的节点如果为 NULL 表示查找失败 5.of_find_node_by_path 函数
of_find_node_by_path 函数通过路径来查找指定的节点函数原型如下
inline struct device_node *of_find_node_by_path(const char *path) 函数参数和返回值含义如下 path带有全路径的节点名可以使用节点的别名比如“/backlight”就是 backlight 这个 节点的全路径。返回值找到的节点如果为 NULL 表示查找失败 二、查找父/子节点的 OF 函数
1、of_get_next_child 函数
of_get_next_child 函数用迭代的方式查找子节点函数原型如下
struct device_node *of_get_next_child(const struct device_node *node, struct device_node *prev)
函数参数和返回值含义如下 node父节点。prev前一个子节点也就是从哪一个子节点开始迭代的查找下一个子节点。可以设置为NULL表示从第一个子节点开始。返回值找到的下一个子节点 2、of_get_parent 函数
of_get_parent 函数用于获取指定节点的父节点(如果有父节点的话)函数原型如下
struct device_node *of_get_parent(const struct device_node *node)
函数参数和返回值含义如下 node要查找的父节点的节点。返回值找到的父节点。 三、提取属性值的 OF 函数
保存属性信息的结构体 节点的属性信息里面保存了驱动所需要的内容因此对于属性值的提取非常重要Linux 内 核中使用结构体 property 表示属性。
struct property { char *name; /* 属性名字 */ int length; /* 属性长度 */ void *value; /* 属性值 */ struct property *next; /* 下一个属性 */ unsigned long _flags; unsigned int unique_id; struct bin_attribute attr; }; 1.of_find_property 函数。
of_find_property 函数用于查找指定的属性函数原型如下
property *of_find_property(const struct device_node *np, const char *name, int *lenp) 函数参数和返回值含义如下 np设备节点。name 属性名字。lenp属性值的字节数返回值找到的属性。 2.of_property_count_elems_of_size 函数
of_property_count_elems_of_size 函数用于获取属性中元素的数量比如 reg 属性值是一个 数组那么使用此函数可以获取到这个数组的大小此函数原型如下
int of_property_count_elems_of_size(const struct device_node *np, const char *propname, int elem_size) 函数参数和返回值含义如下 np设备节点。proname 需要统计元素数量的属性名字。elem_size元素长度。返回值得到的属性元素数量。 3.of_property_read_u32_index 函数。
of_property_read_u32_index 函数用于从属性中获取指定标号的 u32 类型数据值(无符号 32
位)比如某个属性有多个 u32 类型的值那么就可以使用此函数来获取指定标号的数据值
此函数原型如下
int of_property_read_u32_index(const struct device_node *np, const char *propname, u32 index, u32 *out_value) 函数参数和返回值含义如下 np设备节点。proname 要读取的属性名字。index要读取的值标号。out_value读取到的值返回值0 读取成功负值读取失败-EINVAL 表示属性不存在-ENODATA 表示没有 要读取的数据-EOVERFLOW 表示属性值列表太小。 4.of_property_read_u32_array 函数
这个函数是用来读取属性中32类型的数组数据
和他类似的还有三个函数分别是 of_property_read_u8_array 函数of_property_read_u16_array 函数of_property_read_u32_array 函数of_property_read_u64_array 函数 这 4 个函数分别是读取属性中 u8、u16、u32 和 u64 类型的数组数据比如大多数的 reg 属 性都是数组数据可以使用这 4 个函数一次读取出 reg 属性中的所有数据。这四个函数的原型大差不差这里我就挑一个出来分析就好
int of_property_read_u32(const struct device_node *np, const char *propname, u32 *out_value) 函数参数和返回值含义如下 np设备节点。proname 要读取的属性名字。out_value读取到的数组值。返回值0读取成功负值读取失败-EINVAL 表示属性不存在-ENODATA 表示没 有要读取的数据-EOVERFLOW 表示属性值列表太小。 5.of_property_read_u32 函数
有些属性只有一个整形值这个函数就是用于读取这种只有一个整形值的属性用于读取u32 类型属性值同样的也可以读取 u8、u16和 u64 类型属性值。 of_property_read_u8 函数of_property_read_u16 函数of_property_read_u32 函数of_property_read_u64 函数 函数原型如下
int of_property_read_u32(const struct device_node *np, const char *propname, u32 *out_value)
函数参数和返回值含义如下 np设备节点。 proname 要读取的属性名字。out_value读取到的数组值。返回值0读取成功负值读取失败-EINVAL 表示属性不存在-ENODATA 表示没 有要读取的数据-EOVERFLOW 表示属性值列表太小。 6.of_property_read_string 函数
of_property_read_string 函数用于读取属性中字符串值函数原型如下
int of_property_read_string(struct device_node *np, const char *propname, const char **out_string) 函数参数和返回值含义如下 np设备节点。proname 要读取的属性名字。out_string读取到的字符串值。返回值0读取成功负值读取失败。 7.of_n_addr_cells 函数
of_n_addr_cells 函数用于获取#address-cells 属性值函数原型如下
int of_n_addr_cells(struct device_node *np) 函数参数和返回值含义如下np设备节点。返回值获取到的#address-cells 属性值。 8.of_n_size_cells 函数
of_size_cells 函数用于获取#size-cells 属性值函数原型如下
int of_n_size_cells(struct device_node *np)
函数参数和返回值含义如下 np设备节点。返回值获取到的#size-cells 属性值。 四、 其他常用的 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 函数
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成功负值失败。 5、of_iomap 函数
of_iomap 函数本 质上也是将 reg 属性中地址信息转换为虚拟地址如果 reg 属性有多段的话可以通过 index 参 数指定要完成内存映射的是哪一段of_iomap 函数原型如下
void __iomem *of_iomap(struct device_node *np, int index) 函数参数和返回值含义如下 np设备节点。indexreg 属性中要完成内存映射的段如果 reg 属性只有一段的话 index 就设置为 0。返回值经过内存映射后的虚拟内存首地址如果为 NULL 的话表示内存映射失败。
