Tap Entwicklungsumgebung

aus TopfWiki, der freien Wissensdatenbank

Inhaltsverzeichnis

1 Installieren der TAP-Entwicklungsumgebung

2 Cygwin

3 GCC for TAP

4 Topfield-API

5 Setzen der Pfade

6 Erstellen der TAP-Entwicklung Verknüpfung

7 Test

8 Installation der Entwicklungsumgebung in vom o.a. Beispiel abweichenden Ordnern:

9 Links zur für die Entwicklungsumgebung benötigten Software

[bearbeiten]

Installieren der TAP-Entwicklungsumgebung

Diese Anleitung beschreibt Schritt-für-Schritt die Installation der Entwicklungsumgebung für TAPs. Links für die benötigte Software stehen am Ende des Beitrages.

Einen herzlichen Dank an Gerti, aus dessen Beschreibung anno 2003 ich mich schamlos bedient habe. Die angegebenen Pfade sind Beispiele, weiter unten erkläre ich welche Schritte notwendig sind, um die Entwicklungsumgebung auch in anderen Ordnern als den im Beispiel angegebenen zu installieren.

[bearbeiten]

Cygwin

Entweder Cygwin downloaden und nach C:\cygwin installieren

oder

alternativ nur die Datei cygwin1.dll aus dem Cygwin-Installationspaket nach C:\Windows\System32 kopieren und mit folgenden Registry-Einträgen der DLL zwei benötigte Pfade, nämlich /tmp und /usr, bekannt machen:

[HKEY_CURRENT_USER\Software\Cygnus Solutions\Cygwin\mounts v2\/tmp]

"native"="C:/WINDOWS/TEMP"

"flags"=dword:00000002

und

[HKEY_CURRENT_USER\Software\Cygnus Solutions\Cygwin\mounts v2\/usr]

"native"="C:/cygwin/usr"

"flags"=dword:00000002

Anmerkung: Eigentlich ist die komplette Installation von Cygwin nicht notwendig, da nur die DLL und der Registry-Eintrag benötigt werden. Wählt man die "DLL-Registry-Methode", existiert natürlich kein Ordner c:\cygwin, und die Verzeichnisse müssen selbst angelegt werden.

[bearbeiten]

GCC for TAP

GCC for TAP downloaden und in ein temporäres Verzeichnis (z. B. C:\WINDOWS\TEMP) entpacken. Das ausgepackte local-Verzeichnis nach C:\cygwin\usr verschieben, dabei ggf. vorhandene Dateien überschreiben.

[bearbeiten]

Topfield-API

Die Topfield-API downloaden und nach C:\work\tap entpacken.

Bis jetzt wurden cygwin und die GCC for TAP unter C:\cygwin installiert und in C:\work\tap befinden sich einige Beispiel-TAPs und die *.h-Dateien.

[bearbeiten]

Setzen der Pfade

Damit nun der Build-Prozess funktioniert müssen noch ein paar Pfade gesetzt werden.

Dazu den Arbeitsplatz per rechter Maustaste anklicken und Eigenschaften auswählen. Im Reiter Erweitert den Button Umgebungsvariablen anklicken und unter Systemvariablen folgendes einfügen:

Name: C_INCLUDE_PATH

Wert: C:\WORK\TAP;C:\CYGWIN\INCLUDE;C:\CYGWIN\USR\LOCAL\INCLUDE

und – nur, wenn man in C++ entwickeln möchte –

Name: CPLUS_INCLUDE_PATH

Wert: C:\WORK\TAP;C:\CYGWIN\INCLUDE;C:\CYGWIN\USR\LOCAL\INCLUDE

Anschließend wird noch der Wert der Variablen PATH um folgendes ergänzt:

;C:\CYGWIN\USR\LOCAL\BIN;C:\CYGWIN\BIN

Anmerkung: Wählt man die "DLL-Registry-Methode", muss noch das Verzeichnis c:\cygwin\usr\local\lib\gcc-lib\mips\2.95.3 mit in den PATH aufgenommen werden; bzw. das Verzeichnis, in welchem sich der Compiler befindet. (Sollte das Verzeichnis Leerzeichen o. ä. enthalten, ist die 8.1-Schreibweise, also der DOS-Kurzname, zu verwenden.)

[bearbeiten]

Erstellen der TAP-Entwicklung Verknüpfung

Nun ist es sinnvoll sich auf dem Desktop eine Verknüpfung nach cmd.exe (das ist die Eingabeaufforderung) anzulegen. Dazu per Rechtsklick auf einen freien Bereich des Desktops und Neu -> Verknüpfung wählen, als Ziel C:\Windows\System32\cmd.exe angeben und das ganze "TAP-Entwicklung" nennen. Die soeben erstellte Verknüpfung wiederrum per rechter Maustaste und Eigenschaften editieren und unter "Ausführen in" C:\work\tap eingeben. Somit startet die Eingabeaufforderung immer im Ordner C:\work\tap, der ja nun als unser Entwicklungsordner dienen soll.

[bearbeiten]

Test

Und nun zum Test: Als erstes eine Kopie des Ordners FIRE (liegt unter C:\work\tap) anlegen und in FIRE2 umbenennen. Somit hat man die Möglichkeit, das Compilieren zu testen, ohne die originalen FireClock Dateien zu überschreiben. In dem kopierten Ordner FIRE2 löscht man nun alle Dateien bis auf build.bat, CLOCK.C und FIRE.C

Nun auf die Verknüpfung TAP-Entwicklung klicken (oder alternativ Start -> Ausführen auswählen, cmd eingeben, ok drücken und dann am Prompt cd C:\work\tap eingeben). Nun ist man mit der Eingabeaufforderung im Ordner C:\work\tap. Als nächstes gibt man am Prompt cd FIRE2 ein und drückt Enter. Nun ist man im Ordner C:\work\tap\FIRE2

Um jetzt die FireClock testweise zu compilieren, gibt man build ein und drückt erneut Enter. Nun startet der Compiliervorgang (das dauert ein paar Sekunden).

Die Ausgaben an der Eingabeaufforderung müssten wie folgt aussehen:

C:\work\tap>cd FIRE2

C:\work\tap\FIRE2>build

C:\work\tap\FIRE2>call ..\gcc clock.c

C:\work\tap\FIRE2>mips-gcc.exe -O2 -c -mtap -mlong-calls -msoft-float -I..\ -I . .\include -I c:\cygwin\usr\include -I c:\cygwin\usr\local\include clock.c

C:\work\tap\FIRE2>call ..\gcc fire.c

C:\work\tap\FIRE2>mips-gcc.exe -O2 -c -mtap -mlong-calls -msoft-float -I..\ -I . .\include -I c:\cygwin\usr\include -I c:\cygwin\usr\local\include fire.c

C:\work\tap\FIRE2>mips-ld -o fireclk.elf -T ..\TAP.ld clock.o fire.o -l tap -l c -Map fireclk.map

C:\work\tap\FIRE2>mips-objcopy -O binary fireclk.elf fireclk.tap C:\work\tap\FIRE2>

Stimmt alles überein, kontrolliert man zur Sicherheit noch einmal den Inhalt des Ordners FIRE2, in dem sich jetzt acht Dateien befinden sollten:

build.bat

CLOCK.C

clock.o

FIRE.C

fire.o

fireclk.elf

fireclk.map

fireclk.tap

Das war's. Jetzt kann mit der TAP-Programmierung in einem gescheiten Texteditor eurer Wahl begonnen werden ...

Sollten beim Compilieren eigener Projekte Fehlermeldung der Art
C:/cygwin/usr/local/include/g++-3/stdio.h:45:23: sys/reent.h: No such file or directory C:/cygwin/usr/local/include/g++-3/stdio.h:46:23: sys/types.h: No such file or directory C:/cygwin/usr/local/include/g++-3/stdio.h:65:23: sys/stdio.h: No such file or directory
auftauchen, suchen Sie bitte Hilfe im TTD-Forum (https://forum.tms-taps.net/)

[bearbeiten]

Installation der Entwicklungsumgebung in vom o.a. Beispiel abweichenden Ordnern:

Die Schritte 1-5 gelten hier genauso, natürlich mit den abweichenden Ordnernamen. Die Pfade entsprechend Punkt 4 sollten selbstverständlich auch angepasst werden. Bevor wir jedoch den abschließenden Test durchführen können müssen noch diese Änderungen gemacht werden:

1. Die Pfadangabe in der ADDPATH.BAT anpassen.

set path=%PATH%;c:\cygwin\usr\local\bin

2. In der GCC.BAT die Pfade anpassen.

mips-gcc.exe -O2 -c -mtap -mlong-calls -msoft-float -I..\ -I ..\include -I c:\cygwin\usr\include -I c:\cygwin\usr\local\include %1 %2 %3 %4 %5 %6 %7 %8 %9

3. In der TAP.LD die beiden ersten Zeilen ändern.

SEARCH_DIR(C:/cygwin/usr/local/lib/gcc-lib/mips/2.95.3/soft-float)

SEARCH_DIR(C:/cygwin/usr/local/lib/)

SEARCH_DIR(./)

SEARCH_DIR(../)

SEARCH_DIR(d:/work/newtap/)

4. Jetzt mit dem abschließenden Test unter o.a. Punkt 6 fortfahren.

[bearbeiten]