3d21a46093
json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. The json-schema library doesn't yet support this, but the tooling now does a fixup for this and either way works. This has been a constant source of review comments, so let's change this treewide so everyone copies the simpler syntax. Scripted with ruamel.yaml with some manual fixups. Some minor whitespace changes from the script. Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Maxime Ripard <mripard@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Wolfram Sang <wsa@the-dreams.de> # for I2C Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for-iio Reviewed-by: Stephen Boyd <sboyd@kernel.org> # clock Signed-off-by: Rob Herring <robh@kernel.org>
110 lines
2.5 KiB
YAML
110 lines
2.5 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/sound/rockchip-i2s.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Rockchip I2S controller
|
|
|
|
description:
|
|
The I2S bus (Inter-IC sound bus) is a serial link for digital
|
|
audio data transfer between devices in the system.
|
|
|
|
maintainers:
|
|
- Heiko Stuebner <heiko@sntech.de>
|
|
|
|
properties:
|
|
compatible:
|
|
oneOf:
|
|
- const: rockchip,rk3066-i2s
|
|
- items:
|
|
- enum:
|
|
- rockchip,px30-i2s
|
|
- rockchip,rk3036-i2s
|
|
- rockchip,rk3188-i2s
|
|
- rockchip,rk3228-i2s
|
|
- rockchip,rk3288-i2s
|
|
- rockchip,rk3328-i2s
|
|
- rockchip,rk3366-i2s
|
|
- rockchip,rk3368-i2s
|
|
- rockchip,rk3399-i2s
|
|
- const: rockchip,rk3066-i2s
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
items:
|
|
- description: clock for I2S controller
|
|
- description: clock for I2S BUS
|
|
|
|
clock-names:
|
|
items:
|
|
- const: i2s_clk
|
|
- const: i2s_hclk
|
|
|
|
dmas:
|
|
items:
|
|
- description: TX DMA Channel
|
|
- description: RX DMA Channel
|
|
|
|
dma-names:
|
|
items:
|
|
- const: tx
|
|
- const: rx
|
|
|
|
rockchip,capture-channels:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
default: 2
|
|
description:
|
|
Max capture channels, if not set, 2 channels default.
|
|
|
|
rockchip,playback-channels:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
default: 8
|
|
description:
|
|
Max playback channels, if not set, 8 channels default.
|
|
|
|
rockchip,grf:
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
description:
|
|
The phandle of the syscon node for the GRF register.
|
|
Required property for controllers which support multi channel
|
|
playback/capture.
|
|
|
|
"#sound-dai-cells":
|
|
const: 0
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupts
|
|
- clocks
|
|
- clock-names
|
|
- dmas
|
|
- dma-names
|
|
- "#sound-dai-cells"
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/clock/rk3288-cru.h>
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
|
i2s@ff890000 {
|
|
compatible = "rockchip,rk3288-i2s", "rockchip,rk3066-i2s";
|
|
reg = <0xff890000 0x10000>;
|
|
interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;
|
|
clocks = <&cru SCLK_I2S0>, <&cru HCLK_I2S0>;
|
|
clock-names = "i2s_clk", "i2s_hclk";
|
|
dmas = <&pdma1 0>, <&pdma1 1>;
|
|
dma-names = "tx", "rx";
|
|
rockchip,capture-channels = <2>;
|
|
rockchip,playback-channels = <8>;
|
|
#sound-dai-cells = <0>;
|
|
};
|