Linux 6.7-rc7
[linux-modified.git] / Documentation / devicetree / bindings / sound / awinic,aw88395.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/awinic,aw88395.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Awinic AW88395 Smart Audio Amplifier
8
9 maintainers:
10   - Weidong Wang <wangweidong.a@awinic.com>
11
12 description:
13   The Awinic AW88395 is an I2S/TDM input, high efficiency
14   digital Smart K audio amplifier with an integrated 10.25V
15   smart boost convert.
16
17 properties:
18   compatible:
19     enum:
20       - awinic,aw88395
21       - awinic,aw88261
22       - awinic,aw88399
23
24   reg:
25     maxItems: 1
26
27   '#sound-dai-cells':
28     const: 0
29
30   reset-gpios:
31     maxItems: 1
32
33   awinic,audio-channel:
34     description:
35       It is used to distinguish multiple PA devices, so that different
36       configurations can be loaded to different PA devices
37     $ref: /schemas/types.yaml#/definitions/uint32
38     minimum: 0
39     maximum: 7
40
41   awinic,sync-flag:
42     description:
43       Flag bit used to keep the phase synchronized in the case of multiple PA
44     $ref: /schemas/types.yaml#/definitions/flag
45
46 required:
47   - compatible
48   - reg
49   - '#sound-dai-cells'
50   - awinic,audio-channel
51
52 allOf:
53   - $ref: dai-common.yaml#
54   - if:
55       properties:
56         compatible:
57           contains:
58             enum:
59               - awinic,aw88261
60     then:
61       properties:
62         reset-gpios: false
63
64 unevaluatedProperties: false
65
66 examples:
67   - |
68     #include <dt-bindings/gpio/gpio.h>
69     i2c {
70         #address-cells = <1>;
71         #size-cells = <0>;
72         audio-codec@34 {
73             compatible = "awinic,aw88395";
74             reg = <0x34>;
75             #sound-dai-cells = <0>;
76             reset-gpios = <&gpio 10 GPIO_ACTIVE_LOW>;
77             awinic,audio-channel = <0>;
78             awinic,sync-flag;
79         };
80     };