Documentation/devicetree/bindings/sound/adi,adau1373.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/sound/adi,adau1373.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Analog Devices ADAU1373 CODEC
   8
   9 maintainers:
  10   - Nuno Sá <nuno.sa@analog.com>
  11
  12 description: |
  13   Analog Devices ADAU1373 Low power codec with speaker and headphone amplifiers.
  14   https://www.analog.com/media/en/technical-documentation/data-sheets/ADAU1373.pdf
  15
  16 allOf:
  17   - $ref: dai-common.yaml#
  18
  19 properties:
  20   compatible:
  21     enum:
  22       - adi,adau1373
  23
  24   reg:
  25     maxItems: 1
  26
  27   "#sound-dai-cells":
  28     const: 0
  29
  30   powerdown-gpios:
  31     description: GPIO used for hardware power-down.
  32     maxItems: 1
  33
  34   adi,micbias1-microvolt:
  35     description:
  36       This property sets the microphone bias voltage for the first microphone.
  37     enum: [1800000, 2200000, 2600000, 2900000]
  38     default: 2900000
  39
  40   adi,micbias2-microvolt:
  41     description:
  42       This property sets the microphone bias voltage for the second microphone.
  43     enum: [1800000, 2200000, 2600000, 2900000]
  44     default: 2900000
  45
  46   adi,input1-differential:
  47     description: This property sets the first analog input as differential.
  48     type: boolean
  49
  50   adi,input2-differential:
  51     description: This property sets the second analog input as differential.
  52     type: boolean
  53
  54   adi,input3-differential:
  55     description: This property sets the third analog input as differential.
  56     type: boolean
  57
  58   adi,input4-differential:
  59     description: This property sets the fourth analog input as differential.
  60     type: boolean
  61
  62   adi,lineout-differential:
  63     description: This property sets the line output as differential.
  64     type: boolean
  65
  66   adi,lineout-gnd-sense:
  67     description: This property enables the line output ground sense control.
  68     type: boolean
  69
  70   adi,drc-settings:
  71     description:
  72       This setting is used to control the dynamic range of the signal. The
  73       device provides a maximum of three full band DRCs with 13 entries each.
  74     $ref: /schemas/types.yaml#/definitions/uint8-array
  75     oneOf:
  76       - minItems: 13
  77         maxItems: 13
  78       - minItems: 26
  79         maxItems: 26
  80       - minItems: 39
  81         maxItems: 39
  82
  83 required:
  84   - "#sound-dai-cells"
  85   - compatible
  86   - reg
  87
  88 unevaluatedProperties: false
  89
  90 examples:
  91   - |
  92     #include <dt-bindings/gpio/gpio.h>
  93
  94     i2c {
  95         #address-cells = <1>;
  96         #size-cells = <0>;
  97         audio-codec@1a {
  98             compatible = "adi,adau1373";
  99             reg = <0x1a>;
 100             #sound-dai-cells = <0>;
 101             powerdown-gpios = <&gpio 100 GPIO_ACTIVE_LOW>;
 102             adi,input2-differential;
 103             adi,input1-differential;
 104             adi,lineout-differential;
 105             adi,micbias2-microvolt = <1800000>;
 106             adi,drc-settings = /bits/ 8 <
 107                 0xff 0xff 0x1 0x2 0xa 0xa 0xd 0x1 0xff 0xff 0x5 0xd 0xff
 108             >;
 109         };
 110     };
 111 ...