Documentation/devicetree/bindings/ata/faraday,ftide010.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/ata/faraday,ftide010.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Faraday Technology FTIDE010 PATA controller
   8
   9 maintainers:
  10   - Linus Walleij <linus.walleij@linaro.org>
  11
  12 description: |
  13   This controller is the first Faraday IDE interface block, used in the
  14   StorLink SL3512 and SL3516, later known as the Cortina Systems Gemini
  15   platform. The controller can do PIO modes 0 through 4, Multi-word DMA
  16   (MWDM) modes 0 through 2 and Ultra DMA modes 0 through 6.
  17
  18   On the Gemini platform, this PATA block is accompanied by a PATA to
  19   SATA bridge in order to support SATA. This is why a phandle to that
  20   controller is compulsory on that platform.
  21
  22   The timing properties are unique per-SoC, not per-board.
  23
  24 properties:
  25   compatible:
  26     oneOf:
  27       - const: faraday,ftide010
  28       - items:
  29         - const: cortina,gemini-pata
  30         - const: faraday,ftide010
  31
  32   reg:
  33     maxItems: 1
  34
  35   interrupts:
  36     maxItems: 1
  37
  38   clocks:
  39     minItems: 1
  40
  41   clock-names:
  42     const: PCLK
  43
  44   sata:
  45     description:
  46       phandle to the Gemini PATA to SATA bridge, if available
  47     $ref: /schemas/types.yaml#/definitions/phandle
  48
  49 required:
  50   - compatible
  51   - reg
  52   - interrupts
  53
  54 allOf:
  55   - $ref: pata-common.yaml#
  56
  57   - if:
  58       properties:
  59         compatible:
  60           contains:
  61             const: cortina,gemini-pata
  62
  63     then:
  64       required:
  65         - sata
  66
  67 examples:
  68   - |
  69     #include <dt-bindings/interrupt-controller/irq.h>
  70     #include <dt-bindings/clock/cortina,gemini-clock.h>
  71
  72     ide@63000000 {
  73       compatible = "cortina,gemini-pata", "faraday,ftide010";
  74       reg = <0x63000000 0x100>;
  75       interrupts = <4 IRQ_TYPE_EDGE_RISING>;
  76       clocks = <&gcc GEMINI_CLK_GATE_IDE>;
  77       clock-names = "PCLK";
  78       sata = <&sata>;
  79       #address-cells = <1>;
  80       #size-cells = <0>;
  81       ide-port@0 {
  82         reg = <0>;
  83       };
  84       ide-port@1 {
  85         reg = <1>;
  86       };
  87     };
  88
  89 ...