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: 41642 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-la0-f71.google.com (mail-la0-f71.google.com [209.85.215.71]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id C7D67244C2 for ; Thu, 27 Nov 2014 17:56:42 +0000 (UTC) Received: by mail-la0-f71.google.com with SMTP id s18sf3334449lam.2 for ; Thu, 27 Nov 2014 09:56:41 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:delivered-to:from:to:cc:subject :date:message-id:in-reply-to:references:sender:precedence:list-id :x-original-sender:x-original-authentication-results:mailing-list :list-post:list-help:list-archive:list-unsubscribe; bh=LIY48ChSFSxDKcKfhYNp/H+i0KoYSQHWq9D/LMq2/jI=; b=Rcv31+ABfNgCGexex4Cx+RClHXsJXk4uAJCRp92FQPRcrv77qFJvjJZEY6qNxI9IOk /hUpkWtqIibIWjRt/mblNG9/9SVvOnnjQiAAxgyqya8zyEo7EyrfbpeC8CKReRMEk7T+ aMhOnAovYcforIbkp9uhIDgjHwmqB/ADzzsxKcu3GC11gjAL5ONTHHjGbSj91UBi8HdW WUra2ECtCRfLHKdwi9qz1ZGOgCdkzOHedlBCHDGzacrEQnQNH5XW8GQKhOTr+HniWYyZ TgUw2g+oaEpyZwcuP363+1s1lpMhV0VlqBXyfxyYT8x5a66OMbloVdSnghjHvb2IXgkM r1lw== X-Gm-Message-State: ALoCoQnkWqH/OiwdoUT19507QQNCmImZEIm7TfXWJjOrUqr+hyPEfuu8tS106fIjntq5nhxyl5RS X-Received: by 10.112.138.234 with SMTP id qt10mr11076547lbb.4.1417111001713; Thu, 27 Nov 2014 09:56:41 -0800 (PST) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.152.27.193 with SMTP id v1ls384276lag.9.gmail; Thu, 27 Nov 2014 09:56:41 -0800 (PST) X-Received: by 10.112.172.97 with SMTP id bb1mr39819071lbc.38.1417111001535; Thu, 27 Nov 2014 09:56:41 -0800 (PST) Received: from mail-lb0-f170.google.com (mail-lb0-f170.google.com. [209.85.217.170]) by mx.google.com with ESMTPS id bf5si7906588lab.62.2014.11.27.09.56.41 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 27 Nov 2014 09:56:41 -0800 (PST) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.217.170 as permitted sender) client-ip=209.85.217.170; Received: by mail-lb0-f170.google.com with SMTP id w7so4571739lbi.1 for ; Thu, 27 Nov 2014 09:56:41 -0800 (PST) X-Received: by 10.112.14.69 with SMTP id n5mr40150962lbc.34.1417111001424; Thu, 27 Nov 2014 09:56:41 -0800 (PST) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.184.201 with SMTP id ew9csp833114lbc; Thu, 27 Nov 2014 09:56:40 -0800 (PST) X-Received: by 10.67.14.36 with SMTP id fd4mr64976527pad.79.1417110999705; Thu, 27 Nov 2014 09:56:39 -0800 (PST) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id i4si12658435pdj.94.2014.11.27.09.56.38 for ; Thu, 27 Nov 2014 09:56:39 -0800 (PST) Received-SPF: none (google.com: linux-kernel-owner@vger.kernel.org does not designate permitted sender hosts) client-ip=209.132.180.67; Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751651AbaK0R4h (ORCPT + 26 others); Thu, 27 Nov 2014 12:56:37 -0500 Received: from mail-wi0-f175.google.com ([209.85.212.175]:63646 "EHLO mail-wi0-f175.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751146AbaK0Rzu (ORCPT ); Thu, 27 Nov 2014 12:55:50 -0500 Received: by mail-wi0-f175.google.com with SMTP id l15so16498744wiw.8 for ; Thu, 27 Nov 2014 09:55:49 -0800 (PST) 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 Cc: mark.rutland@arm.com, grant.likely@linaro.org, robh+dt@kernel.org, plagnioj@jcrosoft.com, ijc@debian.org, andrew@lunn.ch, s.hauer@pengutronix.de 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> Sender: linux-kernel-owner@vger.kernel.org Precedence: list List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: leif.lindholm@linaro.org X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.217.170 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , 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