From patchwork Mon Jan 27 22:24:05 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alex Elder X-Patchwork-Id: 23768 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-qa0-f71.google.com (mail-qa0-f71.google.com [209.85.216.71]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id D699520300 for ; Mon, 27 Jan 2014 22:24:10 +0000 (UTC) Received: by mail-qa0-f71.google.com with SMTP id j5sf12350293qaq.10 for ; Mon, 27 Jan 2014 14:24:10 -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=IpPBRdo/dsJotI3jddQ06M8BHU2jb5x++l6wvpDu2jo=; b=Ye+Xek6tREKyNDK9UoQORj7ee974XR5x0u2qcqjHGlgtExxxB+t+SIuFkt1fU2Kq2N YQmHME0n/GBRGwngzB26sGyVva3VzivrE95Nt5HPw9uQQaCyMRDSo9f1b5PWAdOrerqc ISK7pfGFUxcXswgWDjyGx2/akufKxryGfrwRv8/7+UXysnaloOorsYFAvmDWqPVWdFiU ATfh1cQ+v41WnDV5AiDJNcBxMDaUtoFFpHiPRYK44WV6kagROqOVV12AxnGHSoJhNTSt OfxDR3AAWo3Oz1mKr/RKwTTJkS18YUqeEXP7cGhWmaq9wopmu9vdR/RoMM45qur0oTb5 sDPA== X-Gm-Message-State: ALoCoQlaU7W1A+Vz4DgGGILJANl4U/umRTISpoTYwkAcrB2LQWugza5jGm5ezY3Yi0LqH7TqbG3h X-Received: by 10.58.85.3 with SMTP id d3mr1719056vez.40.1390861450009; Mon, 27 Jan 2014 14:24:10 -0800 (PST) X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.98.69 with SMTP id n63ls1616366qge.96.gmail; Mon, 27 Jan 2014 14:24:09 -0800 (PST) X-Received: by 10.58.117.65 with SMTP id kc1mr74824veb.68.1390861449914; Mon, 27 Jan 2014 14:24:09 -0800 (PST) Received: from mail-vb0-f47.google.com (mail-vb0-f47.google.com [209.85.212.47]) by mx.google.com with ESMTPS id sk6si5634253vcb.77.2014.01.27.14.24.09 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 27 Jan 2014 14:24:09 -0800 (PST) Received-SPF: neutral (google.com: 209.85.212.47 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.212.47; Received: by mail-vb0-f47.google.com with SMTP id p6so3770407vbe.6 for ; Mon, 27 Jan 2014 14:24:09 -0800 (PST) X-Received: by 10.221.20.199 with SMTP id qp7mr1895321vcb.24.1390861449821; Mon, 27 Jan 2014 14:24:09 -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 u4csp163313vcz; Mon, 27 Jan 2014 14:24:09 -0800 (PST) X-Received: by 10.50.77.38 with SMTP id p6mr24501719igw.1.1390861449107; Mon, 27 Jan 2014 14:24:09 -0800 (PST) Received: from mail-ig0-f179.google.com (mail-ig0-f179.google.com [209.85.213.179]) by mx.google.com with ESMTPS id s2si18062960icz.93.2014.01.27.14.24.08 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 27 Jan 2014 14:24:09 -0800 (PST) Received-SPF: neutral (google.com: 209.85.213.179 is neither permitted nor denied by best guess record for domain of alex.elder@linaro.org) client-ip=209.85.213.179; Received: by mail-ig0-f179.google.com with SMTP id c10so10374838igq.0 for ; Mon, 27 Jan 2014 14:24:08 -0800 (PST) X-Received: by 10.50.43.134 with SMTP id w6mr20043255igl.20.1390861448811; Mon, 27 Jan 2014 14:24:08 -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 s4sm57691342ige.0.2014.01.27.14.24.07 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 27 Jan 2014 14:24:08 -0800 (PST) Message-ID: <52E6DC85.9080904@linaro.org> Date: Mon, 27 Jan 2014 16:24:05 -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 v2 1/3] clk: bcm281xx: define kona clock binding References: <529F4B3C.4020608@linaro.org> In-Reply-To: <529F4B3C.4020608@linaro.org> X-Enigmail-Version: 1.5.2 X-Forwarded-Message-Id: <529F4B3C.4020608@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.212.47 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 v2 1/3] clk: bcm281xx: define kona clock binding Date: Wed, 04 Dec 2013 09:33:16 -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 , LKML 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 --- v2: - list all CCU compatible strings explicitly - reworded a few things, and deleted some text - CCUs and clocks are now defined at the root level - added reference to header file that defines specifiers .../devicetree/bindings/clock/bcm-kona-clock.txt | 93 ++++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/bcm-kona-clock.txt 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..56d1f49 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/bcm-kona-clock.txt @@ -0,0 +1,93 @@ +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 + +Required properties: +- compatible + Shall have one of the following values: + - "brcm,bcm11351-root-ccu" + - "brcm,bcm11351-aon-ccu" + - "brcm,bcm11351-hub-ccu" + - "brcm,bcm11351-master-ccu" + - "brcm,bcm11351-slave-ccu" +- reg + Shall define the base and range of the address space + containing clock control registers +- #clock-cells + Shall have value <1>. The permitted clock-specifier values + are defined below. +- clock-output-names + Shall be an ordered list of strings defining the names of + the clocks provided by the CCU. + + +BCM281XX family SoCs use Kona CCUs. The following table defines +the set of CCUs and clock specifiers for BCM281XX clocks. When +a clock consumer references a clocks, its symbolic specifier +(rather than its numeric index value) should be used. These +specifiers are defined in "include/dt-bindings/clock/bcm281xx.h". + + 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: + + 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>; + };