mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-19 09:04:51 +08:00
90c47eb169
Add the device tree bindings for the MaxLinear GPY2xx PHYs, which essentially adds just one flag: maxlinear,use-broken-interrupts. One might argue, that if interrupts are broken, just don't use the interrupt property in the first place. But it needs to be more nuanced. First, this interrupt line is also used to wake up systems by WoL, which has nothing to do with the (broken) PHY interrupt handling. Second and more importantly, there are devicetrees which have this property set. Thus, within the driver we have to switch off interrupt handling by default as a workaround. But OTOH, a systems designer who knows the hardware and knows there are no shared interrupts for example, can use this new property as a hint to the driver that it can enable the interrupt nonetheless. Signed-off-by: Michael Walle <michael@walle.cc> Reviewed-by: Andrew Lunn <andrew@lunn.ch> Signed-off-by: Paolo Abeni <pabeni@redhat.com>
48 lines
1.2 KiB
YAML
48 lines
1.2 KiB
YAML
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/net/maxlinear,gpy2xx.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: MaxLinear GPY2xx PHY
|
|
|
|
maintainers:
|
|
- Andrew Lunn <andrew@lunn.ch>
|
|
- Michael Walle <michael@walle.cc>
|
|
|
|
allOf:
|
|
- $ref: ethernet-phy.yaml#
|
|
|
|
properties:
|
|
maxlinear,use-broken-interrupts:
|
|
description: |
|
|
Interrupts are broken on some GPY2xx PHYs in that they keep the
|
|
interrupt line asserted even after the interrupt status register is
|
|
cleared. Thus it is blocking the interrupt line which is usually bad
|
|
for shared lines. By default interrupts are disabled for this PHY and
|
|
polling mode is used. If one can live with the consequences, this
|
|
property can be used to enable interrupt handling.
|
|
|
|
Affected PHYs (as far as known) are GPY215B and GPY215C.
|
|
type: boolean
|
|
|
|
dependencies:
|
|
maxlinear,use-broken-interrupts: [ interrupts ]
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
ethernet {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
|
|
ethernet-phy@0 {
|
|
reg = <0>;
|
|
interrupts-extended = <&intc 0>;
|
|
maxlinear,use-broken-interrupts;
|
|
};
|
|
};
|
|
|
|
...
|