From patchwork Mon Jan 27 22:23:33 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alex Elder X-Patchwork-Id: 23765 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-qc0-f199.google.com (mail-qc0-f199.google.com [209.85.216.199]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id AAB7A20300 for ; Mon, 27 Jan 2014 22:23:38 +0000 (UTC) Received: by mail-qc0-f199.google.com with SMTP id m20sf12708392qcx.6 for ; Mon, 27 Jan 2014 14:23:37 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:message-id:date:from:user-agent :mime-version:to:subject:references:in-reply-to:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :list-post:list-help:list-archive:list-unsubscribe:content-type :content-transfer-encoding; bh=ivx34FtHHGGs4zqj3oJi6BBMQufACaLGqX5IZXSFN/k=; b=Vxl/AXfT6oXKT7X6N+nr26KiD4J7kX3Lv+U9E5DmxCvTpXiCrEgxNpXo1pIpkk+hQJ CnZ7+XNt56CucrdSbGgQAfA2rsW72tmpq65+biwVgW4uamQ1nsEwCbgqww1NZYSaQgPm MR55XM77FROmePRg4dBN74ZhAKiIHYdWk/vrdyJBfK3LKrBq1XNA2nB33MwNZUIIbZE7 6BNHHpx0Hq3WTn3cSBxTqFJn7yf+eccCMW8HfZBVW+t9G/4OEyezVCKvCehoIUsl6JbT pwSzn/bR1mfEgo+am2fDQRgOtKb9PMNaEJiYstvkhzO1JpkXB9zND790d1XvxVs9WzoK nVlQ== X-Gm-Message-State: ALoCoQmiwSJ9hW0F+0xnMIaedNZkS8HrbVYKoWNUGt+Mc/3zd0AKdBIm0Jygi1gb6JMBKf7FYAuG X-Received: by 10.236.98.104 with SMTP id u68mr42906yhf.1.1390861417857; Mon, 27 Jan 2014 14:23:37 -0800 (PST) X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.21.8 with SMTP id 8ls1734313qgk.51.gmail; Mon, 27 Jan 2014 14:23:37 -0800 (PST) X-Received: by 10.220.131.210 with SMTP id y18mr17299225vcs.12.1390861417725; Mon, 27 Jan 2014 14:23:37 -0800 (PST) Received: from mail-ve0-f177.google.com (mail-ve0-f177.google.com [209.85.128.177]) by mx.google.com with ESMTPS id cz20si5630279veb.91.2014.01.27.14.23.37 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 27 Jan 2014 14:23:37 -0800 (PST) Received-SPF: neutral (google.com: 209.85.128.177 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.128.177; Received: by mail-ve0-f177.google.com with SMTP id jz11so3792706veb.8 for ; Mon, 27 Jan 2014 14:23:37 -0800 (PST) X-Received: by 10.220.147.16 with SMTP id j16mr1899697vcv.28.1390861417430; Mon, 27 Jan 2014 14:23:37 -0800 (PST) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patches@linaro.org Received: by 10.220.174.196 with SMTP id u4csp163275vcz; Mon, 27 Jan 2014 14:23:36 -0800 (PST) X-Received: by 10.50.154.161 with SMTP id vp1mr19549107igb.17.1390861416715; Mon, 27 Jan 2014 14:23:36 -0800 (PST) Received: from mail-ie0-f182.google.com (mail-ie0-f182.google.com [209.85.223.182]) by mx.google.com with ESMTPS id s2si18103239icz.41.2014.01.27.14.23.36 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 27 Jan 2014 14:23:36 -0800 (PST) Received-SPF: neutral (google.com: 209.85.223.182 is neither permitted nor denied by best guess record for domain of alex.elder@linaro.org) client-ip=209.85.223.182; Received: by mail-ie0-f182.google.com with SMTP id lx4so6734831iec.13 for ; Mon, 27 Jan 2014 14:23:36 -0800 (PST) X-Received: by 10.50.225.67 with SMTP id ri3mr20066301igc.16.1390861416427; Mon, 27 Jan 2014 14:23:36 -0800 (PST) Received: from [172.22.22.4] (c-71-195-31-37.hsd1.mn.comcast.net. [71.195.31.37]) by mx.google.com with ESMTPSA id ml2sm47874507igb.10.2014.01.27.14.23.35 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 27 Jan 2014 14:23:35 -0800 (PST) Message-ID: <52E6DC65.9050102@linaro.org> Date: Mon, 27 Jan 2014 16:23:33 -0600 From: Alex Elder User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: patches@linaro.org Subject: Fwd: [PATCH 1/3] clk: bcm281xx: define kona clock binding References: <529EA80A.60801@linaro.org> In-Reply-To: <529EA80A.60801@linaro.org> X-Enigmail-Version: 1.5.2 X-Forwarded-Message-Id: <529EA80A.60801@linaro.org> X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: alex.elder@linaro.org X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 209.85.128.177 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Precedence: list Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org List-ID: X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , -------- Original Message -------- Subject: [PATCH 1/3] clk: bcm281xx: define kona clock binding Date: Tue, 03 Dec 2013 21:56:58 -0600 From: Alex Elder To: Christian Daudt , Ian Campbell , Mark Rutland , Pawel Moll , Rob Herring , Rob Landley , Russell King , Stephen Warren , Mike Turquette CC: bcm-kernel-feedback-list@broadcom.com, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Document the device tree binding for Broadcom Kona architecture clock control units and clocks. Kona device nodes are represented with compatible strings having "bcm11351" in their name. Kona clocks are managed by "clock control units" (CCUs). Each CCU has a device tree node, and within that node are defined the names of the clocks provided by the CCU. The BCM281xx family of SoCs use Kona CCUs and clocks. Signed-off-by: Alex Elder Reviewed-by: Matt Porter Reviewed-by: Tim Kryger --- .../devicetree/bindings/clock/bcm-kona-clock.txt | 95 ++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/bcm-kona-clock.txt -- 1.7.9.5 diff --git a/Documentation/devicetree/bindings/clock/bcm-kona-clock.txt b/Documentation/devicetree/bindings/clock/bcm-kona-clock.txt new file mode 100644 index 0000000..0cafd6a --- /dev/null +++ b/Documentation/devicetree/bindings/clock/bcm-kona-clock.txt @@ -0,0 +1,95 @@ +Broadcom Kona Family Clocks + +This binding is associated with Broadcom SoCs having "Kona" style +clock control units (CCUs). A CCU is a clock provider that manages +a set of clock signals. Each CCU is represented by a node in the +device tree. + +This binding uses the common clock binding: + Documentation/devicetree/bindings/clock/clock-bindings.txt + +Many source clocks are described using the "fixed-clock" binding: + Documentation/devicetree/bindings/clock/fixed-clock.txt + +Required properties: +- compatible + Shall have a value "brcm,bcm11351--ccu", where + identifies the particular CCU (see below). +- reg + Shall define the base and range of the address space + containing clock control registers +- #clock-cells + Shall have the value <1> +- clock-output-names + Shall be an ordered list of strings defining the names of + the clocks provided by the CCU. + +Clock consumers refer to a particular clock supplied by a CCU using +a phandle and specifier pair, using the phandle for the CCU device +tree node and the clock's symbolic specifier. The clock specifier +is a CCU-unique 0-based index value. + + +BCM281XX family SoCs use Kona CCUs. The following table defines +the set of CCUs and clock specifiers for BCM281XX clocks. The +compatible string for the CCU uses the name in the "CCU" column +below as it's value. + + CCU Clock Type Index Specifier + --- ----- ---- ----- --------- + root frac_1m peri 0 BCM281XX_ROOT_CCU_FRAC_1M + + aon hub_timer peri 0 BCM281XX_AON_CCU_HUB_TIMER + aon pmu_bsc peri 1 BCM281XX_AON_CCU_PMU_BSC + aon pmu_bsc_var peri 2 BCM281XX_AON_CCU_PMU_BSC_VAR + + hub tmon_1m peri 0 BCM281XX_HUB_CCU_TMON_1M + + master sdio1 peri 0 BCM281XX_MASTER_CCU_SDIO1 + master sdio2 peri 1 BCM281XX_MASTER_CCU_SDIO2 + master sdio3 peri 2 BCM281XX_MASTER_CCU_SDIO3 + master sdio4 peri 3 BCM281XX_MASTER_CCU_SDIO4 + master dmac peri 4 BCM281XX_MASTER_CCU_DMAC + master usb_ic peri 5 BCM281XX_MASTER_CCU_USB_IC + master hsic2_48m peri 6 BCM281XX_MASTER_CCU_HSIC_48M + master hsic2_12m peri 7 BCM281XX_MASTER_CCU_HSIC_12M + + slave uartb peri 0 BCM281XX_SLAVE_CCU_UARTB + slave uartb2 peri 1 BCM281XX_SLAVE_CCU_UARTB2 + slave uartb3 peri 2 BCM281XX_SLAVE_CCU_UARTB3 + slave uartb4 peri 3 BCM281XX_SLAVE_CCU_UARTB4 + slave ssp0 peri 4 BCM281XX_SLAVE_CCU_SSP0 + slave ssp2 peri 5 BCM281XX_SLAVE_CCU_SSP2 + slave bsc1 peri 6 BCM281XX_SLAVE_CCU_BSC1 + slave bsc2 peri 7 BCM281XX_SLAVE_CCU_BSC2 + slave bsc3 peri 8 BCM281XX_SLAVE_CCU_BSC3 + slave pwm peri 9 BCM281XX_SLAVE_CCU_PWM + + +Device tree example: + + clocks { + slave_ccu: slave_ccu { + compatible = "brcm,bcm11351-slave-ccu"; + reg = <0x3e011000 0x0f00>; + #clock-cells = <1>; + clock-output-names = "uartb", + "uartb2", + "uartb3", + "uartb4"; + }; + ref_crystal_clk: ref_crystal { + #clock-cells = <0>; + compatible = "fixed-clock"; + clock-frequency = <26000000>; + }; + }; + uart@3e002000 { + compatible = "brcm,bcm11351-dw-apb-uart", "snps,dw-apb-uart"; + status = "disabled"; + reg = <0x3e002000 0x1000>; + clocks = <&slave_ccu BCM281XX_SLAVE_CCU_UARTB3>; + interrupts = ; + reg-shift = <2>; + reg-io-width = <4>; + };