JetSym - Compilerdirektiven und Konfigurationen. Welche Direktiven gibt es und wie werden sie eingegeben?

Transkript

1 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Einleitung JetSym verwendet nur einen Prgrammquelltext für alle Steuerungstypen. Im Gegensatz zu DOS-SYMPAS gibt es smit keine steuerungsspezifischen Dateiendungen mehr, wie z.b. *.pnb für NANO-B der *.ppd für DELTA. Um Prgrammvarianten kmfrtabel verwaltet zu können, bietet JetSym eine verbesserte Unterstützung vn Cmpilerdirektiven und die Möglichkeit, diese in Knfiguratinen zusammenzufassen. Möglichkeiten mit Cmpilerdirektiven Sie können Ihr Prgramm in mehrere Funktinsblöcke aufteilen und s Ihr Prjekt übersichtlicher gestalten. Darüber hinaus können Sie Funktinsbiblitheken erstellen und diese leicht in neue Prjekte übernehmen. Funktinen, die nur auf einem bestimmten Steuerungstyp verfügbar sind der drt in einer besnderen Weise prgrammiert werden sllen, können durch Cmpilerdirektiven aktiviert werden. Falls Sie mehrere Varianten der Ausbaustufen Ihrer Maschine bzw. Anlage anbieten wllen, s können Sie leicht die entsprechenden Prgrammteile einbinden. Sie können sich spezielle Prgrammversinen zum Testen und Einrichten Ihrer Maschine bzw. Anlage erstellen, die Ihnen z.b. zusätzliche Bildschirmausgaben, spezielle Prüfrutinen der ähnliches bieten. Beim Einsatz vn Cmpilerdirektiven in Symbldateien ergeben sich nch zusätzliche Möglichkeiten, wie z.b.: Sie können einfach länderspezifische Bedienerführungen realisieren, indem Sie die vrdefinierten Anzeigetexte für das Bedienpersnal mittels Cmpilerdirektiven austauschen. Vrteil für Sie: Sie brauchen nur einen Prgrammquelltext zu erstellen und zu pflegen. Welche Direktiven gibt es und wie werden sie eingegeben? Direktive: #include Um Prgramme übersichtlicher zu gestalten, können Prgrammteile und Teile der Symbldatei in eigenständige Dateien ausgelagert werden. An der Stelle, an der der Inhalt dieser ausgelagerten Dateien eingefügt werden sll, muß im Prgrammquelltext der in der Symbldatei der Befehl eingefügt werden. #include <Dateiname> Den Befehl im Prgrammquelltext einfügen: Halten Sie zum vrangehenden Befehl mindestens ein Leerzeichen Abstand der beginnen Sie eine Prgrammzeile. Drücken Sie dann Taste #, geflgt vn der Taste i. Es öffnet sich ein Parameterdialg, in dem Sie den Pfad und den Namen der Datei eingeben können, die eingebunden werden sll. Wenn Sie die Schaltfläche rechts neben dem Alle Rechte vrbehalten. Die Firma Jetter AG behält sich das Recht vr, Änderungen an ihren Prdukten vrzunehmen, die der technischen Weiterentwicklung dienen. Diese Änderungen werden nicht ntwendigerweise in jedem Einzelfall dkumentiert. Diese Applicatin Nte und die darin enthaltenen Infrmatinen wurden mit der gebtenen Srgfalt zusammengestellt. Die Firma Jetter AG übernimmt jedch keine Gewähr für Druckfehler der andere Fehler der daraus entstehende Schäden. Jetter AG Gräterstrasse 2 D Ludwigsburg Germany Telefn - Zentrale: 07141/ Telefn - Vertrieb: 07141/ Telefn - Technische Htline: 07141/ Telefax: 07141/ Vertrieb: sales@jetter.de Die hier genannten Marken und Prduktnamen sind Warenzeichen - Technische Htline: htline@jetter.de der eingetragene Warenzeichen der jeweiligen Titelhalter. Internetadresse: Artikel-Nr.: Seite 1 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

2 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Eingabefeld betätigen, dann öffnet sich ein weiteres Dialgfenster, in dem Sie die gewünschte Datei mit der Maus auswählen können. Schließen Sie die Dialgfenster danach mittels der entsprechenden Schaltflächen. Der Dateiname muß in Anführungsstrichen stehen, wie in Abbildung 1 zu sehen. Abbildung 1 Befehl in die Symbldatei einfügen: Klicken sie mit der Maus auf die gewünschte Stelle in der Symbldatei und öffnen Sie durch Klicken mit der rechten Maustaste das Kntextmenü. Wählen Sie dann den Menüeintrag Insert Directive. Geben Sie jetzt in der ersten Spalte der neu eingefügten Zeile die Direktive #include ein. Dppelklicken Sie mit der Maus in die zweite Spalte dieser Zeile. Es öffnet sich ein Dialgfenster (vgl. Abbildung 2), den Sie den Dateinamen der einzubindenden Datei direkt eingeben können. Über die Schaltfläche rechts neben dem Textfeld können Sie aber auch ein Auswahlfenster öffnen, in dem Sie die gewünschte Datei mit der Maus auswählen können. Auch hier muß der Dateiname in Anführungsstrichen stehen, wie in Abbildung 3 zu sehen. Abbildung 2 Abbildung 3 Artikel-Nr.: Seite 2 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

3 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Direktive: #ifdef Verwendung: #ifdef <Cmpilerknstante> Blck mit Quelltext der Symblen #endif Bedeutung: Ein Prgrammteil der Teil einer Symbldatei kann bedingt auskmmentiert werden. #ifdef ist wahr, wenn die <Cmpilerknstante> definiert wurde und damit gültig ist. Definiert werden kann eine Cmpilerknstante durch eine Direktive #define <Cmpilerknstante> am Anfang der Symbldatei der über die Prjektknfiguratinen. Nähere Infrmatinen dazu finden Sie weiter unten im Text. Die Direktive #ifdef kann swhl im Symbleditr als auch im Prgrammeditr verwendet werden. Ist die Bedingung erfüllt (Cmpilerknstante ist definiert), s ist der Quelltext bis zur nächsten #endif Direktive gültig, d.h. der Quelltext wird vm Cmpiler bearbeitet. Sie können nicht mehrere Cmpilerknstanten in einer #ifdef-abfrage verknüpfen. Den Befehl im Prgrammquelltext einfügen: Halten Sie zum vrangehenden Befehl mindestens ein Leerzeichen Abstand der beginnen Sie eine Prgrammzeile. Drücken Sie dann Taste #, geflgt vn der Taste f. Es öffnet sich ein Parameterdialg, in dem Sie die Cmpilerknstante eingeben können. Durch Eingabe eines Fragezeichens können Sie eine Liste aller Cmpilerknstanten, die JetSym zu diesem Zeitpunkt bekannt sind, aufrufen. Sie können auch zuerst ein paar Anfangsbuchstaben der Cmpilerknstanten eingeben, geflgt mit einem Fragezeichen, und Sie erhalten eine Liste mit allen Cmpilerdirektiven angezeigt, die mit diesen Anfangsbuchstaben beginnen. Klicken Sie dann auch OK. Die neue Direktive wird in den Quelltext eingefügt (vgl. Abbildung 4). Abbildung 4 Artikel-Nr.: Seite 3 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

4 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Befehl in die Symbldatei einfügen: Klicken sie mit der Maus auf die gewünschte Stelle in der Symbldatei und öffnen Sie durch Klicken mit der rechten Maustaste das Kntextmenü. Wählen Sie dann den Menüeintrag Insert Directive. Geben Sie jetzt in der ersten Spalte der neu eingefügten Zeile die Direktive #ifdef ein. Wechseln Sie in die zweite Spalte dieser Zeile und geben Sie drt die Cmpilerknstante ein. Die entsprechenden Zeilen in der Symbldatei sehen dann ähnlich wie in Abbildung 5 aus. Abbildung 5 Direktive: #ifndef Verwendung: #ifndef <Cmpilerknstante> Blck mit Quelltext der Symblen #endif Bedeutung: Ein Prgrammteil der Teil einer Symbldatei kann bedingt auskmmentiert werden. #ifndef ist wahr, wenn die <Cmpilerknstante> nicht definiert wurde und damit ungültig ist. Definiert werden kann eine Cmpilerknstante durch eine Direktive #define <Cmpilerknstante> am Anfang der Symbldatei der über die Prjektknfiguratinen. Nähere Infrmatinen dazu finden Sie weiter unten im Text. Die Direktive #ifndef kann swhl im Symbleditr als auch im Prgrammeditr verwendet werden. Ist die Bedingung erfüllt (Cmpilerknstante ist nicht definiert), s ist der Quelltext bis zur nächsten #endif Direktive gültig, d.h. der Quelltext wird vm Cmpiler bearbeitet. Sie können nicht mehrere Cmpilerknstanten in einer #ifndef-abfrage verknüpfen. Den Befehl im Prgrammquelltext einfügen: Halten Sie zum vrangehenden Befehl mindestens ein Leerzeichen Abstand der beginnen Sie eine Prgrammzeile. Drücken Sie dann Taste #, geflgt vn der Taste n. Es öffnet sich ein Parameterdialg, in dem Sie die Cmpilerknstante eingeben können. Durch Eingabe eines Fragezeichens können Sie eine Liste aller Cmpilerknstanten, die JetSym zu diesem Zeitpunkt bekannt sind, aufrufen. Sie können auch zuerst ein paar Anfangsbuchstaben der Cmpilerknstanten eingeben, geflgt mit einem Fragezeichen, und Artikel-Nr.: Seite 4 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

5 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Sie erhalten eine Liste mit allen Cmpilerdirektiven angezeigt, die mit diesen Anfangsbuchstaben beginnen. Klicken Sie dann auf OK. Die neue Direktive wird in den Quelltext eingefügt (vgl. Abbildung 6). Abbildung 6 Befehl in die Symbldatei einfügen: Klicken sie mit der Maus auf die gewünschte Stelle in der Symbldatei und öffnen Sie durch Klicken mit der rechten Maustaste das Kntextmenü. Wählen Sie dann den Menüeintrag Insert Directive. Geben Sie jetzt in der ersten Spalte der neu eingefügten Zeile die Direktive #ifndef ein. Wechseln Sie in die zweite Spalte dieser Zeile und geben Sie drt die Cmpilerknstante ein. Die entsprechenden Zeilen in der Symbldatei sehen dann ähnlich wie in Abbildung 7 aus. Abbildung 7 Direktive: #endif Verwendung: #ifdef/#ifndef <Cmpilerknstante> Blck mit Quelltext der Symblen #endif Artikel-Nr.: Seite 5 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

6 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Bedeutung: Mit #endif werden die Direktiven #ifdef und #ifndef abgeschlssen. Den Befehl im Prgrammquelltext einfügen: Halten Sie zum vrangehenden Befehl mindestens ein Leerzeichen Abstand der beginnen Sie eine Prgrammzeile. Drücken Sie dann Taste #, geflgt vn der Taste e. Die neue Direktive wird in den Quelltext eingefügt. Befehl in die Symbldatei einfügen: Klicken sie mit der Maus auf die gewünschte Stelle in der Symbldatei und öffnen Sie durch Klicken mit der rechten Maustaste das Kntextmenü. Wählen Sie dann den Menüeintrag Insert Directive. Geben Sie jetzt in der ersten Spalte der neu eingefügten Zeile die Direktive #endif ein. Direktive: #define Die Direktive #define ist nur in Symbldateien anwendbar. Verwendung: #define <Cmpilerknstante> Bedeutung: Die Direktive #define <Cmpilerknstante> definiert ein Schlüsselwrt, das mit #ifdef bzw. #ifndef abgefragt werden kann. Befehl in die Symbldatei einfügen: Klicken sie mit der Maus auf die gewünschte Stelle in der Symbldatei und öffnen Sie durch Klicken mit der rechten Maustaste das Kntextmenü. Wählen Sie dann den Menüeintrag Insert Directive. Geben Sie jetzt in der ersten Spalte der neu eingefügten Zeile die Direktive #define ein. Wechseln Sie in die zweite Spalte dieser Zeile und geben Sie drt die Cmpilerknstante ein. Die entsprechenden Zeilen in der Symbldatei sehen dann ähnlich wie in Abbildung 8 aus. Artikel-Nr.: Seite 6 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

7 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Abbildung 8 Vrdefinierte Cmpilerknstanten Wenn Sie JetSym neu starten und ein neues Prjekt anlegen, dann werden z. Zt. vn JetSym autmatisch diese Cmpilerknstanten definiert: _DEBUG NDEBUG _CONTROLLER_D_CPU _CONTROLLER_D_CPU2 _CONTROLLER_DELTA _CONTROLLER_JC_241 _CONTROLLER_JC_243 _CONTROLLER_JC_246 _CONTROLLER_JC_24x _CONTROLLER_NANO _CONTROLLER_NANO_A _CONTROLLER_NANO_B _CONTROLLER_NANO_C _CONTROLLER_NANO_D Ist definiert, wenn die Knfiguratin "Debug" als aktive Knfiguratin gesetzt wurde. Ist definiert, wenn die Knfiguratin "Release" als aktive Knfiguratin gesetzt wurde. Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "D-CPU" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "D-CPU2" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "D-CPU" der "D-CPU2" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "JC-24x" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "NANO-A", "NANO-B", "NANO-C", "NANO-D" der "PCPPLC" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "NANO-A" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "NANO-B" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "NANO-C" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "NANO-D" Artikel-Nr.: Seite 7 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

8 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen _CONTROLLER_PASE_E _CONTROLLER_PCPPLC Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "PASE-E+" Ist definiert, wenn in den "Prject Settings" als Steuerungstyp "PCPPLC" Die "Prject Settings" sind über den Menüeintrag Prject und dann Settings... erreichbar. Verwaltung vn Direktiven Manuell: Liste mit #define anlegen Wie schn vn DOS-SYMPAS bekannt, kann eine Liste vn #define Direktiven am Anfang einer Symbldatei angelegt und verwaltet werden, die dann jeweils manuell gesetzt bzw. auskmmentiert werden. Nachteil: es muß immer aufs Neue überlegt werden, welche Direktiven zu setzen bzw. zu löschen sind -> mögliche Fehlerquelle Autmatisch: Knfiguratinen anlegen JetSym bietet die Möglichkeit mehrere Knfiguratinen zu definieren und einfach zu verwalten. Vrteil: Die Knfiguratinen werden einmal definiert und können dann unverändert bleiben. Für neue Anfrderungen werden einfach neue Knfiguratinen definiert, die bisherigen Knfiguratinen sind aber weiterhin abrufbar -> weniger Fehlermöglichkeiten. Knfiguratinen Knfiguratinen anlegen Über den Menüeintrag Build / Cnfiguratins... ist ein Dialg mit dem Titel "Cnfiguratins" (siehe Abbildung 9) erreichbar, in dem alle Knfiguratinen des geöffneten Wrkspace bearbeitet werden können: Abbildung 9 Wllen Sie eine neue Knfiguratin erstellen, dann wählen Sie das entsprechende Prjekt aus und drücken Sie die Schaltfläche Add.... Es öffnet sich ein weiterer Dialg mit dem Titel "Add Prject Cnfiguratin" (siehe Abbildung 10), in dem sie den Namen der neuen Knfiguratin eingeben können. Hier können sie auch festlegen, welche Artikel-Nr.: Seite 8 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

9 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen schn bestehende Knfiguratin dieses Prjekts hierzu kpiert werden sll. Bestätigen Sie dann, indem Sie die Schaltfläche OK klicken. Abbildung 10 Wurden alle gewünschten Knfiguratinen angelegt, dann schließen Sie den "Cnfiguratins"-Dialg, indem Sie auf die Schaltfläche Clse klicken. Artikel-Nr.: Seite 9 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

10 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Vrdefinierte Knfiguratinen Wenn Sie JetSym neu starten und ein neues Prjekt anlegen, dann werden z. Zt. vn JetSym autmatisch diese Knfiguratinen angelegt: Debug: Die Direktive _DEBUG ist definiert. Release: Die Direktive NDEBUG ist definiert. Knfiguratinen aktivieren Über den Menüeintrag Build / Set Active Cnfiguratin... ist ein Dialg mit dem Titel "Set Active Prject Cnfiguratins" (siehe Abbildung 11) erreichbar, in dem alle Knfiguratinen des geöffneten Wrkspace aufgelistet sind. Abbildung 11 Wählen Sie eine der aufgelisteten Knfiguratinen aus und klicken Sie auf die Schaltfläche OK. Die gewählte Knfiguratin wird daraufhin aktiv gesetzt und ggf. das entsprechende Prjekt zum aktiven Prjekt gemacht. Direktiven für Knfiguratinen setzen Das Dialgfenster der Prject Settings kann, wie in Abbildung 12 gezeigt, über den Menüeintrag Prject / Settings (Tastenkmbinatin Alt + F7) der über das Kntextmenü des Prjekts im FileView-Fenster geöffnet werden. Artikel-Nr.: Seite 10 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

11 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Abbildung 12 Abbildung 13 Artikel-Nr.: Seite 11 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

12 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Das Dialgfenster der Prject Settings, wie es sich in Abbildung 13 zeigt, teilt sich in zwei Hälften: In der linken Dialghälfte ist eine Übersicht über das gewählte Prjekt dargestellt. Die einzelnen Elemente dieser Übersicht sind (vn ben nach unten): Der Name des Prjekts, dessen Einstellungen mmentan bearbeitet werden. Die Dateinamen der Prgrammtext- und Symbl-Hauptdatei ("ifdef.spf" bzw. "ifdef.ssf"). Die Versinsnummer des Prjekts. Die aktuelle Entwicklungssprache (zur Zeit unveränderbar auf "English" eingestellt). Der Name der Knfiguratin, deren Einstellungen auf der rechten Hälfte des Dialgfensters bearbeitet werden kann. Eine Beschreibung der einzelnen Einstellmöglichkeiten für Knfiguratinen flgt weiter unten. (Abbildung 13 zeigt, dass für das Beispielprjekt im Eingabefeld Settings Fr die Knfiguratin Debug eingestellt ist.) Ein Textfeld für einen kurzen Kmmentar zum Prjekt. Dieser Kmmentar gilt für alle Knfiguratinen. Auf der rechten Hälfte des Dialgfensters sind knfiguratinsspezifische Einstellungen angezeigt, wbei sich die Angaben wiederum auf fünf Registerkarten verteilen: Registerkarte General (siehe Abbildung 13): Die vm Cmpiler erzeugten Ausgabedateien können abhängig vn der Knfiguratin autmatisch in verschiedene Verzeichnisse abgelegt werden. Einstellbar sind unabhängig vneinander die Verzeichnisse für tempräre (Intermediate files) und endgültige (Output files) Dateien. Zudem können nch das Zielverzeichnis und der Dateiname der EPROM-Datei (das ist die Prgrammdatei, die später in die Steuerung geladen wird) und einer ggf. zu erstellenden Knstantendatei (Data Dump cnstants), d.h. die Datei mit den Register-Vrgabewerten, festgelegt werden. Registerkarte Sympas (siehe Abbildung 14): Hier können Cmpiler-Direktiven für die aktuelle Knfiguratin gesetzt werden. Abbildung 14 Artikel-Nr.: Seite 12 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

13 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Registerkarte Cntrller (siehe Abbildung 15): Die Einstellungen in dieser Registerkarte beziehen sich auf das angeschlssene Steuerungssystem, für die das Prjekt übersetzt werden sll. Ebenfalls sind hier die Einstellungen der Schnittstelle und die Übertragungsparameter für den Prgramm-Dwnlad veränderbar. Abbildung 15 Registerkarten Custmer (Abbildung 16) und Cmmissin (Abbildung 17): In diese beiden Registerkarten können bei Bedarf nch Infrmatinen (Adresse, Telefn, Ansprechpersn etc.) vn Kunden eingetragen werden. Abbildung 16 Abbildung 17 Nachdem Sie alle Einstellungen vrgenmmen haben, können Sie das Dialgfenster der Prject Settings durch Klicken auf die Schaltfläche OK (siehe Abbildung 13) schließen. Artikel-Nr.: Seite 13 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc

14 Applicatin Nte JetSym - Cmpilerdirektiven und Knfiguratinen Merkregel In einem Wrkspace gibt es immer nur ein aktives Prjekt mit einer aktiven Knfiguratin! Wichtig! Dieses Prjekt mit dieser Knfiguratin dient als Grundlage für den Cmpiler und den Dwnlad. Nur die Einstellungen, die in dieser Knfiguratin gemacht sind, werden vn JetSym beachtet. Artikel-Nr.: Seite 14 vn März 2002 / Wlfgang Becker Ausgabe: 2.0 APN JetSym_Cmpiler_d.dc