From patchwork Fri Aug 19 23:56:51 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nishanth Menon X-Patchwork-Id: 9291421 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 D4588607FF for ; Fri, 19 Aug 2016 23:58:47 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id BCDB6295AA for ; Fri, 19 Aug 2016 23:58:47 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B155F295AD; Fri, 19 Aug 2016 23:58:47 +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=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=unavailable 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 57338295AA for ; Fri, 19 Aug 2016 23:58:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755886AbcHSX62 (ORCPT ); Fri, 19 Aug 2016 19:58:28 -0400 Received: from arroyo.ext.ti.com ([198.47.19.12]:60085 "EHLO arroyo.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755458AbcHSX5u (ORCPT ); Fri, 19 Aug 2016 19:57:50 -0400 Received: from dflxv15.itg.ti.com ([128.247.5.124]) by arroyo.ext.ti.com (8.13.7/8.13.7) with ESMTP id u7JNv5Uu009974; Fri, 19 Aug 2016 18:57:05 -0500 Received: from DLEE70.ent.ti.com (dlemailx.itg.ti.com [157.170.170.113]) by dflxv15.itg.ti.com (8.14.3/8.13.8) with ESMTP id u7JNv5Ga019460; Fri, 19 Aug 2016 18:57:05 -0500 Received: from dlep32.itg.ti.com (157.170.170.100) by DLEE70.ent.ti.com (157.170.170.113) with Microsoft SMTP Server id 14.3.294.0; Fri, 19 Aug 2016 18:57:04 -0500 Received: from localhost (ileax41-snat.itg.ti.com [10.172.224.153]) by dlep32.itg.ti.com (8.14.3/8.13.8) with ESMTP id u7JNv4wi000626; Fri, 19 Aug 2016 18:57:04 -0500 From: Nishanth Menon To: Kevin Hilman , "Rafael J. Wysocki" , Ulf Hansson CC: Dave Gerlach , Keerthy , Peter Ujfalusi , Tero Kristo , Russell King , Sudeep Holla , Santosh Shilimkar , , , , , Nishanth Menon Subject: [PATCH 1/3] Documentation: dt: Add TI-SCI PM Domains Date: Fri, 19 Aug 2016 18:56:51 -0500 Message-ID: <20160819235653.26355-2-nm@ti.com> X-Mailer: git-send-email 2.9.1.200.gb1ec08f In-Reply-To: <20160819235653.26355-1-nm@ti.com> References: <20160819235653.26355-1-nm@ti.com> MIME-Version: 1.0 Sender: linux-pm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Dave Gerlach Add a generic power domain implementation, TI SCI PM Domains, that will hook into the genpd framework and allow each PD, which will be created one per device, to be managed over the TI-SCI protocol. Signed-off-by: Dave Gerlach Signed-off-by: Nishanth Menon --- .../devicetree/bindings/soc/ti/sci-pm-domain.txt | 58 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 59 insertions(+) create mode 100644 Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt diff --git a/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt b/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt new file mode 100644 index 000000000000..059a5d71d692 --- /dev/null +++ b/Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt @@ -0,0 +1,58 @@ +Texas Instruments TI-SCI Generic Power Domain +--------------------------------------------- + +Some TI SoCs contain a system controller (like the PMMC, etc...) that are +responsible for control the state of the IPs that are present. Communication +between the host processor running an OS and the system controller happens +through a protocol known as TI-SCI[1]. This pm domain implementation plugs into +the generic pm domain framework and makes use of the TI SCI protocol power on +and off each device when needed. + +[1] Documentation/devicetree/bindings/arm/keystone/ti,sci.txt + +PM Domains Nodes +================ +The PM domains node represents the global PM domain managed by the PMMC, +which in this case is one cell implementation as documented by the generic +PM domain bindings in +Documentation/devicetree/bindings/power/power_domain.txt. + +Required Properties: +-------------------- +- compatible: should be "ti,sci-pm-domains" +- #power-domain-cells: Must be 1 so that an offset can be provided in each + device node. +- ti,sci: Phandle to the TI SCI device to use for managing the devices + +Example: +-------------------- +/* From arch/arm/boot/dts/k2g.dtsi */ +k2g_pds: k2g_pds { + compatible = "ti,sci-pm-domains"; + #power-domain-cells = <1>; + ti,sci = <&pmmc>; +}; + +PM Domain Consumers +=================== +Hardware blocks belonging to a PM domain should contain a "power-domains" +property that is a phandle pointing to the corresponding PM domain node +along with an index representing the device id to be passed for the PMMC +for device control. + +See dt-bindings/genpd/k2g.h for the list of valid identifiers for k2g. + +Example: +-------------------- +/* From arch/arm/boot/dts/k2g.dtsi */ +uart0: serial@02530c00 { + compatible = "ns16550a"; + current-speed = <115200>; + reg-shift = <2>; + reg-io-width = <4>; + reg = <0x02530c00 0x100>; + interrupts = ; + clock-frequency = <200000000>; + status = "disabled"; + power-domains = <&k2g_pds K2G_DEV_UART0>; +}; diff --git a/MAINTAINERS b/MAINTAINERS index 0c5e3d16f694..657fb6a10286 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -11573,6 +11573,7 @@ S: Maintained F: Documentation/devicetree/bindings/arm/keystone/ti,sci.txt F: drivers/firmware/ti_sci* F: include/linux/soc/ti/ti_sci_protocol.h +F: Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt THANKO'S RAREMONO AM/FM/SW RADIO RECEIVER USB DRIVER M: Hans Verkuil