treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / Documentation / devicetree / bindings / powerpc / 4xx / ppc440spe-adma.txt
blobde6a5f7d4aa4807d9bf3de0ef7dececee60b59c3
1 PPC440SPe DMA/XOR (DMA Controller and XOR Accelerator)
3 Device nodes needed for operation of the ppc440spe-adma driver
4 are specified hereby. These are I2O/DMA, DMA and XOR nodes
5 for DMA engines and Memory Queue Module node. The latter is used
6 by ADMA driver for configuration of RAID-6 H/W capabilities of
7 the PPC440SPe. In addition to the nodes and properties described
8 below, the ranges property of PLB node must specify ranges for
9 DMA devices.
11  i) The I2O node
13  Required properties:
15  - compatible           : "ibm,i2o-440spe";
16  - reg                  : <registers mapping>
17  - dcr-reg              : <DCR registers range>
19  Example:
21         I2O: i2o@400100000 {
22                 compatible = "ibm,i2o-440spe";
23                 reg = <0x00000004 0x00100000 0x100>;
24                 dcr-reg = <0x060 0x020>;
25         };
28  ii) The DMA node
30  Required properties:
32  - compatible           : "ibm,dma-440spe";
33  - cell-index           : 1 cell, hardware index of the DMA engine
34                           (typically 0x0 and 0x1 for DMA0 and DMA1)
35  - reg                  : <registers mapping>
36  - dcr-reg              : <DCR registers range>
37  - interrupts           : <interrupt mapping for DMA0/1 interrupts sources:
38                            2 sources: DMAx CS FIFO Needs Service IRQ (on UIC0)
39                            and DMA Error IRQ (on UIC1). The latter is common
40                            for both DMA engines>.
42  Example:
44         DMA0: dma0@400100100 {
45                 compatible = "ibm,dma-440spe";
46                 cell-index = <0>;
47                 reg = <0x00000004 0x00100100 0x100>;
48                 dcr-reg = <0x060 0x020>;
49                 interrupt-parent = <&DMA0>;
50                 interrupts = <0 1>;
51                 #interrupt-cells = <1>;
52                 #address-cells = <0>;
53                 #size-cells = <0>;
54                 interrupt-map = <
55                         0 &UIC0 0x14 4
56                         1 &UIC1 0x16 4>;
57         };
60  iii) XOR Accelerator node
62  Required properties:
64  - compatible           : "amcc,xor-accelerator";
65  - reg                  : <registers mapping>
66  - interrupts           : <interrupt mapping for XOR interrupt source>
68  Example:
70         xor-accel@400200000 {
71                 compatible = "amcc,xor-accelerator";
72                 reg = <0x00000004 0x00200000 0x400>;
73                 interrupt-parent = <&UIC1>;
74                 interrupts = <0x1f 4>;
75         };
78  iv) Memory Queue Module node
80  Required properties:
82  - compatible           : "ibm,mq-440spe";
83  - dcr-reg              : <DCR registers range>
85  Example:
87         MQ0: mq {
88                 compatible = "ibm,mq-440spe";
89                 dcr-reg = <0x040 0x020>;
90         };