From 289bd72ea41fd45237a34593065ff107afc2a9a9 Mon Sep 17 00:00:00 2001 From: Heinrich Schuchardt Date: Mon, 14 Aug 2023 08:44:26 +0200 Subject: [PATCH] doc: description of board_get_usable_ram_top() Improve the description of function board_get_usable_ram_top(). Signed-off-by: Heinrich Schuchardt Reviewed-by: Simon Glass --- include/init.h | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/include/init.h b/include/init.h index 8873081685..dc3c1f220c 100644 --- a/include/init.h +++ b/include/init.h @@ -296,13 +296,18 @@ int checkboard(void); int show_board_info(void); /** - * Get the uppermost pointer that is valid to access + * board_get_usable_ram_top() - get uppermost address for U-Boot relocation * - * Some systems may not map all of their address space. This function allows - * boards to indicate what their highest support pointer value is for DRAM - * access. + * Some systems have reserved memory areas in high memory. By implementing this + * function boards can indicate the highest address value to be used when + * relocating U-Boot. The returned address is exclusive (i.e. 1 byte above the + * last usable address). * - * @param total_size Size of U-Boot (unused?) + * Due to overflow on systems with 32bit phys_addr_t a value 0 is used instead + * of 4GiB. + * + * @total_size: monitor length in bytes (size of U-Boot code) + * Return: uppermost address for U-Boot relocation */ phys_size_t board_get_usable_ram_top(phys_size_t total_size); -- 2.39.5