IEC-Mate

Die neuste Version kann hier heruntergeladen werden. Bei jedem Start von IEC-Mate wird automatisch auf Updates überprüft.

Fehler können hier gemeldet werden. Über das Einstellungsmenu können die Log Dateien eingesehen werden. Bei einem Bug, bitte Log Datei anhängen.

IEC-Mate soll die Entwicklung von Software unterstützen. Dazu gibt es die folgenden Kernfunktionen:

• Code
• Suche
• Bitset
• dat@net
• DataView
• Helfer

Die dat@net und DataView Funktionen sind sehr spezifisch für KEBA IEC Projekte abgestimmt.

Code

Mit der Code Funktion kann eine Vorlage erstellt werden die drei Variablen enthält. Diese Variablen werden beim generieren durch die Variablen in der Variablenliste ersetzt. So ist es möglich, schnell repetitiven Code zu erstellen.

Die Code Vorlagen können auch als *.txt Datei gespeichert und bei Bedarf wieder importiert werden.

Suche

Mit der Suchfunktion können Wörter innerhalb von Dateien gesucht werden. Als Suchvorschlag werden die im ausgewählten IEC Projekt konfigurierten IO Variablen (Projektname\application\control\config) angezeigt.

Es gibt verschiedene Einstellungen:

• Ganzes Wort suchen: Es werden nur Dateien angezeigt die einen exakten Treffer enthalten (Case-Insensitiv)
• Nur Verzeichnis \config durchsuchen: Es wird nur im Unterverzeichnis Projektname\application\control\config\ gesucht. Dies verkürzt die Suchzeit wenn nur nach einem Hardware-Endpunkt gesucht wird.
• Nur Mask *.xml Dateien durchsuchen: Es werden nur die .xml Dateien die für das HMI relevant sind durchsucht.
• Nur *.java Dateien durchsuchen: Es werden nur Dateien mit dem Dateityp .java durchsucht auch wenn dieser Dateityp ausgeschlossen wurde.
• Im Einstellungsmenu können Dateitypen von der Suche ausgeschlossen werden (Standardmässig sind alle Binärdateien und Java Dateien ausgeschlossen).
• Im Einstellungsmenu kann der Suchvorschlag deaktiviert werden.
• Im Einstellungsmenu kann das Standardmässige öffnen mit Notepad ++ ausgewählt werden. Dies bringt den Vorteil, dass die Datei direkt beim ersten Treffer geöffnet wird.

Die Dateien können mit einem Doppelklick geöffnet werden. Der Ordner in dem die Datei liegt kann mit einem Rechtsklick über das Menu geöffnet werden.

Bitset

Die Bitset-Funktion bietet die Möglichkeit schnell zwischen Binär-, Hexadezimal- und Dezimalzahlen umzurechnen.

dat@net

Spezifisch auf IEC Projekte zugeschnitten sind die Ordner- und Datei-Helfer. Sie ermöglichen einen schnellen Zugriff auf häufig genutzt Dateien und Ordner.

• Mit der Backupfunktion kann das aktuell ausgewählte Verzeichnis als Archiv *.7z gespeichert werden.
• Die Simulation und die Visualisierung für das ausgewählte Projekt kann direkt gestartet werden.
• Die *.puLock Dateien im ausgewählten Projekt zu können gelöscht werden.
• Ein Kundenspez. kann in der Datei systemOptions.properties abgefragt oder geändert werden.
• Das starten der DataView kann in der Datei Start_Simulation.bat deaktiviert werden.

DataView

Spezifisch auf DataView Projekte zugeschnitten sind die Ordner- und Datei-Helfer. Sie ermöglichen einen schnellen Zugriff auf häufig genutzt Dateien und Ordner.

DataView Entwicklung

Die Funktionen in der Box DataView Entwicklung beziehen sich immer auf das Entwicklungsprojekt .\DVIEW_Work\.

DataView Simulation

Die Funktionen in der Box DataView Simulation beziehen sich immer auf das Simulationsprojekt .\view\.

DataView Datenbank

Wenn ein Kundenordner und ein Batch File eingestellt ist, kann hier der eingestellte Batch update_Dataview_simulation_*****.bat direkt ausgeführt werden.

DataView Datenbank Bitset

Hier kann das Bitset zu einem Kundenspez. in der DataView Datenbank abgerufen und geändert werden.

Helfer

Wenn IEC-Mate geöffnet ist, kann mit den konfigurierten Tastenkombinationen die PX Nummer in verschiedenen Variationen in andere Applikationen eingefügt werden.

Einstellungen

IEC-Mate ist auf Deutsch und Englisch lokalisiert. Der Editor hat verschieden Einstellungsmöglichkeiten und ein dunkles Thema ist auch verfügbar.

Anforderungen

IEC-Mate wurde auf MS Windows 10 getestet.

• Windows 10 x86/x64 (Build 1709 / 1909)
• .NET Framework 4.7.2

Falls das .NET Framework 4.7.2 nicht vorhanden sein sollte, bitte der Installationsaufforderung folgen.

Lizenz

IEC-Mate steht unter der MIT Lizenz.

Verwendetet Bibliotheken

Grossen Dank an die Programmierer die Open Source Bibliothek zur Verfügung stellen.

• mahapps
• AvalonEdit
• NHotkey
• Windows Input Simulator Plus
• 7-Zip
• Serilog
• Async MySQL Connector

Entwicklungsumgebung einrichten

Als Entwicklungsumgebung dient Visual Studio 2017 oder 2019. Alle Erweiterungen können direkt in Visual Studio über das Menu Extensions -> Extension Manager installiert werden.

Um die Entwicklung zu vereinfachen sollten folgende Erweiterungen installiert werden:

• GitHub
• AutomaticVersion

Um das Projekt erstellen zu können, werden zwingend folgende Erweiterung benötigt:

• Visual Studio Installer Project

Nun kann über die GitHub Erweiterung das Projekt geklont werden.

Nun kann die IEC Mate.sln Solution geöffnet werden. Wenn die Solution offen ist, kann mit einem Rechtsklick auf Soloution (oberste Ebene) -> Restore NuGet Packages alle benötigten Bibliotheken wieder heruntergeladen werden.

Bekannte Probleme

• Wenn die ganzen Referenzen nicht erkannt werden, muss einfach im Solution Explorer zu den Referenzen navigiert werden. Alle gelben Warnzeichen sollten nach ein paar Sekunden verschwinden.
• Wenn der Fehler Unable to find manifest signing certificate in the certificate store auftritt muss die Signierung vom ClickOnce manifest deaktiviert werden (IEC Mate -> Rechtsklick -> Properties -> Signing -> Sign the ClickOnce manifest deaktivieren)
• Wenn der Error XDG0008 bei Übersetzten der Software auftritt, dann muss die Datei MainWindow.xaml mit einem Rechtsklick -> Exluce from Project vom Projekt entfernt werden. Danach sollte ein Übersetzten ohne Fehler funktionieren. Wenn es immer noch Fehler gibt, kann versucht werden, das Target auf Release zu wechseln und wieder auf Debug zurück. Wenn das Übersetzten fehlerfrei geklappt hat, muss mittel Rechtsklick auf das Projekt IEC Mate -> Add -> Existing Item die Datei MainWindow.xaml.cs wieder hinzugefügt werden.

Release erstellen

1. master branch auschecken
2. Projektmappenkonfiguration auf release stellen
3. Applikation Kompilieren IEC Mate -> Rechtsklick -> Neu Erstellen
4. Setup Version einstellen Setup -> Linksklick -> Deployment Project Properties (Version von IEC-Mate + 1 IEC Mate -> Rechtsklick -> Eigenschaften -> Anwendung -> Assemblyinformation... -> Assemblyversion Build Nummer)
5. Installer Kompilieren Setup -> Rechtsklick -> Neu Erstellen

Das IEC_Mate_Setup.msi befindet sich im Pfad .\MrReSc\IEC-Mate\Setup\Release.

Release veröffentlichen

1. Alle Änderungen nach master pushen.
2. Einen Tag mit der Version (z.B. 1.0.1608) erstellen und ins Repo pushen.
3. Auf https://github.com/MrReSc/IEC-Mate/releases Release bearbeiten und IEC_Mate_Setup.msi hochladen.