1Cirrus Logic Madera class audio codecs Multi-Functional Device
2
3These devices are audio SoCs with extensive digital capabilities and a range
4of analogue I/O.
5
6See also the child driver bindings in:
7bindings/pinctrl/cirrus,madera-pinctrl.txt
8bindings/regulator/arizona-regulator.txt
9bindings/sound/madera.txt
10
11Required properties:
12
13  - compatible : One of the following chip-specific strings:
14        "cirrus,cs47l15"
15        "cirrus,cs47l35"
16        "cirrus,cs47l85"
17        "cirrus,cs47l90"
18        "cirrus,cs47l91"
19        "cirrus,cs42l92"
20        "cirrus,cs47l92"
21        "cirrus,cs47l93"
22        "cirrus,wm1840"
23
24  - reg : I2C slave address when connected using I2C, chip select number when
25    using SPI.
26
27  - DCVDD-supply : Power supply for the device as defined in
28    bindings/regulator/regulator.txt
29    Mandatory on CS47L15, CS47L35, CS47L90, CS47L91, CS42L92, CS47L92, CS47L93
30    Optional on CS47L85, WM1840
31
32  - AVDD-supply, DBVDD1-supply, DBVDD2-supply, CPVDD1-supply, CPVDD2-supply :
33    Power supplies for the device
34
35  - DBVDD3-supply, DBVDD4-supply : Power supplies for the device
36    (CS47L85, CS47L90, CS47L91, WM1840)
37
38  - SPKVDDL-supply, SPKVDDR-supply : Power supplies for the device
39    (CS47L85, WM1840)
40
41  - SPKVDD-supply : Power supply for the device
42    (CS47L15, CS47L35)
43
44  - interrupt-controller : Indicates that this device is an interrupt controller
45
46  - #interrupt-cells: the number of cells to describe an IRQ, must be 2.
47    The first cell is the IRQ number.
48    The second cell is the flags, encoded as the trigger masks from
49    bindings/interrupt-controller/interrupts.txt
50
51  - gpio-controller : Indicates this device is a GPIO controller.
52
53  - #gpio-cells : Must be 2. The first cell is the pin number. The second cell
54    is reserved for future use and must be zero
55
56  - interrupt-parent : The parent interrupt controller.
57
58  - interrupts : The interrupt line the /IRQ signal for the device is
59    connected to.
60
61Optional properties:
62
63  - MICVDD-supply : Power supply, only need to be specified if
64    powered externally
65
66  - reset-gpios : One entry specifying the GPIO controlling /RESET.
67    As defined in bindings/gpio.txt.
68    Although optional, it is strongly recommended to use a hardware reset
69
70  - MICBIASx : Initial data for the MICBIAS regulators, as covered in
71    Documentation/devicetree/bindings/regulator/regulator.txt.
72    One for each MICBIAS generator (MICBIAS1, MICBIAS2, ...)
73    (all codecs)
74
75    One for each output pin (MICBIAS1A, MIBCIAS1B, MICBIAS2A, ...)
76    (all except CS47L85, WM1840)
77
78    The following following additional property is supported for the generator
79    nodes:
80      - cirrus,ext-cap : Set to 1 if the MICBIAS has external decoupling
81        capacitors attached.
82
83Optional child nodes:
84    micvdd : Node containing initialization data for the micvdd regulator
85    See bindings/regulator/arizona-regulator.txt
86
87    ldo1 : Node containing initialization data for the LDO1 regulator
88    See bindings/regulator/arizona-regulator.txt
89    (cs47l85, wm1840)
90
91Example:
92
93cs47l85@0 {
94	compatible = "cirrus,cs47l85";
95	reg = <0>;
96
97	reset-gpios = <&gpio 0>;
98
99	interrupt-controller;
100	#interrupt-cells = <2>;
101	interrupts = <&host_irq1>;
102	interrupt-parent = <&gic>;
103
104	gpio-controller;
105	#gpio-cells = <2>;
106};
107