From patchwork Wed Nov 19 10:32:23 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlo Caione X-Patchwork-Id: 5335981 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork2.web.kernel.org (Postfix) with ESMTP id C3F83C11AC for ; Wed, 19 Nov 2014 10:38:45 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id E2B972018E for ; Wed, 19 Nov 2014 10:38:44 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id EA7BB20108 for ; Wed, 19 Nov 2014 10:38:42 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Xr2cW-0002ih-M2; Wed, 19 Nov 2014 10:36:20 +0000 Received: from mail-wg0-x234.google.com ([2a00:1450:400c:c00::234]) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Xr2ZC-0005ke-Oo for linux-arm-kernel@lists.infradead.org; Wed, 19 Nov 2014 10:32:55 +0000 Received: by mail-wg0-f52.google.com with SMTP id a1so434510wgh.11 for ; Wed, 19 Nov 2014 02:32:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=0Cpl5nXC+QKujShcujOe8XQGu2CkDsdJkXjBJ46iggY=; b=IqgcCCDIwGiW5KCMpX1TRIaXggSdCUkTCdTtKbhNER0D5fhekMNqORFO4BsprR3Y96 xwTGvxQh+sFxpXASkcHKRSa3qyKC0WZ2uobdSGF4Ge5KmnMJbU98I16IWT1mgFuFoUKY Yeb45otCT4LPKTgLSeIUv+tOmetbB+ilhAfn6vZcF5mk+Qz8JNZzKn/Hpkp5DJ/JYgm+ UWfPvajrE3GexXNO/zKlLBrziXndJHoVNuq2jXtL1UrEbg1kgSTjYO5Z02SOObp7z6sm c4j9uosVN8DHmRCyyCxwafU8a3dGPRoCCyIR5lB4IfB5NSt6uh28r7IIkXOZr9nkRL8z vURA== X-Received: by 10.194.110.4 with SMTP id hw4mr57100161wjb.102.1416393155507; Wed, 19 Nov 2014 02:32:35 -0800 (PST) Received: from localhost.localdomain (host146-114-dynamic.0-87-r.retail.telecomitalia.it. [87.0.114.146]) by mx.google.com with ESMTPSA id dc8sm1623493wib.7.2014.11.19.02.32.34 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 19 Nov 2014 02:32:34 -0800 (PST) From: Carlo Caione To: mturquette@linaro.org, linux-arm-kernel@lists.infradead.org, b.galvani@gmail.com, jerry.cao@amlogic.com, victor.wan@amlogic.com, eric.hankinson@leandogsoftware.com, maxime.ripard@free-electrons.com, emilio@elopez.com.ar, robh+dt@kernel.org, p.zabel@pengutronix.de Subject: [PATCH 4/4] ARM: meson: add documentation for reset/clock controller Date: Wed, 19 Nov 2014 11:32:23 +0100 Message-Id: <1416393143-20434-5-git-send-email-carlo@caione.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1416393143-20434-1-git-send-email-carlo@caione.org> References: <1416393143-20434-1-git-send-email-carlo@caione.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20141119_023255_139533_AD37EBD8 X-CRM114-Status: GOOD ( 11.53 ) X-Spam-Score: -0.7 (/) Cc: Carlo Caione X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-2.5 required=5.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_LOW, T_DKIM_INVALID, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add documentation for the reset and clock controller Signed-off-by: Carlo Caione --- .../bindings/clock/amlogic,meson6-clkc.txt | 45 ++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/amlogic,meson6-clkc.txt diff --git a/Documentation/devicetree/bindings/clock/amlogic,meson6-clkc.txt b/Documentation/devicetree/bindings/clock/amlogic,meson6-clkc.txt new file mode 100644 index 0000000..b4a8813 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/amlogic,meson6-clkc.txt @@ -0,0 +1,45 @@ +* Amlogic Meson6 Clock and Reset Unit + +The Amlogic Meson6 clock controller generates and supplies clock to various +controllers within the SoC and also implements a reset controller for SoC +peripherals. + +Required Properties: + +- compatible: should be "amlogic,meson6-clkc" +- reg: it must be composed by three tuples: + 0) physical base address of the xtal register and length of memory + mapped region. + 1) physical base address of the clock controller and length of memory + mapped region. + 2) physical base address of the AO domain reset register and length + of memory mapped region. + +- #clock-cells: should be 1. +- #reset-cells: should be 1. + +Each clock is assigned an identifier and client nodes can use this identifier +to specify the clock which they consume. All available clocks are defined as +preprocessor macros in the dt-bindings/clock/meson6-clkc.h header and can be +used in device tree sources. + +Example: Clock controller node: + + clkc: clock-controller@c1104000 { + #clock-cells = <1>; + #reset-cells = <1>; + compatible = "amlogic,meson6-clkc"; + reg = <0xc1108000 0x4>, <0xc1104000 0x460>, <0xc8100040 0x4>; + }; + + +Example: UART controller node that consumes the clock generated by the clock + controller: + + uart_AO: serial@c81004c0 { + compatible = "amlogic,meson-uart"; + reg = <0xc81004c0 0x14>; + interrupts = <0 90 1>; + clocks = <&clkc CLKID_CLK81>; + status = "disabled"; + };