xref: /linux/Documentation/devicetree/bindings/sound/cirrus,cs42xx8.yaml (revision 4b132aacb0768ac1e652cf517097ea6f237214b9) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/cirrus,cs42xx8.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Cirrus Logic CS42448/CS42888 audio CODEC
8
9maintainers:
10  - patches@opensource.cirrus.com
11
12properties:
13  compatible:
14    enum:
15      - cirrus,cs42448
16      - cirrus,cs42888
17
18  reg:
19    maxItems: 1
20
21  clocks:
22    minItems: 1
23    maxItems: 2
24
25  clock-names:
26    const: mclk
27
28  VA-supply:
29    description: Analog power supply.
30
31  VD-supply:
32    description: Digital power supply.
33
34  VLC-supply:
35    description: Control port power supply
36
37  VLS-supply:
38    description: Serial port interface power supply.
39
40  reset-gpios:
41    description: This pin is connected to the chip's RESET pin.
42    maxItems: 1
43
44required:
45  - compatible
46  - reg
47  - clocks
48  - clock-names
49
50if:
51  properties:
52    compatible:
53      contains:
54        const: cirrus,cs42888
55then:
56  required:
57    - VA-supply
58    - VD-supply
59    - VLC-supply
60    - VLS-supply
61
62additionalProperties: false
63
64examples:
65  - |
66    i2c {
67      #address-cells = <1>;
68      #size-cells = <0>;
69
70      codec@48 {
71          compatible = "cirrus,cs42888";
72          reg = <0x48>;
73          clocks = <&codec_mclk 0>;
74          clock-names = "mclk";
75          VA-supply = <&reg_audio>;
76          VD-supply = <&reg_audio>;
77          VLS-supply = <&reg_audio>;
78          VLC-supply = <&reg_audio>;
79          reset-gpios = <&gpio 1>;
80      };
81    };
82