• PC running Linux, Mac OS X or Windows
• Java Developer Kit 11 or newer
• Eclipse 3.8 or newer
• Microcontroller board (MPC555 / MPC5200B / MicroZed / Zybo / Colibri)

• Ensure that you've installed an up-to-date JDK.
  1. Download the JDK from the Oracle website.
  2. Install it by using the setup assistant
• Install Eclipse IDE for Java Developers.
  1. Get the newest version of Eclipse for Java Developers.
  2. Unzip it into C:\Program Files\eclipse or C:\Programme\eclipse, respectively.

• Ensure that you have installed an up-to-date JDK.
  • On ubuntu/debian based systems you can run sudo apt install default-jdk
• Install Eclipse for Java Developers:
  • Download it from here
  1. Extract it to a suitable place, such as /opt/deep/eclipse/
     1. mkdir -p /opt/deep/eclipse
     2. tar -C /opt/deep/eclipse -xvf eclipse-java-2020-09-R-linux-gtk-x86_64.tar.gz

• Install the deep Eclipse plugin from our Update Site.
  1. Start the Eclipse IDE (eclipse.exe)
  2. Open the plugin installation dialog: Help → Install New Software…
  3. Add a new plugin source: Add… → Name: NTB Plugins, Location: http://update.deepjava.org/eclipse/ → OK
  4. Add the plugin by checking deep Plugin for Eclipse from category „NTB“

• Install the deep runtime library by extracting the ZIP archive from http://update.deepjava.org/runtime-library/deep_runtime_library_1.6.0_2020_09_15.zip to C:\Programm Data\deep\trglib (Windows), /opt/deep/lib (Linux) or any other location.

If you use an ARM based target, i.e. the Zybo or MicroZed Board with a Zynq7000 processor, install the OpenOCD toolchain.

In order to use OpenOCD, the correct USB drivers must be installed. We suggest using USB driver tool for this purpose. This tool is available solely for Windows.

1. Download the USB driver tool, extract and run it.
2. Connect your FT2232 based programmer, e.g. the JTAG-HS3. If you use the Zybo board, connect the board directly as it has the programmer already packed on the board.
3. Identify the USB serial converter, which connects to the JTAG bus. Depending on your actual board this will be
   • Avnet MicroZed: Device name: Digilent USB Device, Vendor ID = 0403, Device ID = 6014
     
   • Digilent Zybo: Device name: USB Serial Converter A, Vendor ID = 0403, Device ID = 6010, Interface = 00
     
4. Right-click on the device and select the WinUSB driver to install the driver
5. If you want to reinstall the default driver choose “Restore default driver”

1. You can either compile OpenOCD from the source code or download the precompiled binaries for Windows, which is the preferred method
2. Extract the archive to your computer
3. The executable binary is located under: openocd-0.10.0/bin-x64/
4. The user manual is located under: openocd-0.10.0/
5. Get ostboards.rar and unpack it into your openocd-0.10.0 directory

Alternatively, you can download the precompiled binaries for Windows together with the necessary files for the MicroZed and the Zybo boards here

The deep plugin of eclipse needs the openOCD plugin to access the hardware. Install it from our Update Site.

1. Start the Eclipse IDE (eclipse.exe)
2. Open the plugin installation dialog: Help → Install New Software…
3. Add a new plugin source: Add… → Name: NTB Plugins, Location: http://update.deepjava.org/eclipse/ → OK
4. Add the plugin by checking openOCD Plugin for Eclipse from category „NTB“

• Install OpenOCD, it is probably available through your distribution's package manager. E.g. sudo apt install openocd
• Download ostboards.rar and unpack it to suitable place, such as /opt/deep/openocd
  • Hint: You can use 7z (package p7zip) to extract .rar files on linux: 7z e ostboards.rar -o/opt/deep/openocd/
• Run OpenOCD with the correct config file:
  1. cd /opt/deep/openocd
  2. sudo openocd -f microzedboard.cfg or sudo openocd -f digilent_zyboboard.cfg

If you want to use deep with our MPC555 and the USB-BDI

• Install the LibusbJava. For Java 9 and later, make sure that you install the necessary plugin as follows:
  1. Start the Eclipse IDE (eclipse.exe)
  2. Open the plugin installation dialog: Help → Install New Software…
  3. Add a new plugin source: Add… → Name: NTB Plugins, Location: http://update.deepjava.org/eclipse/ → OK
  4. Add the plugin by checking LibusbJava plugin for eclipse from category „NTB“
• Install the plugin mpc555UsbBdi from the same update site and follow the instructions of the plugin installer
• On Windows, alternatively to step 1 and 2, you can use our NTB Windows Driver Package

When using a Abatron BDI2000/BDI3000 you must install the Abatron debugger plugin.