Tutorials
++++++++++

There is a tutorial project named `mtf_basic_tuto <https://files.technica-engineering.de/MTF/Tutorials/>`_
that provides tutorials test cases covering **some of the basic features of the MTF Python Api**.

Getting started
#####################

Optional: Download the project
****************************

You can either view the tutorials online or download the project using ´wget´.

.. note::

     For Windows, download `wget 1.21.4 (x86_64) <https://eternallybored.org/misc/wget/1.21.4/64/wget.exe>`_
     and move the executable to "C:\Windows\System32".```

.. code-block:: bash

    wget -q https://files.technica-engineering.de/MTF/Tutorials/mtf_basic_tuto.zip


Install the Microsoft Loopback ETHERNET Adapter
##################################################

To execute the test cases, follow this guide to create a Microsoft Loopback Ethernet Adapter,
which is already included in the YAML test bench configuration file: `Install the Microsoft Loopback ETHERNET Adapter <https://files.technica-engineering.de/MTF/Tutorials/project/How%20to%20create%20and%20configure%20a%20virtual%20adapter.pdf>`_

Available test cases
######################

This project contains multiple test cases, including **basic burst transmission**, **frames transmission**,
**frames capture**, **signal checking**, **faulty alive apply**, **faulty CRC apply**, and other test cases.
You can find these test cases inside the project repository's `tests subfolder <https://files.technica-engineering.de/MTF/Tutorials/project/tests/>`_

Executing test cases
######################

To execute the test cases, run the commands mentioned in the `step-by-step instruction manual <https://files.technica-engineering.de/MTF/Tutorials/project/steps%20to%20execute%20the%20Tuto.pdf>`_.

.. important::

    You need to change the test series configuration file name to run the desired test series.