Documentation/devicetree/bindings/sound/rockchip-i2s.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/sound/rockchip-i2s.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Rockchip I2S controller
   8
   9 description:
  10   The I2S bus (Inter-IC sound bus) is a serial link for digital
  11   audio data transfer between devices in the system.
  12
  13 maintainers:
  14   - Heiko Stuebner <heiko@sntech.de>
  15
  16 properties:
  17   compatible:
  18     oneOf:
  19       - const: rockchip,rk3066-i2s
  20       - items:
  21           - enum:
  22             - rockchip,px30-i2s
  23             - rockchip,rk3036-i2s
  24             - rockchip,rk3188-i2s
  25             - rockchip,rk3228-i2s
  26             - rockchip,rk3288-i2s
  27             - rockchip,rk3328-i2s
  28             - rockchip,rk3366-i2s
  29             - rockchip,rk3368-i2s
  30             - rockchip,rk3399-i2s
  31           - const: rockchip,rk3066-i2s
  32
  33   reg:
  34     maxItems: 1
  35
  36   interrupts:
  37     maxItems: 1
  38
  39   clocks:
  40     items:
  41       - description: clock for I2S controller
  42       - description: clock for I2S BUS
  43
  44   clock-names:
  45     items:
  46       - const: i2s_clk
  47       - const: i2s_hclk
  48
  49   dmas:
  50     items:
  51       - description: TX DMA Channel
  52       - description: RX DMA Channel
  53
  54   dma-names:
  55     items:
  56       - const: tx
  57       - const: rx
  58
  59   rockchip,capture-channels:
  60     allOf:
  61       - $ref: /schemas/types.yaml#/definitions/uint32
  62     default: 2
  63     description:
  64       Max capture channels, if not set, 2 channels default.
  65
  66   rockchip,playback-channels:
  67     allOf:
  68       - $ref: /schemas/types.yaml#/definitions/uint32
  69     default: 8
  70     description:
  71       Max playback channels, if not set, 8 channels default.
  72
  73   rockchip,grf:
  74     $ref: /schemas/types.yaml#/definitions/phandle
  75     description:
  76       The phandle of the syscon node for the GRF register.
  77       Required property for controllers which support multi channel
  78       playback/capture.
  79
  80   "#sound-dai-cells":
  81     const: 0
  82
  83 required:
  84   - compatible
  85   - reg
  86   - interrupts
  87   - clocks
  88   - clock-names
  89   - dmas
  90   - dma-names
  91   - "#sound-dai-cells"
  92
  93 additionalProperties: false
  94
  95 examples:
  96   - |
  97     #include <dt-bindings/clock/rk3288-cru.h>
  98     #include <dt-bindings/interrupt-controller/arm-gic.h>
  99     #include <dt-bindings/interrupt-controller/irq.h>
 100     i2s@ff890000 {
 101       compatible = "rockchip,rk3288-i2s", "rockchip,rk3066-i2s";
 102       reg = <0xff890000 0x10000>;
 103       interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;
 104       clocks = <&cru SCLK_I2S0>, <&cru HCLK_I2S0>;
 105       clock-names = "i2s_clk", "i2s_hclk";
 106       dmas = <&pdma1 0>, <&pdma1 1>;
 107       dma-names = "tx", "rx";
 108       rockchip,capture-channels = <2>;
 109       rockchip,playback-channels = <8>;
 110       #sound-dai-cells = <0>;
 111     };