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"
30 #include "falcon_io.h"
34 * Loopback test packet structure
36 * The self-test should stress every RSS vector, and unfortunately
37 * Falcon only performs RSS on TCP/UDP packets.
39 struct efx_loopback_payload
{
45 } __attribute__ ((packed
));
47 /* Loopback test source MAC address */
48 static const unsigned char payload_source
[ETH_ALEN
] = {
49 0x00, 0x0f, 0x53, 0x1b, 0x1b, 0x1b,
52 static const char *payload_msg
=
53 "Hello world! This is an Efx loopback test in progress!";
56 * efx_loopback_state - persistent state during a loopback selftest
57 * @flush: Drop all packets in efx_loopback_rx_packet
58 * @packet_count: Number of packets being used in this test
59 * @skbs: An array of skbs transmitted
60 * @rx_good: RX good packet count
61 * @rx_bad: RX bad packet count
62 * @payload: Payload used in tests
64 struct efx_loopback_state
{
67 struct sk_buff
**skbs
;
69 /* Checksums are being offloaded */
74 struct efx_loopback_payload payload
;
77 /**************************************************************************
79 * MII, NVRAM and register tests
81 **************************************************************************/
83 static int efx_test_mdio(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
86 int devad
= __ffs(efx
->mdio
.mmds
);
89 if (efx
->phy_type
== PHY_TYPE_NONE
)
92 mutex_lock(&efx
->mac_lock
);
95 physid1
= efx_mdio_read(efx
, devad
, MDIO_DEVID1
);
96 physid2
= efx_mdio_read(efx
, devad
, MDIO_DEVID2
);
98 if ((physid1
== 0x0000) || (physid1
== 0xffff) ||
99 (physid2
== 0x0000) || (physid2
== 0xffff)) {
100 EFX_ERR(efx
, "no MDIO PHY present with ID %d\n",
106 if (EFX_IS10G(efx
)) {
107 rc
= efx_mdio_check_mmds(efx
, efx
->phy_op
->mmds
, 0);
113 mutex_unlock(&efx
->mac_lock
);
114 tests
->mdio
= rc
? -1 : 1;
118 static int efx_test_nvram(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
122 rc
= falcon_read_nvram(efx
, NULL
);
123 tests
->nvram
= rc
? -1 : 1;
127 static int efx_test_chip(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
131 /* Not supported on A-series silicon */
132 if (falcon_rev(efx
) < FALCON_REV_B0
)
135 rc
= falcon_test_registers(efx
);
136 tests
->registers
= rc
? -1 : 1;
140 /**************************************************************************
142 * Interrupt and event queue testing
144 **************************************************************************/
146 /* Test generation and receipt of interrupts */
147 static int efx_test_interrupts(struct efx_nic
*efx
,
148 struct efx_self_tests
*tests
)
150 struct efx_channel
*channel
;
152 EFX_LOG(efx
, "testing interrupts\n");
153 tests
->interrupt
= -1;
155 /* Reset interrupt flag */
156 efx
->last_irq_cpu
= -1;
159 /* ACK each interrupting event queue. Receiving an interrupt due to
160 * traffic before a test event is raised is considered a pass */
161 efx_for_each_channel(channel
, efx
) {
162 if (channel
->work_pending
)
163 efx_process_channel_now(channel
);
164 if (efx
->last_irq_cpu
>= 0)
168 falcon_generate_interrupt(efx
);
170 /* Wait for arrival of test interrupt. */
171 EFX_LOG(efx
, "waiting for test interrupt\n");
172 schedule_timeout_uninterruptible(HZ
/ 10);
173 if (efx
->last_irq_cpu
>= 0)
176 EFX_ERR(efx
, "timed out waiting for interrupt\n");
180 EFX_LOG(efx
, "test interrupt (mode %d) seen on CPU%d\n",
181 efx
->interrupt_mode
, efx
->last_irq_cpu
);
182 tests
->interrupt
= 1;
186 /* Test generation and receipt of interrupting events */
187 static int efx_test_eventq_irq(struct efx_channel
*channel
,
188 struct efx_self_tests
*tests
)
190 unsigned int magic
, count
;
192 /* Channel specific code, limited to 20 bits */
193 magic
= (0x00010150 + channel
->channel
);
194 EFX_LOG(channel
->efx
, "channel %d testing event queue with code %x\n",
195 channel
->channel
, magic
);
197 tests
->eventq_dma
[channel
->channel
] = -1;
198 tests
->eventq_int
[channel
->channel
] = -1;
199 tests
->eventq_poll
[channel
->channel
] = -1;
201 /* Reset flag and zero magic word */
202 channel
->efx
->last_irq_cpu
= -1;
203 channel
->eventq_magic
= 0;
206 falcon_generate_test_event(channel
, magic
);
208 /* Wait for arrival of interrupt */
211 schedule_timeout_uninterruptible(HZ
/ 100);
213 if (channel
->work_pending
)
214 efx_process_channel_now(channel
);
216 if (channel
->eventq_magic
== magic
)
218 } while (++count
< 2);
220 EFX_ERR(channel
->efx
, "channel %d timed out waiting for event queue\n",
223 /* See if interrupt arrived */
224 if (channel
->efx
->last_irq_cpu
>= 0) {
225 EFX_ERR(channel
->efx
, "channel %d saw interrupt on CPU%d "
226 "during event queue test\n", channel
->channel
,
227 raw_smp_processor_id());
228 tests
->eventq_int
[channel
->channel
] = 1;
231 /* Check to see if event was received even if interrupt wasn't */
232 efx_process_channel_now(channel
);
233 if (channel
->eventq_magic
== magic
) {
234 EFX_ERR(channel
->efx
, "channel %d event was generated, but "
235 "failed to trigger an interrupt\n", channel
->channel
);
236 tests
->eventq_dma
[channel
->channel
] = 1;
241 EFX_LOG(channel
->efx
, "channel %d event queue passed\n",
243 tests
->eventq_dma
[channel
->channel
] = 1;
244 tests
->eventq_int
[channel
->channel
] = 1;
245 tests
->eventq_poll
[channel
->channel
] = 1;
249 static int efx_test_phy(struct efx_nic
*efx
, struct efx_self_tests
*tests
,
254 if (!efx
->phy_op
->run_tests
)
257 EFX_BUG_ON_PARANOID(efx
->phy_op
->num_tests
== 0 ||
258 efx
->phy_op
->num_tests
> EFX_MAX_PHY_TESTS
);
260 mutex_lock(&efx
->mac_lock
);
261 rc
= efx
->phy_op
->run_tests(efx
, tests
->phy
, flags
);
262 mutex_unlock(&efx
->mac_lock
);
266 /**************************************************************************
269 * NB Only one loopback test can be executing concurrently.
271 **************************************************************************/
273 /* Loopback test RX callback
274 * This is called for each received packet during loopback testing.
276 void efx_loopback_rx_packet(struct efx_nic
*efx
,
277 const char *buf_ptr
, int pkt_len
)
279 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
280 struct efx_loopback_payload
*received
;
281 struct efx_loopback_payload
*payload
;
285 /* If we are just flushing, then drop the packet */
286 if ((state
== NULL
) || state
->flush
)
289 payload
= &state
->payload
;
291 received
= (struct efx_loopback_payload
*) buf_ptr
;
292 received
->ip
.saddr
= payload
->ip
.saddr
;
293 if (state
->offload_csum
)
294 received
->ip
.check
= payload
->ip
.check
;
296 /* Check that header exists */
297 if (pkt_len
< sizeof(received
->header
)) {
298 EFX_ERR(efx
, "saw runt RX packet (length %d) in %s loopback "
299 "test\n", pkt_len
, LOOPBACK_MODE(efx
));
303 /* Check that the ethernet header exists */
304 if (memcmp(&received
->header
, &payload
->header
, ETH_HLEN
) != 0) {
305 EFX_ERR(efx
, "saw non-loopback RX packet in %s loopback test\n",
310 /* Check packet length */
311 if (pkt_len
!= sizeof(*payload
)) {
312 EFX_ERR(efx
, "saw incorrect RX packet length %d (wanted %d) in "
313 "%s loopback test\n", pkt_len
, (int)sizeof(*payload
),
318 /* Check that IP header matches */
319 if (memcmp(&received
->ip
, &payload
->ip
, sizeof(payload
->ip
)) != 0) {
320 EFX_ERR(efx
, "saw corrupted IP header in %s loopback test\n",
325 /* Check that msg and padding matches */
326 if (memcmp(&received
->msg
, &payload
->msg
, sizeof(received
->msg
)) != 0) {
327 EFX_ERR(efx
, "saw corrupted RX packet in %s loopback test\n",
332 /* Check that iteration matches */
333 if (received
->iteration
!= payload
->iteration
) {
334 EFX_ERR(efx
, "saw RX packet from iteration %d (wanted %d) in "
335 "%s loopback test\n", ntohs(received
->iteration
),
336 ntohs(payload
->iteration
), LOOPBACK_MODE(efx
));
340 /* Increase correct RX count */
341 EFX_TRACE(efx
, "got loopback RX in %s loopback test\n",
344 atomic_inc(&state
->rx_good
);
348 #ifdef EFX_ENABLE_DEBUG
349 if (atomic_read(&state
->rx_bad
) == 0) {
350 EFX_ERR(efx
, "received packet:\n");
351 print_hex_dump(KERN_ERR
, "", DUMP_PREFIX_OFFSET
, 0x10, 1,
352 buf_ptr
, pkt_len
, 0);
353 EFX_ERR(efx
, "expected packet:\n");
354 print_hex_dump(KERN_ERR
, "", DUMP_PREFIX_OFFSET
, 0x10, 1,
355 &state
->payload
, sizeof(state
->payload
), 0);
358 atomic_inc(&state
->rx_bad
);
361 /* Initialise an efx_selftest_state for a new iteration */
362 static void efx_iterate_state(struct efx_nic
*efx
)
364 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
365 struct net_device
*net_dev
= efx
->net_dev
;
366 struct efx_loopback_payload
*payload
= &state
->payload
;
368 /* Initialise the layerII header */
369 memcpy(&payload
->header
.h_dest
, net_dev
->dev_addr
, ETH_ALEN
);
370 memcpy(&payload
->header
.h_source
, &payload_source
, ETH_ALEN
);
371 payload
->header
.h_proto
= htons(ETH_P_IP
);
373 /* saddr set later and used as incrementing count */
374 payload
->ip
.daddr
= htonl(INADDR_LOOPBACK
);
376 payload
->ip
.check
= htons(0xdead);
377 payload
->ip
.tot_len
= htons(sizeof(*payload
) - sizeof(struct ethhdr
));
378 payload
->ip
.version
= IPVERSION
;
379 payload
->ip
.protocol
= IPPROTO_UDP
;
381 /* Initialise udp header */
382 payload
->udp
.source
= 0;
383 payload
->udp
.len
= htons(sizeof(*payload
) - sizeof(struct ethhdr
) -
384 sizeof(struct iphdr
));
385 payload
->udp
.check
= 0; /* checksum ignored */
387 /* Fill out payload */
388 payload
->iteration
= htons(ntohs(payload
->iteration
) + 1);
389 memcpy(&payload
->msg
, payload_msg
, sizeof(payload_msg
));
391 /* Fill out remaining state members */
392 atomic_set(&state
->rx_good
, 0);
393 atomic_set(&state
->rx_bad
, 0);
397 static int efx_begin_loopback(struct efx_tx_queue
*tx_queue
)
399 struct efx_nic
*efx
= tx_queue
->efx
;
400 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
401 struct efx_loopback_payload
*payload
;
405 /* Transmit N copies of buffer */
406 for (i
= 0; i
< state
->packet_count
; i
++) {
407 /* Allocate an skb, holding an extra reference for
408 * transmit completion counting */
409 skb
= alloc_skb(sizeof(state
->payload
), GFP_KERNEL
);
412 state
->skbs
[i
] = skb
;
415 /* Copy the payload in, incrementing the source address to
416 * exercise the rss vectors */
417 payload
= ((struct efx_loopback_payload
*)
418 skb_put(skb
, sizeof(state
->payload
)));
419 memcpy(payload
, &state
->payload
, sizeof(state
->payload
));
420 payload
->ip
.saddr
= htonl(INADDR_LOOPBACK
| (i
<< 2));
422 /* Ensure everything we've written is visible to the
423 * interrupt handler. */
426 if (efx_dev_registered(efx
))
427 netif_tx_lock_bh(efx
->net_dev
);
428 rc
= efx_xmit(efx
, tx_queue
, skb
);
429 if (efx_dev_registered(efx
))
430 netif_tx_unlock_bh(efx
->net_dev
);
432 if (rc
!= NETDEV_TX_OK
) {
433 EFX_ERR(efx
, "TX queue %d could not transmit packet %d "
434 "of %d in %s loopback test\n", tx_queue
->queue
,
435 i
+ 1, state
->packet_count
, LOOPBACK_MODE(efx
));
437 /* Defer cleaning up the other skbs for the caller */
441 efx
->net_dev
->trans_start
= jiffies
;
447 static int efx_poll_loopback(struct efx_nic
*efx
)
449 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
450 struct efx_channel
*channel
;
452 /* NAPI polling is not enabled, so process channels
454 efx_for_each_channel(channel
, efx
) {
455 if (channel
->work_pending
)
456 efx_process_channel_now(channel
);
458 return atomic_read(&state
->rx_good
) == state
->packet_count
;
461 static int efx_end_loopback(struct efx_tx_queue
*tx_queue
,
462 struct efx_loopback_self_tests
*lb_tests
)
464 struct efx_nic
*efx
= tx_queue
->efx
;
465 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
467 int tx_done
= 0, rx_good
, rx_bad
;
470 if (efx_dev_registered(efx
))
471 netif_tx_lock_bh(efx
->net_dev
);
473 /* Count the number of tx completions, and decrement the refcnt. Any
474 * skbs not already completed will be free'd when the queue is flushed */
475 for (i
=0; i
< state
->packet_count
; i
++) {
476 skb
= state
->skbs
[i
];
477 if (skb
&& !skb_shared(skb
))
479 dev_kfree_skb_any(skb
);
482 if (efx_dev_registered(efx
))
483 netif_tx_unlock_bh(efx
->net_dev
);
485 /* Check TX completion and received packet counts */
486 rx_good
= atomic_read(&state
->rx_good
);
487 rx_bad
= atomic_read(&state
->rx_bad
);
488 if (tx_done
!= state
->packet_count
) {
489 /* Don't free the skbs; they will be picked up on TX
490 * overflow or channel teardown.
492 EFX_ERR(efx
, "TX queue %d saw only %d out of an expected %d "
493 "TX completion events in %s loopback test\n",
494 tx_queue
->queue
, tx_done
, state
->packet_count
,
497 /* Allow to fall through so we see the RX errors as well */
500 /* We may always be up to a flush away from our desired packet total */
501 if (rx_good
!= state
->packet_count
) {
502 EFX_LOG(efx
, "TX queue %d saw only %d out of an expected %d "
503 "received packets in %s loopback test\n",
504 tx_queue
->queue
, rx_good
, state
->packet_count
,
510 /* Update loopback test structure */
511 lb_tests
->tx_sent
[tx_queue
->queue
] += state
->packet_count
;
512 lb_tests
->tx_done
[tx_queue
->queue
] += tx_done
;
513 lb_tests
->rx_good
+= rx_good
;
514 lb_tests
->rx_bad
+= rx_bad
;
520 efx_test_loopback(struct efx_tx_queue
*tx_queue
,
521 struct efx_loopback_self_tests
*lb_tests
)
523 struct efx_nic
*efx
= tx_queue
->efx
;
524 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
525 int i
, begin_rc
, end_rc
;
527 for (i
= 0; i
< 3; i
++) {
528 /* Determine how many packets to send */
529 state
->packet_count
= (efx
->type
->txd_ring_mask
+ 1) / 3;
530 state
->packet_count
= min(1 << (i
<< 2), state
->packet_count
);
531 state
->skbs
= kzalloc(sizeof(state
->skbs
[0]) *
532 state
->packet_count
, GFP_KERNEL
);
535 state
->flush
= false;
537 EFX_LOG(efx
, "TX queue %d testing %s loopback with %d "
538 "packets\n", tx_queue
->queue
, LOOPBACK_MODE(efx
),
539 state
->packet_count
);
541 efx_iterate_state(efx
);
542 begin_rc
= efx_begin_loopback(tx_queue
);
544 /* This will normally complete very quickly, but be
545 * prepared to wait up to 100 ms. */
547 if (!efx_poll_loopback(efx
)) {
549 efx_poll_loopback(efx
);
552 end_rc
= efx_end_loopback(tx_queue
, lb_tests
);
555 if (begin_rc
|| end_rc
) {
556 /* Wait a while to ensure there are no packets
557 * floating around after a failure. */
558 schedule_timeout_uninterruptible(HZ
/ 10);
559 return begin_rc
? begin_rc
: end_rc
;
563 EFX_LOG(efx
, "TX queue %d passed %s loopback test with a burst length "
564 "of %d packets\n", tx_queue
->queue
, LOOPBACK_MODE(efx
),
565 state
->packet_count
);
570 static int efx_test_loopbacks(struct efx_nic
*efx
, struct efx_self_tests
*tests
,
571 unsigned int loopback_modes
)
573 enum efx_loopback_mode mode
;
574 struct efx_loopback_state
*state
;
575 struct efx_tx_queue
*tx_queue
;
579 /* Set the port loopback_selftest member. From this point on
580 * all received packets will be dropped. Mark the state as
581 * "flushing" so all inflight packets are dropped */
582 state
= kzalloc(sizeof(*state
), GFP_KERNEL
);
585 BUG_ON(efx
->loopback_selftest
);
587 efx
->loopback_selftest
= state
;
589 /* Test all supported loopback modes */
590 for (mode
= LOOPBACK_NONE
; mode
<= LOOPBACK_TEST_MAX
; mode
++) {
591 if (!(loopback_modes
& (1 << mode
)))
594 /* Move the port into the specified loopback mode. */
596 efx
->loopback_mode
= mode
;
597 efx_reconfigure_port(efx
);
599 /* Wait for the PHY to signal the link is up. Interrupts
600 * are enabled for PHY's using LASI, otherwise we poll()
604 struct efx_channel
*channel
= &efx
->channel
[0];
606 efx
->phy_op
->poll(efx
);
607 schedule_timeout_uninterruptible(HZ
/ 10);
608 if (channel
->work_pending
)
609 efx_process_channel_now(channel
);
610 /* Wait for PHY events to be processed */
611 flush_workqueue(efx
->workqueue
);
614 /* We need both the phy and xaui links to be ok.
615 * rather than relying on the falcon_xmac irq/poll
616 * regime, just poll xaui directly */
617 link_up
= efx
->link_up
;
618 if (link_up
&& EFX_IS10G(efx
) &&
619 !falcon_xaui_link_ok(efx
))
622 } while ((++count
< 20) && !link_up
);
624 /* The link should now be up. If it isn't, there is no point
625 * in attempting a loopback test */
627 EFX_ERR(efx
, "loopback %s never came up\n",
633 EFX_LOG(efx
, "link came up in %s loopback in %d iterations\n",
634 LOOPBACK_MODE(efx
), count
);
636 /* Test every TX queue */
637 efx_for_each_tx_queue(tx_queue
, efx
) {
638 state
->offload_csum
= (tx_queue
->queue
==
639 EFX_TX_QUEUE_OFFLOAD_CSUM
);
640 rc
= efx_test_loopback(tx_queue
,
641 &tests
->loopback
[mode
]);
648 /* Remove the flush. The caller will remove the loopback setting */
650 efx
->loopback_selftest
= NULL
;
657 /**************************************************************************
661 *************************************************************************/
663 int efx_selftest(struct efx_nic
*efx
, struct efx_self_tests
*tests
,
666 enum efx_loopback_mode loopback_mode
= efx
->loopback_mode
;
667 int phy_mode
= efx
->phy_mode
;
668 enum reset_type reset_method
= RESET_TYPE_INVISIBLE
;
669 struct ethtool_cmd ecmd
;
670 struct efx_channel
*channel
;
671 int rc_test
= 0, rc_reset
= 0, rc
;
673 /* Online (i.e. non-disruptive) testing
674 * This checks interrupt generation, event delivery and PHY presence. */
676 rc
= efx_test_mdio(efx
, tests
);
680 rc
= efx_test_nvram(efx
, tests
);
684 rc
= efx_test_interrupts(efx
, tests
);
688 efx_for_each_channel(channel
, efx
) {
689 rc
= efx_test_eventq_irq(channel
, tests
);
697 if (!(flags
& ETH_TEST_FL_OFFLINE
))
698 return efx_test_phy(efx
, tests
, flags
);
700 /* Offline (i.e. disruptive) testing
701 * This checks MAC and PHY loopback on the specified port. */
703 /* force the carrier state off so the kernel doesn't transmit during
704 * the loopback test, and the watchdog timeout doesn't fire. Also put
705 * falcon into loopback for the register test.
707 mutex_lock(&efx
->mac_lock
);
708 efx
->port_inhibited
= true;
709 if (efx
->loopback_modes
) {
710 /* We need the 312 clock from the PHY to test the XMAC
711 * registers, so move into XGMII loopback if available */
712 if (efx
->loopback_modes
& (1 << LOOPBACK_XGMII
))
713 efx
->loopback_mode
= LOOPBACK_XGMII
;
715 efx
->loopback_mode
= __ffs(efx
->loopback_modes
);
718 __efx_reconfigure_port(efx
);
719 mutex_unlock(&efx
->mac_lock
);
721 /* free up all consumers of SRAM (including all the queues) */
722 efx_reset_down(efx
, reset_method
, &ecmd
);
724 rc
= efx_test_chip(efx
, tests
);
728 /* reset the chip to recover from the register test */
729 rc_reset
= falcon_reset_hw(efx
, reset_method
);
731 /* Ensure that the phy is powered and out of loopback
732 * for the bist and loopback tests */
733 efx
->phy_mode
&= ~PHY_MODE_LOW_POWER
;
734 efx
->loopback_mode
= LOOPBACK_NONE
;
736 rc
= efx_reset_up(efx
, reset_method
, &ecmd
, rc_reset
== 0);
741 EFX_ERR(efx
, "Unable to recover from chip test\n");
742 efx_schedule_reset(efx
, RESET_TYPE_DISABLE
);
746 rc
= efx_test_phy(efx
, tests
, flags
);
750 rc
= efx_test_loopbacks(efx
, tests
, efx
->loopback_modes
);
754 /* restore the PHY to the previous state */
755 efx
->loopback_mode
= loopback_mode
;
756 efx
->phy_mode
= phy_mode
;
757 efx
->port_inhibited
= false;
758 efx_ethtool_set_settings(efx
->net_dev
, &ecmd
);