diff mbox series

[v4,20/22] passage: Add docs for spl_handoff

Message ID 20250510134253.1581164-14-sjg@chromium.org
State Changes Requested
Delegated to: Tom Rini
Headers show
Series passage: Define a standard for firmware data flow | expand

Commit Message

Simon Glass May 10, 2025, 1:42 p.m. UTC
This tag already exists in U-Boot. Add documentation, following the
format set out.

Signed-off-by: Simon Glass <sjg@chromium.org>
---

(no changes since v1)

 board/sandbox/stdpass_check.c | 15 ++++++++-------
 include/handoff.h             | 10 +++++++---
 2 files changed, 15 insertions(+), 10 deletions(-)
diff mbox series

Patch

diff --git a/board/sandbox/stdpass_check.c b/board/sandbox/stdpass_check.c
index 2244a90c3ba..d04f41137c1 100644
--- a/board/sandbox/stdpass_check.c
+++ b/board/sandbox/stdpass_check.c
@@ -6,13 +6,6 @@ 
  * Copyright 2021 Google LLC
  */
 
-/* BLOBLISTT_U_BOOT_SPL_HANDOFF */
-#include <handoff.h>
-void check_spl_handoff(void)
-{
-	__maybe_unused struct spl_handoff check;
-};
-
 /*
  * See also doc/develop/std_passage.rst
  *
@@ -33,3 +26,11 @@  void check_struct_name(void)
 {
 	/* __maybe_unused struct struct_name check; */
 }
+
+/* BLOBLISTT_U_BOOT_SPL_HANDOFF */
+#include <handoff.h>
+void check_spl_handoff(void)
+{
+	__maybe_unused struct spl_handoff check;
+};
+
diff --git a/include/handoff.h b/include/handoff.h
index c0ae7b19a75..c7e6e4746bf 100644
--- a/include/handoff.h
+++ b/include/handoff.h
@@ -8,18 +8,24 @@ 
 #ifndef __HANDOFF_H
 #define __HANDOFF_H
 
+#include <linux/types.h>
+
 #if CONFIG_IS_ENABLED(HANDOFF)
 
-#include <linux/types.h>
 #include <asm/handoff.h>
+#endif
 
 /**
  * struct spl_handoff - information passed from SPL to U-Boot proper
  *
+ * bloblist_tag: BLOBLISTT_U_BOOT_SPL_HANDOFF
+ *
  * @ram_size: Value to use for gd->ram_size
  */
 struct spl_handoff {
+#if CONFIG_IS_ENABLED(HANDOFF)
 	struct arch_spl_handoff arch;
+#endif
 	u64 ram_size;
 	struct {
 		u64 start;
@@ -44,5 +50,3 @@  void handoff_load_dram_banks(struct spl_handoff *ho);
 int handoff_arch_save(struct spl_handoff *ho);
 
 #endif
-
-#endif