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: davinci-mcbsp: convert McBSP bindings to yaml schema

Convert the binding for McBSP controllers for TI SoCs from txt
to YAML schema.

Add properties 'clocks', 'clock-names', 'power-domains' and
'#sound-dai-cells' which were missing from the txt file.
Add '#sound-dai-cells' and 'clocks' in the example which were missing
from the txt file.

Signed-off-by: Bastien Curutchet <bastien.curutchet@bootlin.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Acked-by: Peter Ujfalusi <peter.ujfalusi@gmail.com>
Link: https://msgid.link/r/20240402071213.11671-2-bastien.curutchet@bootlin.com
Signed-off-by: Mark Brown <broonie@kernel.org>

authored by

Bastien Curutchet and committed by
Mark Brown 22a1dd65 9cb83ed1

+95 -50
-50
Documentation/devicetree/bindings/sound/davinci-mcbsp.txt
··· 1 - Texas Instruments DaVinci McBSP module 2 - ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 3 - 4 - This binding describes the "Multi-channel Buffered Serial Port" (McBSP) 5 - audio interface found in some TI DaVinci processors like the OMAP-L138 or AM180x. 6 - 7 - 8 - Required properties: 9 - ~~~~~~~~~~~~~~~~~~~~ 10 - - compatible : 11 - "ti,da850-mcbsp" : for DA850, AM180x and OPAM-L138 platforms 12 - 13 - - reg : physical base address and length of the controller memory mapped 14 - region(s). 15 - - reg-names : Should contain: 16 - * "mpu" for the main registers (required). 17 - * "dat" for the data FIFO (optional). 18 - 19 - - dmas: three element list of DMA controller phandles, DMA request line and 20 - TC channel ordered triplets. 21 - - dma-names: identifier string for each DMA request line in the dmas property. 22 - These strings correspond 1:1 with the ordered pairs in dmas. The dma 23 - identifiers must be "rx" and "tx". 24 - 25 - Optional properties: 26 - ~~~~~~~~~~~~~~~~~~~~ 27 - - interrupts : Interrupt numbers for McBSP 28 - - interrupt-names : Known interrupt names are "rx" and "tx" 29 - 30 - - pinctrl-0: Should specify pin control group used for this controller. 31 - - pinctrl-names: Should contain only one value - "default", for more details 32 - please refer to pinctrl-bindings.txt 33 - 34 - Example (AM1808): 35 - ~~~~~~~~~~~~~~~~~ 36 - 37 - mcbsp0: mcbsp@1d10000 { 38 - compatible = "ti,da850-mcbsp"; 39 - pinctrl-names = "default"; 40 - pinctrl-0 = <&mcbsp0_pins>; 41 - 42 - reg = <0x00110000 0x1000>, 43 - <0x00310000 0x1000>; 44 - reg-names = "mpu", "dat"; 45 - interrupts = <97 98>; 46 - interrupt-names = "rx", "tx"; 47 - dmas = <&edma0 3 1 48 - &edma0 2 1>; 49 - dma-names = "tx", "rx"; 50 - };
+95
Documentation/devicetree/bindings/sound/davinci-mcbsp.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/davinci-mcbsp.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: McBSP Controller for TI SoCs 8 + 9 + maintainers: 10 + - Bastien Curutchet <bastien.curutchet@bootlin.com> 11 + 12 + allOf: 13 + - $ref: dai-common.yaml# 14 + 15 + properties: 16 + compatible: 17 + enum: 18 + - ti,da850-mcbsp 19 + 20 + reg: 21 + minItems: 1 22 + items: 23 + - description: CFG registers 24 + - description: data registers 25 + 26 + reg-names: 27 + minItems: 1 28 + items: 29 + - const: mpu 30 + - const: dat 31 + 32 + dmas: 33 + items: 34 + - description: transmission DMA channel 35 + - description: reception DMA channel 36 + 37 + dma-names: 38 + items: 39 + - const: tx 40 + - const: rx 41 + 42 + interrupts: 43 + items: 44 + - description: RX interrupt 45 + - description: TX interrupt 46 + 47 + interrupt-names: 48 + items: 49 + - const: rx 50 + - const: tx 51 + 52 + clocks: 53 + items: 54 + - description: functional clock 55 + 56 + clock-names: 57 + items: 58 + - const: fck 59 + 60 + power-domains: 61 + maxItems: 1 62 + 63 + "#sound-dai-cells": 64 + const: 0 65 + 66 + required: 67 + - "#sound-dai-cells" 68 + - compatible 69 + - reg 70 + - reg-names 71 + - dmas 72 + - dma-names 73 + - clocks 74 + 75 + unevaluatedProperties: false 76 + 77 + examples: 78 + - | 79 + mcbsp0@1d10000 { 80 + #sound-dai-cells = <0>; 81 + compatible = "ti,da850-mcbsp"; 82 + pinctrl-names = "default"; 83 + pinctrl-0 = <&mcbsp0_pins>; 84 + 85 + reg = <0x111000 0x1000>, 86 + <0x311000 0x1000>; 87 + reg-names = "mpu", "dat"; 88 + interrupts = <97>, <98>; 89 + interrupt-names = "rx", "tx"; 90 + dmas = <&edma0 3 1>, 91 + <&edma0 2 1>; 92 + dma-names = "tx", "rx"; 93 + 94 + clocks = <&psc1 14>; 95 + };