Documentation/devicetree/bindings/net/mscc-phy-vsc8531.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/net/mscc-phy-vsc8531.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/net/mscc-phy-vsc8531.yaml
Extension
.yaml
Size
3993 bytes
Lines
132
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/net/mscc-phy-vsc8531.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Microsemi VSC8531 Gigabit Ethernet PHY

maintainers:
  - Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>

description:
  The VSC8531 is a Gigabit Ethernet PHY with configurable MAC interface
  drive strength and LED modes.

allOf:
  - $ref: ethernet-phy.yaml#

select:
  properties:
    compatible:
      contains:
        enum:
          - ethernet-phy-id0007.0570 # VSC8531
          - ethernet-phy-id0007.0772 # VSC8541
  required:
    - compatible

properties:
  compatible:
    items:
      - enum:
          - ethernet-phy-id0007.0570 # VSC8531
          - ethernet-phy-id0007.0772 # VSC8541
      - const: ethernet-phy-ieee802.3-c22

  vsc8531,vddmac:
    $ref: /schemas/types.yaml#/definitions/uint32
    description:
      The VDDMAC voltage in millivolts. This property is used in combination
      with the edge-slowdown property to control the drive strength of the
      MAC interface output signals.
    enum: [3300, 2500, 1800, 1500]
    default: 3300

  vsc8531,edge-slowdown:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: >
      Percentage by which the edge rate should be slowed down relative to
      the fastest possible edge time. This setting helps reduce electromagnetic
      interference (EMI) by adjusting the drive strength of the MAC interface
      output signals. Valid values depend on the vddmac voltage setting
      according to the edge rate change table in the datasheet.

      - When vsc8531,vddmac = 3300 mV: allowed values are 0, 2, 4, 7, 10, 17, 29, and 53.
        (Recommended: 7)
      - When vsc8531,vddmac = 2500 mV: allowed values are 0, 3, 6, 10, 14, 23, 37, and 63.
        (Recommended: 10)
      - When vsc8531,vddmac = 1800 mV: allowed values are 0, 5, 9, 16, 23, 35, 52, and 76.
        (Recommended: 0)
      - When vsc8531,vddmac = 1500 mV: allowed values are 0, 6, 14, 21, 29, 42, 58, and 77.
        (Recommended: 0)
    enum: [0, 2, 3, 4, 5, 6, 7, 9, 10, 14, 16, 17, 21, 23, 29, 35, 37, 42, 52, 53, 58, 63, 76, 77]
    default: 0

  vsc8531,led-0-mode:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: LED[0] behavior mode. See include/dt-bindings/net/mscc-phy-vsc8531.h
      for available modes.
    minimum: 0

Annotation

Implementation Notes