Hi On 11:11 Thu 14 Nov , Heinrich Schuchardt wrote: > On 11/14/24 08:21, Huan Zhou wrote: > > From: Kongyang Liu <seashell11234...@gmail.com> > > > > Add document for Banana Pi F3 board which based on SpacemiT's K1 SoC. > > > > Signed-off-by: Kongyang Liu <seashell11234...@gmail.com> > > Signed-off-by: Huan Zhou <pericycle...@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(+) > > > > diff --git a/doc/board/index.rst b/doc/board/index.rst > > index > > 417c128c7af6ad2267ef1bc743c7f10ae70b6de7..367da2d62316d4cab25ecc53f852ef742eba13dd > > 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 > > 0000000000000000000000000000000000000000..ae98a784a7f19a28658b2d6acad0679cf0a4faa3 > > --- /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 > > +---------- > > Thank you for documenting the new board. > > For such a short article we don't need three levels of sections: > > Banana Pi F3 > |- About This > | |- Building > | |- Booting. > > The 'About This' title could be completely removed. Otherwise, please, > put it on the same level as the other sub-sections. > > > +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 port, 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. > > If we use CROSS_COMPILE, the toolchain does not need to be on the PATH. > You could use an absolute path like > > CROSS_COMPILE=/home/user/my_tools_dir/riscv64-linux-gnu- > > > +2. Setup ARCH & cross compilation environment variable: > > Environment variable ARCH is not used when building U-Boot. > The only usage is in scripts/decodecode. > > > + > > +.. 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. > > Could you, please, describe how to build and use the 'modified vendor's > U-Boot SPL' so that others can test and contribute. > I suspect there might be some patches needed, but fine if we can do it manually via command,
in additio to "for others to test and contribute", describing how to flash the firmware to storage (either sd/emmc/spiflash) would be also required, vendor using fastboot.. > Best regards > > Heinrich > > > + > > +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 > > 0000000000000000000000000000000000000000..3fb7d804ac8fc8dd4c7ee67ffc877f9ad323162d > > --- /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 > > > -- Yixun Lan (dlan) Gentoo Linux Developer GPG Key ID AABEFD55
