Documentation/devicetree/bindings/phy/ti,phy-am654-serdes.yaml

   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
   7 title: TI AM654 SERDES
   8
   9 description:
  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
  13 maintainers:
  14   - Kishon Vijay Abraham I <kishon@ti.com>
  15
  16 properties:
  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
  67 required:
  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
  78 additionalProperties: false
  79
  80 examples:
  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     };