xref: /freebsd/sys/contrib/device-tree/Bindings/net/ethernet-phy-package.yaml (revision 01950c46b8155250f64374fb72fc11faa44bf099)
1*01950c46SEmmanuel Vadot# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2*01950c46SEmmanuel Vadot%YAML 1.2
3*01950c46SEmmanuel Vadot---
4*01950c46SEmmanuel Vadot$id: http://devicetree.org/schemas/net/ethernet-phy-package.yaml#
5*01950c46SEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*01950c46SEmmanuel Vadot
7*01950c46SEmmanuel Vadottitle: Ethernet PHY Package Common Properties
8*01950c46SEmmanuel Vadot
9*01950c46SEmmanuel Vadotmaintainers:
10*01950c46SEmmanuel Vadot  - Christian Marangi <ansuelsmth@gmail.com>
11*01950c46SEmmanuel Vadot
12*01950c46SEmmanuel Vadotdescription:
13*01950c46SEmmanuel Vadot  PHY packages are multi-port Ethernet PHY of the same family
14*01950c46SEmmanuel Vadot  and each Ethernet PHY is affected by the global configuration
15*01950c46SEmmanuel Vadot  of the PHY package.
16*01950c46SEmmanuel Vadot
17*01950c46SEmmanuel Vadot  Each reg of the PHYs defined in the PHY package node is
18*01950c46SEmmanuel Vadot  absolute and describe the real address of the Ethernet PHY on
19*01950c46SEmmanuel Vadot  the MDIO bus.
20*01950c46SEmmanuel Vadot
21*01950c46SEmmanuel Vadotproperties:
22*01950c46SEmmanuel Vadot  $nodename:
23*01950c46SEmmanuel Vadot    pattern: "^ethernet-phy-package@[a-f0-9]+$"
24*01950c46SEmmanuel Vadot
25*01950c46SEmmanuel Vadot  reg:
26*01950c46SEmmanuel Vadot    minimum: 0
27*01950c46SEmmanuel Vadot    maximum: 31
28*01950c46SEmmanuel Vadot    description:
29*01950c46SEmmanuel Vadot      The base ID number for the PHY package.
30*01950c46SEmmanuel Vadot      Commonly the ID of the first PHY in the PHY package.
31*01950c46SEmmanuel Vadot
32*01950c46SEmmanuel Vadot      Some PHY in the PHY package might be not defined but
33*01950c46SEmmanuel Vadot      still occupy ID on the device (just not attached to
34*01950c46SEmmanuel Vadot      anything) hence the PHY package reg might correspond
35*01950c46SEmmanuel Vadot      to a not attached PHY (offset 0).
36*01950c46SEmmanuel Vadot
37*01950c46SEmmanuel Vadot  '#address-cells':
38*01950c46SEmmanuel Vadot    const: 1
39*01950c46SEmmanuel Vadot
40*01950c46SEmmanuel Vadot  '#size-cells':
41*01950c46SEmmanuel Vadot    const: 0
42*01950c46SEmmanuel Vadot
43*01950c46SEmmanuel VadotpatternProperties:
44*01950c46SEmmanuel Vadot  ^ethernet-phy@[a-f0-9]+$:
45*01950c46SEmmanuel Vadot    $ref: ethernet-phy.yaml#
46*01950c46SEmmanuel Vadot
47*01950c46SEmmanuel Vadotrequired:
48*01950c46SEmmanuel Vadot  - reg
49*01950c46SEmmanuel Vadot  - '#address-cells'
50*01950c46SEmmanuel Vadot  - '#size-cells'
51*01950c46SEmmanuel Vadot
52*01950c46SEmmanuel VadotadditionalProperties: true
53