From: Kongyang Liu <seashell11234455@gmail.com>
To: u-boot@lists.denx.de
Cc: Adam Ford <aford173@gmail.com>,
Chris Morgan <macromorgan@hotmail.com>,
Fabio Estevam <festevam@denx.de>,
Heinrich Schuchardt <xypron.glpk@gmx.de>,
Kever Yang <kever.yang@rock-chips.com>,
Nishanth Menon <nm@ti.com>,
Ralph Siemsen <ralph.siemsen@linaro.org>,
Svyatoslav Ryhel <clamor95@gmail.com>,
Thierry Reding <treding@nvidia.com>,
Tim Harvey <tharvey@gateworks.com>, Tom Rini <trini@konsulko.com>,
Wei Fu <wefu@redhat.com>,
Yanhong Wang <yanhong.wang@starfivetech.com>,
Yannic Moog <y.moog@phytec.de>, Yixun Lan <dlan@gentoo.org>
Subject: [PATCH v3 3/3] doc: sophgo: milkv_duo: document Milk-V Duo board
Date: Sun, 21 Jan 2024 23:05:15 +0800 [thread overview]
Message-ID: <20240121150630.30588-4-seashell11234455@gmail.com> (raw)
In-Reply-To: <20240121150630.30588-1-seashell11234455@gmail.com>
Add document for Milk-V Duo board which based on Sophgo's CV1800B SoC.
Signed-off-by: Kongyang Liu <seashell11234455@gmail.com>
---
Changes in v3:
- Add brief description of the procedure to run u-boot-dtb.bin
doc/board/index.rst | 1 +
doc/board/sophgo/index.rst | 8 +++++
doc/board/sophgo/milkv_duo.rst | 64 ++++++++++++++++++++++++++++++++++
3 files changed, 73 insertions(+)
create mode 100644 doc/board/sophgo/index.rst
create mode 100644 doc/board/sophgo/milkv_duo.rst
diff --git a/doc/board/index.rst b/doc/board/index.rst
index c96e5fda28..d0f9f355d2 100644
--- a/doc/board/index.rst
+++ b/doc/board/index.rst
@@ -46,6 +46,7 @@ Board-specific doc
sifive/index
sipeed/index
socionext/index
+ sophgo/index
st/index
starfive/index
ste/index
diff --git a/doc/board/sophgo/index.rst b/doc/board/sophgo/index.rst
new file mode 100644
index 0000000000..e097afdac6
--- /dev/null
+++ b/doc/board/sophgo/index.rst
@@ -0,0 +1,8 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+Sophgo
+======
+.. toctree::
+ :maxdepth: 1
+
+ milkv_duo
diff --git a/doc/board/sophgo/milkv_duo.rst b/doc/board/sophgo/milkv_duo.rst
new file mode 100644
index 0000000000..cb2ed1ad98
--- /dev/null
+++ b/doc/board/sophgo/milkv_duo.rst
@@ -0,0 +1,64 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+Milk-V Duo
+==========
+
+CV1800B RISC-V SoC
+------------------
+The CV1800B is a high-performance, low-power 1+1 64-bit RISC-V SoC from Sophgo.
+
+Mainline support
+----------------
+The support for following drivers are already enabled:
+1. ns16550 UART Driver.
+
+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>
+ cd <U-Boot-dir>
+ make milkv_duo_defconfig
+ make
+
+This will generate u-boot-dtb.bin
+
+Booting
+~~~~~~~
+Currently, we rely on vendor FSBL(First Stage Boot Loader) to initialize the
+clock and load the u-boot image, then bootup from it.
+
+Alternatively, to run u-boot-dtb.bin on top of FSBL, follow these steps:
+
+1. Use the vendor-provided tool to create a unified fip.bin file containing
+ FSBL, OpenSBI, and U-Boot.
+
+2. Place the generated fip.bin file into the FAT partition of the SD card.
+
+3. Insert the SD card into the board and power it on.
+
+The board will automatically execute the FSBL from the fip.bin file.
+Subsequently, it will transition to OpenSBI, and finally, OpenSBI will invoke
+U-Boot.
+
+
+Sample boot log from Milk-V Duo board
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. code-block:: none
+
+ U-Boot 2024.01-rc5-00010-g51965baa36 (Dec 28 2023 - 13:15:53 +0800)milkv_duo
+
+ DRAM: 63.3 MiB
+ Core: 10 devices, 8 uclasses, devicetree: separate
+ Loading Environment from nowhere... OK
+ In: serial@4140000
+ Out: serial@4140000
+ Err: serial@4140000
+ Net: No ethernet found.
+ milkv_duo# cpu detail
+ 0: cpu@0 rv64imafdc
+ ID = 0, freq = 0 Hz: L1 cache, MMU
+ milkv_duo#
--
2.41.0
prev parent reply other threads:[~2024-01-21 15:11 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-01-21 15:05 [PATCH v3 0/3] riscv: sophgo: milkv_duo: add support for Milk-V Duo board Kongyang Liu
2024-01-21 15:05 ` [PATCH v3 1/3] riscv: dts: sophgo: add basic device tree " Kongyang Liu
2024-01-27 16:07 ` Yixun Lan
2024-01-21 15:05 ` [PATCH v3 2/3] riscv: sophgo: milkv_duo: initial support added Kongyang Liu
2024-01-21 15:05 ` Kongyang Liu [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240121150630.30588-4-seashell11234455@gmail.com \
--to=seashell11234455@gmail.com \
--cc=aford173@gmail.com \
--cc=clamor95@gmail.com \
--cc=dlan@gentoo.org \
--cc=festevam@denx.de \
--cc=kever.yang@rock-chips.com \
--cc=macromorgan@hotmail.com \
--cc=nm@ti.com \
--cc=ralph.siemsen@linaro.org \
--cc=tharvey@gateworks.com \
--cc=treding@nvidia.com \
--cc=trini@konsulko.com \
--cc=u-boot@lists.denx.de \
--cc=wefu@redhat.com \
--cc=xypron.glpk@gmx.de \
--cc=y.moog@phytec.de \
--cc=yanhong.wang@starfivetech.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.