From patchwork Thu Nov 27 17:56:05 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leif Lindholm X-Patchwork-Id: 5398751 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 767BA9F2F5 for ; Thu, 27 Nov 2014 17:58:31 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id A97912013A for ; Thu, 27 Nov 2014 17:58:30 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id CF5D12017D for ; Thu, 27 Nov 2014 17:58:29 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Xu3Iu-0003S0-Jt; Thu, 27 Nov 2014 17:56:32 +0000 Received: from mail-wg0-f48.google.com ([74.125.82.48]) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Xu3IZ-0003Eh-Kk for linux-arm-kernel@lists.infradead.org; Thu, 27 Nov 2014 17:56:12 +0000 Received: by mail-wg0-f48.google.com with SMTP id y19so7032814wgg.35 for ; Thu, 27 Nov 2014 09:55:49 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=NVhz4k/Y0yy62/WRsHTfX1vhH/P6Z9K9AqZVnJN8GcM=; b=RmEv1lNBpQ1rVeSDucpo7b7bOsMhXY2lrzQ56UYVVSQVja3BqEfgbW/8HRIOWent+c zSDUM6vbYGiMBMywqWeuuzyU6eaOGwhhJ0b2J2WEoKk5ZbMb6sKZezwCHAr/4QX2rY0Y afAXoV1lB6sDhUUtHx9TWWQ3feeLYkcI5VjDJXMvG5u+xAhyXyC/Jk0EZyZ2t6t5Ww+Y vTNd/P3KZc7MYdiJ7d9TmQ/xYxSNRPUPEQuCOIBOwhyGRD009zOLfwhLPcTtOKI2rL4b 1WNcMKZ0aWMSyCYx48omnm5wc5jxxYw9qSCkxUoK1gDTNIDBCELW6q0ad2EscmdzGmki P2pw== X-Gm-Message-State: ALoCoQmHNkf0c64VOca15p+aH5O5hH+38tfJrjTiZppPuZA+w+rHi1xy6/K14q2Mti+l8ERG0YPO X-Received: by 10.194.3.2 with SMTP id 2mr61521574wjy.89.1417110949809; Thu, 27 Nov 2014 09:55:49 -0800 (PST) Received: from mohikan.mushroom.smurfnet.nu (cpc4-cmbg17-2-0-cust71.5-4.cable.virginm.net. [86.14.224.72]) by mx.google.com with ESMTPSA id nj9sm12404437wic.10.2014.11.27.09.55.48 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 27 Nov 2014 09:55:49 -0800 (PST) From: Leif Lindholm To: devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 1/3] devicetree: of: Add bindings for chosen node, stdout-path Date: Thu, 27 Nov 2014 17:56:05 +0000 Message-Id: <1417110967-16284-2-git-send-email-leif.lindholm@linaro.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1417110967-16284-1-git-send-email-leif.lindholm@linaro.org> References: <1417110967-16284-1-git-send-email-leif.lindholm@linaro.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20141127_095611_831309_CD3E54E1 X-CRM114-Status: GOOD ( 11.20 ) X-Spam-Score: -0.7 (/) Cc: mark.rutland@arm.com, andrew@lunn.ch, s.hauer@pengutronix.de, robh+dt@kernel.org, ijc@debian.org, grant.likely@linaro.org, plagnioj@jcrosoft.com X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_LOW, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add a global binding for the chosen node. Include a description of the stdout-path, and an explicit statement on its extra options in the context of a UART console. Opening description stolen from www.devicetree.org, and part of the remaining text provided by Mark Rutland. Signed-off-by: Leif Lindholm --- Documentation/devicetree/bindings/chosen.txt | 42 ++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 Documentation/devicetree/bindings/chosen.txt diff --git a/Documentation/devicetree/bindings/chosen.txt b/Documentation/devicetree/bindings/chosen.txt new file mode 100644 index 0000000..9cd74e9 --- /dev/null +++ b/Documentation/devicetree/bindings/chosen.txt @@ -0,0 +1,42 @@ +The chosen node +--------------- + +The chosen node does not represent a real device, but serves as a place +for passing data between firmware and the operating system, like boot +arguments. Data in the chosen node does not represent the hardware. + + +stdout-path property +-------------------- + +Device trees may specify the device to be used for boot console output +with a stdout-path property under /chosen, as described in ePAPR, e.g. + +/ { + chosen { + stdout-path = "/serial@f00:115200"; + }; + + serial@f00 { + compatible = "vendor,some-uart"; + reg = <0xf00 0x10>; + }; +}; + +If the character ":" is present in the value, this terminates the path. +The meaning of any characters following the ":" is device-specific, and +must be specified in the relevant binding documentation. + +For UART devices, the format supported by uart_parse_options() is the +expected one. In this case, the format of the string is: + + {{{}}} + +where + + baud - baud rate in decimal + parity - 'n' (none), 'o', (odd) or 'e' (even) + bits - number of data bits + flow - 'r' (rts) + +For example: 115200n8r