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.
							 |