include/dm/read.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
21 	return ofnode_to_np(dev->node);  in dev_np()
31  * dev_ofnode() - get the DT node reference associated with a udevice
38 	return dev->node;  in dev_ofnode()
48  * dev_read_u32() - read a 32-bit integer from a device's DT property
53  * @return 0 if OK, -ve on error
58  * dev_read_u32_default() - read a 32-bit integer from a device's DT property
68  * dev_read_s32() - read a signed 32-bit integer from a device's DT property
73  * @return 0 if OK, -ve on error
78  * dev_read_s32_default() - read a signed 32-bit int from a device's DT property
88  * dev_read_u32u() - read a 32-bit integer from a device's DT property
95  * @return 0 if OK, -ve on error
100  * dev_read_string() - Read a string from a device's DT property
109  * dev_read_bool() - read a boolean value from a device's DT property
118  * dev_read_subnode() - find a named subnode of a device
128  * dev_read_size() - read the size of a property
132  * @return size of property if present, or -EINVAL if not
137  * dev_read_addr_index() - Get the indexed reg property of a device
148  * dev_remap_addr_index() - Get the indexed reg property of a device
149  *                               as a memory-mapped I/O pointer
160  * dev_read_addr_name() - Get the reg property of a device, indexed by name
164  *	  'reg-names' property providing named-based identification. @index
165  *	  indicates the value to search for in 'reg-names'.
172  * dev_remap_addr_name() - Get the reg property of a device, indexed by name,
173  *                         as a memory-mapped I/O pointer
177  *	  'reg-names' property providing named-based identification. @index
178  *	  indicates the value to search for in 'reg-names'.
185  * dev_read_addr() - Get the reg property of a device
194  * dev_read_addr_ptr() - Get the reg property of a device
204  * dev_remap_addr() - Get the reg property of a device as a
205  *                         memory-mapped I/O pointer
214  * dev_read_addr_size() - get address and size from a device property
228  * dev_read_name() - get the name of a device's node
230  * @node: valid node to look up
236  * dev_read_stringlist_search() - find string in a string list and return index
239  * that are not NUL-terminated. That's because the function will stop after
241  * small-valued cell properties, such as #address-cells, when searching for
246  * @string: string to look up in the string list
250  *   -ENODATA if the property is not found
251  *   -EINVAL on some other error
257  * dev_read_string_index() - obtain an indexed string from a string list
265  *   length of string, if found or -ve error value if not found
271  * dev_read_string_count() - find the number of strings in a string list
276  *   number of strings in the list, or -ve error value if not found
280  * dev_read_phandle_with_args() - Find a node pointed by phandle in a list
286  * Caller is responsible to call of_node_put() on the returned out_args->np
292  *	#list-cells = <2>;
296  *	#list-cells = <1>;
304  * dev_read_phandle_with_args(dev, "list", "#list-cells", 0, 1, &args);
312  * @return 0 on success (with @out_args filled out if not NULL), -ENOENT if
313  *	@list_name does not exist, -EINVAL if a phandle was not found,
323  * dev_count_phandle_with_args() - Return phandle number in a list
341  * dev_read_addr_cells() - Get the number of address cells for a device's node
343  * This walks back up the tree to find the closest #address-cells property
352  * dev_read_size_cells() - Get the number of size cells for a device's node
354  * This walks back up the tree to find the closest #size-cells property
363  * dev_read_addr_cells() - Get the address cells property in a node
373  * dev_read_size_cells() - Get the size cells property in a node
383  * dev_read_phandle() - Get the phandle from a device
391  * dev_read_prop()- - read a property from a device's node
401  * dev_read_alias_seq() - Get the alias sequence number of a node
407  * @dev: device to look up
409  * @return 0 if a sequence was found, -ve if not
414  * dev_read_u32_array() - Find and read an array of 32 bit integers
416  * Search for a property in a device node and read 32-bit value(s) from
421  * @dev: device to look up
425  * @return 0 on success, -EINVAL if the property does not exist, -ENODATA if
426  * property does not have a value, and -EOVERFLOW if the property data isn't
433  * dev_read_first_subnode() - find the first subnode of a device's node
435  * @dev: device to look up
442  * ofnode_next_subnode() - find the next sibling of a subnode
451  * dev_read_u8_array_ptr() - find an 8-bit array
453  * Look up a device's node property and return a pointer to its contents as a
458  * @dev: device to look up
468  * dev_read_enabled() - check whether a node is enabled
481  * dev_read_resource() - obtain an indexed resource from a device.
491  * dev_read_resource_byname() - obtain a named resource from a device.
502  * dev_translate_address() - Tranlate a device-tree address
504  * Translate an address from the device-tree into a CPU physical address.  This
505  * function walks up the tree and applies the various bus mappings along the
515  * dev_read_alias_highest_id - Get highest alias id for the given stem
520  * @return alias ID, if found, else -1
672 	/* NOTE: this call should walk up the parent stack */  in dev_read_addr_cells()
673 	return fdt_address_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_addr_cells()
678 	/* NOTE: this call should walk up the parent stack */  in dev_read_size_cells()
679 	return fdt_size_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_size_cells()
684 	return fdt_address_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_simple_addr_cells()
689 	return fdt_size_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_simple_size_cells()
694 	return fdt_get_phandle(gd->fdt_blob, dev_of_offset(dev));  in dev_read_phandle()
705 	return fdtdec_get_alias_seq(gd->fdt_blob, dev->uclass->uc_drv->name,  in dev_read_alias_seq()
733 	return fdtdec_get_is_enabled(gd->fdt_blob, dev_of_offset(dev));  in dev_read_enabled()
756 	return fdtdec_get_alias_highest_id(gd->fdt_blob, stem);  in dev_read_alias_highest_id()
762  * dev_for_each_subnode() - Helper function to iterate through subnodes
765  * device-tree node.