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

Configure Feed

Select the types of activity you want to include in your feed.

ASoC: dt-bindings: Convert mxs-saif.txt to fsl,saif.yaml (imx28 saif)

The 'fsl,imx28-saif' compatible has already the mxs-saif.txt description.
This patch converts (and removes it) this file to fsl,saif.yaml (to follow
current fsl convention).

Changes for the mxs-saif.txt:
- Adds 'clocks', '#clock-cells' and '#sound-dai-cells' properties
- Provide device description

Signed-off-by: Lukasz Majewski <lukma@denx.de>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://patch.msgid.link/20240828092709.2626359-1-lukma@denx.de
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Lukasz Majewski and committed by
Mark Brown 125b7492 4f451bc9

+83 -41
+83
Documentation/devicetree/bindings/sound/fsl,saif.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/fsl,saif.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Freescale MXS Serial Audio Interface (SAIF) 8 + 9 + maintainers: 10 + - Lukasz Majewski <lukma@denx.de> 11 + 12 + allOf: 13 + - $ref: dai-common.yaml# 14 + 15 + description: 16 + The SAIF is based on I2S module that is used to communicate with audio codecs, 17 + but only with half-duplex manner (i.e. it can either transmit or receive PCM 18 + audio). 19 + 20 + properties: 21 + compatible: 22 + const: fsl,imx28-saif 23 + 24 + reg: 25 + maxItems: 1 26 + 27 + "#sound-dai-cells": 28 + const: 0 29 + 30 + interrupts: 31 + maxItems: 1 32 + 33 + dmas: 34 + maxItems: 1 35 + 36 + dma-names: 37 + const: rx-tx 38 + 39 + "#clock-cells": 40 + description: Configure the I2S device as MCLK clock provider. 41 + const: 0 42 + 43 + clocks: 44 + maxItems: 1 45 + 46 + fsl,saif-master: 47 + description: Indicate that saif is a slave and its phandle points to master 48 + $ref: /schemas/types.yaml#/definitions/phandle 49 + 50 + required: 51 + - compatible 52 + - reg 53 + - "#sound-dai-cells" 54 + - interrupts 55 + - dmas 56 + - dma-names 57 + - clocks 58 + 59 + unevaluatedProperties: false 60 + 61 + examples: 62 + - | 63 + saif0: saif@80042000 { 64 + compatible = "fsl,imx28-saif"; 65 + reg = <0x80042000 2000>; 66 + #sound-dai-cells = <0>; 67 + interrupts = <59>; 68 + dmas = <&dma_apbx 4>; 69 + dma-names = "rx-tx"; 70 + #clock-cells = <0>; 71 + clocks = <&clks 53>; 72 + }; 73 + - | 74 + saif1: saif@80046000 { 75 + compatible = "fsl,imx28-saif"; 76 + reg = <0x80046000 2000>; 77 + #sound-dai-cells = <0>; 78 + interrupts = <58>; 79 + dmas = <&dma_apbx 5>; 80 + dma-names = "rx-tx"; 81 + clocks = <&clks 53>; 82 + fsl,saif-master = <&saif0>; 83 + };
-41
Documentation/devicetree/bindings/sound/mxs-saif.txt
··· 1 - * Freescale MXS Serial Audio Interface (SAIF) 2 - 3 - Required properties: 4 - - compatible: Should be "fsl,<chip>-saif" 5 - - reg: Should contain registers location and length 6 - - interrupts: Should contain ERROR interrupt number 7 - - dmas: DMA specifier, consisting of a phandle to DMA controller node 8 - and SAIF DMA channel ID. 9 - Refer to dma.txt and fsl-mxs-dma.txt for details. 10 - - dma-names: Must be "rx-tx". 11 - 12 - Optional properties: 13 - - fsl,saif-master: phandle to the master SAIF. It's only required for 14 - the slave SAIF. 15 - 16 - Note: Each SAIF controller should have an alias correctly numbered 17 - in "aliases" node. 18 - 19 - Example: 20 - 21 - aliases { 22 - saif0 = &saif0; 23 - saif1 = &saif1; 24 - }; 25 - 26 - saif0: saif@80042000 { 27 - compatible = "fsl,imx28-saif"; 28 - reg = <0x80042000 2000>; 29 - interrupts = <59>; 30 - dmas = <&dma_apbx 4>; 31 - dma-names = "rx-tx"; 32 - }; 33 - 34 - saif1: saif@80046000 { 35 - compatible = "fsl,imx28-saif"; 36 - reg = <0x80046000 2000>; 37 - interrupts = <58>; 38 - dmas = <&dma_apbx 5>; 39 - dma-names = "rx-tx"; 40 - fsl,saif-master = <&saif0>; 41 - };