From patchwork Mon Oct 26 06:44:12 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dongsheng Wang X-Patchwork-Id: 535720 X-Patchwork-Delegate: scottwood@freescale.com Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 6E17B1412FD for ; Mon, 26 Oct 2015 17:51:53 +1100 (AEDT) Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 4C99B1A0C7F for ; Mon, 26 Oct 2015 17:51:53 +1100 (AEDT) X-Original-To: linuxppc-dev@lists.ozlabs.org Delivered-To: linuxppc-dev@lists.ozlabs.org Received: from na01-bn1-obe.outbound.protection.outlook.com (mail-bn1on0116.outbound.protection.outlook.com [157.56.110.116]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id A0A601A046D for ; Mon, 26 Oct 2015 17:50:58 +1100 (AEDT) Received: from DM2PR03CA0010.namprd03.prod.outlook.com (10.141.96.20) by BL2PR03MB563.namprd03.prod.outlook.com (10.141.92.141) with Microsoft SMTP Server (TLS) id 15.1.306.13; Mon, 26 Oct 2015 06:50:52 +0000 Received: from BN1AFFO11FD026.protection.gbl (2a01:111:f400:7c10::133) by DM2PR03CA0010.outlook.office365.com (2a01:111:e400:2428::20) with Microsoft SMTP Server (TLS) id 15.1.306.13 via Frontend Transport; Mon, 26 Oct 2015 06:50:51 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=freescale.com; freescale.mail.onmicrosoft.com; dkim=none (message not signed) header.d=none; freescale.mail.onmicrosoft.com; dmarc=none action=none header.from=freescale.com; Received-SPF: Fail (protection.outlook.com: domain of freescale.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BN1AFFO11FD026.mail.protection.outlook.com (10.58.52.86) with Microsoft SMTP Server (TLS) id 15.1.306.13 via Frontend Transport; Mon, 26 Oct 2015 06:50:51 +0000 Received: from titan.ap.freescale.net ([10.192.208.233]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id t9Q6ojjL022848; Sun, 25 Oct 2015 23:50:46 -0700 From: Dongsheng Wang To: Subject: [PATCH v4] Documentation: dt: binding: fsl: add devicetree binding for describing RCPM Date: Mon, 26 Oct 2015 14:44:12 +0800 Message-ID: <1445841852-6830-1-git-send-email-dongsheng.wang@freescale.com> X-Mailer: git-send-email 2.1.0.27.g96db324 X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD026; 1:TyUgPwoQi7NKuODYdH4Fmb+CpRyeC6Jyq6CZOHQZzotl/NGvDX8DcO+I8R7LpBiVNuYETPteMWVf9YaME9S6tbOk/wz82ylFUStq6oXYaCo9VbCRgNUKGvPPyvb9k2Dma7/K+vL1Lme4q+H4PBM0XYxnwN80vbW4mEt+wbiL5QLAJoOsF3Fe/zh1bbt0f3NBhWql1Me9LPjhauOkIFOwZOBwKaPoc076p8DV7DY4v/V6BgodFR0XXlDWCUUOMby3WDTX/6c8QGasycXLTyScXdR2iCQqEEJh39DCRZNZ8aC44CcwJxsMwTQ2d7xIimsFpGgsRFfBFeuIyp/HrNwfp0R7oY51tcqX3pBeK6PgtX1Un6bM/Lc5P+IcjvPUSn+fSTrtOlUZM/K5JXhethQg3g== X-Forefront-Antispam-Report: CIP:192.88.168.50; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10019020)(6009001)(2980300002)(1110001)(1109001)(339900001)(199003)(189002)(5001960100002)(5003940100001)(48376002)(50466002)(47776003)(50226001)(104016004)(5008740100001)(11100500001)(5007970100001)(6806005)(107886002)(229853001)(4001450100002)(2351001)(189998001)(77096005)(92566002)(110136002)(97736004)(87936001)(19580405001)(19580395003)(4001430100002)(106466001)(85426001)(575784001)(86362001)(36756003)(50986999)(2371004)(105606002)(33646002)(81156007); DIR:OUT; SFP:1102; SCL:1; SRVR:BL2PR03MB563; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; BL2PR03MB563; 2:cQ9Cd2anGQUOJwStjZZWUWLeaPRbPEWBar9e744X5GKMdE8VijC9ucGKsW7vIS2LEtwUbdKtY70sUetb03NjaeGek8q0stfnxhBaOvQGqPLkxvX/tUKM+Xb6HuYQx0SNEgOIlv8QADoMzdAQ7ibRYcDFkgfUnC5K2Tvd0Kn7ug4=; 3:Kj5qw1KzogoVLObklgJBpt+qtLRYnUrEJPlcaA+ob+u6ksrlBufwudMVAS/TQ/cehbIgSV9QSgmw69WirWHT2rwdoekjei0yqsJSH0Mnq0vmSqxzhWcqP/N+a4pZ0iETOQqMdCU9y5ZypyPm7ssIhzSp1ayVHVVDkG2kp2a14ERDPthA1IbYZZONiuSKVRnS6VYT2/WKFdD1K8/GXWAh0z9TJrnvX5HpKrPprQfTdu0=; 25:/vcebcYbxkyUyLKD3rlLr2oDZLM7DDHBpVlkNY8KGfbOHt1nnCIVioxHA3ugqRp++NR43DOso+vEFkZuTW54UxKbBujsFBvJouysnQj3nERLulbSSFxbzn6NDqxopzrItJjX5QcXBrjLJITarT7P4q5ccDoQnue1yAusJp0UWI7qvIkPY8oxb4mN+n//AhW4eriiL7WJq1Cv1APc22O1cbse1NOJJ2TqRTi6xq7HWmhOdWydKyWlGF17mSWbKwWaT0w6kM0X893AW6EKaZUFaQ== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BL2PR03MB563; X-Microsoft-Exchange-Diagnostics: 1; BL2PR03MB563; 20:evf+Qsk6GT4DZ/FygEdKkTv4iimvq6cxQjH5PR71TBeAg4Y0bodgD8BsC3DoBZUMDAPl5I9lYd9YSJRbOtwR+TDCmKsqG7lfwHR7oSUjOvWPaONcs28bZ8M6uzKAoKRty5AA68uRTh/Y3ZyW8xKfgfhRvaKewuKHb/+0AJ7nKOQT5Bcx678iX/5Hcl/DxRLj5paneXHS5HkInfZ2f8vDHMeSNwU7TY1Mc+06YJ5Og1ARaBf5NBqUu3AufMamDBGQCpX2bNAbKlnVxivPC80ut92WeQXF2VoE/aZ1h3w+IoDHr9MprN8cbaBGMYbOb2QeEhBFpwQ7Od4f6uZX7NdjJYAetEei2Hxm/gYbnzDSDNk=; 4:kUlw4xEQ3Jki+Gy4eh0PeZHLxiyFkFW2M26yZzrKqYlg6LY84Lk7E+OmNhh25XF192Rxie+oq3ZPq7CHkGpydqy5RL8CmNAD3BB7Am22h768e0M5j7DkSLuXpIJmbBQfv3hSJLvQAjXzo4dKMnWG7/qjQ87tVjeNip1GWrY7bY4Zq5x6MkmGjOXwd62+7B0IcqX9XoS0RuzxjP734FvKGslVYYRhzhoaxfa+4j9WdvCLCJ/NEXUZpgnJ9FRWKScZQ/JjbnpqwRXk0IcN8UCahZ9l+CyuMFO6TrbjQNpPYLawf34Y/KXgS5IoT8VlH96XwIKGR2tZPTg4XM+AqG16Zw97JhMzhauvFwStpU4g74ISKDbYHANM4Lcw/0IBU4nI X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(101931422205132); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(5005006)(520078)(8121501046)(3002001)(102215026); SRVR:BL2PR03MB563; BCL:0; PCL:0; RULEID:; SRVR:BL2PR03MB563; X-Forefront-PRVS: 0741C77572 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BL2PR03MB563; 23:W6Qu/ki13/NYKD31IIM9ERSVnzv3p2wZVzX+52sPhF?= =?us-ascii?Q?cm80JWppPSZbmLCQ/TRuvX+tSUFDCznbiuDcz+9xUsGF9J9uhaJRFeWH2UQ9?= =?us-ascii?Q?8LELjOohTZGMYF/DCGp0SpkFkXYviEMu+KTI9FaOCEestqm80mMYrT2k7LUG?= =?us-ascii?Q?BMXlOQw4SNAtn80e7azBBVvwCgtwK0qcOfFBfTLQaUr4i6ZR53io3Oi+ymnu?= =?us-ascii?Q?lZZ62clSnLE51tJEkrMzmWa2YxiGzTyaXn6qfNF6Wg/gX430RixlJQWv8ySc?= =?us-ascii?Q?e1IyRTg2g0dLcZJ/345qRwDLFcZt2R0jeHKn0Efex5iZp4wm1aIuFFsLH1RJ?= =?us-ascii?Q?RQg7ms3r7QYGdAh4sdrKnWwHnZRcdHfHmdJGxBwSM9tx5P/UEGw1hcPPkggh?= =?us-ascii?Q?Qc12M+8ohLjOghBP4MZrt+cijPROKT3LWCXToC6VvGocCmeQkm0bwehn0V0Q?= =?us-ascii?Q?qK4aaW1KTvxRrqyc/uLreMIsNmH0kjZswT+2orQmphuzd5VL94F4mt94MIbO?= =?us-ascii?Q?x6r8o37jQCsIfh2odKtT0izoCG8Hoslm4h/imtJ/jdK3te1ltTVg9ixQXfSl?= =?us-ascii?Q?F1jTINukJR2cJJ7lcJNXWL4qmWcIJ5TrGrjVUF7yBabw0qJOtwc3ffIMASqx?= =?us-ascii?Q?1yvA3CQQfoFL6Ncr47HYiPzRoz2Wo/DekL6eWfLNu6IzTdgtLRR4xaRqNAV4?= =?us-ascii?Q?VzBOSBpglrH4OC6W+zZQRsaspycqADyAP23AOkJ+AEfmztrUB2nQNDViS6AM?= =?us-ascii?Q?1YzLjFyI0g6tLlohul60CUIrBqbpu9t4MgTjjewaR9GE4HnUNQzs537Kl9PX?= =?us-ascii?Q?3sucOZUhQGOrUlJ/vGFGJvjVk2VQUa50ed9qBn9akEohLX6VI1wnaJTr0v/h?= =?us-ascii?Q?tjBQX+yUhwJu6UrEhnG5omMTfJN2JrNmGtQjV/KTeTDoxYkFmSqUKk9j/218?= =?us-ascii?Q?i5lgEbss9ntEWZSL5SaAkB3wm0jDUxpm2laPfKXXvbuCBiATnXESravObF3T?= =?us-ascii?Q?3/ot/ZcbRylIM62FgjiyNBvpznkmVcNojYoSyDmjXsQqovbxmN8xgg2Bpjmg?= =?us-ascii?Q?7nLWUEU+ZE6hhq6Aq42z5Od3y32++gVVBrx7UxyfuFRDIimVr4NrqPu8T7WK?= =?us-ascii?Q?JhOx9Yvuc=3D?= X-Microsoft-Exchange-Diagnostics: 1; BL2PR03MB563; 5:0Lqzfn+oelvlpwuU6bAnuyRYL5iH8UIJbVu8RfoD6qIkEayuVA7HoSPLWH2qzT1xL5UeEdc4cmwV69NAvPE25bpa0sK2DYO1+RJ5IslfXcDu/OUccaiFDpIG34Hx/6DIqSWNwnUZKq5PD5uxV0pwJw==; 24:3WuIDa4vqnWj82EMD9KUY82omaER6Fc0dCSCjw8OK2GbwKJ89Cpd1b/JzLNR7Yafja3yQx6L+VduvHpPJ8iP1xIIMgkiZS0mTz8lmZ5O/Zw=; 20:rtMU5WPU77JsL1opNFj0jzknwZKwBlynBXsPWdXRmV88nv+87geSFdyDHorVVl/Xjb0Uxz4VGggliESoeRswow== X-OriginatorOrg: freescale.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Oct 2015 06:50:51.2598 (UTC) X-MS-Exchange-CrossTenant-Id: 710a03f5-10f6-4d38-9ff4-a80b81da590d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=710a03f5-10f6-4d38-9ff4-a80b81da590d; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL2PR03MB563 X-BeenThere: linuxppc-dev@lists.ozlabs.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, Chenhui Zhao , shawnguo@kernel.org, stuart.yoder@freescale.com, Wang Dongsheng , Tang Yuantian , robh+dt@kernel.org, jason.jin@freescale.com, linuxppc-dev@lists.ozlabs.org Errors-To: linuxppc-dev-bounces+patchwork-incoming=ozlabs.org@lists.ozlabs.org Sender: "Linuxppc-dev" From: Wang Dongsheng RCPM is the Run Control and Power Management module performs all device-level tasks associated with device run control and power management. Add this for freescale powerpc platform and layerscape platform. Signed-off-by: Chenhui Zhao Signed-off-by: Tang Yuantian Signed-off-by: Wang Dongsheng --- *v4* - Change patch subject. - A few grammatical mistakes. - Change "rcpm-wakeup" property to "fsl,rcpm-wakeup" property. - Remove a few "fsl,-rcpm" examples. - Now the value of "fsl,#rcpm-wakeup-cells" is not contain rcpm node. - Add a NOTE to describe IPPDEXPCR register. *v3* - Add "fsl,#rcpm-wakeup-cells" for rcpm node. The number of cells correspond rcpm-wakeup property. - Modify rcpm-wakeup property description. *v2* - Remove P4080 example. - Modify rcpm-wakeup property description. diff --git a/Documentation/devicetree/bindings/soc/fsl/rcpm.txt b/Documentation/devicetree/bindings/soc/fsl/rcpm.txt new file mode 100644 index 0000000..757e0eb --- /dev/null +++ b/Documentation/devicetree/bindings/soc/fsl/rcpm.txt @@ -0,0 +1,64 @@ +* Run Control and Power Management +------------------------------------------- +The RCPM performs all device-level tasks associated with device run control +and power management. + +Required properites: + - reg : Offset and length of the register set of the RCPM block. + - fsl,#rcpm-wakeup-cells : The number of IPPDEXPCR register cells in the + fsl,rcpm-wakeup property. + - compatible : Must contain a chip-specific RCPM block compatible string + and (if applicable) may contain a chassis-version RCPM compatible + string. Chip-specific strings are of the form "fsl,-rcpm", + such as: + * "fsl,p2041-rcpm" + * "fsl,p5020-rcpm" + * "fsl,t4240-rcpm" + + Chassis-version strings are of the form "fsl,qoriq-rcpm-", + such as: + * "fsl,qoriq-rcpm-1.0": for chassis 1.0 rcpm + * "fsl,qoriq-rcpm-2.0": for chassis 2.0 rcpm + * "fsl,qoriq-rcpm-2.1": for chassis 2.1 rcpm + +All references to "1.0" and "2.0" refer to the QorIQ chassis version to +which the chip complies. +Chassis Version Example Chips +--------------- ------------------------------- +1.0 p4080, p5020, p5040, p2041, p3041 +2.0 t4240, b4860, b4420 +2.1 t1040, ls1021 + +Example: +The RCPM node for T4240: + rcpm: global-utilities@e2000 { + compatible = "fsl,t4240-rcpm", "fsl,qoriq-rcpm-2.0"; + reg = <0xe2000 0x1000>; + fsl,#rcpm-wakeup-cells = <2>; + }; + +* Freescale RCPM Wakeup Source Device Tree Bindings +------------------------------------------- +Required fsl,rcpm-wakeup property should be added to a device node if the device +can be used as a wakeup source. + + - fsl,rcpm-wakeup: Consists of a pointer to the rcpm node and the IPPDEXPCR + register cells. The number of IPPDEXPCR register cells is defined in + "fsl,#rcpm-wakeup-cells" in the rcpm node. The first register cell is + the bit mask that should be set in IPPDEXPCR0, and the second register + cell is for IPPDEXPCR1, and so on. + + Note: IPPDEXPCR(IP Powerdown Exception Control Register) provides a + mechanism for keeping certain blocks awake during STANDBY and MEM, in + order to use them as wake-up sources. + +Example: + lpuart0: serial@2950000 { + compatible = "fsl,ls1021a-lpuart"; + reg = <0x0 0x2950000 0x0 0x1000>; + interrupts = ; + clocks = <&sysclk>; + clock-names = "ipg"; + fsl,rcpm-wakeup = <&rcpm 0x0 0x40000000>; + status = "disabled"; + };