phy.c 32 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268
  1. /* Framework for configuring and reading PHY devices
  2. * Based on code in sungem_phy.c and gianfar_phy.c
  3. *
  4. * Author: Andy Fleming
  5. *
  6. * Copyright (c) 2004 Freescale Semiconductor, Inc.
  7. * Copyright (c) 2006, 2007 Maciej W. Rozycki
  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. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  16. #include <linux/kernel.h>
  17. #include <linux/string.h>
  18. #include <linux/errno.h>
  19. #include <linux/unistd.h>
  20. #include <linux/interrupt.h>
  21. #include <linux/delay.h>
  22. #include <linux/netdevice.h>
  23. #include <linux/etherdevice.h>
  24. #include <linux/skbuff.h>
  25. #include <linux/mm.h>
  26. #include <linux/module.h>
  27. #include <linux/mii.h>
  28. #include <linux/ethtool.h>
  29. #include <linux/phy.h>
  30. #include <linux/timer.h>
  31. #include <linux/workqueue.h>
  32. #include <linux/mdio.h>
  33. #include <linux/io.h>
  34. #include <linux/uaccess.h>
  35. #include <linux/atomic.h>
  36. #include <asm/irq.h>
  37. static const char *phy_speed_to_str(int speed)
  38. {
  39. switch (speed) {
  40. case SPEED_10:
  41. return "10Mbps";
  42. case SPEED_100:
  43. return "100Mbps";
  44. case SPEED_1000:
  45. return "1Gbps";
  46. case SPEED_2500:
  47. return "2.5Gbps";
  48. case SPEED_10000:
  49. return "10Gbps";
  50. case SPEED_UNKNOWN:
  51. return "Unknown";
  52. default:
  53. return "Unsupported (update phy.c)";
  54. }
  55. }
  56. #define PHY_STATE_STR(_state) \
  57. case PHY_##_state: \
  58. return __stringify(_state); \
  59. static const char *phy_state_to_str(enum phy_state st)
  60. {
  61. switch (st) {
  62. PHY_STATE_STR(DOWN)
  63. PHY_STATE_STR(STARTING)
  64. PHY_STATE_STR(READY)
  65. PHY_STATE_STR(PENDING)
  66. PHY_STATE_STR(UP)
  67. PHY_STATE_STR(AN)
  68. PHY_STATE_STR(RUNNING)
  69. PHY_STATE_STR(NOLINK)
  70. PHY_STATE_STR(FORCING)
  71. PHY_STATE_STR(CHANGELINK)
  72. PHY_STATE_STR(HALTED)
  73. PHY_STATE_STR(RESUMING)
  74. }
  75. return NULL;
  76. }
  77. /**
  78. * phy_print_status - Convenience function to print out the current phy status
  79. * @phydev: the phy_device struct
  80. */
  81. void phy_print_status(struct phy_device *phydev)
  82. {
  83. if (phydev->link) {
  84. netdev_info(phydev->attached_dev,
  85. "Link is Up - %s/%s - flow control %s\n",
  86. phy_speed_to_str(phydev->speed),
  87. DUPLEX_FULL == phydev->duplex ? "Full" : "Half",
  88. phydev->pause ? "rx/tx" : "off");
  89. } else {
  90. netdev_info(phydev->attached_dev, "Link is Down\n");
  91. }
  92. }
  93. EXPORT_SYMBOL(phy_print_status);
  94. /**
  95. * phy_clear_interrupt - Ack the phy device's interrupt
  96. * @phydev: the phy_device struct
  97. *
  98. * If the @phydev driver has an ack_interrupt function, call it to
  99. * ack and clear the phy device's interrupt.
  100. *
  101. * Returns 0 on success or < 0 on error.
  102. */
  103. static int phy_clear_interrupt(struct phy_device *phydev)
  104. {
  105. if (phydev->drv->ack_interrupt)
  106. return phydev->drv->ack_interrupt(phydev);
  107. return 0;
  108. }
  109. /**
  110. * phy_config_interrupt - configure the PHY device for the requested interrupts
  111. * @phydev: the phy_device struct
  112. * @interrupts: interrupt flags to configure for this @phydev
  113. *
  114. * Returns 0 on success or < 0 on error.
  115. */
  116. static int phy_config_interrupt(struct phy_device *phydev, u32 interrupts)
  117. {
  118. phydev->interrupts = interrupts;
  119. if (phydev->drv->config_intr)
  120. return phydev->drv->config_intr(phydev);
  121. return 0;
  122. }
  123. /**
  124. * phy_aneg_done - return auto-negotiation status
  125. * @phydev: target phy_device struct
  126. *
  127. * Description: Return the auto-negotiation status from this @phydev
  128. * Returns > 0 on success or < 0 on error. 0 means that auto-negotiation
  129. * is still pending.
  130. */
  131. static inline int phy_aneg_done(struct phy_device *phydev)
  132. {
  133. if (phydev->drv->aneg_done)
  134. return phydev->drv->aneg_done(phydev);
  135. return genphy_aneg_done(phydev);
  136. }
  137. /* A structure for mapping a particular speed and duplex
  138. * combination to a particular SUPPORTED and ADVERTISED value
  139. */
  140. struct phy_setting {
  141. int speed;
  142. int duplex;
  143. u32 setting;
  144. };
  145. /* A mapping of all SUPPORTED settings to speed/duplex */
  146. static const struct phy_setting settings[] = {
  147. {
  148. .speed = SPEED_10000,
  149. .duplex = DUPLEX_FULL,
  150. .setting = SUPPORTED_10000baseKR_Full,
  151. },
  152. {
  153. .speed = SPEED_10000,
  154. .duplex = DUPLEX_FULL,
  155. .setting = SUPPORTED_10000baseKX4_Full,
  156. },
  157. {
  158. .speed = SPEED_10000,
  159. .duplex = DUPLEX_FULL,
  160. .setting = SUPPORTED_10000baseT_Full,
  161. },
  162. {
  163. .speed = SPEED_2500,
  164. .duplex = DUPLEX_FULL,
  165. .setting = SUPPORTED_2500baseX_Full,
  166. },
  167. {
  168. .speed = SPEED_1000,
  169. .duplex = DUPLEX_FULL,
  170. .setting = SUPPORTED_1000baseKX_Full,
  171. },
  172. {
  173. .speed = SPEED_1000,
  174. .duplex = DUPLEX_FULL,
  175. .setting = SUPPORTED_1000baseT_Full,
  176. },
  177. {
  178. .speed = SPEED_1000,
  179. .duplex = DUPLEX_HALF,
  180. .setting = SUPPORTED_1000baseT_Half,
  181. },
  182. {
  183. .speed = SPEED_100,
  184. .duplex = DUPLEX_FULL,
  185. .setting = SUPPORTED_100baseT_Full,
  186. },
  187. {
  188. .speed = SPEED_100,
  189. .duplex = DUPLEX_HALF,
  190. .setting = SUPPORTED_100baseT_Half,
  191. },
  192. {
  193. .speed = SPEED_10,
  194. .duplex = DUPLEX_FULL,
  195. .setting = SUPPORTED_10baseT_Full,
  196. },
  197. {
  198. .speed = SPEED_10,
  199. .duplex = DUPLEX_HALF,
  200. .setting = SUPPORTED_10baseT_Half,
  201. },
  202. };
  203. #define MAX_NUM_SETTINGS ARRAY_SIZE(settings)
  204. /**
  205. * phy_find_setting - find a PHY settings array entry that matches speed & duplex
  206. * @speed: speed to match
  207. * @duplex: duplex to match
  208. *
  209. * Description: Searches the settings array for the setting which
  210. * matches the desired speed and duplex, and returns the index
  211. * of that setting. Returns the index of the last setting if
  212. * none of the others match.
  213. */
  214. static inline unsigned int phy_find_setting(int speed, int duplex)
  215. {
  216. unsigned int idx = 0;
  217. while (idx < ARRAY_SIZE(settings) &&
  218. (settings[idx].speed != speed || settings[idx].duplex != duplex))
  219. idx++;
  220. return idx < MAX_NUM_SETTINGS ? idx : MAX_NUM_SETTINGS - 1;
  221. }
  222. /**
  223. * phy_find_valid - find a PHY setting that matches the requested features mask
  224. * @idx: The first index in settings[] to search
  225. * @features: A mask of the valid settings
  226. *
  227. * Description: Returns the index of the first valid setting less
  228. * than or equal to the one pointed to by idx, as determined by
  229. * the mask in features. Returns the index of the last setting
  230. * if nothing else matches.
  231. */
  232. static inline unsigned int phy_find_valid(unsigned int idx, u32 features)
  233. {
  234. while (idx < MAX_NUM_SETTINGS && !(settings[idx].setting & features))
  235. idx++;
  236. return idx < MAX_NUM_SETTINGS ? idx : MAX_NUM_SETTINGS - 1;
  237. }
  238. /**
  239. * phy_check_valid - check if there is a valid PHY setting which matches
  240. * speed, duplex, and feature mask
  241. * @speed: speed to match
  242. * @duplex: duplex to match
  243. * @features: A mask of the valid settings
  244. *
  245. * Description: Returns true if there is a valid setting, false otherwise.
  246. */
  247. static inline bool phy_check_valid(int speed, int duplex, u32 features)
  248. {
  249. unsigned int idx;
  250. idx = phy_find_valid(phy_find_setting(speed, duplex), features);
  251. return settings[idx].speed == speed && settings[idx].duplex == duplex &&
  252. (settings[idx].setting & features);
  253. }
  254. /**
  255. * phy_sanitize_settings - make sure the PHY is set to supported speed and duplex
  256. * @phydev: the target phy_device struct
  257. *
  258. * Description: Make sure the PHY is set to supported speeds and
  259. * duplexes. Drop down by one in this order: 1000/FULL,
  260. * 1000/HALF, 100/FULL, 100/HALF, 10/FULL, 10/HALF.
  261. */
  262. static void phy_sanitize_settings(struct phy_device *phydev)
  263. {
  264. u32 features = phydev->supported;
  265. unsigned int idx;
  266. /* Sanitize settings based on PHY capabilities */
  267. if ((features & SUPPORTED_Autoneg) == 0)
  268. phydev->autoneg = AUTONEG_DISABLE;
  269. idx = phy_find_valid(phy_find_setting(phydev->speed, phydev->duplex),
  270. features);
  271. phydev->speed = settings[idx].speed;
  272. phydev->duplex = settings[idx].duplex;
  273. }
  274. /**
  275. * phy_ethtool_sset - generic ethtool sset function, handles all the details
  276. * @phydev: target phy_device struct
  277. * @cmd: ethtool_cmd
  278. *
  279. * A few notes about parameter checking:
  280. * - We don't set port or transceiver, so we don't care what they
  281. * were set to.
  282. * - phy_start_aneg() will make sure forced settings are sane, and
  283. * choose the next best ones from the ones selected, so we don't
  284. * care if ethtool tries to give us bad values.
  285. */
  286. int phy_ethtool_sset(struct phy_device *phydev, struct ethtool_cmd *cmd)
  287. {
  288. u32 speed = ethtool_cmd_speed(cmd);
  289. if (cmd->phy_address != phydev->mdio.addr)
  290. return -EINVAL;
  291. /* We make sure that we don't pass unsupported values in to the PHY */
  292. cmd->advertising &= phydev->supported;
  293. /* Verify the settings we care about. */
  294. if (cmd->autoneg != AUTONEG_ENABLE && cmd->autoneg != AUTONEG_DISABLE)
  295. return -EINVAL;
  296. if (cmd->autoneg == AUTONEG_ENABLE && cmd->advertising == 0)
  297. return -EINVAL;
  298. if (cmd->autoneg == AUTONEG_DISABLE &&
  299. ((speed != SPEED_1000 &&
  300. speed != SPEED_100 &&
  301. speed != SPEED_10) ||
  302. (cmd->duplex != DUPLEX_HALF &&
  303. cmd->duplex != DUPLEX_FULL)))
  304. return -EINVAL;
  305. phydev->autoneg = cmd->autoneg;
  306. phydev->speed = speed;
  307. phydev->advertising = cmd->advertising;
  308. if (AUTONEG_ENABLE == cmd->autoneg)
  309. phydev->advertising |= ADVERTISED_Autoneg;
  310. else
  311. phydev->advertising &= ~ADVERTISED_Autoneg;
  312. phydev->duplex = cmd->duplex;
  313. phydev->mdix = cmd->eth_tp_mdix_ctrl;
  314. /* Restart the PHY */
  315. phy_start_aneg(phydev);
  316. return 0;
  317. }
  318. EXPORT_SYMBOL(phy_ethtool_sset);
  319. int phy_ethtool_gset(struct phy_device *phydev, struct ethtool_cmd *cmd)
  320. {
  321. cmd->supported = phydev->supported;
  322. cmd->advertising = phydev->advertising;
  323. cmd->lp_advertising = phydev->lp_advertising;
  324. ethtool_cmd_speed_set(cmd, phydev->speed);
  325. cmd->duplex = phydev->duplex;
  326. if (phydev->interface == PHY_INTERFACE_MODE_MOCA)
  327. cmd->port = PORT_BNC;
  328. else
  329. cmd->port = PORT_MII;
  330. cmd->phy_address = phydev->mdio.addr;
  331. cmd->transceiver = phy_is_internal(phydev) ?
  332. XCVR_INTERNAL : XCVR_EXTERNAL;
  333. cmd->autoneg = phydev->autoneg;
  334. cmd->eth_tp_mdix_ctrl = phydev->mdix;
  335. return 0;
  336. }
  337. EXPORT_SYMBOL(phy_ethtool_gset);
  338. /**
  339. * phy_mii_ioctl - generic PHY MII ioctl interface
  340. * @phydev: the phy_device struct
  341. * @ifr: &struct ifreq for socket ioctl's
  342. * @cmd: ioctl cmd to execute
  343. *
  344. * Note that this function is currently incompatible with the
  345. * PHYCONTROL layer. It changes registers without regard to
  346. * current state. Use at own risk.
  347. */
  348. int phy_mii_ioctl(struct phy_device *phydev, struct ifreq *ifr, int cmd)
  349. {
  350. struct mii_ioctl_data *mii_data = if_mii(ifr);
  351. u16 val = mii_data->val_in;
  352. bool change_autoneg = false;
  353. switch (cmd) {
  354. case SIOCGMIIPHY:
  355. mii_data->phy_id = phydev->mdio.addr;
  356. /* fall through */
  357. case SIOCGMIIREG:
  358. mii_data->val_out = mdiobus_read(phydev->mdio.bus,
  359. mii_data->phy_id,
  360. mii_data->reg_num);
  361. return 0;
  362. case SIOCSMIIREG:
  363. if (mii_data->phy_id == phydev->mdio.addr) {
  364. switch (mii_data->reg_num) {
  365. case MII_BMCR:
  366. if ((val & (BMCR_RESET | BMCR_ANENABLE)) == 0) {
  367. if (phydev->autoneg == AUTONEG_ENABLE)
  368. change_autoneg = true;
  369. phydev->autoneg = AUTONEG_DISABLE;
  370. if (val & BMCR_FULLDPLX)
  371. phydev->duplex = DUPLEX_FULL;
  372. else
  373. phydev->duplex = DUPLEX_HALF;
  374. if (val & BMCR_SPEED1000)
  375. phydev->speed = SPEED_1000;
  376. else if (val & BMCR_SPEED100)
  377. phydev->speed = SPEED_100;
  378. else phydev->speed = SPEED_10;
  379. }
  380. else {
  381. if (phydev->autoneg == AUTONEG_DISABLE)
  382. change_autoneg = true;
  383. phydev->autoneg = AUTONEG_ENABLE;
  384. }
  385. break;
  386. case MII_ADVERTISE:
  387. phydev->advertising = mii_adv_to_ethtool_adv_t(val);
  388. change_autoneg = true;
  389. break;
  390. default:
  391. /* do nothing */
  392. break;
  393. }
  394. }
  395. mdiobus_write(phydev->mdio.bus, mii_data->phy_id,
  396. mii_data->reg_num, val);
  397. if (mii_data->phy_id == phydev->mdio.addr &&
  398. mii_data->reg_num == MII_BMCR &&
  399. val & BMCR_RESET)
  400. return phy_init_hw(phydev);
  401. if (change_autoneg)
  402. return phy_start_aneg(phydev);
  403. return 0;
  404. case SIOCSHWTSTAMP:
  405. if (phydev->drv->hwtstamp)
  406. return phydev->drv->hwtstamp(phydev, ifr);
  407. /* fall through */
  408. default:
  409. return -EOPNOTSUPP;
  410. }
  411. }
  412. EXPORT_SYMBOL(phy_mii_ioctl);
  413. /**
  414. * phy_start_aneg - start auto-negotiation for this PHY device
  415. * @phydev: the phy_device struct
  416. *
  417. * Description: Sanitizes the settings (if we're not autonegotiating
  418. * them), and then calls the driver's config_aneg function.
  419. * If the PHYCONTROL Layer is operating, we change the state to
  420. * reflect the beginning of Auto-negotiation or forcing.
  421. */
  422. int phy_start_aneg(struct phy_device *phydev)
  423. {
  424. int err;
  425. mutex_lock(&phydev->lock);
  426. if (AUTONEG_DISABLE == phydev->autoneg)
  427. phy_sanitize_settings(phydev);
  428. /* Invalidate LP advertising flags */
  429. phydev->lp_advertising = 0;
  430. err = phydev->drv->config_aneg(phydev);
  431. if (err < 0)
  432. goto out_unlock;
  433. if (phydev->state != PHY_HALTED) {
  434. if (AUTONEG_ENABLE == phydev->autoneg) {
  435. phydev->state = PHY_AN;
  436. phydev->link_timeout = PHY_AN_TIMEOUT;
  437. } else {
  438. phydev->state = PHY_FORCING;
  439. phydev->link_timeout = PHY_FORCE_TIMEOUT;
  440. }
  441. }
  442. out_unlock:
  443. mutex_unlock(&phydev->lock);
  444. return err;
  445. }
  446. EXPORT_SYMBOL(phy_start_aneg);
  447. /**
  448. * phy_start_machine - start PHY state machine tracking
  449. * @phydev: the phy_device struct
  450. *
  451. * Description: The PHY infrastructure can run a state machine
  452. * which tracks whether the PHY is starting up, negotiating,
  453. * etc. This function starts the timer which tracks the state
  454. * of the PHY. If you want to maintain your own state machine,
  455. * do not call this function.
  456. */
  457. void phy_start_machine(struct phy_device *phydev)
  458. {
  459. queue_delayed_work(system_power_efficient_wq, &phydev->state_queue, HZ);
  460. }
  461. /**
  462. * phy_stop_machine - stop the PHY state machine tracking
  463. * @phydev: target phy_device struct
  464. *
  465. * Description: Stops the state machine timer, sets the state to UP
  466. * (unless it wasn't up yet). This function must be called BEFORE
  467. * phy_detach.
  468. */
  469. void phy_stop_machine(struct phy_device *phydev)
  470. {
  471. cancel_delayed_work_sync(&phydev->state_queue);
  472. mutex_lock(&phydev->lock);
  473. if (phydev->state > PHY_UP)
  474. phydev->state = PHY_UP;
  475. mutex_unlock(&phydev->lock);
  476. }
  477. /**
  478. * phy_error - enter HALTED state for this PHY device
  479. * @phydev: target phy_device struct
  480. *
  481. * Moves the PHY to the HALTED state in response to a read
  482. * or write error, and tells the controller the link is down.
  483. * Must not be called from interrupt context, or while the
  484. * phydev->lock is held.
  485. */
  486. static void phy_error(struct phy_device *phydev)
  487. {
  488. mutex_lock(&phydev->lock);
  489. phydev->state = PHY_HALTED;
  490. mutex_unlock(&phydev->lock);
  491. }
  492. /**
  493. * phy_interrupt - PHY interrupt handler
  494. * @irq: interrupt line
  495. * @phy_dat: phy_device pointer
  496. *
  497. * Description: When a PHY interrupt occurs, the handler disables
  498. * interrupts, and schedules a work task to clear the interrupt.
  499. */
  500. static irqreturn_t phy_interrupt(int irq, void *phy_dat)
  501. {
  502. struct phy_device *phydev = phy_dat;
  503. if (PHY_HALTED == phydev->state)
  504. return IRQ_NONE; /* It can't be ours. */
  505. /* The MDIO bus is not allowed to be written in interrupt
  506. * context, so we need to disable the irq here. A work
  507. * queue will write the PHY to disable and clear the
  508. * interrupt, and then reenable the irq line.
  509. */
  510. disable_irq_nosync(irq);
  511. atomic_inc(&phydev->irq_disable);
  512. queue_work(system_power_efficient_wq, &phydev->phy_queue);
  513. return IRQ_HANDLED;
  514. }
  515. /**
  516. * phy_enable_interrupts - Enable the interrupts from the PHY side
  517. * @phydev: target phy_device struct
  518. */
  519. static int phy_enable_interrupts(struct phy_device *phydev)
  520. {
  521. int err = phy_clear_interrupt(phydev);
  522. if (err < 0)
  523. return err;
  524. return phy_config_interrupt(phydev, PHY_INTERRUPT_ENABLED);
  525. }
  526. /**
  527. * phy_disable_interrupts - Disable the PHY interrupts from the PHY side
  528. * @phydev: target phy_device struct
  529. */
  530. static int phy_disable_interrupts(struct phy_device *phydev)
  531. {
  532. int err;
  533. /* Disable PHY interrupts */
  534. err = phy_config_interrupt(phydev, PHY_INTERRUPT_DISABLED);
  535. if (err)
  536. goto phy_err;
  537. /* Clear the interrupt */
  538. err = phy_clear_interrupt(phydev);
  539. if (err)
  540. goto phy_err;
  541. return 0;
  542. phy_err:
  543. phy_error(phydev);
  544. return err;
  545. }
  546. /**
  547. * phy_start_interrupts - request and enable interrupts for a PHY device
  548. * @phydev: target phy_device struct
  549. *
  550. * Description: Request the interrupt for the given PHY.
  551. * If this fails, then we set irq to PHY_POLL.
  552. * Otherwise, we enable the interrupts in the PHY.
  553. * This should only be called with a valid IRQ number.
  554. * Returns 0 on success or < 0 on error.
  555. */
  556. int phy_start_interrupts(struct phy_device *phydev)
  557. {
  558. atomic_set(&phydev->irq_disable, 0);
  559. if (request_irq(phydev->irq, phy_interrupt, 0, "phy_interrupt",
  560. phydev) < 0) {
  561. pr_warn("%s: Can't get IRQ %d (PHY)\n",
  562. phydev->mdio.bus->name, phydev->irq);
  563. phydev->irq = PHY_POLL;
  564. return 0;
  565. }
  566. return phy_enable_interrupts(phydev);
  567. }
  568. EXPORT_SYMBOL(phy_start_interrupts);
  569. /**
  570. * phy_stop_interrupts - disable interrupts from a PHY device
  571. * @phydev: target phy_device struct
  572. */
  573. int phy_stop_interrupts(struct phy_device *phydev)
  574. {
  575. int err = phy_disable_interrupts(phydev);
  576. if (err)
  577. phy_error(phydev);
  578. free_irq(phydev->irq, phydev);
  579. /* Cannot call flush_scheduled_work() here as desired because
  580. * of rtnl_lock(), but we do not really care about what would
  581. * be done, except from enable_irq(), so cancel any work
  582. * possibly pending and take care of the matter below.
  583. */
  584. cancel_work_sync(&phydev->phy_queue);
  585. /* If work indeed has been cancelled, disable_irq() will have
  586. * been left unbalanced from phy_interrupt() and enable_irq()
  587. * has to be called so that other devices on the line work.
  588. */
  589. while (atomic_dec_return(&phydev->irq_disable) >= 0)
  590. enable_irq(phydev->irq);
  591. return err;
  592. }
  593. EXPORT_SYMBOL(phy_stop_interrupts);
  594. /**
  595. * phy_change - Scheduled by the phy_interrupt/timer to handle PHY changes
  596. * @work: work_struct that describes the work to be done
  597. */
  598. void phy_change(struct work_struct *work)
  599. {
  600. struct phy_device *phydev =
  601. container_of(work, struct phy_device, phy_queue);
  602. if (phy_interrupt_is_valid(phydev)) {
  603. if (phydev->drv->did_interrupt &&
  604. !phydev->drv->did_interrupt(phydev))
  605. goto ignore;
  606. if (phy_disable_interrupts(phydev))
  607. goto phy_err;
  608. }
  609. mutex_lock(&phydev->lock);
  610. if ((PHY_RUNNING == phydev->state) || (PHY_NOLINK == phydev->state))
  611. phydev->state = PHY_CHANGELINK;
  612. mutex_unlock(&phydev->lock);
  613. if (phy_interrupt_is_valid(phydev)) {
  614. atomic_dec(&phydev->irq_disable);
  615. enable_irq(phydev->irq);
  616. /* Reenable interrupts */
  617. if (PHY_HALTED != phydev->state &&
  618. phy_config_interrupt(phydev, PHY_INTERRUPT_ENABLED))
  619. goto irq_enable_err;
  620. }
  621. /* reschedule state queue work to run as soon as possible */
  622. cancel_delayed_work_sync(&phydev->state_queue);
  623. queue_delayed_work(system_power_efficient_wq, &phydev->state_queue, 0);
  624. return;
  625. ignore:
  626. atomic_dec(&phydev->irq_disable);
  627. enable_irq(phydev->irq);
  628. return;
  629. irq_enable_err:
  630. disable_irq(phydev->irq);
  631. atomic_inc(&phydev->irq_disable);
  632. phy_err:
  633. phy_error(phydev);
  634. }
  635. /**
  636. * phy_stop - Bring down the PHY link, and stop checking the status
  637. * @phydev: target phy_device struct
  638. */
  639. void phy_stop(struct phy_device *phydev)
  640. {
  641. mutex_lock(&phydev->lock);
  642. if (PHY_HALTED == phydev->state)
  643. goto out_unlock;
  644. if (phy_interrupt_is_valid(phydev)) {
  645. /* Disable PHY Interrupts */
  646. phy_config_interrupt(phydev, PHY_INTERRUPT_DISABLED);
  647. /* Clear any pending interrupts */
  648. phy_clear_interrupt(phydev);
  649. }
  650. phydev->state = PHY_HALTED;
  651. out_unlock:
  652. mutex_unlock(&phydev->lock);
  653. /* Cannot call flush_scheduled_work() here as desired because
  654. * of rtnl_lock(), but PHY_HALTED shall guarantee phy_change()
  655. * will not reenable interrupts.
  656. */
  657. }
  658. EXPORT_SYMBOL(phy_stop);
  659. /**
  660. * phy_start - start or restart a PHY device
  661. * @phydev: target phy_device struct
  662. *
  663. * Description: Indicates the attached device's readiness to
  664. * handle PHY-related work. Used during startup to start the
  665. * PHY, and after a call to phy_stop() to resume operation.
  666. * Also used to indicate the MDIO bus has cleared an error
  667. * condition.
  668. */
  669. void phy_start(struct phy_device *phydev)
  670. {
  671. bool do_resume = false;
  672. int err = 0;
  673. mutex_lock(&phydev->lock);
  674. switch (phydev->state) {
  675. case PHY_STARTING:
  676. phydev->state = PHY_PENDING;
  677. break;
  678. case PHY_READY:
  679. phydev->state = PHY_UP;
  680. break;
  681. case PHY_HALTED:
  682. /* make sure interrupts are re-enabled for the PHY */
  683. err = phy_enable_interrupts(phydev);
  684. if (err < 0)
  685. break;
  686. phydev->state = PHY_RESUMING;
  687. do_resume = true;
  688. break;
  689. default:
  690. break;
  691. }
  692. mutex_unlock(&phydev->lock);
  693. /* if phy was suspended, bring the physical link up again */
  694. if (do_resume)
  695. phy_resume(phydev);
  696. }
  697. EXPORT_SYMBOL(phy_start);
  698. /**
  699. * phy_state_machine - Handle the state machine
  700. * @work: work_struct that describes the work to be done
  701. */
  702. void phy_state_machine(struct work_struct *work)
  703. {
  704. struct delayed_work *dwork = to_delayed_work(work);
  705. struct phy_device *phydev =
  706. container_of(dwork, struct phy_device, state_queue);
  707. bool needs_aneg = false, do_suspend = false;
  708. enum phy_state old_state;
  709. int err = 0;
  710. int old_link;
  711. mutex_lock(&phydev->lock);
  712. old_state = phydev->state;
  713. if (phydev->drv->link_change_notify)
  714. phydev->drv->link_change_notify(phydev);
  715. switch (phydev->state) {
  716. case PHY_DOWN:
  717. case PHY_STARTING:
  718. case PHY_READY:
  719. case PHY_PENDING:
  720. break;
  721. case PHY_UP:
  722. needs_aneg = true;
  723. phydev->link_timeout = PHY_AN_TIMEOUT;
  724. break;
  725. case PHY_AN:
  726. err = phy_read_status(phydev);
  727. if (err < 0)
  728. break;
  729. /* If the link is down, give up on negotiation for now */
  730. if (!phydev->link) {
  731. phydev->state = PHY_NOLINK;
  732. netif_carrier_off(phydev->attached_dev);
  733. phydev->adjust_link(phydev->attached_dev);
  734. break;
  735. }
  736. /* Check if negotiation is done. Break if there's an error */
  737. err = phy_aneg_done(phydev);
  738. if (err < 0)
  739. break;
  740. /* If AN is done, we're running */
  741. if (err > 0) {
  742. phydev->state = PHY_RUNNING;
  743. netif_carrier_on(phydev->attached_dev);
  744. phydev->adjust_link(phydev->attached_dev);
  745. } else if (0 == phydev->link_timeout--)
  746. needs_aneg = true;
  747. break;
  748. case PHY_NOLINK:
  749. if (phy_interrupt_is_valid(phydev))
  750. break;
  751. err = phy_read_status(phydev);
  752. if (err)
  753. break;
  754. if (phydev->link) {
  755. if (AUTONEG_ENABLE == phydev->autoneg) {
  756. err = phy_aneg_done(phydev);
  757. if (err < 0)
  758. break;
  759. if (!err) {
  760. phydev->state = PHY_AN;
  761. phydev->link_timeout = PHY_AN_TIMEOUT;
  762. break;
  763. }
  764. }
  765. phydev->state = PHY_RUNNING;
  766. netif_carrier_on(phydev->attached_dev);
  767. phydev->adjust_link(phydev->attached_dev);
  768. }
  769. break;
  770. case PHY_FORCING:
  771. err = genphy_update_link(phydev);
  772. if (err)
  773. break;
  774. if (phydev->link) {
  775. phydev->state = PHY_RUNNING;
  776. netif_carrier_on(phydev->attached_dev);
  777. } else {
  778. if (0 == phydev->link_timeout--)
  779. needs_aneg = true;
  780. }
  781. phydev->adjust_link(phydev->attached_dev);
  782. break;
  783. case PHY_RUNNING:
  784. /* Only register a CHANGE if we are polling and link changed
  785. * since latest checking.
  786. */
  787. if (phydev->irq == PHY_POLL) {
  788. old_link = phydev->link;
  789. err = phy_read_status(phydev);
  790. if (err)
  791. break;
  792. if (old_link != phydev->link)
  793. phydev->state = PHY_CHANGELINK;
  794. }
  795. break;
  796. case PHY_CHANGELINK:
  797. err = phy_read_status(phydev);
  798. if (err)
  799. break;
  800. if (phydev->link) {
  801. phydev->state = PHY_RUNNING;
  802. netif_carrier_on(phydev->attached_dev);
  803. } else {
  804. phydev->state = PHY_NOLINK;
  805. netif_carrier_off(phydev->attached_dev);
  806. }
  807. phydev->adjust_link(phydev->attached_dev);
  808. if (phy_interrupt_is_valid(phydev))
  809. err = phy_config_interrupt(phydev,
  810. PHY_INTERRUPT_ENABLED);
  811. break;
  812. case PHY_HALTED:
  813. if (phydev->link) {
  814. phydev->link = 0;
  815. netif_carrier_off(phydev->attached_dev);
  816. phydev->adjust_link(phydev->attached_dev);
  817. do_suspend = true;
  818. }
  819. break;
  820. case PHY_RESUMING:
  821. if (AUTONEG_ENABLE == phydev->autoneg) {
  822. err = phy_aneg_done(phydev);
  823. if (err < 0)
  824. break;
  825. /* err > 0 if AN is done.
  826. * Otherwise, it's 0, and we're still waiting for AN
  827. */
  828. if (err > 0) {
  829. err = phy_read_status(phydev);
  830. if (err)
  831. break;
  832. if (phydev->link) {
  833. phydev->state = PHY_RUNNING;
  834. netif_carrier_on(phydev->attached_dev);
  835. } else {
  836. phydev->state = PHY_NOLINK;
  837. }
  838. phydev->adjust_link(phydev->attached_dev);
  839. } else {
  840. phydev->state = PHY_AN;
  841. phydev->link_timeout = PHY_AN_TIMEOUT;
  842. }
  843. } else {
  844. err = phy_read_status(phydev);
  845. if (err)
  846. break;
  847. if (phydev->link) {
  848. phydev->state = PHY_RUNNING;
  849. netif_carrier_on(phydev->attached_dev);
  850. } else {
  851. phydev->state = PHY_NOLINK;
  852. }
  853. phydev->adjust_link(phydev->attached_dev);
  854. }
  855. break;
  856. }
  857. mutex_unlock(&phydev->lock);
  858. if (needs_aneg)
  859. err = phy_start_aneg(phydev);
  860. else if (do_suspend)
  861. phy_suspend(phydev);
  862. if (err < 0)
  863. phy_error(phydev);
  864. phydev_dbg(phydev, "PHY state change %s -> %s\n",
  865. phy_state_to_str(old_state),
  866. phy_state_to_str(phydev->state));
  867. /* Only re-schedule a PHY state machine change if we are polling the
  868. * PHY, if PHY_IGNORE_INTERRUPT is set, then we will be moving
  869. * between states from phy_mac_interrupt()
  870. */
  871. if (phydev->irq == PHY_POLL)
  872. queue_delayed_work(system_power_efficient_wq, &phydev->state_queue,
  873. PHY_STATE_TIME * HZ);
  874. }
  875. void phy_mac_interrupt(struct phy_device *phydev, int new_link)
  876. {
  877. phydev->link = new_link;
  878. /* Trigger a state machine change */
  879. queue_work(system_power_efficient_wq, &phydev->phy_queue);
  880. }
  881. EXPORT_SYMBOL(phy_mac_interrupt);
  882. static inline void mmd_phy_indirect(struct mii_bus *bus, int prtad, int devad,
  883. int addr)
  884. {
  885. /* Write the desired MMD Devad */
  886. bus->write(bus, addr, MII_MMD_CTRL, devad);
  887. /* Write the desired MMD register address */
  888. bus->write(bus, addr, MII_MMD_DATA, prtad);
  889. /* Select the Function : DATA with no post increment */
  890. bus->write(bus, addr, MII_MMD_CTRL, (devad | MII_MMD_CTRL_NOINCR));
  891. }
  892. /**
  893. * phy_read_mmd_indirect - reads data from the MMD registers
  894. * @phydev: The PHY device bus
  895. * @prtad: MMD Address
  896. * @devad: MMD DEVAD
  897. *
  898. * Description: it reads data from the MMD registers (clause 22 to access to
  899. * clause 45) of the specified phy address.
  900. * To read these register we have:
  901. * 1) Write reg 13 // DEVAD
  902. * 2) Write reg 14 // MMD Address
  903. * 3) Write reg 13 // MMD Data Command for MMD DEVAD
  904. * 3) Read reg 14 // Read MMD data
  905. */
  906. int phy_read_mmd_indirect(struct phy_device *phydev, int prtad, int devad)
  907. {
  908. struct phy_driver *phydrv = phydev->drv;
  909. int addr = phydev->mdio.addr;
  910. int value = -1;
  911. if (!phydrv->read_mmd_indirect) {
  912. struct mii_bus *bus = phydev->mdio.bus;
  913. mutex_lock(&bus->mdio_lock);
  914. mmd_phy_indirect(bus, prtad, devad, addr);
  915. /* Read the content of the MMD's selected register */
  916. value = bus->read(bus, addr, MII_MMD_DATA);
  917. mutex_unlock(&bus->mdio_lock);
  918. } else {
  919. value = phydrv->read_mmd_indirect(phydev, prtad, devad, addr);
  920. }
  921. return value;
  922. }
  923. EXPORT_SYMBOL(phy_read_mmd_indirect);
  924. /**
  925. * phy_write_mmd_indirect - writes data to the MMD registers
  926. * @phydev: The PHY device
  927. * @prtad: MMD Address
  928. * @devad: MMD DEVAD
  929. * @data: data to write in the MMD register
  930. *
  931. * Description: Write data from the MMD registers of the specified
  932. * phy address.
  933. * To write these register we have:
  934. * 1) Write reg 13 // DEVAD
  935. * 2) Write reg 14 // MMD Address
  936. * 3) Write reg 13 // MMD Data Command for MMD DEVAD
  937. * 3) Write reg 14 // Write MMD data
  938. */
  939. void phy_write_mmd_indirect(struct phy_device *phydev, int prtad,
  940. int devad, u32 data)
  941. {
  942. struct phy_driver *phydrv = phydev->drv;
  943. int addr = phydev->mdio.addr;
  944. if (!phydrv->write_mmd_indirect) {
  945. struct mii_bus *bus = phydev->mdio.bus;
  946. mutex_lock(&bus->mdio_lock);
  947. mmd_phy_indirect(bus, prtad, devad, addr);
  948. /* Write the data into MMD's selected register */
  949. bus->write(bus, addr, MII_MMD_DATA, data);
  950. mutex_unlock(&bus->mdio_lock);
  951. } else {
  952. phydrv->write_mmd_indirect(phydev, prtad, devad, addr, data);
  953. }
  954. }
  955. EXPORT_SYMBOL(phy_write_mmd_indirect);
  956. /**
  957. * phy_init_eee - init and check the EEE feature
  958. * @phydev: target phy_device struct
  959. * @clk_stop_enable: PHY may stop the clock during LPI
  960. *
  961. * Description: it checks if the Energy-Efficient Ethernet (EEE)
  962. * is supported by looking at the MMD registers 3.20 and 7.60/61
  963. * and it programs the MMD register 3.0 setting the "Clock stop enable"
  964. * bit if required.
  965. */
  966. int phy_init_eee(struct phy_device *phydev, bool clk_stop_enable)
  967. {
  968. /* According to 802.3az,the EEE is supported only in full duplex-mode.
  969. * Also EEE feature is active when core is operating with MII, GMII
  970. * or RGMII (all kinds). Internal PHYs are also allowed to proceed and
  971. * should return an error if they do not support EEE.
  972. */
  973. if ((phydev->duplex == DUPLEX_FULL) &&
  974. ((phydev->interface == PHY_INTERFACE_MODE_MII) ||
  975. (phydev->interface == PHY_INTERFACE_MODE_GMII) ||
  976. phy_interface_is_rgmii(phydev) ||
  977. phy_is_internal(phydev))) {
  978. int eee_lp, eee_cap, eee_adv;
  979. u32 lp, cap, adv;
  980. int status;
  981. /* Read phy status to properly get the right settings */
  982. status = phy_read_status(phydev);
  983. if (status)
  984. return status;
  985. /* First check if the EEE ability is supported */
  986. eee_cap = phy_read_mmd_indirect(phydev, MDIO_PCS_EEE_ABLE,
  987. MDIO_MMD_PCS);
  988. if (eee_cap <= 0)
  989. goto eee_exit_err;
  990. cap = mmd_eee_cap_to_ethtool_sup_t(eee_cap);
  991. if (!cap)
  992. goto eee_exit_err;
  993. /* Check which link settings negotiated and verify it in
  994. * the EEE advertising registers.
  995. */
  996. eee_lp = phy_read_mmd_indirect(phydev, MDIO_AN_EEE_LPABLE,
  997. MDIO_MMD_AN);
  998. if (eee_lp <= 0)
  999. goto eee_exit_err;
  1000. eee_adv = phy_read_mmd_indirect(phydev, MDIO_AN_EEE_ADV,
  1001. MDIO_MMD_AN);
  1002. if (eee_adv <= 0)
  1003. goto eee_exit_err;
  1004. adv = mmd_eee_adv_to_ethtool_adv_t(eee_adv);
  1005. lp = mmd_eee_adv_to_ethtool_adv_t(eee_lp);
  1006. if (!phy_check_valid(phydev->speed, phydev->duplex, lp & adv))
  1007. goto eee_exit_err;
  1008. if (clk_stop_enable) {
  1009. /* Configure the PHY to stop receiving xMII
  1010. * clock while it is signaling LPI.
  1011. */
  1012. int val = phy_read_mmd_indirect(phydev, MDIO_CTRL1,
  1013. MDIO_MMD_PCS);
  1014. if (val < 0)
  1015. return val;
  1016. val |= MDIO_PCS_CTRL1_CLKSTOP_EN;
  1017. phy_write_mmd_indirect(phydev, MDIO_CTRL1,
  1018. MDIO_MMD_PCS, val);
  1019. }
  1020. return 0; /* EEE supported */
  1021. }
  1022. eee_exit_err:
  1023. return -EPROTONOSUPPORT;
  1024. }
  1025. EXPORT_SYMBOL(phy_init_eee);
  1026. /**
  1027. * phy_get_eee_err - report the EEE wake error count
  1028. * @phydev: target phy_device struct
  1029. *
  1030. * Description: it is to report the number of time where the PHY
  1031. * failed to complete its normal wake sequence.
  1032. */
  1033. int phy_get_eee_err(struct phy_device *phydev)
  1034. {
  1035. return phy_read_mmd_indirect(phydev, MDIO_PCS_EEE_WK_ERR, MDIO_MMD_PCS);
  1036. }
  1037. EXPORT_SYMBOL(phy_get_eee_err);
  1038. /**
  1039. * phy_ethtool_get_eee - get EEE supported and status
  1040. * @phydev: target phy_device struct
  1041. * @data: ethtool_eee data
  1042. *
  1043. * Description: it reportes the Supported/Advertisement/LP Advertisement
  1044. * capabilities.
  1045. */
  1046. int phy_ethtool_get_eee(struct phy_device *phydev, struct ethtool_eee *data)
  1047. {
  1048. int val;
  1049. /* Get Supported EEE */
  1050. val = phy_read_mmd_indirect(phydev, MDIO_PCS_EEE_ABLE, MDIO_MMD_PCS);
  1051. if (val < 0)
  1052. return val;
  1053. data->supported = mmd_eee_cap_to_ethtool_sup_t(val);
  1054. /* Get advertisement EEE */
  1055. val = phy_read_mmd_indirect(phydev, MDIO_AN_EEE_ADV, MDIO_MMD_AN);
  1056. if (val < 0)
  1057. return val;
  1058. data->advertised = mmd_eee_adv_to_ethtool_adv_t(val);
  1059. /* Get LP advertisement EEE */
  1060. val = phy_read_mmd_indirect(phydev, MDIO_AN_EEE_LPABLE, MDIO_MMD_AN);
  1061. if (val < 0)
  1062. return val;
  1063. data->lp_advertised = mmd_eee_adv_to_ethtool_adv_t(val);
  1064. return 0;
  1065. }
  1066. EXPORT_SYMBOL(phy_ethtool_get_eee);
  1067. /**
  1068. * phy_ethtool_set_eee - set EEE supported and status
  1069. * @phydev: target phy_device struct
  1070. * @data: ethtool_eee data
  1071. *
  1072. * Description: it is to program the Advertisement EEE register.
  1073. */
  1074. int phy_ethtool_set_eee(struct phy_device *phydev, struct ethtool_eee *data)
  1075. {
  1076. int val = ethtool_adv_to_mmd_eee_adv_t(data->advertised);
  1077. phy_write_mmd_indirect(phydev, MDIO_AN_EEE_ADV, MDIO_MMD_AN, val);
  1078. return 0;
  1079. }
  1080. EXPORT_SYMBOL(phy_ethtool_set_eee);
  1081. int phy_ethtool_set_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol)
  1082. {
  1083. if (phydev->drv->set_wol)
  1084. return phydev->drv->set_wol(phydev, wol);
  1085. return -EOPNOTSUPP;
  1086. }
  1087. EXPORT_SYMBOL(phy_ethtool_set_wol);
  1088. void phy_ethtool_get_wol(struct phy_device *phydev, struct ethtool_wolinfo *wol)
  1089. {
  1090. if (phydev->drv->get_wol)
  1091. phydev->drv->get_wol(phydev, wol);
  1092. }
  1093. EXPORT_SYMBOL(phy_ethtool_get_wol);