Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/Documentation/devicetree/bindings/ata/sata_highbank.yaml
26308 views
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


7
title: Calxeda AHCI SATA Controller

8


9
description: |

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


14
maintainers:

15
  - Andre Przywara <andre.przywara@arm.com>

16


17
properties:

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


72
required:

73
  - compatible

74
  - reg

75
  - interrupts

76


77
additionalProperties: false

78


79
examples:

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


97