Xilinx GZip Compression and Decompression

GZip example resides in L2/demos/gzip directory.

Follow build instructions to generate host executable and binary.

The binary host file generated is named as “xil_gzip” and it is present in ./build directory.

Results

Overall Resource Utilization

Table below presents resource utilization of Xilinx Zlib compress/decompress kernels. The final Fmax achieved is 289MHz

Flow LUT LUTMem REG BRAM URAM
Compress 82.7K 26K 84.7K 105 48
DeCompress 13.9K 506 13.9K 8 4

Compress Kernel Resource Utilization

Kernel LUT LUTMem REG BRAM URAM
LZ77 43.9K 10.4K 46.9K 69 48
Huffman 38.8K 10.2K 37.8K 36 0

Decompress Kernel Resource Utilization

Kernel LUT LUTMem REG BRAM URAM
Decompress 10.6K 162 8.1K 4 4
DmReader 2.1K 294 3.8K 3 0
DmWriter 1K 50 1.8K 1 0

Performance Data

Topic Best Kernel Throughput
Compression 2 GB/s
Decompression 736 MB/s
Average Compression Ratio 2.74 (Silesia Corpus)
[*]Decompression uses high fmax options (Bitwidth: 32bit, ByteGen Loop: 2)

Executable Usage

  1. To execute single file for compression : ./build/xil_gzip -sx ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -c <input file_name>

  2. To execute single file for decompression : ./build/xil_gzip -sx ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -d <compressed file_name>

  3. To validate single file (compress & decompress) : ./build/xil_gzip -sx ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -v <input file_name>

  4. To validate multiple files (compress & decompress) : ./build/xil_gzip -sx ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -l <files.list>

    • <files.list>: Contains various file names with current path

The usage of the generated executable is as follows:

Usage: application.exe -[-h-c-d-sx-v-l-k]
     --help,                 -h      Print Help Options   Default: [false]
     --compress,             -c      Compress
     --decompress,           -d      Decompress
     --single_xclbin,        -sx     Single XCLBIN        Default: [single]
     --file_list,            -l      List of Input Files
     --compress_decompress,  -v      Compress Decompress
     --cu,                   -k      CU                   Default: [0]

Standard GZip Support

This application is compatible with standard Gzip application (compress/decompres). Compatibility is validated on Linux environment.

Following is the command to use standard “gzip” to decompress files compressed using Xilinx GZip application.

gzip -dc <compressed_file.gz>  > out

At present we dont support CRC32 check for GZip, due this following error message is expected while running the above command.

Expected Error Message:

invalid compressed data--crc error