Tutorial -- Running an example

This tutorial explains how the examples from the package are executed.

To execute the example only one .jar file is required which runs under all supported Operating systems. This .jar file contains all Java bytecode, the firmware, the bitstream and the OS dependent libraries.

1. Make sure that the Software requirements are satisfied
2. Windows only: Install the libusb driver for Windows, see below
3. Execute the package using the command

   java -cp <Package>.jar <Package>

   where <Package> stands for the main class of the project, e.g.

   java -cp MemFifo.jar MemFifo

   The examples usually have a bash (.sh) and .bat script which can be used instead.

Command line options of the examples can be viewed using

java -cp <Example>.jar <Example> -h

Because the .jar file contains every component required for running the package the jar file can be copied to / executed from every location.

Under Windows every USB device needs a driver. Easiest way to install the driver is using using Zadig, also see the github project.

Quick Start Guide is:

1. Plug-in the device. If Windows asks for a driver, cancel this.
2. start Zadig
3. choose the device and click install driver

This has to be repeated for all USB ID's under which the device may appear. In particular this are: