From patchwork Tue Oct 28 09:15:51 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Emil Medve X-Patchwork-Id: 404127 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 [103.22.144.68]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 6168014007B for ; Tue, 28 Oct 2014 20:28:20 +1100 (AEDT) Received: from ozlabs.org (ozlabs.org [103.22.144.67]) by lists.ozlabs.org (Postfix) with ESMTP id 1670E1A1DDE for ; Tue, 28 Oct 2014 20:28:20 +1100 (AEDT) X-Original-To: linuxppc-dev@lists.ozlabs.org Delivered-To: linuxppc-dev@lists.ozlabs.org Received: from ozlabs.org (ozlabs.org [103.22.144.67]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id B6DE31A0B38 for ; Tue, 28 Oct 2014 20:24:39 +1100 (AEDT) Received: by ozlabs.org (Postfix) id 9010314007B; Tue, 28 Oct 2014 20:24:39 +1100 (AEDT) Delivered-To: linuxppc-dev@ozlabs.org Received: from na01-bn1-obe.outbound.protection.outlook.com (mail-bn1bbn0109.outbound.protection.outlook.com [157.56.111.109]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 8C4D3140077 for ; Tue, 28 Oct 2014 20:24:38 +1100 (AEDT) Received: from CO2PR03CA0049.namprd03.prod.outlook.com (10.141.194.176) by BY2PR03MB490.namprd03.prod.outlook.com (10.141.142.20) with Microsoft SMTP Server (TLS) id 15.1.6.9; Tue, 28 Oct 2014 09:24:32 +0000 Received: from BY2FFO11FD030.protection.gbl (2a01:111:f400:7c0c::135) by CO2PR03CA0049.outlook.office365.com (2a01:111:e400:1414::48) with Microsoft SMTP Server (TLS) id 15.1.6.9 via Frontend Transport; Tue, 28 Oct 2014 09:24:32 +0000 Received: from az84smr01.freescale.net (192.88.158.2) by BY2FFO11FD030.mail.protection.outlook.com (10.1.14.211) with Microsoft SMTP Server (TLS) id 15.0.1049.20 via Frontend Transport; Tue, 28 Oct 2014 09:24:31 +0000 Received: from lazy.am.freescale.net (lazy.am.freescale.net [10.81.116.101]) by az84smr01.freescale.net (8.14.3/8.14.0) with ESMTP id s9S9OPwK003766; Tue, 28 Oct 2014 02:24:30 -0700 From: Emil Medve To: , , , , , , , , , , , , Subject: [PATCH v2 4/4] dt/bindings: Introduce the FSL QorIQ DPAA QMan portal(s) Date: Tue, 28 Oct 2014 04:15:51 -0500 Message-ID: <1414487751-31568-5-git-send-email-Emilian.Medve@Freescale.com> X-Mailer: git-send-email 2.1.2 In-Reply-To: <1414487751-31568-1-git-send-email-Emilian.Medve@Freescale.com> References: <1414487751-31568-1-git-send-email-Emilian.Medve@Freescale.com> X-EOPAttributedMessage: 0 X-Forefront-Antispam-Report: CIP:192.88.158.2; CTRY:US; IPV:CAL; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10019020)(6009001)(189002)(199003)(21056001)(86362001)(50986999)(104016003)(89996001)(88136002)(76176999)(95666004)(84676001)(69596002)(85852003)(92726001)(2201001)(92566001)(19580395003)(68736004)(99396003)(120916001)(76482002)(85306004)(48376002)(81156004)(46102003)(50466002)(87286001)(105606002)(106466001)(97736003)(26826002)(50226001)(4396001)(102836001)(107046002)(64706001)(47776003)(80022003)(104166001)(229853001)(93916002)(20776003)(19580405001)(31966008)(6806004)(62966002)(44976005)(87936001)(36756003)(77156001)(921003)(1121002)(83996005)(2101003); DIR:OUT; SFP:1102; SCL:1; SRVR:BY2PR03MB490; H:az84smr01.freescale.net; FPR:; MLV:ovrnspm; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Antispam: UriScan:; X-Microsoft-Antispam: BCL:0;PCL:0;RULEID:;SRVR:BY2PR03MB490; X-Forefront-PRVS: 0378F1E47A Received-SPF: Fail (protection.outlook.com: domain of freescale.com does not designate 192.88.158.2 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.158.2; helo=az84smr01.freescale.net; Authentication-Results: spf=fail (sender IP is 192.88.158.2) smtp.mailfrom=Emilian.Medve@freescale.com; X-OriginatorOrg: freescale.com Cc: Emil Medve X-BeenThere: linuxppc-dev@lists.ozlabs.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: linuxppc-dev-bounces+patchwork-incoming=ozlabs.org@lists.ozlabs.org Sender: "Linuxppc-dev" Portals are memory mapped interfaces to QMan that allow low-latency, lock-less interaction by software running on processor cores, accelerators and network interfaces with the QMan Signed-off-by: Emil Medve Change-Id: I29764fa8093b5ce65460abc879446795c50d7185 --- .../bindings/powerpc/fsl/qman-portals.txt | 151 +++++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 Documentation/devicetree/bindings/powerpc/fsl/qman-portals.txt diff --git a/Documentation/devicetree/bindings/powerpc/fsl/qman-portals.txt b/Documentation/devicetree/bindings/powerpc/fsl/qman-portals.txt new file mode 100644 index 0000000..86b06d8 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/fsl/qman-portals.txt @@ -0,0 +1,151 @@ +QorIQ DPAA Queue Manager Portals Device Tree Binding + +Copyright (C) 2008 - 2014 Freescale Semiconductor Inc. + +CONTENTS + + - QMan Portal + - QMan Pool Channel + - Example + +QMan Portal Node + +PROPERTIES + +- compatible + Usage: Required + Value type: + Definition: Must include "fsl,qman-portal-" + May include "fsl,-qman-portal" or "fsl,qman-portal" + +- reg + Usage: Required + Value type: + Definition: Two regions. The first is the cache-enabled region of + the portal. The second is the cache-inhibited region of + the portal + +- interrupts + Usage: Required + Value type: + Definition: Standard property + +- fsl,liodn + Usage: See pamu.txt + Value type: + Definition: PAMU property used for static LIODN assignment + +- fsl,iommu-parent + Usage: See pamu.txt + Value type: + Definition: PAMU property used for dynamic LIODN assignment. This is + an optional property. It is a valid configuration for + this phandle to be dangling + + For additional details about the PAMU/LIODN binding(s) see pamu.txt + +- fsl,qman-channel-id + Usage: Required + Value type: + Definition: The hardware index of the channel. This can also be + determined by dividing any of the channel's 8 work queue + IDs by 8 + +In addition to these properties the qman-portals should have sub-nodes to +represent the HW devices/portals that are connected to the software portal +described here + +The currently support sub-nodes are: + * fman@0 + * fman@1 + * pme@0 + * crypto@0 + +These subnodes should have the following properties: + +- fsl,liodn + Usage: See pamu.txt + Value type: + Definition: PAMU property used for static LIODN assignment + +- fsl,iommu-parent + Usage: See pamu.txt + Value type: + Definition: PAMU property used for dynamic LIODN assignment + +- dev-handle + Usage: Required + Value type: + Definition: The phandle to the particular hardware device that this + portal is connected to. + +DPAA QMan Pool Channel Nodes + +Pool Channels are defined with the following properties. + +PROPERTIES + +- compatible + Usage: Required + Value type: + Definition: Must include "fsl,qman-pool-channel" + May include "fsl,-qman-pool-channel" + +- fsl,qman-channel-id + Usage: Required + Value type: + Definition: The hardware index of the channel. This can also be + determined by dividing any of the channel's 8 work queue + IDs by 8 + +EXAMPLE + +The example below shows a (P4080) BMan portals container/bus node with two portals + + qman-portals@ff4200000 { + #address-cells = <1>; + #size-cells = <1>; + compatible = "simple-bus"; + ranges = <0 0xf 0xf4200000 0x200000>; + + qman-portal@0 { + compatible = "fsl,qman-portal-1.2.0", "fsl,qman-portal"; + reg = <0 0x4000>, <0x100000 0x1000>; + interrupts = <104 2 0 0>; + fsl,liodn = <1 2>; + fsl,qman-channel-id = <0>; + + fman@0 { + fsl,liodn = <0x21>; + dev-handle = <&fman0>; + }; + fman@1 { + fsl,liodn = <0xa1>; + dev-handle = <&fman1>; + }; + crypto@0 { + fsl,liodn = <0x41 0x66>; + dev-handle = <&crypto>; + }; + }; + qman-portal@4000 { + compatible = "fsl,qman-portal-1.2.0", "fsl,qman-portal"; + reg = <0x4000 0x4000>, <0x101000 0x1000>; + interrupts = <106 2 0 0>; + fsl,liodn = <3 4>; + fsl,qman-channel-id = <1>; + + fman@1 { + fsl,liodn = <0xa2>; + dev-handle = <&fman0>; + }; + fman@0 { + fsl,liodn = <0x22>; + dev-handle = <&fman1>; + }; + crypto@0 { + fsl,liodn = <0x42 0x67>; + dev-handle = <&crypto>; + }; + }; + };