random-mirrors/smaeul-u-boot
1
0
Fork 0
mirror of https://github.com/smaeul/u-boot.git synced 2025-10-18 14:48:17 +01:00
Code Issues Packages Projects Releases Wiki Activity

core: fix doc comments of dev_read_addr*() and related functions

Browse Source 
- The dev_read_addr_name*() family of functions has no "index" argument,
  doc comments should refer to "name"
- Specify the error return for several devfdt_get_addr*() functions

Signed-off-by: Matthias Schiffer <matthias.schiffer@ew.tq-group.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Matthias Schiffer 2023-09-27 15:33:30 +02:00 committed by Simon Glass
parent bff16109e3
commit e42c4d6d90
2 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
include/dm/fdtaddr.h
View File

@ -19,7 +19,7 @@ struct udevice;
* *
* @dev: Pointer to a device * @dev: Pointer to a device
* *
* Return: addr * Return: Address, or FDT_ADDR_T_NONE if there is no such property
*/ */
fdt_addr_t devfdt_get_addr(const struct udevice *dev); fdt_addr_t devfdt_get_addr(const struct udevice *dev);
@ -59,7 +59,7 @@ void *devfdt_remap_addr_index(const struct udevice *dev, int index);
* devfdt_remap_addr_name() - Get the reg property of a device, indexed by * devfdt_remap_addr_name() - Get the reg property of a device, indexed by
* name, as a memory-mapped I/O pointer * name, as a memory-mapped I/O pointer
* @name: the 'reg' property can hold a list of <addr, size> pairs, with the * @name: the 'reg' property can hold a list of <addr, size> pairs, with the
* 'reg-names' property providing named-based identification. @index * 'reg-names' property providing named-based identification. @name
* indicates the value to search for in 'reg-names'. * indicates the value to search for in 'reg-names'.
* *
* @dev: Pointer to a device * @dev: Pointer to a device
@ -87,7 +87,7 @@ void *devfdt_map_physmem(const struct udevice *dev, unsigned long size);
* @index: the 'reg' property can hold a list of <addr, size> pairs * @index: the 'reg' property can hold a list of <addr, size> pairs
* and @index is used to select which one is required * and @index is used to select which one is required
* *
* Return: addr * Return: Address, or FDT_ADDR_T_NONE if there is no such property
*/ */
fdt_addr_t devfdt_get_addr_index(const struct udevice *dev, int index); fdt_addr_t devfdt_get_addr_index(const struct udevice *dev, int index);
@ -114,7 +114,7 @@ void *devfdt_get_addr_index_ptr(const struct udevice *dev, int index);
* @size: Pointer to size variable - this function returns the size * @size: Pointer to size variable - this function returns the size
* specified in the 'reg' property here * specified in the 'reg' property here
* *
* Return: addr * Return: Address, or FDT_ADDR_T_NONE if there is no such property
*/ */
fdt_addr_t devfdt_get_addr_size_index(const struct udevice *dev, int index, fdt_addr_t devfdt_get_addr_size_index(const struct udevice *dev, int index,
fdt_size_t *size); fdt_size_t *size);
@ -139,7 +139,7 @@ void *devfdt_get_addr_size_index_ptr(const struct udevice *dev, int index,
* *
* @dev: Pointer to a device * @dev: Pointer to a device
* @name: the 'reg' property can hold a list of <addr, size> pairs, with the * @name: the 'reg' property can hold a list of <addr, size> pairs, with the
* 'reg-names' property providing named-based identification. @index * 'reg-names' property providing named-based identification. @name
* indicates the value to search for in 'reg-names'. * indicates the value to search for in 'reg-names'.
* *
* Return: addr * Return: addr
@ -154,7 +154,7 @@ fdt_addr_t devfdt_get_addr_name(const struct udevice *dev, const char *name);
* *
* @dev: Pointer to a device * @dev: Pointer to a device
* @name: the 'reg' property can hold a list of <addr, size> pairs, with the * @name: the 'reg' property can hold a list of <addr, size> pairs, with the
* 'reg-names' property providing named-based identification. @index * 'reg-names' property providing named-based identification. @name
* indicates the value to search for in 'reg-names'. * indicates the value to search for in 'reg-names'.
* @size: Pointer to size variable - this function returns the size * @size: Pointer to size variable - this function returns the size
* specified in the 'reg' property here * specified in the 'reg' property here

6
include/dm/read.h
View File

@ -277,7 +277,7 @@ void *dev_remap_addr_index(const struct udevice *dev, int index);
* *
* @dev: Device to read from * @dev: Device to read from
* @name: the 'reg' property can hold a list of <addr, size> pairs, with the * @name: the 'reg' property can hold a list of <addr, size> pairs, with the
* 'reg-names' property providing named-based identification. @index * 'reg-names' property providing named-based identification. @name
* indicates the value to search for in 'reg-names'. * indicates the value to search for in 'reg-names'.
* *
* Return: address or FDT_ADDR_T_NONE if not found * Return: address or FDT_ADDR_T_NONE if not found
@ -289,7 +289,7 @@ fdt_addr_t dev_read_addr_name(const struct udevice *dev, const char *name);
* *
* @dev: Device to read from * @dev: Device to read from
* @name: the 'reg' property can hold a list of <addr, size> pairs, with the * @name: the 'reg' property can hold a list of <addr, size> pairs, with the
* 'reg-names' property providing named-based identification. @index * 'reg-names' property providing named-based identification. @name
* indicates the value to search for in 'reg-names'. * indicates the value to search for in 'reg-names'.
* @size: place to put size value (on success) * @size: place to put size value (on success)
* *
@ -304,7 +304,7 @@ fdt_addr_t dev_read_addr_size_name(const struct udevice *dev, const char *name,
* *
* @dev: Device to read from * @dev: Device to read from
* @name: the 'reg' property can hold a list of <addr, size> pairs, with the * @name: the 'reg' property can hold a list of <addr, size> pairs, with the
* 'reg-names' property providing named-based identification. @index * 'reg-names' property providing named-based identification. @name
* indicates the value to search for in 'reg-names'. * indicates the value to search for in 'reg-names'.
* *
* Return: pointer or NULL if not found * Return: pointer or NULL if not found