53. Intel® Ethernet 700 Series DDP GTP-C/GTP-U Tests

Intel® Ethernet 700 Series supports DDP (Dynamic Device Personalization) to program analyzer/parser via AdminQ. Profile can be used to update Intel® Ethernet 700 Series configuration tables via MMIO configuration space, not microcode or firmware itself. For microcode/FW changes new HW/FW/NVM image must be uploaded to the NIC. Profiles will be stored in binary files and need to be passed to AQ to program Intel® Ethernet 700 Series during initialization stage.

GPRS Tunneling Protocol (GTP) is a group of IP-based communications protocols used to carry general packet radio service (GPRS) within GSM, UMTS and LTE networks. GTP can be decomposed into separate protocols, GTP-C, GTP-U. With DDP, new types GTP-C/GTP-U tunnels can be supported. To make it scalable it is preferable to use DDP API to get information about new PCTYPE/PTYPEs defined a profile, instead of hardcoding i40e PCTYPE/PTYPE mapping to DPDK FlowType/PacketType.

Below features have be enabled for GTP-C/GTP-U:

  1. FDIR for GTP-C/GTP-U to direct different TEIDs to different queues
  2. Tunnel filters for GTP-C/GTP-U to direct different TEIDs to different VFs

53.1. Prerequisites

  1. Host PF in DPDK driver:

    ./tools/dpdk-devbind.py -b igb_uio 81:00.0

  2. Create 1 VF from 1 PF with DPDK driver:

    echo 1 > /sys/bus/pci/devices/0000:81:00.0/max_vfs

  3. Detach VF from the host:

    rmmod iavf

  4. Pass through VF 81:10.0 to vm0, start vm0.

  5. Login vm0, then bind VF0 device to igb_uio driver.

  6. Start testpmd on host and vm0, host supports flow director and cloud filter, VM supports cloud filter. set chained port topology mode, add txq/rxq to enable multi-queues. In general, PF’s max queue is 64, VF’s max queue is 4:

    ./<build>/app/dpdk-testpmd -c f -n 4 -- -i --port-topology=chained --txq=64 --rxq=64

Note

if test DPDK PF + DPDK VF, bind port to igb_uio, if only test PF, bind pf port to vfio-pci or igb_uio.

53.2. Test Case: Load dynamic device personalization

  1. Stop testpmd port before loading profile:

    testpmd > port stop all

  2. Load gtp.pkgo file to the memory buffer, save original configuration and return in the same buffer to the gtp.bak file:

    testpmd > ddp add (port_id) /tmp/gtp.pkgo,/tmp/gtp.bak

  3. Check profile information successfully:

    testpmd > ddp get list (port_id)

  4. Start testpmd port:

    testpmd > port start all

53.3. Test Case: Delete dynamic device personalization

Remove profile from the network adapter and restore original configuration:

testpmd > ddp del (port_id) /tmp/gtp.bak

Note:

  1. Gtp.pkgo profile has been released publicly. You could download below version to do relative test. https://downloadcenter.intel.com/download/27587
  2. Loading DDP is the prerequisite for below GTP relative cases. Load profile again once restarting testpmd to let software detect this event, although has “profile has already existed” reminder.

53.4. Test Case: GTP-C FDIR packet for PF

  1. Add GTP-C flow director rule for PF, set TEID as random 20 bits, port is 2123, queue should be among configured queue number:

    testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpc teid is 0x3456 / end actions queue index 12 / end

  2. Set fwd rxonly, enable output and start PF and VF testpmd.

  3. Send GTP-C packet with good checksum, dport is 2123, TEID is same as configured rule:

    p=Ether()/IP()/UDP(dport=2123)/GTP_U_Header(teid=0x3456)/Raw('x'*20)

  4. Check PF could receive configured TEID GTP-C packet, checksum is good, queue is configured queue, ptypes are correct, check RTE_MBUF_F_RX_FDIR print.

  5. Send GTP-C packet with bad checksum, dport is 2123, TEID is same as configured rule:

    p=Ether()/IP()/UDP(chksum=0x1234,dport=2123)/GTP_U_Header(teid=0x3456)/Raw('x'*20)

  6. Check PF could receive configured TEID GTP packet, checksum is good, queue is configured queue, ptypes are correct, check RTE_MBUF_F_RX_FDIR print.

  7. Send some TEIDs are not same as configured rule or other types packets, check checksum are good, queue is 0, ptypes are correct, check no RTE_MBUF_F_RX_FDIR print.

53.5. Test Case: GTP-C Cloud filter packet for PF

  1. Add GTP-C cloud filter rule for PF, set TEID as random 20 bits, port is 2123, queue should be among configured queue number:

    testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpc teid is 0x12345678 / end actions pf / queue index 3 / end

  2. Set fwd rxonly, enable output and start PF and VF testpmd.

  3. Send GTP-C packet with good checksum, dport is 2123, TEID is same as configured rule:

    p=Ether()/IP()/UDP(dport=2123)/GTP_U_Header(teid=0x12345678)/Raw('x'*20)

  4. Check PF could receive configured TEID GTP-C packet, checksum is good, queue is configured queue, ptypes are correct, check no RTE_MBUF_F_RX_FDIR print.

  5. Send GTP-C packet with bad checksum, dport is 2123, TEID is same as configured rule:

    p=Ether()/IP()/UDP(chksum=0x1234,dport=2123)/GTP_U_Header(teid=0x12345678)/Raw('x'*20)

  6. Check PF could receive configured TEID GTP packet, checksum is good, queue is configured queue, ptypes are correct, check no RTE_MBUF_F_RX_FDIR print.

  7. Send some TEIDs are not same as configured rule or other types packets, check checksum are good, queue is 0, ptypes are correct, no RTE_MBUF_F_RX_FDIR print.

53.6. Test Case: GTP-U FDIR packet for PF

  1. Add GTP-U flow director rule for PF, set TEID as random 20 bits, port is 2152, queue should be among configured queue number:

    testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpu teid is 0x123456 / end actions queue index 18 / end
testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpu teid is 0x123456 / ipv4 / end actions queue index 58 / end
testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpu teid is 0x123456 / ipv6 / end actions queue index 33 / end

  2. Set fwd rxonly, enable output and start PF and VF testpmd.

  3. Send GTP-U packet with good checksum, dport is 2152, TEID is same as configured rule:

    p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header(teid=0x123456)/Raw('x'*20)
p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header(teid=0x123456)/IP()/Raw('x'*20)
p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header(teid=0x123456)/IPv6()/Raw('x'*20)

  4. Check PF could receive configured TEID GTP-U packet, checksum is good, queue is configured queue, ptypes are correct, check RTE_MBUF_F_RX_FDIR print.

  5. Send GTP-U packet with bad checksum, dport is 2152, TEID is same as configured rule:

    p=Ether()/IP()/UDP(chksum=0x1234,dport=2152)/GTP_U_Header(teid=0x123456)/Raw('x'*20)
p=Ether()/IP()/UDP(chksum=0x1234,dport=2152)/GTP_U_Header(teid=0x123456)/IP()/Raw('x'*20)
p=Ether()/IP()/UDP(chksum=0x1234,dport=2152)/GTP_U_Header(teid=0x123456)/IPv6()/Raw('x'*20)

  6. Check PF could receive configured TEID GTP packet, checksum is good, queue is configured queue, ptypes are corrcet, check RTE_MBUF_F_RX_FDIR print.

  7. Send some TEIDs are not same as configured rule or other types packets, check checksum are good, queue is 0, pytpes are correct, check no RTE_MBUF_F_RX_FDIR print.

53.7. Test Case: GTP-U Cloud filter packet for PF

  1. Add GTP-U cloud filter rule for PF, set TEID as random 20 bits, port is 2152, queue should be among configured queue number:

    testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpu teid is 0x12345678 / end actions pf / queue index 3 / end

  2. Set fwd rxonly, enable output and start PF and VF testpmd.

  3. Send GTP-U packet with good checksum, dport is 2152, TEID is same as configured rule:

    p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header(teid=0x12345678)/Raw('x'*20)

  4. Check PF could receive configured TEID GTP-U packet, checksum is good, queue is configured queue, ptypes are correct, check no RTE_MBUF_F_RX_FDIR print.

  5. Send GTP-U packet with bad checksum, dport is 2152, TEID is same as configured rule:

    p=Ether()/IP()/UDP(chksum=0x1234,dport=2152)/GTP_U_Header(teid=0x12345678)/Raw('x'*20)

  6. Check PF could receive configured TEID GTP packet, checksum is good, queue is configured queue, ptypes are correct, check no RTE_MBUF_F_RX_FDIR print.

  7. Send some TEIDs are not same as configured rule or other types packets, check checksum are good, queue is 0, ptypes are correct, no RTE_MBUF_F_RX_FDIR print.

53.8. Test Case: GTP-C Cloud filter packet for VF

  1. Add GTP-C cloud filter rule for VF, set TEID as random 20 bits, port is 2123, queue should be among configured queue number:

    testpmd> flow create 0 ingress pattern eth / ipv4 / udp / gtpc teid is 0x1678 / end actions vf id 0 / queue index 3 / end

  2. Set fwd rxonly, enable output and start PF and VF testpmd.

  3. Send GTP-C packet with good checksum, dport is 2123, TEID is same as configured rule:

    p=Ether()/IPv6()/UDP(dport=2123)/GTP_U_Header(teid=0x1678)/Raw('x'*20)

  4. Check VF could receive configured teid GTP-C packet, checksum is good, queue is configured queue.

  5. Send GTP-C packet with bad checksum, dport is 2123, TEID is same as configured rule:

    p=Ether()/IPv6()/UDP(chksum=0x1234,dport=2123)/GTP_U_Header(teid=0x1678)/Raw('x'*20)

  6. Check VF could receive configured TEID GTP packet, checksum is good, queue is configured queue.

53.9. Test Case: GTP-U Cloud filter packet for VF

  1. Add GTP-U cloud filter rule for VF, set TEID as random 20 bits, port is 2152, queue should be among configured queue number:

    testpmd > flow create 0 ingress pattern eth / ipv4 / udp / gtpu teid is 0x178 / end actions vf id 0 / queue index 1 / end

  2. Set fwd rxonly, enable output and start PF and VF testpmd.

  3. Send GTP-U packet with good checksum, dport is 2152, TEID is same as configured rule:

    p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header(teid=0x178)/Raw('x'*20)

  4. Check VF could receive configured TEID GTP-U packet, checksum is good, queue is configured queue.

  5. Send GTP-U packet with bad checksum, GTP-U dport is 2152, TEID is same as configured rule:

    p=Ether()/IPv6()/UDP(chksum=0x1234,dport=2152)/GTP_U_Header(teid=0x178)/Raw('x'*20)

  6. Check VF could receive configured TEID GTP packet, checksum is good, queue is configured queue.

53.10. GTP packet

Note:

  1. List all of profile supported GTP packets as below, also could use “ddp get info gtp.pkgo” to check profile information. Below left number is ptype value, right are layer types. 167: IPV4, GTP-C, PAY4
  2. Scapy 2.3.3+ versions support to send GTP packet. Please check your scapy tool could send below different GTP types’ packets successfully then run above tests.

53.11. GTP-C packet types

167: IPV4, GTP-C, PAY4:

p=Ether()/IP()/UDP(dport=2123)/GTP_U_Header()/Raw('x'*20)

168: IPV6, GTP-C, PAY4:

p=Ether()/IPv6()/UDP(dport=2123)/GTP_U_Header()/Raw('x'*20)

53.12. GTP-U data packet types, IPv4 transport, IPv4 payload

169: IPV4 GTPU IPV4 PAY3:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IP()/Raw('x'*20)

170: IPV4 GTPU IPV4FRAG PAY3:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IP(frag=5)/Raw('x'*20)

171: IPV4 GTPU IPV4 UDP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IP()/UDP()/Raw('x'*20)

172: IPV4 GTPU IPV4 TCP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IP()/TCP()/Raw('x'*20)

173: IPV4 GTPU IPV4 SCTP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IP()/SCTP()/Raw('x'*20)

174: IPV4 GTPU IPV4 ICMP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IP()/ICMP()/Raw('x'*20)

53.13. GTP-U data packet types, IPv6 transport, IPv4 payload

175: IPV6 GTPU IPV4 PAY3:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IP()/Raw('x'*20)

176: IPV6 GTPU IPV4FRAG PAY3:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IP(frag=5)/Raw('x'*20)

177: IPV6 GTPU IPV4 UDP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IP()/UDP()/Raw('x'*20)

178: IPV6 GTPU IPV4 TCP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IP()/TCP()/Raw('x'*20)

179: IPV6 GTPU IPV4 SCTP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IP()/SCTP()/Raw('x'*20)

180: IPV6 GTPU IPV4 ICMP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IP()/ICMP()/Raw('x'*20)

53.14. GTP-U control packet types

181: IPV4, GTP-U, PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/Raw('x'*20)

182: PV6, GTP-U, PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/Raw('x'*20)

53.15. GTP-U data packet types, IPv4 transport, IPv6 payload

183: IPV4 GTPU IPV6FRAG PAY3:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IPv6()/IPv6ExtHdrFragment()/Raw('x'*20)

184: IPV4 GTPU IPV6 PAY3:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IPv6()/Raw('x'*20)

185: IPV4 GTPU IPV6 UDP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IPv6()/UDP()/Raw('x'*20)

186: IPV4 GTPU IPV6 TCP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IPv6()/TCP()/Raw('x'*20)

187: IPV4 GTPU IPV6 SCTP PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IPv6()/SCTP()/Raw('x'*20)

188: IPV4 GTPU IPV6 ICMPV6 PAY4:

p=Ether()/IP()/UDP(dport=2152)/GTP_U_Header()/IPv6(nh=58)/ICMP()/Raw('x'*20)

53.16. GTP-U data packet types, IPv6 transport, IPv6 payload

189: IPV6 GTPU IPV6 PAY3:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IPv6()/Raw('x'*20)

190: IPV6 GTPU IPV6FRAG PAY3:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IPv6()/IPv6ExtHdrFragment()/Raw('x'*20)

191: IPV6 GTPU IPV6 UDP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IPv6()/UDP()/Raw('x'*20)

113: IPV6 GTPU IPV6 TCP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IPv6()/TCP()/Raw('x'*20)

120: IPV6 GTPU IPV6 SCTP PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IPv6()/SCTP()/Raw('x'*20)

128: IPV6 GTPU IPV6 ICMPV6 PAY4:

p=Ether()/IPv6()/UDP(dport=2152)/GTP_U_Header()/IPv6(nh=58)/ICMP()/Raw('x'*20)