Commit c5e38a94 authored by Andy Fleming's avatar Andy Fleming Committed by Jeff Garzik

phy: Clean up header style

Multi-line comments weren't all CodingStyle compliant
Signed-off-by: default avatarAndy Fleming <afleming@freescale.com>
Signed-off-by: default avatarJeff Garzik <jgarzik@redhat.com>
parent 9d9326d3
...@@ -39,7 +39,8 @@ ...@@ -39,7 +39,8 @@
SUPPORTED_1000baseT_Half | \ SUPPORTED_1000baseT_Half | \
SUPPORTED_1000baseT_Full) SUPPORTED_1000baseT_Full)
/* Set phydev->irq to PHY_POLL if interrupts are not supported, /*
* Set phydev->irq to PHY_POLL if interrupts are not supported,
* or not desired for this PHY. Set to PHY_IGNORE_INTERRUPT if * or not desired for this PHY. Set to PHY_IGNORE_INTERRUPT if
* the attached driver handles the interrupt * the attached driver handles the interrupt
*/ */
...@@ -80,8 +81,10 @@ typedef enum { ...@@ -80,8 +81,10 @@ typedef enum {
*/ */
#define MII_BUS_ID_SIZE (BUS_ID_SIZE - 3) #define MII_BUS_ID_SIZE (BUS_ID_SIZE - 3)
/* The Bus class for PHYs. Devices which provide access to /*
* PHYs should register using this structure */ * The Bus class for PHYs. Devices which provide access to
* PHYs should register using this structure
*/
struct mii_bus { struct mii_bus {
const char *name; const char *name;
char id[MII_BUS_ID_SIZE]; char id[MII_BUS_ID_SIZE];
...@@ -90,8 +93,10 @@ struct mii_bus { ...@@ -90,8 +93,10 @@ struct mii_bus {
int (*write)(struct mii_bus *bus, int phy_id, int regnum, u16 val); int (*write)(struct mii_bus *bus, int phy_id, int regnum, u16 val);
int (*reset)(struct mii_bus *bus); int (*reset)(struct mii_bus *bus);
/* A lock to ensure that only one thing can read/write /*
* the MDIO bus at a time */ * A lock to ensure that only one thing can read/write
* the MDIO bus at a time
*/
struct mutex mdio_lock; struct mutex mdio_lock;
struct device *dev; struct device *dev;
...@@ -102,8 +107,10 @@ struct mii_bus { ...@@ -102,8 +107,10 @@ struct mii_bus {
/* Phy addresses to be ignored when probing */ /* Phy addresses to be ignored when probing */
u32 phy_mask; u32 phy_mask;
/* Pointer to an array of interrupts, each PHY's /*
* interrupt at the index matching its address */ * Pointer to an array of interrupts, each PHY's
* interrupt at the index matching its address
*/
int *irq; int *irq;
}; };
...@@ -255,7 +262,8 @@ struct phy_device { ...@@ -255,7 +262,8 @@ struct phy_device {
/* Bus address of the PHY (0-32) */ /* Bus address of the PHY (0-32) */
int addr; int addr;
/* forced speed & duplex (no autoneg) /*
* forced speed & duplex (no autoneg)
* partner speed & duplex & pause (autoneg) * partner speed & duplex & pause (autoneg)
*/ */
int speed; int speed;
...@@ -278,8 +286,10 @@ struct phy_device { ...@@ -278,8 +286,10 @@ struct phy_device {
int link_timeout; int link_timeout;
/* Interrupt number for this PHY /*
* -1 means no interrupt */ * Interrupt number for this PHY
* -1 means no interrupt
*/
int irq; int irq;
/* private data pointer */ /* private data pointer */
...@@ -329,22 +339,28 @@ struct phy_driver { ...@@ -329,22 +339,28 @@ struct phy_driver {
u32 features; u32 features;
u32 flags; u32 flags;
/* Called to initialize the PHY, /*
* including after a reset */ * Called to initialize the PHY,
* including after a reset
*/
int (*config_init)(struct phy_device *phydev); int (*config_init)(struct phy_device *phydev);
/* Called during discovery. Used to set /*
* up device-specific structures, if any */ * Called during discovery. Used to set
* up device-specific structures, if any
*/
int (*probe)(struct phy_device *phydev); int (*probe)(struct phy_device *phydev);
/* PHY Power Management */ /* PHY Power Management */
int (*suspend)(struct phy_device *phydev); int (*suspend)(struct phy_device *phydev);
int (*resume)(struct phy_device *phydev); int (*resume)(struct phy_device *phydev);
/* Configures the advertisement and resets /*
* Configures the advertisement and resets
* autonegotiation if phydev->autoneg is on, * autonegotiation if phydev->autoneg is on,
* forces the speed to the current settings in phydev * forces the speed to the current settings in phydev
* if phydev->autoneg is off */ * if phydev->autoneg is off
*/
int (*config_aneg)(struct phy_device *phydev); int (*config_aneg)(struct phy_device *phydev);
/* Determines the negotiated speed and duplex */ /* Determines the negotiated speed and duplex */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment