From patchwork Mon May 14 12:03:04 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Wen He X-Patchwork-Id: 912899 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=freescale.onmicrosoft.com header.i=@freescale.onmicrosoft.com header.b="ObAhNoqD"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 40kzrs5rFmz9s08 for ; Mon, 14 May 2018 22:04:29 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753058AbeENME1 (ORCPT ); Mon, 14 May 2018 08:04:27 -0400 Received: from mail-dm3nam03on0121.outbound.protection.outlook.com ([104.47.41.121]:5381 "EHLO NAM03-DM3-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752936AbeENMEY (ORCPT ); Mon, 14 May 2018 08:04:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freescale.onmicrosoft.com; s=selector1-freescale-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=6z412bqNuQZ+DWJMKYNPTOOiYj+JZc9jr6kZtd4pDnM=; b=ObAhNoqDoWpWEirChbhpfMtyNLOkK/E+elYN3zkDQp/SvTpf93bOSAF39ts7n6KGkUb3lEd8yjeyR8NkBxjumQRfUsrtMicRLtybyjWVvgWNFeV8pChgsTrZZJx+0qmrMIS70YfxCiYAdPDZRKwuffsi2MDOGQKw6wnXDPbUCRY= Received: from BN3PR03CA0114.namprd03.prod.outlook.com (2603:10b6:400:4::32) by CY1PR03MB2186.namprd03.prod.outlook.com (2a01:111:e400:c613::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.755.16; Mon, 14 May 2018 12:04:20 +0000 Received: from BN1BFFO11FD018.protection.gbl (2a01:111:f400:7c10::1:180) by BN3PR03CA0114.outlook.office365.com (2603:10b6:400:4::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.755.16 via Frontend Transport; Mon, 14 May 2018 12:04:20 +0000 Authentication-Results: spf=fail (sender IP is 64.157.242.222) smtp.mailfrom=nxp.com; intel.com; dkim=none (message not signed) header.d=none; intel.com; dmarc=fail action=none header.from=nxp.com; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 64.157.242.222 as permitted sender) receiver=protection.outlook.com; client-ip=64.157.242.222; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (64.157.242.222) by BN1BFFO11FD018.mail.protection.outlook.com (10.58.144.81) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.735.16 via Frontend Transport; Mon, 14 May 2018 12:04:18 +0000 Received: from az84smr01.freescale.net (az84smr01.freescale.net [10.64.34.197]) by tx30smr01.am.freescale.net (8.14.3/8.14.3) with ESMTP id w4EC4Iio029948; Mon, 14 May 2018 05:04:18 -0700 Received: from titan.ap.freescale.net ([10.192.208.233]) by az84smr01.freescale.net (8.14.3/8.14.0) with ESMTP id w4EC4AP6021601; Mon, 14 May 2018 05:04:16 -0700 From: Wen He To: , CC: , , , , , Wen He Subject: [v4 3/6] dt-bindings: fsl-qdma: Add NXP Layerscpae qDMA controller bindings Date: Mon, 14 May 2018 20:03:04 +0800 Message-ID: <20180514120307.15592-3-wen.he_1@nxp.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180514120307.15592-1-wen.he_1@nxp.com> References: <20180514120307.15592-1-wen.he_1@nxp.com> X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:64.157.242.222; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10019020)(376002)(39860400002)(39380400002)(396003)(346002)(2980300002)(1110001)(1109001)(3190300001)(339900001)(189003)(199004)(305945005)(97736004)(47776003)(2906002)(4326008)(1076002)(106466001)(498600001)(36756003)(105606002)(356003)(16586007)(110136005)(54906003)(50226002)(316002)(50466002)(476003)(126002)(11346002)(53936002)(8676002)(6666003)(48376002)(5660300001)(8936002)(76176011)(26005)(2616005)(86362001)(446003)(8656006)(486006)(77096007)(85426001)(336012)(51416003)(81166006)(81156014); DIR:OUT; SFP:1102; SCL:1; SRVR:CY1PR03MB2186; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; LANG:en; PTR:ErrorRetry; MX:1; A:1; X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11FD018; 1:k+OLyc54oXJLD2FQ1ol6/AlXOE6R7mZ8MnMF1zjO0XgEgQgD548xQAWNykQuxpthCWWUMYDCVxp4IKraPI5ChvTmllkqd3GLwBSP2F7pMlZH1261WqCIYdcZGJdeUF/Q MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(4534165)(4627221)(201703031133081)(5600026)(2017052603328); SRVR:CY1PR03MB2186; X-Microsoft-Exchange-Diagnostics: 1; CY1PR03MB2186; 3:ZyEFNBj8AabAwkgrflnnU9zGF8zEL944xLdK/yy/xM2ustEUDNJ0T9CkDcGQ9qw6Bryw8aohl3LgiyhCt4OFv1MLhnDTAiR5spUg7ItcbyiE4zYxURgXGlESQUx5vJ8twHdGKL52Nr2eu6r1VuzwlzB7khEmnZBhwWR5OkIXL9eb+5GPJVg7Il4SssVuFIDtC83x7EnfCRS3689mVs7wuY0jbAr4GjkGdov1sUpoNUbfjyf1J4npIbHS23UVTVaaaKkaoiJWE7gcZIflticIUu68R6wWDRXGr3kkTTISiRzKD9u7ENGOQdLf6EcEtBQz671Uop+065QMxd7hKoN/AQeMJfBjsTHKX6LsmsVp+zU=; 25:f7UgpxheUXRzeWa4Dec5amUvZj47znJPQWuJNd9NcbcypCGkf8mkGFc3JtJyjF0ujjGUq4K0SIwQAy8OFINaq5QO+LUjXwTBkByu+KvMjkxLUKcyxvzod3EXT5tnH57f9rXYR+T2pHANBpRzjIwVO2bClpQUjHPgvEYINpuatOQSDOJIb1T3UBCjqpiMVho8FKbcFMm9RIOL7/d/hGOsQ9wjDbHzMmQdderjejIQ5U8CDC+MfKv8sz0gRCqnTDP1WrgLHZCSegkw0Iin5ge/ShAh2A9QxJZmy1UDvc3LW4YAmStvDzK9XL4rcxEQXGGfCMtnPwptjzKmSkmUYdpqow== X-MS-TrafficTypeDiagnostic: CY1PR03MB2186: X-LD-Processed: 710a03f5-10f6-4d38-9ff4-a80b81da590d,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; CY1PR03MB2186; 31:3VRsBm8fWG4J6CWrF0mCY1EcA+vf8gmN1jfU2VJxW4BAZLlLw0GEV5aqhZwTGGDiM51IcEUW0DlOzoAEeyFg8J9lXap1rzbFUkG0LtSHdFsrye1RCP7OPp66igCol+Yv96qYri3zoaJhKRhaglybBDz9KDh9OQqp5egd6WwjBYW5lXu7KKo9lr6rMgSV4jt6Vn0Zo0VYbePen73Rgvb5zFpFT8yqojUZFXriiQp7v9w=; 20:A8ksF2blDDw9bZqPJDKR9s7VwqXyJMN3JB2p6lziW+IdYOeY8cMbTZYE/RldCFC3SNzqEdTa100iqlMIjPLghD0QHEd/Dirz69j+ZYEeiUiANZld+vP/DbXn8LmCiIHk8ftvAJ+tkYJtlYd/BRSOZBXW+ffGoDO9hHEWRkH7uM5U5Fobomh7GM4DuyzqvNlfmb8LCen7GZg3ny1/S+N4qt5HX3wH1YsOk7sP2xwzNC4heYwx54wMiNsVcbLZ0wW1aXGF6VVdHCVsR6jr3vhoUJBMqNpjXrXj8Sbuj0GhiHqWTh5E/6cIZ0tjESbDzljOnHaNCVK+5hsP3EVYQLSbU7B/9+eQtVgu9VfpEZwFCxD/GXdrvM+LQo8FoYRXIkE27nFtEcQxInNENo4W7JSvdBHa+jmHAVaGTt3oYV5uQkD54xl1V9EWlKPTrT5xYE61YFNJoKe6ap9FIju6uNZpKDIVxI3yqpUjwmREMSb28W0ujvPobNhWoGR3DKdFnPHYNx/90wAIuU78CRHHILv1af7w1YbbRYNOZPuxoumgnMfe+0ZofP7ooIk/+AIVFSpOZag8Q4MLDmcwaFbMMGfD5UWQ2gV0Ie0X0Q35zFEW9G4= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197)(788757137089); X-MS-Exchange-SenderADCheck: 0 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040522)(2401047)(5005006)(8121501046)(3231254)(944501410)(52105095)(93006095)(93003095)(3002001)(10201501046)(6055026)(149027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061750153)(20161123558120)(20161123560045)(20161123562045)(20161123564045)(6072148)(201708071742011); SRVR:CY1PR03MB2186; BCL:0; PCL:0; RULEID:; SRVR:CY1PR03MB2186; X-Microsoft-Exchange-Diagnostics: 1; CY1PR03MB2186; 4:ZrIth7O028+J5msEwloHQWLqd9YKEB1QAsSZUv5fpb/gfXzBtP8aoM5KRTuIoQ+/DNjPEHY4AdorfqZRqLbOt2Vy4pMm/ut1/mIK99LqmzxPfKTYN28O1H8xSC6LF1TIO/dcf46RcVXJc9PgpFKbR1FmT96qG4R2iXkW9myb4nOHURjiS6G8qf+z6/wMFUIMJ4seQQu16QzMTFux0iUyGJr2KZJPi4q/qT7q7lKFLimvkwnHcJulrvxiaf7rGH1D76A3SaWaKIVxYYCPaTXoZSvzeMDQ+OIkchgKXQtHjpy/ANK2/NKJtB2HVnRa7IQgsaZFmva+cvhqfyUyJ0b1Xw== X-Forefront-PRVS: 067270ECAF X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY1PR03MB2186; 23:usxFtOqO0KB5am6TrTKywcmyR9gRNoBFyh33vTCCQ?= rgk21rFx9WCI3AQMO8LzXrFhjW/rGjChuITOE0PBJQ+ynSe+On7nkCKU1FundTLtkbqhPaEcFKpZT8w0Aib5NfPtCU5ATz1LcXSwqgPp3GTiD0JrJWckVzlVH8tx5aLoRTgXDnA9jSMOwmMv7CZ4EUbRSwfeikstOs+FUW5qZ82ZhGivvJ88/rRBeOPgMK/i5HoH++Ip6KbYoyK8POJGJenxv/K5QvcGztCThH4bOVatMq5YmCiXPBQUzs3DC55lAspm0qO11VBFPerviu04UY7nLOga5A/urGFgkpzBMgI/ciR1f3wpivWM56eiUyWvUODk8HO9FSLDCtO2BFctfxK9E1SO7xGObKAWLWQQJxlSCzE1pSnzOzWthUyIgS8ubL9Flkx8tUHUbOzBcqZ/KoHVi9vJ3YA7CgJ8BqyTqa4ZV021ik2G99OsbnPRbUddzeJW8gxke4+rYEvbQddcv8/E31P72jFsyH9ZqCfWd8rRijA63mG+ctcsTRjlU4/zgi9/hCedeVXJha+v0f1Ao0dFPpisWkmwKsYXlfKjmQdHLHasDwvkSfJqfpKxXVHAHQ8FWsYGZFpF1hP10SvNxQUvtj7yvX8+IpWqyNUPtRkQAYBiLrnZFc50LMEj+G665iWXR9fXR6vnarPN2tZ4bzqPVp3ZA/k0XF1Dt4gWphe0i0CjAv4WEV3ff3/+BZTz2qZScB1INpSe6rY/S2TdaHm2yT1lAK1+eg8eI2VQ48IFBLzev2jOYzcBbr2pnMCsMUn4lk/OpTvLsq+xRN5TN7Ympna2dAYH6rjjKZHRF1lpPWZ67O2jPq9uVRuJJimtvLsxXmIoZXB/bOpt3IziAkkYId6tVMBrhfP0cRKbrO6v5Nyoc82pGmg4/xOrqrKuw40pfwL46AfaXZspQYuYmxM9+kMf9jHdWQ5OisClAhTzuWi96mDU2RqyR+RELnrfMgRwTe7t28q4gUuWE09RlD8d/KWB3qbBqOo39oOgEI9qdV8kpxOOB5KLueP+3yqPXpnSHUgSHwK7xszs1oWMSz/NUJELGo5GE7nFIzUvJh+EgL85H49S5IPDeJK0BYWHJah8Lb4OFCzcatJ9vhQpDAxaGT/GQx7zmhYeqUqSIHuEA== X-Microsoft-Antispam-Message-Info: +FogGJIzOj5spt7KG96tfKx40Hwnt188CRahJBlaV32JlTGA5R/2c3Llwi1fzpiWmdMGwP1vMoFPKVQH6NrJ9j8DRrigK7Bc4u3Eag9y4S9iPKUMWe75jBih31iFjC5qPMH6UzlqAGxgCntdXrskPcppJV4KdokKOluB/upfTPl3BUNdA8TE4S8gY4D2kEEJ X-Microsoft-Exchange-Diagnostics: 1; CY1PR03MB2186; 6:0vZM/lPmi9/AVyZVv8rcbrMHKk67qjOBqq9KS9cea7gyTR1ISoU672vtZWizaY6gY7HE2hW0ZOEvmmgBzPVjYHMLIqBxlkd/jHBiQK96+6Aivb11kv5o+50G23SPPkaHKwlYxhRL8Cvqgrufo0RioOhxa7d4yUV/KWU6ZyBhoauUS3GQB4dBrdZjWr13tNzeC3T82hH2/l7Kb46wRwxHe94+cIpDh0JAnstAYBrVQDA7On8qUrwz0HTKR7qCva6CsdVpuJjuj2ssH9U5M1og7kliCmVohR4ykiozkfK69jT9ir5a+i2CiiHRw/a2YXPt0F0sXoQ/Ga8SEQZZvq1SQFvo0WLuwx7jT4Lf4WqpPpQfnMR1vSYy0525UI/UXxmao7a2oq5UhDcfBXZWT+boJPJmesqdO47vtm3sIEsyHSQ/ypvLI0HUO2rvbpejecsqKfhHNOeVGl4T5kNr+2LBqg==; 5:8XJ7RW3ipDqgWXAdu1m+FWa0tRX7cz15JViXxBMr3/Y5idMT3GYGjr/NVC5tMDWm4ZiAB5adqpc5PFxBDpDyqTe6drKCKKdsyVR4K3lSStmS2NPMcOv9cryQmLqGOEQN7/lSlMlAH/YGfBCmmVFfsUTPukTgYBw0w3AnAZ40LCc=; 24:MyQECLeMrdisOhKI7VgYyV5VCXB01fSfzUxL+HteZp1F18LSjWbTwxq2V40OXzkoCeLL0vbXh+3sOu5BY15GAA7eBtpOubyqB/QtPHpy2CM= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY1PR03MB2186; 7:wOG9Xgnlikb2OGu2+mR5GsYFc+PtVUIG5txPkLy5/eXuXflSCKNNxpiWuLBeA3sBdmXzsng7HpXxUYHu7+0UpbFAiTrx547sHfo9ZczLlS5250X+osS7Vrht+857rqcR0YPdALiHMzX4F/uN+r1VgDwabUZLqNCoJUdnj+IP8cFrKs1vXS4vjCwOUZrEbOkSwgOX1rKMiDo9ZsAP6tjJWUn8JXiPEfofSdQimoybv3dS02mkstM3YnWQNSe4L9rZ X-MS-Office365-Filtering-Correlation-Id: b8d52eb6-71c7-4da0-1af6-08d5b992d278 X-OriginatorOrg: freescale.onmicrosoft.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 May 2018 12:04:18.8527 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: b8d52eb6-71c7-4da0-1af6-08d5b992d278 X-MS-Exchange-CrossTenant-Id: 710a03f5-10f6-4d38-9ff4-a80b81da590d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=710a03f5-10f6-4d38-9ff4-a80b81da590d; Ip=[64.157.242.222]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR03MB2186 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Document the devicetree bindings for NXP Layerscape qDMA controller which could be found on NXP QorIQ Layerscape SoCs. Signed-off-by: Wen He --- change in v4: - Rewrite the bindings document that follows generic DMA bindings file change in v3: - no change change in v2: - Remove indentation - Add "Should be" before 'fsl,ls1021a-qdma' - Replace 'channels' by 'dma-channels' - Replace 'qdma@8390000' by 'dma-controller@8390000' Documentation/devicetree/bindings/dma/fsl-qdma.txt | 41 ++++++++++++++++++++ 1 files changed, 41 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/dma/fsl-qdma.txt diff --git a/Documentation/devicetree/bindings/dma/fsl-qdma.txt b/Documentation/devicetree/bindings/dma/fsl-qdma.txt new file mode 100644 index 0000000..368c4e7 --- /dev/null +++ b/Documentation/devicetree/bindings/dma/fsl-qdma.txt @@ -0,0 +1,41 @@ +NXP Layerscape SoC qDMA Controller +================================== + +This device follows the generic DMA bindings defined in dma/dma.txt. + +Required properties: + +- compatible: Must be one of + "fsl,ls1021a-qdma": for LS1021A Board + "fsl,ls1043a-qdma": for ls1043A Board + "fsl,ls1046a-qdma": for ls1046A Board +- reg: Should contain the register's base address and length. +- interrupts: Should contain a reference to the interrupt used by this + device. +- interrupt-names: Should contain interrupt names: + "qdma-error": the error interrupt + "qdma-queue": the queue interrupt +- queues: Should contain number of queues supported. + +Optional properties: + +- dma-channels: Number of DMA channels supported by the controller. +- big-endian: If present registers and hardware scatter/gather descriptors + of the qDMA are implemented in big endian mode, otherwise in little + mode. + +Examples: + + qdma: dma-controller@8390000 { + compatible = "fsl,ls1021a-qdma"; + reg = <0x0 0x8398000 0x0 0x2000 /* Controller registers */ + 0x0 0x839a000 0x0 0x2000>; /* Block registers */ + interrupts = , + ; + interrupt-names = "qdma-error", "qdma-queue"; + dma-channels = <8>; + queues = <2>; + big-endian; + }; + +DMA clients must use the format described in dma/dma.txt file.