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