===== Running JOP (Java Optimized Processor) on a ZTEX FPGA Board =====

[[http://www.jopdesign.com/|JOP - Java Optimized Processor]] - is one way to use a configurable Java processor in small embedded real-time systems. It shall help to increase the acceptance of Java for these systems.

This project explains how a JOP processor can be implemented on a [[http://www.ztex.de/usb-fpga-1/usb-fpga-1.11.e.html|ZTEX USB-FPGA Module 1.11c]] with Spartan6 LX25 FPGA. Currently only 16MB the DDR RAM (of 64MB) are supported. The FPGA utilization is about 23% which allows to build multiple cores in CMP JOP.

===== Download the fresh Source =====

The latest version can be obtained from with following Git command: 

<code>git clone https://github.com/jop-devel/jop</code>

Create the needed directories with: 

<code>make directories</code>

===== Tools =====

The tools are built with following make command:

<code>make tools</code>

===== Assemble the Microcode JVM, Compile the Processor =====

The JVM configured to download the Java application from the serial interface is built with:

<code>make jopser</code>

By default the JOP build is set up to use the quartus tools so the make command will fail with ''quartus_map: Command not found''. This is ok.

===== Open the project in ISE =====

Open the file ''xilinx/ztex/ise_13/ise_13.xise''. Once the project has loaded you will get a dialog asking you for the path for a few files. These files will be generate in the next step so dismiss the dialog for now.

The sources for the MIG has to be added to the project. Add the file ''xilinx/ztex/mig_37/mig_37.xco'' and the icon for the u_mig37 "file" should change from a question mark to a light bulb. TODO: Why is this needed? -Trygve

===== Create the Spartan-6 DDR memory interface =====

First the project has to be configure to generate VHDL instead of Verilog. Open the Design Properties dialog (Project -> Design Properties) and make sure "Preferred Language" is "VHDL" instead of "Verilog". TODO: It should be possible to check in this change to git - trygve

Use Coregen/MIG 3.7 (or 3.61 for ISE 12.4) to create the controller. You may use file ''xilinx/ztex/mig_37/mig_37.xco'' for Coregen

  * Component Name: mig_37
  * Bank 3 Memory Type DDR SDRAM
  * Frequency: 200MHz
  * Memory Part: MT46V32M16XX-5B-IT
  * Configuration Selection: One 32-bit bi-directional port
  * Memory Address Mapping Selection: Row, Bank, Column

Once the controller is generated copy all the VHDL files from the ''xilinx/ztex/mig_37/mig_37/user_design/rtl/*.vhd'' directory to ''xilinx/ztex/mig_37'' directory and apply patch:

<code>patch < memc3_infrastructure.patch</code>

===== Build bitstream =====

Run make in directory xilinx/ztex or load project xilinx/ztex/ise_13/ise_13.xise to [[en:ztex_boards:ztex_fpga_boards:first_steps_with_ise|ISE]]

===== EZ-USB FX2 Firmware =====

No special firmware is required in order to run JOP. The [[en:ztex_boards:ztex_fpga_boards:standalone|standalone firmware]]
from the ZTEX SDK can be used as dummy firmware and to allow Bitstream uploading via USB.

===== Load bitstream =====

The bitstream can be uploaded via USB using [[en:software:FWLoader]] or via [[en:ztex_boards:ztex_fpga_boards:jtag|JTAG]]
using Xilinx Impact.

===== Connect serial console =====

In order to verify the functionality of the JOP a serial adapter cable need to be connected to the FPGA Board.

By default, the serial port is connected to the following pins:

^ Name  ^ FPGA ball  ^  Pin of the FPGA Board  ^ Pin at the Experimental board  ^
| TX  | C13  | A13  | A13  |
| RX  | A14  | A12  | A12  |

If other pins are preferred, lines around line 11 nedd to be changed.

===== Compiling and Downloading the Java Application =====

From root directory of jop make:

<code>make japp -e P1=bench P2=jbe P3=DoAll</code>

Copy file java/target/dist/bin/DoAll.jop to root jop dir and load it:

  * for Win: <code>down.exe -e DoAll.jop com3</code>
  * for Linux: <code>./down -e DoAll.jop /dev/ttyUSB0</code>

Provide your correct port!

Result:

<code>
Parsed JOP file ok.
* 11656 words of Java bytecode (45 KB)
* 20315 words external RAM (79 KB)

Transmitting data via serial...
[########################################################### ] 20224 / 20315
Done.
JOP start V 20110107
93 MHz, 16384 KB RAM, 1 CPUs
JavaBenchEmbedded V1.1
Micro Benchmarks:
iload_3 iadd 46091000 1/s
iinc 23172000 1/s
ldc 4629000 1/s
if_icmplt taken 15477000 1/s
if_icmplt not taken 15477000 1/s
getfield 2699000 1/s
getstatic 5084000 1/s
iaload 2122000 1/s
invoke 521679 1/s
invokestatic 667033 1/s
invokeinterface 413802 1/s
Kernel Benchmarks:
Sieve 3663 1/s
Application benchmarks:
Kfl 8555 1/s
UdpIp 3980 1/s
Lift 9346 1/s
</code>