ks8851.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /* drivers/net/ethernet/micrel/ks8851.h
  3. *
  4. * Copyright 2009 Simtec Electronics
  5. * Ben Dooks <[email protected]>
  6. *
  7. * KS8851 register definitions
  8. */
  9. #ifndef __KS8851_H__
  10. #define __KS8851_H__
  11. #include <linux/eeprom_93cx6.h>
  12. #define KS_CCR 0x08
  13. #define CCR_LE (1 << 10) /* KSZ8851-16MLL */
  14. #define CCR_EEPROM (1 << 9)
  15. #define CCR_SPI (1 << 8) /* KSZ8851SNL */
  16. #define CCR_8BIT (1 << 7) /* KSZ8851-16MLL */
  17. #define CCR_16BIT (1 << 6) /* KSZ8851-16MLL */
  18. #define CCR_32BIT (1 << 5) /* KSZ8851-16MLL */
  19. #define CCR_SHARED (1 << 4) /* KSZ8851-16MLL */
  20. #define CCR_48PIN (1 << 1) /* KSZ8851-16MLL */
  21. #define CCR_32PIN (1 << 0) /* KSZ8851SNL */
  22. /* MAC address registers */
  23. #define KS_MAR(_m) (0x14 - (_m))
  24. #define KS_MARL 0x10
  25. #define KS_MARM 0x12
  26. #define KS_MARH 0x14
  27. #define KS_OBCR 0x20
  28. #define OBCR_ODS_16mA (1 << 6)
  29. #define KS_EEPCR 0x22
  30. #define EEPCR_EESRWA (1 << 5)
  31. #define EEPCR_EESA (1 << 4)
  32. #define EEPCR_EESB (1 << 3)
  33. #define EEPCR_EEDO (1 << 2)
  34. #define EEPCR_EESCK (1 << 1)
  35. #define EEPCR_EECS (1 << 0)
  36. #define KS_MBIR 0x24
  37. #define MBIR_TXMBF (1 << 12)
  38. #define MBIR_TXMBFA (1 << 11)
  39. #define MBIR_RXMBF (1 << 4)
  40. #define MBIR_RXMBFA (1 << 3)
  41. #define KS_GRR 0x26
  42. #define GRR_QMU (1 << 1)
  43. #define GRR_GSR (1 << 0)
  44. #define KS_WFCR 0x2A
  45. #define WFCR_MPRXE (1 << 7)
  46. #define WFCR_WF3E (1 << 3)
  47. #define WFCR_WF2E (1 << 2)
  48. #define WFCR_WF1E (1 << 1)
  49. #define WFCR_WF0E (1 << 0)
  50. #define KS_WF0CRC0 0x30
  51. #define KS_WF0CRC1 0x32
  52. #define KS_WF0BM0 0x34
  53. #define KS_WF0BM1 0x36
  54. #define KS_WF0BM2 0x38
  55. #define KS_WF0BM3 0x3A
  56. #define KS_WF1CRC0 0x40
  57. #define KS_WF1CRC1 0x42
  58. #define KS_WF1BM0 0x44
  59. #define KS_WF1BM1 0x46
  60. #define KS_WF1BM2 0x48
  61. #define KS_WF1BM3 0x4A
  62. #define KS_WF2CRC0 0x50
  63. #define KS_WF2CRC1 0x52
  64. #define KS_WF2BM0 0x54
  65. #define KS_WF2BM1 0x56
  66. #define KS_WF2BM2 0x58
  67. #define KS_WF2BM3 0x5A
  68. #define KS_WF3CRC0 0x60
  69. #define KS_WF3CRC1 0x62
  70. #define KS_WF3BM0 0x64
  71. #define KS_WF3BM1 0x66
  72. #define KS_WF3BM2 0x68
  73. #define KS_WF3BM3 0x6A
  74. #define KS_TXCR 0x70
  75. #define TXCR_TCGICMP (1 << 8)
  76. #define TXCR_TCGUDP (1 << 7)
  77. #define TXCR_TCGTCP (1 << 6)
  78. #define TXCR_TCGIP (1 << 5)
  79. #define TXCR_FTXQ (1 << 4)
  80. #define TXCR_TXFCE (1 << 3)
  81. #define TXCR_TXPE (1 << 2)
  82. #define TXCR_TXCRC (1 << 1)
  83. #define TXCR_TXE (1 << 0)
  84. #define KS_TXSR 0x72
  85. #define TXSR_TXLC (1 << 13)
  86. #define TXSR_TXMC (1 << 12)
  87. #define TXSR_TXFID_MASK (0x3f << 0)
  88. #define TXSR_TXFID_SHIFT (0)
  89. #define TXSR_TXFID_GET(_v) (((_v) >> 0) & 0x3f)
  90. #define KS_RXCR1 0x74
  91. #define RXCR1_FRXQ (1 << 15)
  92. #define RXCR1_RXUDPFCC (1 << 14)
  93. #define RXCR1_RXTCPFCC (1 << 13)
  94. #define RXCR1_RXIPFCC (1 << 12)
  95. #define RXCR1_RXPAFMA (1 << 11)
  96. #define RXCR1_RXFCE (1 << 10)
  97. #define RXCR1_RXEFE (1 << 9)
  98. #define RXCR1_RXMAFMA (1 << 8)
  99. #define RXCR1_RXBE (1 << 7)
  100. #define RXCR1_RXME (1 << 6)
  101. #define RXCR1_RXUE (1 << 5)
  102. #define RXCR1_RXAE (1 << 4)
  103. #define RXCR1_RXINVF (1 << 1)
  104. #define RXCR1_RXE (1 << 0)
  105. #define KS_RXCR2 0x76
  106. #define RXCR2_SRDBL_MASK (0x7 << 5) /* KSZ8851SNL */
  107. #define RXCR2_SRDBL_SHIFT (5) /* KSZ8851SNL */
  108. #define RXCR2_SRDBL_4B (0x0 << 5) /* KSZ8851SNL */
  109. #define RXCR2_SRDBL_8B (0x1 << 5) /* KSZ8851SNL */
  110. #define RXCR2_SRDBL_16B (0x2 << 5) /* KSZ8851SNL */
  111. #define RXCR2_SRDBL_32B (0x3 << 5) /* KSZ8851SNL */
  112. #define RXCR2_SRDBL_FRAME (0x4 << 5) /* KSZ8851SNL */
  113. #define RXCR2_IUFFP (1 << 4)
  114. #define RXCR2_RXIUFCEZ (1 << 3)
  115. #define RXCR2_UDPLFE (1 << 2)
  116. #define RXCR2_RXICMPFCC (1 << 1)
  117. #define RXCR2_RXSAF (1 << 0)
  118. #define KS_TXMIR 0x78
  119. #define KS_RXFHSR 0x7C
  120. #define RXFSHR_RXFV (1 << 15)
  121. #define RXFSHR_RXICMPFCS (1 << 13)
  122. #define RXFSHR_RXIPFCS (1 << 12)
  123. #define RXFSHR_RXTCPFCS (1 << 11)
  124. #define RXFSHR_RXUDPFCS (1 << 10)
  125. #define RXFSHR_RXBF (1 << 7)
  126. #define RXFSHR_RXMF (1 << 6)
  127. #define RXFSHR_RXUF (1 << 5)
  128. #define RXFSHR_RXMR (1 << 4)
  129. #define RXFSHR_RXFT (1 << 3)
  130. #define RXFSHR_RXFTL (1 << 2)
  131. #define RXFSHR_RXRF (1 << 1)
  132. #define RXFSHR_RXCE (1 << 0)
  133. #define KS_RXFHBCR 0x7E
  134. #define RXFHBCR_CNT_MASK (0xfff << 0)
  135. #define KS_TXQCR 0x80
  136. #define TXQCR_AETFE (1 << 2) /* KSZ8851SNL */
  137. #define TXQCR_TXQMAM (1 << 1)
  138. #define TXQCR_METFE (1 << 0)
  139. #define KS_RXQCR 0x82
  140. #define RXQCR_RXDTTS (1 << 12)
  141. #define RXQCR_RXDBCTS (1 << 11)
  142. #define RXQCR_RXFCTS (1 << 10)
  143. #define RXQCR_RXIPHTOE (1 << 9)
  144. #define RXQCR_RXDTTE (1 << 7)
  145. #define RXQCR_RXDBCTE (1 << 6)
  146. #define RXQCR_RXFCTE (1 << 5)
  147. #define RXQCR_ADRFE (1 << 4)
  148. #define RXQCR_SDA (1 << 3)
  149. #define RXQCR_RRXEF (1 << 0)
  150. #define KS_TXFDPR 0x84
  151. #define TXFDPR_TXFPAI (1 << 14)
  152. #define TXFDPR_TXFP_MASK (0x7ff << 0)
  153. #define TXFDPR_TXFP_SHIFT (0)
  154. #define KS_RXFDPR 0x86
  155. #define RXFDPR_RXFPAI (1 << 14)
  156. #define RXFDPR_WST (1 << 12) /* KSZ8851-16MLL */
  157. #define RXFDPR_EMS (1 << 11) /* KSZ8851-16MLL */
  158. #define RXFDPR_RXFP_MASK (0x7ff << 0)
  159. #define RXFDPR_RXFP_SHIFT (0)
  160. #define KS_RXDTTR 0x8C
  161. #define KS_RXDBCTR 0x8E
  162. #define KS_IER 0x90
  163. #define KS_ISR 0x92
  164. #define IRQ_LCI (1 << 15)
  165. #define IRQ_TXI (1 << 14)
  166. #define IRQ_RXI (1 << 13)
  167. #define IRQ_RXOI (1 << 11)
  168. #define IRQ_TXPSI (1 << 9)
  169. #define IRQ_RXPSI (1 << 8)
  170. #define IRQ_TXSAI (1 << 6)
  171. #define IRQ_RXWFDI (1 << 5)
  172. #define IRQ_RXMPDI (1 << 4)
  173. #define IRQ_LDI (1 << 3)
  174. #define IRQ_EDI (1 << 2)
  175. #define IRQ_SPIBEI (1 << 1) /* KSZ8851SNL */
  176. #define IRQ_DEDI (1 << 0)
  177. #define KS_RXFCTR 0x9C
  178. #define KS_RXFC 0x9D
  179. #define RXFCTR_RXFC_MASK (0xff << 8)
  180. #define RXFCTR_RXFC_SHIFT (8)
  181. #define RXFCTR_RXFC_GET(_v) (((_v) >> 8) & 0xff)
  182. #define RXFCTR_RXFCT_MASK (0xff << 0)
  183. #define RXFCTR_RXFCT_SHIFT (0)
  184. #define KS_TXNTFSR 0x9E
  185. #define KS_MAHTR0 0xA0
  186. #define KS_MAHTR1 0xA2
  187. #define KS_MAHTR2 0xA4
  188. #define KS_MAHTR3 0xA6
  189. #define KS_FCLWR 0xB0
  190. #define KS_FCHWR 0xB2
  191. #define KS_FCOWR 0xB4
  192. #define KS_CIDER 0xC0
  193. #define CIDER_ID 0x8870
  194. #define CIDER_REV_MASK (0x7 << 1)
  195. #define CIDER_REV_SHIFT (1)
  196. #define CIDER_REV_GET(_v) (((_v) >> 1) & 0x7)
  197. #define KS_CGCR 0xC6
  198. #define KS_IACR 0xC8
  199. #define IACR_RDEN (1 << 12)
  200. #define IACR_TSEL_MASK (0x3 << 10)
  201. #define IACR_TSEL_SHIFT (10)
  202. #define IACR_TSEL_MIB (0x3 << 10)
  203. #define IACR_ADDR_MASK (0x1f << 0)
  204. #define IACR_ADDR_SHIFT (0)
  205. #define KS_IADLR 0xD0
  206. #define KS_IAHDR 0xD2
  207. #define KS_PMECR 0xD4
  208. #define PMECR_PME_DELAY (1 << 14)
  209. #define PMECR_PME_POL (1 << 12)
  210. #define PMECR_WOL_WAKEUP (1 << 11)
  211. #define PMECR_WOL_MAGICPKT (1 << 10)
  212. #define PMECR_WOL_LINKUP (1 << 9)
  213. #define PMECR_WOL_ENERGY (1 << 8)
  214. #define PMECR_AUTO_WAKE_EN (1 << 7)
  215. #define PMECR_WAKEUP_NORMAL (1 << 6)
  216. #define PMECR_WKEVT_MASK (0xf << 2)
  217. #define PMECR_WKEVT_SHIFT (2)
  218. #define PMECR_WKEVT_GET(_v) (((_v) >> 2) & 0xf)
  219. #define PMECR_WKEVT_ENERGY (0x1 << 2)
  220. #define PMECR_WKEVT_LINK (0x2 << 2)
  221. #define PMECR_WKEVT_MAGICPKT (0x4 << 2)
  222. #define PMECR_WKEVT_FRAME (0x8 << 2)
  223. #define PMECR_PM_MASK (0x3 << 0)
  224. #define PMECR_PM_SHIFT (0)
  225. #define PMECR_PM_NORMAL (0x0 << 0)
  226. #define PMECR_PM_ENERGY (0x1 << 0)
  227. #define PMECR_PM_SOFTDOWN (0x2 << 0)
  228. #define PMECR_PM_POWERSAVE (0x3 << 0)
  229. /* Standard MII PHY data */
  230. #define KS_P1MBCR 0xE4
  231. #define KS_P1MBSR 0xE6
  232. #define KS_PHY1ILR 0xE8
  233. #define KS_PHY1IHR 0xEA
  234. #define KS_P1ANAR 0xEC
  235. #define KS_P1ANLPR 0xEE
  236. #define KS_P1SCLMD 0xF4
  237. #define KS_P1CR 0xF6
  238. #define P1CR_LEDOFF (1 << 15)
  239. #define P1CR_TXIDS (1 << 14)
  240. #define P1CR_RESTARTAN (1 << 13)
  241. #define P1CR_DISAUTOMDIX (1 << 10)
  242. #define P1CR_FORCEMDIX (1 << 9)
  243. #define P1CR_AUTONEGEN (1 << 7)
  244. #define P1CR_FORCE100 (1 << 6)
  245. #define P1CR_FORCEFDX (1 << 5)
  246. #define P1CR_ADV_FLOW (1 << 4)
  247. #define P1CR_ADV_100BT_FDX (1 << 3)
  248. #define P1CR_ADV_100BT_HDX (1 << 2)
  249. #define P1CR_ADV_10BT_FDX (1 << 1)
  250. #define P1CR_ADV_10BT_HDX (1 << 0)
  251. #define KS_P1SR 0xF8
  252. #define P1SR_HP_MDIX (1 << 15)
  253. #define P1SR_REV_POL (1 << 13)
  254. #define P1SR_OP_100M (1 << 10)
  255. #define P1SR_OP_FDX (1 << 9)
  256. #define P1SR_OP_MDI (1 << 7)
  257. #define P1SR_AN_DONE (1 << 6)
  258. #define P1SR_LINK_GOOD (1 << 5)
  259. #define P1SR_PNTR_FLOW (1 << 4)
  260. #define P1SR_PNTR_100BT_FDX (1 << 3)
  261. #define P1SR_PNTR_100BT_HDX (1 << 2)
  262. #define P1SR_PNTR_10BT_FDX (1 << 1)
  263. #define P1SR_PNTR_10BT_HDX (1 << 0)
  264. /* TX Frame control */
  265. #define TXFR_TXIC (1 << 15)
  266. #define TXFR_TXFID_MASK (0x3f << 0)
  267. #define TXFR_TXFID_SHIFT (0)
  268. /**
  269. * struct ks8851_rxctrl - KS8851 driver rx control
  270. * @mchash: Multicast hash-table data.
  271. * @rxcr1: KS_RXCR1 register setting
  272. * @rxcr2: KS_RXCR2 register setting
  273. *
  274. * Representation of the settings needs to control the receive filtering
  275. * such as the multicast hash-filter and the receive register settings. This
  276. * is used to make the job of working out if the receive settings change and
  277. * then issuing the new settings to the worker that will send the necessary
  278. * commands.
  279. */
  280. struct ks8851_rxctrl {
  281. u16 mchash[4];
  282. u16 rxcr1;
  283. u16 rxcr2;
  284. };
  285. /**
  286. * union ks8851_tx_hdr - tx header data
  287. * @txb: The header as bytes
  288. * @txw: The header as 16bit, little-endian words
  289. *
  290. * A dual representation of the tx header data to allow
  291. * access to individual bytes, and to allow 16bit accesses
  292. * with 16bit alignment.
  293. */
  294. union ks8851_tx_hdr {
  295. u8 txb[6];
  296. __le16 txw[3];
  297. };
  298. /**
  299. * struct ks8851_net - KS8851 driver private data
  300. * @netdev: The network device we're bound to
  301. * @statelock: Lock on this structure for tx list.
  302. * @mii: The MII state information for the mii calls.
  303. * @rxctrl: RX settings for @rxctrl_work.
  304. * @rxctrl_work: Work queue for updating RX mode and multicast lists
  305. * @txq: Queue of packets for transmission.
  306. * @txh: Space for generating packet TX header in DMA-able data
  307. * @rxd: Space for receiving SPI data, in DMA-able space.
  308. * @txd: Space for transmitting SPI data, in DMA-able space.
  309. * @msg_enable: The message flags controlling driver output (see ethtool).
  310. * @fid: Incrementing frame id tag.
  311. * @rc_ier: Cached copy of KS_IER.
  312. * @rc_ccr: Cached copy of KS_CCR.
  313. * @rc_rxqcr: Cached copy of KS_RXQCR.
  314. * @eeprom: 93CX6 EEPROM state for accessing on-board EEPROM.
  315. * @vdd_reg: Optional regulator supplying the chip
  316. * @vdd_io: Optional digital power supply for IO
  317. * @gpio: Optional reset_n gpio
  318. * @mii_bus: Pointer to MII bus structure
  319. * @lock: Bus access lock callback
  320. * @unlock: Bus access unlock callback
  321. * @rdreg16: 16bit register read callback
  322. * @wrreg16: 16bit register write callback
  323. * @rdfifo: FIFO read callback
  324. * @wrfifo: FIFO write callback
  325. * @start_xmit: start_xmit() implementation callback
  326. * @rx_skb: rx_skb() implementation callback
  327. * @flush_tx_work: flush_tx_work() implementation callback
  328. *
  329. * The @statelock is used to protect information in the structure which may
  330. * need to be accessed via several sources, such as the network driver layer
  331. * or one of the work queues.
  332. *
  333. * We align the buffers we may use for rx/tx to ensure that if the SPI driver
  334. * wants to DMA map them, it will not have any problems with data the driver
  335. * modifies.
  336. */
  337. struct ks8851_net {
  338. struct net_device *netdev;
  339. spinlock_t statelock;
  340. union ks8851_tx_hdr txh ____cacheline_aligned;
  341. u8 rxd[8];
  342. u8 txd[8];
  343. u32 msg_enable ____cacheline_aligned;
  344. u16 tx_space;
  345. u8 fid;
  346. u16 rc_ier;
  347. u16 rc_rxqcr;
  348. u16 rc_ccr;
  349. struct mii_if_info mii;
  350. struct ks8851_rxctrl rxctrl;
  351. struct work_struct rxctrl_work;
  352. struct sk_buff_head txq;
  353. struct eeprom_93cx6 eeprom;
  354. struct regulator *vdd_reg;
  355. struct regulator *vdd_io;
  356. struct gpio_desc *gpio;
  357. struct mii_bus *mii_bus;
  358. void (*lock)(struct ks8851_net *ks,
  359. unsigned long *flags);
  360. void (*unlock)(struct ks8851_net *ks,
  361. unsigned long *flags);
  362. unsigned int (*rdreg16)(struct ks8851_net *ks,
  363. unsigned int reg);
  364. void (*wrreg16)(struct ks8851_net *ks,
  365. unsigned int reg, unsigned int val);
  366. void (*rdfifo)(struct ks8851_net *ks, u8 *buff,
  367. unsigned int len);
  368. void (*wrfifo)(struct ks8851_net *ks,
  369. struct sk_buff *txp, bool irq);
  370. netdev_tx_t (*start_xmit)(struct sk_buff *skb,
  371. struct net_device *dev);
  372. void (*rx_skb)(struct ks8851_net *ks,
  373. struct sk_buff *skb);
  374. void (*flush_tx_work)(struct ks8851_net *ks);
  375. };
  376. int ks8851_probe_common(struct net_device *netdev, struct device *dev,
  377. int msg_en);
  378. void ks8851_remove_common(struct device *dev);
  379. int ks8851_suspend(struct device *dev);
  380. int ks8851_resume(struct device *dev);
  381. static __maybe_unused SIMPLE_DEV_PM_OPS(ks8851_pm_ops,
  382. ks8851_suspend, ks8851_resume);
  383. /**
  384. * ks8851_done_tx - update and then free skbuff after transmitting
  385. * @ks: The device state
  386. * @txb: The buffer transmitted
  387. */
  388. static void __maybe_unused ks8851_done_tx(struct ks8851_net *ks,
  389. struct sk_buff *txb)
  390. {
  391. struct net_device *dev = ks->netdev;
  392. dev->stats.tx_bytes += txb->len;
  393. dev->stats.tx_packets++;
  394. dev_kfree_skb(txb);
  395. }
  396. #endif /* __KS8851_H__ */