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