xref: /linux/Documentation/devicetree/bindings/soc/fsl/fsl,bman.yaml (revision c8faf11cd192214e231626c3ee973a35d8fc33f2) 
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,bman.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: QorIQ DPAA Buffer Manager
8
9maintainers:
10  - Frank Li <Frank.Li@nxp.com>
11
12description:
13  The Buffer Manager is part of the Data-Path Acceleration Architecture (DPAA).
14  BMan supports hardware allocation and deallocation of buffers belonging to
15  pools originally created by software with configurable depletion thresholds.
16  This binding covers the CCSR space programming model
17
18properties:
19  compatible:
20    oneOf:
21      - const: fsl,bman
22      - items:
23          - enum:
24              - fsl,ls1043a-bman
25              - fsl,ls1046a-bman
26          - const: fsl,bman
27
28  reg:
29    items:
30      - description: |
31          Registers region within the CCSR address space
32
33          The BMan revision information is located in the BMAN_IP_REV_1/2
34          registers which are located at offsets 0xbf8 and 0xbfc
35
36  interrupts:
37    items:
38      - description: The error interrupt
39
40  memory-region:
41    minItems: 1
42    maxItems: 2
43    description:
44      List of phandles referencing the BMan private memory
45      nodes (described below). The bman-fqd node must be
46      first followed by bman-pfdr node. Only used on ARM
47
48      Devices connected to a BMan instance via Direct Connect Portals (DCP) must link
49      to the respective BMan instance
50
51  fsl,bman-portals:
52    $ref: /schemas/types.yaml#/definitions/phandle
53    description: ref fsl,bman-port.yaml
54
55  fsl,liodn:
56    $ref: /schemas/types.yaml#/definitions/uint32-array
57    description:
58      See pamu.txt, PAMU property used for static LIODN assignment
59
60  fsl,iommu-parent:
61    $ref: /schemas/types.yaml#/definitions/phandle
62    description:
63      See pamu.txt, PAMU property used for dynamic LIODN assignment
64
65required:
66  - compatible
67  - reg
68  - interrupts
69
70additionalProperties: false
71
72examples:
73  - |
74    #include <dt-bindings/interrupt-controller/irq.h>
75
76    bman@31a000 {
77        compatible = "fsl,bman";
78        reg = <0x31a000 0x1000>;
79        interrupts = <16 IRQ_TYPE_EDGE_FALLING 1 2>;
80        fsl,liodn = <0x17>;
81        fsl,bman-portals = <&bportals>;
82        memory-region = <&bman_fbpr>;
83    };
84