include/dm/read.h

7  * SPDX-License-Identifier:	GPL-2.0+
22 	return ofnode_to_np(dev->node);  in dev_np()
32  * dev_ofnode() - get the DT node reference associated with a udevice
39 	return dev->node;  in dev_ofnode()
49  * dev_read_u32_default() - read a 32-bit integer from a device's DT property
59  * dev_read_s32_default() - read a signed 32-bit integer from a device's DT property
69  * dev_read_string() - Read a string from a device's DT property
78  * dev_read_bool() - read a boolean value from a device's DT property
87  * dev_read_subnode() - find a named subnode of a device
97  * dev_read_size() - read the size of a property
101  * @return size of property if present, or -EINVAL if not
106  * dev_read_addr_index() - Get the indexed reg property of a device
117  * dev_read_addr() - Get the reg property of a device
126  * dev_read_addr_ptr() - Get the reg property of a device
136  * dev_read_addr_size() - get address and size from a device property
150  * dev_read_name() - get the name of a device's node
152  * @node: valid node to look up
158  * dev_read_stringlist_search() - find string in a string list and return index
161  * that are not NUL-terminated. That's because the function will stop after
163  * small-valued cell properties, such as #address-cells, when searching for
168  * @string: string to look up in the string list
172  *   -ENODATA if the property is not found
173  *   -EINVAL on some other error
179  * dev_read_string_index() - obtain an indexed string from a string list
187  *   length of string, if found or -ve error value if not found
193  * dev_read_string_count() - find the number of strings in a string list
198  *   number of strings in the list, or -ve error value if not found
202  * dev_read_phandle_with_args() - Find a node pointed by phandle in a list
208  * Caller is responsible to call of_node_put() on the returned out_args->np
214  *	#list-cells = <2>;
218  *	#list-cells = <1>;
226  * dev_read_phandle_with_args(dev, "list", "#list-cells", 0, 1, &args);
234  * @return 0 on success (with @out_args filled out if not NULL), -ENOENT if
235  *	@list_name does not exist, -EINVAL if a phandle was not found,
245  * dev_count_phandle_with_args() - Return phandle number in a list
263  * dev_read_addr_cells() - Get the number of address cells for a device's node
265  * This walks back up the tree to find the closest #address-cells property
274  * dev_remap_addr_index() - Get the indexed reg property of a device
275  *                               as a memory-mapped I/O pointer
286  * dev_read_size_cells() - Get the number of size cells for a device's node
288  * This walks back up the tree to find the closest #size-cells property
297  * dev_read_addr_cells() - Get the address cells property in a node
307  * dev_read_size_cells() - Get the size cells property in a node
317  * dev_read_phandle() - Get the phandle from a device
325  * dev_read_prop()- - read a property from a device's node
335  * dev_read_first_prop()- get the reference of the first property
342  * @return 0 if OK, -ve on error. -FDT_ERR_NOTFOUND if not found
347  * ofnode_get_next_property() - get the reference of the next property
353  * @return 0 if OK, -ve on error. -FDT_ERR_NOTFOUND if not found
358  * dev_read_prop_by_prop() - get a pointer to the value of a property
363  * @propname: If non-NULL, place to property name on success,
364  * @lenp: If non-NULL, place to put length on success
365  * @return 0 if OK, -ve on error. -FDT_ERR_NOTFOUND if not found
371  * dev_read_alias_seq() - Get the alias sequence number of a node
377  * @dev: device to look up
379  * @return 0 if a sequence was found, -ve if not
384  * dev_read_u32_array() - Find and read an array of 32 bit integers
386  * Search for a property in a device node and read 32-bit value(s) from
391  * @dev: device to look up
395  * @return 0 on success, -EINVAL if the property does not exist, -ENODATA if
396  * property does not have a value, and -EOVERFLOW if the property data isn't
403  * dev_write_u32_array() - Find and write an array of 32 bit integers
405  * Search for a property in a device node and write 32-bit value(s) to
410  * @dev: device to look up
414  * @return 0 on success, -EINVAL if the property does not exist, -ENODATA if
415  * property does not have a value, and -EOVERFLOW if the property data isn't
422  * dev_read_first_subnode() - find the first subnode of a device's node
424  * @dev: device to look up
431  * ofnode_next_subnode() - find the next sibling of a subnode
440  * dev_read_u8_array_ptr() - find an 8-bit array
442  * Look up a device's node property and return a pointer to its contents as a
447  * @dev: device to look up
457  * dev_read_enabled() - check whether a node is enabled
470  * dev_read_resource() - obtain an indexed resource from a device.
480  * dev_read_resource_byname() - obtain a named resource from a device.
491  * dev_translate_address() - Tranlate a device-tree address
493  * Translate an address from the device-tree into a CPU physical address.  This
494  * function walks up the tree and applies the various bus mappings along the
599 	/* NOTE: this call should walk up the parent stack */  in dev_read_addr_cells()
600 	return fdt_address_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_addr_cells()
610 	/* NOTE: this call should walk up the parent stack */  in dev_read_size_cells()
611 	return fdt_size_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_size_cells()
616 	return fdt_address_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_simple_addr_cells()
621 	return fdt_size_cells(gd->fdt_blob, dev_of_offset(dev));  in dev_read_simple_size_cells()
626 	return fdt_get_phandle(gd->fdt_blob, dev_of_offset(dev));  in dev_read_phandle()
654 	return fdtdec_get_alias_seq(gd->fdt_blob, dev->uclass->uc_drv->name,  in dev_read_alias_seq()
662 		return -EINVAL;  in dev_read_u32_array()
684 	return fdtdec_get_is_enabled(gd->fdt_blob, dev_of_offset(dev));  in dev_read_enabled()
708  * dev_for_each_subnode() - Helper function to iterate through subnodes
711  * device-tree node.
722  * dev_for_each_property() - Helper function to iterate through property
725  * device-tree node.