From patchwork Thu Jan 22 09:34:12 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Geert Uytterhoeven X-Patchwork-Id: 431741 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 11E6614028F for ; Thu, 22 Jan 2015 20:35:23 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752767AbbAVJfU (ORCPT ); Thu, 22 Jan 2015 04:35:20 -0500 Received: from andre.telenet-ops.be ([195.130.132.53]:45320 "EHLO andre.telenet-ops.be" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752403AbbAVJej (ORCPT ); Thu, 22 Jan 2015 04:34:39 -0500 Received: from ayla.of.borg ([84.193.93.87]) by andre.telenet-ops.be with bizsmtp id ixaL1p00m1t5w8s01xaL1C; Thu, 22 Jan 2015 10:34:36 +0100 Received: from ramsan.of.borg ([192.168.97.29] helo=ramsan) by ayla.of.borg with esmtp (Exim 4.82) (envelope-from ) id 1YEE9c-0007Mr-K2; Thu, 22 Jan 2015 10:34:20 +0100 Received: from geert by ramsan with local (Exim 4.82) (envelope-from ) id 1YEE9e-0001G4-0C; Thu, 22 Jan 2015 10:34:22 +0100 From: Geert Uytterhoeven To: Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , Grant Likely , Arnd Bergmann , Kevin Hilman , Ulf Hansson , "Rafael J. Wysocki" Cc: Olof Johansson , Simon Horman , Magnus Damm , Greg Kroah-Hartman , devicetree@vger.kernel.org, linux-sh@vger.kernel.org, linux-pm@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Geert Uytterhoeven Subject: [PATCH v3/resend 3/4] drivers: bus: Add Simple Power-Managed Bus DT Bindings Date: Thu, 22 Jan 2015 10:34:12 +0100 Message-Id: <1421919253-4784-4-git-send-email-geert+renesas@glider.be> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1421919253-4784-1-git-send-email-geert+renesas@glider.be> References: <1421919253-4784-1-git-send-email-geert+renesas@glider.be> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Signed-off-by: Geert Uytterhoeven Tested-by: Ulrich Hecht --- v3: - Add Tested-by, - Document required properties inherited from "simple-bus", - Document required "reg" property for "renesas,bsc", - Move "ranges" before "reg" in the example, v2: - New. --- .../devicetree/bindings/bus/simple-pm-bus.txt | 52 ++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 Documentation/devicetree/bindings/bus/simple-pm-bus.txt diff --git a/Documentation/devicetree/bindings/bus/simple-pm-bus.txt b/Documentation/devicetree/bindings/bus/simple-pm-bus.txt new file mode 100644 index 0000000000000000..d03abf7fd8e3997a --- /dev/null +++ b/Documentation/devicetree/bindings/bus/simple-pm-bus.txt @@ -0,0 +1,52 @@ +Simple Power-Managed Bus +======================== + +A Simple Power-Managed Bus is a transparent bus that doesn't need a real +driver, as it's typically initialized by the boot loader. + +However, its bus controller is part of a PM domain, or under the control of a +functional clock. Hence, the bus controller's PM domain and/or clock must be +enabled for child devices connected to the bus (either on-SoC or externally) +to function. + + +Generic compatible values and properties +---------------------------------------- + +Required properties: + - compatible: Must be at least one of the vendor-specific compatible values + from a vendor-specific section below, and "simple-bus" as a + fallback. + - #address-cells, #size-cells, ranges: Must describe the mapping between + parent address and child address spaces. + +Optional platform-specific properties for clock or PM domain control (at least +one of them is required): + - clocks: Must contain a reference to the functional clock(s), + - power-domains: Must contain a reference to the PM domain. + + +Vendor-specific compatible values and properties +------------------------------------------------ + +Renesas Bus State Controller (BSC): + - compatible: Must be an SoC-specific value, and "renesas,bsc" as a fallback. + SoC-specific values can be: + "renesas,bsc-r8a73a4" for R-Mobile APE6 (r8a73a4) + "renesas,bsc-sh73a0" for SH-Mobile AG5 (sh73a0) + - reg: Must contain the base address and length to access the bus controller. + - interrupts: Must contain a reference to the BSC interrupt, if available. + + +Example: + + bsc: bus@fec10000 { + compatible = "renesas,bsc-sh73a0", "renesas,bsc", "simple-bus"; + #address-cells = <1>; + #size-cells = <1>; + ranges = <0 0 0x20000000>; + reg = <0xfec10000 0x400>; + interrupts = <0 39 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&zb_clk>; + power-domains = <&pd_a4s>; + };