From patchwork Mon Aug 18 03:32:35 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Xiubo Li X-Patchwork-Id: 380673 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 E84F114012B for ; Mon, 18 Aug 2014 13:37:27 +1000 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751718AbaHRDh0 (ORCPT ); Sun, 17 Aug 2014 23:37:26 -0400 Received: from [207.46.163.139] ([207.46.163.139]:3484 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-FAIL-FAIL-OK-FAIL) by vger.kernel.org with ESMTP id S1751671AbaHRDhZ (ORCPT ); Sun, 17 Aug 2014 23:37:25 -0400 Received: from BY2PR03CA073.namprd03.prod.outlook.com (10.141.249.46) by BY2PR0301MB0615.namprd03.prod.outlook.com (25.160.125.25) with Microsoft SMTP Server (TLS) id 15.0.1010.18; Mon, 18 Aug 2014 03:37:01 +0000 Received: from BN1AFFO11FD040.protection.gbl (2a01:111:f400:7c10::175) by BY2PR03CA073.outlook.office365.com (2a01:111:e400:2c5d::46) with Microsoft SMTP Server (TLS) id 15.0.1010.18 via Frontend Transport; Mon, 18 Aug 2014 03:37:01 +0000 Received: from tx30smr01.am.freescale.net (192.88.168.50) by BN1AFFO11FD040.mail.protection.outlook.com (10.58.52.251) with Microsoft SMTP Server (TLS) id 15.0.1010.11 via Frontend Transport; Mon, 18 Aug 2014 03:37:01 +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 s7I3aiw1022216; Sun, 17 Aug 2014 20:36:56 -0700 From: Xiubo Li To: , CC: , , , , , Xiubo Li Subject: [PATCHv3 3/3] pwm: documentation: Add 'big-endian' property for FTM PWM. Date: Mon, 18 Aug 2014 11:32:35 +0800 Message-ID: <1408332755-35102-4-git-send-email-Li.Xiubo@freescale.com> X-Mailer: git-send-email 1.8.5 In-Reply-To: <1408332755-35102-1-git-send-email-Li.Xiubo@freescale.com> References: <1408332755-35102-1-git-send-email-Li.Xiubo@freescale.com> X-EOPAttributedMessage: 0 X-Forefront-Antispam-Report: CIP:192.88.168.50; CTRY:US; IPV:CAL; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10019005)(6009001)(199003)(189002)(99396002)(97736001)(77156001)(48376002)(95666004)(50466002)(46102001)(105606002)(79102001)(107046002)(76176999)(50986999)(229853001)(21056001)(50226001)(4396001)(106466001)(80022001)(81342001)(64706001)(76482001)(104166001)(87286001)(77982001)(81542001)(26826002)(92566001)(92726001)(84676001)(86362001)(93916002)(88136002)(85852003)(89996001)(83072002)(102836001)(85306004)(104016003)(87936001)(74662001)(68736004)(31966008)(6806004)(20776003)(47776003)(19580395003)(19580405001)(83322001)(44976005)(62966002)(74502001)(36756003); DIR:OUT; SFP:1102; SCL:1; SRVR:BY2PR0301MB0615; H:tx30smr01.am.freescale.net; FPR:; MLV:ovrnspm; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Antispam: BCL:0;PCL:0;RULEID:;UriScan:; X-Forefront-PRVS: 03077579FF 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; Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=Li.Xiubo@freescale.com; X-OriginatorOrg: freescale.com Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org For the same FTM PWM device, which on different SoCs will in differrent endian mode, using the same linux device driver need one boolean properties to distingush this. For now the FTM PWM is only applied to the ARM SoCs which are all in LE mode. So the DT binding for FTM PWM device endian: SoC | FTM-PWM | 'big-endian' property is needed? --------|----------|--------------------------------- Vybird | LE | No LS1 | BE | Yes LS2 | LE | No Signed-off-by: Xiubo Li --- .../devicetree/bindings/pwm/pwm-fsl-ftm.txt | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt b/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt index 0bda229..67ed8d6 100644 --- a/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt +++ b/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt @@ -1,5 +1,23 @@ Freescale FlexTimer Module (FTM) PWM controller +For the same FTM PWM device, which on different SoCs will in +differrent endian mode, using the same linux device driver need +one boolean properties to distingush this. + +For now the FTM PWM is only applied to the ARM SoCs which are all +in LE mode. + +So the DT binding for FTM PWM device endian: +SoC | FTM-PWM | 'big-endian' property is needed? +--------|----------|--------------------------------- +Vybird | LE | No +LS1 | BE | Yes +LS2 | LE | No + +Please see "Documentation/devicetree/bindings/regmap/regmap.txt" for more +detail about the endianness. + + Required properties: - compatible: Should be "fsl,vf610-ftm-pwm". - reg: Physical base address and length of the controller's registers @@ -16,7 +34,8 @@ Required properties: - pinctrl-names: Must contain a "default" entry. - pinctrl-NNN: One property must exist for each entry in pinctrl-names. See pinctrl/pinctrl-bindings.txt for details of the property values. - +- big-endian: One boolean property, for all the device registers, the BE mode + will be in use if it's present, or the LE mode will be in use. Example: @@ -32,4 +51,5 @@ pwm0: pwm@40038000 { <&clks VF610_CLK_FTM0_EXT_FIX_EN>; pinctrl-names = "default"; pinctrl-0 = <&pinctrl_pwm0_1>; + big-endian; };