Schnittstellen hinzufügen / bearbeiten / löschen
Mit Hilfe des TwinCAT Module Class (TMC) Editors können Schnittstellen eines TwinCAT Moduls hinzugefügt, bearbeitet und gelöscht werden.
Dieser Artikel beschreibt:
- Schritt 1: Eine neue Schnittstelle in der TMC-Datei erstellen.
- Schritt 2: Der Schnittstelle in der TMC-Datei Methoden hinzufügen.
- Schritt 3: Verwenden Sie die Schnittstelle, indem Sie diese zu „Implemented Interfaces“ des Moduls hinzufügen.
- Schritt 4: Starten Sie den TwinCAT TMC Code Generator, um einen Code für die Modulbeschreibung zu erzeugen.
- Optionale Änderung der Schnittstelle.
Schritt 1: Eine neue Schnittstelle erzeugen
- 1. Wählen Sie nach dem Starten des TMC Editors den Knoten Data Types aus.
- 2. Klicken Sie auf Add a new interface, um die Liste der Schnittstellen um eine neue Schnittstelle zu erweitern.
- Daraufhin wird IInterface1 als neuer Eintrag aufgeführt:
- 3. Entweder wählen Sie den entsprechenden Knoten im Baum oder machen einen Doppelklick auf die Zeile in der Tabelle, um die Einzelheiten zu öffnen.
- 4. Geben Sie einen aussagekräftigeren Namen ein - in diesem Beispiel „IStateMachine“.
Schritt 2: Fügen Sie der Schnittstelle Methoden hinzu
- 1. Klicken Sie auf Edit Methods..., um eine Liste der Methoden dieser Schnittstelle zu erhalten:
- 2. Klicken Sie auf die + Schaltfläche um eine neue standardmäßige Methode „Method1“ zu erzeugen:
- 3. Doppelklicken Sie auf die Methode oder wählen den Knoten im Baum aus, um Einzelheiten zu öffnen.
- 4. Geben Sie der standardmäßigen „Method1“ einen aussagekräftigeren Namen.
- 5. Anschließend können Sie mit einem Klick auf Add a new parameter Parameter hinzufügen bzw. Parameter der Methode „SetState“ bearbeiten.
- Standardmäßig wird der neue Parameter „Parameter1“ als „Normal Type“ „INTEGER“ erzeugt.
- 6. Bearbeiten Sie den Parameter durch einen Klick auf den Namen „Parameter1“.
- Der „Normal Type“ kann auch in „Pointer“ geändert werden usw. - auch kann der Datentyp selber ausgewählt werden.
- In diesem Falle ist „NewState“ der neue Name - die übrigen Einstellungen werden nicht geändert.
- 7. Durch Wiederholen des Schritts 2 „Methoden zur Schnittstelle hinzufügen“ werden alle Methoden aufgelistet - mit Hilfe der nach oben / nach unten Schaltfläche ordnen Sie die Methoden neu.
- 8. Die Schnittstelle ist bereit, durch Ihr Modul implementiert zu werden.
Schritt 3: Die neue Schnittstelle zu Implemented Interfaces hinzufügen
- 1. Wählen Sie das Modul, das mit der neuen Schnittstelle erweitert werden soll - in diesem Falle wählen Sie das Ziel Modules->CModule1.
- 2. Erweitern Sie die Liste der implementierten Schnittstellen um eine neue Schnittstelle durch Klick auf die + Schaltfläche mit Add a new interface to the module.
- 3. Alle verfügbaren Schnittstellen werden aufgeführt - wählen Sie die neue Vorlage „IStateMachine“ und beenden Sie mit OK.
- Die neue Schnittstelle „IStateMachine“ ist Teil der Modulbeschreibung.
Schritt 4: Starten Sie den TwinCAT TMC Code Generator, um einen Code für die Modulbeschreibung zu erzeugen.
- 1. Um den C/C++ Code anhand von dieser Modulbeschreibung zu generieren, klicken Sie mit der rechten Maustaste in das C/C++ Projekt und wählen dann den TwinCAT TMC Code Generator.
- Daraufhin enthält das Modul „Module1“ die neuen Schnittstellen
CModule1: Start()
CModule1: Stop()
CModule1: SetState(SHORT NewState).
- Fertig - der benutzerdefinierte Code kann nun in diesen Bereich eingefügt werden.
Optionale Änderung der Schnittstelle
 | Benutzerdefinierter Code wird nie gelöscht Im Fall von Änderungen an der Schnittstelle (z. B. die Parameter einer Methode werden später erweitert) wird benutzerdefinierter Code nie gelöscht. Stattdessen wird die bestehende Methode lediglich mit einem Kommentar versehen, wenn der TMC Code Generator die Methoden nicht mappen kann. |
