From patchwork Thu Jun 1 08:46:41 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chunyan Zhang X-Patchwork-Id: 100836 Delivered-To: patch@linaro.org Received: by 10.140.96.100 with SMTP id j91csp701104qge; Thu, 1 Jun 2017 01:47:27 -0700 (PDT) X-Received: by 10.36.44.212 with SMTP id i203mr1377003iti.76.1496306847470; Thu, 01 Jun 2017 01:47:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1496306847; cv=none; d=google.com; s=arc-20160816; b=c4ayvrs7D+cKB0h1sg4osfHMpuJg43QBmHJZAwaItXFn/mJ5TbiZjNPnGySJBGnT44 mLTlKiMpFILisFa8sY9ATQ2ez//fyiU6Wnu246rPOtx9zJcecB+HbRyBeMxqfOAYUj22 yYFbaz8eIEXfS0o0Knepq9K3dGHbAwFURL0IhrB+egH6faWGnRXKxAVfv8IJhQ0IjXGA s0/cbivNJY8fiAKCxzgMf43PhQ6njx68Yj5Y1KvvsTIaegiPqG3To/t7/6hKxLnQvWio dKagYpze2nOZj2S2aJxWph4rSfPXaFDkoUScwYPi06eFimuvCpiLhZ/G2i3v96KNgCuE jTgw== 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=ywTBiBkFe9cyyyP7K7OHlfLRcGsUtKk60ckBiEfEwEY=; b=jvHq9vafPA2uSS7zKmkJo97ID9LvXsIEtgBcsMddDxxM4+Ht+w4qfSnTwW6hG5FOIh 4c+pIiJ7rnY6jXvajXWp+TbGABBt2SOLL54rg1gIcGr00C+lkArhtY7kWT65NgVYDwO9 P8H+cpQxWUf0S2n3KsGxz8PzjSI2WosTLUInjRdtd+YymS8QVxcbC9F9GsPGS/xvgebi na13YhCKQOrAC3ltdDTPq9q9pJADhCa/wiP69Xm2QudvHtNmrT2uqLUzyVKGCDCbT4CW J1hHvb9PaS6Q9DxI3WgMxaHRi+lmL5vcSnGxKKFvjSCcfmjeYgAaF83NpnsdgdBKjXw2 zy6Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org; 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 g66si2148317ite.33.2017.06.01.01.47.26; Thu, 01 Jun 2017 01:47:27 -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; 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 S1751783AbdFAIrE (ORCPT + 25 others); Thu, 1 Jun 2017 04:47:04 -0400 Received: from mail-io0-f180.google.com ([209.85.223.180]:33727 "EHLO mail-io0-f180.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751093AbdFAIrB (ORCPT ); Thu, 1 Jun 2017 04:47:01 -0400 Received: by mail-io0-f180.google.com with SMTP id p24so29914113ioi.0 for ; Thu, 01 Jun 2017 01:47:01 -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=ywTBiBkFe9cyyyP7K7OHlfLRcGsUtKk60ckBiEfEwEY=; b=VZt0nbJQTw3H1xOxEL9qZhDWbvt50PBXK76B5Gn8fCD/oO8N7wjGE/cuue+3hH5g24 u+xq0GUxLVKhAnRorXbYfjyglEAWf71llqWV186ZF3SoRSBXDdFUukjTf3jmXLF8xltv qTnhh3cIAKenC8G5Dxii00GANvj+/YF2JzVDg= 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=ywTBiBkFe9cyyyP7K7OHlfLRcGsUtKk60ckBiEfEwEY=; b=uO7Ixb0ZnLPA+j003i211pIycIcSQz/+WvlSTPN7wG1Znvt4KIM+xjjTfHQi1FcG5j 6ILxh81mVOCvpiRUPKKTnMy86xxiWIBmOqZnPuEfHOStNX0udMmsnQ1Q+5Tv5QANlDN6 FN7OVL0cRinNGU2nWHwABMmoBfD6iE6xA0MIT57xT+Rc9M8cDi3ULfBP6ZB8/PJ42qwC KN3gfuq3XDwLUQiO+ujlhljaovtbQuQrhuqjdRNBnGU9S4dxd3Qngri78Avk6nS9EGSp 1SrOUWXL8pke1N86h0SeAyB9EJ8Q+ensgF9GCZ9PDB5/BzA4TizEQhPr2qam1ia5qY39 MIZA== X-Gm-Message-State: AODbwcAMqLuW0rh7R+yQUg6K5iZB1Klz00gy4hiTPx37GsPVzEio1CIX HGyITYLpVtQ1Lgyb X-Received: by 10.98.10.204 with SMTP id 73mr168686pfk.191.1496306820737; Thu, 01 Jun 2017 01:47:00 -0700 (PDT) Received: from ubuntu16.spreadtrum.com ([117.18.48.82]) by smtp.gmail.com with ESMTPSA id z3sm34099811pfk.99.2017.06.01.01.46.57 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 01 Jun 2017 01:47:00 -0700 (PDT) From: Chunyan Zhang To: mturquette@baylibre.com, sboyd@codeaurora.org, robh+dt@kernel.org, mark.rutland@arm.com Cc: linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, zhang.lyra@gmail.com Subject: [PATCH] Documentation: clock: address more for clock-cells property Date: Thu, 1 Jun 2017 16:46:41 +0800 Message-Id: <1496306801-19239-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 actually 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, 8 insertions(+), 2 deletions(-) -- 2.7.4 diff --git a/Documentation/devicetree/bindings/clock/clock-bindings.txt b/Documentation/devicetree/bindings/clock/clock-bindings.txt index 2ec489e..cef3db5 100644 --- a/Documentation/devicetree/bindings/clock/clock-bindings.txt +++ b/Documentation/devicetree/bindings/clock/clock-bindings.txt @@ -15,8 +15,14 @@ value of a #clock-cells property in the clock provider node. Required properties: #clock-cells: Number of cells in a clock specifier; Typically 0 for nodes - with a single clock output and 1 for nodes with multiple - clock outputs. + with a single clock output and it must be able to be + referenced without index, and 1 for nodes with single or + multiple clock outputs which have to be referenced by index. + + Please note that if a node with a single clock output + but it has "clock-indices" property (see bellow), it has + to be referenced by index, its "#clock-cells" cannot be + defined 0. Optional properties: clock-output-names: Recommended to be a list of strings of clock output signal