Release Note for Napatech Link™ Software Driver Version 3.24.1
Release date
2021-04-28
Description
This release note applies to driver package nt_driver_3gd-linux-3.24.1
Release history from version 3.23.3 to 3.24.1
New Features
| ID | Customer tracking number | Summary | Implemented in |
|---|---|---|---|
| 44154 | 43773 / 43855 (Supp) | Support for FPGA images 9537-44-11 and 9538-44-11 added | 3.24.1 |
| 44143 | 44141 / 43655 (FR) | Support for up to Linux kernel version 5.11 has been added | 3.24.1 |
| 44105 | 44055 (FR) | When calling the NT_NetFileOpen_v2 function with the 'noConvert' parameter equal to False (i.e, request automatic conversion of PCAP packets) to read a file containing PCAP packets with PCAP-NANO timestamps, the Napatech library silently discards the nanosecond precision and converts the timestamps to 10-nanosecond precision. | 3.24.1 |
| 44072 | 43637 (FR) | Added option in ntservice.ini to configure inclusion of Ethernet FCS when capturing with PCAP descriptor on 4GArch cards supporting that capability. | 3.23.7 |
| 44064 | Support for new FPGA: 200-9554 4*10/25G, Test & Measurement & 200-9560 4*1/10G, Test & Measurement for NT100A01 | 3.24.0 | |
| 44043 | 43895, 43981 (Sup) |
Driver support added for FPGA-image v35-25 of these image IDs:
NT200A02: 9532, 9533, 9534, 9545, 9549, 9555 NT50B01: 9541 NT100A01: 9553, 9559 NT200A01: 9531 |
3.23.6 |
| 43925 | 43895 (Support) | Driver support added for FPGA-image 9541-35-23 | 3.23.4 |
| 43753 | 43750 (Support) | New feature, %s placeholder for PtpStatusLogFile, added | 3.23.6 |
Resolved Issues
| ID | Customer tracking number | Summary | Found in version | Resolved in version |
|---|---|---|---|---|
| 44135 | 44119 (Support) | When using NT_ConfigRead the driver may return and "unknown error", even for a well-defined command parameter. | 3.23.1 | 3.24.1 |
| 44131 | 44081 (Support) | ~64ns difference in timestamping on 100G between NT200A02 vs NT200A01. | 3.23.1 | 3.24.1 |
| 44121 | 43968 (Support) | Using the NT_InfoRead function with a TIMESYNC_STAT command and specifying an input argument "adapter number" that is out of range or a high number (>16) may lead to undefined behavior or crash the driver. The driver should validate the adapter number and return an out-of-range error if the number is invalid. | 3.23.1 | 3.24.1 |
| 44076 | 44070 (Support) | pps_os does not work when skew is negative. | 3.23.0 | 3.24.1 |
| 44046 | 44032 (Support) | When an oversized PCAP packet is read using NT_NetFileRead, it is not possible to read anymore packets from the file. Should instead move ahead to the next properly sized PCAP packet. | 3.23.3 | 3.24.0 |
| 43960 | 43937 (Support) | Ethernet FCS is erroneously included in the capture file when using PCAP timestamp | 3.23.3 | 3.23.6 |
| 43868 | Auto negotiation is not fully supported on electrical modules on NT100A01 and NT200A02. | 3.23.3 | 3.24.0 | |
| 43862 | When an electrical port is disabled, the link remains up at link partner | 3.23.3 | 3.24.0 | |
| 43861 | When an electrical port is disabled, an error is returned and the link remains up at link partner | 3.23.3 | 3.24.0 | |
| 43807 | It is not possible to properly change the port speed on NT100A01 9559 with the config tool. However, it is possible to change the port speed with the PortSpeedMultiRate setting in ntservice.ini. | 3.23.2 | 3.24.0 |
Known issues
| ID | Customer tracking number | Summary | Found in version |
|---|---|---|---|
| 43621 | TX is not properly disabled on all ports when enabling host-loopback while using DAC cables, resulting in packets being transmitted from the adapter. | 3.21.3 | |
| 42948 | Frequent CRC errors when using DAC cables shorter than 1 meter. | 3.13.3 | |
| 42936 | The link diode extinguishes when the port is disabled as it should, but lights up again when the module is unplugged and reinserted with the port still disabled. No link is up. But the diode lights up as if there is. Status is read correct from software. | 3.13.3 | |
| 42653 | 42616 (fix) |
When using host loopback on NT200A01 without any NIMs plugged in, it is not possible to get link on a QSFP28-LR4 NIM inserted afterwards unless FEC has been disabled (for SR modules) in the ini file
Workaround: If QSFP28-LR module is to be used then either plug it in before start-up of the system or set DisableFEC=TRUE in ntsevice.ini |
3.11.1 |
| 42652 | 42616 (fix) |
FEC cannot be changed dynamically on NT200A01, if traffic has been applied. Hence, it is not possible to dynamically swap between SR and LR QSFP28 if unless FEC has been disabled for SR modules in the ini file
Workaround: If QSFP28-LR module is to be used then either plug it in before start-up of the system or set DisableFEC=TRUE in ntsevice.ini |
3.11.1 |
| 42257 |
Dynamic hostbuffers are not supported by Intel PAC A10 accelerators.
Therefore NTAPI Inline features are not supported by Intel PAC A10 accelerators. Workaround: Applications using DPDK will support Inline for Intel PAC A10 accelerators. |
3.9.1 | |
| 41150 | The Automatic over-temperature shutdown will only stop NT service, it cannot shutdown the Intel Programmable Acceleration Card Blue bitstream. | 3.9.0 | |
| 38699 |
Using NT_NetRxGet* or NT_NetRxGetMult* first time on newly created or reconfigured streams can lead to initial package drops when the system is configured with large hostbuffers or many client applications.
This will only be triggered on newly created and reconfigured streams. Workaround: If packet loss is observed, to get clean statistics no traffic should be received on connected ports while streams are being started. |
3.7.5 | |
| 32765 | When using the GlobalSync feature, link down/up events causes the port to enter 'unknown' state | 2.9.4 | |
| 14086 |
If NUMA node zero is offline and /opt/napatech3/config/ntservice.ini does not exist, the driver cannot start because it fails to allocate memory for the default host buffer set-up.
Workaround: Use an existing ntservice.ini or specify the host buffer set-up on an online NUMA node: '/opt/napatech3/bin/start.sh -o adapter0.BusId=0000:04:00.0 -o adapter0.AdapterType=NT40E3_4_PTP -o adapter0.HostBuffersRx=[4,32,1] -o adapter0.HostBuffersTx=[2,16,1]'. BusId and AdapterType are only required if there are multiple adapters in the server; the BusId can be obtained with 'lspci | grep Napa'. |
2.8.5 | |
| 10740 | When using a Cisco DAC pluggable, link is detected even if the other end of the cable is unplugged. | 2.7.0 | |
| 9189 | 9137 (Support) |
The Linux kernel v3.8->v3.12 has a bug in the NUMA balancing code which was introduced in v3.8. See https://bugzilla.kernel.org/show_bug.cgi?id=60734
The issue causes high execution delays on cores running on other than NUMA 0 if the feature is enabled. To work around the problem, disable the NUMA balancing by adding "numa_balancing=disable" to the kernel command line. The Linux kernel 3.13 received significant NUMA updates which fixes this issue. The 3.10 kernel in RHEL 7, CentOS 7 and Oracle Linux 7 (not the 3.8.13 uek kernel) contains a fix for this, thus the work around is not needed. |
0.1.1 |
| 8719 | Setting TimeSyncTimeJumpThreshold for OS timesync to values > 0, will enable the time jump feature and results in a jump threshold of 1 second. | 2.4.1 | |
| 4324 | 3GD requires at least gcc 4.0 to build and at least glibc 2.5 to run. | 1.1.0 |
Notes
Operating systems
The Napatech driver version applies to these operating systems:
- Linux 3.0 -> 3.19 (64-bit)
- Linux 4.0 -> 4.18 (64-bit)
- Linux 5.0 -> 5.11 (64-bit)
The software has been qualified on: CentOS 7 and CentOS 8
Hardware and FPGA image compatibility
| Hardware | 4GA FPGA images |
|---|---|
| NT20E3-2-PTP | 200-9501-02-16, 200-9501-04-04, 200-9501-06-06, 200-9501-08-06, 200-9501-09-08, 200-9501-10-07, 200-9501-15-02, 200-9501-17-02, 200-9501-18-07, 200-9501-22-05, 200-9501-27-03, 200-9501-28-07 |
| NT40E3-4-PTP | 200-9502-02-16, 200-9502-04-04, 200-9502-06-06, 200-9502-06-07, 200-9502-08-06, 200-9502-08-07, 200-9502-08-08, 200-9502-09-08, 200-9502-10-07, 200-9537-22-06, 200-9537-28-07, 200-9537-44-11, 200-9538-34-09, 200-9538-44-11, 200-8011-22-02 |
| NT80E3-2-PTP | 200-9503-02-16, 200-9503-04-04, 200-9503-06-05, 200-9503-08-06, 200-9503-08-07, 200-9503-08-08, 200-9503-09-08, 200-9503-10-07, 200-9503-10-09, 200-9503-15-02, 200-9503-17-02, 200-9503-18-07, 200-9503.20.04, 200-9503-22-05, 200-9503-22-08, 200-9503-28-07, 200-9519-10-05, 200-9519-10-07, 200-9519-15-02, 200-9519-17-02, 200-9519-18-07, 200-9519-22-05, 200-9519-22-07, 200-9519-28-07, 200-8005-10-01, 200-8005-15-02, 200-8005-17-02, 200-8005-22-00 |
| NT200A01 | 200-9508-05-08, 200-9508-05-17, 200-9508-06-06, 200-9508-07-06, 200-9508-07-07, 200-9515-10-07, 200-9515-15-02, 200-9515-18-09, 200-9515-20-04, 200-9515-20-06, 200-9515-20-10, 200-9516-10-07, 200-9516-15-05, 200-9516-18-09, 200-9516-20-04, 200-9516-20-06, 200-9516-20-10, 200-9531-20-12, 200-9531-28-08, 200-9531-35-25, 200-8002-09-01, 200-8002-09-02, 200-8002-09-04, 200-8002-10-02, 200-8002-15-02, 200-8002-20-01, 200-9512-07-02, 200-9512-08-08, 200-9512-08-09, 200-9512-09-08, 200-9512-10-07, 200-9512-15-02, 200-9512-18-07, 200-9512-20-04, 200-9512-22-05, 200-9512-22-07, 200-9512-28-07, 200-9522-15-03, 200-9522-18-07, 200-9522-20-04, 200-9522-22-05, 200-9522-22-07, 200-9522-28-07, 200-8001-08-00, 200-8001-08-01, 200-8003-09-01, 200-8003-09-03, 200-8003-10-02, 200-8003-15-02, 200-8003-22-00, 200-8004-10-03, 200-8004-15-02, 200-8004-22-00, 200-8006-15-03, 200-8006-22-00, 200-8010-20-02 |
| NT40A01-4x1 | 200-9500-06-07, 200-9500-06-07, 200-9500-08-06, 200-9500-09-08, 200-9500-10-07, 200-9500-15-02, 200-9500-18-07, 200-9500-22-05, 200-9500-27-02, 200-9500-28-07 |
| NT100E3-1-PTP | 200-9504-01-12, 200-9505-02-16, 200-9505-04-04, 200-9505-06-05, 200-9505-08-06, 200-9505-08-07, 200-9505-09-08, 200-9505-10-08, 200-9505-10-09, 200-9505-15-02, 200-9505-18-07, 200-9505-20-05, 200-9505-20-07, 200-9505-28-07 |
| NT40A01 | 200-9517-09-08 |
| INTEL-A10 | 200-7000-12-00, 200-7000-12-02, 200-7000-12-06, 200-7000-22-05, 200-7000-27-02, 200-7000-28-07, 200-7001-12-00, 200-7001-12-03, 200-7001-12-06, 200-7001-22-05, 200-7001-27-02, 200-7001-28-07 |
| NT200A02 | 200-9521-18-11, 200-9521-20-04, 200-9521-22-05, 200-9521-27-03, 200-9521-28-07, 200-9521-41-04, 200-9521-43-11, 200-9526-18-10, 200-9526-20-04, 200-9526-22-05, 200-9526-27-03, 200-9526-28-07, 200-9526-41-04, 200-9526-43-11, 200-9532-27-00, 200-9532-27-02, 200-9532-27-03, 200-9532-28-08, 200-9532-35-25, 200-9532-43-11, 200-9533.20.04, 200-9533-22-05, 200-9533-27-03, 200-9533-28-07, 200-9533-35-25, 200-9533-43-11, 200-9534-21-28, 200-9534-28-07, 200-9534-35-25, 200-9535-21-28, 200-9535-28-07, 200-9536-37-00, 200-9539-23-00, 200-9539-23-01, 200-9540-23-00, 200-9540-23-01, 200-9543-28-07, 200-9543-44-10, 200-9545-28-08, 200-9545-35-25, 200-9545-44-10, 200-9546-28-07, 200-9546-44-10, 200-9549-31-03, 200-9549-35-25, 200-9549-43-11, 200-9555-32-10, 200-9555-35-20, 200-9555-35-25, 200-9555-43-11, 200-8007-22-00, 200-8008-22-00, 200-8009-22-00 |
| NT50B01 | 200-9541-35-20, 200-9541-35-23, 200-9541-35-24, 200-9541-35-25 |
| NT100A01 | 200-9553-35-20, 200-9553-35-25, 200-9554-44-10, 200-9559-35-20, 200-9559-35-25, 200-9560-44-10 |
| Hardware | 3GA FPGA images |
|---|---|
| NT4E | 200-9015-42-08, 200-9015-42-13, 200-9015-42-14 |
| NT4E-STD | 200-9017-42-09, 200-9017-42-10 |
| NT4E-INL | 200-9115-42-13 |
| NT4E2-4-PTP | 200-9226-46-12, 200-9226-46-13, 200-9226-48-05, 200-9226-50-03, 200-9226-50-04, 200-9226-51-03, 200-9226-51-04 |
| NT20E2 | 200-9220-44-10, 200-9220-44-12, 200-9220-45-06, 200-9220-46-09, 200-9220-47-03, 200-9220-50-03, 200-9220-50-04, 200-9220-50-05 |
| NT20E2-PTP | 200-9227-50-03, 200-9227-51-03, 200-9227-51-04 |
| NT20E3-2-PTP | 200-9233-52-13, 200-9233-53-01 |
| NT40E3-4-PTP | 200-9232-50-04, 200-9232-51-04, 200-9232-51-07, 200-9232-52-13, 200-9232-53-01 |
| NT40E2-1 | 200-9222-52-05 |
| NT40E2-4 | 200-9221-44-13, 200-9221-50-04 |
Microcontroller compatibility
Test status
Complete test plan
Documentation
See the Documentation Portal, WebHelp or DN-0449 for reference documentation on Napatech Software Suite.
Release note generated at
2021-04-28