添加设备树节点，驱动读取设备树信息

添加设备树节点，驱动读取设备树信息

1、设备树常用 OF 操作函数
①查找节点的 OF 函数
设备都是以节点的形式“挂”到设备树上的，因此要想获取这个设备的其他属性信息，必须先获取到这个设备的节点。Linux 内核使用 device_node 结构体来描述一个节点。

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;
}

->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);

->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)

->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)

->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)

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

inline struct device_node *of_find_node_by_path(const char *path)

②查找父/子节点的 OF 函数
->of_get_parent 函数
of_get_parent 函数用于获取指定节点的父节点(如果有父节点的话)，函数原型如下：

struct device_node *of_get_parent(const struct device_node *node)

->of_get_next_child 函数
of_get_next_child 函数用迭代的查找子节点，函数原型如下:

struct device_node *of_get_next_child(const struct device_node *node, struct device_node *prev)

③ 提取属性值的 OF 函数
节点的属性信息里面保存了驱动所需要的内容，因此对于属性值的提取非常重要，Linux 内核中使用结构体 property 表示属性，此结构体同样定义在文件 include/linux/of.h 中，内容如下：

struct property {
	char *name; /* 属性名字 */
	int length; /* 属性长度 */
	void *value; /* 属性值 */
	struct property *next; /* 下一个属性 */
	unsigned long _flags;
	unsigned int unique_id;
	struct bin_attribute attr;
};

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

property *of_find_property(const struct device_node *np, const char *name, int *lenp)

->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)

->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)

-> 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_u8_array(const struct device_node *np,const char *propname, u8 *out_values, size_t sz)
int of_property_read_u16_array(const struct device_node *np, const char *propname,  u16 *out_values,  size_t sz)
int of_property_read_u32_array(const struct device_node *np, const char *propname,  u32 *out_values, size_t sz)
int of_property_read_u64_array(const struct device_node *np, const char *propname,  u64 *out_values, size_t sz)

->of_property_read_u8 函数
of_property_read_u16 函数
of_property_read_u32 函数
of_property_read_u64 函数
有些属性只有一个整形值，这四个函数就是用于读取这种只有一个整形值的属性,分别用于读取 u8、u16、u32 和 u64 类型属性值

->of_property_read_string 函数
of_property_read_string 函数用于读取属性中字符串值

->of_n_addr_cells 函数
of_n_addr_cells 函数用于获取#address-cells 属性值

->of_n_size_cells 函数
of_size_cells 函数用于获取#size-cells 属性值

④其他常用的 OF 函数
->of_device_is_compatible 函数
of_device_is_compatible 函数用于查看节点的 compatible 属性是否有包含 compat 指定的字符串，也就是检查设备节点的兼容性。

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

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

->of_translate_address 函数
of_translate_address 函数负责将从设备树读取到的地址转换为物理地址

->of_address_to_resource 函数

->of_iomap 函数
of_iomap 函数用于直接内存映射

2、 修改设备树文件，添加设备树节点

	在根节点“/”下创建一个名为“alphaled”的子节点。

alphaled {
		#address-cells = <1>;
		#size-cells = <1>;
 		compatible = "atkalpha-led"; 
		status = "okay";
		reg = < 0X020C406C 0X04 /* CCM_CCGR1_BASE */
				 0X020E0068 0X04 /* SW_MUX_GPIO1_IO03_BASE */
				 0X020E02F4 0X04 /* SW_PAD_GPIO1_IO03_BASE */
				 0X0209C000 0X04 /* GPIO1_DR_BASE */
				 0X0209C004 0X04 >; /* GPIO1_GDIR_BASE */
 };

3、获取设备树中的属性数据
①获取设备节点：alphaled

dtsled.nd = of_find_node_by_path("/alphaled");
if(dtsled.nd == NULL) {
	 printk("alphaled node can not found!\r\n");
	 return -EINVAL;
 } 
 else {
 	 printk("alphaled node has been found!\r\n");
 }

②获取 compatible 属性内容

proper = of_find_property(dtsled.nd, "compatible", NULL);
if(proper == NULL) {
	printk("compatible property find failed\r\n");
} 
else {
	printk("compatible = %s\r\n", (char*)proper->value);
}

③获取status属性

ret = of_property_read_string(dtsled.nd, "status", &str);
if(ret < 0){
	printk("status read failed!\r\n");
} 
else {
	printk("status = %s\r\n",str);
}

④获取 reg 属性内容

ret = of_property_read_u32_array(dtsled.nd, "reg", regdata, 10);