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.

Executable Usage¶

To execute single file for compression : ./build/xil_gzip -xbin ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -c <input file_name>
To execute single file for decompression : ./build/xil_gzip -xbin ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -d <compressed file_name>
To validate single file (compress & decompress) : ./build/xil_gzip -xbin ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -t <input file_name>
To execute multiple files for compression : ./build/xil_gzip -xbin ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -cfl <files.list>
To execute multiple files for decompression : ./build/xil_gzip -xbin ./build/xclbin_<xsa_name>_<TARGET mode>/compress_decompress.xclbin -dfl <compressed files.list>
To validate multiple files (compress & decompress) : ./build/xil_gzip -xbin ./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-t-cfl-dfl-l-xbin-id]
       --help,                -h        Print Help Options
       --compress,            -c        Compress
       --decompress,          -d        Decompress
       --test,                -t        Xilinx compress & Decompress
       --compress_list,       -cfl      Compress List of Input Files
       --decompress_list,     -dfl      Decompress List of compressed Input Files
       --test_list,           -l        Xilinx Compress & Decompress on Input Files
       --max_cr,              -mcr      Maximum CR                                      Default: [10]
       --xclbin,              -xbin     XCLBIN
       --device_id,           -id       Device ID                                       Default: [0]
       --zlib,                -zlib     [0:GZip, 1:Zlib]                                Default: [0]

Results¶

Resource Utilization¶

Table below presents resource utilization of Xilinx GZip Compress/Decompress kernels. The final Fmax achieved is 277MHz

Compression¶

Flow	LUT	LUTMem	REG	BRAM	URAM
Compress	35.4K	4.6K	31.8K	75	32

Decompression¶

Flow	LUT	LUTMem	REG	BRAM
DeCompress	6.5K	866	5K	8
DM Reader	1.5K	281	1.9K	2
DM Writer	4K	1681	6K	9

Performance Data¶

Table below presents kernel throughput achieved for a single compute unit.

Topic	Results
Compression Throughput	1.5 GB/s
Decompression Throughput	518 MB/s
Average Compression Ratio	2.67x (Silesia Benchmark)

Note: Overall throughput can still be increased with multiple compute.

Standard GZip Support¶

This application is compatible with standard Gzip/Zlib application (compress/decompres).