1 /****************************************************************************
2 * Driver for Solarflare Solarstorm network controllers and boards
3 * Copyright 2005-2006 Fen Systems Ltd.
4 * Copyright 2006-2008 Solarflare Communications Inc.
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License version 2 as published
8 * by the Free Software Foundation, incorporated herein by reference.
11 #include <linux/netdevice.h>
12 #include <linux/module.h>
13 #include <linux/delay.h>
14 #include <linux/kernel_stat.h>
15 #include <linux/pci.h>
16 #include <linux/ethtool.h>
19 #include <linux/udp.h>
20 #include <linux/rtnetlink.h>
22 #include "net_driver.h"
28 #include "workarounds.h"
32 * Loopback test packet structure
34 * The self-test should stress every RSS vector, and unfortunately
35 * Falcon only performs RSS on TCP/UDP packets.
37 struct efx_loopback_payload
{
43 } __attribute__ ((packed
));
45 /* Loopback test source MAC address */
46 static const unsigned char payload_source
[ETH_ALEN
] = {
47 0x00, 0x0f, 0x53, 0x1b, 0x1b, 0x1b,
50 static const char *payload_msg
=
51 "Hello world! This is an Efx loopback test in progress!";
54 * efx_selftest_state - persistent state during a selftest
55 * @flush: Drop all packets in efx_loopback_rx_packet
56 * @packet_count: Number of packets being used in this test
57 * @skbs: An array of skbs transmitted
58 * @rx_good: RX good packet count
59 * @rx_bad: RX bad packet count
60 * @payload: Payload used in tests
62 struct efx_selftest_state
{
65 struct sk_buff
**skbs
;
67 /* Checksums are being offloaded */
72 struct efx_loopback_payload payload
;
75 /**************************************************************************
79 **************************************************************************/
81 /* Level of loopback testing
83 * The maximum packet burst length is 16**(n-1), i.e.
85 * - Level 0 : no packets
86 * - Level 1 : 1 packet
87 * - Level 2 : 17 packets (1 * 1 packet, 1 * 16 packets)
88 * - Level 3 : 273 packets (1 * 1 packet, 1 * 16 packet, 1 * 256 packets)
91 static unsigned int loopback_test_level
= 3;
93 /**************************************************************************
95 * Interrupt and event queue testing
97 **************************************************************************/
99 /* Test generation and receipt of interrupts */
100 static int efx_test_interrupts(struct efx_nic
*efx
,
101 struct efx_self_tests
*tests
)
103 struct efx_channel
*channel
;
105 EFX_LOG(efx
, "testing interrupts\n");
106 tests
->interrupt
= -1;
108 /* Reset interrupt flag */
109 efx
->last_irq_cpu
= -1;
112 /* ACK each interrupting event queue. Receiving an interrupt due to
113 * traffic before a test event is raised is considered a pass */
114 efx_for_each_channel_with_interrupt(channel
, efx
) {
115 if (channel
->work_pending
)
116 efx_process_channel_now(channel
);
117 if (efx
->last_irq_cpu
>= 0)
121 falcon_generate_interrupt(efx
);
123 /* Wait for arrival of test interrupt. */
124 EFX_LOG(efx
, "waiting for test interrupt\n");
125 schedule_timeout_uninterruptible(HZ
/ 10);
126 if (efx
->last_irq_cpu
>= 0)
129 EFX_ERR(efx
, "timed out waiting for interrupt\n");
133 EFX_LOG(efx
, "test interrupt (mode %d) seen on CPU%d\n",
134 efx
->interrupt_mode
, efx
->last_irq_cpu
);
135 tests
->interrupt
= 1;
139 /* Test generation and receipt of non-interrupting events */
140 static int efx_test_eventq(struct efx_channel
*channel
,
141 struct efx_self_tests
*tests
)
145 /* Channel specific code, limited to 20 bits */
146 magic
= (0x00010150 + channel
->channel
);
147 EFX_LOG(channel
->efx
, "channel %d testing event queue with code %x\n",
148 channel
->channel
, magic
);
150 tests
->eventq_dma
[channel
->channel
] = -1;
151 tests
->eventq_int
[channel
->channel
] = 1; /* fake pass */
152 tests
->eventq_poll
[channel
->channel
] = 1; /* fake pass */
154 /* Reset flag and zero magic word */
155 channel
->efx
->last_irq_cpu
= -1;
156 channel
->eventq_magic
= 0;
159 falcon_generate_test_event(channel
, magic
);
162 efx_process_channel_now(channel
);
163 if (channel
->eventq_magic
!= magic
) {
164 EFX_ERR(channel
->efx
, "channel %d failed to see test event\n",
168 tests
->eventq_dma
[channel
->channel
] = 1;
174 /* Test generation and receipt of interrupting events */
175 static int efx_test_eventq_irq(struct efx_channel
*channel
,
176 struct efx_self_tests
*tests
)
178 unsigned int magic
, count
;
180 /* Channel specific code, limited to 20 bits */
181 magic
= (0x00010150 + channel
->channel
);
182 EFX_LOG(channel
->efx
, "channel %d testing event queue with code %x\n",
183 channel
->channel
, magic
);
185 tests
->eventq_dma
[channel
->channel
] = -1;
186 tests
->eventq_int
[channel
->channel
] = -1;
187 tests
->eventq_poll
[channel
->channel
] = -1;
189 /* Reset flag and zero magic word */
190 channel
->efx
->last_irq_cpu
= -1;
191 channel
->eventq_magic
= 0;
194 falcon_generate_test_event(channel
, magic
);
196 /* Wait for arrival of interrupt */
199 schedule_timeout_uninterruptible(HZ
/ 100);
201 if (channel
->work_pending
)
202 efx_process_channel_now(channel
);
204 if (channel
->eventq_magic
== magic
)
206 } while (++count
< 2);
208 EFX_ERR(channel
->efx
, "channel %d timed out waiting for event queue\n",
211 /* See if interrupt arrived */
212 if (channel
->efx
->last_irq_cpu
>= 0) {
213 EFX_ERR(channel
->efx
, "channel %d saw interrupt on CPU%d "
214 "during event queue test\n", channel
->channel
,
215 raw_smp_processor_id());
216 tests
->eventq_int
[channel
->channel
] = 1;
219 /* Check to see if event was received even if interrupt wasn't */
220 efx_process_channel_now(channel
);
221 if (channel
->eventq_magic
== magic
) {
222 EFX_ERR(channel
->efx
, "channel %d event was generated, but "
223 "failed to trigger an interrupt\n", channel
->channel
);
224 tests
->eventq_dma
[channel
->channel
] = 1;
229 EFX_LOG(channel
->efx
, "channel %d event queue passed\n",
231 tests
->eventq_dma
[channel
->channel
] = 1;
232 tests
->eventq_int
[channel
->channel
] = 1;
233 tests
->eventq_poll
[channel
->channel
] = 1;
237 /**************************************************************************
241 **************************************************************************/
243 /* Check PHY presence by reading the PHY ID registers */
244 static int efx_test_phy(struct efx_nic
*efx
,
245 struct efx_self_tests
*tests
)
247 u16 physid1
, physid2
;
248 struct mii_if_info
*mii
= &efx
->mii
;
249 struct net_device
*net_dev
= efx
->net_dev
;
251 if (efx
->phy_type
== PHY_TYPE_NONE
)
254 EFX_LOG(efx
, "testing PHY presence\n");
257 physid1
= mii
->mdio_read(net_dev
, mii
->phy_id
, MII_PHYSID1
);
258 physid2
= mii
->mdio_read(net_dev
, mii
->phy_id
, MII_PHYSID2
);
260 if ((physid1
!= 0x0000) && (physid1
!= 0xffff) &&
261 (physid2
!= 0x0000) && (physid2
!= 0xffff)) {
262 EFX_LOG(efx
, "found MII PHY %d ID 0x%x:%x\n",
263 mii
->phy_id
, physid1
, physid2
);
268 EFX_ERR(efx
, "no MII PHY present with ID %d\n", mii
->phy_id
);
272 /**************************************************************************
275 * NB Only one loopback test can be executing concurrently.
277 **************************************************************************/
279 /* Loopback test RX callback
280 * This is called for each received packet during loopback testing.
282 void efx_loopback_rx_packet(struct efx_nic
*efx
,
283 const char *buf_ptr
, int pkt_len
)
285 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
286 struct efx_loopback_payload
*received
;
287 struct efx_loopback_payload
*payload
;
291 /* If we are just flushing, then drop the packet */
292 if ((state
== NULL
) || state
->flush
)
295 payload
= &state
->payload
;
297 received
= (struct efx_loopback_payload
*) buf_ptr
;
298 received
->ip
.saddr
= payload
->ip
.saddr
;
299 if (state
->offload_csum
)
300 received
->ip
.check
= payload
->ip
.check
;
302 /* Check that header exists */
303 if (pkt_len
< sizeof(received
->header
)) {
304 EFX_ERR(efx
, "saw runt RX packet (length %d) in %s loopback "
305 "test\n", pkt_len
, LOOPBACK_MODE(efx
));
309 /* Check that the ethernet header exists */
310 if (memcmp(&received
->header
, &payload
->header
, ETH_HLEN
) != 0) {
311 EFX_ERR(efx
, "saw non-loopback RX packet in %s loopback test\n",
316 /* Check packet length */
317 if (pkt_len
!= sizeof(*payload
)) {
318 EFX_ERR(efx
, "saw incorrect RX packet length %d (wanted %d) in "
319 "%s loopback test\n", pkt_len
, (int)sizeof(*payload
),
324 /* Check that IP header matches */
325 if (memcmp(&received
->ip
, &payload
->ip
, sizeof(payload
->ip
)) != 0) {
326 EFX_ERR(efx
, "saw corrupted IP header in %s loopback test\n",
331 /* Check that msg and padding matches */
332 if (memcmp(&received
->msg
, &payload
->msg
, sizeof(received
->msg
)) != 0) {
333 EFX_ERR(efx
, "saw corrupted RX packet in %s loopback test\n",
338 /* Check that iteration matches */
339 if (received
->iteration
!= payload
->iteration
) {
340 EFX_ERR(efx
, "saw RX packet from iteration %d (wanted %d) in "
341 "%s loopback test\n", ntohs(received
->iteration
),
342 ntohs(payload
->iteration
), LOOPBACK_MODE(efx
));
346 /* Increase correct RX count */
347 EFX_TRACE(efx
, "got loopback RX in %s loopback test\n",
350 atomic_inc(&state
->rx_good
);
354 #ifdef EFX_ENABLE_DEBUG
355 if (atomic_read(&state
->rx_bad
) == 0) {
356 EFX_ERR(efx
, "received packet:\n");
357 print_hex_dump(KERN_ERR
, "", DUMP_PREFIX_OFFSET
, 0x10, 1,
358 buf_ptr
, pkt_len
, 0);
359 EFX_ERR(efx
, "expected packet:\n");
360 print_hex_dump(KERN_ERR
, "", DUMP_PREFIX_OFFSET
, 0x10, 1,
361 &state
->payload
, sizeof(state
->payload
), 0);
364 atomic_inc(&state
->rx_bad
);
367 /* Initialise an efx_selftest_state for a new iteration */
368 static void efx_iterate_state(struct efx_nic
*efx
)
370 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
371 struct net_device
*net_dev
= efx
->net_dev
;
372 struct efx_loopback_payload
*payload
= &state
->payload
;
374 /* Initialise the layerII header */
375 memcpy(&payload
->header
.h_dest
, net_dev
->dev_addr
, ETH_ALEN
);
376 memcpy(&payload
->header
.h_source
, &payload_source
, ETH_ALEN
);
377 payload
->header
.h_proto
= htons(ETH_P_IP
);
379 /* saddr set later and used as incrementing count */
380 payload
->ip
.daddr
= htonl(INADDR_LOOPBACK
);
382 payload
->ip
.check
= htons(0xdead);
383 payload
->ip
.tot_len
= htons(sizeof(*payload
) - sizeof(struct ethhdr
));
384 payload
->ip
.version
= IPVERSION
;
385 payload
->ip
.protocol
= IPPROTO_UDP
;
387 /* Initialise udp header */
388 payload
->udp
.source
= 0;
389 payload
->udp
.len
= htons(sizeof(*payload
) - sizeof(struct ethhdr
) -
390 sizeof(struct iphdr
));
391 payload
->udp
.check
= 0; /* checksum ignored */
393 /* Fill out payload */
394 payload
->iteration
= htons(ntohs(payload
->iteration
) + 1);
395 memcpy(&payload
->msg
, payload_msg
, sizeof(payload_msg
));
397 /* Fill out remaining state members */
398 atomic_set(&state
->rx_good
, 0);
399 atomic_set(&state
->rx_bad
, 0);
403 static int efx_begin_loopback(struct efx_tx_queue
*tx_queue
)
405 struct efx_nic
*efx
= tx_queue
->efx
;
406 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
407 struct efx_loopback_payload
*payload
;
411 /* Transmit N copies of buffer */
412 for (i
= 0; i
< state
->packet_count
; i
++) {
413 /* Allocate an skb, holding an extra reference for
414 * transmit completion counting */
415 skb
= alloc_skb(sizeof(state
->payload
), GFP_KERNEL
);
418 state
->skbs
[i
] = skb
;
421 /* Copy the payload in, incrementing the source address to
422 * exercise the rss vectors */
423 payload
= ((struct efx_loopback_payload
*)
424 skb_put(skb
, sizeof(state
->payload
)));
425 memcpy(payload
, &state
->payload
, sizeof(state
->payload
));
426 payload
->ip
.saddr
= htonl(INADDR_LOOPBACK
| (i
<< 2));
428 /* Ensure everything we've written is visible to the
429 * interrupt handler. */
432 if (efx_dev_registered(efx
))
433 netif_tx_lock_bh(efx
->net_dev
);
434 rc
= efx_xmit(efx
, tx_queue
, skb
);
435 if (efx_dev_registered(efx
))
436 netif_tx_unlock_bh(efx
->net_dev
);
438 if (rc
!= NETDEV_TX_OK
) {
439 EFX_ERR(efx
, "TX queue %d could not transmit packet %d "
440 "of %d in %s loopback test\n", tx_queue
->queue
,
441 i
+ 1, state
->packet_count
, LOOPBACK_MODE(efx
));
443 /* Defer cleaning up the other skbs for the caller */
452 static int efx_poll_loopback(struct efx_nic
*efx
)
454 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
455 struct efx_channel
*channel
;
457 /* NAPI polling is not enabled, so process channels
459 efx_for_each_channel_with_interrupt(channel
, efx
) {
460 if (channel
->work_pending
)
461 efx_process_channel_now(channel
);
463 return atomic_read(&state
->rx_good
) == state
->packet_count
;
466 static int efx_end_loopback(struct efx_tx_queue
*tx_queue
,
467 struct efx_loopback_self_tests
*lb_tests
)
469 struct efx_nic
*efx
= tx_queue
->efx
;
470 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
472 int tx_done
= 0, rx_good
, rx_bad
;
475 if (efx_dev_registered(efx
))
476 netif_tx_lock_bh(efx
->net_dev
);
478 /* Count the number of tx completions, and decrement the refcnt. Any
479 * skbs not already completed will be free'd when the queue is flushed */
480 for (i
=0; i
< state
->packet_count
; i
++) {
481 skb
= state
->skbs
[i
];
482 if (skb
&& !skb_shared(skb
))
484 dev_kfree_skb_any(skb
);
487 if (efx_dev_registered(efx
))
488 netif_tx_unlock_bh(efx
->net_dev
);
490 /* Check TX completion and received packet counts */
491 rx_good
= atomic_read(&state
->rx_good
);
492 rx_bad
= atomic_read(&state
->rx_bad
);
493 if (tx_done
!= state
->packet_count
) {
494 /* Don't free the skbs; they will be picked up on TX
495 * overflow or channel teardown.
497 EFX_ERR(efx
, "TX queue %d saw only %d out of an expected %d "
498 "TX completion events in %s loopback test\n",
499 tx_queue
->queue
, tx_done
, state
->packet_count
,
502 /* Allow to fall through so we see the RX errors as well */
505 /* We may always be up to a flush away from our desired packet total */
506 if (rx_good
!= state
->packet_count
) {
507 EFX_LOG(efx
, "TX queue %d saw only %d out of an expected %d "
508 "received packets in %s loopback test\n",
509 tx_queue
->queue
, rx_good
, state
->packet_count
,
515 /* Update loopback test structure */
516 lb_tests
->tx_sent
[tx_queue
->queue
] += state
->packet_count
;
517 lb_tests
->tx_done
[tx_queue
->queue
] += tx_done
;
518 lb_tests
->rx_good
+= rx_good
;
519 lb_tests
->rx_bad
+= rx_bad
;
525 efx_test_loopback(struct efx_tx_queue
*tx_queue
,
526 struct efx_loopback_self_tests
*lb_tests
)
528 struct efx_nic
*efx
= tx_queue
->efx
;
529 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
530 int i
, begin_rc
, end_rc
;
532 for (i
= 0; i
< loopback_test_level
; i
++) {
533 /* Determine how many packets to send */
534 state
->packet_count
= (efx
->type
->txd_ring_mask
+ 1) / 3;
535 state
->packet_count
= min(1 << (i
<< 2), state
->packet_count
);
536 state
->skbs
= kzalloc(sizeof(state
->skbs
[0]) *
537 state
->packet_count
, GFP_KERNEL
);
542 EFX_LOG(efx
, "TX queue %d testing %s loopback with %d "
543 "packets\n", tx_queue
->queue
, LOOPBACK_MODE(efx
),
544 state
->packet_count
);
546 efx_iterate_state(efx
);
547 begin_rc
= efx_begin_loopback(tx_queue
);
549 /* This will normally complete very quickly, but be
550 * prepared to wait up to 100 ms. */
552 if (!efx_poll_loopback(efx
)) {
554 efx_poll_loopback(efx
);
557 end_rc
= efx_end_loopback(tx_queue
, lb_tests
);
560 if (begin_rc
|| end_rc
) {
561 /* Wait a while to ensure there are no packets
562 * floating around after a failure. */
563 schedule_timeout_uninterruptible(HZ
/ 10);
564 return begin_rc
? begin_rc
: end_rc
;
568 EFX_LOG(efx
, "TX queue %d passed %s loopback test with a burst length "
569 "of %d packets\n", tx_queue
->queue
, LOOPBACK_MODE(efx
),
570 state
->packet_count
);
575 static int efx_test_loopbacks(struct efx_nic
*efx
,
576 struct efx_self_tests
*tests
,
577 unsigned int loopback_modes
)
579 struct efx_selftest_state
*state
= efx
->loopback_selftest
;
580 struct ethtool_cmd ecmd
, ecmd_loopback
;
581 struct efx_tx_queue
*tx_queue
;
582 enum efx_loopback_mode old_mode
, mode
;
583 int count
, rc
, link_up
;
585 rc
= efx_ethtool_get_settings(efx
->net_dev
, &ecmd
);
587 EFX_ERR(efx
, "could not get GMII settings\n");
590 old_mode
= efx
->loopback_mode
;
592 /* Disable autonegotiation for the purposes of loopback */
593 memcpy(&ecmd_loopback
, &ecmd
, sizeof(ecmd_loopback
));
594 if (ecmd_loopback
.autoneg
== AUTONEG_ENABLE
) {
595 ecmd_loopback
.autoneg
= AUTONEG_DISABLE
;
596 ecmd_loopback
.duplex
= DUPLEX_FULL
;
597 ecmd_loopback
.speed
= SPEED_10000
;
600 rc
= efx_ethtool_set_settings(efx
->net_dev
, &ecmd_loopback
);
602 EFX_ERR(efx
, "could not disable autonegotiation\n");
605 tests
->loopback_speed
= ecmd_loopback
.speed
;
606 tests
->loopback_full_duplex
= ecmd_loopback
.duplex
;
608 /* Test all supported loopback modes */
609 for (mode
= LOOPBACK_NONE
; mode
< LOOPBACK_TEST_MAX
; mode
++) {
610 if (!(loopback_modes
& (1 << mode
)))
613 /* Move the port into the specified loopback mode. */
615 efx
->loopback_mode
= mode
;
616 efx_reconfigure_port(efx
);
618 /* Wait for the PHY to signal the link is up */
621 struct efx_channel
*channel
= &efx
->channel
[0];
623 falcon_check_xmac(efx
);
624 schedule_timeout_uninterruptible(HZ
/ 10);
625 if (channel
->work_pending
)
626 efx_process_channel_now(channel
);
627 /* Wait for PHY events to be processed */
628 flush_workqueue(efx
->workqueue
);
631 /* efx->link_up can be 1 even if the XAUI link is down,
632 * (bug5762). Usually, it's not worth bothering with the
633 * difference, but for selftests, we need that extra
634 * guarantee that the link is really, really, up.
636 link_up
= efx
->link_up
;
637 if (!falcon_xaui_link_ok(efx
))
640 } while ((++count
< 20) && !link_up
);
642 /* The link should now be up. If it isn't, there is no point
643 * in attempting a loopback test */
645 EFX_ERR(efx
, "loopback %s never came up\n",
651 EFX_LOG(efx
, "link came up in %s loopback in %d iterations\n",
652 LOOPBACK_MODE(efx
), count
);
654 /* Test every TX queue */
655 efx_for_each_tx_queue(tx_queue
, efx
) {
656 state
->offload_csum
= (tx_queue
->queue
==
657 EFX_TX_QUEUE_OFFLOAD_CSUM
);
658 rc
= efx_test_loopback(tx_queue
,
659 &tests
->loopback
[mode
]);
666 /* Take out of loopback and restore PHY settings */
668 efx
->loopback_mode
= old_mode
;
669 efx_ethtool_set_settings(efx
->net_dev
, &ecmd
);
674 /**************************************************************************
678 *************************************************************************/
680 /* Online (i.e. non-disruptive) testing
681 * This checks interrupt generation, event delivery and PHY presence. */
682 int efx_online_test(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
684 struct efx_channel
*channel
;
687 rc
= efx_test_interrupts(efx
, tests
);
690 efx_for_each_channel(channel
, efx
) {
691 if (channel
->has_interrupt
)
692 rc
= efx_test_eventq_irq(channel
, tests
);
694 rc
= efx_test_eventq(channel
, tests
);
698 rc
= efx_test_phy(efx
, tests
);
702 /* Offline (i.e. disruptive) testing
703 * This checks MAC and PHY loopback on the specified port. */
704 int efx_offline_test(struct efx_nic
*efx
,
705 struct efx_self_tests
*tests
, unsigned int loopback_modes
)
707 struct efx_selftest_state
*state
;
710 /* Create a selftest_state structure to hold state for the test */
711 state
= kzalloc(sizeof(*state
), GFP_KERNEL
);
715 /* Set the port loopback_selftest member. From this point on
716 * all received packets will be dropped. Mark the state as
717 * "flushing" so all inflight packets are dropped */
718 BUG_ON(efx
->loopback_selftest
);
720 efx
->loopback_selftest
= state
;
722 rc
= efx_test_loopbacks(efx
, tests
, loopback_modes
);
724 efx
->loopback_selftest
= NULL
;