kvm-unit-tests/lib/devicetree.h

7  * Documentation/devicetree/booting-without-of.txt
20 /* dt_init initializes devicetree with a pointer to an fdt, @fdt_ptr */
29 /* traverse child nodes */
32 	     s != -FDT_ERR_NOTFOUND;					\
36  * Abstractions for required node types and properties
44 	 * info is a pointer to device specific data, which may be
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
62 	 * @dev's fdt node's "reg" property, and store the result
63 	 * in @reg, a bus specific structure
65 	 *  - zero on success
66 	 *  - a negative FDT_ERR_* value on failure
71 /* dt_bus_match_any matches any fdt node, i.e. it always returns true */
91  * dt_pbus_translate translates device node regs for the
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
103  * operates on an fdt node instead of a dt_device
112  *  - zero on success
113  *  - a negative FDT_ERR_* value on failure
123  *  match		<- dt_bus_match_any
124  *  translate		<- dt_pbus_translate
129  * dt_device_init initializes a dt_device with the given parameters
136 	dev->fdtnode = fdtnode;  in dt_device_bind_node()
140  * dt_device_find_compatible finds a @compatible node
142  *  - node (>= 0) on success
143  *  - a negative FDT_ERR_* value on failure
150  * It finds the first @compatible fdt node, then translates the 0th reg
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
174 /* dt_reg is a structure for "raw" reg tuples */
184  * dt_reg_init initialize a dt_reg struct to zero and sets
192  * dt_get_reg gets the @regidx'th reg tuple of @fdtnode's reg property
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
214  * dt_get_default_console_node gets the node of the path stored in
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
233  * dt_get_memory_params gets the memory parameters from the /memory node(s)
237  *  - number of memory regions found on success
238  *  - a negative FDT_ERR_* value on failure
243  * dt_for_each_cpu_node runs @func on each cpu node in the /cpus node
244  * passing it its fdt node, its reg property value, and @info
245  *  - zero on success
246  *  - a negative FDT_ERR_* value on failure