Documentation/devicetree/bindings/reset/socionext,uniphier-glue-reset.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/reset/socionext,uniphier-glue-reset.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Socionext UniPhier peripheral core reset in glue layer
   8
   9 description: |
  10   Some peripheral core reset belongs to its own glue layer. Before using
  11   this core reset, it is necessary to control the clocks and resets to
  12   enable this layer. These clocks and resets should be described in each
  13   property.
  14
  15 maintainers:
  16   - Kunihiko Hayashi <hayashi.kunihiko@socionext.com>
  17
  18 properties:
  19   compatible:
  20     enum:
  21       - socionext,uniphier-pro4-usb3-reset
  22       - socionext,uniphier-pro5-usb3-reset
  23       - socionext,uniphier-pxs2-usb3-reset
  24       - socionext,uniphier-ld20-usb3-reset
  25       - socionext,uniphier-pxs3-usb3-reset
  26       - socionext,uniphier-pro4-ahci-reset
  27       - socionext,uniphier-pxs2-ahci-reset
  28       - socionext,uniphier-pxs3-ahci-reset
  29
  30   reg:
  31     maxItems: 1
  32
  33   "#reset-cells":
  34     const: 1
  35
  36   clocks:
  37     minItems: 1
  38     maxItems: 2
  39
  40   clock-names:
  41     oneOf:
  42       - items:           # for Pro4, Pro5
  43           - const: gio
  44           - const: link
  45       - items:           # for others
  46           - const: link
  47
  48   resets:
  49     minItems: 1
  50     maxItems: 2
  51
  52   reset-names:
  53     oneOf:
  54       - items:           # for Pro4, Pro5
  55           - const: gio
  56           - const: link
  57       - items:           # for others
  58           - const: link
  59
  60 additionalProperties: false
  61
  62 required:
  63   - compatible
  64   - reg
  65   - "#reset-cells"
  66   - clocks
  67   - clock-names
  68   - resets
  69   - reset-names
  70
  71 examples:
  72   - |
  73     usb-glue@65b00000 {
  74         compatible = "simple-mfd";
  75         #address-cells = <1>;
  76         #size-cells = <1>;
  77         ranges = <0 0x65b00000 0x400>;
  78
  79         usb_rst: reset@0 {
  80             compatible = "socionext,uniphier-ld20-usb3-reset";
  81             reg = <0x0 0x4>;
  82             #reset-cells = <1>;
  83             clock-names = "link";
  84             clocks = <&sys_clk 14>;
  85             reset-names = "link";
  86             resets = <&sys_rst 14>;
  87         };
  88     };