On Thu, 2024-07-18 at 12:33 +0800, Kongyang Liu wrote: > Add document for Banana Pi F3 board which based on SpacemiT's K1 SoC. > > Signed-off-by: Kongyang Liu <[email protected]> > --- > > (no changes since v1) > > 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..cf3041085f > --- /dev/null > +++ b/doc/board/spacemit/bananapi_f3.rst > @@ -0,0 +1,78 @@ > +.. SPDX-License-Identifier: GPL-2.0-or-later > + > +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
do. missing space before 2x and port rather than prot > +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 > + > +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. Hm, would be great if one could at least test it somehow on real hardware. We do have boards available BTW (;- p). > + > +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,x60 > + ID = 0, freq = 0 Hz: MMU > + 1: cpu@1 spacemit,x60 > + ID = 1, freq = 0 Hz: MMU > + 2: cpu@2 spacemit,x60 > + ID = 2, freq = 0 Hz: MMU > + 3: cpu@3 spacemit,x60 > + ID = 3, freq = 0 Hz: MMU > + 4: cpu@4 spacemit,x60 > + ID = 4, freq = 0 Hz: MMU > + 5: cpu@5 spacemit,x60 > + ID = 5, freq = 0 Hz: MMU > + 6: cpu@6 spacemit,x60 > + ID = 6, freq = 0 Hz: MMU > + 7: cpu@7 spacemit,x60 > + ID = 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..78081a47ff > --- /dev/null > +++ b/doc/board/spacemit/index.rst > @@ -0,0 +1,8 @@ > +.. SPDX-License-Identifier: GPL-2.0-or-later > + > +SpacemiT > +======== > +.. toctree:: > + :maxdepth: 1 > + > + bananapi_f3 do.
