1 /****************************************************************************
2 * Driver for Solarflare Solarstorm network controllers and boards
3 * Copyright 2005-2006 Fen Systems Ltd.
4 * Copyright 2006-2009 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!";
52 * efx_loopback_state - persistent state during a loopback selftest
53 * @flush: Drop all packets in efx_loopback_rx_packet
54 * @packet_count: Number of packets being used in this test
55 * @skbs: An array of skbs transmitted
56 * @offload_csum: Checksums are being offloaded
57 * @rx_good: RX good packet count
58 * @rx_bad: RX bad packet count
59 * @payload: Payload used in tests
61 struct efx_loopback_state {
64 struct sk_buff **skbs;
68 struct efx_loopback_payload payload;
71 /**************************************************************************
73 * MII, NVRAM and register tests
75 **************************************************************************/
77 static int efx_test_phy_alive(struct efx_nic *efx, struct efx_self_tests *tests)
81 if (efx->phy_op->test_alive) {
82 rc = efx->phy_op->test_alive(efx);
83 tests->phy_alive = rc ? -1 : 1;
89 static int efx_test_nvram(struct efx_nic *efx, struct efx_self_tests *tests)
93 if (efx->type->test_nvram) {
94 rc = efx->type->test_nvram(efx);
95 tests->nvram = rc ? -1 : 1;
101 static int efx_test_chip(struct efx_nic *efx, struct efx_self_tests *tests)
105 /* Test register access */
106 if (efx->type->test_registers) {
107 rc = efx->type->test_registers(efx);
108 tests->registers = rc ? -1 : 1;
114 /**************************************************************************
116 * Interrupt and event queue testing
118 **************************************************************************/
120 /* Test generation and receipt of interrupts */
121 static int efx_test_interrupts(struct efx_nic *efx,
122 struct efx_self_tests *tests)
124 struct efx_channel *channel;
126 EFX_LOG(efx, "testing interrupts\n");
127 tests->interrupt = -1;
129 /* Reset interrupt flag */
130 efx->last_irq_cpu = -1;
133 /* ACK each interrupting event queue. Receiving an interrupt due to
134 * traffic before a test event is raised is considered a pass */
135 efx_for_each_channel(channel, efx) {
136 if (channel->work_pending)
137 efx_process_channel_now(channel);
138 if (efx->last_irq_cpu >= 0)
142 efx_nic_generate_interrupt(efx);
144 /* Wait for arrival of test interrupt. */
145 EFX_LOG(efx, "waiting for test interrupt\n");
146 schedule_timeout_uninterruptible(HZ / 10);
147 if (efx->last_irq_cpu >= 0)
150 EFX_ERR(efx, "timed out waiting for interrupt\n");
154 EFX_LOG(efx, "%s test interrupt seen on CPU%d\n", INT_MODE(efx),
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 unsigned int magic_count, count;
166 tests->eventq_dma[channel->channel] = -1;
167 tests->eventq_int[channel->channel] = -1;
168 tests->eventq_poll[channel->channel] = -1;
170 magic_count = channel->magic_count;
171 channel->efx->last_irq_cpu = -1;
174 efx_nic_generate_test_event(channel);
176 /* Wait for arrival of interrupt */
179 schedule_timeout_uninterruptible(HZ / 100);
181 if (channel->work_pending)
182 efx_process_channel_now(channel);
184 if (channel->magic_count != magic_count)
186 } while (++count < 2);
188 EFX_ERR(channel->efx, "channel %d timed out waiting for event queue\n",
191 /* See if interrupt arrived */
192 if (channel->efx->last_irq_cpu >= 0) {
193 EFX_ERR(channel->efx, "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 efx_process_channel_now(channel);
201 if (channel->magic_count != magic_count) {
202 EFX_ERR(channel->efx, "channel %d event was generated, but "
203 "failed to trigger an interrupt\n", channel->channel);
204 tests->eventq_dma[channel->channel] = 1;
209 EFX_LOG(channel->efx, "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 EFX_ERR(efx, "saw runt RX packet (length %d) in %s loopback "
264 "test\n", pkt_len, LOOPBACK_MODE(efx));
268 /* Check that the ethernet header exists */
269 if (memcmp(&received->header, &payload->header, ETH_HLEN) != 0) {
270 EFX_ERR(efx, "saw non-loopback RX packet in %s loopback test\n",
275 /* Check packet length */
276 if (pkt_len != sizeof(*payload)) {
277 EFX_ERR(efx, "saw incorrect RX packet length %d (wanted %d) in "
278 "%s loopback test\n", pkt_len, (int)sizeof(*payload),
283 /* Check that IP header matches */
284 if (memcmp(&received->ip, &payload->ip, sizeof(payload->ip)) != 0) {
285 EFX_ERR(efx, "saw corrupted IP header in %s loopback test\n",
290 /* Check that msg and padding matches */
291 if (memcmp(&received->msg, &payload->msg, sizeof(received->msg)) != 0) {
292 EFX_ERR(efx, "saw corrupted RX packet in %s loopback test\n",
297 /* Check that iteration matches */
298 if (received->iteration != payload->iteration) {
299 EFX_ERR(efx, "saw RX packet from iteration %d (wanted %d) in "
300 "%s loopback test\n", ntohs(received->iteration),
301 ntohs(payload->iteration), LOOPBACK_MODE(efx));
305 /* Increase correct RX count */
306 EFX_TRACE(efx, "got loopback RX in %s loopback test\n",
309 atomic_inc(&state->rx_good);
313 #ifdef EFX_ENABLE_DEBUG
314 if (atomic_read(&state->rx_bad) == 0) {
315 EFX_ERR(efx, "received packet:\n");
316 print_hex_dump(KERN_ERR, "", DUMP_PREFIX_OFFSET, 0x10, 1,
317 buf_ptr, pkt_len, 0);
318 EFX_ERR(efx, "expected packet:\n");
319 print_hex_dump(KERN_ERR, "", DUMP_PREFIX_OFFSET, 0x10, 1,
320 &state->payload, sizeof(state->payload), 0);
323 atomic_inc(&state->rx_bad);
326 /* Initialise an efx_selftest_state for a new iteration */
327 static void efx_iterate_state(struct efx_nic *efx)
329 struct efx_loopback_state *state = efx->loopback_selftest;
330 struct net_device *net_dev = efx->net_dev;
331 struct efx_loopback_payload *payload = &state->payload;
333 /* Initialise the layerII header */
334 memcpy(&payload->header.h_dest, net_dev->dev_addr, ETH_ALEN);
335 memcpy(&payload->header.h_source, &payload_source, ETH_ALEN);
336 payload->header.h_proto = htons(ETH_P_IP);
338 /* saddr set later and used as incrementing count */
339 payload->ip.daddr = htonl(INADDR_LOOPBACK);
341 payload->ip.check = htons(0xdead);
342 payload->ip.tot_len = htons(sizeof(*payload) - sizeof(struct ethhdr));
343 payload->ip.version = IPVERSION;
344 payload->ip.protocol = IPPROTO_UDP;
346 /* Initialise udp header */
347 payload->udp.source = 0;
348 payload->udp.len = htons(sizeof(*payload) - sizeof(struct ethhdr) -
349 sizeof(struct iphdr));
350 payload->udp.check = 0; /* checksum ignored */
352 /* Fill out payload */
353 payload->iteration = htons(ntohs(payload->iteration) + 1);
354 memcpy(&payload->msg, payload_msg, sizeof(payload_msg));
356 /* Fill out remaining state members */
357 atomic_set(&state->rx_good, 0);
358 atomic_set(&state->rx_bad, 0);
362 static int efx_begin_loopback(struct efx_tx_queue *tx_queue)
364 struct efx_nic *efx = tx_queue->efx;
365 struct efx_loopback_state *state = efx->loopback_selftest;
366 struct efx_loopback_payload *payload;
371 /* Transmit N copies of buffer */
372 for (i = 0; i < state->packet_count; i++) {
373 /* Allocate an skb, holding an extra reference for
374 * transmit completion counting */
375 skb = alloc_skb(sizeof(state->payload), GFP_KERNEL);
378 state->skbs[i] = skb;
381 /* Copy the payload in, incrementing the source address to
382 * exercise the rss vectors */
383 payload = ((struct efx_loopback_payload *)
384 skb_put(skb, sizeof(state->payload)));
385 memcpy(payload, &state->payload, sizeof(state->payload));
386 payload->ip.saddr = htonl(INADDR_LOOPBACK | (i << 2));
388 /* Ensure everything we've written is visible to the
389 * interrupt handler. */
392 if (efx_dev_registered(efx))
393 netif_tx_lock_bh(efx->net_dev);
394 rc = efx_enqueue_skb(tx_queue, skb);
395 if (efx_dev_registered(efx))
396 netif_tx_unlock_bh(efx->net_dev);
398 if (rc != NETDEV_TX_OK) {
399 EFX_ERR(efx, "TX queue %d could not transmit packet %d "
400 "of %d in %s loopback test\n", tx_queue->queue,
401 i + 1, state->packet_count, LOOPBACK_MODE(efx));
403 /* Defer cleaning up the other skbs for the caller */
412 static int efx_poll_loopback(struct efx_nic *efx)
414 struct efx_loopback_state *state = efx->loopback_selftest;
415 struct efx_channel *channel;
417 /* NAPI polling is not enabled, so process channels
419 efx_for_each_channel(channel, efx) {
420 if (channel->work_pending)
421 efx_process_channel_now(channel);
423 return atomic_read(&state->rx_good) == state->packet_count;
426 static int efx_end_loopback(struct efx_tx_queue *tx_queue,
427 struct efx_loopback_self_tests *lb_tests)
429 struct efx_nic *efx = tx_queue->efx;
430 struct efx_loopback_state *state = efx->loopback_selftest;
432 int tx_done = 0, rx_good, rx_bad;
435 if (efx_dev_registered(efx))
436 netif_tx_lock_bh(efx->net_dev);
438 /* Count the number of tx completions, and decrement the refcnt. Any
439 * skbs not already completed will be free'd when the queue is flushed */
440 for (i=0; i < state->packet_count; i++) {
441 skb = state->skbs[i];
442 if (skb && !skb_shared(skb))
444 dev_kfree_skb_any(skb);
447 if (efx_dev_registered(efx))
448 netif_tx_unlock_bh(efx->net_dev);
450 /* Check TX completion and received packet counts */
451 rx_good = atomic_read(&state->rx_good);
452 rx_bad = atomic_read(&state->rx_bad);
453 if (tx_done != state->packet_count) {
454 /* Don't free the skbs; they will be picked up on TX
455 * overflow or channel teardown.
457 EFX_ERR(efx, "TX queue %d saw only %d out of an expected %d "
458 "TX completion events in %s loopback test\n",
459 tx_queue->queue, tx_done, state->packet_count,
462 /* Allow to fall through so we see the RX errors as well */
465 /* We may always be up to a flush away from our desired packet total */
466 if (rx_good != state->packet_count) {
467 EFX_LOG(efx, "TX queue %d saw only %d out of an expected %d "
468 "received packets in %s loopback test\n",
469 tx_queue->queue, rx_good, state->packet_count,
475 /* Update loopback test structure */
476 lb_tests->tx_sent[tx_queue->queue] += state->packet_count;
477 lb_tests->tx_done[tx_queue->queue] += tx_done;
478 lb_tests->rx_good += rx_good;
479 lb_tests->rx_bad += rx_bad;
485 efx_test_loopback(struct efx_tx_queue *tx_queue,
486 struct efx_loopback_self_tests *lb_tests)
488 struct efx_nic *efx = tx_queue->efx;
489 struct efx_loopback_state *state = efx->loopback_selftest;
490 int i, begin_rc, end_rc;
492 for (i = 0; i < 3; i++) {
493 /* Determine how many packets to send */
494 state->packet_count = EFX_TXQ_SIZE / 3;
495 state->packet_count = min(1 << (i << 2), state->packet_count);
496 state->skbs = kzalloc(sizeof(state->skbs[0]) *
497 state->packet_count, GFP_KERNEL);
500 state->flush = false;
502 EFX_LOG(efx, "TX queue %d testing %s loopback with %d "
503 "packets\n", tx_queue->queue, LOOPBACK_MODE(efx),
504 state->packet_count);
506 efx_iterate_state(efx);
507 begin_rc = efx_begin_loopback(tx_queue);
509 /* This will normally complete very quickly, but be
510 * prepared to wait up to 100 ms. */
512 if (!efx_poll_loopback(efx)) {
514 efx_poll_loopback(efx);
517 end_rc = efx_end_loopback(tx_queue, lb_tests);
520 if (begin_rc || end_rc) {
521 /* Wait a while to ensure there are no packets
522 * floating around after a failure. */
523 schedule_timeout_uninterruptible(HZ / 10);
524 return begin_rc ? begin_rc : end_rc;
528 EFX_LOG(efx, "TX queue %d passed %s loopback test with a burst length "
529 "of %d packets\n", tx_queue->queue, LOOPBACK_MODE(efx),
530 state->packet_count);
535 /* Wait for link up. On Falcon, we would prefer to rely on efx_monitor, but
536 * any contention on the mac lock (via e.g. efx_mac_mcast_work) causes it
537 * to delay and retry. Therefore, it's safer to just poll directly. Wait
538 * for link up and any faults to dissipate. */
539 static int efx_wait_for_link(struct efx_nic *efx)
541 struct efx_link_state *link_state = &efx->link_state;
542 int count, link_up_count = 0;
545 for (count = 0; count < 40; count++) {
546 schedule_timeout_uninterruptible(HZ / 10);
548 if (efx->type->monitor != NULL) {
549 mutex_lock(&efx->mac_lock);
550 efx->type->monitor(efx);
551 mutex_unlock(&efx->mac_lock);
553 struct efx_channel *channel = &efx->channel[0];
554 if (channel->work_pending)
555 efx_process_channel_now(channel);
558 mutex_lock(&efx->mac_lock);
559 link_up = link_state->up;
561 link_up = !efx->mac_op->check_fault(efx);
562 mutex_unlock(&efx->mac_lock);
565 if (++link_up_count == 2)
575 static int efx_test_loopbacks(struct efx_nic *efx, struct efx_self_tests *tests,
576 unsigned int loopback_modes)
578 enum efx_loopback_mode mode;
579 struct efx_loopback_state *state;
580 struct efx_tx_queue *tx_queue;
583 /* Set the port loopback_selftest member. From this point on
584 * all received packets will be dropped. Mark the state as
585 * "flushing" so all inflight packets are dropped */
586 state = kzalloc(sizeof(*state), GFP_KERNEL);
589 BUG_ON(efx->loopback_selftest);
591 efx->loopback_selftest = state;
593 /* Test all supported loopback modes */
594 for (mode = LOOPBACK_NONE; mode <= LOOPBACK_TEST_MAX; mode++) {
595 if (!(loopback_modes & (1 << mode)))
598 /* Move the port into the specified loopback mode. */
600 mutex_lock(&efx->mac_lock);
601 efx->loopback_mode = mode;
602 rc = __efx_reconfigure_port(efx);
603 mutex_unlock(&efx->mac_lock);
605 EFX_ERR(efx, "unable to move into %s loopback\n",
610 rc = efx_wait_for_link(efx);
612 EFX_ERR(efx, "loopback %s never came up\n",
617 /* Test both types of TX queue */
618 efx_for_each_channel_tx_queue(tx_queue, &efx->channel[0]) {
619 state->offload_csum = (tx_queue->queue &
620 EFX_TXQ_TYPE_OFFLOAD);
621 rc = efx_test_loopback(tx_queue,
622 &tests->loopback[mode]);
629 /* Remove the flush. The caller will remove the loopback setting */
631 efx->loopback_selftest = NULL;
638 /**************************************************************************
642 *************************************************************************/
644 int efx_selftest(struct efx_nic *efx, struct efx_self_tests *tests,
647 enum efx_loopback_mode loopback_mode = efx->loopback_mode;
648 int phy_mode = efx->phy_mode;
649 enum reset_type reset_method = RESET_TYPE_INVISIBLE;
650 struct efx_channel *channel;
651 int rc_test = 0, rc_reset = 0, rc;
653 /* Online (i.e. non-disruptive) testing
654 * This checks interrupt generation, event delivery and PHY presence. */
656 rc = efx_test_phy_alive(efx, tests);
660 rc = efx_test_nvram(efx, tests);
664 rc = efx_test_interrupts(efx, tests);
668 efx_for_each_channel(channel, efx) {
669 rc = efx_test_eventq_irq(channel, tests);
677 if (!(flags & ETH_TEST_FL_OFFLINE))
678 return efx_test_phy(efx, tests, flags);
680 /* Offline (i.e. disruptive) testing
681 * This checks MAC and PHY loopback on the specified port. */
683 /* force the carrier state off so the kernel doesn't transmit during
684 * the loopback test, and the watchdog timeout doesn't fire. Also put
685 * falcon into loopback for the register test.
687 mutex_lock(&efx->mac_lock);
688 efx->port_inhibited = true;
689 if (efx->loopback_modes) {
690 /* We need the 312 clock from the PHY to test the XMAC
691 * registers, so move into XGMII loopback if available */
692 if (efx->loopback_modes & (1 << LOOPBACK_XGMII))
693 efx->loopback_mode = LOOPBACK_XGMII;
695 efx->loopback_mode = __ffs(efx->loopback_modes);
698 __efx_reconfigure_port(efx);
699 mutex_unlock(&efx->mac_lock);
701 /* free up all consumers of SRAM (including all the queues) */
702 efx_reset_down(efx, reset_method);
704 rc = efx_test_chip(efx, tests);
708 /* reset the chip to recover from the register test */
709 rc_reset = efx->type->reset(efx, reset_method);
711 /* Ensure that the phy is powered and out of loopback
712 * for the bist and loopback tests */
713 efx->phy_mode &= ~PHY_MODE_LOW_POWER;
714 efx->loopback_mode = LOOPBACK_NONE;
716 rc = efx_reset_up(efx, reset_method, rc_reset == 0);
721 EFX_ERR(efx, "Unable to recover from chip test\n");
722 efx_schedule_reset(efx, RESET_TYPE_DISABLE);
726 rc = efx_test_phy(efx, tests, flags);
730 rc = efx_test_loopbacks(efx, tests, efx->loopback_modes);
734 /* restore the PHY to the previous state */
735 mutex_lock(&efx->mac_lock);
736 efx->phy_mode = phy_mode;
737 efx->port_inhibited = false;
738 efx->loopback_mode = loopback_mode;
739 __efx_reconfigure_port(efx);
740 mutex_unlock(&efx->mac_lock);