xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/sound/cirrus,cs4234.yaml (revision 4882a59341e53eb6f0b4789bf948001014eff981) 
1*4882a593Smuzhiyun# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause)
2*4882a593Smuzhiyun%YAML 1.2
3*4882a593Smuzhiyun---
4*4882a593Smuzhiyun$id: http://devicetree.org/schemas/sound/cirrus,cs4234.yaml#
5*4882a593Smuzhiyun$schema: http://devicetree.org/meta-schemas/core.yaml#
6*4882a593Smuzhiyun
7*4882a593Smuzhiyuntitle: Cirrus Logic cs4234 audio CODEC
8*4882a593Smuzhiyun
9*4882a593Smuzhiyunmaintainers:
10*4882a593Smuzhiyun  - patches@opensource.cirrus.com
11*4882a593Smuzhiyun
12*4882a593Smuzhiyundescription:
13*4882a593Smuzhiyun  The CS4234 is a highly versatile CODEC that combines 4 channels of
14*4882a593Smuzhiyun  high performance analog to digital conversion, 4 channels of high
15*4882a593Smuzhiyun  performance digital to analog conversion for audio, and 1 channel of
16*4882a593Smuzhiyun  digital to analog conversion to provide a nondelayed audio reference
17*4882a593Smuzhiyun  signal to an external Class H tracking power supply. If not used to
18*4882a593Smuzhiyun  drive a tracking power supply, the 5th DAC can instead be used as a
19*4882a593Smuzhiyun  standard audio grade DAC, with performance specifications identical
20*4882a593Smuzhiyun  to that of the 4 DACs in the audio path. Additionally, the CS4234
21*4882a593Smuzhiyun  includes tunable group delay for each of the 4 audio DAC paths to
22*4882a593Smuzhiyun  provide lead time for the external switch-mode power supply, and a
23*4882a593Smuzhiyun  nondelayed path into the DAC outputs for input signals requiring a
24*4882a593Smuzhiyun  low-latency path to the outputs.
25*4882a593Smuzhiyun
26*4882a593Smuzhiyunproperties:
27*4882a593Smuzhiyun  compatible:
28*4882a593Smuzhiyun    enum:
29*4882a593Smuzhiyun      - cirrus,cs4234
30*4882a593Smuzhiyun
31*4882a593Smuzhiyun  reg:
32*4882a593Smuzhiyun    description:
33*4882a593Smuzhiyun      The 7-bit I2C address depends on the state of the ADx pins, in
34*4882a593Smuzhiyun      binary given by [0 0 1 0 AD2 AD1 AD0 0].
35*4882a593Smuzhiyun    items:
36*4882a593Smuzhiyun      minimum: 0x10
37*4882a593Smuzhiyun      maximum: 0x17
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun  VA-supply:
40*4882a593Smuzhiyun    description:
41*4882a593Smuzhiyun      Analogue power supply.
42*4882a593Smuzhiyun
43*4882a593Smuzhiyun  VL-supply:
44*4882a593Smuzhiyun    description:
45*4882a593Smuzhiyun      Interface power supply.
46*4882a593Smuzhiyun
47*4882a593Smuzhiyun  reset-gpios:
48*4882a593Smuzhiyun    maxItems: 1
49*4882a593Smuzhiyun
50*4882a593Smuzhiyunrequired:
51*4882a593Smuzhiyun  - compatible
52*4882a593Smuzhiyun  - reg
53*4882a593Smuzhiyun  - VA-supply
54*4882a593Smuzhiyun  - VL-supply
55*4882a593Smuzhiyun
56*4882a593SmuzhiyunadditionalProperties: false
57*4882a593Smuzhiyun
58*4882a593Smuzhiyunexamples:
59*4882a593Smuzhiyun  - |
60*4882a593Smuzhiyun    i2c@e0004000 {
61*4882a593Smuzhiyun        #address-cells = <1>;
62*4882a593Smuzhiyun        #size-cells = <0>;
63*4882a593Smuzhiyun        reg = <0xe0004000 0x1000>;
64*4882a593Smuzhiyun
65*4882a593Smuzhiyun        cs4234: codec@11 {
66*4882a593Smuzhiyun            compatible = "cirrus,cs4234";
67*4882a593Smuzhiyun            reg = <0x11>;
68*4882a593Smuzhiyun
69*4882a593Smuzhiyun            VA-supply = <&vdd3v3>;
70*4882a593Smuzhiyun            VL-supply = <&vdd3v3>;
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun            reset-gpios = <&gpio 0>;
73*4882a593Smuzhiyun        };
74*4882a593Smuzhiyun    };
75