1 /****************************************************************************
2 * Driver for Solarflare Solarstorm network controllers and boards
3 * Copyright 2005-2006 Fen Systems Ltd.
4 * Copyright 2006-2010 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>
21 #include <linux/slab.h>
23 #include "net_driver.h"
27 #include "workarounds.h"
30 * Loopback test packet structure
32 * The self-test should stress every RSS vector, and unfortunately
33 * Falcon only performs RSS on TCP/UDP packets.
35 struct efx_loopback_payload
{
43 /* Loopback test source MAC address */
44 static const unsigned char payload_source
[ETH_ALEN
] = {
45 0x00, 0x0f, 0x53, 0x1b, 0x1b, 0x1b,
48 static const char payload_msg
[] =
49 "Hello world! This is an Efx loopback test in progress!";
51 /* Interrupt mode names */
52 static const unsigned int efx_interrupt_mode_max
= EFX_INT_MODE_MAX
;
53 static const char *efx_interrupt_mode_names
[] = {
54 [EFX_INT_MODE_MSIX
] = "MSI-X",
55 [EFX_INT_MODE_MSI
] = "MSI",
56 [EFX_INT_MODE_LEGACY
] = "legacy",
58 #define INT_MODE(efx) \
59 STRING_TABLE_LOOKUP(efx->interrupt_mode, efx_interrupt_mode)
62 * efx_loopback_state - persistent state during a loopback selftest
63 * @flush: Drop all packets in efx_loopback_rx_packet
64 * @packet_count: Number of packets being used in this test
65 * @skbs: An array of skbs transmitted
66 * @offload_csum: Checksums are being offloaded
67 * @rx_good: RX good packet count
68 * @rx_bad: RX bad packet count
69 * @payload: Payload used in tests
71 struct efx_loopback_state
{
74 struct sk_buff
**skbs
;
78 struct efx_loopback_payload payload
;
81 /**************************************************************************
83 * MII, NVRAM and register tests
85 **************************************************************************/
87 static int efx_test_phy_alive(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
91 if (efx
->phy_op
->test_alive
) {
92 rc
= efx
->phy_op
->test_alive(efx
);
93 tests
->phy_alive
= rc
? -1 : 1;
99 static int efx_test_nvram(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
103 if (efx
->type
->test_nvram
) {
104 rc
= efx
->type
->test_nvram(efx
);
105 tests
->nvram
= rc
? -1 : 1;
111 static int efx_test_chip(struct efx_nic
*efx
, struct efx_self_tests
*tests
)
115 /* Test register access */
116 if (efx
->type
->test_registers
) {
117 rc
= efx
->type
->test_registers(efx
);
118 tests
->registers
= rc
? -1 : 1;
124 /**************************************************************************
126 * Interrupt and event queue testing
128 **************************************************************************/
130 /* Test generation and receipt of interrupts */
131 static int efx_test_interrupts(struct efx_nic
*efx
,
132 struct efx_self_tests
*tests
)
134 netif_dbg(efx
, drv
, efx
->net_dev
, "testing interrupts\n");
135 tests
->interrupt
= -1;
137 /* Reset interrupt flag */
138 efx
->last_irq_cpu
= -1;
141 efx_nic_generate_interrupt(efx
);
143 /* Wait for arrival of test interrupt. */
144 netif_dbg(efx
, drv
, efx
->net_dev
, "waiting for test interrupt\n");
145 schedule_timeout_uninterruptible(HZ
/ 10);
146 if (efx
->last_irq_cpu
>= 0)
149 netif_err(efx
, drv
, efx
->net_dev
, "timed out waiting for interrupt\n");
153 netif_dbg(efx
, drv
, efx
->net_dev
, "%s test interrupt seen on CPU%d\n",
156 tests
->interrupt
= 1;
160 /* Test generation and receipt of interrupting events */
161 static int efx_test_eventq_irq(struct efx_channel
*channel
,
162 struct efx_self_tests
*tests
)
164 struct efx_nic
*efx
= channel
->efx
;
165 unsigned int read_ptr
, count
;
167 tests
->eventq_dma
[channel
->channel
] = -1;
168 tests
->eventq_int
[channel
->channel
] = -1;
169 tests
->eventq_poll
[channel
->channel
] = -1;
171 read_ptr
= channel
->eventq_read_ptr
;
172 channel
->efx
->last_irq_cpu
= -1;
175 efx_nic_generate_test_event(channel
);
177 /* Wait for arrival of interrupt */
180 schedule_timeout_uninterruptible(HZ
/ 100);
182 if (ACCESS_ONCE(channel
->eventq_read_ptr
) != read_ptr
)
184 } while (++count
< 2);
186 netif_err(efx
, drv
, efx
->net_dev
,
187 "channel %d timed out waiting for event queue\n",
190 /* See if interrupt arrived */
191 if (channel
->efx
->last_irq_cpu
>= 0) {
192 netif_err(efx
, drv
, efx
->net_dev
,
193 "channel %d saw interrupt on CPU%d "
194 "during event queue test\n", channel
->channel
,
195 raw_smp_processor_id());
196 tests
->eventq_int
[channel
->channel
] = 1;
199 /* Check to see if event was received even if interrupt wasn't */
200 if (efx_nic_event_present(channel
)) {
201 netif_err(efx
, drv
, efx
->net_dev
,
202 "channel %d event was generated, but "
203 "failed to trigger an interrupt\n", channel
->channel
);
204 tests
->eventq_dma
[channel
->channel
] = 1;
209 netif_dbg(efx
, drv
, efx
->net_dev
, "channel %d event queue passed\n",
211 tests
->eventq_dma
[channel
->channel
] = 1;
212 tests
->eventq_int
[channel
->channel
] = 1;
213 tests
->eventq_poll
[channel
->channel
] = 1;
217 static int efx_test_phy(struct efx_nic
*efx
, struct efx_self_tests
*tests
,
222 if (!efx
->phy_op
->run_tests
)
225 mutex_lock(&efx
->mac_lock
);
226 rc
= efx
->phy_op
->run_tests(efx
, tests
->phy_ext
, flags
);
227 mutex_unlock(&efx
->mac_lock
);
231 /**************************************************************************
234 * NB Only one loopback test can be executing concurrently.
236 **************************************************************************/
238 /* Loopback test RX callback
239 * This is called for each received packet during loopback testing.
241 void efx_loopback_rx_packet(struct efx_nic
*efx
,
242 const char *buf_ptr
, int pkt_len
)
244 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
245 struct efx_loopback_payload
*received
;
246 struct efx_loopback_payload
*payload
;
250 /* If we are just flushing, then drop the packet */
251 if ((state
== NULL
) || state
->flush
)
254 payload
= &state
->payload
;
256 received
= (struct efx_loopback_payload
*) buf_ptr
;
257 received
->ip
.saddr
= payload
->ip
.saddr
;
258 if (state
->offload_csum
)
259 received
->ip
.check
= payload
->ip
.check
;
261 /* Check that header exists */
262 if (pkt_len
< sizeof(received
->header
)) {
263 netif_err(efx
, drv
, efx
->net_dev
,
264 "saw runt RX packet (length %d) in %s loopback "
265 "test\n", pkt_len
, LOOPBACK_MODE(efx
));
269 /* Check that the ethernet header exists */
270 if (memcmp(&received
->header
, &payload
->header
, ETH_HLEN
) != 0) {
271 netif_err(efx
, drv
, efx
->net_dev
,
272 "saw non-loopback RX packet in %s loopback test\n",
277 /* Check packet length */
278 if (pkt_len
!= sizeof(*payload
)) {
279 netif_err(efx
, drv
, efx
->net_dev
,
280 "saw incorrect RX packet length %d (wanted %d) in "
281 "%s loopback test\n", pkt_len
, (int)sizeof(*payload
),
286 /* Check that IP header matches */
287 if (memcmp(&received
->ip
, &payload
->ip
, sizeof(payload
->ip
)) != 0) {
288 netif_err(efx
, drv
, efx
->net_dev
,
289 "saw corrupted IP header in %s loopback test\n",
294 /* Check that msg and padding matches */
295 if (memcmp(&received
->msg
, &payload
->msg
, sizeof(received
->msg
)) != 0) {
296 netif_err(efx
, drv
, efx
->net_dev
,
297 "saw corrupted RX packet in %s loopback test\n",
302 /* Check that iteration matches */
303 if (received
->iteration
!= payload
->iteration
) {
304 netif_err(efx
, drv
, efx
->net_dev
,
305 "saw RX packet from iteration %d (wanted %d) in "
306 "%s loopback test\n", ntohs(received
->iteration
),
307 ntohs(payload
->iteration
), LOOPBACK_MODE(efx
));
311 /* Increase correct RX count */
312 netif_vdbg(efx
, drv
, efx
->net_dev
,
313 "got loopback RX in %s loopback test\n", LOOPBACK_MODE(efx
));
315 atomic_inc(&state
->rx_good
);
319 #ifdef EFX_ENABLE_DEBUG
320 if (atomic_read(&state
->rx_bad
) == 0) {
321 netif_err(efx
, drv
, efx
->net_dev
, "received packet:\n");
322 print_hex_dump(KERN_ERR
, "", DUMP_PREFIX_OFFSET
, 0x10, 1,
323 buf_ptr
, pkt_len
, 0);
324 netif_err(efx
, drv
, efx
->net_dev
, "expected packet:\n");
325 print_hex_dump(KERN_ERR
, "", DUMP_PREFIX_OFFSET
, 0x10, 1,
326 &state
->payload
, sizeof(state
->payload
), 0);
329 atomic_inc(&state
->rx_bad
);
332 /* Initialise an efx_selftest_state for a new iteration */
333 static void efx_iterate_state(struct efx_nic
*efx
)
335 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
336 struct net_device
*net_dev
= efx
->net_dev
;
337 struct efx_loopback_payload
*payload
= &state
->payload
;
339 /* Initialise the layerII header */
340 memcpy(&payload
->header
.h_dest
, net_dev
->dev_addr
, ETH_ALEN
);
341 memcpy(&payload
->header
.h_source
, &payload_source
, ETH_ALEN
);
342 payload
->header
.h_proto
= htons(ETH_P_IP
);
344 /* saddr set later and used as incrementing count */
345 payload
->ip
.daddr
= htonl(INADDR_LOOPBACK
);
347 payload
->ip
.check
= htons(0xdead);
348 payload
->ip
.tot_len
= htons(sizeof(*payload
) - sizeof(struct ethhdr
));
349 payload
->ip
.version
= IPVERSION
;
350 payload
->ip
.protocol
= IPPROTO_UDP
;
352 /* Initialise udp header */
353 payload
->udp
.source
= 0;
354 payload
->udp
.len
= htons(sizeof(*payload
) - sizeof(struct ethhdr
) -
355 sizeof(struct iphdr
));
356 payload
->udp
.check
= 0; /* checksum ignored */
358 /* Fill out payload */
359 payload
->iteration
= htons(ntohs(payload
->iteration
) + 1);
360 memcpy(&payload
->msg
, payload_msg
, sizeof(payload_msg
));
362 /* Fill out remaining state members */
363 atomic_set(&state
->rx_good
, 0);
364 atomic_set(&state
->rx_bad
, 0);
368 static int efx_begin_loopback(struct efx_tx_queue
*tx_queue
)
370 struct efx_nic
*efx
= tx_queue
->efx
;
371 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
372 struct efx_loopback_payload
*payload
;
377 /* Transmit N copies of buffer */
378 for (i
= 0; i
< state
->packet_count
; i
++) {
379 /* Allocate an skb, holding an extra reference for
380 * transmit completion counting */
381 skb
= alloc_skb(sizeof(state
->payload
), GFP_KERNEL
);
384 state
->skbs
[i
] = skb
;
387 /* Copy the payload in, incrementing the source address to
388 * exercise the rss vectors */
389 payload
= ((struct efx_loopback_payload
*)
390 skb_put(skb
, sizeof(state
->payload
)));
391 memcpy(payload
, &state
->payload
, sizeof(state
->payload
));
392 payload
->ip
.saddr
= htonl(INADDR_LOOPBACK
| (i
<< 2));
394 /* Ensure everything we've written is visible to the
395 * interrupt handler. */
398 if (efx_dev_registered(efx
))
399 netif_tx_lock_bh(efx
->net_dev
);
400 rc
= efx_enqueue_skb(tx_queue
, skb
);
401 if (efx_dev_registered(efx
))
402 netif_tx_unlock_bh(efx
->net_dev
);
404 if (rc
!= NETDEV_TX_OK
) {
405 netif_err(efx
, drv
, efx
->net_dev
,
406 "TX queue %d could not transmit packet %d of "
407 "%d in %s loopback test\n", tx_queue
->queue
,
408 i
+ 1, state
->packet_count
,
411 /* Defer cleaning up the other skbs for the caller */
420 static int efx_poll_loopback(struct efx_nic
*efx
)
422 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
423 struct efx_channel
*channel
;
425 /* NAPI polling is not enabled, so process channels
427 efx_for_each_channel(channel
, efx
) {
428 if (channel
->work_pending
)
429 efx_process_channel_now(channel
);
431 return atomic_read(&state
->rx_good
) == state
->packet_count
;
434 static int efx_end_loopback(struct efx_tx_queue
*tx_queue
,
435 struct efx_loopback_self_tests
*lb_tests
)
437 struct efx_nic
*efx
= tx_queue
->efx
;
438 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
440 int tx_done
= 0, rx_good
, rx_bad
;
443 if (efx_dev_registered(efx
))
444 netif_tx_lock_bh(efx
->net_dev
);
446 /* Count the number of tx completions, and decrement the refcnt. Any
447 * skbs not already completed will be free'd when the queue is flushed */
448 for (i
=0; i
< state
->packet_count
; i
++) {
449 skb
= state
->skbs
[i
];
450 if (skb
&& !skb_shared(skb
))
452 dev_kfree_skb_any(skb
);
455 if (efx_dev_registered(efx
))
456 netif_tx_unlock_bh(efx
->net_dev
);
458 /* Check TX completion and received packet counts */
459 rx_good
= atomic_read(&state
->rx_good
);
460 rx_bad
= atomic_read(&state
->rx_bad
);
461 if (tx_done
!= state
->packet_count
) {
462 /* Don't free the skbs; they will be picked up on TX
463 * overflow or channel teardown.
465 netif_err(efx
, drv
, efx
->net_dev
,
466 "TX queue %d saw only %d out of an expected %d "
467 "TX completion events in %s loopback test\n",
468 tx_queue
->queue
, tx_done
, state
->packet_count
,
471 /* Allow to fall through so we see the RX errors as well */
474 /* We may always be up to a flush away from our desired packet total */
475 if (rx_good
!= state
->packet_count
) {
476 netif_dbg(efx
, drv
, efx
->net_dev
,
477 "TX queue %d saw only %d out of an expected %d "
478 "received packets in %s loopback test\n",
479 tx_queue
->queue
, rx_good
, state
->packet_count
,
485 /* Update loopback test structure */
486 lb_tests
->tx_sent
[tx_queue
->queue
] += state
->packet_count
;
487 lb_tests
->tx_done
[tx_queue
->queue
] += tx_done
;
488 lb_tests
->rx_good
+= rx_good
;
489 lb_tests
->rx_bad
+= rx_bad
;
495 efx_test_loopback(struct efx_tx_queue
*tx_queue
,
496 struct efx_loopback_self_tests
*lb_tests
)
498 struct efx_nic
*efx
= tx_queue
->efx
;
499 struct efx_loopback_state
*state
= efx
->loopback_selftest
;
500 int i
, begin_rc
, end_rc
;
502 for (i
= 0; i
< 3; i
++) {
503 /* Determine how many packets to send */
504 state
->packet_count
= efx
->txq_entries
/ 3;
505 state
->packet_count
= min(1 << (i
<< 2), state
->packet_count
);
506 state
->skbs
= kzalloc(sizeof(state
->skbs
[0]) *
507 state
->packet_count
, GFP_KERNEL
);
510 state
->flush
= false;
512 netif_dbg(efx
, drv
, efx
->net_dev
,
513 "TX queue %d testing %s loopback with %d packets\n",
514 tx_queue
->queue
, LOOPBACK_MODE(efx
),
515 state
->packet_count
);
517 efx_iterate_state(efx
);
518 begin_rc
= efx_begin_loopback(tx_queue
);
520 /* This will normally complete very quickly, but be
521 * prepared to wait up to 100 ms. */
523 if (!efx_poll_loopback(efx
)) {
525 efx_poll_loopback(efx
);
528 end_rc
= efx_end_loopback(tx_queue
, lb_tests
);
531 if (begin_rc
|| end_rc
) {
532 /* Wait a while to ensure there are no packets
533 * floating around after a failure. */
534 schedule_timeout_uninterruptible(HZ
/ 10);
535 return begin_rc
? begin_rc
: end_rc
;
539 netif_dbg(efx
, drv
, efx
->net_dev
,
540 "TX queue %d passed %s loopback test with a burst length "
541 "of %d packets\n", tx_queue
->queue
, LOOPBACK_MODE(efx
),
542 state
->packet_count
);
547 /* Wait for link up. On Falcon, we would prefer to rely on efx_monitor, but
548 * any contention on the mac lock (via e.g. efx_mac_mcast_work) causes it
549 * to delay and retry. Therefore, it's safer to just poll directly. Wait
550 * for link up and any faults to dissipate. */
551 static int efx_wait_for_link(struct efx_nic
*efx
)
553 struct efx_link_state
*link_state
= &efx
->link_state
;
554 int count
, link_up_count
= 0;
557 for (count
= 0; count
< 40; count
++) {
558 schedule_timeout_uninterruptible(HZ
/ 10);
560 if (efx
->type
->monitor
!= NULL
) {
561 mutex_lock(&efx
->mac_lock
);
562 efx
->type
->monitor(efx
);
563 mutex_unlock(&efx
->mac_lock
);
565 struct efx_channel
*channel
= efx_get_channel(efx
, 0);
566 if (channel
->work_pending
)
567 efx_process_channel_now(channel
);
570 mutex_lock(&efx
->mac_lock
);
571 link_up
= link_state
->up
;
573 link_up
= !efx
->mac_op
->check_fault(efx
);
574 mutex_unlock(&efx
->mac_lock
);
577 if (++link_up_count
== 2)
587 static int efx_test_loopbacks(struct efx_nic
*efx
, struct efx_self_tests
*tests
,
588 unsigned int loopback_modes
)
590 enum efx_loopback_mode mode
;
591 struct efx_loopback_state
*state
;
592 struct efx_channel
*channel
= efx_get_channel(efx
, 0);
593 struct efx_tx_queue
*tx_queue
;
596 /* Set the port loopback_selftest member. From this point on
597 * all received packets will be dropped. Mark the state as
598 * "flushing" so all inflight packets are dropped */
599 state
= kzalloc(sizeof(*state
), GFP_KERNEL
);
602 BUG_ON(efx
->loopback_selftest
);
604 efx
->loopback_selftest
= state
;
606 /* Test all supported loopback modes */
607 for (mode
= LOOPBACK_NONE
; mode
<= LOOPBACK_TEST_MAX
; mode
++) {
608 if (!(loopback_modes
& (1 << mode
)))
611 /* Move the port into the specified loopback mode. */
613 mutex_lock(&efx
->mac_lock
);
614 efx
->loopback_mode
= mode
;
615 rc
= __efx_reconfigure_port(efx
);
616 mutex_unlock(&efx
->mac_lock
);
618 netif_err(efx
, drv
, efx
->net_dev
,
619 "unable to move into %s loopback\n",
624 rc
= efx_wait_for_link(efx
);
626 netif_err(efx
, drv
, efx
->net_dev
,
627 "loopback %s never came up\n",
632 /* Test all enabled types of TX queue */
633 efx_for_each_channel_tx_queue(tx_queue
, channel
) {
634 state
->offload_csum
= (tx_queue
->queue
&
635 EFX_TXQ_TYPE_OFFLOAD
);
636 rc
= efx_test_loopback(tx_queue
,
637 &tests
->loopback
[mode
]);
644 /* Remove the flush. The caller will remove the loopback setting */
646 efx
->loopback_selftest
= NULL
;
653 /**************************************************************************
657 *************************************************************************/
659 int efx_selftest(struct efx_nic
*efx
, struct efx_self_tests
*tests
,
662 enum efx_loopback_mode loopback_mode
= efx
->loopback_mode
;
663 int phy_mode
= efx
->phy_mode
;
664 enum reset_type reset_method
= RESET_TYPE_INVISIBLE
;
665 struct efx_channel
*channel
;
666 int rc_test
= 0, rc_reset
= 0, rc
;
668 /* Online (i.e. non-disruptive) testing
669 * This checks interrupt generation, event delivery and PHY presence. */
671 rc
= efx_test_phy_alive(efx
, tests
);
675 rc
= efx_test_nvram(efx
, tests
);
679 rc
= efx_test_interrupts(efx
, tests
);
683 efx_for_each_channel(channel
, efx
) {
684 rc
= efx_test_eventq_irq(channel
, tests
);
692 if (!(flags
& ETH_TEST_FL_OFFLINE
))
693 return efx_test_phy(efx
, tests
, flags
);
695 /* Offline (i.e. disruptive) testing
696 * This checks MAC and PHY loopback on the specified port. */
698 /* Detach the device so the kernel doesn't transmit during the
699 * loopback test and the watchdog timeout doesn't fire.
701 netif_device_detach(efx
->net_dev
);
703 mutex_lock(&efx
->mac_lock
);
704 if (efx
->loopback_modes
) {
705 /* We need the 312 clock from the PHY to test the XMAC
706 * registers, so move into XGMII loopback if available */
707 if (efx
->loopback_modes
& (1 << LOOPBACK_XGMII
))
708 efx
->loopback_mode
= LOOPBACK_XGMII
;
710 efx
->loopback_mode
= __ffs(efx
->loopback_modes
);
713 __efx_reconfigure_port(efx
);
714 mutex_unlock(&efx
->mac_lock
);
716 /* free up all consumers of SRAM (including all the queues) */
717 efx_reset_down(efx
, reset_method
);
719 rc
= efx_test_chip(efx
, tests
);
723 /* reset the chip to recover from the register test */
724 rc_reset
= efx
->type
->reset(efx
, reset_method
);
726 /* Ensure that the phy is powered and out of loopback
727 * for the bist and loopback tests */
728 efx
->phy_mode
&= ~PHY_MODE_LOW_POWER
;
729 efx
->loopback_mode
= LOOPBACK_NONE
;
731 rc
= efx_reset_up(efx
, reset_method
, rc_reset
== 0);
736 netif_err(efx
, drv
, efx
->net_dev
,
737 "Unable to recover from chip test\n");
738 efx_schedule_reset(efx
, RESET_TYPE_DISABLE
);
742 rc
= efx_test_phy(efx
, tests
, flags
);
746 rc
= efx_test_loopbacks(efx
, tests
, efx
->loopback_modes
);
750 /* restore the PHY to the previous state */
751 mutex_lock(&efx
->mac_lock
);
752 efx
->phy_mode
= phy_mode
;
753 efx
->loopback_mode
= loopback_mode
;
754 __efx_reconfigure_port(efx
);
755 mutex_unlock(&efx
->mac_lock
);
757 netif_device_attach(efx
->net_dev
);