docs/system/arm: Update Nuvoton OpenBMC image guidance
PATCH 1/1 docs/system/arm: Update Nuvoton OpenBMC image guidance
Describe the current OpenBMC target naming and release status for Nuvoton machines. The latest 2.18.0 release no longer includes GSJ, so point users at older 2.14.0 sources and explain how to find Jenkins MTD artifacts.
---
docs/system/arm/nuvoton.rst | 54 +++++++++++++++++++++++++++++++++---- 1 file changed, 49 insertions(+), 5 deletions(-)
docs/system/arm/nuvoton.rst +49 -5
@@ -94,16 +94,60 @@ Boot options ------------ The Nuvoton machines can boot from an OpenBMC firmware image, or directly into -a kernel using the ``-kernel`` option. OpenBMC images for ``quanta-gsj`` and -possibly others can be downloaded from the OpenBMC jenkins : +a kernel using the ``-kernel`` option. OpenBMC machine names do not always +match QEMU machine names. Check the OpenBMC supported-machine list and Jenkins +for currently available source and pre-built images. + +Known OpenBMC (v2.18.0) target names for QEMU Nuvoton machines per: + + https://github.com/openbmc/openbmc/blob/2.18.0/meta-phosphor/docs/supported-machines.md + +.. list-table:: + :header-rows: 1 + + * - QEMU machine + - OpenBMC machine + * - ``npcm750-evb`` + - ``evb-npcm750`` + * - ``npcm845-evb`` + - ``evb-npcm845`` + * - ``quanta-gbs-bmc`` + - ``gbs`` + * - ``kudo-bmc`` + - ``kudo`` + * - ``mori-bmc`` + - ``mori`` + +As of June 2026, the latest OpenBMC release, ``2.18.0``, no longer lists a +``gsj`` machine. To build an image for QEMU's ``quanta-gsj`` machine, use an +older OpenBMC release that still contains ``meta-quanta/meta-gsj``. The +``2.14.0`` release contains the ``gsj`` machine: + + https://github.com/openbmc/openbmc/tree/2.14.0/meta-quanta/meta-gsj + +Some pre-built OpenBMC images for QEMU Nuvoton machines may be available on +Jenkins: https://jenkins.openbmc.org/ -The firmware image should be attached as an MTD drive. Example : +To find a pre-built MTD image on Jenkins, start from the Jenkins home page and +open the ``latest-master`` job. Select the matrix configuration whose +``target`` matches the OpenBMC machine name, for example +``label=docker-builder,target=gbs``, then open its latest successful build's +artifacts. The MTD image is usually published under +``openbmc/build/tmp/deploy/images/<machine>/`` as +``obmc-phosphor-image-<machine>-<timestamp>.static.mtd``. If Jenkins does not +list a matching target, or the build artifacts do not include an MTD image, +there is no current pre-built MTD image for that machine. + +The firmware image should be attached as an MTD drive. Example: .. code-block:: bash - $ qemu-system-arm -machine quanta-gsj -nographic \ - -drive file=image-bmc,if=mtd,bus=0,unit=0,format=raw + $ qemu-system-arm -machine quanta-gbs-bmc -nographic \ + -drive file=obmc-phosphor-image-gbs-xxxxxx.static.mtd,if=mtd,bus=0,unit=0,format=raw The default root password for test images is usually ``0penBmc``. + +For other machines that don't have pre-built images on Jenkins, build an image +from source by following the OpenBMC build documentation.
Signature · 1 line
2.34.1
Quoted 6 lines · Bin Meng
Describe the current OpenBMC target naming and release status for Nuvoton machines. The latest 2.18.0 release no longer includes GSJ, so point users at older 2.14.0 sources and explain how to find Jenkins MTD artifacts.
Quoted 7 lines
Signed-off-by Bin Meng <[email protected]>---
docs/system/arm/nuvoton.rst | 54 +++++++++++++++++++++++++++++++++---- 1 file changed, 49 insertions(+), 5 deletions(-)
Ping?
Quoted 10 lines · Bin Meng
Quoted 8 lines · Bin Meng
Describe the current OpenBMC target naming and release status for Nuvoton machines. The latest 2.18.0 release no longer includes GSJ, so point users at older 2.14.0 sources and explain how to find Jenkins MTD artifacts.
Signed-off-by Bin Meng <[email protected]>
Quoted 7 lines
Quoted 5 lines
---
docs/system/arm/nuvoton.rst | 54 +++++++++++++++++++++++++++++++++---- 1 file changed, 49 insertions(+), 5 deletions(-)Ping?
The docs change looks OK to me as far as formatting goes, but could a Nuvoton maintainer review it, please?
PS: if quanta-gsj is no longer supported by OpenBMC should we consider deprecating (and eventually dropping) it in QEMU ?
thanks
-- PMM
Quoted 14 lines · Peter Maydell
Quoted 12 lines · Bin Meng
Quoted 10 lines · Bin Meng
Describe the current OpenBMC target naming and release status for Nuvoton machines. The latest 2.18.0 release no longer includes GSJ, so point users at older 2.14.0 sources and explain how to find Jenkins MTD artifacts.
Signed-off-by Bin Meng <[email protected]>---
Quoted 8 lines
Quoted 5 lines
Quoted 3 lines
docs/system/arm/nuvoton.rst | 54 +++++++++++++++++++++++++++++++++---- 1 file changed, 49 insertions(+), 5 deletions(-)Ping?
The docs change looks OK to me as far as formatting goes, but could a Nuvoton maintainer review it, please?
In the absence of any response from the Nuvoton maintainers, I'm going to take this into target-arm.next.
Quoted 2 lines
PS: if quanta-gsj is no longer supported by OpenBMC should we consider deprecating (and eventually dropping) it in QEMU ?
I think this is still an interesting question to think about for 11.2.
thanks
-- PMM