From f7f9d083854ac7830853575b5c2693a5f2e59a55 Mon Sep 17 00:00:00 2001 From: Paul Kocialkowski Date: Sun, 24 May 2015 12:01:53 +0200 Subject: [PATCH] fdt: Documentation for a few support functions aside their prototypes This instroduces comments that explain the purpose, parameters and return codes of a few fdt support functions, that are used to fill the fdt. Signed-off-by: Paul Kocialkowski Acked-by: Simon Glass --- include/fdt_support.h | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/include/fdt_support.h b/include/fdt_support.h index 4468aa45f6..2ace1550ef 100644 --- a/include/fdt_support.h +++ b/include/fdt_support.h @@ -16,9 +16,35 @@ uint32_t fdt_getprop_u32_default_node(const void *fdt, int off, int cell, const char *prop, const uint32_t dflt); uint32_t fdt_getprop_u32_default(const void *fdt, const char *path, const char *prop, const uint32_t dflt); + +/** + * Add data to the root of the FDT before booting the OS. + * + * See doc/device-tree-bindings/root.txt + * + * @param fdt FDT address in memory + * @return 0 if ok, or -FDT_ERR_... on error + */ int fdt_root(void *fdt); + +/** + * Add chosen data the FDT before booting the OS. + * + * In particular, this adds the kernel command line (bootargs) to the FDT. + * + * @param fdt FDT address in memory + * @return 0 if ok, or -FDT_ERR_... on error + */ int fdt_chosen(void *fdt); + +/** + * Add initrd information to the FDT before booting the OS. + * + * @param fdt FDT address in memory + * @return 0 if ok, or -FDT_ERR_... on error + */ int fdt_initrd(void *fdt, ulong initrd_start, ulong initrd_end); + void do_fixup_by_path(void *fdt, const char *path, const char *prop, const void *val, int len, int create); void do_fixup_by_path_u32(void *fdt, const char *path, const char *prop, -- 2.39.2