Received: by 2002:ad5:474a:0:0:0:0:0 with SMTP id i10csp923120imu; Wed, 28 Nov 2018 01:34:58 -0800 (PST) X-Google-Smtp-Source: AFSGD/XGN5z0/wEm3q+OFB6/o0+ueFDzWf3rut04MQ5fWYk0ARriYmvzFNfjR0lmqI2vaI2UtSp6 X-Received: by 2002:a62:5182:: with SMTP id f124mr34533073pfb.238.1543397698072; Wed, 28 Nov 2018 01:34:58 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1543397698; cv=none; d=google.com; s=arc-20160816; b=q9xiTy7sIm5ZLXYfUodLp5/9OT/1gUpVDHZ0uRACLvYyeC0GyJAI2TkwVSMqW/Ew6+ BnHief5iCXb2VA8MYXOyF0fTmqGSdBBwg3nhtr9wucYY6UdKFpTSqGpgVxgF2Mr7lv91 4dWrOzxCcIy3Jsy4oIpJ/dn59J6HHL2R+qwgguY5BuDhfAoKadeEzWcdU1HlG7o/3Gow gf6Ia/Qa2rGeCH0AL9SygRSSd4w4b2wNqL/cwFl4DKlT26Q/H1QYL4wV/8DdtQSKuR71 xSRSdUkPaL28JXgQMtbX1x39p4+ZdfddCx5R7f21m8/gQAq3dihVlxtQ90Ae4PYztVNp 6ZjA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=x0SSTTlD3cYfEX1PCzgR3qVMLl3tDcDmS+KGeJo9f4U=; b=SouIo+B8hxKrhs4BaGq6hZAK4lyzMWh8T2V7nzmbpogv3nhkRGRaFNfcC7KgRwCsDU AupEuCFrdW+3TRPEp9aTroNRMLDpCwEuKor56dvvM8MQtNPVqSkHWNfk6PAhGH5/xsoT MkFmZghtzGEMsCZSJ1Gnrg07zn/c4mff52jrXul0CcW+Jr4ksTnW1x57QtVYpfHz/heW Y3cZ/JL3q6h6p/g0C/0ADdXb7lxV/v7gYqH8mF/5kQjRlU9I1YZlyLz9dr1DUPfS3vtb KrC0j8SffXtxMc7qFWSfqE8XbYGs3mAK86XFnXthwZagZFrCjUo/76/tt5eSE7KXvyKO pz5w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id c24si6610501pgk.269.2018.11.28.01.34.42; Wed, 28 Nov 2018 01:34:58 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728156AbeK1Ubd (ORCPT + 99 others); Wed, 28 Nov 2018 15:31:33 -0500 Received: from mirror2.csie.ntu.edu.tw ([140.112.30.76]:49088 "EHLO wens.csie.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727986AbeK1Ubc (ORCPT ); Wed, 28 Nov 2018 15:31:32 -0500 Received: by wens.csie.org (Postfix, from userid 1000) id 352325F725; Wed, 28 Nov 2018 17:30:28 +0800 (CST) From: Chen-Yu Tsai To: Maxime Ripard , Alexandre Belloni , Alessandro Zummo , Michael Turquette , Stephen Boyd , Rob Herring , Mark Rutland Cc: Chen-Yu Tsai , linux-arm-kernel@lists.infradead.org, linux-rtc@vger.kernel.org, linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-sunxi@googlegroups.com Subject: [PATCH 01/15] dt-bindings: rtc: sun6i-rtc: Rewrite clock outputs as a list Date: Wed, 28 Nov 2018 17:29:58 +0800 Message-Id: <20181128093013.24442-2-wens@csie.org> X-Mailer: git-send-email 2.20.0.rc1 In-Reply-To: <20181128093013.24442-1-wens@csie.org> References: <20181128093013.24442-1-wens@csie.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The clock output section for this binding describes the two outputs in the descriptions for both the #clock-cells and clock-output-names properties. Instead of overlapping information that is hard to read, rewrite the clock outputs as a list of indices and descriptions. The properies can reference this list instead. This will also make it easier to add notes or conditions to the clocks, and also for adding new outputs. Signed-off-by: Chen-Yu Tsai --- Documentation/devicetree/bindings/rtc/sun6i-rtc.txt | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Documentation/devicetree/bindings/rtc/sun6i-rtc.txt b/Documentation/devicetree/bindings/rtc/sun6i-rtc.txt index 12c083c1140a..d3e96459fc66 100644 --- a/Documentation/devicetree/bindings/rtc/sun6i-rtc.txt +++ b/Documentation/devicetree/bindings/rtc/sun6i-rtc.txt @@ -10,10 +10,12 @@ Required properties: Required properties for new device trees - clocks : phandle to the 32kHz external oscillator -- clock-output-names : names of the LOSC and its external output clocks created -- #clock-cells : must be equals to 1. The RTC provides two clocks: the - LOSC and its external output, with index 0 and 1 - respectively. +- clock-output-names : names of the two clock outputs. See below. +- #clock-cells : must be equal to 1. + +The RTC provides the following clocks at the given indices: +- 0: LOSC +- 1: LOSC external output, known as X32KFOUT in the datasheet. Example: -- 2.20.0.rc1