190ad3031SOlivier Dautricourt# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
290ad3031SOlivier Dautricourt%YAML 1.2
390ad3031SOlivier Dautricourt---
490ad3031SOlivier Dautricourt$id: http://devicetree.org/schemas/dma/altr,msgdma.yaml#
590ad3031SOlivier Dautricourt$schema: http://devicetree.org/meta-schemas/core.yaml#
690ad3031SOlivier Dautricourt
790ad3031SOlivier Dautricourttitle: Altera mSGDMA IP core
890ad3031SOlivier Dautricourt
990ad3031SOlivier Dautricourtmaintainers:
1090ad3031SOlivier Dautricourt  - Olivier Dautricourt <olivier.dautricourt@orolia.com>
1190ad3031SOlivier Dautricourt
1290ad3031SOlivier Dautricourtdescription: |
1390ad3031SOlivier Dautricourt  Altera / Intel modular Scatter-Gather Direct Memory Access (mSGDMA)
1490ad3031SOlivier Dautricourt  intellectual property (IP)
1590ad3031SOlivier Dautricourt
1690ad3031SOlivier DautricourtallOf:
1790ad3031SOlivier Dautricourt  - $ref: "dma-controller.yaml#"
1890ad3031SOlivier Dautricourt
1990ad3031SOlivier Dautricourtproperties:
2090ad3031SOlivier Dautricourt  compatible:
2190ad3031SOlivier Dautricourt    const: altr,socfpga-msgdma
2290ad3031SOlivier Dautricourt
2390ad3031SOlivier Dautricourt  reg:
2490ad3031SOlivier Dautricourt    items:
2590ad3031SOlivier Dautricourt      - description: Control and Status Register Slave Port
2690ad3031SOlivier Dautricourt      - description: Descriptor Slave Port
27*4aece33cSOlivier Dautricourt      - description: Response Slave Port (Optional)
28*4aece33cSOlivier Dautricourt    minItems: 2
2990ad3031SOlivier Dautricourt
3090ad3031SOlivier Dautricourt  reg-names:
3190ad3031SOlivier Dautricourt    items:
3290ad3031SOlivier Dautricourt      - const: csr
3390ad3031SOlivier Dautricourt      - const: desc
3490ad3031SOlivier Dautricourt      - const: resp
35*4aece33cSOlivier Dautricourt    minItems: 2
3690ad3031SOlivier Dautricourt
3790ad3031SOlivier Dautricourt  interrupts:
3890ad3031SOlivier Dautricourt    maxItems: 1
3990ad3031SOlivier Dautricourt
4090ad3031SOlivier Dautricourt  "#dma-cells":
4190ad3031SOlivier Dautricourt    const: 1
4290ad3031SOlivier Dautricourt    description:
4390ad3031SOlivier Dautricourt      The cell identifies the channel id (must be 0)
4490ad3031SOlivier Dautricourt
4590ad3031SOlivier Dautricourtrequired:
4690ad3031SOlivier Dautricourt  - compatible
4790ad3031SOlivier Dautricourt  - reg
4890ad3031SOlivier Dautricourt  - reg-names
4990ad3031SOlivier Dautricourt  - interrupts
5090ad3031SOlivier Dautricourt
5190ad3031SOlivier DautricourtunevaluatedProperties: false
5290ad3031SOlivier Dautricourt
5390ad3031SOlivier Dautricourtexamples:
5490ad3031SOlivier Dautricourt  - |
5590ad3031SOlivier Dautricourt    #include <dt-bindings/interrupt-controller/irq.h>
5690ad3031SOlivier Dautricourt
5790ad3031SOlivier Dautricourt    msgdma_controller: dma-controller@ff200b00 {
5890ad3031SOlivier Dautricourt        compatible = "altr,socfpga-msgdma";
5990ad3031SOlivier Dautricourt        reg = <0xff200b00 0x100>, <0xff200c00 0x100>, <0xff200d00 0x100>;
6090ad3031SOlivier Dautricourt        reg-names = "csr", "desc", "resp";
6190ad3031SOlivier Dautricourt        interrupts = <0 67 IRQ_TYPE_LEVEL_HIGH>;
6290ad3031SOlivier Dautricourt        #dma-cells = <1>;
6390ad3031SOlivier Dautricourt    };
64