254 lines
7.7 KiB
YAML
254 lines
7.7 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/micrel,gigabit.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Micrel series Gigabit Ethernet PHYs
|
|
|
|
maintainers:
|
|
- Andrew Lunn <andrew@lunn.ch>
|
|
- Stefan Eichenberger <eichest@gmail.com>
|
|
|
|
description:
|
|
Some boards require special skew tuning values, particularly when it comes
|
|
to clock delays. These values can be specified in the device tree using
|
|
the properties listed here.
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- ethernet-phy-id0022.1610 # KSZ9021
|
|
- ethernet-phy-id0022.1611 # KSZ9021RLRN
|
|
- ethernet-phy-id0022.1620 # KSZ9031
|
|
- ethernet-phy-id0022.1631 # KSZ9477
|
|
- ethernet-phy-id0022.1640 # KSZ9131
|
|
- ethernet-phy-id0022.1650 # LAN8841
|
|
- ethernet-phy-id0022.1660 # LAN8814
|
|
- ethernet-phy-id0022.1670 # LAN8804
|
|
|
|
micrel,force-master:
|
|
type: boolean
|
|
description: |
|
|
Force phy to master mode. Only set this option if the phy reference
|
|
clock provided at CLK125_NDO pin is used as MAC reference clock
|
|
because the clock jitter in slave mode is too high (errata#2).
|
|
Attention: The link partner must be configurable as slave otherwise
|
|
no link will be established.
|
|
|
|
coma-mode-gpios:
|
|
maxItems: 1
|
|
description: |
|
|
If present the given gpio will be deasserted when the PHY is probed.
|
|
|
|
Some PHYs have a COMA mode input pin which puts the PHY into
|
|
isolate and power-down mode. On some boards this input is connected
|
|
to a GPIO of the SoC.
|
|
|
|
micrel,led-mode:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: |
|
|
LED mode value to set for PHYs with configurable LEDs.
|
|
|
|
Configure the LED mode with single value. The list of PHYs and the
|
|
bits that are currently supported:
|
|
|
|
LAN8814: register EP5.0, bit 6
|
|
|
|
See the respective PHY datasheet for the mode values.
|
|
minimum: 0
|
|
maximum: 1
|
|
|
|
patternProperties:
|
|
'^([rt]xc)-skew-psec$':
|
|
$ref: /schemas/types.yaml#/definitions/int32
|
|
description:
|
|
Skew control of the pad in picoseconds.
|
|
minimum: -700
|
|
maximum: 2400
|
|
multipleOf: 100
|
|
default: 0
|
|
|
|
'^([rt]xd[0-3]|rxdv|txen)-skew-psec$':
|
|
$ref: /schemas/types.yaml#/definitions/int32
|
|
description: |
|
|
Skew control of the pad in picoseconds.
|
|
minimum: -700
|
|
maximum: 800
|
|
multipleOf: 100
|
|
default: 0
|
|
|
|
allOf:
|
|
- $ref: ethernet-phy.yaml#
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- ethernet-phy-id0022.1610
|
|
- ethernet-phy-id0022.1611
|
|
then:
|
|
patternProperties:
|
|
'^([rt]xd[0-3]|[rt]xc|rxdv|txen)-skew-ps$':
|
|
description: |
|
|
Skew control of the pad in picoseconds.
|
|
The actual increment on the chip is 120ps ranging from -840ps to
|
|
960ps, this mismatch comes from a documentation error before
|
|
datasheet revision 1.2 (Feb 2014).
|
|
|
|
The device tree value to delay mapping looks as follows:
|
|
Device Tree Value Delay
|
|
--------------------------
|
|
0 -840ps
|
|
200 -720ps
|
|
400 -600ps
|
|
600 -480ps
|
|
800 -360ps
|
|
1000 -240ps
|
|
1200 -120ps
|
|
1400 0ps
|
|
1600 120ps
|
|
1800 240ps
|
|
2000 360ps
|
|
2200 480ps
|
|
2400 600ps
|
|
2600 720ps
|
|
2800 840ps
|
|
3000 960ps
|
|
minimum: 0
|
|
maximum: 3000
|
|
multipleOf: 200
|
|
default: 1400
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: ethernet-phy-id0022.1620
|
|
then:
|
|
patternProperties:
|
|
'^([rt]xc)-skew-ps$':
|
|
description: |
|
|
Skew control of the pad in picoseconds.
|
|
|
|
The device tree value to delay mapping is as follows:
|
|
Device Tree Value Delay
|
|
--------------------------
|
|
0 -900ps
|
|
60 -840ps
|
|
120 -780ps
|
|
180 -720ps
|
|
240 -660ps
|
|
300 -600ps
|
|
360 -540ps
|
|
420 -480ps
|
|
480 -420ps
|
|
540 -360ps
|
|
600 -300ps
|
|
660 -240ps
|
|
720 -180ps
|
|
780 -120ps
|
|
840 -60ps
|
|
900 0ps
|
|
960 60ps
|
|
1020 120ps
|
|
1080 180ps
|
|
1140 240ps
|
|
1200 300ps
|
|
1260 360ps
|
|
1320 420ps
|
|
1380 480ps
|
|
1440 540ps
|
|
1500 600ps
|
|
1560 660ps
|
|
1620 720ps
|
|
1680 780ps
|
|
1740 840ps
|
|
1800 900ps
|
|
1860 960ps
|
|
minimum: 0
|
|
maximum: 1860
|
|
multipleOf: 60
|
|
default: 900
|
|
'^([rt]xd[0-3]|rxdv|txen)-skew-ps$':
|
|
description: |
|
|
Skew control of the pad in picoseconds.
|
|
|
|
The device tree value to delay mapping is as follows:
|
|
Device Tree Value Delay
|
|
--------------------------
|
|
0 -420ps
|
|
60 -360ps
|
|
120 -300ps
|
|
180 -240ps
|
|
240 -180ps
|
|
300 -120ps
|
|
360 -60ps
|
|
420 0ps
|
|
480 60ps
|
|
540 120ps
|
|
600 180ps
|
|
660 240ps
|
|
720 300ps
|
|
780 360ps
|
|
840 420ps
|
|
900 480ps
|
|
minimum: 0
|
|
maximum: 900
|
|
multipleOf: 60
|
|
default: 420
|
|
- if:
|
|
not:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- ethernet-phy-id0022.1640
|
|
- ethernet-phy-id0022.1650
|
|
then:
|
|
patternProperties:
|
|
'^([rt]xd[0-3]|[rt]xc|rxdv|txen)-skew-psec$': false
|
|
- if:
|
|
not:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: ethernet-phy-id0022.1620
|
|
then:
|
|
properties:
|
|
micrel,force-master: false
|
|
- if:
|
|
not:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: ethernet-phy-id0022.1660
|
|
then:
|
|
properties:
|
|
coma-mode-gpios: false
|
|
micrel,led-mode: false
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
mdio {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
ethernet-phy@7 {
|
|
compatible = "ethernet-phy-id0022.1610";
|
|
reg = <7>;
|
|
rxc-skew-ps = <3000>;
|
|
rxdv-skew-ps = <0>;
|
|
txc-skew-ps = <3000>;
|
|
txen-skew-ps = <0>;
|
|
};
|
|
|
|
ethernet-phy@9 {
|
|
compatible = "ethernet-phy-id0022.1640";
|
|
reg = <9>;
|
|
rxc-skew-psec = <(-100)>;
|
|
txc-skew-psec = <(-100)>;
|
|
};
|
|
};
|