xref: /freebsd/sys/contrib/device-tree/Bindings/phy/intel,combo-phy.yaml (revision 6580f5c38dd5b01aeeaed16b370f1a12423437f0) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/intel,combo-phy.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Intel ComboPhy Subsystem
8
9maintainers:
10  - Dilip Kota <eswara.kota@linux.intel.com>
11
12description: |
13  Intel Combophy subsystem supports PHYs for PCIe, EMAC and SATA
14  controllers. A single Combophy provides two PHY instances.
15
16properties:
17  $nodename:
18    pattern: "combophy(@.*|-([0-9]|[1-9][0-9]+))?$"
19
20  compatible:
21    items:
22      - const: intel,combophy-lgm
23      - const: intel,combo-phy
24
25  clocks:
26    maxItems: 1
27
28  reg:
29    items:
30      - description: ComboPhy core registers
31      - description: PCIe app core control registers
32
33  reg-names:
34    items:
35      - const: core
36      - const: app
37
38  resets:
39    maxItems: 4
40
41  reset-names:
42    items:
43      - const: phy
44      - const: core
45      - const: iphy0
46      - const: iphy1
47
48  intel,syscfg:
49    $ref: /schemas/types.yaml#/definitions/phandle-array
50    items:
51      - items:
52          - description: phandle to Chip configuration registers
53          - description: ComboPhy instance id
54    description: Chip configuration registers handle and ComboPhy instance id
55
56  intel,hsio:
57    $ref: /schemas/types.yaml#/definitions/phandle-array
58    items:
59      - items:
60          - description: phandle to HSIO registers
61          - description: ComboPhy instance id
62    description: HSIO registers handle and ComboPhy instance id on NOC
63
64  intel,aggregation:
65    type: boolean
66    description: |
67      Specify the flag to configure ComboPHY in dual lane mode.
68
69  intel,phy-mode:
70    $ref: /schemas/types.yaml#/definitions/uint32
71    description: |
72      Mode of the two phys in ComboPhy.
73      See dt-bindings/phy/phy.h for values.
74
75  "#phy-cells":
76    const: 1
77
78required:
79  - compatible
80  - clocks
81  - reg
82  - reg-names
83  - intel,syscfg
84  - intel,hsio
85  - intel,phy-mode
86  - "#phy-cells"
87
88additionalProperties: false
89
90examples:
91  - |
92    #include <dt-bindings/phy/phy.h>
93    combophy@d0a00000 {
94        compatible = "intel,combophy-lgm", "intel,combo-phy";
95        clocks = <&cgu0 1>;
96        #phy-cells = <1>;
97        reg = <0xd0a00000 0x40000>,
98              <0xd0a40000 0x1000>;
99        reg-names = "core", "app";
100        resets = <&rcu0 0x50 6>,
101                 <&rcu0 0x50 17>,
102                 <&rcu0 0x50 23>,
103                 <&rcu0 0x50 24>;
104        reset-names = "phy", "core", "iphy0", "iphy1";
105        intel,syscfg = <&sysconf 0>;
106        intel,hsio = <&hsiol 0>;
107        intel,phy-mode = <PHY_TYPE_PCIE>;
108        intel,aggregation;
109    };
110