Modbus Profile verwalten
In der Modbus Profil Verwaltung können die lokal im Profil Katalog gespeicherten Modbus Profile administriert werden.
Es können neue Profile hinzugefügt, unbenutzt gelöscht und Profile exportiert und importiert werden.
hinweis Im Modbus Geräte Manager können nur Modbus Geräte auf Basis eines Modbus Profils eingebunden werden. Es ist daher immer erforderlich, zunächst ein Modbus Profil anzulegen bzw. in den Profil Katalog zu importieren.
Freigegebene Modbus Profile anderer Nutzer finden Sie hier: Timberwolf Modbus Unterforum.
Inhalt
Modbus Profil Verwaltung
Übersicht
Die weltweit angebotenen Modbus Geräte verfügen über unterschiedliche Eigenschaften und stellen jeweils eine individuelle Kombination aus Datenaustauschpunkten für das Lesen und Schreiben zur Verfügung. Die Hersteller informieren in Datenblätter über die jeweils unterstützten Datenaustauschpunkte („Register“), die jeweiligen Datenformate sowie weitere gerätespezifische Informationen.
Der Timberwolf Server ermöglicht es, diese Definition der Datenaustauschpunkte in einem interaktiven Profil Editor auf komfortable Weise vorzunehmen. Der Profil Editor wird durch Betätigen der Schaltflächen „Hinzufügen“ bzw. „Editieren“ für bestehende Profile aufgerufen und erscheint in der Web-APP unterhalb des Profil Katalogs.
Aufruf Modbus Profil Verwaltung
Unter Modbus → Profil Verwaltung steht sowohl die Verwaltung der Modbus Geräteprofile als auch der Profil Editor zur Verfügung.
Im oberen Teil des Bildschirmes wird der Profil Katalog angezeigt:
In diesem Profilkatalog können Sie diejenigen Modbus Geräteprofile verwalten, die auf diesem Timberwolf Server zur Verfügung stehen.
Die Konfiguration der Kommunikationsregeln (“Applikation”) im Modbus Geräte Manager basiert auf den im Katalog des Timberwolf Servers gespeicherten Profilen. Sollte ein neues Modbus Gerät vom Timberwolf Server angesprochen werden, muss zuvor ein Modbus Geräteprofil angelegt werden (mit + Hinzufügen)
Der Ausgangspunkt hierfür ist diese Modbus Profil Verwaltung. Profile können von dieser Anzeige aus angelegt, gesucht, geändert, kopiert, gelöscht sowie ex- und importiert werden.
Suche im Modbus Profil Katalog:
Herstellersuche: In der Auswahlbox kann der gewünschte Hersteller selektiert werden. Es werden nur diejenigen Hersteller angezeigt, für die sich Profile im Katalog befinden oder die einmal in das System eingegeben wurden.
Tabellenfilter: Die oberste Zeile in der Tabelle der Modbus Profile dient zur Eingabe eines Filters für eine weitere Einschränkung der Suchergebnisse.
Anzeigeelemente im Modbus Profil Katalog
Profil ID: Jedes erstellte Profil erhält automatisch eine einmalige ID durch den Timberwolf Server. Diese ID kann nicht vom Nutzer (Autor) beeinflusst werden. Diese ID besteht aus der Nummer des Timberwolf Servers und einer fortlaufenden Nummer.
Hinweis Bei Import von Modbus Profilen von anderen Timberwolf Servern in den lokalen Katalog wird die ursprüngliche ID des Profils vom erstellenden Timberwolf Server übernommen, sofern die Datei nicht verändert wurde. Sollte die Datei verändert worden sein, wird eine neue Profil ID vergeben.Produktname: Der angezeigte Produktname wird vom Autor des Geräteprofiles angegeben. Wir empfehlen die Bezeichnung des Herstellers für das jeweilige Gerät möglichst genau und eindeutig zu übernehmen. Bitte achten Sie darauf, falls ähnliche Modelle mit unterschiedlicher Ausstattung verfügbar sind, die sich insbesondere auf die verfügbaren Datenaustauschpunkte auswirken, entsprechend genau und eindeutig zu kennzeichnen. Die Angabe des Produktnamens wird nur zur Anzeige im Timberwolf Server und für die Filterung im Katalog benutzt.
Produktbeschreibung: Die Produktbeschreibung wird vom Autor des Geräteprofiles angegeben. Wir empfehlen eine möglichst verständliche Beschreibung anzugeben. Die Angabe der Produktbeschreibung wird nur zur Anzeige im Timberwolf Server und für die Filterung im Katalog benutzt.
Hinweis Der Autor kann für eine optimierte Anzeige einen Zeilenumbruch mit “\n” anlegen. Hierdurch kann die Formatierung der per Tooltip einblendbaren Detailanzeigen beeinflusst werden.Version: Die Version wird vom Autor des Geräteprofils angegeben. Es liegt in der freien Entscheidung des Autors, wie dieser die Version seiner Profile bezeichnet.
Für ein allgemeines Verständnis empfehlen wir, dass Versionsnummern kleiner 1 (z.B. „0.7“) verwendet werden sollen für Profile, die sich noch in der anfänglichen Definition und im Test befinden. Die erste produktiv genutzte Version sollte entsprechend mit Zahlen gleich oder größer 1 bezeichnet werden. Die Angabe der Version wird nur zur Anzeige im Timberwolf Server und für die Filterung im Katalog benutzt.Autor: Die Angabe des Autors wird vom Autor des Geräteprofils angegeben. Es dürfen selbstverständlich Pseudonyme oder Kürzel angegeben werden. Die Angabe des Namens des Autors wird nur zur Anzeige im Timberwolf Server und für die Filterung im Katalog benutzt.
Kommentar: Die Angabe eines Kommentars wird vom Autor des Geräteprofils angegeben. Dieser Kommentar dient einer näheren Erläuterungen zum Profil selbst.
Wir empfehlen hier anzugeben, was in Verbindung mit diesem Gerät bzw. diesem Profil zu beachten ist. Der Kommentar des Autors wird nur zur Anzeige im Timberwolf Server und für die Filterung im Katalog benutzt.
Hinweis Der Autor kann für eine optimierte Anzeige einen Zeilenumbruch mit “\n” anlegen. Hierdurch kann die Formatierung der per Tooltip einblendbaren Detailanzeigen beeinflusst werden.Sprache: Die Angabe der Sprache wird vom Autor des Geräteprofils angegeben. Diese dient dazu, dass mehrere – ansonsten gleiche Versionen eines Profils – in mehreren Sprachen angelegt werden können. Diese Anzeige der Sprache wird nur zur Anzeige im Timberwolf Server und für die Filterung im Katalog benutzt.
Mehrfach-Operationen: In der letzten Spalte der Tabelle können mehrere Profile für Mehrfach-Operationen gekennzeichnet (Haken setzen) werden. Hiermit können in einem nächsten Schritt mehrere Profile gelöscht oder kopiert werden.
Import und Export von Modbus Profilen
Export von Modbus Profilen: Modbus Geräte Profile können mit Betätigen der Schaltfläche
Profil exportierenaus dem Katalog in eine Datei exportiert werden. Diese Datei ist im Forma JSON formatiert und enthält eine komplexe Prüfsumme (digitale Signatur) um bei einem späteren Import mögliche Veränderungen an einer Profildatei zu erkennen.
Hinweis Nach einem Export wird das jeweilige Profil im lokalen Profil Katalog für Veränderung gesperrt. Dies dient der Eindeutigkeit der vergebenen Profil-ID. Ein Profil mit einer ID ist somit stets auf allen Timberwolf Servern identisch. Sowohl auf dem Server von dem exportiert wurde als auch bei jedem anderen Timberwolf Server, in denen das Profil importiert wird. Falls Sie ein solches Profil nach einem Export nochmals bearbeiten wollen, müssen Sie zuvor eine Kopie anlegen, diese eine neue eindeutige ID erhält.Import von Modbus Profilen: Exportierte Profile können auf jedem Timberwolf Server importiert werden. Sofern hierbei keine Verletzung der enthaltenen komplexen Prüfsumme erkannt wird, übernimmt der importierende Server die Profil ID aus der Export-Datei (ansonsten wird eine neue ID vergeben)
Wichtige Hinweis zur manuellen Erstellung / Bearbeitung von Modbus Profilen:
für experten Modbus Geräteprofile werden beim Export vom Timberwolf Server als JSON Datenstruktur abgelegt. Diese Struktur könnte, bei ausreichender Kenntnis des json Datenformates, manuell bearbeitet und erzeugt werden.
Beim Import einer solchen manuell bearbeiteten Datei wird jede Manipulation am Inhalt der Datei anhand der Verletzung - der ursprünglich beim Export generierten - komplexen Prüfsumme erkannt. Hierbei wird ein entsprechender Hinweis angezeigt und dem so importierten Profil wird eine neue Profil ID zugewiesen.
Die Funktion für Export bzw. Import von Profildateien wurde für den einfachen Austausch zwischen Timberwolf Servern konzipiert und war ursprünglich nicht für den Import von manuell bearbeiteten oder gar selbst erzeugten Profilen vorgesehen.
Bei der Abwägung, ob der Import bei verletzter Prüfsumme erlaubt sein soll, haben wir uns dafür entschieden, dass der Timberwolf Server den Import nicht abbrechen soll. Manuelle Veränderungen an der Datei werden nur wegen der Verletzung der komplexen Prüfsumme erkannt. Eine darüberhinausgehende umfassende Validierung der enthaltenen Daten erfolgt beim Import nicht!
Es ist auf diesem Wege möglich, nicht erlaubte Parameter zu importieren, welche das System in einen unbekannten Zustand bringen können. Bitte nutzen Sie den Import bei verletzter Prüfsumme nur mit großer Vorsicht.
Wir empfehlen nicht, diesen Weg zur Definition von Profildateien zu nutzen und können hierfür keinen Support leisten.
Veränderungssperre von Modbus Profilen
Die im lokalen Profil Katalog enthaltenen Modbus Profile können vom Timberwolf Server gegen Veränderung gesperrt werden.
Veränderungssperre nach Import: Modbus Profile eines anderen Timberwolf Servers (erkennbar daran, dass die ID mit einer anderen Timberwolf Server Seriennummer beginnt) sind gegen Veränderung gesperrt. Dies dient dazu, die Einheitlichkeit eines Modbus Geräte Profils sicherzustellen. Es soll damit verhindert werden, dass Modbus Profile mit derselben ID unterschiedliche Definitionen enthalten.
Veränderungssperre nach Export: Modbus Profile, die exportiert wurden, sind gegen Veränderung gesperrt
Veränderungssperre bei Benutzung: Modbus Profile. die aktiv vom Modbus Gerätemanager genutzt werden, sind ebenfalls gegen Veränderung - und gegen Löschen - gesperrt. Dies ist nötig, wenn das Profil im Geräte Manager eingebunden wurde und nun im laufenden Betrieb für die Abfrage von und Übertragungen zu Modbus Geräten genutzt wird.
Notwendigkeit der Veränderungssperre
Jedem Modbus Profil wird ab dem ersten Speichern eine ID zugewiesen.
Aufbau einer Modbus Profil ID: TWS-SN-XXXXX
(TWS-SN ist die Seriennummer des Timberwolf Servers auf dem das Profil erstellt wurde, xxxxx ist eine fortlaufende Nummerierung). Damit ist diese ID ist weltweit eindeutig.
Soweit ein Modbus Profil nicht genutzt und nicht exportiert wurde, kann dieses jederzeit bearbeitet werden, ohne dass sich die ID des Modbus Profils ändert.
Sobald ein Profil einem Modbus Gerät im Geräte Manager zugewiesen wurde, wird das Profil gegen Veränderung und gegen Löschen gesperrt (da sich dieses nun in Betrieb befindet und damit laufend darauf zugegriffen wird).
Sperre nach Export / Import: Ein Profil soll, sobald dieses exportiert wurde, unter seiner ID weltweit stets den gleichen Stand der Definitionen enthalten. Der Nutzer soll sich darauf verlassen können, dass ein Profil mit gegebener ID auf allen seinen Servern die exakt selbe Definition der Datenaustauschpunkte mit dem Modbus Gerät enthält. Deshalb sind Profile im lokalen Katalog ab dem Export dauerhaft gegen Veränderung gesperrt. Importierte Profile übernehmen die ID und bleiben ebenfalls gegen Veränderung gesperrt.
Editieren der Kopien gesperrter Profile: Von jedem Profil im Katalog können Kopien erstellt und diese bearbeitet werden, dies gilt auch für gesperrte Profile. Das kopierte Profil erhält dabei eine neue ID und ist nicht gesperrt (es sei denn, es wird genutzt oder erneut exportiert).