From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 4B4E0C61DD6 for ; Wed, 2 Sep 2026 12:01:40 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x1jea-00019z-8t; Wed, 02 Sep 2026 08:01:20 -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 1x1jeY-00017J-C9 for qemu-arm@nongnu.org; Wed, 02 Sep 2026 08:01:18 -0400 Received: from mail-ed1-x535.google.com ([2a00:1450:4864:20::535]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1x1jeW-0006pn-BP for qemu-arm@nongnu.org; Wed, 02 Sep 2026 08:01:18 -0400 Received: by mail-ed1-x535.google.com with SMTP id 4fb4d7f45d1cf-6a68ab90eb8so845002a12.3 for ; Wed, 02 Sep 2026 05:01:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1788350474; x=1788955274; darn=nongnu.org; h=content-transfer-encoding:content-type:mime-version:message-id:date :user-agent:references:in-reply-to:subject:cc:to:from:from:to:cc :subject:date:message-id:reply-to:content-type; bh=etxuxkqAPn48hft5SGfyuehy13wdz8oxSfU7ME0C+Ag=; b=DpeusVOngjYmtzu82gVGQLqIfe+h2k1OthKtfll1ap4urMule2CogRcp0dgz6wN1Xg nvC1dOHg8Qj/NMsP7Jdn54dy5Af19ukncjZJAbN3JNJ+BdMy78uflNBcEqDmW9TNlqJq /wPAMcdkAlRIh70fXg9CYNKl2R/cAq23nIpFt2YMvdgUaujZFyk+pZMYMJJ6a+T0cNCZ H1s7IEAl4gQ+hVSHt7qP7K8LGlCBRmBpzNOBl1BPX8X+rDtg8hNRffm0yC/UnLtkO047 9fipjkl4M20pmxDSvu+cYL8KEuR+fpDnPNANGzkOmx4zd9KfYZjYy0whPy3sX/nxElfc 3VOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788350474; x=1788955274; h=content-transfer-encoding:content-type:mime-version:message-id:date :user-agent:references:in-reply-to:subject:cc:to:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=etxuxkqAPn48hft5SGfyuehy13wdz8oxSfU7ME0C+Ag=; b=N4wMCqRmpOJupOaBaWmKG7MCQAhyzifxkHM621l9vdn8U//wej68fDPQebMHp9B4ks voJJUNVcZNk/1jya/m27XMkFpayoBEi669IWwi/wv8xsh71Kvl3w+75l21beuT13KIUm q+zp7ClhEpCpZ9lg3t21rgSXvpdZlHtuaaLrQxEKs8VaV/QEFzTws5gxkHCAr83NIpnq KAZC6SDxLTD4zHTEuD1P92MngjxkNBY1cg29/STcHp2KMKJtIg9x3rXrwESePoX3YY50 R7PLyOZ+MMo8QZ6XNYlLHk3A00NN2cpAc5xNAj3py1w9d7q70m3zYSqoyQVZMcYtKgYp 6yTA== X-Forwarded-Encrypted: i=1; AKwUvBzvgnLxKWJK7k7ZM3lZSEM+jMNa7CCtCZUuR6BAn5jLTtr7R1MHoyJMDvp7llYT5PZUsopixgdWCQ==@nongnu.org X-Gm-Message-State: AFuF++kISnQDEdvlDHCr58chHQEw6SI+7a85LzZYcNAXirol/Mh4bnEh eLwSAQdfcUX5E6sdJ1S3g7f+Fwqk/DoAZiFCNfxD4OGvPjIFozwW3HEkkUjeNQ1i6RY= X-Gm-Gg: AYBFou19c+AEjQ0YAl6YuA0mJUWh17PkIRPFs6P6sO/+4mL+NeNK2LSraGegp+gslhs /abr1xN2PLY0xg0eb7MhpCuA8Ce3ETmopFMNvmFcXJq6puvMzC69T/+kGWXqpnuTp+/EZwQwqW7 r4npTuR+YA1h0PUMd1l93uFVCD2OEG+M1DGCSk5wm2I7ANJLVmpfnlyPcm0y0VH6C47jMkPuaSA QdxQfsZkL453BS0V7ngv+VzO+d/uulFhyE4Z2HTVRM4TN7c0SJllpBu3/V7Q7lQf3BHxuIe3o4o dO/dvTcLZ+btsVpRXRy3yL+5GNzJB0fLL+iTE73pshHQoQs3OVIu4lSvi3XUn24rKw+TOc7v9sv xrE/eXrxHYwEhQcvRE75y/GkFEMiKF5SHQy0qOIzqm9CzrNrW1rWqa9Q+q076eL50aX1dOqXfiK NRO4Pl2ubc9zk6PF7t6iUkc6ILC7AijuxG/KcL9HD12fCF5Z3ontTzE5mJYzhR X-Received: by 2002:a05:6402:24d7:b0:6a5:f9cc:748b with SMTP id 4fb4d7f45d1cf-6a682555d1emr2778406a12.9.1788350474015; Wed, 02 Sep 2026 05:01:14 -0700 (PDT) Received: from draig.lan ([185.124.0.156]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-48448e80745sm6060325f8f.15.2026.09.02.05.01.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 02 Sep 2026 05:01:12 -0700 (PDT) Received: from draig (localhost [IPv6:::1]) by draig.lan (Postfix) with ESMTP id 640A35F85F; Wed, 02 Sep 2026 13:01:11 +0100 (BST) From: =?utf-8?Q?Alex_Benn=C3=A9e?= To: Gilles Grimaud Cc: qemu-devel@nongnu.org, qemu-arm@nongnu.org, peter.maydell@linaro.org Subject: Re: [PATCH RFC v2 30/30] docs/system/arm: document Raspberry Pi Pico In-Reply-To: <20260830061601.52136-16-gilles.grimaud@univ-lille.fr> (Gilles Grimaud's message of "Sun, 30 Aug 2026 08:16:01 +0200") References: <20260829234308.33725-1-gilles.grimaud@univ-lille.fr> <20260830061601.52136-16-gilles.grimaud@univ-lille.fr> User-Agent: mu4e 1.14.4-pre1; emacs 30.1 Date: Wed, 02 Sep 2026 13:01:11 +0100 Message-ID: <87tso7rhfc.fsf@draig.linaro.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a00:1450:4864:20::535; envelope-from=alex.bennee@linaro.org; helo=mail-ed1-x535.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, 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-arm@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-arm-bounces+qemu-arm=archiver.kernel.org@nongnu.org Sender: qemu-arm-bounces+qemu-arm=archiver.kernel.org@nongnu.org Gilles Grimaud writes: > From: gilles grimaud > > Document the RP2040 machine lineage, supported and shallow devices, boot = ROM profiles, ELF/UF2/raw loading, persistent flash, serial backends, machi= ne properties, flash policy, Pico SDK exit compatibility, and known limitat= ions. > > Add the board page to the Arm system manual and its ownership entry to MA= INTAINERS. > > Signed-off-by: gilles grimaud > --- > MAINTAINERS | 1 + > docs/system/arm/raspi-pico.rst | 641 +++++++++++++++++++++++++++++++++ > docs/system/target-arm.rst | 1 + > 3 files changed, 643 insertions(+) > create mode 100644 docs/system/arm/raspi-pico.rst > > diff --git a/MAINTAINERS b/MAINTAINERS > index 41494eff2a..0fa93d28c8 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -1043,6 +1043,7 @@ F: hw/*/rp2040* > F: include/hw/*/rp2040* > F: hw/arm/raspi_pico.c > F: scripts/uf2-to-flash.py > +F: docs/system/arm/raspi-pico.rst > F: tests/qtest/rp2040* > F: tests/tcg/arm/system/rp2040* >=20=20 > diff --git a/docs/system/arm/raspi-pico.rst b/docs/system/arm/raspi-pico.= rst > new file mode 100644 > index 0000000000..d28cd20af8 > --- /dev/null > +++ b/docs/system/arm/raspi-pico.rst > @@ -0,0 +1,641 @@ > +.. SPDX-License-Identifier: GPL-2.0-or-later > + > +Raspberry Pi Pico board (``raspi-pico``) > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +The ``raspi-pico`` machine models a minimal Raspberry Pi Pico 1 board ba= sed > +on the RP2040 microcontroller. The current model is intended for bare-m= etal > +bring-up and tests that execute code from the RP2040 external flash XIP > +window. > + > +RFC lineage > +----------- > + > +This machine starts from Alex Bennee's 2022 RP2040/Pico RFC patch series. > +The RP2040 SoC skeleton, Pico machine, and memory map are adapted from t= hat > +series to the current QEMU tree. The RFC ``pc-bios/pipico.rom`` image w= as > +used for bring-up experiments, but it is not installed as a QEMU firmware > +blob by this machine. > + > +RFC patch 0005's mask ROM loading logic is adapted for the current machi= ne: > +an external boot ROM can be supplied explicitly with ``-bios``. QEMU st= ill > +uses a small synthetic boot ROM for direct XIP bring-up, so existing fir= mware > +tests remain stable without requiring an external firmware image. I don't think you need to document the lineage in the user facing docs. You can add Based-on: tags to the individual commits where the patch started out from one of mine if you wish. The rest is a lot but I can't really complain about comprehensive documentation. I do wonder how much is repeating stuff that could just be pointing as RaspberryPi's extensive and good documentation? --=20 Alex Benn=C3=A9e Virtualisation Tech Lead @ Linaro