xref: /linux/Documentation/devicetree/bindings/soc/fsl/fsl,qman.yaml (revision a1ff5a7d78a036d6c2178ee5acd6ba4946243800) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/soc/fsl/fsl,qman.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: QorIQ DPAA Queue Manager
8
9maintainers:
10  - Frank Li <Frank.Li@nxp.com>
11
12description:
13  The Queue Manager is part of the Data-Path Acceleration Architecture (DPAA). QMan
14  supports queuing and QoS scheduling of frames to CPUs, network interfaces and
15  DPAA logic modules, maintains packet ordering within flows. Besides providing
16  flow-level queuing, is also responsible for congestion management functions such
17  as RED/WRED, congestion notifications and tail discards. This binding covers the
18  CCSR space programming model
19
20properties:
21  compatible:
22    oneOf:
23      - const: fsl,qman
24      - items:
25          - enum:
26              - fsl,ls1043a-qman
27              - fsl,ls1046a-qman
28          - const: fsl,qman
29  reg:
30    items:
31      - description: |
32          Registers region within the CCSR address space
33
34          The QMan revision information is located in the QMAN_IP_REV_1/2
35          registers which are located at offsets 0xbf8 and 0xbfc
36
37  interrupts:
38    items:
39      - description: The error interrupt
40
41  fsl,qman-portals:
42    $ref: /schemas/types.yaml#/definitions/phandle
43    description: ref fsl,qman-port.yaml
44
45  fsl,liodn:
46    $ref: /schemas/types.yaml#/definitions/uint32-array
47    description:
48      See pamu.txt, PAMU property used for static LIODN assignment
49
50  fsl,iommu-parent:
51    $ref: /schemas/types.yaml#/definitions/phandle
52    description:
53      See pamu.txt, PAMU property used for dynamic LIODN assignment
54
55  clocks:
56    maxItems: 1
57    description:
58      Reference input clock. Its frequency is half of the platform clock
59
60  memory-region:
61    maxItems: 2
62    description:
63      List of phandles referencing the QMan private memory nodes (described
64      below). The qman-fqd node must be first followed by qman-pfdr node.
65      Only used on ARM Devices connected to a QMan instance via Direct Connect
66      Portals (DCP) must link to the respective QMan instance.
67
68  fsl,qman:
69    $ref: /schemas/types.yaml#/definitions/uint32-array
70    description:
71      List of phandle and DCP index pairs, to the QMan instance
72      to which this device is connected via the DCP
73
74required:
75  - compatible
76  - reg
77  - interrupts
78
79additionalProperties: false
80
81examples:
82  - |
83    #include <dt-bindings/interrupt-controller/irq.h>
84
85    qman: qman@318000 {
86        compatible = "fsl,qman";
87        reg = <0x318000 0x1000>;
88        interrupts = <16 IRQ_TYPE_EDGE_FALLING 1 3>;
89        fsl,liodn = <0x16>;
90        fsl,qman-portals = <&qportals>;
91        memory-region = <&qman_fqd &qman_pfdr>;
92        clocks = <&platform_pll 1>;
93    };
94