0001 QorIQ DPAA Queue Manager Portals Device Tree Binding
0002
0003 Copyright (C) 2008 - 2014 Freescale Semiconductor Inc.
0004
0005 CONTENTS
0006
0007 - QMan Portal
0008 - Example
0009
0010 QMan Portal Node
0011
0012 Portals are memory mapped interfaces to QMan that allow low-latency, lock-less
0013 interaction by software running on processor cores, accelerators and network
0014 interfaces with the QMan
0015
0016 PROPERTIES
0017
0018 - compatible
0019 Usage: Required
0020 Value type: <stringlist>
0021 Definition: Must include "fsl,qman-portal-<hardware revision>"
0022 May include "fsl,<SoC>-qman-portal" or "fsl,qman-portal"
0023
0024 - reg
0025 Usage: Required
0026 Value type: <prop-encoded-array>
0027 Definition: Two regions. The first is the cache-enabled region of
0028 the portal. The second is the cache-inhibited region of
0029 the portal
0030
0031 - interrupts
0032 Usage: Required
0033 Value type: <prop-encoded-array>
0034 Definition: Standard property
0035
0036 - fsl,liodn
0037 Usage: See pamu.txt
0038 Value type: <prop-encoded-array>
0039 Definition: Two LIODN(s). DQRR LIODN (DLIODN) and Frame LIODN
0040 (FLIODN)
0041
0042 - fsl,iommu-parent
0043 Usage: See pamu.txt
0044 Value type: <phandle>
0045 Definition: PAMU property used for dynamic LIODN assignment
0046
0047 For additional details about the PAMU/LIODN binding(s) see pamu.txt
0048
0049 - cell-index
0050 Usage: Required
0051 Value type: <u32>
0052 Definition: The hardware index of the channel. This can also be
0053 determined by dividing any of the channel's 8 work queue
0054 IDs by 8
0055
0056 In addition to these properties the qman-portals should have sub-nodes to
0057 represent the HW devices/portals that are connected to the software portal
0058 described here
0059
0060 The currently supported sub-nodes are:
0061 * fman0
0062 * fman1
0063 * pme
0064 * crypto
0065
0066 These subnodes should have the following properties:
0067
0068 - fsl,liodn
0069 Usage: See pamu.txt
0070 Value type: <prop-encoded-array>
0071 Definition: PAMU property used for static LIODN assignment
0072
0073 - fsl,iommu-parent
0074 Usage: See pamu.txt
0075 Value type: <phandle>
0076 Definition: PAMU property used for dynamic LIODN assignment
0077
0078 - dev-handle
0079 Usage: Required
0080 Value type: <phandle>
0081 Definition: The phandle to the particular hardware device that this
0082 portal is connected to.
0083
0084 EXAMPLE
0085
0086 The example below shows a (P4080) QMan portals container/bus node with two portals
0087
0088 qman-portals@ff4200000 {
0089 #address-cells = <1>;
0090 #size-cells = <1>;
0091 compatible = "simple-bus";
0092 ranges = <0 0xf 0xf4200000 0x200000>;
0093
0094 qman-portal@0 {
0095 compatible = "fsl,qman-portal-1.2.0", "fsl,qman-portal";
0096 reg = <0 0x4000>, <0x100000 0x1000>;
0097 interrupts = <104 2 0 0>;
0098 fsl,liodn = <1 2>;
0099 fsl,qman-channel-id = <0>;
0100
0101 fman0 {
0102 fsl,liodn = <0x21>;
0103 dev-handle = <&fman0>;
0104 };
0105 fman1 {
0106 fsl,liodn = <0xa1>;
0107 dev-handle = <&fman1>;
0108 };
0109 crypto {
0110 fsl,liodn = <0x41 0x66>;
0111 dev-handle = <&crypto>;
0112 };
0113 };
0114 qman-portal@4000 {
0115 compatible = "fsl,qman-portal-1.2.0", "fsl,qman-portal";
0116 reg = <0x4000 0x4000>, <0x101000 0x1000>;
0117 interrupts = <106 2 0 0>;
0118 fsl,liodn = <3 4>;
0119 cell-index = <1>;
0120
0121 fman0 {
0122 fsl,liodn = <0x22>;
0123 dev-handle = <&fman0>;
0124 };
0125 fman1 {
0126 fsl,liodn = <0xa2>;
0127 dev-handle = <&fman1>;
0128 };
0129 crypto {
0130 fsl,liodn = <0x42 0x67>;
0131 dev-handle = <&crypto>;
0132 };
0133 };
0134 };
