1 # SPDX-License-Identifier: (GPL-2.0-only OR BS
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/ata/ahci-co
5 $schema: http://devicetree.org/meta-schemas/co
6
7 title: Common Properties for Serial ATA AHCI c
8
9 maintainers:
10 - Hans de Goede <hdegoede@redhat.com>
11 - Damien Le Moal <dlemoal@kernel.org>
12
13 description:
14 This document defines device tree properties
15 controller implementation. It's hardware int
16 conform to the technical standard defined by
17 Advanced Host Controller Interface specifica
18 document doesn't constitute a DT-node bindin
19 defines a set of common properties for the A
20
21 select: false
22
23 allOf:
24 - $ref: sata-common.yaml#
25
26 properties:
27 reg:
28 description:
29 Generic AHCI registers space conforming
30 specification.
31
32 reg-names:
33 description: CSR space IDs
34 contains:
35 const: ahci
36
37 interrupts:
38 description:
39 Generic AHCI state change interrupt. Can
40 single line attached to the controller o
41 indicating the particular port events.
42 minItems: 1
43 maxItems: 32
44
45 ahci-supply:
46 description: Power regulator for AHCI cont
47
48 target-supply:
49 description: Power regulator for SATA targ
50
51 phy-supply:
52 description: Power regulator for SATA PHY
53
54 phys:
55 description: Reference to the SATA PHY nod
56 maxItems: 1
57
58 phy-names:
59 const: sata-phy
60
61 hba-cap:
62 $ref: /schemas/types.yaml#/definitions/uin
63 description:
64 Bitfield of the HBA generic platform cap
65 Spin-up or Mechanical Presence Switch su
66 appropriately initialize the HWinit fiel
67 in case if the system firmware hasn't do
68
69 ports-implemented:
70 $ref: /schemas/types.yaml#/definitions/uin
71 description:
72 Mask that indicates which ports the HBA
73 programmed by the BIOS, which is true fo
74
75 patternProperties:
76 "^sata-port@[0-9a-f]+$":
77 $ref: '#/$defs/ahci-port'
78 description:
79 It is optionally possible to describe th
80 to enable each port independently when d
81
82 required:
83 - reg
84 - interrupts
85
86 additionalProperties: true
87
88 $defs:
89 ahci-port:
90 $ref: /schemas/ata/sata-common.yaml#/$defs
91
92 properties:
93 reg:
94 description:
95 AHCI SATA port identifier. By design
96 more than 32 ports due to the CAP.NP
97 constraints.
98 minimum: 0
99 maximum: 31
100
101 phys:
102 description: Individual AHCI SATA port
103 maxItems: 1
104
105 phy-names:
106 description: AHCI SATA port PHY ID
107 const: sata-phy
108
109 target-supply:
110 description: Power regulator for SATA
111
112 hba-port-cap:
113 $ref: /schemas/types.yaml#/definitions
114 description:
115 Bitfield of the HBA port-specific pl
116 plugging, eSATA, FIS-based Switching
117 for details). It can be used to init
118 the PxCMD register in case if the sy
119
120 required:
121 - reg
122
123 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.