From patchwork Wed May 24 11:33:08 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marcin Juszkiewicz X-Patchwork-Id: 685340 Delivered-To: patch@linaro.org Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp195225wrt; Wed, 24 May 2023 04:34:41 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7e9dDN8GkGAGvDOTuuoNze1aA8EoVdHg79/Phq2+HGwZA7/9JxS48A5vgZUQYvL1PGtRSn X-Received: by 2002:ad4:5def:0:b0:5ef:486a:505e with SMTP id jn15-20020ad45def000000b005ef486a505emr23918026qvb.41.1684928080712; Wed, 24 May 2023 04:34:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684928080; cv=none; d=google.com; s=arc-20160816; b=0YcHYfpPiOWzFZYQbFzVWjz+ra9eki2bFdjZSJcvrZcEs9NLjUmihx6f2DZ351oFn5 K2TWwGCzM9vJhnKHf6mSA5nlbZ7n5XILsu7RyMYOuNuh6uprokESE0jNoFtUkwussxXV neFs8KTgzAbL5j/Ti4Xg3CVfUs5fR8Vi1vHSve2qWt8JwDGicGDDnXRzteNmh8wBzDpp uvuDoHMIL2ByW4w/IYtqDIhaqZDrmaSOt3V7fn5A7aBAvxbU+Wg+YdqW9r3zTWf2yL0Q 3INGZXIrX7XgJBs6LJrMUByFzA2x9TE+NoEgg1uIKZkt657bq1pMYkiUWDXrBv9AYbV7 UEeg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from; bh=qUjTF89z44rNM3coEMcwX6S2MayNcoDCperIVSibzug=; b=Ib7yKJMwbsx/h4MUAFuvkCNnrBHpJoGYghKmM26r5Akk5wqP9147W23ZGNYJ+9cqSn 9eradpYFjY9n+JlcEgm+VTxE14S9xxfSNYHxgW2fcMYY+yUlyuYtChlHfZkA2V1mcgYD tpzxU9gw6qprn9GfN6pIWt6UGA4cgt9HJy+WmqsPg4GjVONHhp2oF2TcgMexatCbBuz9 UWMeL9EZ11UFYTPFpsogk02gq0d8yvK3oFkIgjnBxe1m21WM3/eHybGpdDMU6fLH5VdD Q+iQJAkvpBrXyrmfZQ2zWWVN7xACeBW0VST7Z/7Qnx6FhNwF+Xf+iSWZSWXS7BZaZe99 L0lw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id fw14-20020a056214238e00b005ef84e19f7dsi6430976qvb.253.2023.05.24.04.34.40 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 24 May 2023 04:34:40 -0700 (PDT) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q1mk9-0005tL-Pq; Wed, 24 May 2023 07:33:25 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q1mk7-0005qm-Ox; Wed, 24 May 2023 07:33:23 -0400 Received: from muminek.juszkiewicz.com.pl ([213.251.184.221]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q1mk6-0002XX-0a; Wed, 24 May 2023 07:33:23 -0400 Received: from localhost (localhost [127.0.0.1]) by muminek.juszkiewicz.com.pl (Postfix) with ESMTP id 7D5552609C0; Wed, 24 May 2023 13:33:19 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at juszkiewicz.com.pl Received: from muminek.juszkiewicz.com.pl ([127.0.0.1]) by localhost (muminek.juszkiewicz.com.pl [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5dJK8hCFjIfr; Wed, 24 May 2023 13:33:17 +0200 (CEST) Received: from applejack.lan (83.21.125.167.ipv4.supernova.orange.pl [83.21.125.167]) by muminek.juszkiewicz.com.pl (Postfix) with ESMTPSA id F35C3260B8B; Wed, 24 May 2023 13:33:15 +0200 (CEST) From: Marcin Juszkiewicz To: qemu-devel@nongnu.org Cc: qemu-arm@nongnu.org, Leif Lindholm , Peter Maydell , Marcin Juszkiewicz Subject: [PATCH v3 3/4] docs: sbsa: document platform version changes Date: Wed, 24 May 2023 13:33:08 +0200 Message-Id: <20230524113308.834675-4-marcin.juszkiewicz@linaro.org> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230524113308.834675-1-marcin.juszkiewicz@linaro.org> References: <20230524113308.834675-1-marcin.juszkiewicz@linaro.org> MIME-Version: 1.0 Received-SPF: softfail client-ip=213.251.184.221; envelope-from=marcin.juszkiewicz@linaro.org; helo=muminek.juszkiewicz.com.pl X-Spam_score_int: -11 X-Spam_score: -1.2 X-Spam_bar: - X-Spam_report: (-1.2 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_SOFTFAIL=0.665, T_SCC_BODY_TEXT_LINE=-0.01, WEIRD_QUOTING=0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@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-devel-bounces+patch=linaro.org@nongnu.org Sender: qemu-devel-bounces+patch=linaro.org@nongnu.org We plan to start adding more system information in DT so firmware does not have to use hardcoded values. Signed-off-by: Marcin Juszkiewicz --- docs/system/arm/sbsa.rst | 31 +++++++++++++++++++++++++------ 1 file changed, 25 insertions(+), 6 deletions(-) diff --git a/docs/system/arm/sbsa.rst b/docs/system/arm/sbsa.rst index 016776aed8..922a29700d 100644 --- a/docs/system/arm/sbsa.rst +++ b/docs/system/arm/sbsa.rst @@ -6,16 +6,35 @@ any real hardware the ``sbsa-ref`` board intends to look like real hardware. The `Server Base System Architecture `_ defines a minimum base line of hardware support and importantly how the firmware -reports that to any operating system. It is a static system that -reports a very minimal DT to the firmware for non-discoverable -information about components affected by the qemu command line (i.e. -cpus and memory). As a result it must have a firmware specifically -built to expect a certain hardware layout (as you would in a real -machine). +reports that to any operating system. It is intended to be a machine for developing firmware and testing standards compliance with operating systems. +Platform versions +""""""""""""""""" + +QEMU 7.1 brought support for "platform version major/minor" fields in +DeviceTree. + +Version 0.0 +''''''''''' + +It is a static system that reports a very minimal DT to the firmware for +non-discoverable information about components affected by the qemu +command line (i.e. cpus and memory). As a result it must have a firmware +specifically built to expect a certain hardware layout (as you would in +a real machine). + +Version 0.1 +''''''''''' + +Additional data are provided in DT to the firmware: + - address and size of GIC Distributor + - address and size of GIC Redistributor + +Simple "/intc/reg" field is used. + Supported devices """""""""""""""""