12/05/2022 19:01, Jeff Daly: > From: Thomas Monjalon <tho...@monjalon.net> > > 11/05/2022 13:43, Zhang, Qi Z: > > > From: Jeff Daly <je...@silicom-usa.com> > > > > > > > > 1ca05831b9b added a check that SDP3 (used as a TX_DISABLE output to > > > > the SFP cage on these cards) is not asserted to avoid incorrectly > > > > reporting link up when the SFP's laser is turned off. > > > > > > > > ff8162cb957 limited this workaround to fiber ports > > > > > > > > This patch: > > > > * Adds devarg 'fiber_sdp3_no_tx_disable' not all fiber ixgbe devs use > > > > SDP3 as TX_DISABLE > > > > > > > > Fixes: 1ca05831b9b ("net/ixgbe: fix link status") > > > > Fixes: ff8162cb957 ("net/ixgbe: fix link status") > > > > Cc: sta...@dpdk.org > > > > > > > > Signed-off-by: Jeff Daly <je...@silicom-usa.com> > > > > > > Acked-by: Qi Zhang <qi.z.zh...@intel.com> > > > > > > Applied to dpdk-next-net-intel. > > > > There is a lack of context in this description. > > I don't know what SDP3 and TX_DISABLE refers to. > > Please make more complete sentences, thanks. > > > > I don't want to sound obtuse here, but this is a fix to a specific Intel NIC > driver. Any symbols or abbreviations or definitions used in a device driver > are almost always in the manual. While SDP3 means something specific to the > Intel 82599 and X550 (and probably others), it probably doesn't appear in a > driver from Marvell for example. So, in this case [S]oftware [D]efined > [P]ins [3] (out of 0-3) is specifically talking about the Intel X550. I'm > familiar enough with the hardware to recognize that, but if I was to look at > a Marvell driver and saw something I didn't recognize like that, I'd be > checking the Marvell manual.
Of course we can spend hours checking code and manuals. But if we need to look to a lot of commits, it is a lot more convenient to have a summary of this information in the commit log. > What I'm describing here is the fact that the TX_DISABLE signal (a signal > defined in the SFP spec) from the NIC as implemented by the Software Defined > Pin (3) by many (most?) implementations that are using this Intel driver, is > not specifically the *only* use of SDP3. A later patch limited the check > (correctly) to fiber implementations (which is the only thing that makes > sense), and *this* patch adds a module switch for platforms to disable this > check in the event that they (as they are perfectly allowed to) don't use > SDP3 as TX_DISABLE. Thank you for the explanation.