From patchwork Wed Jun 14 09:21:44 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chunyan Zhang X-Patchwork-Id: 105488 Delivered-To: patch@linaro.org Received: by 10.140.91.77 with SMTP id y71csp198021qgd; Wed, 14 Jun 2017 02:22:23 -0700 (PDT) X-Received: by 10.84.230.137 with SMTP id e9mr4094982plk.100.1497432143747; Wed, 14 Jun 2017 02:22:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1497432143; cv=none; d=google.com; s=arc-20160816; b=szUdW4C0IgltiMhN1bR5L//0lYEQmioAHj55V064fGbt7GN/6eIXrSgavsjBMFN9xT wey9SS4PaqjNFlKduCdI9sRVHoeY2OOHhfCeFOEeN5vgiIHbVUmg448WCBLoWxlniljl NRHuTDLfAZjTHYHUM1wsLyCqCRxhHXceoW7OJkIjp+NXFQJh/Supt2HxQPxB0EQQ2Wxz VKWiWDODqHYA6XOo8NuXm1mChnEkz9kcl5qa2CELzlXLgHtY6Y3rLrWlU0mqCCFzHT1R m7NpD3LIG+I2b7i9dcSBkrvsHIvHAES7pBEQLfFuD/XFzuY+d0WP/UdEVIlBXuwTx/+n rhrw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :dkim-signature:arc-authentication-results; bh=4rmevh1LbuiqMSfv/g8sKaYdx4VdkhaU1/kipFdNA7U=; b=BcD7ePYxcbKbCGRUl0KUnXm1Z8wAgtM6E5rB1CCW8dXPa4lo+uyZSoNWBDwpJIFkkI gghB3NhHsiS4JnPWI+gVz9tkwNsSuO59ARomX7L4bNB387II7AqC4PZnkfYyOPfuArOI 4V33YGd6tFhWFT7fF4c0l0w6SV2oSatKsTfdHTqyJQgpnxH0KD3vdWV1MF7+7OulbPaA igEiKjhrtPLyR4+tKBvQxoyakNoh4lnvjTc2h3pY2tHwk0tBZAqAxNExbm6unKSVg2Ld 2IHcWrUNbgrfrC6HjVVqZaZAICpsf+DuOo99oBjbHDXkfYAseH0XUcguiiulvsxvPKps rrkA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.b=KppmB9fr; 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; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id q76si258681pfi.254.2017.06.14.02.22.22; Wed, 14 Jun 2017 02:22:23 -0700 (PDT) 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; dkim=pass header.i=@linaro.org header.b=KppmB9fr; 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; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752184AbdFNJWN (ORCPT + 25 others); Wed, 14 Jun 2017 05:22:13 -0400 Received: from mail-pf0-f175.google.com ([209.85.192.175]:33993 "EHLO mail-pf0-f175.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751919AbdFNJWJ (ORCPT ); Wed, 14 Jun 2017 05:22:09 -0400 Received: by mail-pf0-f175.google.com with SMTP id s66so13462599pfs.1 for ; Wed, 14 Jun 2017 02:22:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=4rmevh1LbuiqMSfv/g8sKaYdx4VdkhaU1/kipFdNA7U=; b=KppmB9frDG7zYN/VTOMpIRVQV279kAuyUm+6e2/OOespNUoLrK6/5AkU3x1vi9au3S yAZk0JBCKzykWyCPlBA+rLFU4tr0fN/qql+KsatDice1FIRHxcEvlSjKgroY4DbJMWLH UbIgLATlMSP4+Ov4KIC+GnTbWPoyxH18X/R3w= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=4rmevh1LbuiqMSfv/g8sKaYdx4VdkhaU1/kipFdNA7U=; b=pyvFtz59r8FoVYue5t8pJ1nBNBXurud6xuw7cQMG2LZy9QoL58wqWILto2ZQpFKsla 6YXxtWZGfeB0ShCz4EJi62QISpV+UGd/rEsGycfu6nYFBQLfMMBBRrD49mxlabxIjdBj ejXTgH3VYJ+TgFliH89VKPJd15mEfuJD1QoqzU688kNJOz9KWwACpIkfTJ4inWto9cQK ix8st2+yKLXeGTpU+jnfsbxmhgFQazVZGPeM975YcnxfbGQKX8uKPsLHScyBcmT0aeId kmSqOs+TCEtxVnHgo+HbKmf9jMLS6YN1Grkqlthj6vXw73qI+sb4MxbJ8nGO8YSOdAm7 NOUA== X-Gm-Message-State: AKS2vOw/lWh0rBvDzDEAmeSY7b1592SMEr52w6J6rNwWOvOE4GLOujbH NBBxcLhJ12ayb9CM6k7rkA== X-Received: by 10.99.168.67 with SMTP id i3mr3393359pgp.23.1497432129073; Wed, 14 Jun 2017 02:22:09 -0700 (PDT) Received: from ubuntu16.spreadtrum.com ([117.18.48.82]) by smtp.gmail.com with ESMTPSA id t82sm1064872pfe.88.2017.06.14.02.22.02 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 14 Jun 2017 02:22:07 -0700 (PDT) From: Chunyan Zhang To: robh+dt@kernel.org, mturquette@baylibre.com, sboyd@codeaurora.org Cc: mark.rutland@arm.com, linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, zhang.lyra@gmail.com Subject: [PATCH v2] Documentation: clock: address more for clock-cells property Date: Wed, 14 Jun 2017 17:21:44 +0800 Message-Id: <1497432104-22609-1-git-send-email-zhang.chunyan@linaro.org> X-Mailer: git-send-email 2.7.4 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The value of property 'clock-cells' is not determined only by the number of clock outputs in one clock node, it is determined by whether the clock output in this node can be referenced directly without index. If the output clock has to be referenced by a index, the clock-cell of this clock node can't be defined 0. Signed-off-by: Chunyan Zhang --- Documentation/devicetree/bindings/clock/clock-bindings.txt | 10 ++++++++++ 1 file changed, 10 insertions(+) -- 2.7.4 diff --git a/Documentation/devicetree/bindings/clock/clock-bindings.txt b/Documentation/devicetree/bindings/clock/clock-bindings.txt index 2ec489e..e2b76b4 100644 --- a/Documentation/devicetree/bindings/clock/clock-bindings.txt +++ b/Documentation/devicetree/bindings/clock/clock-bindings.txt @@ -18,6 +18,9 @@ Required properties: with a single clock output and 1 for nodes with multiple clock outputs. + There's one exception, please see the description for + clock-indices below. + Optional properties: clock-output-names: Recommended to be a list of strings of clock output signal names indexed by the first cell in the clock specifier. @@ -48,6 +51,13 @@ clock-indices: If the identifying number for the clocks in the node is not linear from zero, then this allows the mapping of identifiers into the clock-output-names array. + This property not only servers for clocks with multiple + clock outputs, but also for clocks with a single clock + output whose identifying number is not zero. + + So long as clock-indices is set, clock-cells cannot be + set zero. + For example, if we have two clocks <&oscillator 1> and <&oscillator 3>: oscillator {