18c2ecf20Sopenharmony_ci# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
28c2ecf20Sopenharmony_ci%YAML 1.2
38c2ecf20Sopenharmony_ci---
48c2ecf20Sopenharmony_ci$id: http://devicetree.org/schemas/ata/sata-common.yaml#
58c2ecf20Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_cititle: Common Properties for Serial AT attachment (SATA) controllers
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_cimaintainers:
108c2ecf20Sopenharmony_ci  - Linus Walleij <linus.walleij@linaro.org>
118c2ecf20Sopenharmony_ci
128c2ecf20Sopenharmony_cidescription: |
138c2ecf20Sopenharmony_ci  This document defines device tree properties common to most Serial
148c2ecf20Sopenharmony_ci  AT attachment (SATA) storage devices. It doesn't constitute a device tree
158c2ecf20Sopenharmony_ci  binding specification by itself but is meant to be referenced by device
168c2ecf20Sopenharmony_ci  tree bindings.
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci  The SATA controller-specific device tree bindings are responsible for
198c2ecf20Sopenharmony_ci  defining whether each property is required or optional.
208c2ecf20Sopenharmony_ci
218c2ecf20Sopenharmony_ciproperties:
228c2ecf20Sopenharmony_ci  $nodename:
238c2ecf20Sopenharmony_ci    pattern: "^sata(@.*)?$"
248c2ecf20Sopenharmony_ci    description:
258c2ecf20Sopenharmony_ci      Specifies the host controller node. SATA host controller nodes are named
268c2ecf20Sopenharmony_ci      "sata"
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci  "#address-cells":
298c2ecf20Sopenharmony_ci    const: 1
308c2ecf20Sopenharmony_ci
318c2ecf20Sopenharmony_ci  "#size-cells":
328c2ecf20Sopenharmony_ci    const: 0
338c2ecf20Sopenharmony_ci
348c2ecf20Sopenharmony_cipatternProperties:
358c2ecf20Sopenharmony_ci  "^sata-port@[0-9a-e]$":
368c2ecf20Sopenharmony_ci    description: |
378c2ecf20Sopenharmony_ci      DT nodes for ports connected on the SATA host. The SATA port
388c2ecf20Sopenharmony_ci      nodes will be named "sata-port".
398c2ecf20Sopenharmony_ci    type: object
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ci    properties:
428c2ecf20Sopenharmony_ci      reg:
438c2ecf20Sopenharmony_ci        minimum: 0
448c2ecf20Sopenharmony_ci        maximum: 14
458c2ecf20Sopenharmony_ci        description:
468c2ecf20Sopenharmony_ci          The ID number of the drive port SATA can potentially use a port
478c2ecf20Sopenharmony_ci          multiplier making it possible to connect up to 15 disks to a single
488c2ecf20Sopenharmony_ci          SATA port.
498c2ecf20Sopenharmony_ci
508c2ecf20Sopenharmony_ciadditionalProperties: true
518c2ecf20Sopenharmony_ci
528c2ecf20Sopenharmony_ci...
53