drivers/net: delete non-required instances of include <linux/init.h>
[linux-2.6/btrfs-unstable.git] / drivers / net / ethernet / xilinx / xilinx_emaclite.c
blob36052b98b3fcb20c8955a575c66d38fb8e6fc2ad
1 /*
2 * Xilinx EmacLite Linux driver for the Xilinx Ethernet MAC Lite device.
4 * This is a new flat driver which is based on the original emac_lite
5 * driver from John Williams <john.williams@xilinx.com>.
7 * 2007 - 2013 (c) Xilinx, Inc.
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.
15 #include <linux/module.h>
16 #include <linux/uaccess.h>
17 #include <linux/netdevice.h>
18 #include <linux/etherdevice.h>
19 #include <linux/skbuff.h>
20 #include <linux/io.h>
21 #include <linux/slab.h>
22 #include <linux/of_address.h>
23 #include <linux/of_device.h>
24 #include <linux/of_platform.h>
25 #include <linux/of_mdio.h>
26 #include <linux/of_net.h>
27 #include <linux/phy.h>
28 #include <linux/interrupt.h>
30 #define DRIVER_NAME "xilinx_emaclite"
32 /* Register offsets for the EmacLite Core */
33 #define XEL_TXBUFF_OFFSET 0x0 /* Transmit Buffer */
34 #define XEL_MDIOADDR_OFFSET 0x07E4 /* MDIO Address Register */
35 #define XEL_MDIOWR_OFFSET 0x07E8 /* MDIO Write Data Register */
36 #define XEL_MDIORD_OFFSET 0x07EC /* MDIO Read Data Register */
37 #define XEL_MDIOCTRL_OFFSET 0x07F0 /* MDIO Control Register */
38 #define XEL_GIER_OFFSET 0x07F8 /* GIE Register */
39 #define XEL_TSR_OFFSET 0x07FC /* Tx status */
40 #define XEL_TPLR_OFFSET 0x07F4 /* Tx packet length */
42 #define XEL_RXBUFF_OFFSET 0x1000 /* Receive Buffer */
43 #define XEL_RPLR_OFFSET 0x100C /* Rx packet length */
44 #define XEL_RSR_OFFSET 0x17FC /* Rx status */
46 #define XEL_BUFFER_OFFSET 0x0800 /* Next Tx/Rx buffer's offset */
48 /* MDIO Address Register Bit Masks */
49 #define XEL_MDIOADDR_REGADR_MASK 0x0000001F /* Register Address */
50 #define XEL_MDIOADDR_PHYADR_MASK 0x000003E0 /* PHY Address */
51 #define XEL_MDIOADDR_PHYADR_SHIFT 5
52 #define XEL_MDIOADDR_OP_MASK 0x00000400 /* RD/WR Operation */
54 /* MDIO Write Data Register Bit Masks */
55 #define XEL_MDIOWR_WRDATA_MASK 0x0000FFFF /* Data to be Written */
57 /* MDIO Read Data Register Bit Masks */
58 #define XEL_MDIORD_RDDATA_MASK 0x0000FFFF /* Data to be Read */
60 /* MDIO Control Register Bit Masks */
61 #define XEL_MDIOCTRL_MDIOSTS_MASK 0x00000001 /* MDIO Status Mask */
62 #define XEL_MDIOCTRL_MDIOEN_MASK 0x00000008 /* MDIO Enable */
64 /* Global Interrupt Enable Register (GIER) Bit Masks */
65 #define XEL_GIER_GIE_MASK 0x80000000 /* Global Enable */
67 /* Transmit Status Register (TSR) Bit Masks */
68 #define XEL_TSR_XMIT_BUSY_MASK 0x00000001 /* Tx complete */
69 #define XEL_TSR_PROGRAM_MASK 0x00000002 /* Program the MAC address */
70 #define XEL_TSR_XMIT_IE_MASK 0x00000008 /* Tx interrupt enable bit */
71 #define XEL_TSR_XMIT_ACTIVE_MASK 0x80000000 /* Buffer is active, SW bit
72 * only. This is not documented
73 * in the HW spec */
75 /* Define for programming the MAC address into the EmacLite */
76 #define XEL_TSR_PROG_MAC_ADDR (XEL_TSR_XMIT_BUSY_MASK | XEL_TSR_PROGRAM_MASK)
78 /* Receive Status Register (RSR) */
79 #define XEL_RSR_RECV_DONE_MASK 0x00000001 /* Rx complete */
80 #define XEL_RSR_RECV_IE_MASK 0x00000008 /* Rx interrupt enable bit */
82 /* Transmit Packet Length Register (TPLR) */
83 #define XEL_TPLR_LENGTH_MASK 0x0000FFFF /* Tx packet length */
85 /* Receive Packet Length Register (RPLR) */
86 #define XEL_RPLR_LENGTH_MASK 0x0000FFFF /* Rx packet length */
88 #define XEL_HEADER_OFFSET 12 /* Offset to length field */
89 #define XEL_HEADER_SHIFT 16 /* Shift value for length */
91 /* General Ethernet Definitions */
92 #define XEL_ARP_PACKET_SIZE 28 /* Max ARP packet size */
93 #define XEL_HEADER_IP_LENGTH_OFFSET 16 /* IP Length Offset */
97 #define TX_TIMEOUT (60*HZ) /* Tx timeout is 60 seconds. */
98 #define ALIGNMENT 4
100 /* BUFFER_ALIGN(adr) calculates the number of bytes to the next alignment. */
101 #define BUFFER_ALIGN(adr) ((ALIGNMENT - ((u32) adr)) % ALIGNMENT)
104 * struct net_local - Our private per device data
105 * @ndev: instance of the network device
106 * @tx_ping_pong: indicates whether Tx Pong buffer is configured in HW
107 * @rx_ping_pong: indicates whether Rx Pong buffer is configured in HW
108 * @next_tx_buf_to_use: next Tx buffer to write to
109 * @next_rx_buf_to_use: next Rx buffer to read from
110 * @base_addr: base address of the Emaclite device
111 * @reset_lock: lock used for synchronization
112 * @deferred_skb: holds an skb (for transmission at a later time) when the
113 * Tx buffer is not free
114 * @phy_dev: pointer to the PHY device
115 * @phy_node: pointer to the PHY device node
116 * @mii_bus: pointer to the MII bus
117 * @mdio_irqs: IRQs table for MDIO bus
118 * @last_link: last link status
119 * @has_mdio: indicates whether MDIO is included in the HW
121 struct net_local {
123 struct net_device *ndev;
125 bool tx_ping_pong;
126 bool rx_ping_pong;
127 u32 next_tx_buf_to_use;
128 u32 next_rx_buf_to_use;
129 void __iomem *base_addr;
131 spinlock_t reset_lock;
132 struct sk_buff *deferred_skb;
134 struct phy_device *phy_dev;
135 struct device_node *phy_node;
137 struct mii_bus *mii_bus;
138 int mdio_irqs[PHY_MAX_ADDR];
140 int last_link;
141 bool has_mdio;
145 /*************************/
146 /* EmacLite driver calls */
147 /*************************/
150 * xemaclite_enable_interrupts - Enable the interrupts for the EmacLite device
151 * @drvdata: Pointer to the Emaclite device private data
153 * This function enables the Tx and Rx interrupts for the Emaclite device along
154 * with the Global Interrupt Enable.
156 static void xemaclite_enable_interrupts(struct net_local *drvdata)
158 u32 reg_data;
160 /* Enable the Tx interrupts for the first Buffer */
161 reg_data = __raw_readl(drvdata->base_addr + XEL_TSR_OFFSET);
162 __raw_writel(reg_data | XEL_TSR_XMIT_IE_MASK,
163 drvdata->base_addr + XEL_TSR_OFFSET);
165 /* Enable the Rx interrupts for the first buffer */
166 __raw_writel(XEL_RSR_RECV_IE_MASK, drvdata->base_addr + XEL_RSR_OFFSET);
168 /* Enable the Global Interrupt Enable */
169 __raw_writel(XEL_GIER_GIE_MASK, drvdata->base_addr + XEL_GIER_OFFSET);
173 * xemaclite_disable_interrupts - Disable the interrupts for the EmacLite device
174 * @drvdata: Pointer to the Emaclite device private data
176 * This function disables the Tx and Rx interrupts for the Emaclite device,
177 * along with the Global Interrupt Enable.
179 static void xemaclite_disable_interrupts(struct net_local *drvdata)
181 u32 reg_data;
183 /* Disable the Global Interrupt Enable */
184 __raw_writel(XEL_GIER_GIE_MASK, drvdata->base_addr + XEL_GIER_OFFSET);
186 /* Disable the Tx interrupts for the first buffer */
187 reg_data = __raw_readl(drvdata->base_addr + XEL_TSR_OFFSET);
188 __raw_writel(reg_data & (~XEL_TSR_XMIT_IE_MASK),
189 drvdata->base_addr + XEL_TSR_OFFSET);
191 /* Disable the Rx interrupts for the first buffer */
192 reg_data = __raw_readl(drvdata->base_addr + XEL_RSR_OFFSET);
193 __raw_writel(reg_data & (~XEL_RSR_RECV_IE_MASK),
194 drvdata->base_addr + XEL_RSR_OFFSET);
198 * xemaclite_aligned_write - Write from 16-bit aligned to 32-bit aligned address
199 * @src_ptr: Void pointer to the 16-bit aligned source address
200 * @dest_ptr: Pointer to the 32-bit aligned destination address
201 * @length: Number bytes to write from source to destination
203 * This function writes data from a 16-bit aligned buffer to a 32-bit aligned
204 * address in the EmacLite device.
206 static void xemaclite_aligned_write(void *src_ptr, u32 *dest_ptr,
207 unsigned length)
209 u32 align_buffer;
210 u32 *to_u32_ptr;
211 u16 *from_u16_ptr, *to_u16_ptr;
213 to_u32_ptr = dest_ptr;
214 from_u16_ptr = src_ptr;
215 align_buffer = 0;
217 for (; length > 3; length -= 4) {
218 to_u16_ptr = (u16 *)&align_buffer;
219 *to_u16_ptr++ = *from_u16_ptr++;
220 *to_u16_ptr++ = *from_u16_ptr++;
222 /* This barrier resolves occasional issues seen around
223 * cases where the data is not properly flushed out
224 * from the processor store buffers to the destination
225 * memory locations.
227 wmb();
229 /* Output a word */
230 *to_u32_ptr++ = align_buffer;
232 if (length) {
233 u8 *from_u8_ptr, *to_u8_ptr;
235 /* Set up to output the remaining data */
236 align_buffer = 0;
237 to_u8_ptr = (u8 *) &align_buffer;
238 from_u8_ptr = (u8 *) from_u16_ptr;
240 /* Output the remaining data */
241 for (; length > 0; length--)
242 *to_u8_ptr++ = *from_u8_ptr++;
244 /* This barrier resolves occasional issues seen around
245 * cases where the data is not properly flushed out
246 * from the processor store buffers to the destination
247 * memory locations.
249 wmb();
250 *to_u32_ptr = align_buffer;
255 * xemaclite_aligned_read - Read from 32-bit aligned to 16-bit aligned buffer
256 * @src_ptr: Pointer to the 32-bit aligned source address
257 * @dest_ptr: Pointer to the 16-bit aligned destination address
258 * @length: Number bytes to read from source to destination
260 * This function reads data from a 32-bit aligned address in the EmacLite device
261 * to a 16-bit aligned buffer.
263 static void xemaclite_aligned_read(u32 *src_ptr, u8 *dest_ptr,
264 unsigned length)
266 u16 *to_u16_ptr, *from_u16_ptr;
267 u32 *from_u32_ptr;
268 u32 align_buffer;
270 from_u32_ptr = src_ptr;
271 to_u16_ptr = (u16 *) dest_ptr;
273 for (; length > 3; length -= 4) {
274 /* Copy each word into the temporary buffer */
275 align_buffer = *from_u32_ptr++;
276 from_u16_ptr = (u16 *)&align_buffer;
278 /* Read data from source */
279 *to_u16_ptr++ = *from_u16_ptr++;
280 *to_u16_ptr++ = *from_u16_ptr++;
283 if (length) {
284 u8 *to_u8_ptr, *from_u8_ptr;
286 /* Set up to read the remaining data */
287 to_u8_ptr = (u8 *) to_u16_ptr;
288 align_buffer = *from_u32_ptr++;
289 from_u8_ptr = (u8 *) &align_buffer;
291 /* Read the remaining data */
292 for (; length > 0; length--)
293 *to_u8_ptr = *from_u8_ptr;
298 * xemaclite_send_data - Send an Ethernet frame
299 * @drvdata: Pointer to the Emaclite device private data
300 * @data: Pointer to the data to be sent
301 * @byte_count: Total frame size, including header
303 * This function checks if the Tx buffer of the Emaclite device is free to send
304 * data. If so, it fills the Tx buffer with data for transmission. Otherwise, it
305 * returns an error.
307 * Return: 0 upon success or -1 if the buffer(s) are full.
309 * Note: The maximum Tx packet size can not be more than Ethernet header
310 * (14 Bytes) + Maximum MTU (1500 bytes). This is excluding FCS.
312 static int xemaclite_send_data(struct net_local *drvdata, u8 *data,
313 unsigned int byte_count)
315 u32 reg_data;
316 void __iomem *addr;
318 /* Determine the expected Tx buffer address */
319 addr = drvdata->base_addr + drvdata->next_tx_buf_to_use;
321 /* If the length is too large, truncate it */
322 if (byte_count > ETH_FRAME_LEN)
323 byte_count = ETH_FRAME_LEN;
325 /* Check if the expected buffer is available */
326 reg_data = __raw_readl(addr + XEL_TSR_OFFSET);
327 if ((reg_data & (XEL_TSR_XMIT_BUSY_MASK |
328 XEL_TSR_XMIT_ACTIVE_MASK)) == 0) {
330 /* Switch to next buffer if configured */
331 if (drvdata->tx_ping_pong != 0)
332 drvdata->next_tx_buf_to_use ^= XEL_BUFFER_OFFSET;
333 } else if (drvdata->tx_ping_pong != 0) {
334 /* If the expected buffer is full, try the other buffer,
335 * if it is configured in HW */
337 addr = (void __iomem __force *)((u32 __force)addr ^
338 XEL_BUFFER_OFFSET);
339 reg_data = __raw_readl(addr + XEL_TSR_OFFSET);
341 if ((reg_data & (XEL_TSR_XMIT_BUSY_MASK |
342 XEL_TSR_XMIT_ACTIVE_MASK)) != 0)
343 return -1; /* Buffers were full, return failure */
344 } else
345 return -1; /* Buffer was full, return failure */
347 /* Write the frame to the buffer */
348 xemaclite_aligned_write(data, (u32 __force *) addr, byte_count);
350 __raw_writel((byte_count & XEL_TPLR_LENGTH_MASK),
351 addr + XEL_TPLR_OFFSET);
353 /* Update the Tx Status Register to indicate that there is a
354 * frame to send. Set the XEL_TSR_XMIT_ACTIVE_MASK flag which
355 * is used by the interrupt handler to check whether a frame
356 * has been transmitted */
357 reg_data = __raw_readl(addr + XEL_TSR_OFFSET);
358 reg_data |= (XEL_TSR_XMIT_BUSY_MASK | XEL_TSR_XMIT_ACTIVE_MASK);
359 __raw_writel(reg_data, addr + XEL_TSR_OFFSET);
361 return 0;
365 * xemaclite_recv_data - Receive a frame
366 * @drvdata: Pointer to the Emaclite device private data
367 * @data: Address where the data is to be received
369 * This function is intended to be called from the interrupt context or
370 * with a wrapper which waits for the receive frame to be available.
372 * Return: Total number of bytes received
374 static u16 xemaclite_recv_data(struct net_local *drvdata, u8 *data)
376 void __iomem *addr;
377 u16 length, proto_type;
378 u32 reg_data;
380 /* Determine the expected buffer address */
381 addr = (drvdata->base_addr + drvdata->next_rx_buf_to_use);
383 /* Verify which buffer has valid data */
384 reg_data = __raw_readl(addr + XEL_RSR_OFFSET);
386 if ((reg_data & XEL_RSR_RECV_DONE_MASK) == XEL_RSR_RECV_DONE_MASK) {
387 if (drvdata->rx_ping_pong != 0)
388 drvdata->next_rx_buf_to_use ^= XEL_BUFFER_OFFSET;
389 } else {
390 /* The instance is out of sync, try other buffer if other
391 * buffer is configured, return 0 otherwise. If the instance is
392 * out of sync, do not update the 'next_rx_buf_to_use' since it
393 * will correct on subsequent calls */
394 if (drvdata->rx_ping_pong != 0)
395 addr = (void __iomem __force *)((u32 __force)addr ^
396 XEL_BUFFER_OFFSET);
397 else
398 return 0; /* No data was available */
400 /* Verify that buffer has valid data */
401 reg_data = __raw_readl(addr + XEL_RSR_OFFSET);
402 if ((reg_data & XEL_RSR_RECV_DONE_MASK) !=
403 XEL_RSR_RECV_DONE_MASK)
404 return 0; /* No data was available */
407 /* Get the protocol type of the ethernet frame that arrived */
408 proto_type = ((ntohl(__raw_readl(addr + XEL_HEADER_OFFSET +
409 XEL_RXBUFF_OFFSET)) >> XEL_HEADER_SHIFT) &
410 XEL_RPLR_LENGTH_MASK);
412 /* Check if received ethernet frame is a raw ethernet frame
413 * or an IP packet or an ARP packet */
414 if (proto_type > (ETH_FRAME_LEN + ETH_FCS_LEN)) {
416 if (proto_type == ETH_P_IP) {
417 length = ((ntohl(__raw_readl(addr +
418 XEL_HEADER_IP_LENGTH_OFFSET +
419 XEL_RXBUFF_OFFSET)) >>
420 XEL_HEADER_SHIFT) &
421 XEL_RPLR_LENGTH_MASK);
422 length += ETH_HLEN + ETH_FCS_LEN;
424 } else if (proto_type == ETH_P_ARP)
425 length = XEL_ARP_PACKET_SIZE + ETH_HLEN + ETH_FCS_LEN;
426 else
427 /* Field contains type other than IP or ARP, use max
428 * frame size and let user parse it */
429 length = ETH_FRAME_LEN + ETH_FCS_LEN;
430 } else
431 /* Use the length in the frame, plus the header and trailer */
432 length = proto_type + ETH_HLEN + ETH_FCS_LEN;
434 /* Read from the EmacLite device */
435 xemaclite_aligned_read((u32 __force *) (addr + XEL_RXBUFF_OFFSET),
436 data, length);
438 /* Acknowledge the frame */
439 reg_data = __raw_readl(addr + XEL_RSR_OFFSET);
440 reg_data &= ~XEL_RSR_RECV_DONE_MASK;
441 __raw_writel(reg_data, addr + XEL_RSR_OFFSET);
443 return length;
447 * xemaclite_update_address - Update the MAC address in the device
448 * @drvdata: Pointer to the Emaclite device private data
449 * @address_ptr:Pointer to the MAC address (MAC address is a 48-bit value)
451 * Tx must be idle and Rx should be idle for deterministic results.
452 * It is recommended that this function should be called after the
453 * initialization and before transmission of any packets from the device.
454 * The MAC address can be programmed using any of the two transmit
455 * buffers (if configured).
457 static void xemaclite_update_address(struct net_local *drvdata,
458 u8 *address_ptr)
460 void __iomem *addr;
461 u32 reg_data;
463 /* Determine the expected Tx buffer address */
464 addr = drvdata->base_addr + drvdata->next_tx_buf_to_use;
466 xemaclite_aligned_write(address_ptr, (u32 __force *) addr, ETH_ALEN);
468 __raw_writel(ETH_ALEN, addr + XEL_TPLR_OFFSET);
470 /* Update the MAC address in the EmacLite */
471 reg_data = __raw_readl(addr + XEL_TSR_OFFSET);
472 __raw_writel(reg_data | XEL_TSR_PROG_MAC_ADDR, addr + XEL_TSR_OFFSET);
474 /* Wait for EmacLite to finish with the MAC address update */
475 while ((__raw_readl(addr + XEL_TSR_OFFSET) &
476 XEL_TSR_PROG_MAC_ADDR) != 0)
481 * xemaclite_set_mac_address - Set the MAC address for this device
482 * @dev: Pointer to the network device instance
483 * @addr: Void pointer to the sockaddr structure
485 * This function copies the HW address from the sockaddr strucutre to the
486 * net_device structure and updates the address in HW.
488 * Return: Error if the net device is busy or 0 if the addr is set
489 * successfully
491 static int xemaclite_set_mac_address(struct net_device *dev, void *address)
493 struct net_local *lp = netdev_priv(dev);
494 struct sockaddr *addr = address;
496 if (netif_running(dev))
497 return -EBUSY;
499 memcpy(dev->dev_addr, addr->sa_data, dev->addr_len);
500 xemaclite_update_address(lp, dev->dev_addr);
501 return 0;
505 * xemaclite_tx_timeout - Callback for Tx Timeout
506 * @dev: Pointer to the network device
508 * This function is called when Tx time out occurs for Emaclite device.
510 static void xemaclite_tx_timeout(struct net_device *dev)
512 struct net_local *lp = netdev_priv(dev);
513 unsigned long flags;
515 dev_err(&lp->ndev->dev, "Exceeded transmit timeout of %lu ms\n",
516 TX_TIMEOUT * 1000UL / HZ);
518 dev->stats.tx_errors++;
520 /* Reset the device */
521 spin_lock_irqsave(&lp->reset_lock, flags);
523 /* Shouldn't really be necessary, but shouldn't hurt */
524 netif_stop_queue(dev);
526 xemaclite_disable_interrupts(lp);
527 xemaclite_enable_interrupts(lp);
529 if (lp->deferred_skb) {
530 dev_kfree_skb(lp->deferred_skb);
531 lp->deferred_skb = NULL;
532 dev->stats.tx_errors++;
535 /* To exclude tx timeout */
536 dev->trans_start = jiffies; /* prevent tx timeout */
538 /* We're all ready to go. Start the queue */
539 netif_wake_queue(dev);
540 spin_unlock_irqrestore(&lp->reset_lock, flags);
543 /**********************/
544 /* Interrupt Handlers */
545 /**********************/
548 * xemaclite_tx_handler - Interrupt handler for frames sent
549 * @dev: Pointer to the network device
551 * This function updates the number of packets transmitted and handles the
552 * deferred skb, if there is one.
554 static void xemaclite_tx_handler(struct net_device *dev)
556 struct net_local *lp = netdev_priv(dev);
558 dev->stats.tx_packets++;
559 if (lp->deferred_skb) {
560 if (xemaclite_send_data(lp,
561 (u8 *) lp->deferred_skb->data,
562 lp->deferred_skb->len) != 0)
563 return;
564 else {
565 dev->stats.tx_bytes += lp->deferred_skb->len;
566 dev_kfree_skb_irq(lp->deferred_skb);
567 lp->deferred_skb = NULL;
568 dev->trans_start = jiffies; /* prevent tx timeout */
569 netif_wake_queue(dev);
575 * xemaclite_rx_handler- Interrupt handler for frames received
576 * @dev: Pointer to the network device
578 * This function allocates memory for a socket buffer, fills it with data
579 * received and hands it over to the TCP/IP stack.
581 static void xemaclite_rx_handler(struct net_device *dev)
583 struct net_local *lp = netdev_priv(dev);
584 struct sk_buff *skb;
585 unsigned int align;
586 u32 len;
588 len = ETH_FRAME_LEN + ETH_FCS_LEN;
589 skb = netdev_alloc_skb(dev, len + ALIGNMENT);
590 if (!skb) {
591 /* Couldn't get memory. */
592 dev->stats.rx_dropped++;
593 dev_err(&lp->ndev->dev, "Could not allocate receive buffer\n");
594 return;
598 * A new skb should have the data halfword aligned, but this code is
599 * here just in case that isn't true. Calculate how many
600 * bytes we should reserve to get the data to start on a word
601 * boundary */
602 align = BUFFER_ALIGN(skb->data);
603 if (align)
604 skb_reserve(skb, align);
606 skb_reserve(skb, 2);
608 len = xemaclite_recv_data(lp, (u8 *) skb->data);
610 if (!len) {
611 dev->stats.rx_errors++;
612 dev_kfree_skb_irq(skb);
613 return;
616 skb_put(skb, len); /* Tell the skb how much data we got */
618 skb->protocol = eth_type_trans(skb, dev);
619 skb_checksum_none_assert(skb);
621 dev->stats.rx_packets++;
622 dev->stats.rx_bytes += len;
624 if (!skb_defer_rx_timestamp(skb))
625 netif_rx(skb); /* Send the packet upstream */
629 * xemaclite_interrupt - Interrupt handler for this driver
630 * @irq: Irq of the Emaclite device
631 * @dev_id: Void pointer to the network device instance used as callback
632 * reference
634 * This function handles the Tx and Rx interrupts of the EmacLite device.
636 static irqreturn_t xemaclite_interrupt(int irq, void *dev_id)
638 bool tx_complete = false;
639 struct net_device *dev = dev_id;
640 struct net_local *lp = netdev_priv(dev);
641 void __iomem *base_addr = lp->base_addr;
642 u32 tx_status;
644 /* Check if there is Rx Data available */
645 if ((__raw_readl(base_addr + XEL_RSR_OFFSET) &
646 XEL_RSR_RECV_DONE_MASK) ||
647 (__raw_readl(base_addr + XEL_BUFFER_OFFSET + XEL_RSR_OFFSET)
648 & XEL_RSR_RECV_DONE_MASK))
650 xemaclite_rx_handler(dev);
652 /* Check if the Transmission for the first buffer is completed */
653 tx_status = __raw_readl(base_addr + XEL_TSR_OFFSET);
654 if (((tx_status & XEL_TSR_XMIT_BUSY_MASK) == 0) &&
655 (tx_status & XEL_TSR_XMIT_ACTIVE_MASK) != 0) {
657 tx_status &= ~XEL_TSR_XMIT_ACTIVE_MASK;
658 __raw_writel(tx_status, base_addr + XEL_TSR_OFFSET);
660 tx_complete = true;
663 /* Check if the Transmission for the second buffer is completed */
664 tx_status = __raw_readl(base_addr + XEL_BUFFER_OFFSET + XEL_TSR_OFFSET);
665 if (((tx_status & XEL_TSR_XMIT_BUSY_MASK) == 0) &&
666 (tx_status & XEL_TSR_XMIT_ACTIVE_MASK) != 0) {
668 tx_status &= ~XEL_TSR_XMIT_ACTIVE_MASK;
669 __raw_writel(tx_status, base_addr + XEL_BUFFER_OFFSET +
670 XEL_TSR_OFFSET);
672 tx_complete = true;
675 /* If there was a Tx interrupt, call the Tx Handler */
676 if (tx_complete != 0)
677 xemaclite_tx_handler(dev);
679 return IRQ_HANDLED;
682 /**********************/
683 /* MDIO Bus functions */
684 /**********************/
687 * xemaclite_mdio_wait - Wait for the MDIO to be ready to use
688 * @lp: Pointer to the Emaclite device private data
690 * This function waits till the device is ready to accept a new MDIO
691 * request.
693 * Return: 0 for success or ETIMEDOUT for a timeout
696 static int xemaclite_mdio_wait(struct net_local *lp)
698 long end = jiffies + 2;
700 /* wait for the MDIO interface to not be busy or timeout
701 after some time.
703 while (__raw_readl(lp->base_addr + XEL_MDIOCTRL_OFFSET) &
704 XEL_MDIOCTRL_MDIOSTS_MASK) {
705 if (end - jiffies <= 0) {
706 WARN_ON(1);
707 return -ETIMEDOUT;
709 msleep(1);
711 return 0;
715 * xemaclite_mdio_read - Read from a given MII management register
716 * @bus: the mii_bus struct
717 * @phy_id: the phy address
718 * @reg: register number to read from
720 * This function waits till the device is ready to accept a new MDIO
721 * request and then writes the phy address to the MDIO Address register
722 * and reads data from MDIO Read Data register, when its available.
724 * Return: Value read from the MII management register
726 static int xemaclite_mdio_read(struct mii_bus *bus, int phy_id, int reg)
728 struct net_local *lp = bus->priv;
729 u32 ctrl_reg;
730 u32 rc;
732 if (xemaclite_mdio_wait(lp))
733 return -ETIMEDOUT;
735 /* Write the PHY address, register number and set the OP bit in the
736 * MDIO Address register. Set the Status bit in the MDIO Control
737 * register to start a MDIO read transaction.
739 ctrl_reg = __raw_readl(lp->base_addr + XEL_MDIOCTRL_OFFSET);
740 __raw_writel(XEL_MDIOADDR_OP_MASK |
741 ((phy_id << XEL_MDIOADDR_PHYADR_SHIFT) | reg),
742 lp->base_addr + XEL_MDIOADDR_OFFSET);
743 __raw_writel(ctrl_reg | XEL_MDIOCTRL_MDIOSTS_MASK,
744 lp->base_addr + XEL_MDIOCTRL_OFFSET);
746 if (xemaclite_mdio_wait(lp))
747 return -ETIMEDOUT;
749 rc = __raw_readl(lp->base_addr + XEL_MDIORD_OFFSET);
751 dev_dbg(&lp->ndev->dev,
752 "xemaclite_mdio_read(phy_id=%i, reg=%x) == %x\n",
753 phy_id, reg, rc);
755 return rc;
759 * xemaclite_mdio_write - Write to a given MII management register
760 * @bus: the mii_bus struct
761 * @phy_id: the phy address
762 * @reg: register number to write to
763 * @val: value to write to the register number specified by reg
765 * This function waits till the device is ready to accept a new MDIO
766 * request and then writes the val to the MDIO Write Data register.
768 static int xemaclite_mdio_write(struct mii_bus *bus, int phy_id, int reg,
769 u16 val)
771 struct net_local *lp = bus->priv;
772 u32 ctrl_reg;
774 dev_dbg(&lp->ndev->dev,
775 "xemaclite_mdio_write(phy_id=%i, reg=%x, val=%x)\n",
776 phy_id, reg, val);
778 if (xemaclite_mdio_wait(lp))
779 return -ETIMEDOUT;
781 /* Write the PHY address, register number and clear the OP bit in the
782 * MDIO Address register and then write the value into the MDIO Write
783 * Data register. Finally, set the Status bit in the MDIO Control
784 * register to start a MDIO write transaction.
786 ctrl_reg = __raw_readl(lp->base_addr + XEL_MDIOCTRL_OFFSET);
787 __raw_writel(~XEL_MDIOADDR_OP_MASK &
788 ((phy_id << XEL_MDIOADDR_PHYADR_SHIFT) | reg),
789 lp->base_addr + XEL_MDIOADDR_OFFSET);
790 __raw_writel(val, lp->base_addr + XEL_MDIOWR_OFFSET);
791 __raw_writel(ctrl_reg | XEL_MDIOCTRL_MDIOSTS_MASK,
792 lp->base_addr + XEL_MDIOCTRL_OFFSET);
794 return 0;
798 * xemaclite_mdio_reset - Reset the mdio bus.
799 * @bus: Pointer to the MII bus
801 * This function is required(?) as per Documentation/networking/phy.txt.
802 * There is no reset in this device; this function always returns 0.
804 static int xemaclite_mdio_reset(struct mii_bus *bus)
806 return 0;
810 * xemaclite_mdio_setup - Register mii_bus for the Emaclite device
811 * @lp: Pointer to the Emaclite device private data
812 * @ofdev: Pointer to OF device structure
814 * This function enables MDIO bus in the Emaclite device and registers a
815 * mii_bus.
817 * Return: 0 upon success or a negative error upon failure
819 static int xemaclite_mdio_setup(struct net_local *lp, struct device *dev)
821 struct mii_bus *bus;
822 int rc;
823 struct resource res;
824 struct device_node *np = of_get_parent(lp->phy_node);
825 struct device_node *npp;
827 /* Don't register the MDIO bus if the phy_node or its parent node
828 * can't be found.
830 if (!np) {
831 dev_err(dev, "Failed to register mdio bus.\n");
832 return -ENODEV;
834 npp = of_get_parent(np);
836 of_address_to_resource(npp, 0, &res);
837 if (lp->ndev->mem_start != res.start) {
838 struct phy_device *phydev;
839 phydev = of_phy_find_device(lp->phy_node);
840 if (!phydev)
841 dev_info(dev,
842 "MDIO of the phy is not registered yet\n");
843 return 0;
846 /* Enable the MDIO bus by asserting the enable bit in MDIO Control
847 * register.
849 __raw_writel(XEL_MDIOCTRL_MDIOEN_MASK,
850 lp->base_addr + XEL_MDIOCTRL_OFFSET);
852 bus = mdiobus_alloc();
853 if (!bus) {
854 dev_err(dev, "Failed to allocate mdiobus\n");
855 return -ENOMEM;
858 snprintf(bus->id, MII_BUS_ID_SIZE, "%.8llx",
859 (unsigned long long)res.start);
860 bus->priv = lp;
861 bus->name = "Xilinx Emaclite MDIO";
862 bus->read = xemaclite_mdio_read;
863 bus->write = xemaclite_mdio_write;
864 bus->reset = xemaclite_mdio_reset;
865 bus->parent = dev;
866 bus->irq = lp->mdio_irqs; /* preallocated IRQ table */
868 lp->mii_bus = bus;
870 rc = of_mdiobus_register(bus, np);
871 if (rc) {
872 dev_err(dev, "Failed to register mdio bus.\n");
873 goto err_register;
876 return 0;
878 err_register:
879 mdiobus_free(bus);
880 return rc;
884 * xemaclite_adjust_link - Link state callback for the Emaclite device
885 * @ndev: pointer to net_device struct
887 * There's nothing in the Emaclite device to be configured when the link
888 * state changes. We just print the status.
890 static void xemaclite_adjust_link(struct net_device *ndev)
892 struct net_local *lp = netdev_priv(ndev);
893 struct phy_device *phy = lp->phy_dev;
894 int link_state;
896 /* hash together the state values to decide if something has changed */
897 link_state = phy->speed | (phy->duplex << 1) | phy->link;
899 if (lp->last_link != link_state) {
900 lp->last_link = link_state;
901 phy_print_status(phy);
906 * xemaclite_open - Open the network device
907 * @dev: Pointer to the network device
909 * This function sets the MAC address, requests an IRQ and enables interrupts
910 * for the Emaclite device and starts the Tx queue.
911 * It also connects to the phy device, if MDIO is included in Emaclite device.
913 static int xemaclite_open(struct net_device *dev)
915 struct net_local *lp = netdev_priv(dev);
916 int retval;
918 /* Just to be safe, stop the device first */
919 xemaclite_disable_interrupts(lp);
921 if (lp->phy_node) {
922 u32 bmcr;
924 lp->phy_dev = of_phy_connect(lp->ndev, lp->phy_node,
925 xemaclite_adjust_link, 0,
926 PHY_INTERFACE_MODE_MII);
927 if (!lp->phy_dev) {
928 dev_err(&lp->ndev->dev, "of_phy_connect() failed\n");
929 return -ENODEV;
932 /* EmacLite doesn't support giga-bit speeds */
933 lp->phy_dev->supported &= (PHY_BASIC_FEATURES);
934 lp->phy_dev->advertising = lp->phy_dev->supported;
936 /* Don't advertise 1000BASE-T Full/Half duplex speeds */
937 phy_write(lp->phy_dev, MII_CTRL1000, 0);
939 /* Advertise only 10 and 100mbps full/half duplex speeds */
940 phy_write(lp->phy_dev, MII_ADVERTISE, ADVERTISE_ALL |
941 ADVERTISE_CSMA);
943 /* Restart auto negotiation */
944 bmcr = phy_read(lp->phy_dev, MII_BMCR);
945 bmcr |= (BMCR_ANENABLE | BMCR_ANRESTART);
946 phy_write(lp->phy_dev, MII_BMCR, bmcr);
948 phy_start(lp->phy_dev);
951 /* Set the MAC address each time opened */
952 xemaclite_update_address(lp, dev->dev_addr);
954 /* Grab the IRQ */
955 retval = request_irq(dev->irq, xemaclite_interrupt, 0, dev->name, dev);
956 if (retval) {
957 dev_err(&lp->ndev->dev, "Could not allocate interrupt %d\n",
958 dev->irq);
959 if (lp->phy_dev)
960 phy_disconnect(lp->phy_dev);
961 lp->phy_dev = NULL;
963 return retval;
966 /* Enable Interrupts */
967 xemaclite_enable_interrupts(lp);
969 /* We're ready to go */
970 netif_start_queue(dev);
972 return 0;
976 * xemaclite_close - Close the network device
977 * @dev: Pointer to the network device
979 * This function stops the Tx queue, disables interrupts and frees the IRQ for
980 * the Emaclite device.
981 * It also disconnects the phy device associated with the Emaclite device.
983 static int xemaclite_close(struct net_device *dev)
985 struct net_local *lp = netdev_priv(dev);
987 netif_stop_queue(dev);
988 xemaclite_disable_interrupts(lp);
989 free_irq(dev->irq, dev);
991 if (lp->phy_dev)
992 phy_disconnect(lp->phy_dev);
993 lp->phy_dev = NULL;
995 return 0;
999 * xemaclite_send - Transmit a frame
1000 * @orig_skb: Pointer to the socket buffer to be transmitted
1001 * @dev: Pointer to the network device
1003 * This function checks if the Tx buffer of the Emaclite device is free to send
1004 * data. If so, it fills the Tx buffer with data from socket buffer data,
1005 * updates the stats and frees the socket buffer. The Tx completion is signaled
1006 * by an interrupt. If the Tx buffer isn't free, then the socket buffer is
1007 * deferred and the Tx queue is stopped so that the deferred socket buffer can
1008 * be transmitted when the Emaclite device is free to transmit data.
1010 * Return: 0, always.
1012 static int xemaclite_send(struct sk_buff *orig_skb, struct net_device *dev)
1014 struct net_local *lp = netdev_priv(dev);
1015 struct sk_buff *new_skb;
1016 unsigned int len;
1017 unsigned long flags;
1019 len = orig_skb->len;
1021 new_skb = orig_skb;
1023 spin_lock_irqsave(&lp->reset_lock, flags);
1024 if (xemaclite_send_data(lp, (u8 *) new_skb->data, len) != 0) {
1025 /* If the Emaclite Tx buffer is busy, stop the Tx queue and
1026 * defer the skb for transmission during the ISR, after the
1027 * current transmission is complete */
1028 netif_stop_queue(dev);
1029 lp->deferred_skb = new_skb;
1030 /* Take the time stamp now, since we can't do this in an ISR. */
1031 skb_tx_timestamp(new_skb);
1032 spin_unlock_irqrestore(&lp->reset_lock, flags);
1033 return 0;
1035 spin_unlock_irqrestore(&lp->reset_lock, flags);
1037 skb_tx_timestamp(new_skb);
1039 dev->stats.tx_bytes += len;
1040 dev_kfree_skb(new_skb);
1042 return 0;
1046 * xemaclite_remove_ndev - Free the network device
1047 * @ndev: Pointer to the network device to be freed
1049 * This function un maps the IO region of the Emaclite device and frees the net
1050 * device.
1052 static void xemaclite_remove_ndev(struct net_device *ndev)
1054 if (ndev) {
1055 free_netdev(ndev);
1060 * get_bool - Get a parameter from the OF device
1061 * @ofdev: Pointer to OF device structure
1062 * @s: Property to be retrieved
1064 * This function looks for a property in the device node and returns the value
1065 * of the property if its found or 0 if the property is not found.
1067 * Return: Value of the parameter if the parameter is found, or 0 otherwise
1069 static bool get_bool(struct platform_device *ofdev, const char *s)
1071 u32 *p = (u32 *)of_get_property(ofdev->dev.of_node, s, NULL);
1073 if (p) {
1074 return (bool)*p;
1075 } else {
1076 dev_warn(&ofdev->dev, "Parameter %s not found,"
1077 "defaulting to false\n", s);
1078 return 0;
1082 static struct net_device_ops xemaclite_netdev_ops;
1085 * xemaclite_of_probe - Probe method for the Emaclite device.
1086 * @ofdev: Pointer to OF device structure
1087 * @match: Pointer to the structure used for matching a device
1089 * This function probes for the Emaclite device in the device tree.
1090 * It initializes the driver data structure and the hardware, sets the MAC
1091 * address and registers the network device.
1092 * It also registers a mii_bus for the Emaclite device, if MDIO is included
1093 * in the device.
1095 * Return: 0, if the driver is bound to the Emaclite device, or
1096 * a negative error if there is failure.
1098 static int xemaclite_of_probe(struct platform_device *ofdev)
1100 struct resource *res;
1101 struct net_device *ndev = NULL;
1102 struct net_local *lp = NULL;
1103 struct device *dev = &ofdev->dev;
1104 const void *mac_address;
1106 int rc = 0;
1108 dev_info(dev, "Device Tree Probing\n");
1110 /* Create an ethernet device instance */
1111 ndev = alloc_etherdev(sizeof(struct net_local));
1112 if (!ndev)
1113 return -ENOMEM;
1115 dev_set_drvdata(dev, ndev);
1116 SET_NETDEV_DEV(ndev, &ofdev->dev);
1118 lp = netdev_priv(ndev);
1119 lp->ndev = ndev;
1121 /* Get IRQ for the device */
1122 res = platform_get_resource(ofdev, IORESOURCE_IRQ, 0);
1123 if (!res) {
1124 dev_err(dev, "no IRQ found\n");
1125 goto error;
1128 ndev->irq = res->start;
1130 res = platform_get_resource(ofdev, IORESOURCE_MEM, 0);
1131 lp->base_addr = devm_ioremap_resource(&ofdev->dev, res);
1132 if (IS_ERR(lp->base_addr)) {
1133 rc = PTR_ERR(lp->base_addr);
1134 goto error;
1137 ndev->mem_start = res->start;
1138 ndev->mem_end = res->end;
1140 spin_lock_init(&lp->reset_lock);
1141 lp->next_tx_buf_to_use = 0x0;
1142 lp->next_rx_buf_to_use = 0x0;
1143 lp->tx_ping_pong = get_bool(ofdev, "xlnx,tx-ping-pong");
1144 lp->rx_ping_pong = get_bool(ofdev, "xlnx,rx-ping-pong");
1145 mac_address = of_get_mac_address(ofdev->dev.of_node);
1147 if (mac_address)
1148 /* Set the MAC address. */
1149 memcpy(ndev->dev_addr, mac_address, ETH_ALEN);
1150 else
1151 dev_warn(dev, "No MAC address found\n");
1153 /* Clear the Tx CSR's in case this is a restart */
1154 __raw_writel(0, lp->base_addr + XEL_TSR_OFFSET);
1155 __raw_writel(0, lp->base_addr + XEL_BUFFER_OFFSET + XEL_TSR_OFFSET);
1157 /* Set the MAC address in the EmacLite device */
1158 xemaclite_update_address(lp, ndev->dev_addr);
1160 lp->phy_node = of_parse_phandle(ofdev->dev.of_node, "phy-handle", 0);
1161 rc = xemaclite_mdio_setup(lp, &ofdev->dev);
1162 if (rc)
1163 dev_warn(&ofdev->dev, "error registering MDIO bus\n");
1165 dev_info(dev, "MAC address is now %pM\n", ndev->dev_addr);
1167 ndev->netdev_ops = &xemaclite_netdev_ops;
1168 ndev->flags &= ~IFF_MULTICAST;
1169 ndev->watchdog_timeo = TX_TIMEOUT;
1171 /* Finally, register the device */
1172 rc = register_netdev(ndev);
1173 if (rc) {
1174 dev_err(dev,
1175 "Cannot register network device, aborting\n");
1176 goto error;
1179 dev_info(dev,
1180 "Xilinx EmacLite at 0x%08X mapped to 0x%08X, irq=%d\n",
1181 (unsigned int __force)ndev->mem_start,
1182 (unsigned int __force)lp->base_addr, ndev->irq);
1183 return 0;
1185 error:
1186 xemaclite_remove_ndev(ndev);
1187 return rc;
1191 * xemaclite_of_remove - Unbind the driver from the Emaclite device.
1192 * @of_dev: Pointer to OF device structure
1194 * This function is called if a device is physically removed from the system or
1195 * if the driver module is being unloaded. It frees any resources allocated to
1196 * the device.
1198 * Return: 0, always.
1200 static int xemaclite_of_remove(struct platform_device *of_dev)
1202 struct net_device *ndev = platform_get_drvdata(of_dev);
1204 struct net_local *lp = netdev_priv(ndev);
1206 /* Un-register the mii_bus, if configured */
1207 if (lp->has_mdio) {
1208 mdiobus_unregister(lp->mii_bus);
1209 kfree(lp->mii_bus->irq);
1210 mdiobus_free(lp->mii_bus);
1211 lp->mii_bus = NULL;
1214 unregister_netdev(ndev);
1216 if (lp->phy_node)
1217 of_node_put(lp->phy_node);
1218 lp->phy_node = NULL;
1220 xemaclite_remove_ndev(ndev);
1222 return 0;
1225 #ifdef CONFIG_NET_POLL_CONTROLLER
1226 static void
1227 xemaclite_poll_controller(struct net_device *ndev)
1229 disable_irq(ndev->irq);
1230 xemaclite_interrupt(ndev->irq, ndev);
1231 enable_irq(ndev->irq);
1233 #endif
1235 static struct net_device_ops xemaclite_netdev_ops = {
1236 .ndo_open = xemaclite_open,
1237 .ndo_stop = xemaclite_close,
1238 .ndo_start_xmit = xemaclite_send,
1239 .ndo_set_mac_address = xemaclite_set_mac_address,
1240 .ndo_tx_timeout = xemaclite_tx_timeout,
1241 #ifdef CONFIG_NET_POLL_CONTROLLER
1242 .ndo_poll_controller = xemaclite_poll_controller,
1243 #endif
1246 /* Match table for OF platform binding */
1247 static struct of_device_id xemaclite_of_match[] = {
1248 { .compatible = "xlnx,opb-ethernetlite-1.01.a", },
1249 { .compatible = "xlnx,opb-ethernetlite-1.01.b", },
1250 { .compatible = "xlnx,xps-ethernetlite-1.00.a", },
1251 { .compatible = "xlnx,xps-ethernetlite-2.00.a", },
1252 { .compatible = "xlnx,xps-ethernetlite-2.01.a", },
1253 { .compatible = "xlnx,xps-ethernetlite-3.00.a", },
1254 { /* end of list */ },
1256 MODULE_DEVICE_TABLE(of, xemaclite_of_match);
1258 static struct platform_driver xemaclite_of_driver = {
1259 .driver = {
1260 .name = DRIVER_NAME,
1261 .owner = THIS_MODULE,
1262 .of_match_table = xemaclite_of_match,
1264 .probe = xemaclite_of_probe,
1265 .remove = xemaclite_of_remove,
1268 module_platform_driver(xemaclite_of_driver);
1270 MODULE_AUTHOR("Xilinx, Inc.");
1271 MODULE_DESCRIPTION("Xilinx Ethernet MAC Lite driver");
1272 MODULE_LICENSE("GPL");