target/linux/generic/pending-6.1/713-01-dt-bindings-net-ipq4019-mdio-document-now-supported-.patch

   1 From 85e2038891989e41bc62f6a4625fd5865da8a1a2 Mon Sep 17 00:00:00 2001
   2 From: Christian Marangi <ansuelsmth@gmail.com>
   3 Date: Wed, 24 Jan 2024 19:17:02 +0100
   4 Subject: [PATCH 1/3] dt-bindings: net: ipq4019-mdio: document now supported
   5  clock-frequency
   6
   7 Document support for clock-frequency and add details on why this
   8 property is needed and what values are supported.
   9
  10 From internal documentation, while other values are supported, the
  11 correct function of the MDIO bus is not assured hence add only the
  12 suggested supported values to the property enum.
  13
  14 Signed-off-by: Christian Marangi <ansuelsmth@gmail.com>
  15 ---
  16  .../bindings/net/qcom,ipq4019-mdio.yaml           | 15 +++++++++++++++
  17  1 file changed, 15 insertions(+)
  18
  19 --- a/Documentation/devicetree/bindings/net/qcom,ipq4019-mdio.yaml
  20 +++ b/Documentation/devicetree/bindings/net/qcom,ipq4019-mdio.yaml
  21 @@ -38,6 +38,21 @@ properties:
  22        MDIO clock source frequency fixed to 100MHZ, this clock should be specified
  23        by the platform IPQ807x, IPQ60xx and IPQ50xx.
  24
  25 +  clock-frequency:
  26 +    description:
  27 +      The MDIO bus clock that must be output by the MDIO bus hardware, if
  28 +      absent, the default hardware values are used.
  29 +
  30 +      MDC rate is feed by an external clock (fixed 100MHz) and is divider
  31 +      internally. The default divider is /256 resulting in the default rate
  32 +      applied of 390KHz.
  33 +
  34 +      To follow 802.3 standard that instruct up to 2.5MHz by default, if
  35 +      this property is not declared and the divider is set to /256, by
  36 +      default 1.5625Mhz is select.
  37 +    enum: [ 390625, 781250, 1562500, 3125000, 6250000, 12500000 ]
  38 +    default: 1562500
  39 +
  40  required:
  41    - compatible
  42    - reg