From patchwork Tue May 22 10:01:23 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Michel Pollet X-Patchwork-Id: 10417817 X-Patchwork-Delegate: geert@linux-m68k.org 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 185A56053B for ; Tue, 22 May 2018 10:07:17 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 096B428BB6 for ; Tue, 22 May 2018 10:07:17 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id F1DE028BBA; Tue, 22 May 2018 10:07:16 +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=-7.9 required=2.0 tests=BAYES_00, MAILING_LIST_MULTI, RCVD_IN_DNSWL_HI 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 6ED5328BB6 for ; Tue, 22 May 2018 10:07:16 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751275AbeEVKHQ (ORCPT ); Tue, 22 May 2018 06:07:16 -0400 Received: from relmlor2.renesas.com ([210.160.252.172]:60503 "EHLO relmlie1.idc.renesas.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751060AbeEVKHM (ORCPT ); Tue, 22 May 2018 06:07:12 -0400 Received: from unknown (HELO relmlir2.idc.renesas.com) ([10.200.68.152]) by relmlie1.idc.renesas.com with ESMTP; 22 May 2018 19:07:10 +0900 Received: from relmlii1.idc.renesas.com (relmlii1.idc.renesas.com [10.200.68.65]) by relmlir2.idc.renesas.com (Postfix) with ESMTP id DAA4E89E7C; Tue, 22 May 2018 19:07:10 +0900 (JST) X-IronPort-AV: E=Sophos;i="5.49,429,1520866800"; d="scan'208";a="280253499" Received: from unknown (HELO be1yocto.ree.adwin.renesas.com) ([172.29.43.62]) by relmlii1.idc.renesas.com with ESMTP; 22 May 2018 19:07:07 +0900 From: Michel Pollet To: linux-renesas-soc@vger.kernel.org, Simon Horman Cc: phil.edworthy@renesas.com, Michel Pollet , Michel Pollet , Magnus Damm , Rob Herring , Mark Rutland , Michael Turquette , Stephen Boyd , Geert Uytterhoeven , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-clk@vger.kernel.org Subject: [PATCH v6 3/6] dt-bindings: clock: renesas, rzn1-clocks: document RZ/N1 clock driver Date: Tue, 22 May 2018 11:01:23 +0100 Message-Id: <1526983321-41949-4-git-send-email-michel.pollet@bp.renesas.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1526983321-41949-1-git-send-email-michel.pollet@bp.renesas.com> References: <1526983321-41949-1-git-send-email-michel.pollet@bp.renesas.com> Sender: linux-renesas-soc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-renesas-soc@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP The Renesas RZ/N1 Family (Part #R9A06G0xx) requires a driver to provide the SoC clock infrastructure for Linux. This documents the driver bindings. Signed-off-by: Michel Pollet --- .../bindings/clock/renesas,rzn1-clocks.txt | 44 ++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/renesas,rzn1-clocks.txt diff --git a/Documentation/devicetree/bindings/clock/renesas,rzn1-clocks.txt b/Documentation/devicetree/bindings/clock/renesas,rzn1-clocks.txt new file mode 100644 index 0000000..0c41137 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/renesas,rzn1-clocks.txt @@ -0,0 +1,44 @@ +* Renesas RZ/N1 Clock Driver + +This driver provides the clock infrastructure used by all the other drivers. + +One of the 'special' feature of this infrastructure is that Linux doesn't +necessary 'own' all the clocks on the SoC, some other OS runs on +the Cortex-M3 core and that OS can access and claim it's own clocks. + +Required Properties: + + - compatible: Must be + - "renesas,r9a06g032-clocks" for the RZ/N1D + and "renesas,rzn1-clocks" as a fallback. + - reg: Base address and length of the memory resource used by the driver + - #clock-cells: Must be 1 + +Examples +-------- + + - Clock driver device node: + + clock: clocks@4000c000 { + compatible = "renesas,r9a06g032-clocks", + "renesas,rzn1-clocks"; + reg = <0x4000c000 0x1000>; + status = "okay"; + #clock-cells = <1>; + }; + + + - Other drivers can use the clocks as in: + + uart0: serial@40060000 { + compatible = "snps,dw-apb-uart"; + reg = <0x40060000 0x400>; + interrupts = ; + reg-shift = <2>; + reg-io-width = <4>; + clocks = <&clock RZN1_CLK_UART0>; + clock-names = "baudclk"; + }; + Note the use of RZN1_CLK_UART0 -- these constants are declared in + the rzn1-clocks.h header file. These are not hardware based constants + and are Linux specific.