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;
};