From patchwork Tue Dec 16 23:26:53 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chanwoo Choi X-Patchwork-Id: 5504531 Return-Path: X-Original-To: patchwork-linux-arm@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 BF6109F326 for ; Tue, 16 Dec 2014 23:30:13 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id E0FA520A1B for ; Tue, 16 Dec 2014 23:30:12 +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 F1BF020A16 for ; Tue, 16 Dec 2014 23:30:11 +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 1Y11XK-0003YP-D8; Tue, 16 Dec 2014 23:28:14 +0000 Received: from mailout3.samsung.com ([203.254.224.33]) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Y11WY-0003CB-E0 for linux-arm-kernel@lists.infradead.org; Tue, 16 Dec 2014 23:27:28 +0000 Received: from epcpsbgr2.samsung.com (u142.gpu120.samsung.co.kr [203.254.230.142]) by mailout3.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTP id <0NGP00JN57T15L50@mailout3.samsung.com> for linux-arm-kernel@lists.infradead.org; Wed, 17 Dec 2014 08:27:01 +0900 (KST) Received: from epcpsbgm2.samsung.com ( [172.20.52.112]) by epcpsbgr2.samsung.com (EPCPMTA) with SMTP id 54.36.11124.5CFB0945; Wed, 17 Dec 2014 08:27:01 +0900 (KST) X-AuditID: cbfee68e-f79b46d000002b74-b5-5490bfc5d1ab Received: from epmmp1.local.host ( [203.254.227.16]) by epcpsbgm2.samsung.com (EPCPMTA) with SMTP id 0E.89.09430.5CFB0945; Wed, 17 Dec 2014 08:27:01 +0900 (KST) Received: from chan.10.32.193.11 ([10.252.81.195]) by mmp1.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTPA id <0NGP000357T0KH30@mmp1.samsung.com>; Wed, 17 Dec 2014 08:27:01 +0900 (KST) From: Chanwoo Choi To: myungjoo.ham@samsung.com Subject: [PATCHv4 4/8] devfreq: event: Add documentation for exynos-ppmu devfreq-event driver Date: Wed, 17 Dec 2014 08:26:53 +0900 Message-id: <1418772417-5164-5-git-send-email-cw00.choi@samsung.com> X-Mailer: git-send-email 1.8.5.5 In-reply-to: <1418772417-5164-1-git-send-email-cw00.choi@samsung.com> References: <1418772417-5164-1-git-send-email-cw00.choi@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpjkeLIzCtJLcpLzFFi42JZI2JSoHt0/4QQg2Nf5S0er1nMZHH9y3NW i/lHzrFaTLo/gcXi9QtDi94FV9kszja9YbfY9Pgaq8XlXXPYLD73HmG0mHF+H5PF0usXmSxu N65gs3i84i27xapdfxgd+D3WzFvD6LFz1l12j8V7XjJ5bF5S79G3ZRWjx+dNcgFsUVw2Kak5 mWWpRfp2CVwZayc9Zyr4KVOx9uds9gbGHvEuRk4OCQETiYvvbzFB2GISF+6tZ+ti5OIQEljK KDH53W0mmKKVt5sYIRKLGCW2PpnNApIQEmhikrh9XRnEZhPQktj/4gYbiC0iICNxdeN2FpAG ZoFGZokvy/6DTRIWiJfYsv8kWDOLgKpE14afQHEODl4BF4nFj8whlilILFs+kxXE5hRwlWi5 sZoJYpeLROfVnawgMyUE7rFLrH5wgg1ijoDEt8mHWEDmSAjISmw6wAwxR1Li4IobLBMYhRcw MqxiFE0tSC4oTkovMtIrTswtLs1L10vOz93ECIye0/+e9e1gvHnA+hCjAAejEg9vYGF/iBBr YllxZe4hRlOgDROZpUST84ExmlcSb2hsZmRhamJqbGRuaaYkzpsg9TNYSCA9sSQ1OzW1ILUo vqg0J7X4ECMTB6dUA+O0E16y5au+aUxcdcT87L+AE3EVK5iXxm2PFp7W4u29vk5o6QndYzlm gaZ339nVr4zNOBtwatnPpDiBibZPU9x27JzYMrVFNf2rutDvHBmDr93ddvoScU2B26NS40w2 Lm/Y/Paah5T4upjn9zg9IqebPHfRW/Qq5c05i/cTexUMTMoPPZD7JqLEUpyRaKjFXFScCAC/ ShDEmQIAAA== X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFrrAIsWRmVeSWpSXmKPExsVy+t9jAd2j+yeEGMx5KmbxeM1iJovrX56z Wsw/co7VYtL9CSwWr18YWvQuuMpmcbbpDbvFpsfXWC0u75rDZvG59wijxYzz+5gsll6/yGRx u3EFm8XjFW/ZLVbt+sPowO+xZt4aRo+ds+6yeyze85LJY/OSeo++LasYPT5vkgtgi2pgtMlI TUxJLVJIzUvOT8nMS7dV8g6Od443NTMw1DW0tDBXUshLzE21VXLxCdB1y8wBOllJoSwxpxQo FJBYXKykb4dpQmiIm64FTGOErm9IEFyPkQEaSFjDmLF20nOmgp8yFWt/zmZvYOwR72Lk5JAQ MJFYebuJEcIWk7hwbz1bFyMXh5DAIkaJrU9ms4AkhASamCRuX1cGsdkEtCT2v7jBBmKLCMhI XN24nQWkgVmgkVniy7L/TCAJYYF4iS37T4I1swioSnRt+AkU5+DgFXCRWPzIHGKZgsSy5TNZ QWxOAVeJlhurmSB2uUh0Xt3JOoGRdwEjwypG0dSC5ILipPRcI73ixNzi0rx0veT83E2M4Nh8 Jr2DcVWDxSFGAQ5GJR7ewML+ECHWxLLiytxDjBIczEoivBaLJoQI8aYkVlalFuXHF5XmpBYf YjQFOmois5Rocj4wbeSVxBsam5gZWRqZG1oYGZsrifMq2beFCAmkJ5akZqemFqQWwfQxcXBK NTByXDjIfX5pafj0lZ6GrgWfLV5ZX764/EGk486tT1eJv50lf+zmB48AJ6WQOR+7nXo6i/9w TjgZ75f1fWXJqkOm17mj/lYYlccybOj0TrjRYqbf23qxyXzGDYVWE8FJlx5XhLV+zli9oN31 I8O3V/UXLbfV/I2+6PXRN7T57fmH09bKNkc/U96vxFKckWioxVxUnAgATG53T+MCAAA= DLP-Filter: Pass X-MTR: 20000000000000000@CPGS X-CFilter-Loop: Reflected X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20141216_152726_670170_3A0E965A X-CRM114-Status: GOOD ( 10.92 ) X-Spam-Score: -5.0 (-----) Cc: mark.rutland@arm.com, devicetree@vger.kernel.org, k.kozlowski@samsung.com, kgene.kim@samsung.com, linux-pm@vger.kernel.org, rafael.j.wysocki@intel.com, tomasz.figa@gmail.com, linux-kernel@vger.kernel.org, inki.dae@samsung.com, cw00.choi@samsung.com, kyungmin.park@samsung.com, linux-samsung-soc@vger.kernel.org, a.kesavan@samsung.com, linux-arm-kernel@lists.infradead.org X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, T_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 This patch adds the documentation for Exynos PPMU (Platform Performance Monitoring Unit) devfreq-event driver. Cc: MyungJoo Ham Cc: Kyungmin Park Signed-off-by: Chanwoo Choi --- .../bindings/devfreq/event/exynos-ppmu.txt | 110 +++++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 Documentation/devicetree/bindings/devfreq/event/exynos-ppmu.txt diff --git a/Documentation/devicetree/bindings/devfreq/event/exynos-ppmu.txt b/Documentation/devicetree/bindings/devfreq/event/exynos-ppmu.txt new file mode 100644 index 0000000..e665d30 --- /dev/null +++ b/Documentation/devicetree/bindings/devfreq/event/exynos-ppmu.txt @@ -0,0 +1,110 @@ + +* Samsung Exynos PPMU (Performance Profiling Monitoring Unit) device + +The Samsung Exynos SoC have PPMU (Performance Profiling Monitoring Unit) for +each IPs. PPMU provides the primitive values to get performance data. These +events provide useful information about the behavior of the SoC that you can +use when analyzing system performance, and made visible and can be counted +using login in each IP (DMC, CPU, RIGHTBUS, LEFTBUS, CAM interface, LCD, G3D, +MFC). The Exynos PPMU driver use the devfreq-event class to provide event data +to various devfreq device. The devfreq device would use the event data when +derterming the current state of each IP. + +Required properties: +- compatible: Should be "samsung,exynos-ppmu". +- reg: physical base address of each PPMU and length of memory mapped region. + +Optional properties: +- clock-names : the name of clock used by the PPMU, "ppmu" +- clocks : phandles for clock specified in "clock-names" property +- #clock-cells: should be 1. + +Example1 : PPMU nodes in exynos3250.dtsi are listed below. + + ppmu_dmc0: ppmu_dmc0@106a0000 { + compatible = "samsung,exynos-ppmu"; + reg = <0x106a0000 0x2000>; + status = "disabled"; + }; + + ppmu_dmc1: ppmu_dmc1@106b0000 { + compatible = "samsung,exynos-ppmu"; + reg = <0x106b0000 0x2000>; + status = "disabled"; + }; + + ppmu_cpu: ppmu_cpu@106c0000 { + compatible = "samsung,exynos-ppmu"; + reg = <0x106c0000 0x2000>; + status = "disabled"; + }; + + ppmu_rightbus: ppmu_rightbus@112a0000 { + compatible = "samsung,exynos-ppmu"; + reg = <0x112a0000 0x2000>; + clocks = <&cmu CLK_PPMURIGHT>; + clock-names = "ppmu"; + status = "disabled"; + }; + + ppmu_leftbus: ppmu_leftbus0@116a0000 { + compatible = "samsung,exynos-ppmu"; + reg = <0x116a0000 0x2000>; + clocks = <&cmu CLK_PPMULEFT>; + clock-names = "ppmu"; + status = "disabled"; + }; + +Example2 : Events of each PPMU node in exynos3250-rinato.dts are listed below. + + &ppmu_dmc0 { + status = "okay"; + + events { + ppmu_dmc0_3: ppmu-event3-dmc0 { + event-name = "ppmu-event3-dmc0"; + }; + + ppmu_dmc0_2: ppmu-event2-dmc0 { + event-name = "ppmu-event2-dmc0"; + }; + + ppmu_dmc0_1: ppmu-event1-dmc0 { + event-name = "ppmu-event1-dmc0"; + }; + + ppmu_dmc0_0: ppmu-event0-dmc0 { + event-name = "ppmu-event0-dmc0"; + }; + }; + }; + + &ppmu_dmc1 { + status = "okay"; + + events { + ppmu_dmc1_3: ppmu-event3-dmc1 { + event-name = "ppmu-event3-dmc1"; + }; + }; + }; + + &ppmu_leftbus { + status = "okay"; + + events { + ppmu_leftbus_3: ppmu-event3-leftbus { + event-name = "ppmu-event3-leftbus"; + }; + }; + }; + + &ppmu_rightbus { + status = "okay"; + + events { + ppmu_rightbus_3: ppmu-event3-rightbus { + event-name = "ppmu-event3-rightbus"; + }; + }; + };