mirror of https://github.com/xemu-project/xemu.git
aspeed queue:
* Restructured the "Boot options" section in the aspeed documentation -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEoPZlSPBIlev+awtgUaNDx8/77KEFAmc8140ACgkQUaNDx8/7 7KHcNA//ZGDHZxeeATYDuvTx2o/gYsQKe2F3NFnaR9zSFTDe5yeA49e0SwOeqUN9 /jHEL5X/6tXWiw+Od0vGbBbbKDuyZf5aMtMYLjObSaD0tAMl5m7NFcP8CjP7Wfrr Y/BdbbDZd3PIo8RnqALE02YGqLcjroyVtIw4mD/S1zN/nl30tV61M9fqzx9de4jo qMrrixDC+URqOQ2qOn8nfeHLxCirTSbI/yxoBJEyfjeRfFVdLV2P219pQBaY68mD zq0ioSNKgXS0Cuj4Ksy0YcXP3NRRU7mTc8G+D1hTAJg5wd27WDlrnA7Q0JvNvASJ LiGGrif2QqrgIGr8qJ7C2sqYAQ2gToBa+KGWE491F+Dx3mFeB+naSxhEwvRezhV6 Qrt5aODiGhc2BICG74UJITms5W1TmwLfmc7uK8WyoKxJWidD/OZINiM4lpjBUTvV B5mWpDSq05h98EYnsYeSrHstWw7s8JSxA5mzG4u7pasvao8sioX8IOFvpFIt53pv 8D+mcBA+vSc4KbuxWvTnw/0iuBRDGw39JrFr31BvJr9kKJ++VGFmsk7RSGmlKTJ/ o/CspDP7MM8NWH9Kp/bkJC8MW5njaP4QCtni/z8ka4ivnHg1C2TUmw9uDkoU28Z2 e/hWp1ru51rm47UerJMeooqqtc3ACXYm1TCDKK0kFWaDVOnzD98= =cCyK -----END PGP SIGNATURE----- Merge tag 'pull-aspeed-20241119' of https://github.com/legoater/qemu into staging aspeed queue: * Restructured the "Boot options" section in the aspeed documentation # -----BEGIN PGP SIGNATURE----- # # iQIzBAABCAAdFiEEoPZlSPBIlev+awtgUaNDx8/77KEFAmc8140ACgkQUaNDx8/7 # 7KHcNA//ZGDHZxeeATYDuvTx2o/gYsQKe2F3NFnaR9zSFTDe5yeA49e0SwOeqUN9 # /jHEL5X/6tXWiw+Od0vGbBbbKDuyZf5aMtMYLjObSaD0tAMl5m7NFcP8CjP7Wfrr # Y/BdbbDZd3PIo8RnqALE02YGqLcjroyVtIw4mD/S1zN/nl30tV61M9fqzx9de4jo # qMrrixDC+URqOQ2qOn8nfeHLxCirTSbI/yxoBJEyfjeRfFVdLV2P219pQBaY68mD # zq0ioSNKgXS0Cuj4Ksy0YcXP3NRRU7mTc8G+D1hTAJg5wd27WDlrnA7Q0JvNvASJ # LiGGrif2QqrgIGr8qJ7C2sqYAQ2gToBa+KGWE491F+Dx3mFeB+naSxhEwvRezhV6 # Qrt5aODiGhc2BICG74UJITms5W1TmwLfmc7uK8WyoKxJWidD/OZINiM4lpjBUTvV # B5mWpDSq05h98EYnsYeSrHstWw7s8JSxA5mzG4u7pasvao8sioX8IOFvpFIt53pv # 8D+mcBA+vSc4KbuxWvTnw/0iuBRDGw39JrFr31BvJr9kKJ++VGFmsk7RSGmlKTJ/ # o/CspDP7MM8NWH9Kp/bkJC8MW5njaP4QCtni/z8ka4ivnHg1C2TUmw9uDkoU28Z2 # e/hWp1ru51rm47UerJMeooqqtc3ACXYm1TCDKK0kFWaDVOnzD98= # =cCyK # -----END PGP SIGNATURE----- # gpg: Signature made Tue 19 Nov 2024 18:23:09 GMT # gpg: using RSA key A0F66548F04895EBFE6B0B6051A343C7CFFBECA1 # gpg: Good signature from "Cédric Le Goater <clg@redhat.com>" [full] # gpg: aka "Cédric Le Goater <clg@kaod.org>" [full] # Primary key fingerprint: A0F6 6548 F048 95EB FE6B 0B60 51A3 43C7 CFFB ECA1 * tag 'pull-aspeed-20241119' of https://github.com/legoater/qemu: docs: aspeed: Reorganize the "Boot options" section Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
This commit is contained in:
Peter Maydell
commit
687fe4f39c
|
|
@ -105,6 +105,9 @@ or directly from the ASPEED Forked OpenBMC GitHub release repository :
|
|||
|
||||
https://github.com/AspeedTech-BMC/openbmc/releases
|
||||
|
||||
Booting from a kernel image
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
To boot a kernel directly from a Linux build tree:
|
||||
|
||||
.. code-block:: bash
|
||||
|
|
@ -114,16 +117,10 @@ To boot a kernel directly from a Linux build tree:
|
|||
-dtb arch/arm/boot/dts/aspeed-ast2600-evb.dtb \
|
||||
-initrd rootfs.cpio
|
||||
|
||||
To boot the machine from the flash image, use an MTD drive :
|
||||
Booting from a flash image
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ qemu-system-arm -M romulus-bmc -nic user \
|
||||
-drive file=obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd -nographic
|
||||
|
||||
Options specific to Aspeed machines are :
|
||||
|
||||
* ``boot-emmc`` to set or unset boot from eMMC (AST2600).
|
||||
The machine options specific to Aspeed to boot from a flash image are :
|
||||
|
||||
* ``execute-in-place`` which emulates the boot from the CE0 flash
|
||||
device by using the FMC controller to load the instructions, and
|
||||
|
|
@ -134,10 +131,12 @@ Options specific to Aspeed machines are :
|
|||
|
||||
* ``spi-model`` to change the default SPI Flash model.
|
||||
|
||||
* ``bmc-console`` to change the default console device. Most of the
|
||||
machines use the ``UART5`` device for a boot console, which is
|
||||
mapped on ``/dev/ttyS4`` under Linux, but it is not always the
|
||||
case.
|
||||
To boot the machine from the flash image, use an MTD drive :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ qemu-system-arm -M romulus-bmc -nic user \
|
||||
-drive file=obmc-phosphor-image-romulus.static.mtd,format=raw,if=mtd -nographic
|
||||
|
||||
To use other flash models, for instance a different FMC chip and a
|
||||
bigger (64M) SPI for the ``ast2500-evb`` machine, run :
|
||||
|
|
@ -169,6 +168,78 @@ In that case, the machine boots fetching instructions from the FMC0
|
|||
device. It is slower to start but closer to what HW does. Using the
|
||||
machine option ``execute-in-place`` has a similar effect.
|
||||
|
||||
Booting from an eMMC image
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
The machine options specific to Aspeed machines to boot from an eMMC
|
||||
image are :
|
||||
|
||||
* ``boot-emmc`` to set or unset boot from eMMC (AST2600).
|
||||
|
||||
Only the ``ast2600-evb`` and ``rainier-emmc`` machines have support to
|
||||
boot from an eMMC device. In this case, the machine assumes that the
|
||||
eMMC image includes special boot partitions. Such an image can be
|
||||
built this way :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ dd if=/dev/zero of=mmc-bootarea.img count=2 bs=1M
|
||||
$ dd if=u-boot-spl.bin of=mmc-bootarea.img conv=notrunc
|
||||
$ dd if=u-boot.bin of=mmc-bootarea.img conv=notrunc count=64 bs=1K
|
||||
$ cat mmc-bootarea.img obmc-phosphor-image.wic > mmc.img
|
||||
$ truncate --size 16GB mmc.img
|
||||
|
||||
Boot the machine ``rainier-emmc`` with :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ qemu-system-arm -M rainier-bmc \
|
||||
-drive file=mmc.img,format=raw,if=sd,index=2 \
|
||||
-nographic
|
||||
|
||||
The ``boot-emmc`` option can be set or unset, to change the default
|
||||
boot mode of machine: SPI or eMMC. This can be useful to boot the
|
||||
``ast2600-evb`` machine from an eMMC device (default being SPI) or to
|
||||
boot the ``rainier-bmc`` machine from a flash device (default being
|
||||
eMMC).
|
||||
|
||||
As an example, here is how to to boot the ``rainier-bmc`` machine from
|
||||
the flash device with ``boot-emmc=false`` and let the machine use an
|
||||
eMMC image :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
$ qemu-system-arm -M rainier-bmc,boot-emmc=false \
|
||||
-drive file=flash.img,format=raw,if=mtd \
|
||||
-drive file=mmc.img,format=raw,if=sd,index=2 \
|
||||
-nographic
|
||||
|
||||
It should be noted that in this case the eMMC device must not have
|
||||
boot partitions, otherwise the contents will not be accessible to the
|
||||
machine. This limitation is due to the use of the ``-drive``
|
||||
interface.
|
||||
|
||||
Ideally, one should be able to define the eMMC device and the
|
||||
associated backend directly on the command line, such as :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
-blockdev node-name=emmc0,driver=file,filename=mmc.img \
|
||||
-device emmc,bus=sdhci-bus.2,drive=emmc0,boot-partition-size=1048576,boot-config=8
|
||||
|
||||
This is not yet supported (as of QEMU-10.0). Work is needed to
|
||||
refactor the sdhci bus model.
|
||||
|
||||
Other booting options
|
||||
^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Other machine options specific to Aspeed machines are :
|
||||
|
||||
* ``bmc-console`` to change the default console device. Most of the
|
||||
machines use the ``UART5`` device for a boot console, which is
|
||||
mapped on ``/dev/ttyS4`` under Linux, but it is not always the
|
||||
case.
|
||||
|
||||
To change the boot console and use device ``UART3`` (``/dev/ttyS2``
|
||||
under Linux), use :
|
||||
|
||||
|
|
@ -176,6 +247,8 @@ under Linux), use :
|
|||
|
||||
-M ast2500-evb,bmc-console=uart3
|
||||
|
||||
Booting the ast2700-evb machine
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Boot the AST2700 machine from the flash image, use an MTD drive :
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue