[PATCH v7 2/2] doc: spacemit: bananapi_f3: document Banana Pi F3 board

Huan Zhou pericycle.cc at gmail.com
Sun Dec 15 05:54:57 CET 2024


On Sat, Dec 14, 2024 at 10:31:40PM +0100, Heinrich Schuchardt wrote:
> Am 14. Dezember 2024 08:30:22 MEZ schrieb Huan Zhou <pericycle.cc at gmail.com>:
> >From: Kongyang Liu <seashell11234455 at gmail.com>
> >
> >Add document for Banana Pi F3 board which based on SpacemiT's K1 SoC.
> >
> >Signed-off-by: Kongyang Liu <seashell11234455 at gmail.com>
> >Signed-off-by: Huan Zhou <pericycle.cc at gmail.com>
> >Tested-by: Marcel Ziswiler <marcel at ziswiler.com>
> >Reviewed-by: Yixun Lan <dlan at gentoo.org>
> >---
> > doc/board/index.rst                |   1 +
> > doc/board/spacemit/bananapi-f3.rst | 106 +++++++++++++++++++++++++++++++++++++
> > doc/board/spacemit/index.rst       |   9 ++++
> > 3 files changed, 116 insertions(+)
> >
> >diff --git a/doc/board/index.rst b/doc/board/index.rst
> >index b54c1748d57ece029f0f3ab829956dc893e7f5d7..b1c470eb2cbb1c07f907eb2282039520c219c72a 100644
> >--- a/doc/board/index.rst
> >+++ b/doc/board/index.rst
> >@@ -55,6 +55,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 0000000000000000000000000000000000000000..54b412775e458ee7a8cd436d7a1f1c6ac70744f6
> >--- /dev/null
> >+++ b/doc/board/spacemit/bananapi-f3.rst
> >@@ -0,0 +1,106 @@
> >+.. SPDX-License-Identifier: GPL-2.0-or-later
> >+
> >+Banana Pi BPI-F3
> >+============
> >+
> >+Building
> >+~~~~~~~~
> >+1. Install the spacemit riscv cross compile toolchain_, or skip it if riscv toolchain is installed.
> 
> Thanks a lot for providing the documentation. Just some nits:
> 
> %/spacemit/SpacemiT/
fix, thx:)
> 
> >+
> >+.. _toolchain: https://archive.spacemit.com/toolchain/
> >+
> >+2. Setup cross compilation environment variable:
> >+
> >+.. code-block:: console
> >+
> >+   export CROSS_COMPILE=<riscv64 toolchain prefix, e.g /opt/spacemit/bin/riscv64-unknown-linux-gnu->
> >+
> >+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
> >+
> >+Burning
> >+~~~~~~~~
> >+Actually, we can replace the uboot part
> 
> %s/part/partition/
> 
>  from bianbu linux which is the bsp_ to
> 
> %s/from bianbu linux/of Bianbu Linux/
> 
> Bianbu Linux may be a part of the board support package but it is not the complete BSP. So how about:
> 
> which is provided as part of the BSP
> 
>From bianbu linux official link[1], it writes:
```
Bianbu Linux is the BSP (Board Support Package) for the Spacemit Stone series chips, including the SDK (Software Development Kit). 
```

Link: https://bianbu-linux.spacemit.com/en/ [1]
i think is should be the complete bsp(include linux, opensbi and u-boot in the img it provide)...

>  validate  patch,
> >+use `balena etcher` to burn the bianbu-minimal.img to the sd card,
> >+and replace the /dev/sdx4 where places the uboot_ with the `u-boot.itb` generated from this patch.
> >+Or use fastboot:
> >+Collect FSBL.bin, u-boot.itb, partition_2M.json, bootinfo_spinor.bin
> >+u-boot-env-default.bin, fw_dynamic.itb from vendor sdk
> 
> %s/sdk/SDK/
Got it.
> 
> Best regards
> 
> Heinrich
> 
> >+
> >+.. code-block:: console
> >+
> >+   fastboot stage FSBL.bin
> >+   fastboot continue
> >+   fastboot stage u-boot.itb-vendor # the itb from vendor uboot
> >+   fastboot continue
> >+
> >+   fastboot flash mtd partition_2M.json
> >+   fastboot flash bootinfo bootinfo_spinor.bin
> >+   fastboot flash fsbl FSBL.bin
> >+   fastboot flash env u-boot-env-default.bin
> >+   fastboot flash opensbi fw_dynamic.itb
> >+
> >+   fastboot flash uboot u-boot.itb-mainline # the itb from mainline uboot
> >+
> >+.. _bsp: https://archive.spacemit.com/image/k1/version/bianbu/v2.0/
> >+.. _uboot: https://bianbu-linux.spacemit.com/en/device/boot#21-firmware-layout
> >+
> >+Booting
> >+~~~~~~~
> >+Sample boot log from Banana Pi BPI-F3 board
> >+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> >+.. code-block:: none
> >+
> >+   try sd...
> >+   bm:3
> >+   j...
> >+
> >+   U-Boot SPL 2022.10spacemit-dirty (Oct 21 2024 - 09:01:13 +0000)
> >+   [   0.279] DDR type LPDDR4X
> >+   [   0.292] lpddr4_silicon_init consume 13ms
> >+   [   0.293] Change DDR data rate to 2400MT/s
> >+   [   0.430] ## Checking hash(es) for config conf-1 ... OK
> >+   [   0.432] ## Checking hash(es) for Image opensbi ... OK
> >+   [   0.437] ## Checking hash(es) for Image uboot ... OK
> >+   [   0.443] ## Checking hash(es) for Image fdt-1 ... OK
> >+   [   0.488] ## Checking hash(es) for config config_1 ... OK
> >+   [   0.490] ## Checking hash(es) for Image opensbi ... crc32+ OK
> >+
> >+
> >+   U-Boot 2024.10-rc4-00462-g5b138cfcc587-dirty (Nov 28 2024 - 14:56:49 +0800)
> >+
> >+   DRAM:  4 GiB
> >+   Core:  19 devices, 8 uclasses, devicetree: separate
> >+   Loading Environment from nowhere... OK
> >+   In:    serial at d4017000
> >+   Out:   serial at d4017000
> >+   Err:   serial at d4017000
> >+   Net:   No ethernet found.
> >+   => cpu list
> >+   0: cpu at 0      spacemit,x60
> >+   1: cpu at 1      spacemit,x60
> >+   2: cpu at 2      spacemit,x60
> >+   3: cpu at 3      spacemit,x60
> >+   4: cpu at 4      spacemit,x60
> >+   5: cpu at 5      spacemit,x60
> >+   6: cpu at 6      spacemit,x60
> >+   7: cpu at 7      spacemit,x60
> >+   => test
> >+   =>
> >+
> >diff --git a/doc/board/spacemit/index.rst b/doc/board/spacemit/index.rst
> >new file mode 100644
> >index 0000000000000000000000000000000000000000..e7d3d94e4599fbeb8da16c8a837e777a0be06227
> >--- /dev/null
> >+++ b/doc/board/spacemit/index.rst
> >@@ -0,0 +1,9 @@
> >+.. SPDX-License-Identifier: GPL-2.0-or-later
> >+
> >+SpacemiT
> >+========
> >+.. toctree::
> >+   :maxdepth: 1
> >+
> >+   bananapi-f3
> >+
> >
> 


More information about the U-Boot mailing list