2 * Aeroflex Gaisler GRETH 10/100/1G Ethernet MAC.
4 * 2005-2010 (c) Aeroflex Gaisler AB
6 * This driver supports GRETH 10/100 and GRETH 10/100/1G Ethernet MACs
7 * available in the GRLIB VHDL IP core library.
9 * Full documentation of both cores can be found here:
10 * http://www.gaisler.com/products/grlib/grip.pdf
12 * The Gigabit version supports scatter/gather DMA, any alignment of
13 * buffers and checksum offloading.
15 * This program is free software; you can redistribute it and/or modify it
16 * under the terms of the GNU General Public License as published by the
17 * Free Software Foundation; either version 2 of the License, or (at your
18 * option) any later version.
20 * Contributors: Kristoffer Glembo
25 #include <linux/dma-mapping.h>
26 #include <linux/module.h>
27 #include <linux/uaccess.h>
28 #include <linux/init.h>
29 #include <linux/interrupt.h>
30 #include <linux/netdevice.h>
31 #include <linux/etherdevice.h>
32 #include <linux/ethtool.h>
33 #include <linux/skbuff.h>
35 #include <linux/crc32.h>
36 #include <linux/mii.h>
37 #include <linux/of_device.h>
38 #include <linux/of_platform.h>
39 #include <linux/slab.h>
40 #include <asm/cacheflush.h>
41 #include <asm/byteorder.h>
44 #include <asm/idprom.h>
49 #define GRETH_DEF_MSG_ENABLE \
58 static int greth_debug = -1; /* -1 == use GRETH_DEF_MSG_ENABLE as value */
59 module_param(greth_debug, int, 0);
60 MODULE_PARM_DESC(greth_debug, "GRETH bitmapped debugging message enable value");
62 /* Accept MAC address of the form macaddr=0x08,0x00,0x20,0x30,0x40,0x50 */
63 static int macaddr[6];
64 module_param_array(macaddr, int, NULL, 0);
65 MODULE_PARM_DESC(macaddr, "GRETH Ethernet MAC address");
67 static int greth_edcl = 1;
68 module_param(greth_edcl, int, 0);
69 MODULE_PARM_DESC(greth_edcl, "GRETH EDCL usage indicator. Set to 1 if EDCL is used.");
71 static int greth_open(struct net_device *dev);
72 static netdev_tx_t greth_start_xmit(struct sk_buff *skb,
73 struct net_device *dev);
74 static netdev_tx_t greth_start_xmit_gbit(struct sk_buff *skb,
75 struct net_device *dev);
76 static int greth_rx(struct net_device *dev, int limit);
77 static int greth_rx_gbit(struct net_device *dev, int limit);
78 static void greth_clean_tx(struct net_device *dev);
79 static void greth_clean_tx_gbit(struct net_device *dev);
80 static irqreturn_t greth_interrupt(int irq, void *dev_id);
81 static int greth_close(struct net_device *dev);
82 static int greth_set_mac_add(struct net_device *dev, void *p);
83 static void greth_set_multicast_list(struct net_device *dev);
85 #define GRETH_REGLOAD(a) (be32_to_cpu(__raw_readl(&(a))))
86 #define GRETH_REGSAVE(a, v) (__raw_writel(cpu_to_be32(v), &(a)))
87 #define GRETH_REGORIN(a, v) (GRETH_REGSAVE(a, (GRETH_REGLOAD(a) | (v))))
88 #define GRETH_REGANDIN(a, v) (GRETH_REGSAVE(a, (GRETH_REGLOAD(a) & (v))))
90 #define NEXT_TX(N) (((N) + 1) & GRETH_TXBD_NUM_MASK)
91 #define SKIP_TX(N, C) (((N) + C) & GRETH_TXBD_NUM_MASK)
92 #define NEXT_RX(N) (((N) + 1) & GRETH_RXBD_NUM_MASK)
94 static void greth_print_rx_packet(void *addr, int len)
96 print_hex_dump(KERN_DEBUG, "RX: ", DUMP_PREFIX_OFFSET, 16, 1,
100 static void greth_print_tx_packet(struct sk_buff *skb)
105 if (skb_shinfo(skb)->nr_frags == 0)
108 length = skb_headlen(skb);
110 print_hex_dump(KERN_DEBUG, "TX: ", DUMP_PREFIX_OFFSET, 16, 1,
111 skb->data, length, true);
113 for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
115 print_hex_dump(KERN_DEBUG, "TX: ", DUMP_PREFIX_OFFSET, 16, 1,
116 phys_to_virt(page_to_phys(skb_shinfo(skb)->frags[i].page)) +
117 skb_shinfo(skb)->frags[i].page_offset,
122 static inline void greth_enable_tx(struct greth_private *greth)
125 GRETH_REGORIN(greth->regs->control, GRETH_TXEN);
128 static inline void greth_disable_tx(struct greth_private *greth)
130 GRETH_REGANDIN(greth->regs->control, ~GRETH_TXEN);
133 static inline void greth_enable_rx(struct greth_private *greth)
136 GRETH_REGORIN(greth->regs->control, GRETH_RXEN);
139 static inline void greth_disable_rx(struct greth_private *greth)
141 GRETH_REGANDIN(greth->regs->control, ~GRETH_RXEN);
144 static inline void greth_enable_irqs(struct greth_private *greth)
146 GRETH_REGORIN(greth->regs->control, GRETH_RXI | GRETH_TXI);
149 static inline void greth_disable_irqs(struct greth_private *greth)
151 GRETH_REGANDIN(greth->regs->control, ~(GRETH_RXI|GRETH_TXI));
154 static inline void greth_write_bd(u32 *bd, u32 val)
156 __raw_writel(cpu_to_be32(val), bd);
159 static inline u32 greth_read_bd(u32 *bd)
161 return be32_to_cpu(__raw_readl(bd));
164 static void greth_clean_rings(struct greth_private *greth)
167 struct greth_bd *rx_bdp = greth->rx_bd_base;
168 struct greth_bd *tx_bdp = greth->tx_bd_base;
170 if (greth->gbit_mac) {
172 /* Free and unmap RX buffers */
173 for (i = 0; i < GRETH_RXBD_NUM; i++, rx_bdp++) {
174 if (greth->rx_skbuff[i] != NULL) {
175 dev_kfree_skb(greth->rx_skbuff[i]);
176 dma_unmap_single(greth->dev,
177 greth_read_bd(&rx_bdp->addr),
178 MAX_FRAME_SIZE+NET_IP_ALIGN,
184 while (greth->tx_free < GRETH_TXBD_NUM) {
186 struct sk_buff *skb = greth->tx_skbuff[greth->tx_last];
187 int nr_frags = skb_shinfo(skb)->nr_frags;
188 tx_bdp = greth->tx_bd_base + greth->tx_last;
189 greth->tx_last = NEXT_TX(greth->tx_last);
191 dma_unmap_single(greth->dev,
192 greth_read_bd(&tx_bdp->addr),
196 for (i = 0; i < nr_frags; i++) {
197 skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
198 tx_bdp = greth->tx_bd_base + greth->tx_last;
200 dma_unmap_page(greth->dev,
201 greth_read_bd(&tx_bdp->addr),
205 greth->tx_last = NEXT_TX(greth->tx_last);
207 greth->tx_free += nr_frags+1;
212 } else { /* 10/100 Mbps MAC */
214 for (i = 0; i < GRETH_RXBD_NUM; i++, rx_bdp++) {
215 kfree(greth->rx_bufs[i]);
216 dma_unmap_single(greth->dev,
217 greth_read_bd(&rx_bdp->addr),
221 for (i = 0; i < GRETH_TXBD_NUM; i++, tx_bdp++) {
222 kfree(greth->tx_bufs[i]);
223 dma_unmap_single(greth->dev,
224 greth_read_bd(&tx_bdp->addr),
231 static int greth_init_rings(struct greth_private *greth)
234 struct greth_bd *rx_bd, *tx_bd;
238 rx_bd = greth->rx_bd_base;
239 tx_bd = greth->tx_bd_base;
241 /* Initialize descriptor rings and buffers */
242 if (greth->gbit_mac) {
244 for (i = 0; i < GRETH_RXBD_NUM; i++) {
245 skb = netdev_alloc_skb(greth->netdev, MAX_FRAME_SIZE+NET_IP_ALIGN);
247 if (netif_msg_ifup(greth))
248 dev_err(greth->dev, "Error allocating DMA ring.\n");
251 skb_reserve(skb, NET_IP_ALIGN);
252 dma_addr = dma_map_single(greth->dev,
254 MAX_FRAME_SIZE+NET_IP_ALIGN,
257 if (dma_mapping_error(greth->dev, dma_addr)) {
258 if (netif_msg_ifup(greth))
259 dev_err(greth->dev, "Could not create initial DMA mapping\n");
262 greth->rx_skbuff[i] = skb;
263 greth_write_bd(&rx_bd[i].addr, dma_addr);
264 greth_write_bd(&rx_bd[i].stat, GRETH_BD_EN | GRETH_BD_IE);
269 /* 10/100 MAC uses a fixed set of buffers and copy to/from SKBs */
270 for (i = 0; i < GRETH_RXBD_NUM; i++) {
272 greth->rx_bufs[i] = kmalloc(MAX_FRAME_SIZE, GFP_KERNEL);
274 if (greth->rx_bufs[i] == NULL) {
275 if (netif_msg_ifup(greth))
276 dev_err(greth->dev, "Error allocating DMA ring.\n");
280 dma_addr = dma_map_single(greth->dev,
285 if (dma_mapping_error(greth->dev, dma_addr)) {
286 if (netif_msg_ifup(greth))
287 dev_err(greth->dev, "Could not create initial DMA mapping\n");
290 greth_write_bd(&rx_bd[i].addr, dma_addr);
291 greth_write_bd(&rx_bd[i].stat, GRETH_BD_EN | GRETH_BD_IE);
293 for (i = 0; i < GRETH_TXBD_NUM; i++) {
295 greth->tx_bufs[i] = kmalloc(MAX_FRAME_SIZE, GFP_KERNEL);
297 if (greth->tx_bufs[i] == NULL) {
298 if (netif_msg_ifup(greth))
299 dev_err(greth->dev, "Error allocating DMA ring.\n");
303 dma_addr = dma_map_single(greth->dev,
308 if (dma_mapping_error(greth->dev, dma_addr)) {
309 if (netif_msg_ifup(greth))
310 dev_err(greth->dev, "Could not create initial DMA mapping\n");
313 greth_write_bd(&tx_bd[i].addr, dma_addr);
314 greth_write_bd(&tx_bd[i].stat, 0);
317 greth_write_bd(&rx_bd[GRETH_RXBD_NUM - 1].stat,
318 greth_read_bd(&rx_bd[GRETH_RXBD_NUM - 1].stat) | GRETH_BD_WR);
320 /* Initialize pointers. */
324 greth->tx_free = GRETH_TXBD_NUM;
326 /* Initialize descriptor base address */
327 GRETH_REGSAVE(greth->regs->tx_desc_p, greth->tx_bd_base_phys);
328 GRETH_REGSAVE(greth->regs->rx_desc_p, greth->rx_bd_base_phys);
333 greth_clean_rings(greth);
337 static int greth_open(struct net_device *dev)
339 struct greth_private *greth = netdev_priv(dev);
342 err = greth_init_rings(greth);
344 if (netif_msg_ifup(greth))
345 dev_err(&dev->dev, "Could not allocate memory for DMA rings\n");
349 err = request_irq(greth->irq, greth_interrupt, 0, "eth", (void *) dev);
351 if (netif_msg_ifup(greth))
352 dev_err(&dev->dev, "Could not allocate interrupt %d\n", dev->irq);
353 greth_clean_rings(greth);
357 if (netif_msg_ifup(greth))
358 dev_dbg(&dev->dev, " starting queue\n");
359 netif_start_queue(dev);
361 GRETH_REGSAVE(greth->regs->status, 0xFF);
363 napi_enable(&greth->napi);
365 greth_enable_irqs(greth);
366 greth_enable_tx(greth);
367 greth_enable_rx(greth);
372 static int greth_close(struct net_device *dev)
374 struct greth_private *greth = netdev_priv(dev);
376 napi_disable(&greth->napi);
378 greth_disable_irqs(greth);
379 greth_disable_tx(greth);
380 greth_disable_rx(greth);
382 netif_stop_queue(dev);
384 free_irq(greth->irq, (void *) dev);
386 greth_clean_rings(greth);
392 greth_start_xmit(struct sk_buff *skb, struct net_device *dev)
394 struct greth_private *greth = netdev_priv(dev);
395 struct greth_bd *bdp;
396 int err = NETDEV_TX_OK;
397 u32 status, dma_addr, ctrl;
401 greth_clean_tx(greth->netdev);
403 if (unlikely(greth->tx_free <= 0)) {
404 spin_lock_irqsave(&greth->devlock, flags);/*save from poll/irq*/
405 ctrl = GRETH_REGLOAD(greth->regs->control);
406 /* Enable TX IRQ only if not already in poll() routine */
407 if (ctrl & GRETH_RXI)
408 GRETH_REGSAVE(greth->regs->control, ctrl | GRETH_TXI);
409 netif_stop_queue(dev);
410 spin_unlock_irqrestore(&greth->devlock, flags);
411 return NETDEV_TX_BUSY;
414 if (netif_msg_pktdata(greth))
415 greth_print_tx_packet(skb);
418 if (unlikely(skb->len > MAX_FRAME_SIZE)) {
419 dev->stats.tx_errors++;
423 bdp = greth->tx_bd_base + greth->tx_next;
424 dma_addr = greth_read_bd(&bdp->addr);
426 memcpy((unsigned char *) phys_to_virt(dma_addr), skb->data, skb->len);
428 dma_sync_single_for_device(greth->dev, dma_addr, skb->len, DMA_TO_DEVICE);
430 status = GRETH_BD_EN | GRETH_BD_IE | (skb->len & GRETH_BD_LEN);
432 /* Wrap around descriptor ring */
433 if (greth->tx_next == GRETH_TXBD_NUM_MASK) {
434 status |= GRETH_BD_WR;
437 greth->tx_next = NEXT_TX(greth->tx_next);
440 /* Write descriptor control word and enable transmission */
441 greth_write_bd(&bdp->stat, status);
442 spin_lock_irqsave(&greth->devlock, flags); /*save from poll/irq*/
443 greth_enable_tx(greth);
444 spin_unlock_irqrestore(&greth->devlock, flags);
453 greth_start_xmit_gbit(struct sk_buff *skb, struct net_device *dev)
455 struct greth_private *greth = netdev_priv(dev);
456 struct greth_bd *bdp;
457 u32 status = 0, dma_addr, ctrl;
458 int curr_tx, nr_frags, i, err = NETDEV_TX_OK;
461 nr_frags = skb_shinfo(skb)->nr_frags;
464 greth_clean_tx_gbit(dev);
466 if (greth->tx_free < nr_frags + 1) {
467 spin_lock_irqsave(&greth->devlock, flags);/*save from poll/irq*/
468 ctrl = GRETH_REGLOAD(greth->regs->control);
469 /* Enable TX IRQ only if not already in poll() routine */
470 if (ctrl & GRETH_RXI)
471 GRETH_REGSAVE(greth->regs->control, ctrl | GRETH_TXI);
472 netif_stop_queue(dev);
473 spin_unlock_irqrestore(&greth->devlock, flags);
474 err = NETDEV_TX_BUSY;
478 if (netif_msg_pktdata(greth))
479 greth_print_tx_packet(skb);
481 if (unlikely(skb->len > MAX_FRAME_SIZE)) {
482 dev->stats.tx_errors++;
486 /* Save skb pointer. */
487 greth->tx_skbuff[greth->tx_next] = skb;
491 status = GRETH_TXBD_MORE;
493 status |= GRETH_TXBD_CSALL;
494 status |= skb_headlen(skb) & GRETH_BD_LEN;
495 if (greth->tx_next == GRETH_TXBD_NUM_MASK)
496 status |= GRETH_BD_WR;
499 bdp = greth->tx_bd_base + greth->tx_next;
500 greth_write_bd(&bdp->stat, status);
501 dma_addr = dma_map_single(greth->dev, skb->data, skb_headlen(skb), DMA_TO_DEVICE);
503 if (unlikely(dma_mapping_error(greth->dev, dma_addr)))
506 greth_write_bd(&bdp->addr, dma_addr);
508 curr_tx = NEXT_TX(greth->tx_next);
511 for (i = 0; i < nr_frags; i++) {
512 skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
513 greth->tx_skbuff[curr_tx] = NULL;
514 bdp = greth->tx_bd_base + curr_tx;
516 status = GRETH_TXBD_CSALL | GRETH_BD_EN;
517 status |= frag->size & GRETH_BD_LEN;
519 /* Wrap around descriptor ring */
520 if (curr_tx == GRETH_TXBD_NUM_MASK)
521 status |= GRETH_BD_WR;
523 /* More fragments left */
524 if (i < nr_frags - 1)
525 status |= GRETH_TXBD_MORE;
527 status |= GRETH_BD_IE; /* enable IRQ on last fragment */
529 greth_write_bd(&bdp->stat, status);
531 dma_addr = dma_map_page(greth->dev,
537 if (unlikely(dma_mapping_error(greth->dev, dma_addr)))
540 greth_write_bd(&bdp->addr, dma_addr);
542 curr_tx = NEXT_TX(curr_tx);
547 /* Enable the descriptor chain by enabling the first descriptor */
548 bdp = greth->tx_bd_base + greth->tx_next;
549 greth_write_bd(&bdp->stat, greth_read_bd(&bdp->stat) | GRETH_BD_EN);
550 greth->tx_next = curr_tx;
551 greth->tx_free -= nr_frags + 1;
555 spin_lock_irqsave(&greth->devlock, flags); /*save from poll/irq*/
556 greth_enable_tx(greth);
557 spin_unlock_irqrestore(&greth->devlock, flags);
562 /* Unmap SKB mappings that succeeded and disable descriptor */
563 for (i = 0; greth->tx_next + i != curr_tx; i++) {
564 bdp = greth->tx_bd_base + greth->tx_next + i;
565 dma_unmap_single(greth->dev,
566 greth_read_bd(&bdp->addr),
567 greth_read_bd(&bdp->stat) & GRETH_BD_LEN,
569 greth_write_bd(&bdp->stat, 0);
573 dev_warn(greth->dev, "Could not create TX DMA mapping\n");
579 static irqreturn_t greth_interrupt(int irq, void *dev_id)
581 struct net_device *dev = dev_id;
582 struct greth_private *greth;
584 irqreturn_t retval = IRQ_NONE;
586 greth = netdev_priv(dev);
588 spin_lock(&greth->devlock);
590 /* Get the interrupt events that caused us to be here. */
591 status = GRETH_REGLOAD(greth->regs->status);
593 /* Must see if interrupts are enabled also, INT_TX|INT_RX flags may be
594 * set regardless of whether IRQ is enabled or not. Especially
595 * important when shared IRQ.
597 ctrl = GRETH_REGLOAD(greth->regs->control);
599 /* Handle rx and tx interrupts through poll */
600 if (((status & (GRETH_INT_RE | GRETH_INT_RX)) && (ctrl & GRETH_RXI)) ||
601 ((status & (GRETH_INT_TE | GRETH_INT_TX)) && (ctrl & GRETH_TXI))) {
602 retval = IRQ_HANDLED;
604 /* Disable interrupts and schedule poll() */
605 greth_disable_irqs(greth);
606 napi_schedule(&greth->napi);
610 spin_unlock(&greth->devlock);
615 static void greth_clean_tx(struct net_device *dev)
617 struct greth_private *greth;
618 struct greth_bd *bdp;
621 greth = netdev_priv(dev);
624 bdp = greth->tx_bd_base + greth->tx_last;
625 GRETH_REGSAVE(greth->regs->status, GRETH_INT_TE | GRETH_INT_TX);
627 stat = greth_read_bd(&bdp->stat);
629 if (unlikely(stat & GRETH_BD_EN))
632 if (greth->tx_free == GRETH_TXBD_NUM)
635 /* Check status for errors */
636 if (unlikely(stat & GRETH_TXBD_STATUS)) {
637 dev->stats.tx_errors++;
638 if (stat & GRETH_TXBD_ERR_AL)
639 dev->stats.tx_aborted_errors++;
640 if (stat & GRETH_TXBD_ERR_UE)
641 dev->stats.tx_fifo_errors++;
643 dev->stats.tx_packets++;
644 greth->tx_last = NEXT_TX(greth->tx_last);
648 if (greth->tx_free > 0) {
649 netif_wake_queue(dev);
654 static inline void greth_update_tx_stats(struct net_device *dev, u32 stat)
656 /* Check status for errors */
657 if (unlikely(stat & GRETH_TXBD_STATUS)) {
658 dev->stats.tx_errors++;
659 if (stat & GRETH_TXBD_ERR_AL)
660 dev->stats.tx_aborted_errors++;
661 if (stat & GRETH_TXBD_ERR_UE)
662 dev->stats.tx_fifo_errors++;
663 if (stat & GRETH_TXBD_ERR_LC)
664 dev->stats.tx_aborted_errors++;
666 dev->stats.tx_packets++;
669 static void greth_clean_tx_gbit(struct net_device *dev)
671 struct greth_private *greth;
672 struct greth_bd *bdp, *bdp_last_frag;
677 greth = netdev_priv(dev);
679 while (greth->tx_free < GRETH_TXBD_NUM) {
681 skb = greth->tx_skbuff[greth->tx_last];
683 nr_frags = skb_shinfo(skb)->nr_frags;
685 /* We only clean fully completed SKBs */
686 bdp_last_frag = greth->tx_bd_base + SKIP_TX(greth->tx_last, nr_frags);
688 GRETH_REGSAVE(greth->regs->status, GRETH_INT_TE | GRETH_INT_TX);
690 stat = greth_read_bd(&bdp_last_frag->stat);
692 if (stat & GRETH_BD_EN)
695 greth->tx_skbuff[greth->tx_last] = NULL;
697 greth_update_tx_stats(dev, stat);
699 bdp = greth->tx_bd_base + greth->tx_last;
701 greth->tx_last = NEXT_TX(greth->tx_last);
703 dma_unmap_single(greth->dev,
704 greth_read_bd(&bdp->addr),
708 for (i = 0; i < nr_frags; i++) {
709 skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
710 bdp = greth->tx_bd_base + greth->tx_last;
712 dma_unmap_page(greth->dev,
713 greth_read_bd(&bdp->addr),
717 greth->tx_last = NEXT_TX(greth->tx_last);
719 greth->tx_free += nr_frags+1;
723 if (netif_queue_stopped(dev) && (greth->tx_free > (MAX_SKB_FRAGS+1)))
724 netif_wake_queue(dev);
727 static int greth_rx(struct net_device *dev, int limit)
729 struct greth_private *greth;
730 struct greth_bd *bdp;
734 u32 status, dma_addr;
737 greth = netdev_priv(dev);
739 for (count = 0; count < limit; ++count) {
741 bdp = greth->rx_bd_base + greth->rx_cur;
742 GRETH_REGSAVE(greth->regs->status, GRETH_INT_RE | GRETH_INT_RX);
744 status = greth_read_bd(&bdp->stat);
746 if (unlikely(status & GRETH_BD_EN)) {
750 dma_addr = greth_read_bd(&bdp->addr);
753 /* Check status for errors. */
754 if (unlikely(status & GRETH_RXBD_STATUS)) {
755 if (status & GRETH_RXBD_ERR_FT) {
756 dev->stats.rx_length_errors++;
759 if (status & (GRETH_RXBD_ERR_AE | GRETH_RXBD_ERR_OE)) {
760 dev->stats.rx_frame_errors++;
763 if (status & GRETH_RXBD_ERR_CRC) {
764 dev->stats.rx_crc_errors++;
769 dev->stats.rx_errors++;
773 pkt_len = status & GRETH_BD_LEN;
775 skb = netdev_alloc_skb(dev, pkt_len + NET_IP_ALIGN);
777 if (unlikely(skb == NULL)) {
780 dev_warn(&dev->dev, "low on memory - " "packet dropped\n");
782 dev->stats.rx_dropped++;
785 skb_reserve(skb, NET_IP_ALIGN);
788 dma_sync_single_for_cpu(greth->dev,
793 if (netif_msg_pktdata(greth))
794 greth_print_rx_packet(phys_to_virt(dma_addr), pkt_len);
796 memcpy(skb_put(skb, pkt_len), phys_to_virt(dma_addr), pkt_len);
798 skb->protocol = eth_type_trans(skb, dev);
799 dev->stats.rx_packets++;
800 netif_receive_skb(skb);
804 status = GRETH_BD_EN | GRETH_BD_IE;
805 if (greth->rx_cur == GRETH_RXBD_NUM_MASK) {
806 status |= GRETH_BD_WR;
810 greth_write_bd(&bdp->stat, status);
812 dma_sync_single_for_device(greth->dev, dma_addr, MAX_FRAME_SIZE, DMA_FROM_DEVICE);
814 spin_lock_irqsave(&greth->devlock, flags); /* save from XMIT */
815 greth_enable_rx(greth);
816 spin_unlock_irqrestore(&greth->devlock, flags);
818 greth->rx_cur = NEXT_RX(greth->rx_cur);
824 static inline int hw_checksummed(u32 status)
827 if (status & GRETH_RXBD_IP_FRAG)
830 if (status & GRETH_RXBD_IP && status & GRETH_RXBD_IP_CSERR)
833 if (status & GRETH_RXBD_UDP && status & GRETH_RXBD_UDP_CSERR)
836 if (status & GRETH_RXBD_TCP && status & GRETH_RXBD_TCP_CSERR)
842 static int greth_rx_gbit(struct net_device *dev, int limit)
844 struct greth_private *greth;
845 struct greth_bd *bdp;
846 struct sk_buff *skb, *newskb;
849 u32 status, dma_addr;
852 greth = netdev_priv(dev);
854 for (count = 0; count < limit; ++count) {
856 bdp = greth->rx_bd_base + greth->rx_cur;
857 skb = greth->rx_skbuff[greth->rx_cur];
858 GRETH_REGSAVE(greth->regs->status, GRETH_INT_RE | GRETH_INT_RX);
860 status = greth_read_bd(&bdp->stat);
863 if (status & GRETH_BD_EN)
866 /* Check status for errors. */
867 if (unlikely(status & GRETH_RXBD_STATUS)) {
869 if (status & GRETH_RXBD_ERR_FT) {
870 dev->stats.rx_length_errors++;
873 (GRETH_RXBD_ERR_AE | GRETH_RXBD_ERR_OE | GRETH_RXBD_ERR_LE)) {
874 dev->stats.rx_frame_errors++;
876 } else if (status & GRETH_RXBD_ERR_CRC) {
877 dev->stats.rx_crc_errors++;
882 /* Allocate new skb to replace current, not needed if the
883 * current skb can be reused */
884 if (!bad && (newskb=netdev_alloc_skb(dev, MAX_FRAME_SIZE + NET_IP_ALIGN))) {
885 skb_reserve(newskb, NET_IP_ALIGN);
887 dma_addr = dma_map_single(greth->dev,
889 MAX_FRAME_SIZE + NET_IP_ALIGN,
892 if (!dma_mapping_error(greth->dev, dma_addr)) {
893 /* Process the incoming frame. */
894 pkt_len = status & GRETH_BD_LEN;
896 dma_unmap_single(greth->dev,
897 greth_read_bd(&bdp->addr),
898 MAX_FRAME_SIZE + NET_IP_ALIGN,
901 if (netif_msg_pktdata(greth))
902 greth_print_rx_packet(phys_to_virt(greth_read_bd(&bdp->addr)), pkt_len);
904 skb_put(skb, pkt_len);
906 if (dev->features & NETIF_F_RXCSUM && hw_checksummed(status))
907 skb->ip_summed = CHECKSUM_UNNECESSARY;
909 skb_checksum_none_assert(skb);
911 skb->protocol = eth_type_trans(skb, dev);
912 dev->stats.rx_packets++;
913 netif_receive_skb(skb);
915 greth->rx_skbuff[greth->rx_cur] = newskb;
916 greth_write_bd(&bdp->addr, dma_addr);
919 dev_warn(greth->dev, "Could not create DMA mapping, dropping packet\n");
920 dev_kfree_skb(newskb);
921 /* reusing current skb, so it is a drop */
922 dev->stats.rx_dropped++;
925 /* Bad Frame transfer, the skb is reused */
926 dev->stats.rx_dropped++;
928 /* Failed Allocating a new skb. This is rather stupid
929 * but the current "filled" skb is reused, as if
930 * transfer failure. One could argue that RX descriptor
931 * table handling should be divided into cleaning and
932 * filling as the TX part of the driver
935 dev_warn(greth->dev, "Could not allocate SKB, dropping packet\n");
936 /* reusing current skb, so it is a drop */
937 dev->stats.rx_dropped++;
940 status = GRETH_BD_EN | GRETH_BD_IE;
941 if (greth->rx_cur == GRETH_RXBD_NUM_MASK) {
942 status |= GRETH_BD_WR;
946 greth_write_bd(&bdp->stat, status);
947 spin_lock_irqsave(&greth->devlock, flags);
948 greth_enable_rx(greth);
949 spin_unlock_irqrestore(&greth->devlock, flags);
950 greth->rx_cur = NEXT_RX(greth->rx_cur);
957 static int greth_poll(struct napi_struct *napi, int budget)
959 struct greth_private *greth;
963 greth = container_of(napi, struct greth_private, napi);
966 if (netif_queue_stopped(greth->netdev)) {
968 greth_clean_tx_gbit(greth->netdev);
970 greth_clean_tx(greth->netdev);
973 if (greth->gbit_mac) {
974 work_done += greth_rx_gbit(greth->netdev, budget - work_done);
976 work_done += greth_rx(greth->netdev, budget - work_done);
979 if (work_done < budget) {
981 spin_lock_irqsave(&greth->devlock, flags);
983 ctrl = GRETH_REGLOAD(greth->regs->control);
984 if (netif_queue_stopped(greth->netdev)) {
985 GRETH_REGSAVE(greth->regs->control,
986 ctrl | GRETH_TXI | GRETH_RXI);
987 mask = GRETH_INT_RX | GRETH_INT_RE |
988 GRETH_INT_TX | GRETH_INT_TE;
990 GRETH_REGSAVE(greth->regs->control, ctrl | GRETH_RXI);
991 mask = GRETH_INT_RX | GRETH_INT_RE;
994 if (GRETH_REGLOAD(greth->regs->status) & mask) {
995 GRETH_REGSAVE(greth->regs->control, ctrl);
996 spin_unlock_irqrestore(&greth->devlock, flags);
997 goto restart_txrx_poll;
999 __napi_complete(napi);
1000 spin_unlock_irqrestore(&greth->devlock, flags);
1007 static int greth_set_mac_add(struct net_device *dev, void *p)
1009 struct sockaddr *addr = p;
1010 struct greth_private *greth;
1011 struct greth_regs *regs;
1013 greth = netdev_priv(dev);
1014 regs = (struct greth_regs *) greth->regs;
1016 if (!is_valid_ether_addr(addr->sa_data))
1019 memcpy(dev->dev_addr, addr->sa_data, dev->addr_len);
1021 GRETH_REGSAVE(regs->esa_msb, addr->sa_data[0] << 8 | addr->sa_data[1]);
1022 GRETH_REGSAVE(regs->esa_lsb,
1023 addr->sa_data[2] << 24 | addr->
1024 sa_data[3] << 16 | addr->sa_data[4] << 8 | addr->sa_data[5]);
1028 static u32 greth_hash_get_index(__u8 *addr)
1030 return (ether_crc(6, addr)) & 0x3F;
1033 static void greth_set_hash_filter(struct net_device *dev)
1035 struct netdev_hw_addr *ha;
1036 struct greth_private *greth = netdev_priv(dev);
1037 struct greth_regs *regs = (struct greth_regs *) greth->regs;
1041 mc_filter[0] = mc_filter[1] = 0;
1043 netdev_for_each_mc_addr(ha, dev) {
1044 bitnr = greth_hash_get_index(ha->addr);
1045 mc_filter[bitnr >> 5] |= 1 << (bitnr & 31);
1048 GRETH_REGSAVE(regs->hash_msb, mc_filter[1]);
1049 GRETH_REGSAVE(regs->hash_lsb, mc_filter[0]);
1052 static void greth_set_multicast_list(struct net_device *dev)
1055 struct greth_private *greth = netdev_priv(dev);
1056 struct greth_regs *regs = (struct greth_regs *) greth->regs;
1058 cfg = GRETH_REGLOAD(regs->control);
1059 if (dev->flags & IFF_PROMISC)
1060 cfg |= GRETH_CTRL_PR;
1062 cfg &= ~GRETH_CTRL_PR;
1064 if (greth->multicast) {
1065 if (dev->flags & IFF_ALLMULTI) {
1066 GRETH_REGSAVE(regs->hash_msb, -1);
1067 GRETH_REGSAVE(regs->hash_lsb, -1);
1068 cfg |= GRETH_CTRL_MCEN;
1069 GRETH_REGSAVE(regs->control, cfg);
1073 if (netdev_mc_empty(dev)) {
1074 cfg &= ~GRETH_CTRL_MCEN;
1075 GRETH_REGSAVE(regs->control, cfg);
1079 /* Setup multicast filter */
1080 greth_set_hash_filter(dev);
1081 cfg |= GRETH_CTRL_MCEN;
1083 GRETH_REGSAVE(regs->control, cfg);
1086 static u32 greth_get_msglevel(struct net_device *dev)
1088 struct greth_private *greth = netdev_priv(dev);
1089 return greth->msg_enable;
1092 static void greth_set_msglevel(struct net_device *dev, u32 value)
1094 struct greth_private *greth = netdev_priv(dev);
1095 greth->msg_enable = value;
1097 static int greth_get_settings(struct net_device *dev, struct ethtool_cmd *cmd)
1099 struct greth_private *greth = netdev_priv(dev);
1100 struct phy_device *phy = greth->phy;
1105 return phy_ethtool_gset(phy, cmd);
1108 static int greth_set_settings(struct net_device *dev, struct ethtool_cmd *cmd)
1110 struct greth_private *greth = netdev_priv(dev);
1111 struct phy_device *phy = greth->phy;
1116 return phy_ethtool_sset(phy, cmd);
1119 static int greth_get_regs_len(struct net_device *dev)
1121 return sizeof(struct greth_regs);
1124 static void greth_get_drvinfo(struct net_device *dev, struct ethtool_drvinfo *info)
1126 struct greth_private *greth = netdev_priv(dev);
1128 strncpy(info->driver, dev_driver_string(greth->dev), 32);
1129 strncpy(info->version, "revision: 1.0", 32);
1130 strncpy(info->bus_info, greth->dev->bus->name, 32);
1131 strncpy(info->fw_version, "N/A", 32);
1132 info->eedump_len = 0;
1133 info->regdump_len = sizeof(struct greth_regs);
1136 static void greth_get_regs(struct net_device *dev, struct ethtool_regs *regs, void *p)
1139 struct greth_private *greth = netdev_priv(dev);
1140 u32 __iomem *greth_regs = (u32 __iomem *) greth->regs;
1143 for (i = 0; i < sizeof(struct greth_regs) / sizeof(u32); i++)
1144 buff[i] = greth_read_bd(&greth_regs[i]);
1147 static const struct ethtool_ops greth_ethtool_ops = {
1148 .get_msglevel = greth_get_msglevel,
1149 .set_msglevel = greth_set_msglevel,
1150 .get_settings = greth_get_settings,
1151 .set_settings = greth_set_settings,
1152 .get_drvinfo = greth_get_drvinfo,
1153 .get_regs_len = greth_get_regs_len,
1154 .get_regs = greth_get_regs,
1155 .get_link = ethtool_op_get_link,
1158 static struct net_device_ops greth_netdev_ops = {
1159 .ndo_open = greth_open,
1160 .ndo_stop = greth_close,
1161 .ndo_start_xmit = greth_start_xmit,
1162 .ndo_set_mac_address = greth_set_mac_add,
1163 .ndo_validate_addr = eth_validate_addr,
1166 static inline int wait_for_mdio(struct greth_private *greth)
1168 unsigned long timeout = jiffies + 4*HZ/100;
1169 while (GRETH_REGLOAD(greth->regs->mdio) & GRETH_MII_BUSY) {
1170 if (time_after(jiffies, timeout))
1176 static int greth_mdio_read(struct mii_bus *bus, int phy, int reg)
1178 struct greth_private *greth = bus->priv;
1181 if (!wait_for_mdio(greth))
1184 GRETH_REGSAVE(greth->regs->mdio, ((phy & 0x1F) << 11) | ((reg & 0x1F) << 6) | 2);
1186 if (!wait_for_mdio(greth))
1189 if (!(GRETH_REGLOAD(greth->regs->mdio) & GRETH_MII_NVALID)) {
1190 data = (GRETH_REGLOAD(greth->regs->mdio) >> 16) & 0xFFFF;
1198 static int greth_mdio_write(struct mii_bus *bus, int phy, int reg, u16 val)
1200 struct greth_private *greth = bus->priv;
1202 if (!wait_for_mdio(greth))
1205 GRETH_REGSAVE(greth->regs->mdio,
1206 ((val & 0xFFFF) << 16) | ((phy & 0x1F) << 11) | ((reg & 0x1F) << 6) | 1);
1208 if (!wait_for_mdio(greth))
1214 static int greth_mdio_reset(struct mii_bus *bus)
1219 static void greth_link_change(struct net_device *dev)
1221 struct greth_private *greth = netdev_priv(dev);
1222 struct phy_device *phydev = greth->phy;
1223 unsigned long flags;
1224 int status_change = 0;
1227 spin_lock_irqsave(&greth->devlock, flags);
1231 if ((greth->speed != phydev->speed) || (greth->duplex != phydev->duplex)) {
1232 ctrl = GRETH_REGLOAD(greth->regs->control) &
1233 ~(GRETH_CTRL_FD | GRETH_CTRL_SP | GRETH_CTRL_GB);
1236 ctrl |= GRETH_CTRL_FD;
1238 if (phydev->speed == SPEED_100)
1239 ctrl |= GRETH_CTRL_SP;
1240 else if (phydev->speed == SPEED_1000)
1241 ctrl |= GRETH_CTRL_GB;
1243 GRETH_REGSAVE(greth->regs->control, ctrl);
1244 greth->speed = phydev->speed;
1245 greth->duplex = phydev->duplex;
1250 if (phydev->link != greth->link) {
1251 if (!phydev->link) {
1255 greth->link = phydev->link;
1260 spin_unlock_irqrestore(&greth->devlock, flags);
1262 if (status_change) {
1264 pr_debug("%s: link up (%d/%s)\n",
1265 dev->name, phydev->speed,
1266 DUPLEX_FULL == phydev->duplex ? "Full" : "Half");
1268 pr_debug("%s: link down\n", dev->name);
1272 static int greth_mdio_probe(struct net_device *dev)
1274 struct greth_private *greth = netdev_priv(dev);
1275 struct phy_device *phy = NULL;
1278 /* Find the first PHY */
1279 phy = phy_find_first(greth->mdio);
1282 if (netif_msg_probe(greth))
1283 dev_err(&dev->dev, "no PHY found\n");
1287 ret = phy_connect_direct(dev, phy, &greth_link_change,
1288 0, greth->gbit_mac ?
1289 PHY_INTERFACE_MODE_GMII :
1290 PHY_INTERFACE_MODE_MII);
1292 if (netif_msg_ifup(greth))
1293 dev_err(&dev->dev, "could not attach to PHY\n");
1297 if (greth->gbit_mac)
1298 phy->supported &= PHY_GBIT_FEATURES;
1300 phy->supported &= PHY_BASIC_FEATURES;
1302 phy->advertising = phy->supported;
1312 static inline int phy_aneg_done(struct phy_device *phydev)
1316 retval = phy_read(phydev, MII_BMSR);
1318 return (retval < 0) ? retval : (retval & BMSR_ANEGCOMPLETE);
1321 static int greth_mdio_init(struct greth_private *greth)
1324 unsigned long timeout;
1326 greth->mdio = mdiobus_alloc();
1331 greth->mdio->name = "greth-mdio";
1332 snprintf(greth->mdio->id, MII_BUS_ID_SIZE, "%s-%d", greth->mdio->name, greth->irq);
1333 greth->mdio->read = greth_mdio_read;
1334 greth->mdio->write = greth_mdio_write;
1335 greth->mdio->reset = greth_mdio_reset;
1336 greth->mdio->priv = greth;
1338 greth->mdio->irq = greth->mdio_irqs;
1340 for (phy = 0; phy < PHY_MAX_ADDR; phy++)
1341 greth->mdio->irq[phy] = PHY_POLL;
1343 ret = mdiobus_register(greth->mdio);
1348 ret = greth_mdio_probe(greth->netdev);
1350 if (netif_msg_probe(greth))
1351 dev_err(&greth->netdev->dev, "failed to probe MDIO bus\n");
1355 phy_start(greth->phy);
1357 /* If Ethernet debug link is used make autoneg happen right away */
1358 if (greth->edcl && greth_edcl == 1) {
1359 phy_start_aneg(greth->phy);
1360 timeout = jiffies + 6*HZ;
1361 while (!phy_aneg_done(greth->phy) && time_before(jiffies, timeout)) {
1363 genphy_read_status(greth->phy);
1364 greth_link_change(greth->netdev);
1370 mdiobus_unregister(greth->mdio);
1372 mdiobus_free(greth->mdio);
1376 /* Initialize the GRETH MAC */
1377 static int __devinit greth_of_probe(struct platform_device *ofdev)
1379 struct net_device *dev;
1380 struct greth_private *greth;
1381 struct greth_regs *regs;
1386 unsigned long timeout;
1388 dev = alloc_etherdev(sizeof(struct greth_private));
1393 greth = netdev_priv(dev);
1394 greth->netdev = dev;
1395 greth->dev = &ofdev->dev;
1397 if (greth_debug > 0)
1398 greth->msg_enable = greth_debug;
1400 greth->msg_enable = GRETH_DEF_MSG_ENABLE;
1402 spin_lock_init(&greth->devlock);
1404 greth->regs = of_ioremap(&ofdev->resource[0], 0,
1405 resource_size(&ofdev->resource[0]),
1406 "grlib-greth regs");
1408 if (greth->regs == NULL) {
1409 if (netif_msg_probe(greth))
1410 dev_err(greth->dev, "ioremap failure.\n");
1415 regs = (struct greth_regs *) greth->regs;
1416 greth->irq = ofdev->archdata.irqs[0];
1418 dev_set_drvdata(greth->dev, dev);
1419 SET_NETDEV_DEV(dev, greth->dev);
1421 if (netif_msg_probe(greth))
1422 dev_dbg(greth->dev, "reseting controller.\n");
1424 /* Reset the controller. */
1425 GRETH_REGSAVE(regs->control, GRETH_RESET);
1427 /* Wait for MAC to reset itself */
1428 timeout = jiffies + HZ/100;
1429 while (GRETH_REGLOAD(regs->control) & GRETH_RESET) {
1430 if (time_after(jiffies, timeout)) {
1432 if (netif_msg_probe(greth))
1433 dev_err(greth->dev, "timeout when waiting for reset.\n");
1438 /* Get default PHY address */
1439 greth->phyaddr = (GRETH_REGLOAD(regs->mdio) >> 11) & 0x1F;
1441 /* Check if we have GBIT capable MAC */
1442 tmp = GRETH_REGLOAD(regs->control);
1443 greth->gbit_mac = (tmp >> 27) & 1;
1445 /* Check for multicast capability */
1446 greth->multicast = (tmp >> 25) & 1;
1448 greth->edcl = (tmp >> 31) & 1;
1450 /* If we have EDCL we disable the EDCL speed-duplex FSM so
1451 * it doesn't interfere with the software */
1452 if (greth->edcl != 0)
1453 GRETH_REGORIN(regs->control, GRETH_CTRL_DISDUPLEX);
1455 /* Check if MAC can handle MDIO interrupts */
1456 greth->mdio_int_en = (tmp >> 26) & 1;
1458 err = greth_mdio_init(greth);
1460 if (netif_msg_probe(greth))
1461 dev_err(greth->dev, "failed to register MDIO bus\n");
1465 /* Allocate TX descriptor ring in coherent memory */
1466 greth->tx_bd_base = (struct greth_bd *) dma_alloc_coherent(greth->dev,
1468 &greth->tx_bd_base_phys,
1471 if (!greth->tx_bd_base) {
1472 if (netif_msg_probe(greth))
1473 dev_err(&dev->dev, "could not allocate descriptor memory.\n");
1478 memset(greth->tx_bd_base, 0, 1024);
1480 /* Allocate RX descriptor ring in coherent memory */
1481 greth->rx_bd_base = (struct greth_bd *) dma_alloc_coherent(greth->dev,
1483 &greth->rx_bd_base_phys,
1486 if (!greth->rx_bd_base) {
1487 if (netif_msg_probe(greth))
1488 dev_err(greth->dev, "could not allocate descriptor memory.\n");
1493 memset(greth->rx_bd_base, 0, 1024);
1495 /* Get MAC address from: module param, OF property or ID prom */
1496 for (i = 0; i < 6; i++) {
1497 if (macaddr[i] != 0)
1501 const unsigned char *addr;
1503 addr = of_get_property(ofdev->dev.of_node, "local-mac-address",
1505 if (addr != NULL && len == 6) {
1506 for (i = 0; i < 6; i++)
1507 macaddr[i] = (unsigned int) addr[i];
1510 for (i = 0; i < 6; i++)
1511 macaddr[i] = (unsigned int) idprom->id_ethaddr[i];
1516 for (i = 0; i < 6; i++)
1517 dev->dev_addr[i] = macaddr[i];
1521 if (!is_valid_ether_addr(&dev->dev_addr[0])) {
1522 if (netif_msg_probe(greth))
1523 dev_err(greth->dev, "no valid ethernet address, aborting.\n");
1528 GRETH_REGSAVE(regs->esa_msb, dev->dev_addr[0] << 8 | dev->dev_addr[1]);
1529 GRETH_REGSAVE(regs->esa_lsb, dev->dev_addr[2] << 24 | dev->dev_addr[3] << 16 |
1530 dev->dev_addr[4] << 8 | dev->dev_addr[5]);
1532 /* Clear all pending interrupts except PHY irq */
1533 GRETH_REGSAVE(regs->status, 0xFF);
1535 if (greth->gbit_mac) {
1536 dev->hw_features = NETIF_F_SG | NETIF_F_IP_CSUM |
1538 dev->features = dev->hw_features | NETIF_F_HIGHDMA;
1539 greth_netdev_ops.ndo_start_xmit = greth_start_xmit_gbit;
1542 if (greth->multicast) {
1543 greth_netdev_ops.ndo_set_multicast_list = greth_set_multicast_list;
1544 dev->flags |= IFF_MULTICAST;
1546 dev->flags &= ~IFF_MULTICAST;
1549 dev->netdev_ops = &greth_netdev_ops;
1550 dev->ethtool_ops = &greth_ethtool_ops;
1552 err = register_netdev(dev);
1554 if (netif_msg_probe(greth))
1555 dev_err(greth->dev, "netdevice registration failed.\n");
1560 netif_napi_add(dev, &greth->napi, greth_poll, 64);
1565 dma_free_coherent(greth->dev, 1024, greth->rx_bd_base, greth->rx_bd_base_phys);
1567 dma_free_coherent(greth->dev, 1024, greth->tx_bd_base, greth->tx_bd_base_phys);
1569 mdiobus_unregister(greth->mdio);
1571 of_iounmap(&ofdev->resource[0], greth->regs, resource_size(&ofdev->resource[0]));
1577 static int __devexit greth_of_remove(struct platform_device *of_dev)
1579 struct net_device *ndev = dev_get_drvdata(&of_dev->dev);
1580 struct greth_private *greth = netdev_priv(ndev);
1582 /* Free descriptor areas */
1583 dma_free_coherent(&of_dev->dev, 1024, greth->rx_bd_base, greth->rx_bd_base_phys);
1585 dma_free_coherent(&of_dev->dev, 1024, greth->tx_bd_base, greth->tx_bd_base_phys);
1587 dev_set_drvdata(&of_dev->dev, NULL);
1590 phy_stop(greth->phy);
1591 mdiobus_unregister(greth->mdio);
1593 unregister_netdev(ndev);
1596 of_iounmap(&of_dev->resource[0], greth->regs, resource_size(&of_dev->resource[0]));
1601 static struct of_device_id greth_of_match[] = {
1603 .name = "GAISLER_ETHMAC",
1611 MODULE_DEVICE_TABLE(of, greth_of_match);
1613 static struct platform_driver greth_of_driver = {
1615 .name = "grlib-greth",
1616 .owner = THIS_MODULE,
1617 .of_match_table = greth_of_match,
1619 .probe = greth_of_probe,
1620 .remove = __devexit_p(greth_of_remove),
1623 static int __init greth_init(void)
1625 return platform_driver_register(&greth_of_driver);
1628 static void __exit greth_cleanup(void)
1630 platform_driver_unregister(&greth_of_driver);
1633 module_init(greth_init);
1634 module_exit(greth_cleanup);
1636 MODULE_AUTHOR("Aeroflex Gaisler AB.");
1637 MODULE_DESCRIPTION("Aeroflex Gaisler Ethernet MAC driver");
1638 MODULE_LICENSE("GPL");