1QorIQ DPAA Queue Manager Portals Device Tree Binding
2
3Copyright (C) 2008 - 2014 Freescale Semiconductor Inc.
4
5CONTENTS
6
7	- QMan Portal
8	- QMan Pool Channel
9	- Example
10
11QMan Portal Node
12
13Portals are memory mapped interfaces to QMan that allow low-latency, lock-less
14interaction by software running on processor cores, accelerators and network
15interfaces with the QMan
16
17PROPERTIES
18
19- compatible
20	Usage:		Required
21	Value type:	<stringlist>
22	Definition:	Must include "fsl,qman-portal-<hardware revision>"
23			May include "fsl,<SoC>-qman-portal" or "fsl,qman-portal"
24
25- reg
26	Usage:		Required
27	Value type:	<prop-encoded-array>
28	Definition:	Two regions. The first is the cache-enabled region of
29			the portal. The second is the cache-inhibited region of
30			the portal
31
32- interrupts
33	Usage:		Required
34	Value type:	<prop-encoded-array>
35	Definition:	Standard property
36
37- fsl,liodn
38	Usage:		See pamu.txt
39	Value type:	<prop-encoded-array>
40	Definition:	Two LIODN(s). DQRR LIODN (DLIODN) and Frame LIODN
41			(FLIODN)
42
43- fsl,iommu-parent
44	Usage:		See pamu.txt
45	Value type:	<phandle>
46	Definition:	PAMU property used for dynamic LIODN assignment
47
48	For additional details about the PAMU/LIODN binding(s) see pamu.txt
49
50- cell-index
51	Usage:		Required
52	Value type:	<u32>
53	Definition:	The hardware index of the channel. This can also be
54			determined by dividing any of the channel's 8 work queue
55			IDs by 8
56
57In addition to these properties the qman-portals should have sub-nodes to
58represent the HW devices/portals that are connected to the software portal
59described here
60
61The currently supported sub-nodes are:
62	* fman0
63	* fman1
64	* pme
65	* crypto
66
67These subnodes should have the following properties:
68
69- fsl,liodn
70	Usage:		See pamu.txt
71	Value type:	<prop-encoded-array>
72	Definition:	PAMU property used for static LIODN assignment
73
74- fsl,iommu-parent
75	Usage:		See pamu.txt
76	Value type:	<phandle>
77	Definition:	PAMU property used for dynamic LIODN assignment
78
79- dev-handle
80	Usage:		Required
81	Value type:	<phandle>
82	Definition:	The phandle to the particular hardware device that this
83			portal is connected to.
84
85DPAA QMan Pool Channel Nodes
86
87Pool Channels are defined with the following properties.
88
89PROPERTIES
90
91- compatible
92	Usage:		Required
93	Value type:	<stringlist>
94	Definition:	Must include "fsl,qman-pool-channel"
95			May include "fsl,<SoC>-qman-pool-channel"
96
97- fsl,qman-channel-id
98	Usage:		Required
99	Value type:	<u32>
100	Definition:	The hardware index of the channel. This can also be
101			determined by dividing any of the channel's 8 work queue
102			IDs by 8
103
104EXAMPLE
105
106The example below shows a (P4080) QMan portals container/bus node with two portals
107
108	qman-portals@ff4200000 {
109		#address-cells = <1>;
110		#size-cells = <1>;
111		compatible = "simple-bus";
112		ranges = <0 0xf 0xf4200000 0x200000>;
113
114		qman-portal@0 {
115			compatible = "fsl,qman-portal-1.2.0", "fsl,qman-portal";
116			reg = <0 0x4000>, <0x100000 0x1000>;
117			interrupts = <104 2 0 0>;
118			fsl,liodn = <1 2>;
119			fsl,qman-channel-id = <0>;
120
121			fman0 {
122				fsl,liodn = <0x21>;
123				dev-handle = <&fman0>;
124			};
125			fman1 {
126				fsl,liodn = <0xa1>;
127				dev-handle = <&fman1>;
128			};
129			crypto {
130				fsl,liodn = <0x41 0x66>;
131				dev-handle = <&crypto>;
132			};
133		};
134		qman-portal@4000 {
135			compatible = "fsl,qman-portal-1.2.0", "fsl,qman-portal";
136			reg = <0x4000 0x4000>, <0x101000 0x1000>;
137			interrupts = <106 2 0 0>;
138			fsl,liodn = <3 4>;
139			cell-index = <1>;
140
141			fman0 {
142				fsl,liodn = <0x22>;
143				dev-handle = <&fman0>;
144			};
145			fman1 {
146				fsl,liodn = <0xa2>;
147				dev-handle = <&fman1>;
148			};
149			crypto {
150				fsl,liodn = <0x42 0x67>;
151				dev-handle = <&crypto>;
152			};
153		};
154	};
155