Heinrich Schuchardt xypron.glpk@gmx.de 于2024年7月14日周日 23:19写道：
On 7/14/24 17:08, Kongyang Liu wrote:
Add document for Banana Pi F3 board which based on SpacemiT's K1 SoC.
Signed-off-by: Kongyang Liu seashell11234455@gmail.com
doc/board/index.rst | 1 + doc/board/spacemit/bananapi_f3.rst | 78 ++++++++++++++++++++++++++++++ doc/board/spacemit/index.rst | 8 +++ 3 files changed, 87 insertions(+) create mode 100644 doc/board/spacemit/bananapi_f3.rst create mode 100644 doc/board/spacemit/index.rst
diff --git a/doc/board/index.rst b/doc/board/index.rst index 417c128c7a..367da2d623 100644 --- a/doc/board/index.rst +++ b/doc/board/index.rst @@ -51,6 +51,7 @@ Board-specific doc sipeed/index socionext/index sophgo/index
- spacemit/index st/index starfive/index ste/index
diff --git a/doc/board/spacemit/bananapi_f3.rst b/doc/board/spacemit/bananapi_f3.rst new file mode 100644 index 0000000000..465040b94f --- /dev/null +++ b/doc/board/spacemit/bananapi_f3.rst @@ -0,0 +1,78 @@ +.. SPDX-License-Identifier: GPL-2.0+
+Banana Pi F3 +============
+About This +---------- +Banana Pi F3 board is a industrial grade RISC-V development board, it +design with SpacemiT K1 8 core RISC-V chip, CPU integrates 2.0 TOPs AI +computing power. 4G DDR and 16G eMMC onboard.2x GbE Ethernet prot, 4x USB +3.0 and PCIe for M.2 interface, support HDMI and Dual MIPI-CSI Camera.
+Building +~~~~~~~~ +1. Add the RISC-V toolchain to your PATH. +2. Setup ARCH & cross compilation environment variable:
+.. code-block:: console
- export CROSS_COMPILE=<riscv64 toolchain prefix>
+3. Before building U-Boot, OpenSBI should be built first. OpenSBI can be +built for SpacemiT K1 SoC as below:
+.. code-block:: console
- git clone https://github.com/cyyself/opensbi -b k1-opensbi
- cd opensbi
- make PLATFORM=generic
+4. Then build U-Boot as following:
+.. code-block:: console
- cd <U-Boot-dir>
- make bananapi_f3_defconfig
- make OPENSBI=<OpenSBI-dir>/build/platform/generic/firmware/fw_dynamic.bin
+This will generate u-boot.itb
Thanks a lot for the board documentation.
Could you, please, describe how to install the u-boot.itb.
To where should it be copied? Does it need to be signed to be accepted by the vendor SPL?
In the vendor's U-Boot SPL, OpenSBI and U-Boot are loaded separately. From my observation, U-Boot seems to prefer loading a FIT image that includes both OpenSBI and U-Boot. Therefore, I modified this part to allow them to be loaded together. The modified code might be somewhat messy because I just made it work.
As a result, it is currently difficult to describe how to boot into U-Boot. Perhaps I can improve the documentation after U-Boot SPL is available for Banana Pi F3.
Best regards Kongyang Liu
Best regards
Heinrich
+Booting +~~~~~~~ +Currently, we use a modified vendor's U-Boot SPL to load a FIT image that +includes OpenSBI and U-Boot. Fully describing how to boot into U-Boot is a +challenging task. And the booting method will be added after the SPL +support is available.
+Sample boot log from Banana Pi F3 board +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. code-block:: none
- U-Boot 2024.07-00686-g608f2d51760c (Jul 08 2024 - 14:53:51 +0800)
- DRAM: 4 GiB
- Core: 18 devices, 7 uclasses, devicetree: separate
- Loading Environment from nowhere... OK
- In: serial@d4017000
- Out: serial@d4017000
- Err: serial@d4017000
- Net: No ethernet found.
- bananapi_f3# cpu detail
0: cpu@0 spacemit,x60ID = 0, freq = 0 Hz: MMU1: cpu@1 spacemit,x60ID = 1, freq = 0 Hz: MMU2: cpu@2 spacemit,x60ID = 2, freq = 0 Hz: MMU3: cpu@3 spacemit,x60ID = 3, freq = 0 Hz: MMU4: cpu@4 spacemit,x60ID = 4, freq = 0 Hz: MMU5: cpu@5 spacemit,x60ID = 5, freq = 0 Hz: MMU6: cpu@6 spacemit,x60ID = 6, freq = 0 Hz: MMU7: cpu@7 spacemit,x60ID = 7, freq = 0 Hz: MMU- bananapi_f3#
diff --git a/doc/board/spacemit/index.rst b/doc/board/spacemit/index.rst new file mode 100644 index 0000000000..cc2bd6ab0a --- /dev/null +++ b/doc/board/spacemit/index.rst @@ -0,0 +1,8 @@ +.. SPDX-License-Identifier: GPL-2.0+
+SpacemiT +======== +.. toctree::
- :maxdepth: 1
- bananapi_f3