32. ICE Support Rx Timestamp

32.1. Description

The PF driver is able to enable rx timestamp offload, the 64 bits timestamp is able to extracted from the flexible Rx descriptor and be stored in mbuf’s dynamic field. The received packets have timestamp values, and the timestamp values are incremented.

32.2. Prerequisites

32.2.1. Topology

DUT port 0 <—-> Tester port 0

32.2.2. Hardware

Supported NICs: Intel® Ethernet 800 Series E810-XXVDA4/E810-CQ

32.2.4. General Set Up

  1. Compile DPDK:

    # CC=gcc meson --werror -Denable_kmods=True -Dlibdir=lib --default-library=static <dpdk build dir>
# ninja -C <dpdk build dir> -j 110

  2. Get the pci device id and interface of DUT and tester. For example, 0000:3b:00.0 and 0000:3b:00.1 is pci device id, ens785f0 and ens785f1 is interface:

    <dpdk dir># ./usertools/dpdk-devbind.py -s

0000:3b:00.0 'Device 159b' if=ens785f0 drv=ice unused=vfio-pci
0000:3b:00.1 'Device 159b' if=ens785f1 drv=ice unused=vfio-pci

  3. Bind the DUT port to dpdk:

    <dpdk dir># ./usertools/dpdk-devbind.py -b vfio-pci <DUT port pci device id>

32.3. Test Case

32.3.1. Common Steps

All the packets in this test plan use below settings: dst mac: 68:05:CA:C1:BA:28 ipv4 src: 192.168.0.2 ipv4 dst: 192.168.0.3 ipv6 src: 2001::2 ipv6 dst: 2001::3 sport: 1026 dport: 1027 count: 3

  1. Set fwd engine:

    testpmd> set fwd rxonly

  2. Set verbose:

    testpmd> set verbose 1

  3. Start testpmd:

    testpmd> start

  4. Send ether packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/("X"*480)], iface="<tester interface>",count=<count>)

  5. Send ipv4 packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IP(src="<ipv4 src>",dst="<ipv4 dst>")/("X"*480)], iface="<tester interface>",count=<count>)

  6. Send ipv6 packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IPv6(src="<ipv6 src>",dst="<ipv6 dst>")/("X"*480)], iface="<tester interface>",count=<count>)

  7. Send ipv4-udp packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IP(src="<ipv4 src>",dst="<ipv4 dst>")/UDP(sport=<sport>, dport=<dport>)/("X"*480)], iface="<tester interface>",count=<count>)

  8. Send ipv6-udp packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IPv6(src="<ipv6 src>",dst="<ipv6 dst>")/UDP(sport=<sport>, dport=<dport>)/("X"*480)], iface="<tester interface>",count=<count>)

  9. Send ipv4-tcp packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IP(src="<ipv4 src>",dst="<ipv4 dst>")/TCP(sport=<sport>, dport=<dport>)/("X"*480)], iface="<tester interface>",count=<count>)

  10. Send ipv6-tcp packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IPv6(src="<ipv6 src>",dst="<ipv6 dst>")/TCP(sport=<sport>, dport=<dport>)/("X"*480)], iface="<tester interface>",count=<count>)

  11. Send ipv4-sctp packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IP(src="<ipv4 src>",dst="<ipv4 dst>")/SCTP(sport=<sport>, dport=<dport>)/("X"*480)], iface="<tester interface>",count=<count>)

  12. Send ipv6-sctp packets, record the timestamp values and check the timestamp values are incremented:

    >>> sendp([Ether(dst="<dst mac>")/IPv6(src="<ipv6 src>",dst="<ipv6 dst>")/SCTP(sport=<sport>, dport=<dport>)/("X"*480)], iface="<tester interface>",count=<count>)

32.3.2. Test Case 1: Without timestamp, check no timestamp

This case is designed to check no timestamp value while testpmd not enable rx timestamp.

32.3.2.1. Test Steps

  1. Start testpmd with different command line:

    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c f -n 4 -a 3b:00.0 -- -i --rxq=16 --txq=16

  2. Send packets as common steps, check no timestamp value.

32.3.3. Test Case 2: Single queue With timestamp, check timestamp

This case is designed to check single queue has timestamp values and the timestamp values are incremented.

32.3.3.1. Test Steps

  1. Start testpmd with different command line:

    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c f -n 4 -a 3b:00.0 -- -i --enable-rx-timestamp

  2. Send packets as common steps, check single queue has timestamp values and the timestamp values are incremented.

    testpmd> port 0/queue 0: received 1 packets src=00:00:00:02:00:00 - dst=68:05:CA:C1:BA:28 - type=0x9000 - length=494 - nb_segs=1 - timestamp 1663643637602717932 - hw ptype: L2_ETHER - sw ptype: L2_ETHER - l2_len=14 - Receive queue=0x0 ol_flags: RTE_MBUF_F_RX_L4_CKSUM_UNKNOWN RTE_MBUF_F_RX_IP_CKSUM_UNKNOWN RTE_MBUF_F_RX_OUTER_L4_CKSUM_UNKNOWN port 0/queue 0: received 1 packets src=00:00:00:02:00:00 - dst=68:05:CA:C1:BA:28 - type=0x9000 - length=494 - nb_segs=1 - timestamp 1663643637602871904 - hw ptype: L2_ETHER - sw ptype: L2_ETHER - l2_len=14 - Receive queue=0x0 ol_flags: RTE_MBUF_F_RX_L4_CKSUM_UNKNOWN RTE_MBUF_F_RX_IP_CKSUM_UNKNOWN RTE_MBUF_F_RX_OUTER_L4_CKSUM_UNKNOWN port 0/queue 0: received 1 packets src=00:00:00:02:00:00 - dst=68:05:CA:C1:BA:28 - type=0x9000 - length=494 - nb_segs=1 - timestamp 1663643637603018449 - hw ptype: L2_ETHER - sw ptype: L2_ETHER - l2_len=14 - Receive queue=0x0 ol_flags: RTE_MBUF_F_RX_L4_CKSUM_UNKNOWN RTE_MBUF_F_RX_IP_CKSUM_UNKNOWN RTE_MBUF_F_RX_OUTER_L4_CKSUM_UNKNOWN

32.3.4. Test Case 3: Multi queues With timestamp, check timestamp

This case is designed to check multi queues have timestamp values and the timestamp values are incremented.

32.3.4.1. Test Steps

  1. Start testpmd with different command line:

    ./x86_64-native-linuxapp-gcc/app/dpdk-testpmd -c f -n 4 -a 3b:00.0 -- -i --rxq=16 --txq=16 --enable-rx-timestamp

  2. Send packets as common steps, check multi queues have timestamp values and the timestamp values are incremented.