xref: /openbmc/qemu/docs/system/openrisc/or1k-sim.rst (revision df22fbb7)
1Or1ksim board
2=============
3
4The QEMU Or1ksim machine emulates the standard OpenRISC board simulator which is
5also the standard SoC configuration.
6
7Supported devices
8-----------------
9
10 * 16550A UART
11 * ETHOC Ethernet controller
12 * SMP (OpenRISC multicore using ompic)
13
14Boot options
15------------
16
17The Or1ksim machine can be started using the ``-kernel`` and ``-initrd`` options
18to load a Linux kernel and optional disk image.
19
20.. code-block:: bash
21
22  $ qemu-system-or1k -cpu or1220 -M or1k-sim -nographic \
23        -kernel vmlinux \
24        -initrd initramfs.cpio.gz \
25        -m 128
26
27Linux guest kernel configuration
28""""""""""""""""""""""""""""""""
29
30The 'or1ksim_defconfig' for Linux openrisc kernels includes the right
31drivers for the or1ksim machine.  If you would like to run an SMP system
32choose the 'simple_smp_defconfig' config.
33
34Hardware configuration information
35""""""""""""""""""""""""""""""""""
36
37The ``or1k-sim`` board automatically generates a device tree blob ("dtb")
38which it passes to the guest. This provides information about the
39addresses, interrupt lines and other configuration of the various devices
40in the system.
41
42The location of the DTB will be passed in register ``r3`` to the guest operating
43system.
44