162306a36Sopenharmony_ci# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
262306a36Sopenharmony_ci%YAML 1.2
362306a36Sopenharmony_ci---
462306a36Sopenharmony_ci$id: http://devicetree.org/schemas/ata/sata-common.yaml#
562306a36Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
662306a36Sopenharmony_ci
762306a36Sopenharmony_cititle: Common Properties for Serial AT attachment (SATA) controllers
862306a36Sopenharmony_ci
962306a36Sopenharmony_cimaintainers:
1062306a36Sopenharmony_ci  - Linus Walleij <linus.walleij@linaro.org>
1162306a36Sopenharmony_ci
1262306a36Sopenharmony_cidescription: |
1362306a36Sopenharmony_ci  This document defines device tree properties common to most Serial
1462306a36Sopenharmony_ci  AT attachment (SATA) storage devices. It doesn't constitute a device tree
1562306a36Sopenharmony_ci  binding specification by itself but is meant to be referenced by device
1662306a36Sopenharmony_ci  tree bindings.
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ci  The SATA controller-specific device tree bindings are responsible for
1962306a36Sopenharmony_ci  defining whether each property is required or optional.
2062306a36Sopenharmony_ci
2162306a36Sopenharmony_ciproperties:
2262306a36Sopenharmony_ci  $nodename:
2362306a36Sopenharmony_ci    pattern: "^sata(@.*)?$"
2462306a36Sopenharmony_ci    description:
2562306a36Sopenharmony_ci      Specifies the host controller node. SATA host controller nodes are named
2662306a36Sopenharmony_ci      "sata"
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci  "#address-cells":
2962306a36Sopenharmony_ci    const: 1
3062306a36Sopenharmony_ci
3162306a36Sopenharmony_ci  "#size-cells":
3262306a36Sopenharmony_ci    const: 0
3362306a36Sopenharmony_ci
3462306a36Sopenharmony_ci  dma-coherent: true
3562306a36Sopenharmony_ci
3662306a36Sopenharmony_cipatternProperties:
3762306a36Sopenharmony_ci  "^sata-port@[0-9a-e]$":
3862306a36Sopenharmony_ci    $ref: '#/$defs/sata-port'
3962306a36Sopenharmony_ci    description: |
4062306a36Sopenharmony_ci      DT nodes for ports connected on the SATA host. The SATA port
4162306a36Sopenharmony_ci      nodes will be named "sata-port".
4262306a36Sopenharmony_ci
4362306a36Sopenharmony_ciadditionalProperties: true
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ci$defs:
4662306a36Sopenharmony_ci  sata-port:
4762306a36Sopenharmony_ci    type: object
4862306a36Sopenharmony_ci
4962306a36Sopenharmony_ci    properties:
5062306a36Sopenharmony_ci      reg:
5162306a36Sopenharmony_ci        minimum: 0
5262306a36Sopenharmony_ci        description:
5362306a36Sopenharmony_ci          The ID number of the SATA port. Aside with being directly used,
5462306a36Sopenharmony_ci          each port can have a Port Multiplier attached thus allowing to
5562306a36Sopenharmony_ci          access more than one drive by means of a single SATA port.
5662306a36Sopenharmony_ci
5762306a36Sopenharmony_ci...
58