3. OCTEON TX ZIP Compression Poll Mode Driver

The OCTEON TX ZIP PMD (librte_pmd_octeontx_zip) provides poll mode compression & decompression driver for ZIP HW offload device, found in Cavium OCTEON TX SoC family.

More information can be found at Cavium, Inc Official Website.

3.1. Features

OCTEON TX ZIP PMD has support for:

Compression/Decompression algorithm:

  • DEFLATE

Huffman code type:

  • FIXED
  • DYNAMIC

Window size support:

  • 2 to 2^14

3.2. Limitations

  • Chained mbufs are not supported.

3.3. Supported OCTEON TX SoCs

  • CN83xx

3.4. Steps To Setup Platform

OCTEON TX SDK includes kernel image which provides OCTEON TX ZIP PF driver to manage configuration of ZIPVF device Required version of SDK is “OCTEONTX-SDK-6.2.0-build35” or above.

SDK can be install by using below command. #rpm -ivh OCTEONTX-SDK-6.2.0-build35.x86_64.rpm –force –nodeps It will install OCTEONTX-SDK at following default location /usr/local/Cavium_Networks/OCTEONTX-SDK/

For more information on building and booting linux kernel on OCTEON TX please refer /usr/local/Cavium_Networks/OCTEONTX-SDK/docs/OcteonTX-SDK-UG_6.2.0.pdf.

SDK and related information can be obtained from: Cavium support site.

3.5. Installation

3.5.1. Driver Compilation

To compile the OCTEON TX ZIP PMD for Linux arm64 gcc target, run the following make command:

cd <DPDK-source-directory>
make config T=arm64-thunderx-linux-gcc install

3.6. Initialization

The OCTEON TX zip is exposed as pci device which consists of a set of PCIe VF devices. On EAL initialization, ZIP PCIe VF devices will be probed. To use the PMD in an application, user must:

  • run dev_bind script to bind eight ZIP PCIe VFs to the vfio-pci driver:

    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.1
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.2
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.3
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.4
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.5
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.6
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:00.7
    ./usertools/dpdk-devbind.py -b vfio-pci 0001:04:01.0
    
  • The unit test cases can be tested as below:

    reserve enough huge pages
    cd to the top-level DPDK directory
    export RTE_TARGET=arm64-thunderx-linux-gcc
    export RTE_SDK=`pwd`
    cd to app/test
    type the command "make" to compile
    run the tests with "./test"
    type the command "compressdev_autotest" to test