Referenz für BACnet-Drittgeräte

Engineering

Die Integration von BACnet-Drittgeräten in das Managementsystem kann je nach Anwendungsfall oder Verfügbarkeit der Projektdaten online oder offline erfolgen. Der gewählte Import in die Managementplattform beeinflusst auch, wie Projektdaten im System Browser hierarchisch dargestellt werden.

Online-Import

Beim Online-Engineering müssen Sie mit dem BACnet-Drittgerät online verbunden sein, um die Projektdaten in die Managementplattform importieren zu können.

Vorteil

• Sie importieren die aktuellsten Projektdaten aus dem BACnet-Drittgerät.
• Es ist keine aufwendige Koordination mit dem Projektingenieur des BACnet-Drittgeräts notwendig.
  Hinweis: Folgende Informationen müssen/sollten jedoch vorgängig abgeklärt werden: PICS, Geräte-ID, Gerätename und UDP-Port.

Nachteil

• Das Scannen des Netzwerkes kann sehr lange dauern.
• Die Hierarchiestruktur zur Ansicht im System Browser kann nicht beeinflusst werden.

Offline-Import

Für den Offline-Import von BACnet-Drittgeräten in das Managementsystem benötigen Sie eine Engineering-Data-Exchange- (EDE-)Datei. Eine Online-Verbindung mit dem BACnet-Drittgerät ist nicht notwendig.

Vorteil

• Das Engineering kann im Büro erfolgen.
• Mehrere Sprachen werden unterstützt.
• Im System Browser werden folgende Ansichten unterstützt:
• Managementsicht (wird vom System automatisch erstellt und kann nicht beeinflusst werden).
• Technische Sicht (gesteuert mittels Konfigurationsdatei)
• Technische Sicht (nur wenn bereits im Engineeringtool erstellt, dann steuerbar mittels Konfigurationsdatei)
• Das Grafikengineering kann im Vorfeld im Büro fertiggestellt werden.

Nachteil

• Die Projektdaten auf dem BACnet-Drittgerät sind möglicherweise nicht aktuell.
• Es benötigt mehr Koordination, die EDE-Daten vom Projektingenieur des BACnet-Drittgeräts zu erhalten.

Ansichten im System

Die Datenpunkte werden je nach verwendeter Importart in den verschiedenen Ansichten angezeigt. Die Managementsicht wird bei allen Importarten erstellt.

Online

Die Liste der importierten Datenpunkte wird nach einem Online-Import alphabetisch angezeigt.

Offline

Neben der Managementsicht, die offline identisch zur Online-Version ist, können auch die Technische Sicht und die Betreibersicht mittels Konfigurationsdateien offline erstellt werden.

PICS

Das Dokument Protocol Implementation Conformance Statement (PICS) führt alle Geräte des Herstellers auf, und beschreibt die unterstützten BIBBs, Objekttypen, Zeichensätze und Kommunikationsoptionen.as PICS von den entsprechenden Hersteller sind unter folgenden Links aufgeführt:

• http://www.bacnetinternational.net/btl/
• http://www.bacnet.org
• http://www.big-eu.org

Die folgenden PICS stehen den Herstellergeräten zur Verfügung:

• BACnet Advanced Operator Workstation (B-AWS)
• BACnet Building Controller (B-BC)
• BACnet Advanced Application Controller (B-AAC)
• BACnet Application Specific Controller (B-ASC)
• Other BACnet Devices (B-Oth)

Unterstützte Objekttypen

Die Funktionen AutoDiscovery oder EDE-Import unterstützen nur Standard-BACnet-Objekte, d.h., herstellerseitige BACnet-Erweiterungen werden von diesen Desigo CC-Funktionen nicht unterstützt. Die aktuelle Version unterstützt definierte BACnet-Objekte in folgender Bibliothek: Projekt > Systemeinstellungen > Bibliotheken > BA (HQ) > Geräte > BACnet > Objektmodelle.

Workflow Importing Data

A BACnet driver and a network must be created or exist in advance for online or offline import.

NOTE:
Select the same type of import for each manufacturer and network to avoid potential data loss.

Konzept EDE-Datei

Mit BACnet wird die Interoperabilität zwischen den Geräten verschiedener Hersteller gewährleistet. Mit der EDE-Datei werden die BACnet-Projektdaten eines Gerätes dokumentiert und diese können in Desigo CC eingebunden werden.

Projektdaten

Damit die Projektdaten untereinander ausgetauscht werden können, haben EDE-Daten die folgende Struktur:

• Allgemeine Information zum Projekt
• Notwendige Informationen zum einzelnen Objekt (Spalte: Mandatory)
• Notwendige Informationen zum einzelnen Objekt (Spalte: Optional)

Sind Informationen in der Spalte Optional vorhanden, so werden diese als Objektinstanz in die Projektdatenbank übernommen. Sind keine optionalen Informationen in der EDE-Datei vorhanden, werden die fehlenden Informationen aus der Funktion oder dem Objektmodell abgeleitet.

Objektinformation

Für den Datenimport gibt es zwei Dateiformate (CSV und XLSX), um die Objektinformation bereit zu stellen. Beim Dateiformat CSV kann der Dateiaufbau zudem unterschiedlich sein.

CSV‒Dateiformat

• Informationen befinden sich in verschiedenen CSV-Dateien:
• Objektbeschreibung
• Objekttyp
• Einheit
• State-Text
• Alle Informationen befinden sich in einer CSV-Datei (Objektbeschreibung, Objekttyp, Einheit, Zustandstext). Die einzelnen Informationen sind jeweils in der entsprechenden Spalte definiert.

XLSX‒Dateiformat

• Alle Informationen befinden sich in einer XLSX-Datei (Objektbeschreibung, Objekttyp, Einheit, Zustandstext). Die einzelnen Informationen sind jeweils in einem eigenen Register definiert.

Diese drei Datenformen werden von der Desigo CC Importfunktion unterstützt. Eine Fehlermeldung wird angezeigt, wenn das Datenformat nicht den Anforderungen entspricht.

Hinweis:
Standardmässig wird der Objekttyp wird aus dem zugehörenden Objektmodell der Bibliothek BA_Device_BACnet_HQ_1 abgebildet (Family = BACNET). Durch Nutzung des Attributs Family kann auf eine andere Bibliothek verwiesen werden. Die Information aus der EDE-Standarddatei wird beim Import ignoriert.

Hierarchieabbildung im System Browser

Im System Browser sind je nach integrierten Subsystemnetzwerken mehrere Ansichten auf ein Objekt möglich:

• Ohne eine zusätzliche Konfiguration werden die Projektdaten nur in der Managementsicht angezeigt. Die Informationen aus der Spalte Objektname werden für die Erstellung der Objekte in der Managementsicht verwendet.
• Mittels einer Konfigurationsdatei können die Technische Sicht (Hierarchy-Logical.txt) und die Betreibersicht (Hierarchy-User.txt) definiert werden. Voraussetzung für eine korrekte Hierarchieabbildung in Desigo CC ist, dass sich die ausführende Firma an die Projektvorgaben gehalten hat. Nur so kann die Objektinformation mittels des Separators hierarchisch importiert und im System Browser angezeigt werden.

Spezialfälle für spezifische Subsystemnetzwerke

Das Systemverhalten (Erstellung von Objekten oder Ansichten) während des Imports kann sich je nach genutztem Subsystemnetzwerk von der Standard-EDE-Datei unterscheiden. Voraussetzung für die Integration ist, dass die Erweiterung Desigo_System und die entsprechenden Erweiterungen für das Subsystemnetzwerk im Projekt verfügbar sind.

Integration von Simatic S7 Lösungen

Objekt für Hierarchieabbildung hinzufügen

In Subsystemnetzwerken, die keine Objekte für die Hierarchieabbildung kennen, werden alle Objekte mit dem gleichen Beschreibungstext (z.B. Zähler) untereinander aufgeführt, was die Auswahl eines bestimmten Objekts erschwert.

Um die Auswahl benutzerfreundlicher zu gestalten, muss die EDE-Datei um einen zusätzlichen Eintrag für jedes Objekt erweitert werden. Es ist dieses Objekt, das die entsprechende Beschreibung enthält.

HINWEIS

Vermeiden von Datenverlusten

Alle Änderungen an vorigen Versionen werden überschrieben, sobald eine neu generierte EDE-Datei importiert wird.

Sichern Sie die bearbeitete EDE-Datei und vergleichen Sie die Änderungen an der neuen EDE-Datei. Bearbeiten Sie eine oder beide EDE-Dateien, und importieren Sie die überarbeitete EDE-Datei.

Alternativ können Sie das Tool SX Open nutzen, um an der EDE-Datei benötigte Änderungen vorzunehmen.

Desigo PX Objekte erstellen

Eine EDE-Datei kann um zusätzliche Spalteninformationen erweitert werden. So wird ein Desigo PX-BACnet-Objekt statt eines Standard-BACnet-Objekts erstellt, wenn Erweiterungen verfügbar sind. Daher ist es vollständig mit Desigo PX kompatibel.

HINWEIS

Die Anzeige im System Browser ist inkorrekt
Die Spalten Function-name und Short-name sind notwendig, damit das Programm in den S7-Modus wechseln kann. Die Informationen in den Spalten sind abhängig von der Funktion, die Spalten können aber auch leer bleiben.

− Eine Technische Sicht, aber keine Betreibersicht wird erstellt, wenn die Dateien Hierarchy-User.txt und Hierarchy-Logical.txt nicht vorhanden sind. Die Technische Sicht wird dann vom Objektnamen abgeleitet (Trennzeichen = ' ; min = 1; max = 50) und hart codiert.

Namenskonventionen

Dateinamen

Wenn Objektbeschreibung, Objekttyp (wird nicht ausgewertet), Einheit und Zustandstext in verschiedenen CSV-Dateien gespeichert werden, müssen folgende Namenskonventionen eingehalten werden.

Kann der Dateinamen für Objekttyp, Einheit oder Zustandstext nicht aufgelöst werden, so wird beim Import eine Fehlermeldung angezeigt.

Spaltennamen

Spaltennamen können sich je nach Hersteller unterscheiden. Damit ein Import korrekt ausgeführt wird, muss mindestens das Keyword im Spaltennamen enthalten sein (Gross-/Kleinschreibung beachten).

Wird ein Keyword in mehreren Spalten verwendet, so kann dies zu einem inkorrekten Import von Daten führen. Verwenden Sie wenn möglich die Spaltennamen gemäss der Vorgabe der EDE-Spezifikation.

Mapping im System

Zeigt, an welchen Stellen die Information im System angezeigt wird.

Format der Konfigurationsdateien

Begriffe

• Datei-Trennzeichen
• Definiert, an welcher Stelle in der Hauptdatei (CSV) ein neuer Eintrag (Spalteninformation) beginnt.
• Definiert in der Hauptdatei die Inline-State-Texte (Aus, Ein) und in den Nebendateien, wo ein neuer Eintrag (Spalteninformation) beginnt.
• Definition-Trennzeichen
  Definiert, welches Trennzeichen die einzelnen Einträge in der Konfigurationsdatei trennt.
• Hierarchietrennzeichen
  Definiert beim Importieren des Objekts die jeweilige Hierarchiestufe.

Trennzeichen in den Dateien

Allgemein

Die Erstellung der Dateien Hierarchy-User.txt und Hierarchy-Logical.txt kann mit einem Texteditor erfolgen. Das Format der Dateien Hierarchy-User.txt und Hierarchy-Logical.txt ist in zwei Teile unterteilt:

• Aufbau der EDE-Datei
• Aufbau der Hierarchieabbildung

Dateiformat

!encoding!utf-8

#separators-1#;

#separators-2#,;

#separators-3#|

:column-name:keyname

,_,1,15,Location|Location|Standort

,:,1,15,Building|Bâtiment|Gebäude

,_,1,15,Floor|Plancher|Stockwerk

,_,1,20,Plant|Installation|Anlage

,_,1,20,Object|Objet|Objekt

,_,1,25,Data point|Point|Datenpunkt

Hinweis:
Es kann jedes Zeichen als Definitionstrennzeichen verwendet werden, es darf jedoch nicht in der entsprechenden Zeile enthalten sein.

Teildefinition für EDE-Datei

Zum Import einer EDE-Datei in Desigo CC können fünf Eigenschaften verwendet werden:

• Encoding (Optional): Muss angewendet werden, wenn importierte Zeichen nicht korrekt dargestellt werden
• Separators-1 (Optional): Standard = ";")
• Separators- 2 (Optional): Standard = ";,")
• Separators- 3 (Optional): Standard = "|") nur bei Verwendung mehrerer Sprachen
• Column-name (Optional): Standard (logisch) = „object-name“, Standard (Benutzer) = "keyname"
• Family (Optional): Standard = "BACNET”

Syntax für den EDE-Teil

!encoding!utf-8

#separators-1#;

#separators-2#,;

#separators-3#|

:column-name:keyname

Eigenschaftserweiterung Family verwenden

Die Attribut Family kann verwendet werden, um andere Objektmodelle als die aus der Standard-BACnet-Bibliothek (Family = BACNET) zu wählen. Die Abbildung des BACnet-Typs auf EO-Type ist standardmässig hart codiert. Dies bedeutet, dass das Attribut Family nur für Libraries genutzt werden kann, die zu 100% den BACnet-Vorgaben entsprechen (z.B. Objekttyp ‘0’ EO_BA_AI_1, ‘1’ EO_BA_AO_1, …).

Wenn das nicht der Fall ist, muss die EDE-Datei um eine neue Spalte erweitert werden (mit dem Namen EoType), die den Eo-Type für jedes Objekt individuell angibt.

Beispiel zur Verwendung der Eigenschaft EO type:

Beispiel zur Verwendung der Eigenschaft Family:

!encoding!utf-8

#separators-1#;

#separators-2#,;

#separators-3#|

:column-name:keyname

;Family;System_name

+EOType-Aggregator+EO_System_name_AGG_1

?EOType-Folder?EO_System_name_FDR_1

Wenn die flexible Importregel Family angewendet wird, müssen die hierarchischen Objektmodellaggregatoren und Ordner des Subsystems definiert werden. Bei Bedarf werden der Aggregator und der Ordner während des Importes der EDE-Datei zur Hierarchiestruktur hinzugefügt.

Unterstützung von Mehrsprachigkeit

Damit die Mehrsprachigkeit unterstützt wird, müssen die folgenden Voraussetzungen gegeben sein.

• In den Dateien Hierarchy-User.txt und Hierarchy-Logical.txt ist ein #separators-3#| mit einem eindeutigen Trennzeichen definiert.
• Die Reihenfolge der Sprachen ist gemäss der System Management Console definiert.
• In der Spalte description der EDE-Datei sind die gewünschten Texte vorhanden und mit dem Separator 3 getrennt.
  
• Bei der Verwendung der Datei State-Text, sind die Texte in der gewünschte Sprache vorhanden und mit dem Separator 3 getrennt.
  
• Die gewünschte Sprachen sind in den Dateien Hierarchy-Logical-Map.csv und Hierarchy-User-Map.csv vorhanden und mit dem Separator 3 getrennt. Ein zweiter Datenimport ist notwendig, um die Texte auf die Projekt-Datenbank zu schreiben.
  

Art und Quelle der Gefahr

Wird nur die Landesprache (z.B. de-DE) im Projekt verwendet, so muss trotzdem als erste Sprache en-US definiert werden und mit dem Separator-3 getrennt werden.
Anwendung en-US als auch de-DE:

Beispiel en-US nur:

Encoding

Eine Zeichenkodierung erlaubt die eindeutige Zuordnung von Schriftzeichen (Buchstaben oder Ziffern) und Symbolen innerhalb eines Zeichensatzes. Bei einer falschen Zeichenkodierung werden die Zeichen im System teilweise falsch dargestellt. Dies geschieht meistens, wenn eine EDE-Datei auf einem Rechner in Westeuropa erstellt wird und anschliessend auf einem Rechner in Osteuropa importiert wird. Normalerweise gibt es keine Probleme, wenn beim Speichern der EDE-Datei das Encoding UTF-8 (mit BOM) verwendet wird.

Problembehandlung Version 1

Definieren Sie in der ersten Zeile die code-page Information, die mit der EDE-Datei erstellt wurde. Wenn die codepage Informationen unbekannt sind, versuchen Sie encoding=UTF-8.

Das explizite Eingabe für richtigen Encodings liefert normalerweise die korrekten Ergebnisse. Die Vorteile dieser Variante sind:

‒ Wird eine neue EDE-Datei vom Lieferanten geliefert, so werden keine zusätzlichen Einstellungen mehr benötigt.

‒ Das Encoding muss nur einmal in der Konfigurationsdatei beim Import von mehrfachen EDE-Dateien definiert werden.

Das Encoding kann sowohl textuell als auch numerisch angegeben werden: Zum Beispiel 1252 oder Windows-1252.

Problembehandlung Version 2

Öffnen Sie die EDE-Datei mit einem normalen Editor (alle Zeichen müssen in diesem Editor korrekt angezeigt werden) und speichern die Datei mit der Einstellung Encoding = UTF-8. Die Nachteile dieser Variante:

‒ Wenn eine neue EDE-Datei vom Lieferanten geliefert wird, muss diese wieder mit UTF-8 erneut gespeichert werden.

‒ Jede EDE-Datei muss auf diese Weise gespeichert werden.

• Allgemeine Informationen zur Implementierung der EDE-Funktion
• Die beiden Hierarchiedateien werden mit Encoding.Default gelesen.
• Die anderen EDE-Textdateien werden mit dem angegebenen Encoding gelesen.
• Der Default für das Encodingproperty ist Encoding.Default.
• Encoding.Default verwendet die code-page Information, die im Betriebssystem eingestellt ist, ausser, wenn ein Byte Order Mark (BOM) vorhanden ist. In solch einem Fall wird das Encoding vom BOM abgeleitet.

Wenn ein BOM in einer Datei vorhanden ist, wird immer das korrekte Encoding verwendet.

Separators-1

Das Datei-Trennzeichen (separators-1) wird benötigt, um die Spalten der EDE-Hauptdatei zu gliedern. Diese Eigenschaft ist optional und nicht erforderlich. Wird kein Trennzeichen definiert, so wird der Defaultwert Strich-Punkt (;) verwendet.

Separators-2

Das Datei-Trennzeichen (separators-2) wird benötigt, um:

• In der EDE-Hauptdatei die Inline-Texte in einer Spalte zu erkennen, wie z.B. Aus, Ein, Stufe 1, Stufe 2;
• Die Spalten in den State-Text- und Unit-Text-Dateien zu gliedern.

Die Default-Trennzeichen sind Komma (,) und Strichpunkt (;).

Separators-3

Das Datei-Trennzeichen (separators-3) wird benötigt, um:

• Mehrere Sprachen zu unterstützen.

Column-Name

Mit dem Column-name wird die Referenzspalte für die Erstellung der Objekthierarchie festgelegt.

Teildefinition für Hierarchieabbildung

Für die Hierarchieabbildung im System Browser müssen fünf Eigenschaften definiert werden:

• Definition-Trennzeichen
• Hierarchietrennzeichen
• Minimallänge der Betreiberbezeichnung
• Maximallänge der Betreiberbezeichnung
• Beschreibung der Hierarchieebene

Syntax für den Hierarchieteil

,_,1,15,Ort

,:,1,15,Gebäude

,',1,15,Stockwerk

,-,1,20,Anlage

,_,1,20,Objekt

,+,1,25,Datenpunkt

Definition-Trennzeichen

Das erste Zeichen jeder einzelnen Zeile ist das Definition-Trennzeichen. Dies kann ein Sonderzeichen, ein Buchstabe oder eine Zahl sein. Das Definition-Trennzeichen muss jedoch unterschiedlich zum definierten Hierarchie-Trennzeichen in der gleichen Zeile sein.

Hierarchietrennzeichen

Das Hierarchie- Trennzeichen definiert, an welcher Stelle des Texts eine neue Hierarchieebene erstellt wird (AAA:BBB'CCC_DDD-EEE_FFF+GGG).

Wird ein Definition-Trennzeichen auch im Objekttext als Zeichen verwendet, so kann dies zu einer falschen Hierarchieebene führen.

Minimallänge Betreiberbezeichner

Definiert die minimale Textlänge (1-255) der entsprechenden Hierarchieebene. Eine Warnung wird angezeigt, wenn die Bezeichnung kürzer ist als definiert.

Maximallänge Betreiberbezeichner

Definiert die maximale Textlänge (1‒255) der entsprechenden Hierarchieebene. Eine Warnung wird angezeigt, wenn die Bezeichnung länger ist als definiert.

Beschreibung (optional)

Im System Browser wird der Beschreibungstext bei der entsprechenden Hierarchieebene angezeigt.

Spezialfall: Fixe Feldlänge

Bei der Betreiberbezeichnung mit einer fixen Feldlänge sind keine Hierarchie-Trennzeichen vorhanden. In diesem Fall:

• Die minimale und maximale Feldlänge gleich definiert werden
• Es dürfen keine Hierarchie-Trennzeichen definiert werden.

Übersicht EDE-Dateien

Nachfolgende Beispiele zeigen die unterstützten Dateiformate.

XLSX-Datei

In der XLSX-Datei werden alle Informationen in unterschiedlichen Registern gespeichert.

Hinweis:
Werden in der XLSX-EDE-Datei alle Informationen in einer Spalte angezeigt, so muss das Datei-Trennzeichen geändert werden.

1. Wählen Sie Start > Systemsteuerung > Zeit, Sprache und Region > Datum, Uhrzeit oder Zahlenformat ändern.
2. Wählen Sie Formate > Weitere Einstellungen > Listentrennzeichen.
3. Geben Sie das entsprechende Datei-Trennzechen ein.

CSV mit Referenzdateien

In der CSV-Datei mit Referenzdateien werden verschiedene Arten Informationen in einzelnen Dateien gespeichert.

CSV ohne Referenzdateien

In der CSV-Datei ohne Referenzdateien werden alle Informationen in einer einzelnen Datei gespeichert.

Textgruppen

State-Text

Während eines EDE-Dateiimports wird für jeden State-Text eine Textgruppe erstellt. Diese Textgruppen werden in der Managementsicht im System Browser unter Projekt > Systemeinstellungen > Bibliotheken > L4-Projekt > Gemeinsam > Gemeinsam > Texte gespeichert. Der beschreibende Name der Textgruppe wird gebildet aus EdeStateTexts+Dateiname+Nummer. Ein Dateiname mit Leerzeichen wird mit _ (Unterstrich) ergänzt.

Bestehende Textgruppe für den State-Text verwenden

Verwenden Sie die Spalte state-text-reference, um viele neue Textgruppe zu verhindern. Das funktioniert für:

• _StateTexts.csv
• Tab StateTexts
• _StateTexts.csv als "inline" Text definiert.

Syntax für Ventilator, 3-stufig

• Kommentar *TxG*,TxG_BA_3147 hinzufügen, wenn kein Limit notwendig ist oder in der Spalte max-present-value definiert ist.
• Definieren Sie eine maximale Stufe for Ventilator *TxG*,TxG_BA_3147,4 bei einem 2-stufigen Ventilator. Der Wert wird verwendet, wenn kein Wert in der Spalte max-present-value definiert ist.

Einfaches Szenario:

• Debug-Mode

Sczenario mit max-present-value:

• Debug-Mode

Szenario ohne min-present-value und max-present-value aber mit State-Text:

• Debug-Mode

Zusätzliche Informationen zum Verhalten des State-Texts:

• Standard Verhalten (kein min-present-value & kein max-present-value & 2 Texts (*TxG*,TxG_BA_1024)): Min. und max. sind auf «0» und «1» für Binär und «1» und «2» für Multistate gesetzt.
• min-present-value & max-present-value vorhanden: min. und max. Werte sind stehen zur Verfügung.
• Kein min-present-value & max-present-value vorhand aber 3. Texts (*TxG*,TxG_BA_1024,4): Min ist auf «1» und max. auf 3. Text (hier 4) für Multistate (es bleibt auf «0» und «1» für Binär).
• min-present-value ist z.B. auf Wert «3» gesetzt aber kein max-present-value ist für 3. Texts vorhanden (*TxG*,TxG_BA_1024,8): Min auf «3», Max auf «8» gesetzt.

Units-Text

Für die Abbildung der verwendeten Einheiten wird eine Textgruppe EdeUnitsTexts+Dateiname erstellt.

Löschen

Textgruppen werden nur gelöscht, wenn diese in einem Gerät referenziert sind. Mehrfach, referenzierte Textgruppen müssen manuell mit dem Textgruppen-Editor gelöscht werden.