Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Signed-off-by: Stafford Horne <shorne@gmail.com>
		
			
				
	
	
		
			44 lines
		
	
	
		
			1.2 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			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.
 |