xref: /freebsd/sys/contrib/device-tree/Bindings/phy/calxeda-combophy.yaml (revision 8bab661a3316d8bd9b9fbd11a3b4371b91507bd2)
1c66ec88fSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2c66ec88fSEmmanuel Vadot%YAML 1.2
3c66ec88fSEmmanuel Vadot---
4c66ec88fSEmmanuel Vadot$id: http://devicetree.org/schemas/phy/calxeda-combophy.yaml#
5c66ec88fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6c66ec88fSEmmanuel Vadot
7*8bab661aSEmmanuel Vadottitle: Calxeda Highbank Combination PHYs for SATA
8c66ec88fSEmmanuel Vadot
9c66ec88fSEmmanuel Vadotdescription: |
10c66ec88fSEmmanuel Vadot  The Calxeda Combination PHYs connect the SoC to the internal fabric
11c66ec88fSEmmanuel Vadot  and to SATA connectors. The PHYs support multiple protocols (SATA,
12c66ec88fSEmmanuel Vadot  SGMII, PCIe) and can be assigned to different devices (SATA or XGMAC
13c66ec88fSEmmanuel Vadot  controller).
14c66ec88fSEmmanuel Vadot  Programming the PHYs is typically handled by those device drivers,
15c66ec88fSEmmanuel Vadot  not by a dedicated PHY driver.
16c66ec88fSEmmanuel Vadot
17c66ec88fSEmmanuel Vadotmaintainers:
18c66ec88fSEmmanuel Vadot  - Andre Przywara <andre.przywara@arm.com>
19c66ec88fSEmmanuel Vadot
20c66ec88fSEmmanuel Vadotproperties:
21c66ec88fSEmmanuel Vadot  compatible:
22c66ec88fSEmmanuel Vadot    const: calxeda,hb-combophy
23c66ec88fSEmmanuel Vadot
24c66ec88fSEmmanuel Vadot  '#phy-cells':
25c66ec88fSEmmanuel Vadot    const: 1
26c66ec88fSEmmanuel Vadot
27c66ec88fSEmmanuel Vadot  reg:
28c66ec88fSEmmanuel Vadot    maxItems: 1
29c66ec88fSEmmanuel Vadot
30c66ec88fSEmmanuel Vadot  phydev:
31c66ec88fSEmmanuel Vadot    description: device ID for programming the ComboPHY.
32c66ec88fSEmmanuel Vadot    $ref: /schemas/types.yaml#/definitions/uint32
33c66ec88fSEmmanuel Vadot    maximum: 31
34c66ec88fSEmmanuel Vadot
35c66ec88fSEmmanuel Vadotrequired:
36c66ec88fSEmmanuel Vadot  - compatible
37c66ec88fSEmmanuel Vadot  - reg
38c66ec88fSEmmanuel Vadot  - phydev
39c66ec88fSEmmanuel Vadot  - '#phy-cells'
40c66ec88fSEmmanuel Vadot
41c66ec88fSEmmanuel VadotadditionalProperties: false
42c66ec88fSEmmanuel Vadot
43c66ec88fSEmmanuel Vadotexamples:
44c66ec88fSEmmanuel Vadot  - |
45c66ec88fSEmmanuel Vadot    combophy5: combo-phy@fff5d000 {
46c66ec88fSEmmanuel Vadot                   compatible = "calxeda,hb-combophy";
47c66ec88fSEmmanuel Vadot                   #phy-cells = <1>;
48c66ec88fSEmmanuel Vadot                   reg = <0xfff5d000 0x1000>;
49c66ec88fSEmmanuel Vadot                   phydev = <31>;
50c66ec88fSEmmanuel Vadot               };
51