drivers/of/property.c

3  * drivers/of/property.c - Procedures for accessing and interpreting
7  * file contains the OF property as well as the OF graph interface
55  * of_property_count_elems_of_size - Count the number of elements in a property
57  * @np:		device node from which the property value is to be read.
58  * @propname:	name of the property to be searched.
61  * Search for a property in a device node and count the number of elements of
64  * Return: The number of elements on sucess, -EINVAL if the property does not
66  * the property does not have a value.
71 	struct property *prop = of_find_property(np, propname, NULL);  in of_property_count_elems_of_size()
91  * @np:		device node from which the property value is to be read.
92  * @propname:	name of the property to be searched.
93  * @min:	minimum allowed length of property value
94  * @max:	maximum allowed length of property value (0 means unlimited)
97  * Search for a property in a device node and valid the requested size.
99  * Return: The property value on success, -EINVAL if the property does not
100  * exist, -ENODATA if property does not have a value, and -EOVERFLOW if the
101  * property data is too small or too large.
107 	struct property *prop = of_find_property(np, propname, NULL);  in of_find_property_value_of_size()
125  * of_property_read_u32_index - Find and read a u32 from a multi-value property.
127  * @np:		device node from which the property value is to be read.
128  * @propname:	name of the property to be searched.
132  * Search for a property in a device node and read nth 32-bit value from
135  * Return: 0 on success, -EINVAL if the property does not exist,
136  * -ENODATA if property does not have a value, and -EOVERFLOW if the
137  * property data isn't large enough.
159  * of_property_read_u64_index - Find and read a u64 from a multi-value property.
161  * @np:		device node from which the property value is to be read.
162  * @propname:	name of the property to be searched.
166  * Search for a property in a device node and read nth 64-bit value from
169  * Return: 0 on success, -EINVAL if the property does not exist,
170  * -ENODATA if property does not have a value, and -EOVERFLOW if the
171  * property data isn't large enough.
193  * property, with bounds on the minimum and maximum array size.
195  * @np:		device node from which the property value is to be read.
196  * @propname:	name of the property to be searched.
203  * Search for a property in a device node and read 8-bit value(s) from
207  *  ``property = /bits/ 8 <0x50 0x60 0x70>;``
209  * Return: The number of elements read on success, -EINVAL if the property
210  * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW
211  * if the property data is smaller than sz_min or longer than sz_max.
243  * property, with bounds on the minimum and maximum array size.
245  * @np:		device node from which the property value is to be read.
246  * @propname:	name of the property to be searched.
253  * Search for a property in a device node and read 16-bit value(s) from
257  *  ``property = /bits/ 16 <0x5000 0x6000 0x7000>;``
259  * Return: The number of elements read on success, -EINVAL if the property
260  * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW
261  * if the property data is smaller than sz_min or longer than sz_max.
293  * integers from a property, with bounds on the minimum and maximum array size.
295  * @np:		device node from which the property value is to be read.
296  * @propname:	name of the property to be searched.
303  * Search for a property in a device node and read 32-bit value(s) from
306  * Return: The number of elements read on success, -EINVAL if the property
307  * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW
308  * if the property data is smaller than sz_min or longer than sz_max.
339  * of_property_read_u64 - Find and read a 64 bit integer from a property
340  * @np:		device node from which the property value is to be read.
341  * @propname:	name of the property to be searched.
344  * Search for a property in a device node and read a 64-bit value from
347  * Return: 0 on success, -EINVAL if the property does not exist,
348  * -ENODATA if property does not have a value, and -EOVERFLOW if the
349  * property data isn't large enough.
371  * integers from a property, with bounds on the minimum and maximum array size.
373  * @np:		device node from which the property value is to be read.
374  * @propname:	name of the property to be searched.
381  * Search for a property in a device node and read 64-bit value(s) from
384  * Return: The number of elements read on success, -EINVAL if the property
385  * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW
386  * if the property data is smaller than sz_min or longer than sz_max.
419  * of_property_read_string - Find and read a string from a property
420  * @np:		device node from which the property value is to be read.
421  * @propname:	name of the property to be searched.
425  * Search for a property in a device tree node and retrieve a null
428  * Return: 0 on success, -EINVAL if the property does not exist, -ENODATA if
429  * property does not have a value, and -EILSEQ if the string is not
430  * null-terminated within the length of the property data.
440 	const struct property *prop = of_find_property(np, propname, NULL);  in of_property_read_string()
455  * @np: pointer to the node containing the string list property
456  * @propname: string list property name
459  * Search for an exact match of string in a device node property which is a
463  * if the property does not exist, -ENODATA if the property does not have a
465  * the property data.
470 	const struct property *prop = of_find_property(np, propname, NULL);  in of_property_match_string()
497  * @np:		device node from which the property value is to be read.
498  * @propname:	name of the property to be searched.
510 	const struct property *prop = of_find_property(np, propname, NULL);  in of_property_read_string_helper()
533 const __be32 *of_prop_next_u32(struct property *prop, const __be32 *cur,  in of_prop_next_u32()
556 const char *of_prop_next_string(struct property *prop, const char *cur)  in of_prop_next_string()
701  * @port_reg: identifier (value of reg property) of the parent port node
702  * @reg: identifier (value of reg property) of the endpoint node
829  * @port: identifier (value of reg property) of the parent port node
830  * @endpoint: identifier (value of reg property) of the endpoint node
1084  * parse_prop_cells - Property parsing function for suppliers
1087  * @prop_name:	Name of property to be parsed. Expected to hold phandle values
1090  * @list_name:	Property name that is known to contain list of phandle(s) to
1092  * @cells_name:	property name that specifies phandles' arguments count
1138  * parse_suffix_prop_cells - Suffix property parsing function for suppliers
1141  * @prop_name:	Name of property to be parsed. Expected to hold phandle values
1144  * @suffix:	Property suffix that is known to contain list of phandle(s) to
1146  * @cells_name:	property name that specifies phandles' arguments count
1181  * struct supplier_bindings - Property parsing functions for suppliers
1185  *  parse_prop.np: Pointer to device node holding supplier phandle property
1186  *  parse_prop.prop_name: Name of property holding a phandle value
1189  * @get_con_dev: If the consumer node containing the property is never converted
1194  *		  for this property.
1274 	 * Ignore node with gpio-hog property since its gpios are all provided  in parse_gpio_compat()
1406  * of_link_property - Create device links to suppliers listed in a property
1407  * @con_np: The consumer device tree node which contains the property
1408  * @prop_name: Name of property to be parsed
1410  * This function checks if the property @prop_name that is present in the
1469 	struct property *p;  in of_fwnode_add_links()