qemu/docs/system/openrisc/or1k-sim.rst
Stafford Horne b14df228d7 docs/system: openrisc: Add OpenRISC documentation
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Signed-off-by: Stafford Horne <shorne@gmail.com>
2022-09-04 07:02:57 +01:00

44 lines
1.2 KiB
ReStructuredText

Or1ksim board
=============
The QEMU Or1ksim machine emulates the standard OpenRISC board simulator which is
also the standard SoC configuration.
Supported devices
-----------------
* 16550A UART
* ETHOC Ethernet controller
* SMP (OpenRISC multicore using ompic)
Boot options
------------
The Or1ksim machine can be started using the ``-kernel`` and ``-initrd`` options
to load a Linux kernel and optional disk image.
.. code-block:: bash
$ qemu-system-or1k -cpu or1220 -M or1k-sim -nographic \
-kernel vmlinux \
-initrd initramfs.cpio.gz \
-m 128
Linux guest kernel configuration
""""""""""""""""""""""""""""""""
The 'or1ksim_defconfig' for Linux openrisc kernels includes the right
drivers for the or1ksim machine. If you would like to run an SMP system
choose the 'simple_smp_defconfig' config.
Hardware configuration information
""""""""""""""""""""""""""""""""""
The ``or1k-sim`` board automatically generates a device tree blob ("dtb")
which it passes to the guest. This provides information about the
addresses, interrupt lines and other configuration of the various devices
in the system.
The location of the DTB will be passed in register ``r3`` to the guest operating
system.