Merge tag 'armsoc-dt' of git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / spi / fsl-spi.txt
1 * SPI (Serial Peripheral Interface)
2
3 Required properties:
4 - cell-index : QE SPI subblock index.
5                 0: QE subblock SPI1
6                 1: QE subblock SPI2
7 - compatible : should be "fsl,spi" or "aeroflexgaisler,spictrl".
8 - mode : the SPI operation mode, it can be "cpu" or "cpu-qe".
9 - reg : Offset and length of the register set for the device
10 - interrupts : <a b> where a is the interrupt number and b is a
11   field that represents an encoding of the sense and level
12   information for the interrupt.  This should be encoded based on
13   the information in section 2) depending on the type of interrupt
14   controller you have.
15 - clock-frequency : input clock frequency to non FSL_SOC cores
16
17 Optional properties:
18 - gpios : specifies the gpio pins to be used for chipselects.
19   The gpios will be referred to as reg = <index> in the SPI child nodes.
20   If unspecified, a single SPI device without a chip select can be used.
21 - fsl,spisel_boot : for the MPC8306 and MPC8309, specifies that the
22   SPISEL_BOOT signal is used as chip select for a slave device. Use
23   reg = <number of gpios> in the corresponding child node, i.e. 0 if
24   the gpios property is not present.
25
26 Example:
27         spi@4c0 {
28                 cell-index = <0>;
29                 compatible = "fsl,spi";
30                 reg = <4c0 40>;
31                 interrupts = <82 0>;
32                 interrupt-parent = <700>;
33                 mode = "cpu";
34                 gpios = <&gpio 18 1     // device reg=<0>
35                          &gpio 19 1>;   // device reg=<1>
36         };
37
38
39 * eSPI (Enhanced Serial Peripheral Interface)
40
41 Required properties:
42 - compatible : should be "fsl,mpc8536-espi".
43 - reg : Offset and length of the register set for the device.
44 - interrupts : should contain eSPI interrupt, the device has one interrupt.
45 - fsl,espi-num-chipselects : the number of the chipselect signals.
46
47 Optional properties:
48 - fsl,csbef: chip select assertion time in bits before frame starts
49 - fsl,csaft: chip select negation time in bits after frame ends
50
51 Example:
52         spi@110000 {
53                 #address-cells = <1>;
54                 #size-cells = <0>;
55                 compatible = "fsl,mpc8536-espi";
56                 reg = <0x110000 0x1000>;
57                 interrupts = <53 0x2>;
58                 interrupt-parent = <&mpic>;
59                 fsl,espi-num-chipselects = <4>;
60                 fsl,csbef = <1>;
61                 fsl,csaft = <1>;
62         };