From patchwork Tue Sep 23 02:55:15 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "jinkun.hong" X-Patchwork-Id: 4952371 Return-Path: X-Original-To: patchwork-linux-rockchip@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 144479F2BB for ; Tue, 23 Sep 2014 02:56:47 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 2F1BD2014A for ; Tue, 23 Sep 2014 02:56:46 +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 49C24200FF for ; Tue, 23 Sep 2014 02:56:45 +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 1XWGHR-0002ET-5O; Tue, 23 Sep 2014 02:56:41 +0000 Received: from mail-pa0-f66.google.com ([209.85.220.66]) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1XWGHM-00027f-L4; Tue, 23 Sep 2014 02:56:37 +0000 Received: by mail-pa0-f66.google.com with SMTP id eu11so4120504pac.1 for ; Mon, 22 Sep 2014 19:56:18 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=8IhO7GQzwG0AK/hMq7rWaKrrZ8DNn+uX+ms/AKcWEfQ=; b=B9v8LHytKDxhqYGSmMs1J5VuT2Jobw1hengFJV3qoi6ISjjhYpBo3yMb5Nq4WZuZXR B9hqjKWowq9uT98gE+MfjS0PLtaRYULHnlW19skuyV3AkTfh1oBUZp8TVo0oC3rlKWxG Sv83gGbMOxiHRj3uRXOBhhyuf0BVvgMlR4sULzhd5xP8LezNVmbQQ30vIueC2v+V2HKP kWHmA6B5fAUgvYSrtuI26B5+aAclnWKQqkOxvZ94L3le4ctJQt6/Adu75oN3+7apZJ8A dpwG5Q4pzsQQv4XDYEhZP+/OuEZFQMbyCxh/VBoN6QWjyeoRGdWbdWDwsX16IcJXnCtm Ka7w== X-Received: by 10.70.130.74 with SMTP id oc10mr37601638pdb.94.1411440978289; Mon, 22 Sep 2014 19:56:18 -0700 (PDT) Received: from ubuntu.localdomain ([58.22.7.114]) by mx.google.com with ESMTPSA id aj3sm10540249pbc.92.2014.09.22.19.56.10 for (version=TLSv1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 22 Sep 2014 19:56:17 -0700 (PDT) From: "jinkun.hong" To: linux-rockchip@lists.infradead.org, Heiko Stuebner , Russell King , Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , Grant Likely , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, Randy Dunlap , linux-doc@vger.kernel.org Subject: [PATCH 2/3] dt-bindings: add document of Rockchip power domain Date: Mon, 22 Sep 2014 19:55:15 -0700 Message-Id: <1411440916-6830-3-git-send-email-jinkun.hong@rock-chips.com> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1411440916-6830-1-git-send-email-jinkun.hong@rock-chips.com> References: <1411440916-6830-1-git-send-email-jinkun.hong@rock-chips.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20140922_195636_722128_2B598A1A X-CRM114-Status: GOOD ( 11.78 ) X-Spam-Score: -0.7 (/) Cc: "jinkun.hong" , Jack Dai , Caesar Wang X-BeenThere: linux-rockchip@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Upstream kernel work for Rockchip platforms List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: "Linux-rockchip" Errors-To: linux-rockchip-bounces+patchwork-linux-rockchip=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_NONE, 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 From: "jinkun.hong" Signed-off-by: Jack Dai Signed-off-by: Caesar Wang Signed-off-by: jinkun.hong --- .../bindings/arm/rockchip/power_domain.txt | 48 ++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/arm/rockchip/power_domain.txt diff --git a/Documentation/devicetree/bindings/arm/rockchip/power_domain.txt b/Documentation/devicetree/bindings/arm/rockchip/power_domain.txt new file mode 100644 index 0000000..2a80d3f --- /dev/null +++ b/Documentation/devicetree/bindings/arm/rockchip/power_domain.txt @@ -0,0 +1,48 @@ +* Rockchip Power Domains + +Rockchip processors include support for multiple power domains which can be +powered up/down by software based on different application scenes to save power. + +Required properties for power domain controller: +- compatible: should be one of the following. + * rockchip,rk3288-power-controller - for rk3288 type power domain. +- #power-domain-cells: Number of cells in a power-domain specifier. + should be 1. +- rockchip,pmu: phandle referencing a syscon providing the pmu registers +- #address-cells: should be 1. +- #size-cells: should be 0. + +Required properties for power domain sub nodes: +- reg: index of the power domain, should use macros in: + * include/dt-bindings/power-domain/rk3288.h - for rk3288 type power domain. +- clocks: phandles to clocks which need to be enabled while power domain + switches state. + +Example: + + power: power-controller { + compatible = "rockchip,rk3288-power-controller"; + #power-domain-cells = <1>; + rockchip,pmu = <&pmu>; + #address-cells = <1>; + #size-cells = <0>; + + pd_gpu { + reg = ; + clocks = <&cru ACLK_GPU>; + }; + }; + +Node of a device using power domains must have a power-domains property, +containing a phandle to the power device node and an index specifying which +power domain to use. +The index should use macros in: + * include/dt-bindings/power-domain/rk3288.h - for rk3288 type power domain. + +Example of the node using power domain: + + node { + /* ... */ + power-domains = <&power RK3288_PD_GPU>; + /* ... */ + };