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

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/sound/rockchip-spdif.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Rockchip SPDIF transceiver
   8
   9 description:
  10   The S/PDIF audio block is a stereo transceiver that allows the
  11   processor to receive and transmit digital audio via a coaxial or
  12   fibre cable.
  13
  14 maintainers:
  15   - Heiko Stuebner <heiko@sntech.de>
  16
  17 properties:
  18   compatible:
  19     oneOf:
  20       - const: rockchip,rk3066-spdif
  21       - const: rockchip,rk3228-spdif
  22       - const: rockchip,rk3328-spdif
  23       - const: rockchip,rk3366-spdif
  24       - const: rockchip,rk3368-spdif
  25       - const: rockchip,rk3399-spdif
  26       - const: rockchip,rk3568-spdif
  27       - items:
  28           - enum:
  29               - rockchip,rk3188-spdif
  30               - rockchip,rk3288-spdif
  31               - rockchip,rk3308-spdif
  32           - const: rockchip,rk3066-spdif
  33
  34   reg:
  35     maxItems: 1
  36
  37   interrupts:
  38     maxItems: 1
  39
  40   clocks:
  41     items:
  42       - description: clock for SPDIF bus
  43       - description: clock for SPDIF controller
  44
  45   clock-names:
  46     items:
  47       - const: mclk
  48       - const: hclk
  49
  50   dmas:
  51     maxItems: 1
  52
  53   dma-names:
  54     const: tx
  55
  56   power-domains:
  57     maxItems: 1
  58
  59   rockchip,grf:
  60     $ref: /schemas/types.yaml#/definitions/phandle
  61     description:
  62       The phandle of the syscon node for the GRF register.
  63       Required property on RK3288.
  64
  65   "#sound-dai-cells":
  66     const: 0
  67
  68 required:
  69   - compatible
  70   - reg
  71   - interrupts
  72   - clocks
  73   - clock-names
  74   - dmas
  75   - dma-names
  76   - "#sound-dai-cells"
  77
  78 allOf:
  79   - $ref: dai-common.yaml#
  80   - if:
  81       properties:
  82         compatible:
  83           contains:
  84             const: rockchip,rk3288-spdif
  85     then:
  86       required:
  87         - rockchip,grf
  88
  89 unevaluatedProperties: false
  90
  91 examples:
  92   - |
  93     #include <dt-bindings/clock/rk3188-cru.h>
  94     #include <dt-bindings/interrupt-controller/arm-gic.h>
  95     spdif: spdif@1011e000 {
  96       compatible = "rockchip,rk3188-spdif", "rockchip,rk3066-spdif";
  97       reg = <0x1011e000 0x2000>;
  98       interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>;
  99       clocks = <&cru SCLK_SPDIF>, <&cru HCLK_SPDIF>;
 100       clock-names = "mclk", "hclk";
 101       dmas = <&dmac1_s 8>;
 102       dma-names = "tx";
 103       #sound-dai-cells = <0>;
 104     };