On Mon, Sep 30, 2024 at 03:33:10PM +0800, Macpaul Lin wrote:
> Convert the MediaTek MT6358 Audio CODEC bindings to DT schema.
>
> This change implements the following updates:
> 1. Compatible property: Added the const 'mediatek,mt6358-sound'
> to ensure alignment with the schema in the actual (DTS) file
> "mt8186-corsola.dtsi" with 'mediatek,mt6366-sound'.
> 2. Example: Removed the example section, as it should be relocated to
> the MT6397 PMIC file 'mfd/mediatek,mt6397.yaml'.
>
> Signed-off-by: Macpaul Lin <macpaul.lin@xxxxxxxxxxxx>
> ---
> .../devicetree/bindings/sound/mt6358.txt | 26 ------------
> .../devicetree/bindings/sound/mt6358.yaml | 41 +++++++++++++++++++
> 2 files changed, 41 insertions(+), 26 deletions(-)
> delete mode 100644 Documentation/devicetree/bindings/sound/mt6358.txt
> create mode 100644 Documentation/devicetree/bindings/sound/mt6358.yaml
>
> Changess for v1~v6:
> - It was not in the origin patch set.
>
> Changes for v7:
> - It is seperated from the origin patch set (2/2, v6).
> It could simplifies the audio-codec node in next patch (3/3, v7)
> of 'mfd/mediatek,mt6397.yaml'
>
> diff --git a/Documentation/devicetree/bindings/sound/mt6358.txt b/Documentation/devicetree/bindings/sound/mt6358.txt
> deleted file mode 100644
> index fbe9e55c68f5..000000000000
> --- a/Documentation/devicetree/bindings/sound/mt6358.txt
> +++ /dev/null
> @@ -1,26 +0,0 @@
> -Mediatek MT6358 Audio Codec
> -
> -The communication between MT6358 and SoC is through Mediatek PMIC wrapper.
> -For more detail, please visit Mediatek PMIC wrapper documentation.
> -
> -Must be a child node of PMIC wrapper.
> -
> -Required properties:
> -
> -- compatible - "string" - One of:
> - "mediatek,mt6358-sound"
> - "mediatek,mt6366-sound"
> -- Avdd-supply : power source of AVDD
> -
> -Optional properties:
> -- mediatek,dmic-mode : Indicates how many data pins are used to transmit two
> - channels of PDM signal. 0 means two wires, 1 means one wire. Default
> - value is 0.
> -
> -Example:
> -
> -mt6358_snd {
> - compatible = "mediatek,mt6358-sound";
> - Avdd-supply = <&mt6358_vaud28_reg>;
> - mediatek,dmic-mode = <0>;
> -};
> diff --git a/Documentation/devicetree/bindings/sound/mt6358.yaml b/Documentation/devicetree/bindings/sound/mt6358.yaml
> new file mode 100644
> index 000000000000..5f7611e26a89
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/sound/mt6358.yaml
> @@ -0,0 +1,41 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/sound/mt6358.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Mediatek MT6358 Audio Codec
> +
> +maintainers:
> + - Jiaxin Yu <jiaxin.yu@xxxxxxxxxxxx>
> + - Macpaul Lin <macpaul.lin@xxxxxxxxxxxx>
> +
> +description: |
> + The communication between MT6358 and SoC is through Mediatek PMIC wrapper.
> + For more detail, please visit Mediatek PMIC wrapper documentation.
> + Must be a child node of PMIC wrapper.
> +
> +properties:
> + compatible:
> + enum:
> + - mediatek,mt6366-sound
> + - mediatek,mt6358-sound
> + const: mediatek,mt6358-sound
This wasn't ever tested.
Do not send untested code, it's a waste of reviewers' time.
Best regards,
Krzysztof
