intel,ixp4xx-ethernet.yaml

  1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
  2# Copyright 2018 Linaro Ltd.
  3%YAML 1.2
  4---
  5$id: http://devicetree.org/schemas/net/intel,ixp4xx-ethernet.yaml#
  6$schema: http://devicetree.org/meta-schemas/core.yaml#
  7
  8title: Intel IXP4xx ethernet
  9
 10allOf:
 11  - $ref: ethernet-controller.yaml#
 12
 13maintainers:
 14  - Linus Walleij <linusw@kernel.org>
 15
 16description: |
 17  The Intel IXP4xx ethernet makes use of the IXP4xx NPE (Network
 18  Processing Engine) and the IXP4xx Queue Manager to process
 19  the ethernet frames. It can optionally contain an MDIO bus to
 20  talk to PHYs.
 21
 22properties:
 23  compatible:
 24    const: intel,ixp4xx-ethernet
 25
 26  reg:
 27    maxItems: 1
 28    description: Ethernet MMIO address range
 29
 30  queue-rx:
 31    $ref: /schemas/types.yaml#/definitions/phandle-array
 32    items:
 33      - items:
 34          - description: phandle to the RX queue node
 35          - description: RX queue instance to use
 36    description: phandle to the RX queue on the NPE
 37
 38  queue-txready:
 39    $ref: /schemas/types.yaml#/definitions/phandle-array
 40    items:
 41      - items:
 42          - description: phandle to the TX READY queue node
 43          - description: TX READY queue instance to use
 44    description: phandle to the TX READY queue on the NPE
 45
 46  phy-mode: true
 47
 48  phy-handle: true
 49
 50  fixed-link: true
 51
 52  intel,npe-handle:
 53    $ref: /schemas/types.yaml#/definitions/phandle-array
 54    items:
 55      - items:
 56          - description: phandle to the NPE this ethernet instance is using
 57          - description: the NPE instance to use
 58    description: phandle to the NPE this ethernet instance is using
 59      and the instance to use in the second cell
 60
 61  mdio:
 62    $ref: mdio.yaml#
 63    unevaluatedProperties: false
 64    description: optional node for embedded MDIO controller
 65
 66required:
 67  - compatible
 68  - reg
 69  - queue-rx
 70  - queue-txready
 71  - intel,npe-handle
 72
 73additionalProperties: false
 74
 75examples:
 76  - |
 77    npe: npe@c8006000 {
 78      compatible = "intel,ixp4xx-network-processing-engine";
 79      reg = <0xc8006000 0x1000>, <0xc8007000 0x1000>, <0xc8008000 0x1000>;
 80    };
 81
 82    ethernet@c8009000 {
 83      compatible = "intel,ixp4xx-ethernet";
 84      reg = <0xc8009000 0x1000>;
 85      queue-rx = <&qmgr 4>;
 86      queue-txready = <&qmgr 21>;
 87      intel,npe-handle = <&npe 1>;
 88      phy-mode = "rgmii";
 89      phy-handle = <&phy1>;
 90    };
 91
 92    ethernet@c800c000 {
 93      compatible = "intel,ixp4xx-ethernet";
 94      reg = <0xc800c000 0x1000>;
 95      queue-rx = <&qmgr 3>;
 96      queue-txready = <&qmgr 20>;
 97      intel,npe-handle = <&npe 2>;
 98      phy-mode = "rgmii";
 99      phy-handle = <&phy2>;
100
101      mdio {
102        #address-cells = <1>;
103        #size-cells = <0>;
104        phy1: ethernet-phy@1 {
105          reg = <1>;
106        };
107        phy2: ethernet-phy@2 {
108          reg = <2>;
109        };
110      };
111    };