xref: /freebsd/sys/contrib/device-tree/Bindings/ata/sata_highbank.yaml (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/ata/sata_highbank.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Calxeda AHCI SATA Controller
8
9description: |
10  The Calxeda SATA controller mostly conforms to the AHCI interface
11  with some special extensions to add functionality, to map GPIOs for
12  activity LEDs and for mapping the ComboPHYs.
13
14maintainers:
15  - Andre Przywara <andre.przywara@arm.com>
16
17properties:
18  compatible:
19    const: calxeda,hb-ahci
20
21  reg:
22    maxItems: 1
23
24  interrupts:
25    maxItems: 1
26
27  dma-coherent: true
28
29  calxeda,pre-clocks:
30    $ref: /schemas/types.yaml#/definitions/uint32
31    description: |
32      Indicates the number of additional clock cycles to transmit before
33      sending an SGPIO pattern.
34
35  calxeda,post-clocks:
36    $ref: /schemas/types.yaml#/definitions/uint32
37    description: |
38      Indicates the number of additional clock cycles to transmit after
39      sending an SGPIO pattern.
40
41  calxeda,led-order:
42    description: Maps port numbers to offsets within the SGPIO bitstream.
43    $ref: /schemas/types.yaml#/definitions/uint32-array
44    minItems: 1
45    maxItems: 8
46
47  calxeda,port-phys:
48    description: |
49      phandle-combophy and lane assignment, which maps each SATA port to a
50      combophy and a lane within that combophy
51    $ref: /schemas/types.yaml#/definitions/phandle-array
52    minItems: 1
53    maxItems: 8
54    items:
55      maxItems: 2
56
57  calxeda,tx-atten:
58    description: |
59      Contains TX attenuation override codes, one per port.
60      The upper 24 bits of each entry are always 0 and thus ignored.
61    $ref: /schemas/types.yaml#/definitions/uint32-array
62    minItems: 1
63    maxItems: 8
64
65  calxeda,sgpio-gpio:
66    maxItems: 3
67    description: |
68      phandle-gpio bank, bit offset, and default on or off, which indicates
69      that the driver supports SGPIO indicator lights using the indicated
70      GPIOs.
71
72required:
73  - compatible
74  - reg
75  - interrupts
76
77additionalProperties: false
78
79examples:
80  - |
81    sata@ffe08000 {
82        compatible = "calxeda,hb-ahci";
83        reg = <0xffe08000 0x1000>;
84        interrupts = <115>;
85        dma-coherent;
86        calxeda,port-phys = <&combophy5 0>, <&combophy0 0>, <&combophy0 1>,
87                             <&combophy0 2>, <&combophy0 3>;
88        calxeda,sgpio-gpio =<&gpioh 5 1>, <&gpioh 6 1>, <&gpioh 7 1>;
89        calxeda,led-order = <4 0 1 2 3>;
90        calxeda,tx-atten = <0xff 22 0xff 0xff 23>;
91        calxeda,pre-clocks = <10>;
92        calxeda,post-clocks = <0>;
93    };
94
95...
96