mirror of
				https://github.com/qemu/qemu.git
				synced 2025-10-31 04:06:46 +00:00 
			
		
		
		
	 12bff81b4d
			
		
	
	
		12bff81b4d
		
	
	
	
	
		
			
			Document the 3 front LEDs modeled on the OpenPOWER Witherspoon BMC
(see commit 7cfbde5ea1 "hw/arm/aspeed: Add the 3 front LEDs drived
by the PCA9552 #1").
Reviewed-by: Cédric Le Goater <clg@kaod.org>
Signed-off-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Message-id: 20201120173953.2539469-4-f4bug@amsat.org
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
		
	
			
		
			
				
	
	
		
			105 lines
		
	
	
		
			3.0 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			105 lines
		
	
	
		
			3.0 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
| Aspeed family boards (``*-bmc``, ``ast2500-evb``, ``ast2600-evb``)
 | |
| ==================================================================
 | |
| 
 | |
| The QEMU Aspeed machines model BMCs of various OpenPOWER systems and
 | |
| Aspeed evaluation boards. They are based on different releases of the
 | |
| Aspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the
 | |
| AST2500 with an ARM1176JZS CPU (800MHz) and more recently the AST2600
 | |
| with dual cores ARM Cortex A7 CPUs (1.2GHz).
 | |
| 
 | |
| The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C,
 | |
| etc.
 | |
| 
 | |
| AST2400 SoC based machines :
 | |
| 
 | |
| - ``palmetto-bmc``         OpenPOWER Palmetto POWER8 BMC
 | |
| 
 | |
| AST2500 SoC based machines :
 | |
| 
 | |
| - ``ast2500-evb``          Aspeed AST2500 Evaluation board
 | |
| - ``romulus-bmc``          OpenPOWER Romulus POWER9 BMC
 | |
| - ``witherspoon-bmc``      OpenPOWER Witherspoon POWER9 BMC
 | |
| - ``sonorapass-bmc``       OCP SonoraPass BMC
 | |
| - ``swift-bmc``            OpenPOWER Swift BMC POWER9
 | |
| 
 | |
| AST2600 SoC based machines :
 | |
| 
 | |
| - ``ast2600-evb``          Aspeed AST2600 Evaluation board (Cortex A7)
 | |
| - ``tacoma-bmc``           OpenPOWER Witherspoon POWER9 AST2600 BMC
 | |
| 
 | |
| Supported devices
 | |
| -----------------
 | |
| 
 | |
|  * SMP (for the AST2600 Cortex-A7)
 | |
|  * Interrupt Controller (VIC)
 | |
|  * Timer Controller
 | |
|  * RTC Controller
 | |
|  * I2C Controller
 | |
|  * System Control Unit (SCU)
 | |
|  * SRAM mapping
 | |
|  * X-DMA Controller (basic interface)
 | |
|  * Static Memory Controller (SMC or FMC) - Only SPI Flash support
 | |
|  * SPI Memory Controller
 | |
|  * USB 2.0 Controller
 | |
|  * SD/MMC storage controllers
 | |
|  * SDRAM controller (dummy interface for basic settings and training)
 | |
|  * Watchdog Controller
 | |
|  * GPIO Controller (Master only)
 | |
|  * UART
 | |
|  * Ethernet controllers
 | |
|  * Front LEDs (PCA9552 on I2C bus)
 | |
| 
 | |
| 
 | |
| Missing devices
 | |
| ---------------
 | |
| 
 | |
|  * Coprocessor support
 | |
|  * ADC (out of tree implementation)
 | |
|  * PWM and Fan Controller
 | |
|  * LPC Bus Controller
 | |
|  * Slave GPIO Controller
 | |
|  * Super I/O Controller
 | |
|  * Hash/Crypto Engine
 | |
|  * PCI-Express 1 Controller
 | |
|  * Graphic Display Controller
 | |
|  * PECI Controller
 | |
|  * MCTP Controller
 | |
|  * Mailbox Controller
 | |
|  * Virtual UART
 | |
|  * eSPI Controller
 | |
|  * I3C Controller
 | |
| 
 | |
| Boot options
 | |
| ------------
 | |
| 
 | |
| The Aspeed machines can be started using the -kernel option to load a
 | |
| Linux kernel or from a firmware image which can be downloaded from the
 | |
| OpenPOWER jenkins :
 | |
| 
 | |
|    https://openpower.xyz/
 | |
| 
 | |
| The image should be attached as an MTD drive. Run :
 | |
| 
 | |
| .. code-block:: bash
 | |
| 
 | |
|   $ qemu-system-arm -M romulus-bmc -nic user \
 | |
| 	-drive file=flash-romulus,format=raw,if=mtd -nographic
 | |
| 
 | |
| Options specific to Aspeed machines are :
 | |
| 
 | |
|  * ``execute-in-place`` which emulates the boot from the CE0 flash
 | |
|    device by using the FMC controller to load the instructions, and
 | |
|    not simply from RAM. This takes a little longer.
 | |
| 
 | |
|  * ``fmc-model`` to change the FMC Flash model. FW needs support for
 | |
|    the chip model to boot.
 | |
| 
 | |
|  * ``spi-model`` to change the SPI Flash model.
 | |
| 
 | |
| For instance, to start the ``ast2500-evb`` machine with a different
 | |
| FMC chip and a bigger (64M) SPI chip, use :
 | |
| 
 | |
| .. code-block:: bash
 | |
| 
 | |
|   -M ast2500-evb,fmc-model=mx25l25635e,spi-model=mx66u51235f
 |