Merge tag 'powerpc-5.3-5' of git://git.kernel.org/pub/scm/linux/kernel/git/powerpc...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / sound / st,sta32x.txt
1 STA32X audio CODEC
2
3 The driver for this device only supports I2C.
4
5 Required properties:
6
7   - compatible: "st,sta32x"
8   - reg: the I2C address of the device for I2C
9   - reset-gpios: a GPIO spec for the reset pin. If specified, it will be
10                  deasserted before communication to the codec starts.
11
12   - power-down-gpios: a GPIO spec for the power down pin. If specified,
13                       it will be deasserted before communication to the codec
14                       starts.
15
16   - Vdda-supply: regulator spec, providing 3.3V
17   - Vdd3-supply: regulator spec, providing 3.3V
18   - Vcc-supply: regulator spec, providing 5V - 26V
19
20 Optional properties:
21
22   - clocks, clock-names: Clock specifier for XTI input clock.
23         If specified, the clock will be enabled when the codec is probed,
24         and disabled when it is removed. The 'clock-names' must be set to 'xti'.
25
26   -  st,output-conf: number, Selects the output configuration:
27         0: 2-channel (full-bridge) power, 2-channel data-out
28         1: 2 (half-bridge). 1 (full-bridge) on-board power
29         2: 2 Channel (Full-Bridge) Power, 1 Channel FFX
30         3: 1 Channel Mono-Parallel
31         If parameter is missing, mode 0 will be enabled.
32         This property has to be specified as '/bits/ 8' value.
33
34   -  st,ch1-output-mapping: Channel 1 output mapping
35   -  st,ch2-output-mapping: Channel 2 output mapping
36   -  st,ch3-output-mapping: Channel 3 output mapping
37         0: Channel 1
38         1: Channel 2
39         2: Channel 3
40         If parameter is missing, channel 1 is chosen.
41         This properties have to be specified as '/bits/ 8' values.
42
43   -  st,thermal-warning-recover:
44         If present, thermal warning recovery is enabled.
45
46   - st,fault-detect-recovery:
47         If present, fault detect recovery is enabled.
48
49   -  st,thermal-warning-adjustment:
50         If present, thermal warning adjustment is enabled.
51
52   -  st,fault-detect-recovery:
53         If present, then fault recovery will be enabled.
54
55   -  st,drop-compensation-ns: number
56         Only required for "st,ffx-power-output-mode" ==
57         "variable-drop-compensation".
58         Specifies the drop compensation in nanoseconds.
59         The value must be in the range of 0..300, and only
60         multiples of 20 are allowed. Default is 140ns.
61
62   -  st,max-power-use-mpcc:
63         If present, then MPCC bits are used for MPC coefficients,
64         otherwise standard MPC coefficients are used.
65
66   -  st,max-power-corr:
67         If present, power bridge correction for THD reduction near maximum
68         power output is enabled.
69
70   -  st,am-reduction-mode:
71         If present, FFX mode runs in AM reduction mode, otherwise normal
72         FFX mode is used.
73
74   -  st,odd-pwm-speed-mode:
75         If present, PWM speed mode run on odd speed mode (341.3 kHz) on all
76         channels. If not present, normal PWM spped mode (384 kHz) will be used.
77
78   -  st,invalid-input-detect-mute:
79         If present, automatic invalid input detect mute is enabled.
80
81 Example:
82
83 codec: sta32x@38 {
84         compatible = "st,sta32x";
85         reg = <0x1c>;
86         clocks = <&clock>;
87         clock-names = "xti";
88         reset-gpios = <&gpio1 19 0>;
89         power-down-gpios = <&gpio1 16 0>;
90         st,output-conf = /bits/ 8  <0x3>;       // set output to 2-channel
91                                                 // (full-bridge) power,
92                                                 // 2-channel data-out
93         st,ch1-output-mapping = /bits/ 8 <0>;   // set channel 1 output ch 1
94         st,ch2-output-mapping = /bits/ 8 <0>;   // set channel 2 output ch 1
95         st,ch3-output-mapping = /bits/ 8 <0>;   // set channel 3 output ch 1
96         st,max-power-correction;                // enables power bridge
97                                                 // correction for THD reduction
98                                                 // near maximum power output
99         st,invalid-input-detect-mute;           // mute if no valid digital
100                                                 // audio signal is provided.
101 };