.. meta::
   :keywords: Vitis, Library, Data Compression, Xilinx, FPGA OpenCL Kernels, LZ4 Test, Snappy Test, ZLIB Test, GZip Test, ZSTD Test
   :description: This section provides various application tests
   :xlnxdocumentclass: Document
   :xlnxdocumenttypes: Tutorials

=====
Tests
=====

Tests examples for **lz4**, **snappy**, **lz4_streaming**, **snappy_streaming**, **zlib**, **gzip** and **zstd** kernels are available in the ``L2/tests/`` directory.

.. toctree::
   :maxdepth: 1
   :caption: List of Tests

   lz4_compress_streaming.rst
   lz4_compress.rst
   snappy_compress.rst
   gzipc_block_mm.rst
   gzipc.rst
   gzipc_static.rst
   lz4_dec_streaming_parallelByte8.rst
   snappy_dec_streaming_parallelByte8.rst
   gzip_decompress.rst

.. note::
Execute the following commands before building any of the examples:

.. code-block:: bash
   
   $ source <Vitis_Installed_Path>/installs/lin64/Vitis/2020.2/settings64.sh
   $ source <Vitis_Installed_Path>/xbb/xrt/packages/setup.sh

Build Instructions
------------------

Execute the following commands to compile and test run this example:

.. code-block:: bash
   
   $ make run TARGET=sw_emu

Variable ``TARGET`` can take the following values:

	- **sw_emu**	: software emulation
	
	- **hw_emu**	: hardware emulation
	
	- **hw**	: run on actual hardware

By default, the target device is set as Alveo U200. In order to target a different
device, use the  ``DEVICE`` argument. For example:

.. code-block:: bash

    make run TARGET=sw_emu DEVICE=<new_device.xpfm>

.. note::
Build instructions explained in this section are common for all the
applications. The generated executable names may differ.