.. SPDX-License-Identifier: BSD-3-Clause
   Copyright(c) 2017 Intel Corporation

================================================
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


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.

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

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. 
	  

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.
  

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.


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.


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.
   
   
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.
   
   
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.
   

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.  
 

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)
 
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)

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)

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)
 
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) 

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)