dt-bindings: phy: Add `tx-p2p-microvolt` property binding
authorMarek Behún <kabel@kernel.org>
Thu, 10 Feb 2022 17:48:22 +0000 (18:48 +0100)
committerDavid S. Miller <davem@davemloft.net>
Fri, 11 Feb 2022 11:21:34 +0000 (11:21 +0000)
commit066c4b6ba06392e5929ea2ebd17622090b500b58
treea641351579bd09030fa7c75fdb5a06ad9968de3f
parentb9605161e7be40fdd0fa0685b5c534e6201ac04b
dt-bindings: phy: Add `tx-p2p-microvolt` property binding

Common PHYs and network PCSes often have the possibility to specify
peak-to-peak voltage on the differential pair - the default voltage
sometimes needs to be changed for a particular board.

Add properties `tx-p2p-microvolt` and `tx-p2p-microvolt-names` for this
purpose. The second property is needed to specify the mode for the
corresponding voltage in the `tx-p2p-microvolt` property, if the voltage
is to be used only for speficic mode. More voltage-mode pairs can be
specified.

Example usage with only one voltage (it will be used for all supported
PHY modes, the `tx-p2p-microvolt-names` property is not needed in this
case):

  tx-p2p-microvolt = <915000>;

Example usage with voltages for multiple modes:

  tx-p2p-microvolt = <915000>, <1100000>, <1200000>;
  tx-p2p-microvolt-names = "2500base-x", "usb", "pcie";

Add these properties into a separate file phy/transmit-amplitude.yaml,
which should be referenced by any binding that uses it.

Signed-off-by: Marek Behún <kabel@kernel.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: David S. Miller <davem@davemloft.net>
Documentation/devicetree/bindings/phy/transmit-amplitude.yaml [new file with mode: 0644]