Documentation/devicetree/bindings/sound/cirrus,cs4234.yaml

   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
   7 title: Cirrus Logic cs4234 audio CODEC
   8
   9 maintainers:
  10   - patches@opensource.cirrus.com
  11
  12 description:
  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
  26 properties:
  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
  50 required:
  51   - compatible
  52   - reg
  53   - VA-supply
  54   - VL-supply
  55
  56 additionalProperties: false
  57
  58 examples:
  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     };