aboutsummaryrefslogtreecommitdiff
path: root/docs/system/riscv/xiangshan-kunminghu.rst
blob: 46e7ceeda065ece04734210511f70d80d1e59b54 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
BOSC Xiangshan Kunminghu FPGA prototype platform (``xiangshan-kunminghu``)
==========================================================================
The ``xiangshan-kunminghu`` machine is compatible with our FPGA prototype
platform.

XiangShan is an open-source high-performance RISC-V processor project.
The third generation processor is called Kunminghu. Kunminghu is a 64-bit
RV64GCBSUHV processor core. More information can be found in our Github
repository:
https://github.com/OpenXiangShan/XiangShan

Supported devices
-----------------
The ``xiangshan-kunminghu`` machine supports the following devices:

* Up to 16 xiangshan-kunminghu cores
* Core Local Interruptor (CLINT)
* Incoming MSI Controller (IMSIC)
* Advanced Platform-Level Interrupt Controller (APLIC)
* 1 UART

Boot options
------------
The ``xiangshan-kunminghu`` machine can start using the standard ``-bios``
functionality for loading the boot image. You need to compile and link
the firmware, kernel, and Device Tree (FDT) into a single binary file,
such as ``fw_payload.bin``.

Running
-------
Below is an example command line for running the ``xiangshan-kunminghu``
machine:

.. code-block:: bash

   $ qemu-system-riscv64 -machine xiangshan-kunminghu \
      -smp 16 -m 16G \
      -bios path/to/opensbi/platform/generic/firmware/fw_payload.bin \
      -nographic