Re: [PATCH v4 13/13] dt-bindings: mediatek: mt8188: add mt8188-mt6359 document

On 30/12/2022 06:54, Trevor Wu wrote:

Add document for mt8188 board with mt6359.

Use subject prefixes matching the subsystem (which you can get for example with `git log --oneline -- DIRECTORY_OR_FILE` on the directory your patch is touching).

Signed-off-by: Trevor Wu trevor.wu@mediatek.com

.../sound/mediatek,mt8188-mt6359.yaml | 93 +++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/mediatek,mt8188-mt6359.yaml

diff --git a/Documentation/devicetree/bindings/sound/mediatek,mt8188-mt6359.yaml b/Documentation/devicetree/bindings/sound/mediatek,mt8188-mt6359.yaml new file mode 100644 index 000000000000..5754c1d460db --- /dev/null +++ b/Documentation/devicetree/bindings/sound/mediatek,mt8188-mt6359.yaml @@ -0,0 +1,93 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/mediatek,mt8188-mt6359.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml#

+title: MediaTek MT8188 ASoC sound card

+maintainers:

• • Trevor Wu trevor.wu@mediatek.com

+properties:

• compatible:
• const: mediatek,mt8188-mt6359-evb
• model:
• $ref: /schemas/types.yaml#/definitions/string
• description: User specified audio sound card name
• audio-routing:
• $ref: /schemas/types.yaml#/definitions/non-unique-string-array
• description:

•  A list of the connections between audio components. Each entry is a
  

•  sink/source pair of strings. Valid names could be the input or output
  

•  widgets of audio components, power supplies, MicBias of codec and the
  

•  software switch.
  

• mediatek,platform:
• $ref: /schemas/types.yaml#/definitions/phandle
• description: The phandle of MT8188 ASoC platform.

+patternProperties:

• "^dai-link-[0-9]+$":
• type: object

On this level: additionalProperties: false

• description: |

•  Container for dai-link level properties and CODEC sub-nodes.
  

• properties:

•  dai-link-name:
  

Instead: link-name

•    description: |
  

•      This property corresponds to the name of the BE dai-link to which
  

•      we are going to update parameters in this node.
  

•    items:
  

•      enum:
  

•        - ADDA_BE
  

•        - DPTX_BE
  

•        - ETDM1_IN_BE
  

•        - ETDM2_IN_BE
  

•        - ETDM1_OUT_BE
  

•        - ETDM2_OUT_BE
  

•        - ETDM3_OUT_BE
  

•        - PCM1_BE
  

•  codec:
  

•    description: Holds subnode which indicates codec dai.
  

•    type: object
  

•    additionalProperties: false
  

•    properties:
  

•      sound-dai:
  

•        minItems: 1
  

•        maxItems: 2
  

required sound-dai

• required:

•  - dai-link-name
  

•  - codec
  

+additionalProperties: false

+required:

• • compatible
• • mediatek,platform

Your example looks pretty straightforward. Maybe you can use simple-card.yaml?

Best regards, Krzysztof