Hi Rob,

On 10/11/22 20:41, Rob Herring wrote:

Convert the dmic-codec binding to DT schema format.

The '#sound-dai-cells' and 'sound-name-prefix' properties were not documented, but are in use, so add them.

Signed-off-by: Rob Herring robh@kernel.org

.../devicetree/bindings/sound/dmic-codec.yaml | 55 +++++++++++++++++++ .../devicetree/bindings/sound/dmic.txt | 22 -------- 2 files changed, 55 insertions(+), 22 deletions(-) create mode 100644 Documentation/devicetree/bindings/sound/dmic-codec.yaml delete mode 100644 Documentation/devicetree/bindings/sound/dmic.txt

diff --git a/Documentation/devicetree/bindings/sound/dmic-codec.yaml b/Documentation/devicetree/bindings/sound/dmic-codec.yaml new file mode 100644 index 000000000000..767152fa99cc --- /dev/null +++ b/Documentation/devicetree/bindings/sound/dmic-codec.yaml @@ -0,0 +1,55 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/dmic-codec.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml#

+title: Generic PDM Digital microphone (DMIC) codec

+maintainers:

• • Arnaud Pouliquen arnaud.pouliquen@st.com

I don't have much activity on the audio topic anymore, so I don't know if I'm the best person. But if one maintainer is needed, that's fine. Please just change my email address to arnaud.pouliquen@foss.st.com With that and the fix reported by the bot Reviewed-by: Arnaud Pouliquen arnaud.pouliquen@foss.st.com

Thanks, Arnaud

+allOf:

• • $ref: name-prefix.yaml#

+properties:

• compatible:
• const: dmic-codec
• '#sound-dai-cells':
• const: 0
• dmicen-gpios:
• description: GPIO specifier for DMIC to control start and stop
• maxItems: 1
• num-channels:
• description: Number of microphones on this DAI
• $ref: /schemas/types.yaml#/definitions/uint32
• minimum: 1
• maximum: 8
• default: 8
• modeswitch-delay-ms:
• description: Delay (in ms) to complete DMIC mode switch
• wakeup-delay-ms:
• description: Delay (in ms) after enabling the DMIC

+required:

• • compatible

+unevaluatedProperties: false

+examples:

• • |
• #include <dt-bindings/gpio.h>
• dmic {

•    compatible = "dmic-codec";
  

•    dmicen-gpios = <&gpio4 3 GPIO_ACTIVE_HIGH>;
  

•    num-channels = <1>;
  

•    wakeup-delay-ms <50>;
  

•    modeswitch-delay-ms <35>;
  

• };

+... diff --git a/Documentation/devicetree/bindings/sound/dmic.txt b/Documentation/devicetree/bindings/sound/dmic.txt deleted file mode 100644 index 32e871037269..000000000000 --- a/Documentation/devicetree/bindings/sound/dmic.txt +++ /dev/null @@ -1,22 +0,0 @@ -Device-Tree bindings for Digital microphone (DMIC) codec

-This device support generic PDM digital microphone.

-Required properties:

• • compatible: should be "dmic-codec".

-Optional properties:

• • dmicen-gpios: GPIO specifier for dmic to control start and stop
• • num-channels: Number of microphones on this DAI
• • wakeup-delay-ms: Delay (in ms) after enabling the DMIC
• • modeswitch-delay-ms: Delay (in ms) to complete DMIC mode switch

-Example node:

• dmic_codec: dmic@0 {

• compatible = "dmic-codec";
  

• dmicen-gpios = <&gpio4 3 GPIO_ACTIVE_HIGH>;
  

• num-channels = <1>;
  

• wakeup-delay-ms <50>;
  

• modeswitch-delay-ms <35>;
  

• };