rk3399_rockchip-uboot/include/fdtdec.h

3  * SPDX-License-Identifier:	GPL-2.0+
12  * drivers and board-specific code within U-Boot. It aims to reduce the
13  * amount of FDT munging required within U-Boot itself, so that driver code
27 #define FDT_ADDR_T_NONE (-1ULL)
32 #define FDT_ADDR_T_NONE (-1U)
57  * be equal to: end - start + 1.
91  * t:        is 1 if the address is aliased (for non-relocatable I/O) below 1MB
94  * bbbbbbbb: is the 8-bit Bus Number
95  * ddddd:    is the 5-bit Device Number
96  * fff:      is the 3-bit Function Number
97  * rrrrrrrr: is the 8-bit Register Number
98  * hhhhhhhh: is a 32-bit unsigned number
99  * llllllll: is a 32-bit unsigned number
115 	return res->end - res->start + 1;  in fdt_resource_size()
155 	COMPAT_INTEL_BAYTRAIL_FSP_MDP,	/* Intel FSP memory-down params */
159 	COMPAT_ALTERA_SOCFPGA_PINCTRL_SINGLE,	/* SoCFPGA pinctrl-single */
179  * fdtdec_parse_phandle_with_args() - Find a node pointed by phandle in a list
186  *	#list-cells = <2>;
190  *	#list-cells = <1>;
194  *	list = <&phandle1 1 2 &phandle2 3>;
198  * fdtdec_parse_phandle_with_args(blob, node3, "list", "#list-cells", 0, 1,
205  * @src_node:	Offset of device tree node containing a list
206  * @list_name:	property name that contains a list
212  * @return 0 on success (with @out_args filled out if not NULL), -ENOENT if
239  * @return offset of next compatible node, or -FDT_ERR_NOTFOUND if no more
248  * This function looks through our list of known compatible strings and
267  * @return offset of next compatible node, or -FDT_ERR_NOTFOUND if no more
284  * @return offset of next compatible node, or -FDT_ERR_NOTFOUND if no more
297  * non-standard properties, and never to parse the "reg" property. Instead,
299  * #address-cells and #size-cells properties in the parent node.
304  * @param index	which address to retrieve from a list of addresses. Often 0.
321  * the address and size by parsing the provided parent node's #address-cells
322  * and #size-cells properties.
328  * @param index	which address to retrieve from a list of addresses. Often 0.
343  * the address and size by parsing the parent node's #address-cells
344  * and #size-cells properties. The parent node is automatically found.
354  * @param index	which address to retrieve from a list of addresses. Often 0.
367  * This variant hard-codes the number of cells used to represent the address
371  * Use of this function is not recommended due to the hard-coding of cell
372  * counts. There is no programmatic validation that these hard-coded values
375  * set in the U-Boot build and exercising strict control over DT content to
376  * ensure use of matching #address-cells/#size-cells properties. However, this
377  * approach is error-prone; those familiar with DT will not expect the
394  * This variant hard-codes the number of cells used to represent the address
398  * Use of this function is not recommended due to the hard-coding of cell
399  * counts. There is no programmatic validation that these hard-coded values
402  * set in the U-Boot build and exercising strict control over DT content to
403  * ensure use of matching #address-cells/#size-cells properties. However, this
404  * approach is error-prone; those familiar with DT will not expect the
428  * @return 0 if ok, -ENOENT if the property did not exist, -EINVAL if the
429  *		format of the property was invalid, -ENXIO if the requested
443  * @return 0 if ok, negative on error
455  * @return 0 if ok, negative on error
461  * Look up a 32-bit integer property in a node and return it. The property
488  * Get a variable-sized number from a property
499  * Look up a 64-bit integer property in a node and return it. The property
527  * Make sure we have a valid fdt available to control U-Boot.
531  * @return 0 if all ok, -1 if not
536  * Checks that we have a valid fdt available to control U-Boot.
546  * Find the nodes for a peripheral and return a list of them in the correct
557  * Pass "usb" as the name to this function and will return a list of two
563  * If no alias node is found, then the node list will be returned in the
577  * @param node_list	Place to put list of found nodes
579  * @return number of nodes found on success, FDT_ERR_... on error
587  * available for allocation - others are considered already used and are
591  * uninitialised array, then setting the elements that are returned to -1,
615  * @param blob		Device tree blob (if NULL, then error is returned)
620  * @return 0 if a sequence was found, -ve if not
640  * @param blob		Device tree blob (if NULL, then error is returned)
641  * @param name		Property name, e.g. "stdout-path"
642  * @return Node offset referred to by that chosen node, or -ve FDT_ERR_...
660  * @return node offset if found, -ve error code on error
674  * @return 0 if ok, or -FDT_ERR_NOTFOUND if the property is not found,
675  *		or -FDT_ERR_BADLAYOUT if not enough data
690  * @return number of array elements if ok, or -FDT_ERR_NOTFOUND if the
739  * as a 32-bit integer. The property must have at least 4 bytes of data. The
766  * @returns property string, NULL on error.
780  * @return 0 if ok, or -FDT_ERR_MISSING if the property is not found,
781  *		or -FDT_ERR_BADLAYOUT if not enough data
807  * 32-bit machines.
814  * @return 0 if ok, -1 on error (property not found)
827  * @return 0 if ok, negative on error
835  * Look up the index of the name in a list of strings and return the resource
841  * @param prop_names	name of the property containing the list of names
857  *	<mem_type>-memory<suffix> for the name of the memory bank
858  *	<mem_type>-offset<suffix> for the offset in that bank
864  * @param node		Node containing the properties (-1 for /config)
866  *			"u-boot" or "kernel".
871  * @return 0 if OK, -ive on error
916  *	  |<- sync ->|<- back ->|<----- active ----->|<- front ->|<- sync..
941  * fdtdec_decode_display_timing() - decode display timings
943  * Decode display timings from the supplied 'display-timings' node.
944  * See doc/device-tree-bindings/video/display-timing.txt for binding
948  * @param node		'display-timing' node containing the timing subnodes
951  * @return 0 if OK, -FDT_ERR_NOTFOUND if not found
957  * fdtdec_setup_memory_size() - decode and setup gd->ram_size
962  * This function should be called from a boards dram_init(). This helper
963  * function allows for boards to query the device tree for DRAM size instead of
967  * @return 0 if OK, -EINVAL if the /memory node or reg property is missing or
973  * fdtdec_setup_memory_banksize() - decode and populate gd->bd->bi_dram
979  * This function should be called from a boards dram_init_banksize(). This
980  * helper function allows for boards to query the device tree for memory bank
984  * @return 0 if OK, -EINVAL if the /memory node or reg property is missing or
995  * Board-specific FDT initialization. Returns the address to a device tree blob.