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_tx_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_rx_loopback(struct efx_tx_queue *tx_queue,
453 struct efx_loopback_self_tests *lb_tests)
455 struct efx_nic *efx = tx_queue->efx;
456 struct efx_selftest_state *state = efx->loopback_selftest;
458 int tx_done = 0, rx_good, rx_bad;
461 if (efx_dev_registered(efx))
462 netif_tx_lock_bh(efx->net_dev);
464 /* Count the number of tx completions, and decrement the refcnt. Any
465 * skbs not already completed will be free'd when the queue is flushed */
466 for (i=0; i < state->packet_count; i++) {
467 skb = state->skbs[i];
468 if (skb && !skb_shared(skb))
470 dev_kfree_skb_any(skb);
473 if (efx_dev_registered(efx))
474 netif_tx_unlock_bh(efx->net_dev);
476 /* Check TX completion and received packet counts */
477 rx_good = atomic_read(&state->rx_good);
478 rx_bad = atomic_read(&state->rx_bad);
479 if (tx_done != state->packet_count) {
480 /* Don't free the skbs; they will be picked up on TX
481 * overflow or channel teardown.
483 EFX_ERR(efx, "TX queue %d saw only %d out of an expected %d "
484 "TX completion events in %s loopback test\n",
485 tx_queue->queue, tx_done, state->packet_count,
488 /* Allow to fall through so we see the RX errors as well */
491 /* We may always be up to a flush away from our desired packet total */
492 if (rx_good != state->packet_count) {
493 EFX_LOG(efx, "TX queue %d saw only %d out of an expected %d "
494 "received packets in %s loopback test\n",
495 tx_queue->queue, rx_good, state->packet_count,
501 /* Update loopback test structure */
502 lb_tests->tx_sent[tx_queue->queue] += state->packet_count;
503 lb_tests->tx_done[tx_queue->queue] += tx_done;
504 lb_tests->rx_good += rx_good;
505 lb_tests->rx_bad += rx_bad;
511 efx_test_loopback(struct efx_tx_queue *tx_queue,
512 struct efx_loopback_self_tests *lb_tests)
514 struct efx_nic *efx = tx_queue->efx;
515 struct efx_selftest_state *state = efx->loopback_selftest;
516 struct efx_channel *channel;
519 for (i = 0; i < loopback_test_level; i++) {
520 /* Determine how many packets to send */
521 state->packet_count = (efx->type->txd_ring_mask + 1) / 3;
522 state->packet_count = min(1 << (i << 2), state->packet_count);
523 state->skbs = kzalloc(sizeof(state->skbs[0]) *
524 state->packet_count, GFP_KERNEL);
529 EFX_LOG(efx, "TX queue %d testing %s loopback with %d "
530 "packets\n", tx_queue->queue, LOOPBACK_MODE(efx),
531 state->packet_count);
533 efx_iterate_state(efx);
534 tx_rc = efx_tx_loopback(tx_queue);
536 /* NAPI polling is not enabled, so process channels synchronously */
537 schedule_timeout_uninterruptible(HZ / 50);
538 efx_for_each_channel_with_interrupt(channel, efx) {
539 if (channel->work_pending)
540 efx_process_channel_now(channel);
543 rx_rc = efx_rx_loopback(tx_queue, lb_tests);
546 if (tx_rc || rx_rc) {
547 /* Wait a while to ensure there are no packets
548 * floating around after a failure. */
549 schedule_timeout_uninterruptible(HZ / 10);
550 return tx_rc ? tx_rc : rx_rc;
554 EFX_LOG(efx, "TX queue %d passed %s loopback test with a burst length "
555 "of %d packets\n", tx_queue->queue, LOOPBACK_MODE(efx),
556 state->packet_count);
561 static int efx_test_loopbacks(struct efx_nic *efx,
562 struct efx_self_tests *tests,
563 unsigned int loopback_modes)
565 struct efx_selftest_state *state = efx->loopback_selftest;
566 struct ethtool_cmd ecmd, ecmd_loopback;
567 struct efx_tx_queue *tx_queue;
568 enum efx_loopback_mode old_mode, mode;
569 int count, rc = 0, link_up;
571 rc = efx_ethtool_get_settings(efx->net_dev, &ecmd);
573 EFX_ERR(efx, "could not get GMII settings\n");
576 old_mode = efx->loopback_mode;
578 /* Disable autonegotiation for the purposes of loopback */
579 memcpy(&ecmd_loopback, &ecmd, sizeof(ecmd_loopback));
580 if (ecmd_loopback.autoneg == AUTONEG_ENABLE) {
581 ecmd_loopback.autoneg = AUTONEG_DISABLE;
582 ecmd_loopback.duplex = DUPLEX_FULL;
583 ecmd_loopback.speed = SPEED_10000;
586 rc = efx_ethtool_set_settings(efx->net_dev, &ecmd_loopback);
588 EFX_ERR(efx, "could not disable autonegotiation\n");
591 tests->loopback_speed = ecmd_loopback.speed;
592 tests->loopback_full_duplex = ecmd_loopback.duplex;
594 /* Test all supported loopback modes */
595 for (mode = LOOPBACK_NONE; mode < LOOPBACK_TEST_MAX; mode++) {
596 if (!(loopback_modes & (1 << mode)))
599 /* Move the port into the specified loopback mode. */
601 efx->loopback_mode = mode;
602 efx_reconfigure_port(efx);
604 /* Wait for the PHY to signal the link is up */
607 struct efx_channel *channel = &efx->channel[0];
609 falcon_check_xmac(efx);
610 schedule_timeout_uninterruptible(HZ / 10);
611 if (channel->work_pending)
612 efx_process_channel_now(channel);
613 /* Wait for PHY events to be processed */
614 flush_workqueue(efx->workqueue);
617 /* efx->link_up can be 1 even if the XAUI link is down,
618 * (bug5762). Usually, it's not worth bothering with the
619 * difference, but for selftests, we need that extra
620 * guarantee that the link is really, really, up.
622 link_up = efx->link_up;
623 if (!falcon_xaui_link_ok(efx))
626 } while ((++count < 20) && !link_up);
628 /* The link should now be up. If it isn't, there is no point
629 * in attempting a loopback test */
631 EFX_ERR(efx, "loopback %s never came up\n",
637 EFX_LOG(efx, "link came up in %s loopback in %d iterations\n",
638 LOOPBACK_MODE(efx), count);
640 /* Test every TX queue */
641 efx_for_each_tx_queue(tx_queue, efx) {
642 state->offload_csum = (tx_queue->queue ==
643 EFX_TX_QUEUE_OFFLOAD_CSUM);
644 rc |= efx_test_loopback(tx_queue,
645 &tests->loopback[mode]);
652 /* Take out of loopback and restore PHY settings */
654 efx->loopback_mode = old_mode;
655 efx_ethtool_set_settings(efx->net_dev, &ecmd);
660 /**************************************************************************
664 *************************************************************************/
666 /* Online (i.e. non-disruptive) testing
667 * This checks interrupt generation, event delivery and PHY presence. */
668 int efx_online_test(struct efx_nic *efx, struct efx_self_tests *tests)
670 struct efx_channel *channel;
673 EFX_LOG(efx, "performing online self-tests\n");
675 rc |= efx_test_interrupts(efx, tests);
676 efx_for_each_channel(channel, efx) {
677 if (channel->has_interrupt)
678 rc |= efx_test_eventq_irq(channel, tests);
680 rc |= efx_test_eventq(channel, tests);
682 rc |= efx_test_phy(efx, tests);
685 EFX_ERR(efx, "failed online self-tests\n");
690 /* Offline (i.e. disruptive) testing
691 * This checks MAC and PHY loopback on the specified port. */
692 int efx_offline_test(struct efx_nic *efx,
693 struct efx_self_tests *tests, unsigned int loopback_modes)
695 struct efx_selftest_state *state;
698 EFX_LOG(efx, "performing offline self-tests\n");
700 /* Create a selftest_state structure to hold state for the test */
701 state = kzalloc(sizeof(*state), GFP_KERNEL);
707 /* Set the port loopback_selftest member. From this point on
708 * all received packets will be dropped. Mark the state as
709 * "flushing" so all inflight packets are dropped */
710 BUG_ON(efx->loopback_selftest);
712 efx->loopback_selftest = state;
714 rc = efx_test_loopbacks(efx, tests, loopback_modes);
716 efx->loopback_selftest = NULL;
722 EFX_ERR(efx, "failed offline self-tests\n");