From nobody Sun Jul 26 11:50:51 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1782540011; cv=none; d=zohomail.com; s=zohoarc; b=N0XFPa/HxJH4gMmeN+lQxGbEPBPm9AbBs59gwAulHskh+m4Juo3WTZrW1VIHrBjJoPabp6rBWF0ErLU+4oxWO0/iZL8rDFDjAaJBawOgKrWFf17ugHmllrbwlq9IohTGS2kmzArcrBN0vDXHWwQ9l/6FzhHMGkatNnH6c4ZM17s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1782540011; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=ZcR8L0WC/Ee3sh1/HeRViPr1GzlOHSGGVXj0ax8e8Dc=; b=SF+3DVxbllsFHH1L5VchAp0xHh8xylylEMU5akzDkCRKQW2PCuFuyZyijeKX2QuJIpJ85sBMZVkRhRSYdJSnfv8lyt0vEjlEOTR5xTPu2umLgQf7+PxsWCxCCDQrYW1jmdGHhzwFp4i+PwDN5WixOTILXS7atHEsy9HdfrVeUSE= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1782540011628871.378145942514; Fri, 26 Jun 2026 23:00:11 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1wdM4I-0002xe-LI; Sat, 27 Jun 2026 01:59:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1wdM4A-0002xH-FB for qemu-devel@nongnu.org; Sat, 27 Jun 2026 01:58:58 -0400 Received: from mail-dy1-x132a.google.com ([2607:f8b0:4864:20::132a]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1wdM48-0000Gc-N0 for qemu-devel@nongnu.org; Sat, 27 Jun 2026 01:58:58 -0400 Received: by mail-dy1-x132a.google.com with SMTP id 5a478bee46e88-30ca1b4b278so1796426eec.0 for ; Fri, 26 Jun 2026 22:58:54 -0700 (PDT) Received: from ubuntu.. ([111.196.134.99]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-30c7ca438ddsm23462629eec.23.2026.06.26.22.58.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Jun 2026 22:58:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1782539933; x=1783144733; darn=nongnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=ZcR8L0WC/Ee3sh1/HeRViPr1GzlOHSGGVXj0ax8e8Dc=; b=sdcNJS/sAKBt34XB827GXL8saM9mEJ1ChuDkhwqnCNTFU2+m+qlgR9vAzielnjKRw+ R+D4uu/tCrRRGd1r5NYV41IOUvmwFKOfpKrLBAY8ywX+FJ3Ag+zB12/KKgtn/WrmUSdx 7ymygwj/2Ftuju+4CZc1PMNkVSCcA1eLgGJ1vlBmx4MAYc8cgYcsMSWdHlsMCePplU7u EGk+DdQxD2EuFJQltAolDWR4pkwuI0NznfQ2yBtZ5P+HZjcY0IlULnzXfLQBHuoPuwLl ie8g16fjtG9MQd8ckl8fDmv+mqqLTBqD6pnKxqTYTrwlbC5qzYTnZunePJ0UjxO+yAGT SLfw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1782539933; x=1783144733; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=ZcR8L0WC/Ee3sh1/HeRViPr1GzlOHSGGVXj0ax8e8Dc=; b=aMP5hi+C81iKPZMY6kadvWQBcp4H7EOCsmGi90Vt18YUFIjAYhSquPYh8TwoPMRVt8 +pOwGIEYbpQkA5X4lJlnlFmu3volBnPm0rapDYd6XG6zSvzrt6qsaB5fZdP/Y2eBMUiR fgNhqOVXj/sGFh7aOTh5SQe4Wft1FCrjJyT705MMhs/MElAhUJ60G7Mv03xDvS4n2k9e cxwQdGbat5zyc3QQKGYcRS0zb0atneuGpoLX1vB3z9wYRVLD/xc8mFDydsRQHZr8WV7J O4z4l6FsfPcmJyBSQ2OQhb6xiCiXveMQ1t0LxHxsxsJz/ddvMi9ISixVoXPFeJCQH5Dr crgQ== X-Gm-Message-State: AOJu0YwXcuzwFB73Jf2B8im3sZLOdVAu74UR6xYq2M0XkbiTJ2o/wbC+ RSezu/+KQUABp7y+sz5YtN4tyaM/wuxuqZYS0x/OG2c7lVdYHZV43P9U9G9QFGg6pGvyGg== X-Gm-Gg: AfdE7cmh4pLGVULLYk9TcRuDnwURlzS8xTM5XkvdPPngKurNDfEMFxQQ4HeSXhZcyST SUBXeL1TeMsF/lWD0T+1auqQjX9u92hPsbhT7s3Y71h7hbZJx3pOoOkR+I5uOsPXccNCMVw40Qu XxeVDbU1gLdBrlGO12l25n3rf9OYojivWHo80C4ATdXTyGCpVTachMiOt3qoVgeB4zaM8QWIqMo IuFEEejqNKjKBIQTOET+nOIgoeOgq3weSYtph6TJMW/Ih/l3GthNQDQQsd/nRAnPbkRui5BjbfC gGerFMn9AQnkjnkBsWPT5ZI8LaJDS3bUNKYLdfTpvlap+vJu+Eq5UiDQYrkEx6CNAulQrXZFQ1/ PXRfZyUdNQvepCENa5LayBYkvg/ktTzAnT6oUmu6DcUaZupGroUVXkNSA3eBcP768u5o/CZvQNK 2ic7MBjxGVgn7WzGg7ow== X-Received: by 2002:a05:7300:3207:b0:30c:ab4d:382d with SMTP id 5a478bee46e88-30cab4d3bf1mr2601077eec.36.1782539932543; Fri, 26 Jun 2026 22:58:52 -0700 (PDT) From: Bin Meng X-Google-Original-From: Bin Meng To: qemu-devel@nongnu.org Cc: Hao Wu , Pierrick Bouvier , Tyrone Ting , qemu-arm@nongnu.org Subject: [PATCH] docs(arm): Update Nuvoton OpenBMC image guidance Date: Sat, 27 Jun 2026 13:58:47 +0800 Message-Id: <20260627055848.28279-1-bin.meng@processmission.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=2607:f8b0:4864:20::132a; envelope-from=bmeng.cn@gmail.com; helo=mail-dy1-x132a.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: qemu development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @gmail.com) X-ZM-MESSAGEID: 1782540016404154100 Content-Type: text/plain; charset="utf-8" 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 --- docs/system/arm/nuvoton.rst | 54 +++++++++++++++++++++++++++++++++---- 1 file changed, 49 insertions(+), 5 deletions(-) diff --git a/docs/system/arm/nuvoton.rst b/docs/system/arm/nuvoton.rst index e4827fb43a..51d36b2bc0 100644 --- a/docs/system/arm/nuvoton.rst +++ b/docs/system/arm/nuvoton.rst @@ -94,16 +94,60 @@ Boot options ------------ =20 The Nuvoton machines can boot from an OpenBMC firmware image, or directly = into -a kernel using the ``-kernel`` option. OpenBMC images for ``quanta-gsj`` a= nd -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 Jen= kins +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/suppo= rted-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: =20 https://jenkins.openbmc.org/ =20 -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=3Ddocker-builder,target=3Dgbs``, then open its latest successful b= uild's +artifacts. The MTD image is usually published under +``openbmc/build/tmp/deploy/images//`` as +``obmc-phosphor-image--.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: =20 .. code-block:: bash =20 - $ qemu-system-arm -machine quanta-gsj -nographic \ - -drive file=3Dimage-bmc,if=3Dmtd,bus=3D0,unit=3D0,format=3Draw + $ qemu-system-arm -machine quanta-gbs-bmc -nographic \ + -drive file=3Dobmc-phosphor-image-gbs-xxxxxx.static.mtd,if=3Dmtd,bus= =3D0,unit=3D0,format=3Draw =20 The default root password for test images is usually ``0penBmc``. + +For other machines that don't have pre-built images on Jenkins, build an i= mage +from source by following the OpenBMC build documentation. --=20 2.34.1