]>
git.proxmox.com Git - mirror_qemu.git/blob - include/sysemu/device_tree.h
2 * Header with function prototypes to help device tree manipulation using
3 * libfdt. It also provides functions to read entries from device tree proc
6 * Copyright 2008 IBM Corporation.
7 * Authors: Jerone Young <jyoung5@us.ibm.com>
8 * Hollis Blanchard <hollisb@us.ibm.com>
10 * This work is licensed under the GNU GPL license version 2 or later.
14 #ifndef __DEVICE_TREE_H__
15 #define __DEVICE_TREE_H__
17 void *create_device_tree(int *sizep
);
18 void *load_device_tree(const char *filename_path
, int *sizep
);
21 * load_device_tree_from_sysfs: reads the device tree information in the
22 * /proc/device-tree directory and return the corresponding binary blob
23 * buffer pointer. Asserts in case of error.
25 void *load_device_tree_from_sysfs(void);
29 * qemu_fdt_node_path: return the paths of nodes matching a given
30 * name and compat string
31 * @fdt: pointer to the dt blob
33 * @compat: compatibility string
34 * @errp: handle to an error object
36 * returns a newly allocated NULL-terminated array of node paths.
37 * Use g_strfreev() to free it. If one or more nodes were found, the
38 * array contains the path of each node and the last element equals to
39 * NULL. If there is no error but no matching node was found, the
40 * returned array contains a single element equal to NULL. If an error
41 * was encountered when parsing the blob, the function returns NULL
43 char **qemu_fdt_node_path(void *fdt
, const char *name
, char *compat
,
46 int qemu_fdt_setprop(void *fdt
, const char *node_path
,
47 const char *property
, const void *val
, int size
);
48 int qemu_fdt_setprop_cell(void *fdt
, const char *node_path
,
49 const char *property
, uint32_t val
);
50 int qemu_fdt_setprop_u64(void *fdt
, const char *node_path
,
51 const char *property
, uint64_t val
);
52 int qemu_fdt_setprop_string(void *fdt
, const char *node_path
,
53 const char *property
, const char *string
);
54 int qemu_fdt_setprop_phandle(void *fdt
, const char *node_path
,
56 const char *target_node_path
);
57 const void *qemu_fdt_getprop(void *fdt
, const char *node_path
,
58 const char *property
, int *lenp
);
59 uint32_t qemu_fdt_getprop_cell(void *fdt
, const char *node_path
,
60 const char *property
);
61 uint32_t qemu_fdt_get_phandle(void *fdt
, const char *path
);
62 uint32_t qemu_fdt_alloc_phandle(void *fdt
);
63 int qemu_fdt_nop_node(void *fdt
, const char *node_path
);
64 int qemu_fdt_add_subnode(void *fdt
, const char *name
);
66 #define qemu_fdt_setprop_cells(fdt, node_path, property, ...) \
68 uint32_t qdt_tmp[] = { __VA_ARGS__ }; \
71 for (i = 0; i < ARRAY_SIZE(qdt_tmp); i++) { \
72 qdt_tmp[i] = cpu_to_be32(qdt_tmp[i]); \
74 qemu_fdt_setprop(fdt, node_path, property, qdt_tmp, \
78 void qemu_fdt_dumpdtb(void *fdt
, int size
);
81 * qemu_fdt_setprop_sized_cells_from_array:
82 * @fdt: device tree blob
83 * @node_path: node to set property on
84 * @property: property to set
85 * @numvalues: number of values
86 * @values: array of number-of-cells, value pairs
88 * Set the specified property on the specified node in the device tree
89 * to be an array of cells. The values of the cells are specified via
90 * the values list, which alternates between "number of cells used by
91 * this value" and "value".
92 * number-of-cells must be either 1 or 2 (other values will result in
93 * an error being returned). If a value is too large to fit in the
94 * number of cells specified for it, an error is returned.
96 * This function is useful because device tree nodes often have cell arrays
97 * which are either lists of addresses or lists of address,size tuples, but
98 * the number of cells used for each element vary depending on the
99 * #address-cells and #size-cells properties of their parent node.
100 * If you know all your cell elements are one cell wide you can use the
101 * simpler qemu_fdt_setprop_cells(). If you're not setting up the
102 * array programmatically, qemu_fdt_setprop_sized_cells may be more
105 * Return value: 0 on success, <0 on error.
107 int qemu_fdt_setprop_sized_cells_from_array(void *fdt
,
108 const char *node_path
,
109 const char *property
,
114 * qemu_fdt_setprop_sized_cells:
115 * @fdt: device tree blob
116 * @node_path: node to set property on
117 * @property: property to set
118 * @...: list of number-of-cells, value pairs
120 * Set the specified property on the specified node in the device tree
121 * to be an array of cells. The values of the cells are specified via
122 * the variable arguments, which alternates between "number of cells
123 * used by this value" and "value".
125 * This is a convenience wrapper for the function
126 * qemu_fdt_setprop_sized_cells_from_array().
128 * Return value: 0 on success, <0 on error.
130 #define qemu_fdt_setprop_sized_cells(fdt, node_path, property, ...) \
132 uint64_t qdt_tmp[] = { __VA_ARGS__ }; \
133 qemu_fdt_setprop_sized_cells_from_array(fdt, node_path, \
135 ARRAY_SIZE(qdt_tmp) / 2, \
139 #define FDT_PCI_RANGE_RELOCATABLE 0x80000000
140 #define FDT_PCI_RANGE_PREFETCHABLE 0x40000000
141 #define FDT_PCI_RANGE_ALIASED 0x20000000
142 #define FDT_PCI_RANGE_TYPE_MASK 0x03000000
143 #define FDT_PCI_RANGE_MMIO_64BIT 0x03000000
144 #define FDT_PCI_RANGE_MMIO 0x02000000
145 #define FDT_PCI_RANGE_IOPORT 0x01000000
146 #define FDT_PCI_RANGE_CONFIG 0x00000000
148 #endif /* __DEVICE_TREE_H__ */