system/riscv/microchip-icicle-kit.rst

1 Microchip PolarFire SoC Icicle Kit (``microchip-icicle-kit``)
5 SiFive's E51 plus four U54 cores and many on-chip peripherals and an FPGA.
8 https://www.microchip.com/en-us/products/fpgas-and-plds/system-on-chip-fpgas/polarfire-soc-fpgas
11 https://www.microchip.com/en-us/development-tool/mpfs-icicle-kit-es
14 -----------------
16 The ``microchip-icicle-kit`` machine supports the following devices:
21 * Platform-Level Interrupt Controller (PLIC)
22 * L2 Loosely Integrated Memory (L2-LIM)
34 ------------
36 The ``microchip-icicle-kit`` machine provides some options to run a firmware
41 -bios          -kernel    firmware
46 NULL, default           Y opensbi-riscv64-generic-fw_dynamic.bin
51 ------------------
53 Use the ``-kernel`` option to directly run a kernel image.  When a direct
54 kernel boot is requested, a device tree blob may be specified via the ``-dtb``
60   of subnodes should match QEMU's ``-smp`` option.
62 * The ``/memory`` reg size should match QEMU’s selected RAM size via the ``-m``
68 When ``-bios`` is not specified or set to ``default``, the OpenSBI
70 S-mode payload like U-Boot or OS kernel directly.
72 For example, the following commands show building a U-Boot image from U-Boot
75 .. code-block:: bash
77   $ export CROSS_COMPILE=riscv64-linux-
82 .. code-block:: bash
84   $ qemu-system-riscv64 -M microchip-icicle-kit -smp 5 -m 2G \
85       -sd path/to/sdcard.img \
86       -nic user,model=cadence_gem \
87       -nic tap,ifname=tap,model=cadence_gem,script=no \
88       -display none -serial stdio \
89       -kernel path/to/u-boot/build/dir/u-boot.bin \
90       -dtb path/to/u-boot/build/dir/u-boot.dtb
94 * Check the "stdout-path" property in the /chosen node in the DTB to determine
96   to the second serial port, change to use "-serial null -serial stdio".
97 * The default U-Boot configuration uses CONFIG_OF_SEPARATE hence the ELF image
98   ``u-boot`` cannot be passed to "-kernel" as it does not contain the DTB hence
99   ``u-boot.bin`` has to be used which does contain one. To use the ELF image,
103 -----------
105 The machine ``microchip-icicle-kit`` used to run the Hart Software Services
111 .. _HSS: https://github.com/polarfire-soc/hart-software-services