Re: [PATCH v4 1/2] ASoC: dt-bindings: Added schema for "nuvoton,nau8325"

From: Rob Herring
Date: Fri Mar 22 2024 - 14:25:43 EST


On Fri, Mar 22, 2024 at 10:54:04AM +0800, Seven Lee wrote:
> Add a DT schema for describing nau8325 audio amplifiers. The key features
> are as follows:
> - Low SPK_VDD Quiescent Current
> - Gain Setting with 2-wire interface
> - Powerful Stereo Class-D Amplifier
> - Low Output Noise
> - Low Current Shutdown Mode
> - Click-and Pop Suppression
>
> More resources :
> https://www.nuvoton.com/products/smart-home-audio/audio-amplifiers/class-d-series/nau8325yg/
>
> Signed-off-by: Seven Lee <wtli@xxxxxxxxxxx>
> ---
> .../bindings/sound/nuvoton,nau8325.yaml | 90 +++++++++++++++++++
> 1 file changed, 90 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/sound/nuvoton,nau8325.yaml
>
> diff --git a/Documentation/devicetree/bindings/sound/nuvoton,nau8325.yaml b/Documentation/devicetree/bindings/sound/nuvoton,nau8325.yaml
> new file mode 100644
> index 000000000000..6ded94c0e644
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/sound/nuvoton,nau8325.yaml
> @@ -0,0 +1,90 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/sound/nuvoton,nau8325.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: NAU8325 audio Amplifier
> +
> +maintainers:
> + - Seven Lee <WTLI@xxxxxxxxxxx>
> +
> +allOf:
> + - $ref: dai-common.yaml#
> +
> +properties:
> + compatible:
> + const: nuvoton,nau8325
> +
> + reg:
> + maxItems: 1
> +
> + nuvoton,vref-impedance:
> + $ref: /schemas/types.yaml#/definitions/uint32
> + description:
> + The vref impedance to be used in kohms. Middle of voltage enables
> + Tie-Off selection options. Due to the high impedance of the VREF
> + pin, it is important to use a low-leakage capacitor. Possible
> + values are 0, 1, 2, and 3 as per the below,
> +
> + 0 = Disable tie off resistance
> + 1 = 25 kohms
> + 2 = 125 kohms
> + 3 = 2.5 kohms
> + enum: [ 0, 1, 2, 3 ]

Once again, use standard unit suffix on the property name:

nuvoton,vref-impedance-ohms:
enum: [0, 2500, 25000, 125000]

Rob