Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 08 Aug 2026 15:57:59 +0000
From:      Kevin Bowling <kbowling@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 0baf0fabdb5e - main - ix/ixv: Match Tx writeback thresholds to iflib
Message-ID:  <6a775207.3043f.5d69db35@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by kbowling:

URL: https://cgit.FreeBSD.org/src/commit/?id=0baf0fabdb5e60e917458f85706707ee92683080

commit 0baf0fabdb5e60e917458f85706707ee92683080
Author:     Kevin Bowling <kbowling@FreeBSD.org>
AuthorDate: 2026-08-08 11:10:18 +0000
Commit:     Kevin Bowling <kbowling@FreeBSD.org>
CommitDate: 2026-08-08 15:55:45 +0000

    ix/ixv: Match Tx writeback thresholds to iflib
    
    PTHRESH controls when the device prefetches transmit descriptors,
    HTHRESH controls how many host descriptors must be ready, and WTHRESH
    controls completion writeback batching.
    
    iflib places RS on selected descriptors and reclaims through those
    checkpoints.  The data sheets require WTHRESH to be zero when software
    uses RS.  Clear WTHRESH while retaining the established PTHRESH 32 and
    HTHRESH 1 fetch policy.
    
    This also follows DPDK in pairing sparse RS descriptors with
    WTHRESH zero.  DPDK defaults to 32/0/0, while Linux ixgbevf uses
    32/1/8.  The 32/1/0 setting preserves FreeBSD's prefetch policy and the
    data-sheet requirement that HTHRESH be nonzero when PTHRESH is used.
    
    MFC after:      2 weeks
---
 sys/dev/ixgbe/if_ix.c  | 10 ++++------
 sys/dev/ixgbe/if_ixv.c |  4 ++--
 sys/dev/ixgbe/ixgbe.h  |  8 ++++++++
 3 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/sys/dev/ixgbe/if_ix.c b/sys/dev/ixgbe/if_ix.c
index 1aa6c039ad74..545516cb7372 100644
--- a/sys/dev/ixgbe/if_ix.c
+++ b/sys/dev/ixgbe/if_ix.c
@@ -4009,17 +4009,15 @@ ixgbe_if_init(if_ctx_t ctx)
 		struct tx_ring *txr = &tx_que->txr;
 
 		txdctl = IXGBE_READ_REG(hw, IXGBE_TXDCTL(txr->me));
-		txdctl |= IXGBE_TXDCTL_ENABLE;
-		/* Set WTHRESH to 8, burst writeback */
-		txdctl |= (8 << 16);
+		txdctl &= ~IXGBE_TXDCTL_THRESH_MASK;
+		txdctl |= IXGBE_TXDCTL_ENABLE | IXGBE_TXDCTL_THRESH_DEFAULT;
 		/*
 		 * When the internal queue falls below PTHRESH (32),
 		 * start prefetching as long as there are at least
-		 * HTHRESH (1) buffers ready. The values are taken
-		 * from the Intel linux driver 3.8.21.
+		 * HTHRESH (1) buffers ready.  Leave WTHRESH at zero
+		 * so that writeback follows iflib's sparse RS bits.
 		 * Prefetching enables tx line rate even with 1 queue.
 		 */
-		txdctl |= (32 << 0) | (1 << 8);
 		IXGBE_WRITE_REG(hw, IXGBE_TXDCTL(txr->me), txdctl);
 	}
 
diff --git a/sys/dev/ixgbe/if_ixv.c b/sys/dev/ixgbe/if_ixv.c
index ae7f1a64babb..f9e58ecf5877 100644
--- a/sys/dev/ixgbe/if_ixv.c
+++ b/sys/dev/ixgbe/if_ixv.c
@@ -1349,9 +1349,9 @@ ixv_initialize_transmit_units(if_ctx_t ctx)
 		u32 txctrl, txdctl;
 		int j = txr->me;
 
-		/* Set WTHRESH to 8, burst writeback */
 		txdctl = IXGBE_READ_REG(hw, IXGBE_VFTXDCTL(j));
-		txdctl |= (8 << 16);
+		txdctl &= ~IXGBE_TXDCTL_THRESH_MASK;
+		txdctl |= IXGBE_TXDCTL_THRESH_DEFAULT;
 		IXGBE_WRITE_REG(hw, IXGBE_VFTXDCTL(j), txdctl);
 
 		/* Set the HW Tx Head and Tail indices */
diff --git a/sys/dev/ixgbe/ixgbe.h b/sys/dev/ixgbe/ixgbe.h
index 7c3f2aee7216..347a4d4974bd 100644
--- a/sys/dev/ixgbe/ixgbe.h
+++ b/sys/dev/ixgbe/ixgbe.h
@@ -121,6 +121,14 @@
 /* Alignment for rings */
 #define DBA_ALIGN		128
 
+/*
+ * iflib uses the RS bit to select the descriptors whose status it polls.
+ * Keep WTHRESH zero so the hardware honors RS, and retain the driver's
+ * established descriptor-prefetch settings.
+ */
+#define IXGBE_TXDCTL_THRESH_MASK		0x007f7f7f
+#define IXGBE_TXDCTL_THRESH_DEFAULT	((32 << 0) | (1 << 8))
+
 /*
  * This is the max watchdog interval, ie. the time that can
  * pass between any two TX clean operations, such only happening


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a775207.3043f.5d69db35>