| 1 | Or1ksim board |
| 2 | ============= |
| 3 | |
| 4 | The QEMU Or1ksim machine emulates the standard OpenRISC board simulator which is |
| 5 | also the standard SoC configuration. |
| 6 | |
| 7 | Supported devices |
| 8 | ----------------- |
| 9 | |
| 10 | * 16550A UART |
| 11 | * ETHOC Ethernet controller |
| 12 | * SMP (OpenRISC multicore using ompic) |
| 13 | |
| 14 | Boot options |
| 15 | ------------ |
| 16 | |
| 17 | The Or1ksim machine can be started using the ``-kernel`` and ``-initrd`` options |
| 18 | to 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 | |
| 27 | Linux guest kernel configuration |
| 28 | """""""""""""""""""""""""""""""" |
| 29 | |
| 30 | The 'or1ksim_defconfig' for Linux openrisc kernels includes the right |
| 31 | drivers for the or1ksim machine. If you would like to run an SMP system |
| 32 | choose the 'simple_smp_defconfig' config. |
| 33 | |
| 34 | Hardware configuration information |
| 35 | """""""""""""""""""""""""""""""""" |
| 36 | |
| 37 | The ``or1k-sim`` board automatically generates a device tree blob ("dtb") |
| 38 | which it passes to the guest. This provides information about the |
| 39 | addresses, interrupt lines and other configuration of the various devices |
| 40 | in the system. |
| 41 | |
| 42 | The location of the DTB will be passed in register ``r3`` to the guest operating |
| 43 | system. |