Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

ASoC: dt-bindings: dlg,da7213: Convert to json-schema

Convert the Dialog Semiconductor DA7212/DA7213 Audio Codec Device Tree
binding documentation to json-schema.

Add missing properties.

Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/7645c9024a1762d281f4067504bc32a7a3d27caa.1721649741.git.geert+renesas@glider.be
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Geert Uytterhoeven and committed by
Mark Brown
d57ef033 aaa5e1aa

+104 -45
-45
Documentation/devicetree/bindings/sound/da7213.txt
··· 1 - Dialog Semiconductor DA7212/DA7213 Audio Codec bindings 2 - 3 - ====== 4 - 5 - Required properties: 6 - - compatible : Should be "dlg,da7212" or "dlg,da7213" 7 - - reg: Specifies the I2C slave address 8 - 9 - Optional properties: 10 - - clocks : phandle and clock specifier for codec MCLK. 11 - - clock-names : Clock name string for 'clocks' attribute, should be "mclk". 12 - 13 - - dlg,micbias1-lvl : Voltage (mV) for Mic Bias 1 14 - [<1600>, <2200>, <2500>, <3000>] 15 - - dlg,micbias2-lvl : Voltage (mV) for Mic Bias 2 16 - [<1600>, <2200>, <2500>, <3000>] 17 - - dlg,dmic-data-sel : DMIC channel select based on clock edge. 18 - ["lrise_rfall", "lfall_rrise"] 19 - - dlg,dmic-samplephase : When to sample audio from DMIC. 20 - ["on_clkedge", "between_clkedge"] 21 - - dlg,dmic-clkrate : DMIC clock frequency (Hz). 22 - [<1500000>, <3000000>] 23 - 24 - - VDDA-supply : Regulator phandle for Analogue power supply 25 - - VDDMIC-supply : Regulator phandle for Mic Bias 26 - - VDDIO-supply : Regulator phandle for I/O power supply 27 - 28 - ====== 29 - 30 - Example: 31 - 32 - codec_i2c: da7213@1a { 33 - compatible = "dlg,da7213"; 34 - reg = <0x1a>; 35 - 36 - clocks = <&clks 201>; 37 - clock-names = "mclk"; 38 - 39 - dlg,micbias1-lvl = <2500>; 40 - dlg,micbias2-lvl = <2500>; 41 - 42 - dlg,dmic-data-sel = "lrise_rfall"; 43 - dlg,dmic-samplephase = "between_clkedge"; 44 - dlg,dmic-clkrate = <3000000>; 45 - };
+103
Documentation/devicetree/bindings/sound/dlg,da7213.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/sound/dlg,da7213.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Dialog Semiconductor DA7212/DA7213 Audio Codec 8 + 9 + maintainers: 10 + - Support Opensource <support.opensource@diasemi.com> 11 + 12 + allOf: 13 + - $ref: dai-common.yaml# 14 + 15 + properties: 16 + compatible: 17 + enum: 18 + - dlg,da7212 19 + - dlg,da7213 20 + 21 + reg: 22 + maxItems: 1 23 + 24 + clocks: 25 + maxItems: 1 26 + 27 + clock-names: 28 + const: mclk 29 + 30 + "#sound-dai-cells": 31 + const: 0 32 + 33 + dlg,micbias1-lvl: 34 + description: Voltage (mV) for Mic Bias 1 35 + $ref: /schemas/types.yaml#/definitions/uint32 36 + enum: [ 1600, 2200, 2500, 3000 ] 37 + 38 + dlg,micbias2-lvl: 39 + description: Voltage (mV) for Mic Bias 2 40 + $ref: /schemas/types.yaml#/definitions/uint32 41 + enum: [ 1600, 2200, 2500, 3000 ] 42 + 43 + dlg,dmic-data-sel: 44 + description: DMIC channel select based on clock edge 45 + enum: [ lrise_rfall, lfall_rrise ] 46 + 47 + dlg,dmic-samplephase: 48 + description: When to sample audio from DMIC 49 + enum: [ on_clkedge, between_clkedge ] 50 + 51 + dlg,dmic-clkrate: 52 + description: DMIC clock frequency (Hz) 53 + $ref: /schemas/types.yaml#/definitions/uint32 54 + enum: [ 1500000, 3000000 ] 55 + 56 + VDDA-supply: 57 + description: Analogue power supply 58 + 59 + VDDIO-supply: 60 + description: I/O power supply 61 + 62 + VDDMIC-supply: 63 + description: Mic Bias 64 + 65 + VDDSP-supply: 66 + description: Speaker supply 67 + 68 + ports: 69 + $ref: audio-graph-port.yaml#/definitions/ports 70 + 71 + port: 72 + $ref: audio-graph-port.yaml# 73 + unevaluatedProperties: false 74 + 75 + required: 76 + - compatible 77 + - reg 78 + 79 + unevaluatedProperties: false 80 + 81 + examples: 82 + - | 83 + i2c { 84 + #address-cells = <1>; 85 + #size-cells = <0>; 86 + 87 + codec@1a { 88 + compatible = "dlg,da7213"; 89 + reg = <0x1a>; 90 + 91 + clocks = <&clks 201>; 92 + clock-names = "mclk"; 93 + 94 + #sound-dai-cells = <0>; 95 + 96 + dlg,micbias1-lvl = <2500>; 97 + dlg,micbias2-lvl = <2500>; 98 + 99 + dlg,dmic-data-sel = "lrise_rfall"; 100 + dlg,dmic-samplephase = "between_clkedge"; 101 + dlg,dmic-clkrate = <3000000>; 102 + }; 103 + };
+1
MAINTAINERS
··· 6500 6500 F: Documentation/devicetree/bindings/regulator/dlg,da9*.yaml 6501 6501 F: Documentation/devicetree/bindings/regulator/dlg,slg51000.yaml 6502 6502 F: Documentation/devicetree/bindings/sound/da[79]*.txt 6503 + F: Documentation/devicetree/bindings/sound/dlg,da7213.yaml 6503 6504 F: Documentation/devicetree/bindings/thermal/dlg,da9062-thermal.yaml 6504 6505 F: Documentation/devicetree/bindings/watchdog/dlg,da9062-watchdog.yaml 6505 6506 F: Documentation/hwmon/da90??.rst