conv_to_SoftPlc7

| ALPHA-VISION® SoftPlc7

# Projekt-Konvertierung zur SoftPlc7

Ein bestehendes S7-Projekt kann ohne großen Aufwand in eine SoftPlc7 übernommen werden.
Folgende Aktionen sind dazu notwendig:

- Konvertieren

Ein bestehendes S7-Programm wird in die SoftPlc7-Umgebung importiert.

- SoftPlc7.ini

Datei an das importierte Programm anpassen.

- Konsistenzprüfung

Es wird geprüft, ob alle Bausteine vorhanden sind.

- Aufrufanalyse

Der Bediener prüft die Plausibilität der Anzeige.

- Laufzeitprüfung

Das S7-Programm wird gestartet.

### Dateistruktur

Die Programm-Dateien der SoftPlc7 liegen im Ordner ...\Vision\bin, ebenso die SoftPlc7.ini Datei.

Die zu einem S7-Programm gehörenden Dateien werden in einem eigenen Projektordner abgelegt.

### Konvertieren

Nach Start des Programms SoftPlc7.exe kann in dem Dialogfenster über das Rollmenü Datei der Menüpunkt Konvertieren... aufgerufen werden.
In das sich öffnende Dialogfenster werden das Quellverzeichnis, z.B.:

     SIEMENS/Step7/S7Projekt/prj_name/ombstx/offline/00000001

und das Zielverzeichnis, z.B.:

     Vision\S7_prj/Projektname

eingetragen.
(Spätestens jetzt muß der SIMATIC-Manager geschlossen werden)
Wahlweise kann auch über die Schaltfläche S7-Programm... in einen Datei-Browser verzweigt werden. In diesem sind Simatic-Projekte besonders gekennzeichnet. Steht der Cursor auf einem Projektverzeichnis, so werden in einem zweiten Fenster alle zugehörigen Quellverzeichnisse der S7-Programme aufgelistet. Aus diesen kann nun ein Verzeichnis ausgewählt und in den ursprünglichen Dialog übernommen werden.
Über die Schaltfläche "Konvertieren" wird die Übernahme des S7-Programms gestartet.

- Es kann nur ein Programm gleichzeitig übernommen werden.
- Im Fenster "Meldungen" wird der Fortschritt der Konvertierung angezeigt.
- Fehlt das Quell- oder Zielverzeichnis, wird die Konvertierung nicht gestartet.
- Treten Fehler auf, wird in einem Meldefenster die Fehlerursache angegeben.

Die Konvertierung kann auch beim Kommandoaufruf durch Parameterübergabe durchgeführt werden, siehe: Kommandoaufruf /c

### SoftPlc7.ini Datei

In der SoftPlc7.ini-Datei stehen Parameter/Informationen der Laufzeit.
- Der Default-Name ist SoftPlc7.ini
  Wird dieser nicht verwendet, muß der Name der INI-Datei als Parameter beim Kommandoaufruf /ini= mitgeliefert werden.

- Werden SoftPlcs instanziiert, muß für jede Instanz eine SoftPlc7.ini-Datei erstellt werden,
  d.h. der Defaultname "SoftPlc.ini" muss durch einen projektspezifischen ersetzt werden.

- Eine Standard-SoftPlc7.ini-Datei wird mitgeliefert.
  Aufbau der INI-Datei
  Die Datei ist in Sektionen gegliedert, die beliebig viele Einträge haben können.

  Nur ein sehr geringer Teil bedarf der Anpassung an ein spezifisches Projekt und ist im Folgenden entsprechend gekennzeichnet.

  In einige Sektionen trägt das System vom Benutzer gemachte Angaben ein, z.B. beim Konvertieren die "from" und "to" Pfade in die Sektion "Convert", diese werden beim nächsten Aufruf des Konvertierprogramms als Voreinstellung angeboten.
  Folgende Sektionen sind derzeit möglich:
  (Abhängig der Funktionalität und der verwendeten Hardware sind nicht alle Sektionen vorhanden.)
  [HLL-Funktionen] ! Einträge prüfen !
  Hier werden Bausteine gelistet, deren Funktionalität in DLLs nachgebildet wurde. Es müssen alle Programmbausteine, die eine DLL-Entsprechung haben, gelistet sein.

  Baustein-Name=Entsprechung in DLL

  Für die Syntax siehe Dokumentation: | SoftPlc7_ini
  Für verfügbare Bausteine in einer DLL siehe: | System & PlcNet Bausteine
  | AbvSpu Bausteine
  | AciConnect Bausteine
  | OPC-Server Bausteine

  [OBx] nur bei Abweichung von Defaultwerten
  Falls Parameter der Organisationsbausteine vom Default-Wert abweichen, müssen sie hier mit ihrer Abweichung definiert werden. (OBs ohne Abweichung brauchen überhaupt nicht gelistet werden.)
  Mögliche Parameter siehe Dokumentation: SoftPlc7_ini
  [OB1] nur bei Abweichung vom Defaultwert
  Entspricht OBx, hat den zusätzlichen Parameter "CycleMonitoring"
  [Run]
  Hier listet das System das zuletzt aktive SoftPlc7-Projekt.
  [Convert]
  Hier listet das System die Pfade des zuletzt konvertierten S7-Programms.
  [StartUp]
  Mögliche StartUp-Parameter siehe: SoftPlc7_ini
  [Aci] !! modifizieren !!
  Definiert die Datenobjekt-Datei *.do aus der Visualisierung.
  [AciConnect]
  Syntax siehe Dokumentation: SoftPlc7AciConnect
  [PG]
  Definiert die Parameter zur Debug-Schnittstelle.

  Bedienung, mögliche Parameter siehe Dokumentation: SoftPlc7PG
  [Watch]
  Definiert die Häufigkeit der Debug-Wertabfrage.

  Parameter siehe Dokumentation: SoftPlc7_ini
  [Retentive]
  Definiert Anzahl remanenter Flags, Timer und Zähler.

  Falls Parameter vom Default-Wert abweichen, müssen sie hier mit ihrer Abweichung definiert werden. (Parameter mit Defaultwerten brauchen nicht gelistet werden.)

  siehe Dokumentation: SoftPlc7_ini
  [Exit]
  Abweichend vom Standardverhalten einer SIMATIC-S7 kann hier zusätzlich definiert werden, ob die aktuellen Daten gespeichert werden sollen.
  Parameter siehe Dokumentation: SoftPlc7_ini

  ### Konsistenzprüfung

  Nach Start des Programms SoftPlc7.exe kann im Dialogfenster über das Rollmenü Datei der Menüpunkt Konsistenzprüfung aufgerufen werden.
  Bei der Konsistenzprüfung wird geprüft, ob alle Bausteine vorhanden sind; fehlende Bausteine werden in einem Meldefenster gelistet.
  Hints&Tip:
  In der S7-Umgebung müssen Bausteine der Bibliothek nicht zusätzlich im Projektordner stehen; beim Konvertieren zur SoftPlc7 werden aber nur Bausteine aus dem Offline-Ordner übernommen. Im SIMATIC-Manager müssen also vor dem Konvertieren mindestens die Bibliotheksbausteine in das S7-Programm übernommen werden, die im Projekt Verwendung finden.

  ### Aufrufanalyse

  Nach Start des Programms SoftPlc7.exe kann im Dialogfenster über das Rollmenü Datei der Menüpunkt Aufrufanalyse ausgewählt werden.
  Die Aufrufanalyse geht durch das S7-Programm und listet alle Bausteine in einem Baum.
  - Bausteinname in Fettschrift bedeutet, dieser Baustein ist in der INI-Datei gelistet, wird also über eine DLL ausgeführt.
  - Bausteinname in Normalschrift bedeutet, dieser Baustein wird als Standard-S7-Code ausgeführt.
  - Bausteinname in Klammern bedeutet, dieser Baustein wird nicht aufgerufen. (siehe Hints&Tips)
  - + vor dem Baustein ermöglicht, über Mausklick anzuzeigen, von welchem(n) Baustein(nen) dieser Baustein aufgerufen wird.
  Hints&Tip:

  Systembausteine müssen immer in Fettschrift erscheinen - gegebenenfalls in INI-Datei eintragen.

  Nicht-Systembausteine, die in Fettschrift erscheinen, prüfen - grundsätzlich können alle Bausteine über eine DLL ausgeführt werden, aber z. Zt. eher unwahrscheinlich. Ausnahmen sind die Funktionen "FC5, FC6, FC8, FC50, FC60" (send - recv), hier ist beides möglich, trotzdem sicherstellen.

  Die Bausteinanzeige in Klammern (dieser Baustein wird nicht aufgerufen) ist unter Vorbehalt zu sehen, da ein Baustein, der nur indirekt, z.B. UC FC[MW03], aufgerufen wird, von der Aufrufanalyse nicht erkannt werden kann und so als "nicht aufgerufen" definiert wird.

  ### Laufzeitprüfung

  Falls das Programm unerwartet in den STOP-Zustand geht, liegt ein S7-Fehler vor.

  Zur weiteren Analyse kann der SIMATIC Manager oder über das Rollmenü "Ansicht", Auswahl "Testbetrieb" der SoftPlc7Testbetrieb genutzt werden.