Documentation/devicetree/bindings/net/dsa/micrel,ks8995.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/net/dsa/micrel,ks8995.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/net/dsa/micrel,ks8995.yaml
Extension
.yaml
Size
3061 bytes
Lines
136
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/dsa/micrel,ks8995.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Micrel KS8995 Family DSA Switches

maintainers:
  - Linus Walleij <linusw@kernel.org>

description:
  The Micrel KS8995 DSA Switches are 100 Mbit switches that were produced in
  the early-to-mid 2000s. The chip features a CPU port and four outgoing ports,
  each with an internal PHY. The chip itself is managed over SPI, but all the
  PHYs need to be accessed from an external MDIO channel.

  Further, a fifth PHY is available and can be used separately from the switch
  fabric, connected to an external MII interface name MII-P5. This is
  unrelated from the CPU-facing port 5 which is used for DSA MII traffic.

properties:
  compatible:
    enum:
      - micrel,ks8995
      - micrel,ksz8795
      - micrel,ksz8864

  reg:
    maxItems: 1

  reset-gpios:
    description: GPIO to be used to reset the whole device
    maxItems: 1

allOf:
  - $ref: dsa.yaml#/$defs/ethernet-ports
  - $ref: /schemas/spi/spi-peripheral-props.yaml#

required:
  - compatible
  - reg

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>

    spi {
      #address-cells = <1>;
      #size-cells = <0>;

      ethernet-switch@0 {
        compatible = "micrel,ks8995";
        reg = <0>;
        spi-max-frequency = <25000000>;

        ethernet-ports {
          #address-cells = <1>;
          #size-cells = <0>;

          ethernet-port@0 {
            reg = <0>;
            label = "lan1";
          };
          ethernet-port@1 {
            reg = <1>;
            label = "lan2";
          };

Annotation

Implementation Notes