1Aspeed family boards (``*-bmc``, ``ast2500-evb``, ``ast2600-evb``) 2================================================================== 3 4The QEMU Aspeed machines model BMCs of various OpenPOWER systems and 5Aspeed evaluation boards. They are based on different releases of the 6Aspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the 7AST2500 with an ARM1176JZS CPU (800MHz) and more recently the AST2600 8with dual cores ARM Cortex-A7 CPUs (1.2GHz). 9 10The SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C, 11etc. 12 13AST2400 SoC based machines : 14 15- ``palmetto-bmc`` OpenPOWER Palmetto POWER8 BMC 16- ``quanta-q71l-bmc`` OpenBMC Quanta BMC 17- ``supermicrox11-bmc`` Supermicro X11 BMC 18 19AST2500 SoC based machines : 20 21- ``ast2500-evb`` Aspeed AST2500 Evaluation board 22- ``romulus-bmc`` OpenPOWER Romulus POWER9 BMC 23- ``witherspoon-bmc`` OpenPOWER Witherspoon POWER9 BMC 24- ``sonorapass-bmc`` OCP SonoraPass BMC 25- ``fp5280g2-bmc`` Inspur FP5280G2 BMC 26- ``g220a-bmc`` Bytedance G220A BMC 27 28AST2600 SoC based machines : 29 30- ``ast2600-evb`` Aspeed AST2600 Evaluation board (Cortex-A7) 31- ``tacoma-bmc`` OpenPOWER Witherspoon POWER9 AST2600 BMC 32- ``rainier-bmc`` IBM Rainier POWER10 BMC 33- ``fuji-bmc`` Facebook Fuji BMC 34 35Supported devices 36----------------- 37 38 * SMP (for the AST2600 Cortex-A7) 39 * Interrupt Controller (VIC) 40 * Timer Controller 41 * RTC Controller 42 * I2C Controller 43 * System Control Unit (SCU) 44 * SRAM mapping 45 * X-DMA Controller (basic interface) 46 * Static Memory Controller (SMC or FMC) - Only SPI Flash support 47 * SPI Memory Controller 48 * USB 2.0 Controller 49 * SD/MMC storage controllers 50 * SDRAM controller (dummy interface for basic settings and training) 51 * Watchdog Controller 52 * GPIO Controller (Master only) 53 * UART 54 * Ethernet controllers 55 * Front LEDs (PCA9552 on I2C bus) 56 * LPC Peripheral Controller (a subset of subdevices are supported) 57 * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA 58 * ADC 59 60 61Missing devices 62--------------- 63 64 * Coprocessor support 65 * PWM and Fan Controller 66 * Slave GPIO Controller 67 * Super I/O Controller 68 * PCI-Express 1 Controller 69 * Graphic Display Controller 70 * PECI Controller 71 * MCTP Controller 72 * Mailbox Controller 73 * Virtual UART 74 * eSPI Controller 75 * I3C Controller 76 77Boot options 78------------ 79 80The Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options 81to load a Linux kernel or from a firmware. Images can be downloaded from the 82OpenBMC jenkins : 83 84 https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/ 85 86or directly from the OpenBMC GitHub release repository : 87 88 https://github.com/openbmc/openbmc/releases 89 90To boot a kernel directly from a Linux build tree: 91 92.. code-block:: bash 93 94 $ qemu-system-arm -M ast2600-evb -nographic \ 95 -kernel arch/arm/boot/zImage \ 96 -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \ 97 -initrd rootfs.cpio 98 99The image should be attached as an MTD drive. Run : 100 101.. code-block:: bash 102 103 $ qemu-system-arm -M romulus-bmc -nic user \ 104 -drive file=obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd -nographic 105 106Options specific to Aspeed machines are : 107 108 * ``execute-in-place`` which emulates the boot from the CE0 flash 109 device by using the FMC controller to load the instructions, and 110 not simply from RAM. This takes a little longer. 111 112 * ``fmc-model`` to change the FMC Flash model. FW needs support for 113 the chip model to boot. 114 115 * ``spi-model`` to change the SPI Flash model. 116 117For instance, to start the ``ast2500-evb`` machine with a different 118FMC chip and a bigger (64M) SPI chip, use : 119 120.. code-block:: bash 121 122 -M ast2500-evb,fmc-model=mx25l25635e,spi-model=mx66u51235f 123