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