deep

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Create and manage deep projects ======

When creating new projects all the necessary settings will be written automatically in a configuration file (''PROJECTNAME.deep'' in the root folder of the project). This file can also be manually edited to change project settings.

===== The deep project file =====
A typical deep project file looks like this:
<code>
#deep-1

meta {
	version = "Sun May 26 16:05:42 CEST 2013";
	description = "deep project file for Test1";
}

project Test1 {
	libpath = "I:\deep\lib";
	boardtype = ntbMpc555HB;
	ostype = sts_ppc;
	programmertype = ntbMpc555UsbBdi;
#	programmeropts = none;
#	imgfile = D:\temp\myFile.bin;
#	pl_file = ;

#	enter names of rootclasses, e.g.
#	rootclasses = "test.MyFirstTestClass","other.MySecondTestClass";
	rootclasses = "test.TestClass1";
}
</code>

All lines starting with # are comments. Also the first line which is optional, it only helps the system to choose the right parser for the file.

The meta paragraph contains only some informations about the file, but remind, that both assignments are necessary. More interesting is the second paragraph //project//, which contains all informations about the deep-Project.

==== Library path ====
The library path must be carefully set up. It can consist of several strings. For each path the directory //bin// is added to the path. At this resulting location the configuration files and the class files must be found. \\
It is possible as well to choose a jar-file as library path.\\
If some of the configuration files are located in the current project, this current project must also be added to the library path.
If several paths and/or jar-files are given, the search order for any given class file is in the order of the given paths.
Some examples:
<code>
  libpath = "I:\deep\lib"; # network drive
  libpath = "../org.deepjava.trglib","../ch.ntb.inf.junitTarget; # local
  libpath = "C:/Program Files/Java/jre6/lib/rt.jar","I:\deep\lib"; # jar file
  libpath = "I:\deep\lib","M:\EUser\runtime-EclipseApplication\Test"; # local project
</code>

==== Board ====
The type of the board must be specified. The compiler has to know where to place code and variables and what type of architecture to compile for.
<code>
  boardtype = ntbMpc555HB;
</code>

==== Target operating system ====
Choose an operating system with
<code>
  ostype = sts_ppc;
</code>

==== Programmer ====
The programmer declaration is optional, if no programmer is given, deep will not automatically download the image to the target board.
<code>
  programmertype = ntbMpc555UsbBdi;
</code>

==== Programmer Options ====
This options are used when the programmer is accessed trough a telnet connection, e.g. with OpenOCD.
<code>
  programmeropts = localhost_4444;
</code>

==== Image File ====
It is possible to write an image file to disk. This might be useful for further processing or debugging.
<code>
  imgfile = "D:\myProject\myFile";
</code>

==== PL Image File ====
If the target architecture contains a programmable logic block (PL), you can specify the bit-file with which the PL can be configured, e.g.
<code>
  pl_file = "I:\deep\lib\rsc\flink2.bit";
</code>

==== Target Command Table File ====
When you specify this option, the launcher will create a file containing all methods together with their memory addresses of all classes which are commands.
<code>
  tctfile = "../ch.ntb.inf.junitTarget/tct/targetCommands.dtct";
</code>
This option is solely used for testing purposes.

==== Rootclasses ====
At least one rootclass must be specified. If several rootclasses are used the list must be comma separated. 
<code>
  rootclasses = "test.MyFirstTestClass","other.MySecondTestClass";
</code>
deep

User Tools

Site Tools

Page Tools
