xref: /linux/Documentation/devicetree/bindings/sound/nuvoton,nau8325.yaml (revision 90d32e92011eaae8e70a9169b4e7acf4ca8f9d3a) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/nuvoton,nau8325.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: NAU8325 audio Amplifier
8
9maintainers:
10  - Seven Lee <WTLI@nuvoton.com>
11
12allOf:
13  - $ref: dai-common.yaml#
14
15properties:
16  compatible:
17    const: nuvoton,nau8325
18
19  reg:
20    maxItems: 1
21
22  nuvoton,vref-impedance-ohms:
23    description:
24      The vref impedance to be used in ohms. Middle of voltage enables
25      Tie-Off selection options. Due to the high impedance of the VREF
26      pin, it is important to use a low-leakage capacitor.
27
28    enum: [0, 25000, 125000, 2500]
29
30  nuvoton,dac-vref-microvolt:
31    description:
32      The DAC vref to be used in voltage. DAC reference voltage setting. Can
33      be used for minor tuning of the output level. Since the VDDA is range
34      between 1.62 to 1.98 voltage, the typical value for design is 1.8V. After
35      the minor tuning, the final microvolt are as the below.
36
37    enum: [1800000, 2700000, 2880000, 3060000]
38
39  nuvoton,alc-enable:
40    description:
41      Enable digital automatic level control (ALC) function.
42    type: boolean
43
44  nuvoton,clock-detection-disable:
45    description:
46      When clock detection is enabled, it will detect whether MCLK
47      and FS are within the range. MCLK range is from 2.048MHz to 24.576MHz.
48      FS range is from 8kHz to 96kHz. And also needs to detect the ratio
49      MCLK_SRC/LRCK of 256, 400 or 500, and needs to detect the BCLK
50      to make sure data is present. There needs to be at least 8 BCLK
51      cycles per Frame Sync.
52    type: boolean
53
54  nuvoton,clock-det-data:
55    description:
56      Request clock detection to require 2048 non-zero samples before enabling
57      the audio paths. If set then non-zero samples is required, otherwise it
58      doesn't matter.
59    type: boolean
60
61required:
62  - compatible
63  - reg
64
65unevaluatedProperties: false
66
67examples:
68  - |
69    i2c {
70        #address-cells = <1>;
71        #size-cells = <0>;
72        codec@21 {
73            compatible = "nuvoton,nau8325";
74            reg = <0x21>;
75            nuvoton,vref-impedance-ohms = <125000>;
76            nuvoton,dac-vref-microvolt = <2880000>;
77            nuvoton,alc-enable;
78            nuvoton,clock-det-data;
79        };
80    };
81