Executable Usage - 2023.2 English

Vitis Libraries

Release Date
2023-12-20
Version
2023.2 English

This application is present under L3/demos/gzip_app/ directory. Follow build instructions to generate executable and binary.

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

Following is the usage of the executable:

  1. To execute single file for compression : ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -c <input file_name>

  2. To execute single file for decompression : ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -d <compressed file_name>

  3. To validate single file (compress & decompress) : ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -t <input file_name>

  4. To execute multiple files for compression : ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -cfl <files.list>

  5. To execute multiple files for decompression : ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -dfl <compressed files.list>

  6. To validate multiple files (compress & decompress) : ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -l <files.list>

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

The default design flow is GZIP design to run the ZLIB, enable the switch -zlib in the command line, as mentioned below: ./build_dir.<TARGET mode>.<xsa_name>/xil_gzip -xbin ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin -c <input file_name> -zlib 1

The -xbin option mentioned above is optional, you can provide path to your binary file using -xbin option otherwise it will by default map to ./build_dir.<TARGET mode>.<xsa_name>/compress_decompress.xclbin

The usage of the generated executable is as follows:

Usage: application.exe -[-h-c-d-xbin-t-l-id-mcr]
       --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]