====== Download and Installation ======

===== Requirements =====
  * 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)

===== Install Eclipse =====

==== Windows ====
  - Ensure that you've installed an up-to-date JDK.
    * Download the JDK from the [[http://www.oracle.com/technetwork/java/javase/downloads/index.html | Oracle website]].
    * Install it by using the setup assistant
  - Install //Eclipse IDE for Java Developers//.
    * Get the newest version of [[http://www.eclipse.org/downloads/|Eclipse for Java Developers]].
    * Unzip it into ''C:\Program Files\eclipse'' or ''C:\Programme\eclipse'', respectively.

==== Linux ====

  - 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 [[ https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2020-09/R/eclipse-java-2020-09-R-linux-gtk-x86_64.tar.gz | here ]]
    * Extract it to a suitable place, such as ''/opt/deep/eclipse/''
      - ''mkdir -p /opt/deep/eclipse''
      - ''tar -C /opt/deep/eclipse -xvf eclipse-java-2020-09-R-linux-gtk-x86_64.tar.gz''

===== Install Eclipse Plugins =====

  - Install the deep Eclipse plugin from our [[http://update.deepjava.org/eclipse | Update Site]].
    - Start the Eclipse IDE (eclipse.exe)
    - Open the plugin installation dialog: Help → Install New Software…
    - Add a new plugin source: Add… → Name: Deep, Location: http://update.deepjava.org/eclipse/ → OK
    - Add the plugin by checking ''deep Plugin for Eclipse'' from category „Deep“

===== Install deep Runtime Library =====
  - Install the deep runtime library by extracting the newest ZIP archive from [[https://update.deepjava.org/runtime-library/ | ]] to ''C:\Programm Data\deep\trglib'' (Windows), ''/opt/deep/lib'' (Linux) or any other location.

===== Install Libraries to Access the Hardware =====
==== Using a Zynq7000 Based Board ====
If you use an ARM based target, i.e. the Zybo or MicroZed Board with a Zynq7000 processor, install the [[..:..:openocd:start | OpenOCD toolchain]].
  - Install OpenOCDInterface plugin in eclipse from our [[http://update.deepjava.org/eclipse | Update Site]].
    - Start the Eclipse IDE (eclipse.exe)
    - Open the plugin installation dialog: Help → Install New Software…
    - Add a new plugin source: Add… → Name: Deep, Location: http://update.deepjava.org/eclipse/ → OK
    - Add the plugin by checking ''openOCD Plugin for Eclipse'' from category „Deep“
  - Install OpenOCD
    * **Windows**
      - In order to use OpenOCD, the correct USB drivers must be installed. We suggest using [[http://visualgdb.com/UsbDriverTool/|USB driver tool]] for this purpose. This tool is available solely for Windows. Download the [[http://visualgdb.com/UsbDriverTool/|USB driver tool]] and extract it. We will later use it to load the correct driver.
      - Install OpenOCD 
        * Either compile OpenOCD from the [[http://sourceforge.net/p/openocd/code/ |source code ]] 
        * Or [[http://www.freddiechopin.info/en/download/category/4-openocd?download=154%3Aopenocd-0.10.0 | download ]] the precompiled binaries for Windows (preferred method)
          - Extract the archive to your computer
          - The executable binary is located under: ''openocd-0.10.0/bin-x64/''
          - The user manual is located under: ''openocd-0.10.0/''
          - Get {{ :openocd:ostboards.zip |}} 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 {{ :openocd:openocd-0.10.0.zip |here}}.
    * **Linux**
      - Install OpenOCD, it is probably available through your distribution's package manager. E.g. ''sudo apt install openocd''
      - Download {{ :openocd:ostboards.zip |}} and unpack it to suitable place, such as ''/opt/deep/openocd''

==== Using a MPC555 Board ====
If you want to use deep with our [[http://wiki.bu.ost.ch/infoportal/embedded_systems/mpc555/headerboard/start|MPC555]] and the [[http://wiki.bu.ost.ch/infoportal/embedded_systems/mpc555/usb-bdi|USB-BDI]]
  * Install the [[https://libusb-java.ch/installation/start|LibusbJava]]. For Java 9 and later, make sure that you install the necessary plugin as follows:
    - Start the Eclipse IDE (eclipse.exe)
    - Open the plugin installation dialog: Help → Install New Software…
    - Add a new plugin source: Add… → Name: Deep, Location: http://update.deepjava.org/eclipse/ → OK
    - Add the plugin by checking ''LibusbJava plugin for eclipse'' from category „Deep“
  * Install the plugin ''mpc555UsbBdi'' from the same update site and follow the instructions of the plugin installer
  * On Windows, alternatively to the steps above, you can use our [[https://wiki.bu.ost.ch/infoportal/software/inf_win_driver_package/start|INF Windows Driver Package]]

==== Using a MPC5200 Board ====
When using a [[https://wiki.bu.ost.ch/infoportal/embedded_systems/abatron_bdi/start|Abatron BDI2000/BDI3000]] you must install the Abatron debugger plugin. Check on [[https://github.com/deepjava/abatronInterface]].