From patchwork Wed May 31 17:18:34 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marcin Juszkiewicz X-Patchwork-Id: 687286 Delivered-To: patch@linaro.org Received: by 2002:a5d:4d8a:0:0:0:0:0 with SMTP id b10csp1371883wru; Wed, 31 May 2023 10:19:37 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ60wxyq+anNiOXWWsEDNCdOKzoWYdgaMIl1hVEPoCgf3hwGf+xNF6CMEYZ9q7DAd/wByCDR X-Received: by 2002:a05:620a:cea:b0:75b:23a0:e7c7 with SMTP id c10-20020a05620a0cea00b0075b23a0e7c7mr5442652qkj.40.1685553577429; Wed, 31 May 2023 10:19:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1685553577; cv=none; d=google.com; s=arc-20160816; b=qtK/vuKPrynGchYEf+YuOR5X6cxUxsOglQsqgewtxYsfXuxZlj98lk2RDkiIUjx+tT 5xRABp/u5z0KH9R0V8cWYCOd0nqexRMtRsvdYNvtShCNOwExeW8IAK3AZUZQVbILbIFT nvS6+qtJBUKRTtFizkfGI2jESuI2VJJFjueRtIexb63weMe94UTjdb/Jou7qH5RhUXQ7 a2NhnDUvoe5iVdhfLeM9K+TG9bl2NQiQ/RCsoGK/gYxxU1tEakbgY0ZXfBMH31eXrW3F Ue8gy6X+7oncij4CKvlVPP72z/bYYir4oa2LIeAPqdpB3mEX1GyoeGiLYaVfNq0D8L2L 5gqQ== 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:message-id:date:subject:cc:to:from; bh=snbbRB4ema03X4hq1n+2qKekRsjOk1/KvEUZ5OyV9WY=; b=JzaGF13rbIgPfdgrO1Czn74wDxao70QB5mt6qe1V61KqeQvroyRdVAr9Knjk4ZgTb0 gUtfJAnZ8B0//QKMBFunpcNCRU8xnFzcbCwwDgcR78jNo+Yf4Sb3tB11RiJLGDK1UNeQ A3hh6tNUChkLwE9+qeiF2UaPuBD1VqxogLIRJM4cHJ1GK8j3ONap3yuUZcvub5mhuomF 8mnFT9KoWE7pyMqh04RyUiX2kk1aG6Vx4op7sJDgP0uVJByh2i2poULgT181gZhbS2Nc 1fW/qS6HFXgUijZoEIG+ERxymYlAGjUQ7wRMteI5cADwdhjOr2pg/Z7x+ecq4K1zpfQQ g8oA== 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 g19-20020ac87d13000000b003f505434c2dsi8213709qtb.624.2023.05.31.10.19.37 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Wed, 31 May 2023 10:19:37 -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 1q4PTL-0007g1-Oc; Wed, 31 May 2023 13:18:55 -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 1q4PTJ-0007ez-7a; Wed, 31 May 2023 13:18:53 -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 1q4PTG-0006we-LO; Wed, 31 May 2023 13:18:52 -0400 Received: from localhost (localhost [127.0.0.1]) by muminek.juszkiewicz.com.pl (Postfix) with ESMTP id B892A260B95; Wed, 31 May 2023 19:18:46 +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 wpi0D7Bo9RB0; Wed, 31 May 2023 19:18:44 +0200 (CEST) Received: from applejack.lan (83.21.93.182.ipv4.supernova.orange.pl [83.21.93.182]) by muminek.juszkiewicz.com.pl (Postfix) with ESMTPSA id 949E7260078; Wed, 31 May 2023 19:18:43 +0200 (CEST) From: Marcin Juszkiewicz To: qemu-devel@nongnu.org Cc: qemu-arm@nongnu.org, Peter Maydell , Leif Lindholm , Radoslaw Biernacki , Marcin Juszkiewicz Subject: [PATCH 1/1] docs: sbsa: document board to firmware interface Date: Wed, 31 May 2023 19:18:34 +0200 Message-Id: <20230531171834.236569-1-marcin.juszkiewicz@linaro.org> X-Mailer: git-send-email 2.40.1 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 add more hardware information into DeviceTree to limit amount of hardcoded values in firmware. Signed-off-by: Marcin Juszkiewicz --- docs/system/arm/sbsa.rst | 28 +++++++++++++++++++++------- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/docs/system/arm/sbsa.rst b/docs/system/arm/sbsa.rst index 016776aed8..c5b3342b52 100644 --- a/docs/system/arm/sbsa.rst +++ b/docs/system/arm/sbsa.rst @@ -6,12 +6,7 @@ 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. @@ -19,7 +14,7 @@ standards compliance with operating systems. Supported devices """"""""""""""""" -The sbsa-ref board supports: +The ``sbsa-ref`` board supports: - A configurable number of AArch64 CPUs - GIC version 3 @@ -30,3 +25,22 @@ The sbsa-ref board supports: - Bochs display adapter on PCIe bus - A generic SBSA watchdog device + +Board to firmware interface +""""""""""""""""""""""""""" +``sbsa-ref`` is a static system that reports a very minimal DeviceTree to the +firmware for non-discoverable information about system components. This +includes both internal hardware and parts 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). + +DeviceTree information +''''''''''''''''''''''' + +Provided DeviceTree is not intended to be a complete compliant DT. Only +minimal subset is provided: + + - cpus + - memory + - platform version + - GIC addresses