Fahrplan für Neueinsteiger im ME7 Team

3.2.1 Kopfinformation
3.2.2 Verzeichnisstruktur
3.2.3 Zielbaum
3.2.4 Link-Invocation

3.3.1 Aufbau einer Regel

1 Allgemeines

1.1 Über dieses Dokument

1.2 Der Aufbau von Steps-ME7

• Versionsverwaltung
• Einsatz von Damos++
• Compilierung
• Debugging
• Erzeugung von Dateien f�r Test-, Me�- und Applikationswerkzeuge
• Listings mit absoluten Adressen
• ...

2 Vorgehen beim Laden eines Programmstandes mit Codewright

1. Ein Programmstand wurde kopiert.
2. Ein weiteres Modul wurde in die Programmstandsbeschreibung (.psb) aufgenommen.
3. Im Projekt wurden Includeanweisungen hinzugefügt.
4. Ein neues Projekt wird erzeugt.

Tips und Tricks zu Codewright
Shortcuts für die Bedienung von Codewright 5.0

3 Die Dateien eines Programmstands

3.1 Verarbeitung der Programmstandsbeschreibung

• C++-Kommentare (also: /* */ und //)
• Definieren von symbolischen Namen
  define-name(can-modul, �can71051.c")
• Auswerten von symbolischen Namen mit []
  [C166] [can-modul]
• Extrahieren von Pfad, Dateiname und/oder Dateierweiterung
  [a166-5.5] [source] to [pn, source].obj
• Auswerten von Umgebungsvariablen
  define-name(MY_PATH, �[$, PATH];N:\Programme\Diverses")
• Setzen von Umgebungsvariablen
  set-environment(MY_ENV, �N:\Programme\Diverses")
• Verwendung von Variablen-/Symbole-Namen in Zeichenketten
  [out-dir]\ercdl00.c

3.2 Die Programmstandsbeschreibung (.PSB)

3.2.2 Verzeichnisstruktur

add-search-path([.]\asic)
add-search-path([.]\ercos)

S:\sw\int\7105110A\Progst\71051.psb

S:\sw\int\7105110A.

3.2.3 Zielbaum

ZielName
{

Datei
:

}

[pst-id].66				// Hauptziel Binärfile
{
	[bso-5.0-crtlib]		// Standardlib dazubinden
	
	[out-dir]\ercos08.lno	// Unterziel: Ercos Task
	{
	cstart1.asm			// Assembler Source Datei
	ercdl00.c			// C Source Datei
	7x000t.c
	7x000c.c
	}

	[out-dir]\zahn001.lno	// Unterziel Zahn Task
	{
	task(ZAHN)			// Angabe des Tasknamens
	zahn001.a66
	}

	[out-dir]\tnot001.lno
	{
	tnot001.a66
	xyz.lib			// Unterunterziel Bibliothek xyz
		{
		modul1.c		// Source Datei für xyz
		modul2.c
		}
	}
}

1. [kgs-files]:
   Unterziel f�r die Kenngr��endateien. Es werden hier alle Kenngr��endateien aufgef�hrt, die zu diesem Programmstand geh�ren. Dabei ist darauf zu achten, da� Dateien, die von anderen Funktionen ben�tigt werden (z.B. St�tzstellenberechnung) vor diesen aufgelistet werden.

2. [special]:
   Dateien, die in die Dateiliste des Projektes �bernommen werden, obwohl sie f�r die Erzeugung des Programmstandes nicht ben�tigt werden. Hier sollten solche Dateien eingetragen werden, die keine Sourcedateien o.�. sind, aber dennoch zum Programmstand geh�ren. Die Dateiliste des Projektes ist die Grundlage f�r verschiedene Aktionen, unter anderem zum Generieren eines Programmstandes.

3.2.4 Link-Invocation

file [project].inv
begin-of-file
TEXT
end-of-file


3.3 Die Regeln (.RUL)

Aufbau der Regeldatei

Projekt-Manager-Version(1.0)

3.3.1 Aufbau einer Regel

Es gibt zwei Typen von Regeln, die sich in der Kardinalität ihrer Quelldateien unterscheiden:

1. Die 1-1-rule (abgekürzt rule) bekommt eine Quell- und eine Zieldatei (Bsp.: Regel für C Sourcen).
2. Die 1-N-rule kann mehrere Quelldateien verarbeiten (Bsp.: Regel für den Linker).

Ist eine Abhängigkeit angegeben, wird sie für jeden Knoten des Zielbaumes, der mit dieser Regel verknüpft ist, eingetragen. Auf diese Weise kann man Abhängigkeiten definieren, die nicht automatisch festgestellt werden können. Zum Beispiel sollte so die Abhängigkeit aller Assembler Sourcen von der Portdefinitionsdatei reg167me.def festgelegt werden.

Innerhalb einer Regel - also auch innerhalb der Kommandos - sind symbolische Namen erlaubt. Drei spezielle symbolische Namen werden automatisch belegt:

1-N-rule obj-2-lno
.lno : .obj .lib
"echo ---- Linking [ne, target]"
"@[BSO-5.0-Linker] [source] CASE nowa(118) to [target]"
end-rule

rule c-2-obj
.obj : .c  [.]\progst\[project].h
"echo ---- Compiling [ne, source]"
"@[BSO-5.0-CC] [more-options]
   -DPROJECT_H='"[project].h'"
   -I[.]\Include
   -I[.]\header
   -I[.]\d_files
   -I[.]\ercos
   -I[.]\progst
   -g -x -Ms -Hreg167me.h -H[dep-1] 
   -o [out-dir]\[n,source].src [source]"
"@[BSO-5.0-Asm] [out-dir]\[n,source].src EX SN(reg167me.def)
NOM166 EP([pn,target]) PR([pn,target]) TO [target]"
end-rule

Diverses

Schaubilder

� K3/EES3 Fa. ISS - Mohring Michael
Letzte Änderung: August 1997