u-boot.git/include/phy.h, branch v2021.04

net: phy: introduce fixed_phy_create for DSA CPU ports

2021-02-16T16:48:20+00:00

The DSA (Distributed Switch Architecture) implementation has made a
design decision when it got introduced to the Linux kernel in 2008.
That was to hide away from the user the CPU-facing Ethernet MAC, since
it does not make sense to register it as a struct net_device (UCLASS_ETH
udevice for U-Boot), because that would never be beneficial for a user:
they would not be able to use it for traffic, since conceptually, a
packet delivered to the CPU port should loop back into the system.

Nonetheless, DSA has had numerous growing pains due to the lack of a
struct net_device for the CPU port, but so far it has overcome them.
It is unlikely at this stage of maturity that this aspect of it will
change.

We would like U-Boot to present the same information as Linux, to be at
parity in terms of number of interfaces, so that ethNaddr environment
variables could directly be associated between U-Boot and Linux.
Therefore, we would implicitly like U-Boot to hide the CPU port from the
user as well.

But the paradox is that DSA still needs a struct phy_device to inform
the driver of the parameters of the link that it should configure the
CPU port to. The problem is that the phy_device is typically returned
via a call to phy_connect, which needs an udevice to attach the PHY to,
and to search its ofnode for the 'fixed-link' property. But we don't
have an udevice to present for the CPU port.

Since 99% of DSA setups are MAC-to-MAC connections between the switch
and the host Ethernet controller, the struct phy_device is going to be a
fixed PHY. This simplifies things quite a bit. In U-Boot, a fixed PHY
does not need an MDIO bus, and does not need an attached dev either.
Basically, the phy_connect call doesn't do any connection, it just
creates the fixed PHY.

The proposal of this patch is to introduce a new fixed_phy_create
function which will take a single argument: the ofnode that holds this:

	port@4 {
		reg = <4>;
		phy-mode = "internal";

		fixed-link {
			speed = <2500>;
			full-duplex;
		};
	};

and probe a fixed PHY driver using the information from this ofnode.
DSA will probably be the only user of this function.

Signed-off-by: Vladimir Oltean 
Reviewed-by: Claudiu Manoil

net: phy: ca_phy: Add driver for CAxxxx SoCs

2021-01-27T15:47:47+00:00

Add phy driver support for MACs embedded inside Cortina Access SoCs

Signed-off-by: Abbie Chang 
Signed-off-by: Alex Nemirovsky 

CC: Joe Hershberger 
CC: Tom Rini 
CC: Aaron Tseng 

Moved out PHY specific code out of Cortina NI Ethernet driver
and into a Cortina Access PHY interface driver

include: phy: fix NULL pointer check in phy_write()

2020-09-16T20:54:00+00:00

phy_write() uses bus->write() instead of bus->read(). This means NULL
pointer pre-check needs to happen on bus->write instead of bus->read.

Signed-off-by: Thirupathaiah Annapureddy 
Reviewed-by: Michal Simek

net: Drop dm.h header file from phy.h

2020-08-04T02:19:54+00:00

This header file should not be included in other header files. Remove it
and use other headers and C inclusions instead.

Signed-off-by: Simon Glass

net: phy: Add helper routines to set and clear bits

2020-06-12T17:17:23+00:00

Add phy_set/clear_bit helper routines so that ported drivers from the
kernel can use these functions.

Acked-by: Michal Simek 
Signed-off-by: Dan Murphy

net: phy: Fix kernel doc issues in phy.h

2020-06-12T17:17:23+00:00

Fix kernel doc warnings in phy.h.  Mostly the warnings were due to the
return missing the semi-colon.

Acked-by: Michal Simek 
Signed-off-by: Dan Murphy

net: phy: Add missing kernel doc to phy functions

2020-06-12T17:17:23+00:00

Add kernel doc to the phy_read/write utility functions in phy.h

Acked-by: Michal Simek 
Signed-off-by: Dan Murphy

net: phy: add XFI, USXGMII types to is_10g_interface() helper

2020-03-09T23:11:25+00:00

The helper is used to reset PHYs on connect and it determines the clause
to use (C22/C45) based on interface type.  This fixes 'PHY reset timed out'
warnings in console for USXGMII/XFI PHYs.

Signed-off-by: Alex Marginean 
Acked-by: Joe Hershberger

phy: Include NC-SI in phy setup

2020-03-09T23:11:23+00:00

Add NC-SI to the usual phy handling. This makes two notable changes:
- Somewhat similar to a fixed phy, phy_connect() will create an NC-SI
phy if CONFIG_PHY_NCSI is defined.
- An early return is added to phy_read() and phy_write() to handle a
case like the NC-SI phy which does not define a bus.

Signed-off-by: Samuel Mendoza-Jonas 
Reviewed-by: Joel Stanley 
Acked-by: Joe Hershberger

phy: Add support for the NC-SI protocol

2020-03-09T23:11:23+00:00

This introduces support for the NC-SI protocol, modelled as a phy driver
for other ethernet drivers to consume.

NC-SI (Network Controller Sideband Interface) is a protocol to manage a
sideband connection to a proper network interface, for example a BMC
(Baseboard Management Controller) sharing the NIC of the host system.
Probing and configuration occurs by communicating with the "remote" NIC
via NC-SI control frames (Ethernet header 0x88f8).

This implementation is roughly based on the upstream Linux
implementation[0], with a reduced feature set and an emphasis on getting
a link up as fast as possible rather than probing the full possible
topology of the bus.
The current phy model relies on the network being "up", sending NC-SI
command frames via net_send_packet() and receiving them from the
net_loop() loop (added in a following patch).

The ncsi-pkt.h header[1] is copied from the Linux kernel for consistent
field definitions.

[0]: https://github.com/torvalds/linux/tree/master/net/ncsi
[1]: https://github.com/torvalds/linux/blob/master/net/ncsi/ncsi-pkt.h

Signed-off-by: Samuel Mendoza-Jonas 
Reviewed-by: Joel Stanley 
Acked-by: Joe Hershberger