[PATCH v1 12/12] doc: board: starfive: Update the building guide

Hal Feng hal.feng at starfivetech.com
Mon Sep 30 17:59:19 CEST 2024


After implementing OF_UPSTREAM, v1.3b DT is set as
the default DT, so if you need to build a u-boot
for the other boards, specify DEVICE_TREE in your
compilation commands.

Signed-off-by: Hal Feng <hal.feng at starfivetech.com>
---
 doc/board/starfive/milk-v_mars.rst    |  2 +-
 doc/board/starfive/milk-v_mars_cm.rst |  2 +-
 doc/board/starfive/pine64_star64.rst  |  2 +-
 doc/board/starfive/visionfive2.rst    | 11 ++++++++++-
 4 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/doc/board/starfive/milk-v_mars.rst b/doc/board/starfive/milk-v_mars.rst
index 554932ecfd..4aaed71e93 100644
--- a/doc/board/starfive/milk-v_mars.rst
+++ b/doc/board/starfive/milk-v_mars.rst
@@ -34,7 +34,7 @@ Now build the U-Boot SPL and U-Boot proper.
 
 	cd <U-Boot-dir>
 	make starfive_visionfive2_defconfig
-	make OPENSBI=$(opensbi_dir)/build/platform/generic/firmware/fw_dynamic.bin
+	make OPENSBI=$(opensbi_dir)/build/platform/generic/firmware/fw_dynamic.bin DEVICE_TREE=starfive/jh7110-milkv-mars
 
 This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
 as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
diff --git a/doc/board/starfive/milk-v_mars_cm.rst b/doc/board/starfive/milk-v_mars_cm.rst
index 52d4e5e909..dd7ec84733 100644
--- a/doc/board/starfive/milk-v_mars_cm.rst
+++ b/doc/board/starfive/milk-v_mars_cm.rst
@@ -64,7 +64,7 @@ Now build the U-Boot SPL and U-Boot proper.
 
 	cd <U-Boot-dir>
 	make starfive_visionfive2_defconfig
-	make OPENSBI=$(opensbi_dir)/build/platform/generic/firmware/fw_dynamic.bin
+	make OPENSBI=$(opensbi_dir)/build/platform/generic/firmware/fw_dynamic.bin DEVICE_TREE=starfive/jh7110-milkv-mars
 
 This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
 as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
diff --git a/doc/board/starfive/pine64_star64.rst b/doc/board/starfive/pine64_star64.rst
index 52e9a90791..126487ad17 100644
--- a/doc/board/starfive/pine64_star64.rst
+++ b/doc/board/starfive/pine64_star64.rst
@@ -34,7 +34,7 @@ Now build the U-Boot SPL and U-Boot proper.
 
 	cd <U-Boot-dir>
 	make starfive_visionfive2_defconfig
-	make OPENSBI=$(opensbi_dir)/build/platform/generic/firmware/fw_dynamic.bin
+	make OPENSBI=$(opensbi_dir)/build/platform/generic/firmware/fw_dynamic.bin DEVICE_TREE=starfive/jh7110-pine64-star64
 
 This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
 as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
diff --git a/doc/board/starfive/visionfive2.rst b/doc/board/starfive/visionfive2.rst
index 2c68df3ce4..95ffaa627e 100644
--- a/doc/board/starfive/visionfive2.rst
+++ b/doc/board/starfive/visionfive2.rst
@@ -60,7 +60,8 @@ More detailed description of steps required to build FW_DYNAMIC firmware
 is beyond the scope of this document. Please refer OpenSBI documenation.
 (Note: OpenSBI git repo is at https://github.com/riscv/opensbi.git)
 
-Now build the U-Boot SPL and U-Boot proper
+Now build the U-Boot SPL and U-Boot proper.
+If you build for VisionFive 2 v1.3B, run
 
 .. code-block:: console
 
@@ -68,6 +69,14 @@ Now build the U-Boot SPL and U-Boot proper
 	make starfive_visionfive2_defconfig
 	make OPENSBI=$(opensbi_dir)/opensbi/build/platform/generic/firmware/fw_dynamic.bin
 
+If you build for VisionFive 2 v1.2A, run
+
+.. code-block:: console
+
+	cd <U-Boot-dir>
+	make starfive_visionfive2_defconfig
+	make OPENSBI=$(opensbi_dir)/opensbi/build/platform/generic/firmware/fw_dynamic.bin DEVICE_TREE=starfive/jh7110-starfive-visionfive-2-v1.2a
+
 This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
 as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
 
-- 
2.43.2



More information about the U-Boot mailing list