summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Kocialkowski <contact@paulk.fr>2015-05-24 10:01:53 (GMT)
committerSimon Glass <sjg@chromium.org>2015-06-05 14:32:58 (GMT)
commit3c4c142e5deed2a9362e65e45372044652ac57b5 (patch)
tree58363d61685146fe6eabe28ad36a2debe08d2bdf
parent10be5b5d3a8d8dd1aa8be95d339c0fdf498c3687 (diff)
downloadu-boot-3c4c142e5deed2a9362e65e45372044652ac57b5.tar.xz
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 <contact@paulk.fr> Acked-by: Simon Glass <sjg@chromium.org>
-rw-r--r--include/fdt_support.h26
1 files changed, 26 insertions, 0 deletions
diff --git a/include/fdt_support.h b/include/fdt_support.h
index 56185c9..0edc4fa 100644
--- a/include/fdt_support.h
+++ b/include/fdt_support.h
@@ -16,9 +16,35 @@ u32 fdt_getprop_u32_default_node(const void *fdt, int off, int cell,
const char *prop, const u32 dflt);
u32 fdt_getprop_u32_default(const void *fdt, const char *path,
const char *prop, const u32 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,