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: 9758863 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 30BE660375 for ; Thu, 1 Jun 2017 08:47:18 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1D9B2284FC for ; Thu, 1 Jun 2017 08:47:18 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1259E284FF; Thu, 1 Jun 2017 08:47:18 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.3 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A7A2E284FC for ; Thu, 1 Jun 2017 08:47:17 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751644AbdFAIrD (ORCPT ); Thu, 1 Jun 2017 04:47:03 -0400 Received: from mail-io0-f170.google.com ([209.85.223.170]:36342 "EHLO mail-io0-f170.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751607AbdFAIrB (ORCPT ); Thu, 1 Jun 2017 04:47:01 -0400 Received: by mail-io0-f170.google.com with SMTP id o12so29845243iod.3 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=ncuS8zjC3MRN44AeYq+UWFEFuyNOx9EY8F31KqYQbomfiWvErLhE+qCz2hlge4y2ZO q9ayndiup1bD0UIbYTwEVbvqkA4JaZ/NQpkniKcGarQfGSI5thgtwP1f6VkxXY1SEzQL wepNsmETbSz7Uw8RGepxaQTPoO4Y5qOrMv2VrN8xUgpk01MI/ajhlaaD6hZKWrTOLy75 X+nAvpkj/UysKNn0JRmUUyd4MT9cZztgbhwZlnZscTHRgeIj3OJ4MxN/FuYlxvJdfeeq 6yH92IDiD+SCMixvhEvAQLxI0y6MmxpZgi3on2QvXf8nrZOij3zLJK2xJowwT4v7rVo7 BkYQ== X-Gm-Message-State: AODbwcAhNswAxMd6sMuw7KQHHzXCQoZA/sXyKi54EFkbXZDpXct8uqu3 jRv6K7cBgU+cmRd+/WytlA== 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-clk-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-clk@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP 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(-) 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