mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-04-02 05:51:14 -04:00
35d1a5464b
Convert the Marvell10G driver to use the generic SFP handling, through a dedicated .attach_port() handler to populate the port's supported interfaces. As the 88x3310 supports multiple MDI, the .attach_port() logic handles both SFP attach with 10GBaseR support, and support for the "regular" port that usually is a BaseT port. Reviewed-by: Andrew Lunn <andrew@lunn.ch> Reviewed-by: Christophe Leroy <christophe.leroy@csgroup.eu> Tested-by: Christophe Leroy <christophe.leroy@csgroup.eu> Signed-off-by: Maxime Chevallier <maxime.chevallier@bootlin.com> Link: https://patch.msgid.link/20260108080041.553250-11-maxime.chevallier@bootlin.com Signed-off-by: Jakub Kicinski <kuba@kernel.org>
100 lines
2.9 KiB
C
100 lines
2.9 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#ifndef __PHY_PORT_H
|
|
#define __PHY_PORT_H
|
|
|
|
#include <linux/ethtool.h>
|
|
#include <linux/types.h>
|
|
#include <linux/phy.h>
|
|
|
|
struct phy_port;
|
|
|
|
/**
|
|
* enum phy_port_parent - The device this port is attached to
|
|
*
|
|
* @PHY_PORT_PHY: Indicates that the port is driven by a PHY device
|
|
*/
|
|
enum phy_port_parent {
|
|
PHY_PORT_PHY,
|
|
};
|
|
|
|
struct phy_port_ops {
|
|
/* Sometimes, the link state can be retrieved from physical,
|
|
* out-of-band channels such as the LOS signal on SFP. These
|
|
* callbacks allows notifying the port about state changes
|
|
*/
|
|
void (*link_up)(struct phy_port *port);
|
|
void (*link_down)(struct phy_port *port);
|
|
|
|
/* If the port acts as a Media Independent Interface (Serdes port),
|
|
* configures the port with the relevant state and mode. When enable is
|
|
* not set, interface should be ignored
|
|
*/
|
|
int (*configure_mii)(struct phy_port *port, bool enable, phy_interface_t interface);
|
|
};
|
|
|
|
/**
|
|
* struct phy_port - A representation of a network device physical interface
|
|
*
|
|
* @head: Used by the port's parent to list ports
|
|
* @parent_type: The type of device this port is directly connected to
|
|
* @phy: If the parent is PHY_PORT_PHYDEV, the PHY controlling that port
|
|
* @ops: Callback ops implemented by the port controller
|
|
* @pairs: The number of pairs this port has, 0 if not applicable
|
|
* @mediums: Bitmask of the physical mediums this port provides access to
|
|
* @supported: The link modes this port can expose, if this port is MDI (not MII)
|
|
* @interfaces: The MII interfaces this port supports, if this port is MII
|
|
* @not_described: Indicates to the parent driver if this port isn't described,
|
|
* so it's up to the parent to filter its capabilities.
|
|
* @active: Indicates if the port is currently part of the active link.
|
|
* @is_mii: Indicates if this port is MII (Media Independent Interface),
|
|
* or MDI (Media Dependent Interface).
|
|
* @is_sfp: Indicates if this port drives an SFP cage.
|
|
*/
|
|
struct phy_port {
|
|
struct list_head head;
|
|
enum phy_port_parent parent_type;
|
|
union {
|
|
struct phy_device *phy;
|
|
};
|
|
|
|
const struct phy_port_ops *ops;
|
|
|
|
int pairs;
|
|
unsigned long mediums;
|
|
__ETHTOOL_DECLARE_LINK_MODE_MASK(supported);
|
|
DECLARE_PHY_INTERFACE_MASK(interfaces);
|
|
|
|
unsigned int not_described:1;
|
|
unsigned int active:1;
|
|
unsigned int is_mii:1;
|
|
unsigned int is_sfp:1;
|
|
};
|
|
|
|
struct phy_port *phy_port_alloc(void);
|
|
void phy_port_destroy(struct phy_port *port);
|
|
|
|
static inline struct phy_device *port_phydev(struct phy_port *port)
|
|
{
|
|
return port->phy;
|
|
}
|
|
|
|
struct phy_port *phy_of_parse_port(struct device_node *dn);
|
|
|
|
static inline bool phy_port_is_copper(struct phy_port *port)
|
|
{
|
|
return port->mediums == BIT(ETHTOOL_LINK_MEDIUM_BASET);
|
|
}
|
|
|
|
static inline bool phy_port_is_fiber(struct phy_port *port)
|
|
{
|
|
return !!(port->mediums & ETHTOOL_MEDIUM_FIBER_BITS);
|
|
}
|
|
|
|
void phy_port_update_supported(struct phy_port *port);
|
|
int phy_port_restrict_mediums(struct phy_port *port, unsigned long mediums);
|
|
|
|
int phy_port_get_type(struct phy_port *port);
|
|
|
|
#endif
|