From mboxrd@z Thu Jan 1 00:00:00 1970 Delivery-date: Fri, 17 Mar 2023 12:09:36 +0100 Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by lore.white.stw.pengutronix.de with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1pd7xn-003qjA-6e for lore@lore.pengutronix.de; Fri, 17 Mar 2023 12:09:36 +0100 Received: from bombadil.infradead.org ([2607:7c80:54:3::133]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pd7xm-0003Dg-PX for lore@pengutronix.de; Fri, 17 Mar 2023 12:09:35 +0100 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id: Content-Transfer-Encoding:MIME-Version:Message-Id:Date:Subject:To:From: Reply-To:Content-Type:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=Ku1ASnTS4ytN4Bb0TfHvaG/YEzsj7VkJXTUBW7FWvAA=; b=yPowrC9+YFTlEc GL7+tS7QkPyEakiSuaUgOdT+fxeVJPOMBrdd59zyDCskB/wbDjr705hKVW/AH7zmL1G0xV/7NiHJb tJzFQ7b2/9uZC1Fvl2YqYVzoSalMoucVFdr7KA7zgrjme6Ejg1IW3SQBXkW7loiIfJDniJ7XhnEAl 4xH39gViIjr8M2oLSYU/Qxv2PVKXrFhvNRDE/rvFMmmokZ/urBLFdSa5BB+XNlMfgJhoRjasE0zRM e3iHUZWtgrRGkJ1Hr4xIIPYmKVZkXw2OSfhCKbfqI21NmJmVNAdLs+pgQ6IRTQeOWm8ULEqP4tRBt 8/PNxia17wWRGVOi2L5w==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1pd7wO-00209Z-2P; Fri, 17 Mar 2023 11:08:08 +0000 Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1pd7wI-00207A-1z for barebox@lists.infradead.org; Fri, 17 Mar 2023 11:08:07 +0000 Received: from drehscheibe.grey.stw.pengutronix.de ([2a0a:edc0:0:c01:1d::a2]) by metis.ext.pengutronix.de with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pd7wB-00034g-5q; Fri, 17 Mar 2023 12:07:55 +0100 Received: from [2a0a:edc0:0:1101:1d::39] (helo=dude03.red.stw.pengutronix.de) by drehscheibe.grey.stw.pengutronix.de with esmtp (Exim 4.94.2) (envelope-from ) id 1pd7wA-004knO-Ha; Fri, 17 Mar 2023 12:07:54 +0100 Received: from jzi by dude03.red.stw.pengutronix.de with local (Exim 4.94.2) (envelope-from ) id 1pd7w9-003VPW-I4; Fri, 17 Mar 2023 12:07:53 +0100 From: Johannes Zink To: barebox@lists.infradead.org Date: Fri, 17 Mar 2023 12:07:48 +0100 Message-Id: <20230317110748.835678-1-j.zink@pengutronix.de> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230317_040802_649474_3B141440 X-CRM114-Status: UNSURE ( 9.14 ) X-CRM114-Notice: Please train this message. X-BeenThere: barebox@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Johannes Zink , afa@pengutronix.de, jzi@pengutronix.de Sender: "barebox" X-SA-Exim-Connect-IP: 2607:7c80:54:3::133 X-SA-Exim-Mail-From: barebox-bounces+lore=pengutronix.de@lists.infradead.org X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on metis.ext.pengutronix.de X-Spam-Level: X-Spam-Status: No, score=-4.5 required=4.0 tests=AWL,BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,SPF_HELO_NONE,SPF_NONE autolearn=unavailable autolearn_force=no version=3.4.2 Subject: [PATCH] Documentation: devicetree: list automatic boot argument fixups X-SA-Exim-Version: 4.2.1 (built Wed, 08 May 2019 21:11:16 +0000) X-SA-Exim-Scanned: Yes (on metis.ext.pengutronix.de) Barebox automatically fixes up several entries to the root and chosen-node of the devicetree passed to the booted system. These entries contain information about the hardware, reset source and the barebox version string. Add documentation on how to query these information from the booted linux system. Signed-off-by: Johannes Zink --- Documentation/devicetree/index.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/Documentation/devicetree/index.rst b/Documentation/devicetree/index.rst index 36fa69058d1d..92a91dc35a11 100644 --- a/Documentation/devicetree/index.rst +++ b/Documentation/devicetree/index.rst @@ -151,3 +151,24 @@ Contents: bindings/regulator/* bindings/rtc/* bindings/watchdog/* + +automatic boot argument fixups to the devicetree +------------------------------------------------ + +Barebox automatically fixes up some arguments in the devicetree. + +In the devicetree root barebox fixes up + + * serial-number (if available) + * machine compatible (if available) + +In the ``chosen``-node barebox fixes up + + * barebox-version + * reset-source + * reset-source-instance (if available) + * reset-source-device (phandle, only if available) + * bootsource + * boot-hartid (only on RISCV) + +These values can be read from the booted linux system in ``/proc/device-tree/``. -- 2.30.2