^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) %YAML 1.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ---
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) $id: http://devicetree.org/schemas/ata/sata-common.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) $schema: http://devicetree.org/meta-schemas/core.yaml#
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) title: Common Properties for Serial AT attachment (SATA) controllers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) maintainers:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) - Linus Walleij <linus.walleij@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) description: |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) This document defines device tree properties common to most Serial
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) AT attachment (SATA) storage devices. It doesn't constitute a device tree
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) binding specification by itself but is meant to be referenced by device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) tree bindings.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) The SATA controller-specific device tree bindings are responsible for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) defining whether each property is required or optional.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) $nodename:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) pattern: "^sata(@.*)?$"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Specifies the host controller node. SATA host controller nodes are named
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) "sata"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) "#address-cells":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) const: 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) "#size-cells":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) const: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) patternProperties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) "^sata-port@[0-9a-e]$":
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) description: |
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) DT nodes for ports connected on the SATA host. The SATA port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) nodes will be named "sata-port".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) type: object
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) properties:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) reg:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) minimum: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) maximum: 14
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) The ID number of the drive port SATA can potentially use a port
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) multiplier making it possible to connect up to 15 disks to a single
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) SATA port.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) additionalProperties: true
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) ...