17a1e049aSCédric Le GoaterAspeed family boards (``*-bmc``, ``ast2500-evb``, ``ast2600-evb``) 27a1e049aSCédric Le Goater================================================================== 37a1e049aSCédric Le Goater 47a1e049aSCédric Le GoaterThe QEMU Aspeed machines model BMCs of various OpenPOWER systems and 57a1e049aSCédric Le GoaterAspeed evaluation boards. They are based on different releases of the 67a1e049aSCédric Le GoaterAspeed SoC : the AST2400 integrating an ARM926EJ-S CPU (400MHz), the 77a1e049aSCédric Le GoaterAST2500 with an ARM1176JZS CPU (800MHz) and more recently the AST2600 8f548f201SPeter Maydellwith dual cores ARM Cortex-A7 CPUs (1.2GHz). 97a1e049aSCédric Le Goater 107a1e049aSCédric Le GoaterThe SoC comes with RAM, Gigabit ethernet, USB, SD/MMC, USB, SPI, I2C, 117a1e049aSCédric Le Goateretc. 127a1e049aSCédric Le Goater 137a1e049aSCédric Le GoaterAST2400 SoC based machines : 147a1e049aSCédric Le Goater 157a1e049aSCédric Le Goater- ``palmetto-bmc`` OpenPOWER Palmetto POWER8 BMC 1671f5027fSPatrick Venture- ``quanta-q71l-bmc`` OpenBMC Quanta BMC 170b052414SJoel Stanley- ``supermicrox11-bmc`` Supermicro X11 BMC 187a1e049aSCédric Le Goater 197a1e049aSCédric Le GoaterAST2500 SoC based machines : 207a1e049aSCédric Le Goater 217a1e049aSCédric Le Goater- ``ast2500-evb`` Aspeed AST2500 Evaluation board 227a1e049aSCédric Le Goater- ``romulus-bmc`` OpenPOWER Romulus POWER9 BMC 237a1e049aSCédric Le Goater- ``witherspoon-bmc`` OpenPOWER Witherspoon POWER9 BMC 247a1e049aSCédric Le Goater- ``sonorapass-bmc`` OCP SonoraPass BMC 250b052414SJoel Stanley- ``fp5280g2-bmc`` Inspur FP5280G2 BMC 260b052414SJoel Stanley- ``g220a-bmc`` Bytedance G220A BMC 277a1e049aSCédric Le Goater 287a1e049aSCédric Le GoaterAST2600 SoC based machines : 297a1e049aSCédric Le Goater 30f548f201SPeter Maydell- ``ast2600-evb`` Aspeed AST2600 Evaluation board (Cortex-A7) 317a1e049aSCédric Le Goater- ``tacoma-bmc`` OpenPOWER Witherspoon POWER9 AST2600 BMC 320b052414SJoel Stanley- ``rainier-bmc`` IBM Rainier POWER10 BMC 330b052414SJoel Stanley- ``fuji-bmc`` Facebook Fuji BMC 34*1d6fb3d0SCédric Le Goater- ``bletchley-bmc`` Facebook Bletchley BMC 35264a360aSPeter Delevoryas- ``fby35-bmc`` Facebook fby35 BMC 36*1d6fb3d0SCédric Le Goater- ``qcom-dc-scm-v1-bmc`` Qualcomm DC-SCM V1 BMC 37*1d6fb3d0SCédric Le Goater- ``qcom-firework-bmc`` Qualcomm Firework BMC 387a1e049aSCédric Le Goater 397a1e049aSCédric Le GoaterSupported devices 407a1e049aSCédric Le Goater----------------- 417a1e049aSCédric Le Goater 427a1e049aSCédric Le Goater * SMP (for the AST2600 Cortex-A7) 437a1e049aSCédric Le Goater * Interrupt Controller (VIC) 447a1e049aSCédric Le Goater * Timer Controller 457a1e049aSCédric Le Goater * RTC Controller 46*1d6fb3d0SCédric Le Goater * I2C Controller, including the new register interface of the AST2600 477a1e049aSCédric Le Goater * System Control Unit (SCU) 487a1e049aSCédric Le Goater * SRAM mapping 497a1e049aSCédric Le Goater * X-DMA Controller (basic interface) 507a1e049aSCédric Le Goater * Static Memory Controller (SMC or FMC) - Only SPI Flash support 517a1e049aSCédric Le Goater * SPI Memory Controller 527a1e049aSCédric Le Goater * USB 2.0 Controller 537a1e049aSCédric Le Goater * SD/MMC storage controllers 547a1e049aSCédric Le Goater * SDRAM controller (dummy interface for basic settings and training) 557a1e049aSCédric Le Goater * Watchdog Controller 567a1e049aSCédric Le Goater * GPIO Controller (Master only) 577a1e049aSCédric Le Goater * UART 587a1e049aSCédric Le Goater * Ethernet controllers 5912bff81bSPhilippe Mathieu-Daudé * Front LEDs (PCA9552 on I2C bus) 602ecf1726SCédric Le Goater * LPC Peripheral Controller (a subset of subdevices are supported) 61c5475b3fSJoel Stanley * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA 62b662fac6SJoel Stanley * ADC 63*1d6fb3d0SCédric Le Goater * Secure Boot Controller (AST2600) 64*1d6fb3d0SCédric Le Goater * eMMC Boot Controller (dummy) 65*1d6fb3d0SCédric Le Goater * PECI Controller (minimal) 66*1d6fb3d0SCédric Le Goater * I3C Controller 677a1e049aSCédric Le Goater 687a1e049aSCédric Le Goater 697a1e049aSCédric Le GoaterMissing devices 707a1e049aSCédric Le Goater--------------- 717a1e049aSCédric Le Goater 727a1e049aSCédric Le Goater * Coprocessor support 737a1e049aSCédric Le Goater * PWM and Fan Controller 747a1e049aSCédric Le Goater * Slave GPIO Controller 757a1e049aSCédric Le Goater * Super I/O Controller 767a1e049aSCédric Le Goater * PCI-Express 1 Controller 777a1e049aSCédric Le Goater * Graphic Display Controller 787a1e049aSCédric Le Goater * MCTP Controller 797a1e049aSCédric Le Goater * Mailbox Controller 807a1e049aSCédric Le Goater * Virtual UART 817a1e049aSCédric Le Goater * eSPI Controller 827a1e049aSCédric Le Goater 837a1e049aSCédric Le GoaterBoot options 847a1e049aSCédric Le Goater------------ 857a1e049aSCédric Le Goater 869d5dcb85SJoel StanleyThe Aspeed machines can be started using the ``-kernel`` and ``-dtb`` options 879d5dcb85SJoel Stanleyto load a Linux kernel or from a firmware. Images can be downloaded from the 889d5dcb85SJoel StanleyOpenBMC jenkins : 897a1e049aSCédric Le Goater 9038b1ed6cSJoel Stanley https://jenkins.openbmc.org/job/ci-openbmc/lastSuccessfulBuild/ 91d029c729SCédric Le Goater 92d029c729SCédric Le Goateror directly from the OpenBMC GitHub release repository : 93d029c729SCédric Le Goater 94d029c729SCédric Le Goater https://github.com/openbmc/openbmc/releases 957a1e049aSCédric Le Goater 969d5dcb85SJoel StanleyTo boot a kernel directly from a Linux build tree: 979d5dcb85SJoel Stanley 989d5dcb85SJoel Stanley.. code-block:: bash 999d5dcb85SJoel Stanley 1009d5dcb85SJoel Stanley $ qemu-system-arm -M ast2600-evb -nographic \ 1019d5dcb85SJoel Stanley -kernel arch/arm/boot/zImage \ 1029d5dcb85SJoel Stanley -dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \ 1039d5dcb85SJoel Stanley -initrd rootfs.cpio 1049d5dcb85SJoel Stanley 1057a1e049aSCédric Le GoaterThe image should be attached as an MTD drive. Run : 1067a1e049aSCédric Le Goater 1077a1e049aSCédric Le Goater.. code-block:: bash 1087a1e049aSCédric Le Goater 1097a1e049aSCédric Le Goater $ qemu-system-arm -M romulus-bmc -nic user \ 110d029c729SCédric Le Goater -drive file=obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd -nographic 1119820e52fSCédric Le Goater 1129820e52fSCédric Le GoaterOptions specific to Aspeed machines are : 1139820e52fSCédric Le Goater 1149820e52fSCédric Le Goater * ``execute-in-place`` which emulates the boot from the CE0 flash 1159820e52fSCédric Le Goater device by using the FMC controller to load the instructions, and 1169820e52fSCédric Le Goater not simply from RAM. This takes a little longer. 1179820e52fSCédric Le Goater 1189820e52fSCédric Le Goater * ``fmc-model`` to change the FMC Flash model. FW needs support for 1199820e52fSCédric Le Goater the chip model to boot. 1209820e52fSCédric Le Goater 1219820e52fSCédric Le Goater * ``spi-model`` to change the SPI Flash model. 1229820e52fSCédric Le Goater 1239820e52fSCédric Le GoaterFor instance, to start the ``ast2500-evb`` machine with a different 1249820e52fSCédric Le GoaterFMC chip and a bigger (64M) SPI chip, use : 1259820e52fSCédric Le Goater 1269820e52fSCédric Le Goater.. code-block:: bash 1279820e52fSCédric Le Goater 1289820e52fSCédric Le Goater -M ast2500-evb,fmc-model=mx25l25635e,spi-model=mx66u51235f 1293d393bb7SJamin Lin 1303d393bb7SJamin Lin 1313d393bb7SJamin LinAspeed minibmc family boards (``ast1030-evb``) 1323d393bb7SJamin Lin================================================================== 1333d393bb7SJamin Lin 1343d393bb7SJamin LinThe QEMU Aspeed machines model mini BMCs of various Aspeed evaluation 1353d393bb7SJamin Linboards. They are based on different releases of the 1363d393bb7SJamin LinAspeed SoC : the AST1030 integrating an ARM Cortex M4F CPU (200MHz). 1373d393bb7SJamin Lin 1383d393bb7SJamin LinThe SoC comes with SRAM, SPI, I2C, etc. 1393d393bb7SJamin Lin 1403d393bb7SJamin LinAST1030 SoC based machines : 1413d393bb7SJamin Lin 1423d393bb7SJamin Lin- ``ast1030-evb`` Aspeed AST1030 Evaluation board (Cortex-M4F) 1433d393bb7SJamin Lin 1443d393bb7SJamin LinSupported devices 1453d393bb7SJamin Lin----------------- 1463d393bb7SJamin Lin 1473d393bb7SJamin Lin * SMP (for the AST1030 Cortex-M4F) 1483d393bb7SJamin Lin * Interrupt Controller (VIC) 1493d393bb7SJamin Lin * Timer Controller 1503d393bb7SJamin Lin * I2C Controller 1513d393bb7SJamin Lin * System Control Unit (SCU) 1523d393bb7SJamin Lin * SRAM mapping 1533d393bb7SJamin Lin * Static Memory Controller (SMC or FMC) - Only SPI Flash support 1543d393bb7SJamin Lin * SPI Memory Controller 1553d393bb7SJamin Lin * USB 2.0 Controller 1563d393bb7SJamin Lin * Watchdog Controller 1573d393bb7SJamin Lin * GPIO Controller (Master only) 1583d393bb7SJamin Lin * UART 1593d393bb7SJamin Lin * LPC Peripheral Controller (a subset of subdevices are supported) 1603d393bb7SJamin Lin * Hash/Crypto Engine (HACE) - Hash support only. TODO: HMAC and RSA 1613d393bb7SJamin Lin * ADC 162*1d6fb3d0SCédric Le Goater * Secure Boot Controller 163*1d6fb3d0SCédric Le Goater * PECI Controller (minimal) 1643d393bb7SJamin Lin 1653d393bb7SJamin Lin 1663d393bb7SJamin LinMissing devices 1673d393bb7SJamin Lin--------------- 1683d393bb7SJamin Lin 1693d393bb7SJamin Lin * PWM and Fan Controller 1703d393bb7SJamin Lin * Slave GPIO Controller 1713d393bb7SJamin Lin * Mailbox Controller 1723d393bb7SJamin Lin * Virtual UART 1733d393bb7SJamin Lin * eSPI Controller 1743d393bb7SJamin Lin * I3C Controller 1753d393bb7SJamin Lin 1763d393bb7SJamin LinBoot options 1773d393bb7SJamin Lin------------ 1783d393bb7SJamin Lin 1793d393bb7SJamin LinThe Aspeed machines can be started using the ``-kernel`` to load a 1803d393bb7SJamin LinZephyr OS or from a firmware. Images can be downloaded from the 1813d393bb7SJamin LinASPEED GitHub release repository : 1823d393bb7SJamin Lin 1833d393bb7SJamin Lin https://github.com/AspeedTech-BMC/zephyr/releases 1843d393bb7SJamin Lin 1853d393bb7SJamin LinTo boot a kernel directly from a Zephyr build tree: 1863d393bb7SJamin Lin 1873d393bb7SJamin Lin.. code-block:: bash 1883d393bb7SJamin Lin 1893d393bb7SJamin Lin $ qemu-system-arm -M ast1030-evb -nographic \ 1903d393bb7SJamin Lin -kernel zephyr.elf 19119d7c0d4SPeter Delevoryas 19219d7c0d4SPeter DelevoryasFacebook Yosemite v3.5 Platform and CraterLake Server (``fby35``) 19319d7c0d4SPeter Delevoryas================================================================== 19419d7c0d4SPeter Delevoryas 19519d7c0d4SPeter DelevoryasFacebook has a series of multi-node compute server designs named 19619d7c0d4SPeter DelevoryasYosemite. The most recent version released was 19719d7c0d4SPeter Delevoryas`Yosemite v3 <https://www.opencompute.org/documents/ocp-yosemite-v3-platform-design-specification-1v16-pdf>`__. 19819d7c0d4SPeter Delevoryas 19919d7c0d4SPeter DelevoryasYosemite v3.5 is an iteration on this design, and is very similar: there's a 20019d7c0d4SPeter Delevoryasbaseboard with a BMC, and 4 server slots. The new server board design termed 20119d7c0d4SPeter Delevoryas"CraterLake" includes a Bridge IC (BIC), with room for expansion boards to 20219d7c0d4SPeter Delevoryasinclude various compute accelerators (video, inferencing, etc). At the moment, 20319d7c0d4SPeter Delevoryasonly the first server slot's BIC is included. 20419d7c0d4SPeter Delevoryas 20519d7c0d4SPeter DelevoryasYosemite v3.5 is itself a sled which fits into a 40U chassis, and 3 sleds 20619d7c0d4SPeter Delevoryascan be fit into a chassis. See `here <https://www.opencompute.org/products/423/wiwynn-yosemite-v3-server>`__ 20719d7c0d4SPeter Delevoryasfor an example. 20819d7c0d4SPeter Delevoryas 20919d7c0d4SPeter DelevoryasIn this generation, the BMC is an AST2600 and each BIC is an AST1030. The BMC 21019d7c0d4SPeter Delevoryasruns `OpenBMC <https://github.com/facebook/openbmc>`__, and the BIC runs 21119d7c0d4SPeter Delevoryas`OpenBIC <https://github.com/facebook/openbic>`__. 21219d7c0d4SPeter Delevoryas 21319d7c0d4SPeter DelevoryasFirmware images can be retrieved from the Github releases or built from the 21419d7c0d4SPeter Delevoryassource code, see the README's for instructions on that. This image uses the 21519d7c0d4SPeter Delevoryas"fby35" machine recipe from OpenBMC, and the "yv35-cl" target from OpenBIC. 21619d7c0d4SPeter DelevoryasSome reference images can also be found here: 21719d7c0d4SPeter Delevoryas 21819d7c0d4SPeter Delevoryas.. code-block:: bash 21919d7c0d4SPeter Delevoryas 22019d7c0d4SPeter Delevoryas $ wget https://github.com/facebook/openbmc/releases/download/openbmc-e2294ff5d31d/fby35.mtd 22119d7c0d4SPeter Delevoryas $ wget https://github.com/peterdelevoryas/OpenBIC/releases/download/oby35-cl-2022.13.01/Y35BCL.elf 22219d7c0d4SPeter Delevoryas 22319d7c0d4SPeter DelevoryasSince this machine has multiple SoC's, each with their own serial console, the 22419d7c0d4SPeter Delevoryasrecommended way to run it is to allocate a pseudoterminal for each serial 22519d7c0d4SPeter Delevoryasconsole and let the monitor use stdio. Also, starting in a paused state is 22619d7c0d4SPeter Delevoryasuseful because it allows you to attach to the pseudoterminals before the boot 22719d7c0d4SPeter Delevoryasprocess starts. 22819d7c0d4SPeter Delevoryas 22919d7c0d4SPeter Delevoryas.. code-block:: bash 23019d7c0d4SPeter Delevoryas 23119d7c0d4SPeter Delevoryas $ qemu-system-arm -machine fby35 \ 23219d7c0d4SPeter Delevoryas -drive file=fby35.mtd,format=raw,if=mtd \ 23319d7c0d4SPeter Delevoryas -device loader,file=Y35BCL.elf,addr=0,cpu-num=2 \ 23419d7c0d4SPeter Delevoryas -serial pty -serial pty -serial mon:stdio \ 23519d7c0d4SPeter Delevoryas -display none -S 23619d7c0d4SPeter Delevoryas $ screen /dev/tty0 # In a separate TMUX pane, terminal window, etc. 23719d7c0d4SPeter Delevoryas $ screen /dev/tty1 23819d7c0d4SPeter Delevoryas $ (qemu) c # Start the boot process once screen is setup. 239