xref: /freebsd/sys/contrib/device-tree/Bindings/phy/ti,phy-am654-serdes.yaml (revision fac71e4e09885bb2afa3d984a0c239a52e1a7418) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/ti,phy-am654-serdes.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: TI AM654 SERDES
8
9description:
10  This binding describes the TI AM654 SERDES. AM654 SERDES can be configured
11  to be used with either PCIe or USB or SGMII.
12
13maintainers:
14  - Kishon Vijay Abraham I <kishon@ti.com>
15
16properties:
17  compatible:
18    enum:
19      - ti,phy-am654-serdes
20
21  reg:
22    maxItems: 1
23
24  reg-names:
25    items:
26      - const: serdes
27
28  power-domains:
29    maxItems: 1
30
31  clocks:
32    maxItems: 3
33    description:
34      Three input clocks referring to left input reference clock, refclk and right input reference
35      clock.
36
37  '#phy-cells':
38    const: 2
39    description:
40      The 1st cell corresponds to the phy type (should be one of the types specified in
41      include/dt-bindings/phy/phy.h) and the 2nd cell should be the serdes lane function.
42
43  ti,serdes-clk:
44    description: Phandle to the SYSCON entry required for configuring SERDES clock selection.
45    $ref: /schemas/types.yaml#/definitions/phandle
46
47  '#clock-cells':
48    const: 1
49
50  mux-controls:
51    maxItems: 1
52    description: Phandle to the SYSCON entry required for configuring SERDES lane function.
53
54  clock-output-names:
55    oneOf:
56      - description: Clock output names for SERDES 0
57        items:
58          - const: serdes0_cmu_refclk
59          - const: serdes0_lo_refclk
60          - const: serdes0_ro_refclk
61      - description: Clock output names for SERDES 1
62        items:
63          - const: serdes1_cmu_refclk
64          - const: serdes1_lo_refclk
65          - const: serdes1_ro_refclk
66
67required:
68  - compatible
69  - reg
70  - power-domains
71  - clocks
72  - assigned-clocks
73  - assigned-clock-parents
74  - ti,serdes-clk
75  - mux-controls
76  - clock-output-names
77
78additionalProperties: false
79
80examples:
81  - |
82    #include <dt-bindings/phy/phy-am654-serdes.h>
83
84    serdes0: serdes@900000 {
85      compatible = "ti,phy-am654-serdes";
86      reg = <0x900000 0x2000>;
87      reg-names = "serdes";
88      #phy-cells = <2>;
89      power-domains = <&k3_pds 153>;
90      clocks = <&k3_clks 153 4>, <&k3_clks 153 1>,
91               <&serdes1 AM654_SERDES_LO_REFCLK>;
92      clock-output-names = "serdes0_cmu_refclk", "serdes0_lo_refclk", "serdes0_ro_refclk";
93      assigned-clocks = <&k3_clks 153 4>, <&serdes0 AM654_SERDES_CMU_REFCLK>;
94      assigned-clock-parents = <&k3_clks 153 8>, <&k3_clks 153 4>;
95      ti,serdes-clk = <&serdes0_clk>;
96      mux-controls = <&serdes_mux 0>;
97      #clock-cells = <1>;
98    };
99