kvm-unit-tests/lib/devicetree.h

4  * devicetree builds on libfdt to implement abstractions and accessors
7  * Documentation/devicetree/booting-without-of.txt
14 #include "libfdt/libfdt.h"
17  * devicetree init and libfdt helpers
32 	     s != -FDT_ERR_NOTFOUND;					\
52 	 * match a device @dev to an fdt node @fdtnode
54 	 *  - a positive value on match
55 	 *  - zero on no match
56 	 *  - a negative FDT_ERR_* value on failure
58 	int (*match)(const struct dt_device *dev, int fdtnode);
62 	 * @dev's fdt node's "reg" property, and store the result
65 	 *  - zero on success
66 	 *  - a negative FDT_ERR_* value on failure
68 	int (*translate)(const struct dt_device *dev, int regidx, void *reg);
72 extern int dt_bus_match_any(const struct dt_device *dev, int fdtnode);
92  * processor bus using the parent node's #address-cells
93  * and #size-cells and dt_pbus_read_cells()
95  *  - zero on success
96  *  - a negative FDT_ERR_* value on failure
98 extern int dt_pbus_translate(const struct dt_device *dev, int regidx,
110  *     dt_pbus_translate(dev, 0, base)
112  *  - zero on success
113  *  - a negative FDT_ERR_* value on failure
115 static inline int dt_pbus_get_base(const struct dt_device *dev,  in dt_pbus_get_base()  argument
118 	return dt_pbus_translate(dev, 0, base);  in dt_pbus_get_base()
123  *  match		<- dt_bus_match_any
124  *  translate		<- dt_pbus_translate
131 extern void dt_device_init(struct dt_device *dev, const struct dt_bus *bus,
134 static inline void dt_device_bind_node(struct dt_device *dev, int fdtnode)  in dt_device_bind_node()  argument
136 	dev->fdtnode = fdtnode;  in dt_device_bind_node()
142  *  - node (>= 0) on success
143  *  - a negative FDT_ERR_* value on failure
145 extern int dt_device_find_compatible(const struct dt_device *dev,
154  *  - zero on success
155  *  - a negative FDT_ERR_* value on failure
161  * Low-level accessors for required node types and properties
166  * #address-cells and #size-cells properties of @fdtnode
168  *  - zero on success
169  *  - a negative FDT_ERR_* value on failure
195  *  - zero on success
196  *  - a negative FDT_ERR_* value on failure
201  * High-level accessors for required node types and properties
207  *  - zero on success
208  *  - a negative FDT_ERR_* value on failure, and @bootargs
215  * /chosen/stdout-path (or the deprecated /chosen/linux,stdout-path)
217  *  - the node (>= 0) on success
218  *  - a negative FDT_ERR_* value on failure
226  *  - zero on success
227  *  - a negative FDT_ERR_* value on failure, and @initrd will be
237  *  - number of memory regions found on success
238  *  - a negative FDT_ERR_* value on failure
245  *  - zero on success
246  *  - a negative FDT_ERR_* value on failure