Voraussetzung für die Verwendung des Imports

• Sie haben die benötigte Lizenzierung installiert.

• Sie haben das Installationspaket com.logicals.simulink.export-x.y.z.zip von logi.cals erhalten. x.y.z steht für die entsprechende Versionsnummer.
  Dieses Installationspaket enthält Scripts, die Sie in MATLAB ausführen müssen.

• Sie verwenden Version 2021a von MATLAB und Embedder Coder als Code-Generator (siehe https://de.mathworks.com/products/embedded-coder.html).

• Der Import unterstützt nur zeitdiskrete Simulink-Modelle (= time discrete Simulink models). 2 oder mehrere unterschiedliche "Sampling Times" in einem Simulink-Modell werden beim Import nicht unterstützt.
  Beachten Sie zusätzlich: Falls das Simulink-Modell von der Zykluszeit abhängt, muss der Simulink-Anwender darüber entscheiden, wie dies im Simulink-Modell gelöst werden kann. Beispielsweise ist es möglich, einen speziellen Eingang im Simulink-Modell zu definieren, der dann in logi.CAD 3 importiert wird. In der logi.CAD 3-Anwendung müssen dann die Zeitwerte diesem Eingang übergeben werden.

• Das Simulink-Modell entspricht den Vorgaben für einen erfolgreichen Import.

• Im Simulink-Model: Verwenden Sie POE-eindeutige Namen (wenn möglich, sogar projekt- und POE-eindeutig) für alle C-Identifier, die in einem globalen Namespace verfügbar sind. Siehe "Grundregeln für das Arbeiten, Erstellen von Bausteinen mit C-Code" für Details.

• Sie verwenden die gleiche logi.CAD 3-Version für beide Teil-Schritte des Imports:

  • Simulink-Modell als MATLAB-Export-Bundle exportieren

  • MATLAB-Export-Bundle in die IDE importieren

Simulink-Modell als logi.CAD 3-MATLAB-Export-Bundle exportieren

1. Entpacken Sie das Installationspaket com.logicals.simulink.export-x.y.z.zip in einen beliebigen Ordner.

2. Fügen Sie den Pfad mit den entpackten Scripts dem Suchpfad von MATLAB hinzu.

   1. Möglichkeit 1: Navigieren Sie in MATLAB zum Pfad mit den entpackten Scripts. Öffnen Sie das Kontextmenü für den Ordner und wählen Sie den Befehl Add to Path und Selected Folders aus.
      

   2. Möglichkeit 2: Geben Sie im MATLAB Command Window den folgenden Befehl ein (ersetzen Sie path_to_folder_with_scripts durch den Pfad mit den entpackten Scripts): addpath('path_to_folder_with_scripts')

   3. Möglichkeit 3, damit der Pfad permanent eingefügt wird: Wählen Sie Set Path (in der Gruppe ENVIRONMENT) des Registers HOME in der Multifunktionsleiste von MATLAB. Klicken Sie auf Add Folder..., fügen Sie den Pfad mit den entpackten Scripts hinzu und drücken Sie Save.
      

3. Öffnen Sie das Simulink-Modell und – falls vorhanden – die jeweiligen Projekte in MATLAB.
   Grund: Die Projekte können sogenannte "Data Dictionaries" mit benutzerdefinierten Typen enthalten.

4. Führen Sie eines der folgenden Scripts im MATLAB Command Window aus:

   Script 1: Bundle basierend auf einem Modell erzeugen

   generateLogiCAD3BundleFromModel(modelName, outputFolder)

   Ersetzen Sie dabei die Parameter modelName durch den Namen des geöffneten Modells und outputFolder durch den Pfad, in dem das logi.CAD 3-MATLAB-Export-Bundle abgelegt werden soll.
   Beispiel: generateLogiCAD3BundleFromModel('fuelsys_dd_controller', "C:\data\exported_bundles")

   Script 2: Bundle basierend auf einem Modell und Subsystem erzeugen

   generateLogiCAD3BundleFromSubsystem(modelName, subsystemQualifiedName, outputFolder)

   Ersetzen Sie dabei die Parameter modelName und outputFolder analog zu Script 1. Zusätzlich ersetzen Sie subsystemQualifiedName durch den qualifizierten Namen des Subsystems.
   Beispiel: generateLogiCAD3BundleFromSubsystem('Overrun', 'Overrun/OvrRun', "C:\data\exported_bundles")Ergebnis des Scripts: Ein logi.CAD 3-MATLAB-Export-Bundle wird auf Basis der angegebenen Daten erzeugt. Der Name dieses logi.CAD 3-MATLAB-Export-Bundle ist: Simulink_Modell_Name_logiCAD3Bundle.zip oder Subsystem_Name_logiCAD3Bundle.zip – Beispiel: OvrRun_logiCAD3Bundle.zip (OvrRun ist der Name des Subsystems.)

logi.CAD 3-MATLAB-Export-Bundle in logi.CAD 3 importieren

So importieren Sie das erzeugte logi.CAD 3-MATLAB-Export-Bundle in das Projekt von logi.CAD 3:

1. Im Menü Datei oder im Kontextmenü der Sicht mit Projekten/Ressourcen wählen Sie Importieren...

2. Im Assistenten klappen Sie die Kategorie Simulink-Modell-Import auf, wählen Sie Import eines Simulink-Modells und drücken Sie Weiter >.
   Um einen bestimmten Assistenten zu finden: Tippen Sie einen Text (z.B. Simulink) im Feld unter Einen Import-Assistenten wählen ein, um nur jene Assistenten anzuzeigen, die dem Text im Feld entsprechen.
   

3. Auf der nächsten Seite des Assistenten führen Sie diese Schritte aus:

   1. Tippen Sie den vollständigen Pfad und den Dateinamen des zuvor erzeugten logi.CAD 3-MATLAB-Export-Bundles im Textfeld (links von Simulink-Bundle) ein. Alternative: Drücken Sie die Schaltfläche Durchsuchen..., um Pfad und Dateinamen im Dateisystem zu wählen.

   2. Wählen Sie das Projekt, in das das logi.CAD 3-MATLAB-Export-Bundle importiert werden soll, in der Liste unter Ziel-Projekt aus.
      Diese Liste enthält alle Projekte, die in der Sicht geöffnet sind.

   3. Drücken Sie Fertigstellen, um den Import zu starten.
      Ergebnis: Die folgenden Objekte werden auf Basis des logi.CAD 3-MATLAB-Export-Bundles im Projekt erstellt:
      

      Objekt-Typ	Bedeutung
      ST-Objekt	Das ST-Objekt hat den Namen des Simulink-Modells. Es enthält zumindest einen →Vendor-Baustein vom Typ "→Funktionsbaustein" mit dem gleichen Namen. Abhängig davon, welches Simulink-Model exportiert wurde, können auch andere ST-Sprachelemente im ST-Objekt enthalten sein, z.B. ein →strukturierter Datentyp. Strings werden mit einer Standard-Stringlänge von 256 importiert. Bearbeiten Sie diese ST-Sprachelemente nicht! Falls Sie doch Änderungen machen, stimmen die ST-Sprachelemente nicht mehr mit dem importierten Simulink-Modell überein. Sie können diesen erzeugten Funktionsbaustein wie jeden anderen Funktionsbaustein in Ihrer Anwendung verwenden. Erstellen Sie z.B. eine →Funktionsbaustein-Instanz und rufen Sie diese Funktionsbaustein-Instanz auf oder fügen Sie den Funktionsbaustein in eine Bibliothek ein. Verweise auf weiterführende Dokumentation: Siehe "Deklaration von Funktionsbaustein-Instanzen in ST" und "Aufruf der Funktionsbaustein-Instanz in ST" für die ST-Syntax zum Instanziieren/Aufrufen des Funktionsbausteins. Siehe "Unterstützte ST-Syntax" für eine Liste aller möglichen ST-Elemente. Siehe die englische Dokumentation "Administrator's Manual" für Informationen über die Pragmas eines Vendor-Bausteins, wie z.B. zu { CustomImplementation, CustomNamespace := Simulink }.
      H- und C-Dateien	Der erstellte Vendor-Funktionsbaustein benötigt H- und C-Dateien, die die Implementierung des Vendor-Funktionsbausteins enthält. Diese Dateien werden automatisch beim Import im Projekt erstellt und standardmäßig im Unterordner src-code des vorgegebenen Projekt-Unterordners src angezeigt. Zusätzlich werden d ie H- und C-Dateien aus MATLAB in das Projekt importiert. Standardmäßig werden diese Dateien im Projekt im Unterordner src-code parallel zum vorgegebenen Projekt-Unterordners src angezeigt. Damit diese H- und C-Dateien nicht irrtümlich bearbeitet werden und weiterhin mit dem importierten Simulink-Modell übereinstimmen, bietet Ihnen logi.CAD 3 diese Möglichkeiten: Mit Hilfe der K onfigurationsvariable lc3.src_code.filter.enable können Sie den Unterordner src-code mit den C-/H-Dateien ausblenden. Details zu den K onfigurationsvariablen finden Sie in der englischen Dokumentation "Administrator's Manual". Standardmäßig sind d ie H-/C-Dateien für das importierte Simulink-Modell schreibgeschützt. Falls die C-/H-Dateien angezeigt werden und Sie eine dieser Dateien bearbeiten, weist Sie eine Meldung auf diesen Schreibschutz hin. Entfernen Sie in Folge nicht den Schreibschutz, damit die H-/C-Dateien mit dem importierten Simulink-Modell auch weiterhin übereinstimmen.
      Bibliothekskonfiguration	Die Bibliothekskonfiguration enthält bereits den Vendor-Funktionsbaustein als Bibliothekselement – und zwar bei der Anweisung IEC := ... Mit Hilfe dieser Bibliothekskonfiguration können Sie eine Bibliothek erstellen, der den Vendor-Funktionsbaustein enthält. Verweise auf weiterführende Dokumentation: Siehe "Syntax für Bibliothekskonfiguration" für die Syntax der Bibliothekskonfiguration. Siehe "Eigene Bibliothek erstellen und bereitstellen" für Anweisungen zum Erzeugen/Bereitstellen/Installieren einer Bibliothek.

Vorgaben für das Simulink-Modell