LCOV - code coverage report
Current view: top level - include/linux - phy.h (source / functions) Hit Total Coverage
Test: coverage.info Lines: 3 5 60.0 %
Date: 2014-02-18 Functions: 0 0 -
Branches: 0 0 -

           Branch data     Line data    Source code
       1                 :            : /*
       2                 :            :  * include/linux/phy.h
       3                 :            :  *
       4                 :            :  * Framework and drivers for configuring and reading different PHYs
       5                 :            :  * Based on code in sungem_phy.c and gianfar_phy.c
       6                 :            :  *
       7                 :            :  * Author: Andy Fleming
       8                 :            :  *
       9                 :            :  * Copyright (c) 2004 Freescale Semiconductor, Inc.
      10                 :            :  *
      11                 :            :  * This program is free software; you can redistribute  it and/or modify it
      12                 :            :  * under  the terms of  the GNU General  Public License as published by the
      13                 :            :  * Free Software Foundation;  either version 2 of the  License, or (at your
      14                 :            :  * option) any later version.
      15                 :            :  *
      16                 :            :  */
      17                 :            : 
      18                 :            : #ifndef __PHY_H
      19                 :            : #define __PHY_H
      20                 :            : 
      21                 :            : #include <linux/spinlock.h>
      22                 :            : #include <linux/ethtool.h>
      23                 :            : #include <linux/mii.h>
      24                 :            : #include <linux/timer.h>
      25                 :            : #include <linux/workqueue.h>
      26                 :            : #include <linux/mod_devicetable.h>
      27                 :            : 
      28                 :            : #include <linux/atomic.h>
      29                 :            : 
      30                 :            : #define PHY_BASIC_FEATURES      (SUPPORTED_10baseT_Half | \
      31                 :            :                                  SUPPORTED_10baseT_Full | \
      32                 :            :                                  SUPPORTED_100baseT_Half | \
      33                 :            :                                  SUPPORTED_100baseT_Full | \
      34                 :            :                                  SUPPORTED_Autoneg | \
      35                 :            :                                  SUPPORTED_TP | \
      36                 :            :                                  SUPPORTED_MII)
      37                 :            : 
      38                 :            : #define PHY_GBIT_FEATURES       (PHY_BASIC_FEATURES | \
      39                 :            :                                  SUPPORTED_1000baseT_Half | \
      40                 :            :                                  SUPPORTED_1000baseT_Full)
      41                 :            : 
      42                 :            : /*
      43                 :            :  * Set phydev->irq to PHY_POLL if interrupts are not supported,
      44                 :            :  * or not desired for this PHY.  Set to PHY_IGNORE_INTERRUPT if
      45                 :            :  * the attached driver handles the interrupt
      46                 :            :  */
      47                 :            : #define PHY_POLL                -1
      48                 :            : #define PHY_IGNORE_INTERRUPT    -2
      49                 :            : 
      50                 :            : #define PHY_HAS_INTERRUPT       0x00000001
      51                 :            : #define PHY_HAS_MAGICANEG       0x00000002
      52                 :            : #define PHY_IS_INTERNAL         0x00000004
      53                 :            : 
      54                 :            : /* Interface Mode definitions */
      55                 :            : typedef enum {
      56                 :            :         PHY_INTERFACE_MODE_NA,
      57                 :            :         PHY_INTERFACE_MODE_MII,
      58                 :            :         PHY_INTERFACE_MODE_GMII,
      59                 :            :         PHY_INTERFACE_MODE_SGMII,
      60                 :            :         PHY_INTERFACE_MODE_TBI,
      61                 :            :         PHY_INTERFACE_MODE_REVMII,
      62                 :            :         PHY_INTERFACE_MODE_RMII,
      63                 :            :         PHY_INTERFACE_MODE_RGMII,
      64                 :            :         PHY_INTERFACE_MODE_RGMII_ID,
      65                 :            :         PHY_INTERFACE_MODE_RGMII_RXID,
      66                 :            :         PHY_INTERFACE_MODE_RGMII_TXID,
      67                 :            :         PHY_INTERFACE_MODE_RTBI,
      68                 :            :         PHY_INTERFACE_MODE_SMII,
      69                 :            : } phy_interface_t;
      70                 :            : 
      71                 :            : 
      72                 :            : #define PHY_INIT_TIMEOUT        100000
      73                 :            : #define PHY_STATE_TIME          1
      74                 :            : #define PHY_FORCE_TIMEOUT       10
      75                 :            : #define PHY_AN_TIMEOUT          10
      76                 :            : 
      77                 :            : #define PHY_MAX_ADDR    32
      78                 :            : 
      79                 :            : /* Used when trying to connect to a specific phy (mii bus id:phy device id) */
      80                 :            : #define PHY_ID_FMT "%s:%02x"
      81                 :            : 
      82                 :            : /*
      83                 :            :  * Need to be a little smaller than phydev->dev.bus_id to leave room
      84                 :            :  * for the ":%02x"
      85                 :            :  */
      86                 :            : #define MII_BUS_ID_SIZE (20 - 3)
      87                 :            : 
      88                 :            : /* Or MII_ADDR_C45 into regnum for read/write on mii_bus to enable the 21 bit
      89                 :            :    IEEE 802.3ae clause 45 addressing mode used by 10GIGE phy chips. */
      90                 :            : #define MII_ADDR_C45 (1<<30)
      91                 :            : 
      92                 :            : struct device;
      93                 :            : struct sk_buff;
      94                 :            : 
      95                 :            : /*
      96                 :            :  * The Bus class for PHYs.  Devices which provide access to
      97                 :            :  * PHYs should register using this structure
      98                 :            :  */
      99                 :            : struct mii_bus {
     100                 :            :         const char *name;
     101                 :            :         char id[MII_BUS_ID_SIZE];
     102                 :            :         void *priv;
     103                 :            :         int (*read)(struct mii_bus *bus, int phy_id, int regnum);
     104                 :            :         int (*write)(struct mii_bus *bus, int phy_id, int regnum, u16 val);
     105                 :            :         int (*reset)(struct mii_bus *bus);
     106                 :            : 
     107                 :            :         /*
     108                 :            :          * A lock to ensure that only one thing can read/write
     109                 :            :          * the MDIO bus at a time
     110                 :            :          */
     111                 :            :         struct mutex mdio_lock;
     112                 :            : 
     113                 :            :         struct device *parent;
     114                 :            :         enum {
     115                 :            :                 MDIOBUS_ALLOCATED = 1,
     116                 :            :                 MDIOBUS_REGISTERED,
     117                 :            :                 MDIOBUS_UNREGISTERED,
     118                 :            :                 MDIOBUS_RELEASED,
     119                 :            :         } state;
     120                 :            :         struct device dev;
     121                 :            : 
     122                 :            :         /* list of all PHYs on bus */
     123                 :            :         struct phy_device *phy_map[PHY_MAX_ADDR];
     124                 :            : 
     125                 :            :         /* PHY addresses to be ignored when probing */
     126                 :            :         u32 phy_mask;
     127                 :            : 
     128                 :            :         /*
     129                 :            :          * Pointer to an array of interrupts, each PHY's
     130                 :            :          * interrupt at the index matching its address
     131                 :            :          */
     132                 :            :         int *irq;
     133                 :            : };
     134                 :            : #define to_mii_bus(d) container_of(d, struct mii_bus, dev)
     135                 :            : 
     136                 :            : struct mii_bus *mdiobus_alloc_size(size_t);
     137                 :            : static inline struct mii_bus *mdiobus_alloc(void)
     138                 :            : {
     139                 :          0 :         return mdiobus_alloc_size(0);
     140                 :            : }
     141                 :            : 
     142                 :            : int mdiobus_register(struct mii_bus *bus);
     143                 :            : void mdiobus_unregister(struct mii_bus *bus);
     144                 :            : void mdiobus_free(struct mii_bus *bus);
     145                 :            : struct phy_device *mdiobus_scan(struct mii_bus *bus, int addr);
     146                 :            : int mdiobus_read(struct mii_bus *bus, int addr, u32 regnum);
     147                 :            : int mdiobus_write(struct mii_bus *bus, int addr, u32 regnum, u16 val);
     148                 :            : 
     149                 :            : 
     150                 :            : #define PHY_INTERRUPT_DISABLED  0x0
     151                 :            : #define PHY_INTERRUPT_ENABLED   0x80000000
     152                 :            : 
     153                 :            : /* PHY state machine states:
     154                 :            :  *
     155                 :            :  * DOWN: PHY device and driver are not ready for anything.  probe
     156                 :            :  * should be called if and only if the PHY is in this state,
     157                 :            :  * given that the PHY device exists.
     158                 :            :  * - PHY driver probe function will, depending on the PHY, set
     159                 :            :  * the state to STARTING or READY
     160                 :            :  *
     161                 :            :  * STARTING:  PHY device is coming up, and the ethernet driver is
     162                 :            :  * not ready.  PHY drivers may set this in the probe function.
     163                 :            :  * If they do, they are responsible for making sure the state is
     164                 :            :  * eventually set to indicate whether the PHY is UP or READY,
     165                 :            :  * depending on the state when the PHY is done starting up.
     166                 :            :  * - PHY driver will set the state to READY
     167                 :            :  * - start will set the state to PENDING
     168                 :            :  *
     169                 :            :  * READY: PHY is ready to send and receive packets, but the
     170                 :            :  * controller is not.  By default, PHYs which do not implement
     171                 :            :  * probe will be set to this state by phy_probe().  If the PHY
     172                 :            :  * driver knows the PHY is ready, and the PHY state is STARTING,
     173                 :            :  * then it sets this STATE.
     174                 :            :  * - start will set the state to UP
     175                 :            :  *
     176                 :            :  * PENDING: PHY device is coming up, but the ethernet driver is
     177                 :            :  * ready.  phy_start will set this state if the PHY state is
     178                 :            :  * STARTING.
     179                 :            :  * - PHY driver will set the state to UP when the PHY is ready
     180                 :            :  *
     181                 :            :  * UP: The PHY and attached device are ready to do work.
     182                 :            :  * Interrupts should be started here.
     183                 :            :  * - timer moves to AN
     184                 :            :  *
     185                 :            :  * AN: The PHY is currently negotiating the link state.  Link is
     186                 :            :  * therefore down for now.  phy_timer will set this state when it
     187                 :            :  * detects the state is UP.  config_aneg will set this state
     188                 :            :  * whenever called with phydev->autoneg set to AUTONEG_ENABLE.
     189                 :            :  * - If autonegotiation finishes, but there's no link, it sets
     190                 :            :  *   the state to NOLINK.
     191                 :            :  * - If aneg finishes with link, it sets the state to RUNNING,
     192                 :            :  *   and calls adjust_link
     193                 :            :  * - If autonegotiation did not finish after an arbitrary amount
     194                 :            :  *   of time, autonegotiation should be tried again if the PHY
     195                 :            :  *   supports "magic" autonegotiation (back to AN)
     196                 :            :  * - If it didn't finish, and no magic_aneg, move to FORCING.
     197                 :            :  *
     198                 :            :  * NOLINK: PHY is up, but not currently plugged in.
     199                 :            :  * - If the timer notes that the link comes back, we move to RUNNING
     200                 :            :  * - config_aneg moves to AN
     201                 :            :  * - phy_stop moves to HALTED
     202                 :            :  *
     203                 :            :  * FORCING: PHY is being configured with forced settings
     204                 :            :  * - if link is up, move to RUNNING
     205                 :            :  * - If link is down, we drop to the next highest setting, and
     206                 :            :  *   retry (FORCING) after a timeout
     207                 :            :  * - phy_stop moves to HALTED
     208                 :            :  *
     209                 :            :  * RUNNING: PHY is currently up, running, and possibly sending
     210                 :            :  * and/or receiving packets
     211                 :            :  * - timer will set CHANGELINK if we're polling (this ensures the
     212                 :            :  *   link state is polled every other cycle of this state machine,
     213                 :            :  *   which makes it every other second)
     214                 :            :  * - irq will set CHANGELINK
     215                 :            :  * - config_aneg will set AN
     216                 :            :  * - phy_stop moves to HALTED
     217                 :            :  *
     218                 :            :  * CHANGELINK: PHY experienced a change in link state
     219                 :            :  * - timer moves to RUNNING if link
     220                 :            :  * - timer moves to NOLINK if the link is down
     221                 :            :  * - phy_stop moves to HALTED
     222                 :            :  *
     223                 :            :  * HALTED: PHY is up, but no polling or interrupts are done. Or
     224                 :            :  * PHY is in an error state.
     225                 :            :  *
     226                 :            :  * - phy_start moves to RESUMING
     227                 :            :  *
     228                 :            :  * RESUMING: PHY was halted, but now wants to run again.
     229                 :            :  * - If we are forcing, or aneg is done, timer moves to RUNNING
     230                 :            :  * - If aneg is not done, timer moves to AN
     231                 :            :  * - phy_stop moves to HALTED
     232                 :            :  */
     233                 :            : enum phy_state {
     234                 :            :         PHY_DOWN=0,
     235                 :            :         PHY_STARTING,
     236                 :            :         PHY_READY,
     237                 :            :         PHY_PENDING,
     238                 :            :         PHY_UP,
     239                 :            :         PHY_AN,
     240                 :            :         PHY_RUNNING,
     241                 :            :         PHY_NOLINK,
     242                 :            :         PHY_FORCING,
     243                 :            :         PHY_CHANGELINK,
     244                 :            :         PHY_HALTED,
     245                 :            :         PHY_RESUMING
     246                 :            : };
     247                 :            : 
     248                 :            : /**
     249                 :            :  * struct phy_c45_device_ids - 802.3-c45 Device Identifiers
     250                 :            :  * @devices_in_package: Bit vector of devices present.
     251                 :            :  * @device_ids: The device identifer for each present device.
     252                 :            :  */
     253                 :            : struct phy_c45_device_ids {
     254                 :            :         u32 devices_in_package;
     255                 :            :         u32 device_ids[8];
     256                 :            : };
     257                 :            : 
     258                 :            : /* phy_device: An instance of a PHY
     259                 :            :  *
     260                 :            :  * drv: Pointer to the driver for this PHY instance
     261                 :            :  * bus: Pointer to the bus this PHY is on
     262                 :            :  * dev: driver model device structure for this PHY
     263                 :            :  * phy_id: UID for this device found during discovery
     264                 :            :  * c45_ids: 802.3-c45 Device Identifers if is_c45.
     265                 :            :  * is_c45:  Set to true if this phy uses clause 45 addressing.
     266                 :            :  * is_internal: Set to true if this phy is internal to a MAC.
     267                 :            :  * state: state of the PHY for management purposes
     268                 :            :  * dev_flags: Device-specific flags used by the PHY driver.
     269                 :            :  * addr: Bus address of PHY
     270                 :            :  * link_timeout: The number of timer firings to wait before the
     271                 :            :  * giving up on the current attempt at acquiring a link
     272                 :            :  * irq: IRQ number of the PHY's interrupt (-1 if none)
     273                 :            :  * phy_timer: The timer for handling the state machine
     274                 :            :  * phy_queue: A work_queue for the interrupt
     275                 :            :  * attached_dev: The attached enet driver's device instance ptr
     276                 :            :  * adjust_link: Callback for the enet controller to respond to
     277                 :            :  * changes in the link state.
     278                 :            :  * adjust_state: Callback for the enet driver to respond to
     279                 :            :  * changes in the state machine.
     280                 :            :  *
     281                 :            :  * speed, duplex, pause, supported, advertising, and
     282                 :            :  * autoneg are used like in mii_if_info
     283                 :            :  *
     284                 :            :  * interrupts currently only supports enabled or disabled,
     285                 :            :  * but could be changed in the future to support enabling
     286                 :            :  * and disabling specific interrupts
     287                 :            :  *
     288                 :            :  * Contains some infrastructure for polling and interrupt
     289                 :            :  * handling, as well as handling shifts in PHY hardware state
     290                 :            :  */
     291                 :            : struct phy_device {
     292                 :            :         /* Information about the PHY type */
     293                 :            :         /* And management functions */
     294                 :            :         struct phy_driver *drv;
     295                 :            : 
     296                 :            :         struct mii_bus *bus;
     297                 :            : 
     298                 :            :         struct device dev;
     299                 :            : 
     300                 :            :         u32 phy_id;
     301                 :            : 
     302                 :            :         struct phy_c45_device_ids c45_ids;
     303                 :            :         bool is_c45;
     304                 :            :         bool is_internal;
     305                 :            : 
     306                 :            :         enum phy_state state;
     307                 :            : 
     308                 :            :         u32 dev_flags;
     309                 :            : 
     310                 :            :         phy_interface_t interface;
     311                 :            : 
     312                 :            :         /* Bus address of the PHY (0-31) */
     313                 :            :         int addr;
     314                 :            : 
     315                 :            :         /*
     316                 :            :          * forced speed & duplex (no autoneg)
     317                 :            :          * partner speed & duplex & pause (autoneg)
     318                 :            :          */
     319                 :            :         int speed;
     320                 :            :         int duplex;
     321                 :            :         int pause;
     322                 :            :         int asym_pause;
     323                 :            : 
     324                 :            :         /* The most recently read link state */
     325                 :            :         int link;
     326                 :            : 
     327                 :            :         /* Enabled Interrupts */
     328                 :            :         u32 interrupts;
     329                 :            : 
     330                 :            :         /* Union of PHY and Attached devices' supported modes */
     331                 :            :         /* See mii.h for more info */
     332                 :            :         u32 supported;
     333                 :            :         u32 advertising;
     334                 :            : 
     335                 :            :         int autoneg;
     336                 :            : 
     337                 :            :         int link_timeout;
     338                 :            : 
     339                 :            :         /*
     340                 :            :          * Interrupt number for this PHY
     341                 :            :          * -1 means no interrupt
     342                 :            :          */
     343                 :            :         int irq;
     344                 :            : 
     345                 :            :         /* private data pointer */
     346                 :            :         /* For use by PHYs to maintain extra state */
     347                 :            :         void *priv;
     348                 :            : 
     349                 :            :         /* Interrupt and Polling infrastructure */
     350                 :            :         struct work_struct phy_queue;
     351                 :            :         struct delayed_work state_queue;
     352                 :            :         atomic_t irq_disable;
     353                 :            : 
     354                 :            :         struct mutex lock;
     355                 :            : 
     356                 :            :         struct net_device *attached_dev;
     357                 :            : 
     358                 :            :         void (*adjust_link)(struct net_device *dev);
     359                 :            : 
     360                 :            :         void (*adjust_state)(struct net_device *dev);
     361                 :            : };
     362                 :            : #define to_phy_device(d) container_of(d, struct phy_device, dev)
     363                 :            : 
     364                 :            : /* struct phy_driver: Driver structure for a particular PHY type
     365                 :            :  *
     366                 :            :  * phy_id: The result of reading the UID registers of this PHY
     367                 :            :  *   type, and ANDing them with the phy_id_mask.  This driver
     368                 :            :  *   only works for PHYs with IDs which match this field
     369                 :            :  * name: The friendly name of this PHY type
     370                 :            :  * phy_id_mask: Defines the important bits of the phy_id
     371                 :            :  * features: A list of features (speed, duplex, etc) supported
     372                 :            :  *   by this PHY
     373                 :            :  * flags: A bitfield defining certain other features this PHY
     374                 :            :  *   supports (like interrupts)
     375                 :            :  *
     376                 :            :  * The drivers must implement config_aneg and read_status.  All
     377                 :            :  * other functions are optional. Note that none of these
     378                 :            :  * functions should be called from interrupt time.  The goal is
     379                 :            :  * for the bus read/write functions to be able to block when the
     380                 :            :  * bus transaction is happening, and be freed up by an interrupt
     381                 :            :  * (The MPC85xx has this ability, though it is not currently
     382                 :            :  * supported in the driver).
     383                 :            :  */
     384                 :            : struct phy_driver {
     385                 :            :         u32 phy_id;
     386                 :            :         char *name;
     387                 :            :         unsigned int phy_id_mask;
     388                 :            :         u32 features;
     389                 :            :         u32 flags;
     390                 :            : 
     391                 :            :         /*
     392                 :            :          * Called to initialize the PHY,
     393                 :            :          * including after a reset
     394                 :            :          */
     395                 :            :         int (*config_init)(struct phy_device *phydev);
     396                 :            : 
     397                 :            :         /*
     398                 :            :          * Called during discovery.  Used to set
     399                 :            :          * up device-specific structures, if any
     400                 :            :          */
     401                 :            :         int (*probe)(struct phy_device *phydev);
     402                 :            : 
     403                 :            :         /* PHY Power Management */
     404                 :            :         int (*suspend)(struct phy_device *phydev);
     405                 :            :         int (*resume)(struct phy_device *phydev);
     406                 :            : 
     407                 :            :         /*
     408                 :            :          * Configures the advertisement and resets
     409                 :            :          * autonegotiation if phydev->autoneg is on,
     410                 :            :          * forces the speed to the current settings in phydev
     411                 :            :          * if phydev->autoneg is off
     412                 :            :          */
     413                 :            :         int (*config_aneg)(struct phy_device *phydev);
     414                 :            : 
     415                 :            :         /* Determines the negotiated speed and duplex */
     416                 :            :         int (*read_status)(struct phy_device *phydev);
     417                 :            : 
     418                 :            :         /* Clears any pending interrupts */
     419                 :            :         int (*ack_interrupt)(struct phy_device *phydev);
     420                 :            : 
     421                 :            :         /* Enables or disables interrupts */
     422                 :            :         int (*config_intr)(struct phy_device *phydev);
     423                 :            : 
     424                 :            :         /*
     425                 :            :          * Checks if the PHY generated an interrupt.
     426                 :            :          * For multi-PHY devices with shared PHY interrupt pin
     427                 :            :          */
     428                 :            :         int (*did_interrupt)(struct phy_device *phydev);
     429                 :            : 
     430                 :            :         /* Clears up any memory if needed */
     431                 :            :         void (*remove)(struct phy_device *phydev);
     432                 :            : 
     433                 :            :         /* Returns true if this is a suitable driver for the given
     434                 :            :          * phydev.  If NULL, matching is based on phy_id and
     435                 :            :          * phy_id_mask.
     436                 :            :          */
     437                 :            :         int (*match_phy_device)(struct phy_device *phydev);
     438                 :            : 
     439                 :            :         /* Handles ethtool queries for hardware time stamping. */
     440                 :            :         int (*ts_info)(struct phy_device *phydev, struct ethtool_ts_info *ti);
     441                 :            : 
     442                 :            :         /* Handles SIOCSHWTSTAMP ioctl for hardware time stamping. */
     443                 :            :         int  (*hwtstamp)(struct phy_device *phydev, struct ifreq *ifr);
     444                 :            : 
     445                 :            :         /*
     446                 :            :          * Requests a Rx timestamp for 'skb'. If the skb is accepted,
     447                 :            :          * the phy driver promises to deliver it using netif_rx() as
     448                 :            :          * soon as a timestamp becomes available. One of the
     449                 :            :          * PTP_CLASS_ values is passed in 'type'. The function must
     450                 :            :          * return true if the skb is accepted for delivery.
     451                 :            :          */
     452                 :            :         bool (*rxtstamp)(struct phy_device *dev, struct sk_buff *skb, int type);
     453                 :            : 
     454                 :            :         /*
     455                 :            :          * Requests a Tx timestamp for 'skb'. The phy driver promises
     456                 :            :          * to deliver it using skb_complete_tx_timestamp() as soon as a
     457                 :            :          * timestamp becomes available. One of the PTP_CLASS_ values
     458                 :            :          * is passed in 'type'.
     459                 :            :          */
     460                 :            :         void (*txtstamp)(struct phy_device *dev, struct sk_buff *skb, int type);
     461                 :            : 
     462                 :            :         /* Some devices (e.g. qnap TS-119P II) require PHY register changes to
     463                 :            :          * enable Wake on LAN, so set_wol is provided to be called in the
     464                 :            :          * ethernet driver's set_wol function. */
     465                 :            :         int (*set_wol)(struct phy_device *dev, struct ethtool_wolinfo *wol);
     466                 :            : 
     467                 :            :         /* See set_wol, but for checking whether Wake on LAN is enabled. */
     468                 :            :         void (*get_wol)(struct phy_device *dev, struct ethtool_wolinfo *wol);
     469                 :            : 
     470                 :            :         struct device_driver driver;
     471                 :            : };
     472                 :            : #define to_phy_driver(d) container_of(d, struct phy_driver, driver)
     473                 :            : 
     474                 :            : #define PHY_ANY_ID "MATCH ANY PHY"
     475                 :            : #define PHY_ANY_UID 0xffffffff
     476                 :            : 
     477                 :            : /* A Structure for boards to register fixups with the PHY Lib */
     478                 :            : struct phy_fixup {
     479                 :            :         struct list_head list;
     480                 :            :         char bus_id[20];
     481                 :            :         u32 phy_uid;
     482                 :            :         u32 phy_uid_mask;
     483                 :            :         int (*run)(struct phy_device *phydev);
     484                 :            : };
     485                 :            : 
     486                 :            : /**
     487                 :            :  * phy_read - Convenience function for reading a given PHY register
     488                 :            :  * @phydev: the phy_device struct
     489                 :            :  * @regnum: register number to read
     490                 :            :  *
     491                 :            :  * NOTE: MUST NOT be called from interrupt context,
     492                 :            :  * because the bus read/write functions may wait for an interrupt
     493                 :            :  * to conclude the operation.
     494                 :            :  */
     495                 :            : static inline int phy_read(struct phy_device *phydev, u32 regnum)
     496                 :            : {
     497                 :     174460 :         return mdiobus_read(phydev->bus, phydev->addr, regnum);
     498                 :            : }
     499                 :            : 
     500                 :            : /**
     501                 :            :  * phy_write - Convenience function for writing a given PHY register
     502                 :            :  * @phydev: the phy_device struct
     503                 :            :  * @regnum: register number to write
     504                 :            :  * @val: value to write to @regnum
     505                 :            :  *
     506                 :            :  * NOTE: MUST NOT be called from interrupt context,
     507                 :            :  * because the bus read/write functions may wait for an interrupt
     508                 :            :  * to conclude the operation.
     509                 :            :  */
     510                 :            : static inline int phy_write(struct phy_device *phydev, u32 regnum, u16 val)
     511                 :            : {
     512                 :          0 :         return mdiobus_write(phydev->bus, phydev->addr, regnum, val);
     513                 :            : }
     514                 :            : 
     515                 :            : /**
     516                 :            :  * phy_interrupt_is_valid - Convenience function for testing a given PHY irq
     517                 :            :  * @phydev: the phy_device struct
     518                 :            :  *
     519                 :            :  * NOTE: must be kept in sync with addition/removal of PHY_POLL and
     520                 :            :  * PHY_IGNORE_INTERRUPT
     521                 :            :  */
     522                 :            : static inline bool phy_interrupt_is_valid(struct phy_device *phydev)
     523                 :            : {
     524                 :      87229 :         return phydev->irq != PHY_POLL && phydev->irq != PHY_IGNORE_INTERRUPT;
     525                 :            : }
     526                 :            : 
     527                 :            : /**
     528                 :            :  * phy_is_internal - Convenience function for testing if a PHY is internal
     529                 :            :  * @phydev: the phy_device struct
     530                 :            :  */
     531                 :            : static inline bool phy_is_internal(struct phy_device *phydev)
     532                 :            : {
     533                 :            :         return phydev->is_internal;
     534                 :            : }
     535                 :            : 
     536                 :            : struct phy_device *phy_device_create(struct mii_bus *bus, int addr, int phy_id,
     537                 :            :                 bool is_c45, struct phy_c45_device_ids *c45_ids);
     538                 :            : struct phy_device *get_phy_device(struct mii_bus *bus, int addr, bool is_c45);
     539                 :            : int phy_device_register(struct phy_device *phy);
     540                 :            : int phy_init_hw(struct phy_device *phydev);
     541                 :            : struct phy_device * phy_attach(struct net_device *dev,
     542                 :            :                 const char *bus_id, phy_interface_t interface);
     543                 :            : struct phy_device *phy_find_first(struct mii_bus *bus);
     544                 :            : int phy_connect_direct(struct net_device *dev, struct phy_device *phydev,
     545                 :            :                 void (*handler)(struct net_device *),
     546                 :            :                 phy_interface_t interface);
     547                 :            : struct phy_device * phy_connect(struct net_device *dev, const char *bus_id,
     548                 :            :                 void (*handler)(struct net_device *),
     549                 :            :                 phy_interface_t interface);
     550                 :            : void phy_disconnect(struct phy_device *phydev);
     551                 :            : void phy_detach(struct phy_device *phydev);
     552                 :            : void phy_start(struct phy_device *phydev);
     553                 :            : void phy_stop(struct phy_device *phydev);
     554                 :            : int phy_start_aneg(struct phy_device *phydev);
     555                 :            : 
     556                 :            : int phy_stop_interrupts(struct phy_device *phydev);
     557                 :            : 
     558                 :            : static inline int phy_read_status(struct phy_device *phydev) {
     559                 :      43615 :         return phydev->drv->read_status(phydev);
     560                 :            : }
     561                 :            : 
     562                 :            : int genphy_setup_forced(struct phy_device *phydev);
     563                 :            : int genphy_restart_aneg(struct phy_device *phydev);
     564                 :            : int genphy_config_aneg(struct phy_device *phydev);
     565                 :            : int genphy_update_link(struct phy_device *phydev);
     566                 :            : int genphy_read_status(struct phy_device *phydev);
     567                 :            : int genphy_suspend(struct phy_device *phydev);
     568                 :            : int genphy_resume(struct phy_device *phydev);
     569                 :            : void phy_driver_unregister(struct phy_driver *drv);
     570                 :            : void phy_drivers_unregister(struct phy_driver *drv, int n);
     571                 :            : int phy_driver_register(struct phy_driver *new_driver);
     572                 :            : int phy_drivers_register(struct phy_driver *new_driver, int n);
     573                 :            : void phy_state_machine(struct work_struct *work);
     574                 :            : void phy_change(struct work_struct *work);
     575                 :            : void phy_mac_interrupt(struct phy_device *phydev, int new_link);
     576                 :            : void phy_start_machine(struct phy_device *phydev,
     577                 :            :                 void (*handler)(struct net_device *));
     578                 :            : void phy_stop_machine(struct phy_device *phydev);
     579                 :            : int phy_ethtool_sset(struct phy_device *phydev, struct ethtool_cmd *cmd);
     580                 :            : int phy_ethtool_gset(struct phy_device *phydev, struct ethtool_cmd *cmd);
     581                 :            : int phy_mii_ioctl(struct phy_device *phydev,
     582                 :            :                 struct ifreq *ifr, int cmd);
     583                 :            : int phy_start_interrupts(struct phy_device *phydev);
     584                 :            : void phy_print_status(struct phy_device *phydev);
     585                 :            : void phy_device_free(struct phy_device *phydev);
     586                 :            : 
     587                 :            : int phy_register_fixup(const char *bus_id, u32 phy_uid, u32 phy_uid_mask,
     588                 :            :                 int (*run)(struct phy_device *));
     589                 :            : int phy_register_fixup_for_id(const char *bus_id,
     590                 :            :                 int (*run)(struct phy_device *));
     591                 :            : int phy_register_fixup_for_uid(u32 phy_uid, u32 phy_uid_mask,
     592                 :            :                 int (*run)(struct phy_device *));
     593                 :            : int phy_scan_fixups(struct phy_device *phydev);
     594                 :            : 
     595                 :            : int phy_init_eee(struct phy_device *phydev, bool clk_stop_enable);
     596                 :            : int phy_get_eee_err(struct phy_device *phydev);
     597                 :            : int phy_ethtool_set_eee(struct phy_device *phydev, struct ethtool_eee *data);
     598                 :            : int phy_ethtool_get_eee(struct phy_device *phydev, struct ethtool_eee *data);
     599                 :            : int phy_ethtool_set_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol);
     600                 :            : void phy_ethtool_get_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol);
     601                 :            : 
     602                 :            : int __init mdio_bus_init(void);
     603                 :            : void mdio_bus_exit(void);
     604                 :            : 
     605                 :            : extern struct bus_type mdio_bus_type;
     606                 :            : #endif /* __PHY_H */

Generated by: LCOV version 1.9