of_find_node_by_type

通过 device_type 属性查找指定的节点，函数原型如下：

structdevice_node*of_find_node_by_type(structdevice_node*from,constchar*type);

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

(资料图片)

of_find_compatible_node

根据 device_type 和 compatible 这两个属性查找指定的节点，函数原型如下：

structdevice_node*of_find_compatible_node(structdevice_node*from,constchar*type,constchar*compatible);

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

from：开始查找的节点，如果为 NULL 表示从根节点开始查找整个设备树。

type：要查找的节点对应的 type 字符串，也就是 device_type 属性值，可以为 NULL，表示忽略掉 device_type 属性。

compatible：要查找的节点所对应的 compatible 属性列表。

返回值：找到的节点，如果为 NULL 表示查找失败

of_find_matching_node_and_match

通过 of_device_id 匹配表来查找指定的节点，函数原型如下：

structdevice_node*of_find_matching_node_and_match(structdevice_node*from,conststructof_device_id*matches,conststructof_device_id`match);

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

of_find_node_by_path

过路径来查找指定的节点，函数原型如下：

inlinestructdevice_node*of_find_node_by_path(constchar*path);

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

查找父子节点的函数

of_get_parent

用于获取指定节点的父节点，原型如下：

structdevice_node*of_get_parent(conststructdevice_node*node);

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

of_get_next_child

用迭代的查找子节点，函数原型如下：

structdevice_node*of_get_next_child(conststructdevice_node*node,structdevice_node*prev);

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

提取属性的of函数

of_find_property

用于查找指定的属性，函数原型如下：

property*of_find_property(conststructdevice_node*np,constchar*name,int*lenp);

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

返回值：找到的属性。

of_property_count_elems_of_size

用于获取属性中元素的数量，比如 reg 属性值是一个数组，那么使用此函数可以获取到这个数组的大小，此函数原型如下：

intof_property_count_elems_of_size(conststructdevice_node*np,constchar*propname,intelem_size);

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

返回值：得到的属性元素数量。

of_property_read_u8_array

从属性中查找并读取 u8 数组，此函数原型如下：

intof_property_read_u8_array(conststructdevice_node*np,constchar*propname,u8*out_values,size_tsz)

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

返回值：0 读取成功，负值，读取失败， -EINVAL 表示属性不存在。-ENODATA 表示没有要读取的数据， -EOVERFLOW 表示属性值列表太小。

of_property_read_u8

读取 u8类型属性值，函数原型如下：

intof_property_read_u8(conststructdevice_node*np,constchar*propname,u8*out_value)

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

返回值：0，读取成功，负值，读取失败， -EINVAL 表示属性不存在， -ENODATA 表示没有要读取的数据， -EOVERFLOW 表示属性值列表太小。

of_property_read_string

用于读取属性中字符串值，函数原型如下：

intof_property_read_string(structdevice_node*np,constchar*propname,constchar`out_string);

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

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

of_n_addr_cells

用于获取 #address-cells属性值，函数原型如下：

intof_n_addr_cells(structdevice_node*np);

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

of_n_size_cells

用于获取 #size-cells属性值，函数原型如下：

intof_n_size_cells(structdevice_node*np);

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

返回值：获取到的#size-cells 属性值。

其他常用of函数

of_get_address

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

const__be32*of_get_address(structdevice_node*dev,intindex,u64*size,unsignedint*flags);

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

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

of_translate_address

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

u64of_translate_address(structdevice_node*dev,const__be32*in_addr);

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

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

of_address_to_resource

从设备树里面提取资源值，但是本质上就是将 reg 属性值，然后将其转换为 resource 结构体类型，函数原型如下所示：

intof_address_to_resource(structdevice_node*dev,intindex,structresource*r);

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

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

of_iomap

用于直接内存映射，以前我们会通过 ioremap来完成物理地址到虚拟地址的映射，采用设备树以后就可以直接通过 of_iomap来获取内存地址所对应的虚拟地址，不需要使用 ioremap了。该函数的原型如下：

void__iomem*of_iomap(structdevice_node*np,intindex);

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

二、GPIO相关

GPIO子系统相关函数

gpio_request

申请一个GPIO

intgpio_request(unsignedgpio,constchar*label)

gpio：管脚号；

label：管脚名，可以为空（NULL）

返回值：成功返回0，失败返回错误码

gpio_free

释放注册的GPIO

voidgpio_free(unsignedgpio)

gpio：管脚号

gpio_direction_input

设置GPIO为输入，函数原型如下：

intgpio_direction_input(unsignedgpio)

gpio：管脚号

返回值：成功返回0，失败返回错误码

gpio_get_value

获取GPIO输入值，函数原型如下：

intgpio_get_value(unsignedgpio)

gpio：管脚号

返回值：0或1

gpio_set_value

设置GPIO控制值，函数原型如下：

voidgpio_set_value(unsignedgpio,intvalue)

gpio：管脚号；

value：控制值，0或1

与GPIO相关的of函数

of_gpio_named_count

用于获取设备树某个属性里面定义了几个 GPIO 信息，函数原型如下：

intof_gpio_named_count(structdevice_node*np,constchar*propname)

np：设备节点

propname：要统计的gpio属性

返回值：正确返回统计的gpio数量，错误返回负数

of_gpio_count

用于统计gpios 这个属性的 GPIO 数量，函数原型如下：

intof_gpio_count(structdevice_node*np)

np：设备节点

返回值：正确返回统计的gpio数量，错误返回负数

of_get_named_gpio

用于获取 GPIO 编号，函数原型如下：

intof_get_named_gpio(structdevice_node*np,constchar*propname,intindex)

np：设备节点

propname：包含要获取 GPIO 信息的属性名

index：GPIO 索引

返回值：正确返回获取到的GPIO编号，错误返回负数

三、devm相关

clock

devm_clk_get

用于获取时钟源，函数原型如下：

structclk*devm_clk_get(structdevice*dev,constchar*id);

dev：device设备

id：时钟源名字，可以为NULL

返回值：正确返回struct clk指针，错误返回NULL

devm_clk_put

用于释放时钟源，函数原型如下：

voiddevm_clk_put(structdevice*dev,structclk*clk);

dev：device设备

id：时钟源名字

iomap

devm_ioremap_resource

先申请，后映射物理内存，函数原型如下：

void__iomem*devm_ioremap_resource(structdevice*dev,conststructresource*res);

dev：device设备

res：resource资源

返回值：成功返回虚拟地址指针，识别返回错误码

devm_iounmap

释放之前映射的地址，函数原型如下：

voiddevm_iounmap(structdevice*dev,void__iomem*addr);

dev：device设备

addr：要释放的虚拟地址

irq

devm_request_irq

用于注册中断服务函数，函数原型如下：

intdevm_request_irq(structdevice*dev,unsignedintirq,irq_handle_thandle,unsignedintflags,constchar*name,void*dev_id);

dev：device设备

irq：中断号，可以通过platform_get_irq获得

handle：中断处理函数

flags：中断触发方式，上升沿/下降沿等

name：中断名称

dev_id：中断共享时用到，一般设置为结构体或NULL

devm_free_irq

用于释放devm_request_irq注册的中断，函数原型如下：

voiddevm_free_irq(structdevice*dev,unsignedintirq,void*dev_id)

dev：device设备

irq：中断号，与devm_request_irq注册的对应

dev_id：与devm_request_irq注册的对应

mem

devm_kmalloc

分配的内存物理上连续（虚拟上也连续），只能在低端内存分配（直接内存映射区），函数原型如下：

void*kmalloc(size_tsize,gfp_tgfp)；

size：分配的大小

gfp：申请内存的类型标志

devm_kzalloc

与devm_kmalloc类似，只不过devm_kzalloc会对申请到的内存内容清零，函数原型如下：

void*devm_kzalloc(structdevice*dev,size_tsize,gfp_tgfp);

dev：device设备

size：申请内存的大小

gfp：申请内存的类型标志

devm_kfree

devm_kmalloc()和devm_kzalloc()申请的内存必须调用devm_kfree()释放，函数原型如下：

voiddevm_kfree(structdevice*dev,void*p);

dev：device设备

p：内存指针

pinctrl

devm_pinctrl_get

用于获取pin操作句柄，函数原型如下：

structpinctrl*devm_pinctrl_get(structdevice*dev);

dev：device设备

返回值：pinctrl句柄

devm_pinctrl_put

用于释放pin操作句柄，函数原型如下：

voiddevm_pinctrl_put(structpinctrl*p);

p：pinctrl句柄

来源：嵌入式Linux充电站

版权归原作者所有，如有侵权，请联系删除。

▍

标签：