libs/libfdt/libfdt.h

22 	/* FDT_ERR_NOTFOUND: The requested node or property does not exist */
24 	/* FDT_ERR_EXISTS: Attempted to create a node or property which
43 	 * This can be caused either by an invalid phandle property
85 	 * or similar property with a bad format or value */
88 	/* FDT_ERR_BADVALUE: Device tree has a property with an unexpected
89 	 * value. For example: a property expected to contain a string list
95 	 * unexpected or missing value, property or node. */
151 static inline void fdt32_st(void *property, uint32_t value)
153 	uint8_t *bp = (uint8_t *)property;
175 static inline void fdt64_st(void *property, uint64_t value)
177 	uint8_t *bp = (uint8_t *)property;
566  * fdt_first_property_offset - find the offset of a node's first property
570  * fdt_first_property_offset() finds the first property of the node at
574  *	structure block offset of the property (>=0), on success
588  * @offset: structure block offset of a property
590  * fdt_next_property_offset() finds the property immediately after the
591  * one at the given structure block offset.  This will be a property
592  * of the same node as the given property.
595  *	structure block offset of the next property (>=0), on success
596  *	-FDT_ERR_NOTFOUND, if the given property is the last in its node
609  * @property:	property offset (int, lvalue)
615  *	fdt_for_each_property_offset(property, fdt, node) {
616  *		Use property
620  *	if ((property < 0) && (property != -FDT_ERR_NOTFOUND)) {
624  * Note that this is implemented as a macro and property is used as
628 #define fdt_for_each_property_offset(property, fdt, node)	\
629 	for (property = fdt_first_property_offset(fdt, node);	\
630 	     property >= 0;					\
631 	     property = fdt_next_property_offset(fdt, property))
634  * fdt_get_property_by_offset - retrieve the property at a given offset
636  * @offset: offset of the property to retrieve
641  * offset.  If lenp is non-NULL, the length of the property value is
648  *	pointer to the structure representing the property
649  *		if lenp is non-NULL, *lenp contains the length of the property
665  * fdt_get_property_namelen - find a property based on substring
667  * @nodeoffset: offset of the node whose property to find
668  * @name: name of the property to find
673  * characters of name for matching the property name.
675  * Return: pointer to the structure representing the property, or NULL
686  * fdt_get_property - find a given property in a given node
688  * @nodeoffset: offset of the node whose property to find
689  * @name: name of the property to find
693  * structure within the device tree blob corresponding to the property
695  * non-NULL, the length of the property value is also returned, in the
699  *	pointer to the structure representing the property
700  *		if lenp is non-NULL, *lenp contains the length of the property
704  *		-FDT_ERR_NOTFOUND, node does not have named property
724  * fdt_getprop_by_offset - retrieve the value of a property at a given offset
726  * @offset: offset of the property to read
731  * property at structure block offset 'offset' (this will be a pointer
733  * lenp is non-NULL, the length of the property value is also
735  * the property's namne will also be returned in the char * pointed to
740  *	pointer to the property's value
741  *		if lenp is non-NULL, *lenp contains the length of the property
743  *		if namep is non-NULL *namep contiains a pointer to the property
760  * fdt_getprop_namelen - get property value based on substring
762  * @nodeoffset: offset of the node whose property to find
763  * @name: name of the property to find
768  * characters of name for matching the property name.
770  * Return: pointer to the property's value or NULL on error
785  * fdt_getprop - retrieve the value of a given property
787  * @nodeoffset: offset of the node whose property to find
788  * @name: name of the property to find
791  * fdt_getprop() retrieves a pointer to the value of the property
794  * If @lenp is non-NULL, the length of the property value is also
798  *	pointer to the property's value
799  *		if lenp is non-NULL, *lenp contains the length of the property
803  *		-FDT_ERR_NOTFOUND, node does not have named property
857  * value of the property named @name in the node /aliases.
970  * fdt_node_offset_by_prop_value - find nodes with a given property value
973  * @propname: property name to check
974  * @propval: property value to search for
978  * node after startoffset, which has a property named propname whose
1033  * fdt_node_check_compatible - check a node's compatible property
1039  * @compatible property with the given string as one of its elements,
1043  *	0, if the node has a 'compatible' property listing the given string
1044  *	1, if the node has a 'compatible' property, but it does not list
1046  *	-FDT_ERR_NOTFOUND, if the given node has no 'compatible' property
1063  * node after startoffset, which has a 'compatible' property which
1094  * fdt_stringlist_contains - check a string list property for a string
1096  * @listlen: Length of property
1101  * "compatible" property.
1111  * @property: name of the property containing the string list
1114  *   the number of strings in the given property
1115  *   -FDT_ERR_BADVALUE if the property value is not NUL-terminated
1116  *   -FDT_ERR_NOTFOUND if the property does not exist
1118 int fdt_stringlist_count(const void *fdt, int nodeoffset, const char *property);
1124  * @property: name of the property containing the string list
1127  * Note that it is possible for this function to succeed on property values
1135  *   -FDT_ERR_BADVALUE if the property value is not NUL-terminated
1136  *   -FDT_ERR_NOTFOUND if the property does not exist or does not contain
1139 int fdt_stringlist_search(const void *fdt, int nodeoffset, const char *property,
1146  * @property: name of the property containing the string list
1163  *     -FDT_ERR_BADVALUE if the property value is not NUL-terminated
1164  *     -FDT_ERR_NOTFOUND if the property does not exist
1167 			       const char *property, int index,
1190  * When the node has a valid #address-cells property, returns its value.
1194  *      2, if the node has no #address-cells property
1196  *		#address-cells property
1211  * When the node has a valid #size-cells property, returns its value.
1215  *      1, if the node has no #size-cells property
1217  *		#size-cells property
1232  * fdt_setprop_inplace_namelen_partial - change a property's value,
1235  * @nodeoffset: offset of the node whose property to change
1236  * @name: name of the property to change
1238  * @idx: index of the property to change in the array
1239  * @val: pointer to data to replace the property value with
1240  * @len: length of the property value
1242  * Identical to fdt_setprop_inplace(), but modifies the given property
1257  * fdt_setprop_inplace - change a property's value, but not its size
1259  * @nodeoffset: offset of the node whose property to change
1260  * @name: name of the property to change
1261  * @val: pointer to data to replace the property value with
1262  * @len: length of the property value
1264  * fdt_setprop_inplace() replaces the value of a given property with
1266  * size of a property, and so will only work if len is equal to the
1267  * current length of the property.
1270  * the given property value, and will not alter or move any other part
1275  *	-FDT_ERR_NOSPACE, if len is not equal to the property's current length
1276  *	-FDT_ERR_NOTFOUND, node does not have the named property
1290  * fdt_setprop_inplace_u32 - change the value of a 32-bit integer property
1292  * @nodeoffset: offset of the node whose property to change
1293  * @name: name of the property to change
1294  * @val: 32-bit integer value to replace the property with
1296  * fdt_setprop_inplace_u32() replaces the value of a given property
1298  * if necessary.  This function cannot change the size of a property,
1299  * and so will only work if the property already exists and has length
1303  * the given property value, and will not alter or move any other part
1308  *	-FDT_ERR_NOSPACE, if the property's length is not equal to 4
1309  *	-FDT_ERR_NOTFOUND, node does not have the named property
1325  * fdt_setprop_inplace_u64 - change the value of a 64-bit integer property
1327  * @nodeoffset: offset of the node whose property to change
1328  * @name: name of the property to change
1329  * @val: 64-bit integer value to replace the property with
1331  * fdt_setprop_inplace_u64() replaces the value of a given property
1333  * if necessary.  This function cannot change the size of a property,
1334  * and so will only work if the property already exists and has length
1338  * the given property value, and will not alter or move any other part
1343  *	-FDT_ERR_NOSPACE, if the property's length is not equal to 8
1344  *	-FDT_ERR_NOTFOUND, node does not have the named property
1360  * fdt_setprop_inplace_cell - change the value of a single-cell property
1362  * @nodeoffset: offset of the node containing the property
1363  * @name: name of the property to change the value of
1376  * fdt_nop_property - replace a property with nop tags
1378  * @nodeoffset: offset of the node whose property to nop
1379  * @name: name of the property to nop
1381  * fdt_nop_property() will replace a given property's representation
1386  * the property, and will not alter or move any other part of the
1391  *	-FDT_ERR_NOTFOUND, node does not have the named property
1431 	/* FDT_CREATE_FLAG_NO_NAME_DEDUP: Do not try to de-duplicate property
1492  * fdt_property_placeholder - add a new property and return a ptr to its value
1495  * @name: name of property to add
1496  * @len: length of property value in bytes
1595  * fdt_setprop - create or change a property
1597  * @nodeoffset: offset of the node whose property to change
1598  * @name: name of the property to change
1599  * @val: pointer to data to set the property value to
1600  * @len: length of the property value
1602  * fdt_setprop() sets the value of the named property in the given
1603  * node to the given value and length, creating the property if it
1612  *		contain the new property value
1626  * fdt_setprop_placeholder - allocate space for a property
1628  * @nodeoffset: offset of the node whose property to change
1629  * @name: name of the property to change
1630  * @len: length of the property value
1631  * @prop_data: return pointer to property data
1633  * fdt_setprop_placeholer() allocates the named property in the given node.
1634  * If the property exists it is resized. In either case a pointer to the
1635  * property data is returned.
1643  *		contain the new property value
1657  * fdt_setprop_u32 - set a property to a 32-bit integer
1659  * @nodeoffset: offset of the node whose property to change
1660  * @name: name of the property to change
1661  * @val: 32-bit integer value for the property (native endian)
1663  * fdt_setprop_u32() sets the value of the named property in the given
1665  * necessary), or creates a new property with that value if it does
1674  *		contain the new property value
1692  * fdt_setprop_u64 - set a property to a 64-bit integer
1694  * @nodeoffset: offset of the node whose property to change
1695  * @name: name of the property to change
1696  * @val: 64-bit integer value for the property (native endian)
1698  * fdt_setprop_u64() sets the value of the named property in the given
1700  * necessary), or creates a new property with that value if it does
1709  *		contain the new property value
1727  * fdt_setprop_cell - set a property to a single cell value
1729  * @nodeoffset: offset of the node whose property to change
1730  * @name: name of the property to change
1731  * @val: 32-bit integer value for the property (native endian)
1744  * fdt_setprop_string - set a property to a string value
1746  * @nodeoffset: offset of the node whose property to change
1747  * @name: name of the property to change
1748  * @str: string value for the property
1750  * fdt_setprop_string() sets the value of the named property in the
1752  * string to determine the new length of the property), or creates a
1753  * new property with that value if it does not already exist.
1761  *		contain the new property value
1776  * fdt_setprop_empty - set a property to an empty value
1778  * @nodeoffset: offset of the node whose property to change
1779  * @name: name of the property to change
1781  * fdt_setprop_empty() sets the value of the named property in the
1783  * property if it does not already exist.
1791  *		contain the new property value
1805  * fdt_appendprop - append to or create a property
1807  * @nodeoffset: offset of the node whose property to change
1808  * @name: name of the property to append to
1809  * @val: pointer to data to append to the property value
1810  * @len: length of the data to append to the property value
1812  * fdt_appendprop() appends the value to the named property in the
1813  * given node, creating the property if it does not already exist.
1821  *		contain the new property value
1835  * fdt_appendprop_u32 - append a 32-bit integer value to a property
1837  * @nodeoffset: offset of the node whose property to change
1838  * @name: name of the property to change
1839  * @val: 32-bit integer value to append to the property (native endian)
1843  * property in the given node, or creates a new property with that
1852  *		contain the new property value
1870  * fdt_appendprop_u64 - append a 64-bit integer value to a property
1872  * @nodeoffset: offset of the node whose property to change
1873  * @name: name of the property to change
1874  * @val: 64-bit integer value to append to the property (native endian)
1878  * property in the given node, or creates a new property with that
1887  *		contain the new property value
1905  * fdt_appendprop_cell - append a single cell value to a property
1907  * @nodeoffset: offset of the node whose property to change
1908  * @name: name of the property to change
1909  * @val: 32-bit integer value to append to the property (native endian)
1922  * fdt_appendprop_string - append a string to a property
1924  * @nodeoffset: offset of the node whose property to change
1925  * @name: name of the property to change
1926  * @str: string value to append to the property
1929  * the named property in the given node, or creates a new property
1938  *		contain the new property value
1952  * fdt_appendprop_addrrange - append a address range property
1955  * @nodeoffset: offset of the node to add a property at
1956  * @name: name of property
1961  * address and size) to the value of the named property in the given
1962  * node, or creates a new property with that value if it does not
1975  *		#address-cells property
1982  *		contain a new property
1989  * fdt_delprop - delete a property
1991  * @nodeoffset: offset of the node whose property to nop
1992  * @name: name of the property to nop
1994  * fdt_del_property() will delete the given property.
2001  *	-FDT_ERR_NOTFOUND, node does not have the named property