phy.h 22 KB

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