“Linux device tree”的版本间的差异
free6d1823（讨论 | 贡献） |
free6d1823（讨论 | 贡献） |
||
| 第175行： | 第175行： | ||
相关API: | 相关API: | ||
| − | resource *platform_get_resource(struct platform_device *, unsigned int type, unsigned int); | + | resource *platform_get_resource(struct platform_device *, unsigned int type, unsigned int order); |
取BASE address: | 取BASE address: | ||
| − | resource*res = platform_get_resource(pdev, IORESOURCE_MEM, 0); | + | resource*res = platform_get_resource(pdev, IORESOURCE_MEM, 0); //0= 第一个 MEM |
regs_addr = devm_ioremap_resource(&pdev->dev, res); | regs_addr = devm_ioremap_resource(&pdev->dev, res); | ||
struct resource { | struct resource { | ||
| 第186行： | 第186行： | ||
} | } | ||
flags;type;: | flags;type;: | ||
| − | #define IORESOURCE_MEM 0x00000200 | + | #define IORESOURCE_MEM 0x00000200 //register mem map |
#define IORESOURCE_REG 0x00000300 /* Register offsets */ | #define IORESOURCE_REG 0x00000300 /* Register offsets */ | ||
| − | #define IORESOURCE_IRQ 0x00000400 | + | #define IORESOURCE_IRQ 0x00000400 //IRQ number |
#define IORESOURCE_DMA 0x00000800 | #define IORESOURCE_DMA 0x00000800 | ||
#define IORESOURCE_BUS 0x00001000 | #define IORESOURCE_BUS 0x00001000 | ||
2020年7月18日 (六) 18:22的最后版本
- 1. Device tree structure in DTS
/{ node1{ property = <value>; node1_1{ }; }; node2{ }; };
propertyy value format:
(a) string: "A string"
(b) string list: "string1", "string2"
(c) binary: [0x01 0x02 0x03];
(d) uint32 array: <1 2 3 4>
predefined property:
- address-cells = <2>; 定义所有子节点的 reg address 的数目
- size-cells = <1>; 定义所有子节点的 reg size 的数目
此例: reg = < address0 address1 size0>
aliases node:
aliases {
alias_name = &real_name;
}
引用aliase: &alias_name
- 2. 解析设备树在函数unflatten_device_tree中完成，它将.dtb解析成device_node结构
Device tree maps to device_node
struct device_node { const char *name; phandle phandle; const char *full_name; struct fwnode_handle fwnode; struct property *properties; struct property *deadprops; /* removed properties */ 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; struct of_irq_controller *irq_trans; #endif }; struct property { char *name; int length; void *value; struct property *next; #if defined(CONFIG_OF_DYNAMIC) || defined(CONFIG_SPARC) unsigned long _flags; #endif #if defined(CONFIG_OF_PROMTREE) unsigned int unique_id; #endif #if defined(CONFIG_OF_KOBJ) struct bin_attribute attr; #endif };
- 3. OF的API接口
OF的接口函数在/drivers/of/目录下，有of_i2c.c、of_mdio.c、of_mtd.c、Adress.c等等
这里将列出几个常用的API接口。
1. 用来查找在dtb中的根节点
unsigned long __init of_get_flat_dt_root(void)
2. 根据deice_node结构的full_name参数，在全局链表of_allnodes中，查找合适的device_node
struct device_node *of_find_node_by_path(const char *path)
例如：
struct device_node *cpus;
cpus=of_find_node_by_path("/cpus");
3. 若from=NULL，则在全局链表of_allnodes中根据name查找合适的device_node
struct device_node *of_find_node_by_name(struct device_node *from,const char *name)
例如：
struct device_node *np;
np = of_find_node_by_name(NULL,"firewire");
4. 根据设备类型查找相应的device_node
struct device_node *of_find_node_by_type(struct device_node *from,const char *type)
例如：
struct device_node *tsi_pci;
tsi_pci= of_find_node_by_type(NULL,"pci");
5. 根据compatible字符串查找device_node
struct device_node *of_find_compatible_node(struct device_node *from,const char *type, const char *compatible)
6. 根据节点属性的name查找device_node
struct device_node *of_find_node_with_property(struct device_node *from,const char *prop_name)
7. 根据phandle查找device_node
struct device_node *of_find_node_by_phandle(phandle handle)
8. 根据alias的name获得设备id号
int of_alias_get_id(struct device_node *np, const char *stem)
9. device node计数增加/减少
struct device_node *of_node_get(struct device_node *node)
void of_node_put(struct device_node *node)
10. 根据property结构的name参数，在指定的device node中查找合适的property
struct property *of_find_property(const struct device_node *np,const char *name,int *lenp)
11. 根据property结构的name参数，返回该属性的属性值
const void *of_get_property(const struct device_node *np, const char *name,int *lenp)
12. 根据compat参数与device node的compatible匹配，返回匹配度
int of_device_is_compatible(const struct device_node *device,const char *compat)
13. 获得父节点的device node
struct device_node *of_get_parent(const struct device_node *node)
14. 将matches数组中of_device_id结构的name和type与device node的compatible和type匹配，返回匹配度最高的of_device_id结构
const struct of_device_id *of_match_node(const struct of_device_id *matches,const struct device_node *node)
15. 根据属性名propname，读出属性值中的第index个u32数值给out_value
int of_property_read_u32_index(const struct device_node *np,const char *propname,u32 index, u32 *out_value)
16. 根据属性名propname，读出该属性的数组中sz个属性值给out_values
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)
17. 根据属性名propname，读出该属性的u64属性值
int of_property_read_u64(const struct device_node *np, const char *propname,u64 *out_value)
18. 根据属性名propname，读出该属性的字符串属性值
int of_property_read_string(struct device_node *np, const char *propname,const char **out_string)
19. 根据属性名propname，读出该字符串属性值数组中的第index个字符串
int of_property_read_string_index(struct device_node *np, const char *propname,int index, const char **output)
20. 读取属性名propname中，字符串属性值的个数
int of_property_count_strings(struct device_node *np, const char *propname)
21. 读取该设备的第index个irq号
unsigned int irq_of_parse_and_map(struct device_node *dev, int index)
22. 读取该设备的第index个irq号，并填充一个irq资源结构体
int of_irq_to_resource(struct device_node *dev, int index, struct resource *r)
23. 获取该设备的irq个数
int of_irq_count(struct device_node *dev)
24. 获取设备寄存器地址，并填充寄存器资源结构体
int of_address_to_resource(struct device_node *dev, int index,struct resource *r)
const __be32 *of_get_address(struct device_node *dev, int index, u64 *size,unsigned int *flags)
25. 获取经过映射的寄存器虚拟地址
void __iomem *of_iomap(struct device_node *np, int index)
24. 根据device_node查找返回该设备对应的platform_device结构
struct platform_device *of_find_device_by_node(struct device_node *np)
25. 根据device node，bus id以及父节点创建该设备的platform_device结构
struct platform_device *of_device_alloc(struct device_node *np,const char *bus_id,struct device *parent)
static struct platform_device *of_platform_device_create_pdata(struct device_node *np,const char *bus_id,
void *platform_data,struct device *parent)
26. 遍历of_allnodes中的节点挂接到of_platform_bus_type总线上,由于此时of_platform_bus_type总线上还没有驱动,所以此时不进行匹配
int of_platform_bus_probe(struct device_node *root,const struct of_device_id *matches,struct device *parent)
相关API:
resource *platform_get_resource(struct platform_device *, unsigned int type, unsigned int order);
取BASE address:
resource*res = platform_get_resource(pdev, IORESOURCE_MEM, 0); //0= 第一个 MEM
regs_addr = devm_ioremap_resource(&pdev->dev, res);
struct resource {
start; //start address
end; //end address
flags;//resource type
}
flags;type;:
#define IORESOURCE_MEM 0x00000200 //register mem map
#define IORESOURCE_REG 0x00000300 /* Register offsets */
#define IORESOURCE_IRQ 0x00000400 //IRQ number
#define IORESOURCE_DMA 0x00000800
#define IORESOURCE_BUS 0x00001000
