baikal,bt1-ahci.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/baikal,bt1-ahci.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Baikal-T1 SoC AHCI SATA controller
  8
  9maintainers:
 10  - Serge Semin <fancer.lancer@gmail.com>
 11
 12description:
 13  AHCI SATA controller embedded into the Baikal-T1 SoC is based on the
 14  DWC AHCI SATA v4.10a IP-core.
 15
 16allOf:
 17  - $ref: snps,dwc-ahci-common.yaml#
 18
 19properties:
 20  compatible:
 21    const: baikal,bt1-ahci
 22
 23  clocks:
 24    items:
 25      - description: Peripheral APB bus clock
 26      - description: Application AXI BIU clock
 27      - description: SATA Ports reference clock
 28
 29  clock-names:
 30    items:
 31      - const: pclk
 32      - const: aclk
 33      - const: ref
 34
 35  resets:
 36    items:
 37      - description: Application AXI BIU domain reset
 38      - description: SATA Ports clock domain reset
 39
 40  reset-names:
 41    items:
 42      - const: arst
 43      - const: ref
 44
 45  ports-implemented:
 46    maximum: 0x3
 47
 48patternProperties:
 49  "^sata-port@[0-1]$":
 50    $ref: /schemas/ata/snps,dwc-ahci-common.yaml#/$defs/dwc-ahci-port
 51
 52    properties:
 53      reg:
 54        minimum: 0
 55        maximum: 1
 56
 57      snps,tx-ts-max:
 58        $ref: /schemas/types.yaml#/definitions/uint32
 59        description:
 60          Due to having AXI3 bus interface utilized the maximum Tx DMA
 61          transaction size can't exceed 16 beats (AxLEN[3:0]).
 62        enum: [ 1, 2, 4, 8, 16 ]
 63
 64      snps,rx-ts-max:
 65        $ref: /schemas/types.yaml#/definitions/uint32
 66        description:
 67          Due to having AXI3 bus interface utilized the maximum Rx DMA
 68          transaction size can't exceed 16 beats (AxLEN[3:0]).
 69        enum: [ 1, 2, 4, 8, 16 ]
 70
 71    unevaluatedProperties: false
 72
 73required:
 74  - compatible
 75  - reg
 76  - interrupts
 77  - clocks
 78  - clock-names
 79  - resets
 80
 81unevaluatedProperties: false
 82
 83examples:
 84  - |
 85    sata@1f050000 {
 86      compatible = "baikal,bt1-ahci";
 87      reg = <0x1f050000 0x2000>;
 88      #address-cells = <1>;
 89      #size-cells = <0>;
 90
 91      interrupts = <0 64 4>;
 92
 93      clocks = <&ccu_sys 1>, <&ccu_axi 2>, <&sata_ref_clk>;
 94      clock-names = "pclk", "aclk", "ref";
 95
 96      resets = <&ccu_axi 2>, <&ccu_sys 0>;
 97      reset-names = "arst", "ref";
 98
 99      ports-implemented = <0x3>;
100
101      sata-port@0 {
102        reg = <0>;
103
104        snps,tx-ts-max = <4>;
105        snps,rx-ts-max = <4>;
106      };
107
108      sata-port@1 {
109        reg = <1>;
110
111        snps,tx-ts-max = <4>;
112        snps,rx-ts-max = <4>;
113      };
114    };
115...