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: hisilicon: Convert hi6210 I2S to dt-schema

Convert the Hisilicon hi6210 I2S controller hardware binding from
legacy plain text to modern YAML dt-schema format.

During the conversion, the order of the dma-names properties in the
example was corrected to "tx", "rx" to match the official property
description, resolving a contradiction in the original text binding.

Signed-off-by: Chaitanya Sabnis <chaitanya.msabnis@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20260327092106.4233-1-chaitanya.msabnis@gmail.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Chaitanya Sabnis and committed by
Mark Brown f4ee8a88 9a52d1b7

+80 -42
-42
Documentation/devicetree/bindings/sound/hisilicon,hi6210-i2s.txt
··· 1 - * Hisilicon 6210 i2s controller 2 - 3 - Required properties: 4 - 5 - - compatible: should be one of the following: 6 - - "hisilicon,hi6210-i2s" 7 - - reg: physical base address of the i2s controller unit and length of 8 - memory mapped region. 9 - - interrupts: should contain the i2s interrupt. 10 - - clocks: a list of phandle + clock-specifier pairs, one for each entry 11 - in clock-names. 12 - - clock-names: should contain following: 13 - - "dacodec" 14 - - "i2s-base" 15 - - dmas: DMA specifiers for tx dma. See the DMA client binding, 16 - Documentation/devicetree/bindings/dma/dma.txt 17 - - dma-names: should be "tx" and "rx" 18 - - hisilicon,sysctrl-syscon: phandle to sysctrl syscon 19 - - #sound-dai-cells: Should be set to 1 (for multi-dai) 20 - - The dai cell indexes reference the following interfaces: 21 - 0: S2 interface 22 - (Currently that is the only one available, but more may be 23 - supported in the future) 24 - 25 - Example for the hi6210 i2s controller: 26 - 27 - i2s0: i2s@f7118000{ 28 - compatible = "hisilicon,hi6210-i2s"; 29 - reg = <0x0 0xf7118000 0x0 0x8000>; /* i2s unit */ 30 - interrupts = <GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH>; /* 155 "DigACodec_intr"-32 */ 31 - clocks = <&sys_ctrl HI6220_DACODEC_PCLK>, 32 - <&sys_ctrl HI6220_BBPPLL0_DIV>; 33 - clock-names = "dacodec", "i2s-base"; 34 - dmas = <&dma0 15 &dma0 14>; 35 - dma-names = "rx", "tx"; 36 - hisilicon,sysctrl-syscon = <&sys_ctrl>; 37 - #sound-dai-cells = <1>; 38 - }; 39 - 40 - Then when referencing the i2s controller: 41 - sound-dai = <&i2s0 0>; /* index 0 => S2 interface */ 42 -
+80
Documentation/devicetree/bindings/sound/hisilicon,hi6210-i2s.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/hisilicon,hi6210-i2s.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: HiSilicon hi6210 I2S controller 8 + 9 + maintainers: 10 + - John Stultz <john.stultz@linaro.org> 11 + 12 + allOf: 13 + - $ref: dai-common.yaml# 14 + 15 + properties: 16 + compatible: 17 + const: hisilicon,hi6210-i2s 18 + 19 + reg: 20 + maxItems: 1 21 + 22 + interrupts: 23 + maxItems: 1 24 + 25 + clocks: 26 + maxItems: 2 27 + 28 + clock-names: 29 + items: 30 + - const: dacodec 31 + - const: i2s-base 32 + 33 + dmas: 34 + maxItems: 2 35 + 36 + dma-names: 37 + items: 38 + - const: tx 39 + - const: rx 40 + 41 + hisilicon,sysctrl-syscon: 42 + $ref: /schemas/types.yaml#/definitions/phandle 43 + description: phandle to sysctrl syscon 44 + 45 + "#sound-dai-cells": 46 + const: 1 47 + description: | 48 + The dai cell indexes reference the following interfaces: 49 + 0: S2 interface 50 + 51 + required: 52 + - compatible 53 + - reg 54 + - interrupts 55 + - clocks 56 + - clock-names 57 + - dmas 58 + - dma-names 59 + - hisilicon,sysctrl-syscon 60 + - "#sound-dai-cells" 61 + 62 + unevaluatedProperties: false 63 + 64 + examples: 65 + - | 66 + #include <dt-bindings/interrupt-controller/arm-gic.h> 67 + #include <dt-bindings/clock/hi6220-clock.h> 68 + 69 + i2s@f7118000 { 70 + compatible = "hisilicon,hi6210-i2s"; 71 + reg = <0xf7118000 0x8000>; 72 + interrupts = <GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH>; 73 + clocks = <&sys_ctrl HI6220_DACODEC_PCLK>, 74 + <&sys_ctrl HI6220_BBPPLL0_DIV>; 75 + clock-names = "dacodec", "i2s-base"; 76 + dmas = <&dma0 14>, <&dma0 15>; 77 + dma-names = "tx", "rx"; 78 + hisilicon,sysctrl-syscon = <&sys_ctrl>; 79 + #sound-dai-cells = <1>; 80 + };