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

ASoC: dt-bindings: atmel-i2s: Convert to json-schema

Convert atmel i2s devicetree binding to json-schema.
Change file name to match json-schema naming.

Signed-off-by: Ryan Wanner <Ryan.Wanner@microchip.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20220722152945.2950807-1-Ryan.Wanner@microchip.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Ryan Wanner and committed by
Mark Brown
6f786754 8ebc4dd8

+85 -46
+85
Documentation/devicetree/bindings/sound/atmel,sama5d2-i2s.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) 2 + # Copyright (C) 2022 Microchip Technology, Inc. and its subsidiaries 3 + %YAML 1.2 4 + --- 5 + $id: http://devicetree.org/schemas/sound/atmel,sama5d2-i2s.yaml# 6 + $schema: http://devicetree.org/meta-schemas/core.yaml# 7 + 8 + title: Atmel I2S controller 9 + 10 + maintainers: 11 + - Nicolas Ferre <nicolas.ferre@microchip.com> 12 + - Alexandre Belloni <alexandre.belloni@bootlin.com> 13 + - Claudiu Beznea <claudiu.beznea@microchip.com> 14 + 15 + description: 16 + Atmel I2S (Inter-IC Sound Controller) bus is the standard 17 + interface for connecting audio devices, such as audio codecs. 18 + 19 + properties: 20 + compatible: 21 + const: atmel,sama5d2-i2s 22 + 23 + reg: 24 + maxItems: 1 25 + 26 + interrupts: 27 + maxItems: 1 28 + 29 + clocks: 30 + items: 31 + - description: Peripheral clock 32 + - description: Generated clock (Optional) 33 + - description: I2S mux clock (Optional). Set 34 + with gclk when Master Mode is required. 35 + minItems: 1 36 + 37 + clock-names: 38 + items: 39 + - const: pclk 40 + - const: gclk 41 + - const: muxclk 42 + minItems: 1 43 + 44 + dmas: 45 + items: 46 + - description: TX DMA Channel 47 + - description: RX DMA Channel 48 + 49 + dma-names: 50 + items: 51 + - const: tx 52 + - const: rx 53 + 54 + required: 55 + - compatible 56 + - reg 57 + - interrupts 58 + - dmas 59 + - dma-names 60 + - clocks 61 + - clock-names 62 + 63 + additionalProperties: false 64 + 65 + examples: 66 + - | 67 + #include <dt-bindings/dma/at91.h> 68 + #include <dt-bindings/interrupt-controller/arm-gic.h> 69 + 70 + i2s@f8050000 { 71 + compatible = "atmel,sama5d2-i2s"; 72 + reg = <0xf8050000 0x300>; 73 + interrupts = <54 IRQ_TYPE_LEVEL_HIGH 7>; 74 + dmas = <&dma0 75 + (AT91_XDMAC_DT_MEM_IF(0) | AT91_XDMAC_DT_PER_IF(1) | 76 + AT91_XDMAC_DT_PERID(31))>, 77 + <&dma0 78 + (AT91_XDMAC_DT_MEM_IF(0) | AT91_XDMAC_DT_PER_IF(1) | 79 + AT91_XDMAC_DT_PERID(32))>; 80 + dma-names = "tx", "rx"; 81 + clocks = <&i2s0_clk>, <&i2s0_gclk>, <&i2s0muxck>; 82 + clock-names = "pclk", "gclk", "muxclk"; 83 + pinctrl-names = "default"; 84 + pinctrl-0 = <&pinctrl_i2s0_default>; 85 + };
-46
Documentation/devicetree/bindings/sound/atmel-i2s.txt
··· 1 - * Atmel I2S controller 2 - 3 - Required properties: 4 - - compatible: Should be "atmel,sama5d2-i2s". 5 - - reg: Should be the physical base address of the controller and the 6 - length of memory mapped region. 7 - - interrupts: Should contain the interrupt for the controller. 8 - - dmas: Should be one per channel name listed in the dma-names property, 9 - as described in atmel-dma.txt and dma.txt files. 10 - - dma-names: Two dmas have to be defined, "tx" and "rx". 11 - This IP also supports one shared channel for both rx and tx; 12 - if this mode is used, one "rx-tx" name must be used. 13 - - clocks: Must contain an entry for each entry in clock-names. 14 - Please refer to clock-bindings.txt. 15 - - clock-names: Should be one of each entry matching the clocks phandles list: 16 - - "pclk" (peripheral clock) Required. 17 - - "gclk" (generated clock) Optional (1). 18 - - "muxclk" (I2S mux clock) Optional (1). 19 - 20 - Optional properties: 21 - - pinctrl-0: Should specify pin control groups used for this controller. 22 - - princtrl-names: Should contain only one value - "default". 23 - 24 - 25 - (1) : Only the peripheral clock is required. The generated clock and the I2S 26 - mux clock are optional and should only be set together, when Master Mode 27 - is required. 28 - 29 - Example: 30 - 31 - i2s@f8050000 { 32 - compatible = "atmel,sama5d2-i2s"; 33 - reg = <0xf8050000 0x300>; 34 - interrupts = <54 IRQ_TYPE_LEVEL_HIGH 7>; 35 - dmas = <&dma0 36 - (AT91_XDMAC_DT_MEM_IF(0) | AT91_XDMAC_DT_PER_IF(1) | 37 - AT91_XDMAC_DT_PERID(31))>, 38 - <&dma0 39 - (AT91_XDMAC_DT_MEM_IF(0) | AT91_XDMAC_DT_PER_IF(1) | 40 - AT91_XDMAC_DT_PERID(32))>; 41 - dma-names = "tx", "rx"; 42 - clocks = <&i2s0_clk>, <&i2s0_gclk>, <&i2s0muxck>; 43 - clock-names = "pclk", "gclk", "muxclk"; 44 - pinctrl-names = "default"; 45 - pinctrl-0 = <&pinctrl_i2s0_default>; 46 - };