3.3.5. 设备树操作常用API
内核中用下面这个结构描述设备树中的一个节点，后面的API都需要一个device_node对象作为参数传入。
struct device_node {
const char *name;
phandle phandle;
const char *full_name;
struct fwnode_handle fwnode;
struct property *properties;
struct property *deadprops;
struct device_node *parent;
struct device_node *child;
struct device_node *sibling;
#if defined(CONFIG_OF_KOBJ)
struct kobject kobj;
#endif
unsigned long _flags;
void *data;
#if defined(CONFIG_SPARC)
unsigned int unique_id;
strcut of_ifq_controller *irq_trans;
#endif
};
- struct device_node
–>节点名 –>设备类型 –>全路径节点名 –>父节点指针 –>子节点指针
查找节点API
/*
bref 通过compatible属性查找指定节点
from 指向开始路径的节点，如果为NULL，则从根节点开始
type device_type设备类型，可以为NULL
compat 指向 节点的compatible属性值(字符串)的首地址
成功：得到节点的首地址 失败：NULL
*/
struct device_node *of_find_compatible_node(struct device_node *from, const char *type, const char *compat);
/*
bref 通过compatible属性查找指定节点
from------
matches 指向设备ID表，注意ID表必须以NULL结束
例如
const struct of_device_id mydemo_of_match[] = {
{.compatible = "fs4412,mydemo"},
{}
};
*/
struct device_node *of_find_matching_node(struct device_node *from, const struct of_device_id *matches);
//全路径查找指定节点
struct device_node *of_find_node_by_path(const char *path);
//通过节点名查找指定节点
struct device_node *of_find_node_by_name(struct device_node *from, const char *name);
提取通用属性API
/*
提取属性的值
np 设备节点指针
name 属性名称
lenp属性值字节数
成功：属性值首地址 失败：NULL
*/
struct property *of_find_property(cosnt struct device_node *np, const char *name, int *lenp);
/*
得到属性值中数据的数量
np 设备节点指针
propername 属性名称
elem_size 每个数据的单位
成功：属性值的数据个数 失败：负数
*/
int of_property_count_elems_of_size(const struct device_node *np, const char *propname, int elem_size);
/*
得到属性值中指定标号的32位数据值
np 设备节点指针
propname 属性值中指定数据的标号
out_value 输出参数，得到指定数据的值
成功：0 失败：负数
*/
int of_property_read_u32_index(const struct device_node *np, cosnt char *propname, u32 index, u32 *out_value);
/*
提取字符串(属性值)
np 设备节点指针
propname 属性名称
out_string 输出参数，指向字符串(属性值)
成功：0 失败：负数
*/
int of_propery_read_string(struct device_node *np, cosnt char *propname, const char **out_string);
提取addr属性API
/*
提取默认属性"#address-cells"的值
np 设备节点指针
成功：地址的数量 失败：负值
*/
int of_n_addr_cells(strcut device_node *np);
//提取"#size-cells"的值
int of_n_size_cell(struct device_node *np);
/*
提取I/O口地址
np 设备节点指针
index 地址标号
size 输出参数,I/O地址的长度
flags 输出参数，类型(IORESOURCE——IO，IORESOURCE_MEM)
成功：I/O地址的首地址，失败：NULL
*/
__be32 *of_get_address(struct device_node *np, int index, u64 *size, unsigned int *flags);
/*
从设备树中提取I/O地址转换成物理地址
np 设备节点指针
in_addr 设备树提取的I/O地址
成功：物理地址 失败：OF_BAD_ADDR
*/
u64 of_translate_address(strcut device_node *np, cosnt __be32 *in_addr);
/*
提取I/O地址并映射成虚拟地址
np-----
index I/O地址的标号
成功：映射好的虚拟地址，失败：NULL
*/
void __iomem *of_iomap(struct device_node *np, int index);
/*
提取I/O地址并申请I/O资源及映射成虚拟地址
np--
index--
name 设备名，申请I/O地址时使用
成功：映射好虚拟地址，失败：NULL
*/
void __iomem *of_io_request_and_map(strcut device_node *np, int index, const char *name);
提取resource属性API
/*
从设备树中提取资源resource(I/O地址)
np 设备节点指针
index I/O 地址资源的标号
r 输出参数，指向资源resource
成功：0 失败：负数
*/
int of_address_to_resource(strcut device_node *np, int index, struct resource *r);
提取GPIO属性API
/*
从设备树中提取GPIO口
np---
propname---
index gpio口引脚标号
成功：得到GPIO口编号 失败：负数
*/
int of_get_named_gpio(struct device_node *np, const char *propname, int index);
提取irq属性API
/*
从设备树中提取中断号
np---
index 要提取的中断号标号
成功：中断号 失败：负数
*/
int of_irq_count(struct device_node *np);
提取MAC属性
void of_get_mac_address(struct device_node *np);
3.3.5.1. 驱动调用示例
int iic_probe(struct i2c_client *clent, const struct i2c_device_id *id)
{
struct device dev;
char *string;
unsigned int mint;
dev = client->dev;
of_property_read_string(dev.of_node, "string_test", &string);
of_property_read_u32(dev.of_name, "mint", &mint);
return 0;
}