EDE-Dateiformate für BACnet-Drittgeräte für Brandschutz

Dateiformat

Datenformat

CSV

EDE-Daten können wie folgt dargestellt werden:

• Separate CSV-Dateien für folgende Elemente:
• Objektbeschreibung
• Objekttyp
• Einheit
• Zustandstext
• Einzelne CSV-Datei, die Objektbeschreibung, Objekttyp, Einheit und Zustandstext enthält (jeweils in der entsprechenden Spalte)

XLSX

• EDE-Daten sind in einer einzelnen XLSX-Datei verfügbar, die Objektbeschreibung, Objekttyp Einheit und Zustandstext enthält (jeweils in einem separaten Register). Siehe Beispiele für EDE-Dateien.

Namenskonventionen für CSV-Dateien

Variante 1

Variante 2

Variante 3

Beispiel_EDE.csv

Beispiel_EDE.csv

Beispiel_EDE.csv

Beispiel_ObjectTypes.csv

Beispiel_Object-Types.csv

Beispiel-object.csv

Beispiel_StateTexts.csv

Beispiel_State-Texts.csv

Beispiel-states.csv

Beispiel_Units.csv

Beispiel_Unit-Texts.csv

Beispiel-unit.csv

Schlüsselwort

Vorgabe EDE-Template

Systemabbildung

keyname

keyname

Wird zur Hierarchieabbildung benötigt.

Gerät

device-object-instance

Eindeutige Geräte-ID im BACnet-Netzwerk.

object-name

object-name

Eindeutiger Name innerhalb des Geräts.

object-type

object-type

Definiert den Objekttyp um das entsprechende Objekt Model zu bestimmen.

object-instance

object-instance

Instanznummer für den gleichen Objekttyp.

description

description

Beschreibender Datenpunkttext in den importieren Ansichten:

• Managementsicht
• Technische Sicht
• Betreibersicht

Standard

present-value-default

Wird vom System nicht ausgewertet.

min

min-present-value

Bei der Bedienung, werden Wertänderungen, die kleiner sind als definiert, nicht ausgeführt.

max

max-present-value

Bei der Bedienung, werden Wertänderungen, die grösser sind als definiert, nicht ausgeführt.

Hoch

hi-limit

Wird vom System nicht ausgewertet.

Gering

low-limit

Wird vom System nicht ausgewertet.

Zustand

state text reference

Angezeigter Zustandswert für Binär- oder Multistatedatenpunkte.

unit-code

unit-code

Referenznummer für die Unit-Text-Spalte.

Units-Text

Siemens-spezifisch

Verwendete Einheit bei analogen Werten.

Hersteller

Vendor-specific-address

Identifikation des Herstellers.

function

Siemens-spezifisch

Referenz der zu verwendenden Funktion. Ein entsprechende Funktion und ein Function-Key müssen definiert sein. Siehe (Optional) Function-Keys in den Importregeln definieren.

resolution

Siemens-spezifisch

Wert für die Auflösung eines Datenpunktes.

EoType

-

Die EoType-Zuordnung ist obligatorisch und muss in Kombination mit dem Attribut family verwendet werden. Jeder Zeile muss ein Eo-Typ zugewiesen sein.

Laufzeit

Beschreibung

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

• Ist das Zeichen, welches beim Importieren des Objekts die jeweilige Hierarchiestufe definiert.

Trennzeichen in den Dateien

Verwendung

Beschreibung

1

Main file

Das Datei-Trennzeichen Strichpunkt (;) wird als Defaultzeichen in der Hauptdatei verwendet. Wird ein anderes Trennzeichen benötigt, so kann dieses in den Konfigurationsdateien (separators-1-) geändert werden. Siehe Konfigurationsdateien erstellen

Das Datei-Trennzeichen hängt von den Regionaleinstellungen in Windows bei der Nutzung von Excel ab: Wählen Sie Systemsteuerung > Zeit, Sprache und Region > Datum, Uhrzeit oder Zahlenformat ändern > Erweiterte Einstellungen > Listentrennzeichen.

2

Sekundäre Datei

Inline-Texte in der Hauptdatei

Die Datei-Trennzeichen Komma (,) oder Strichpunkt (;) werden als Defaultzeichen in der Hauptdatei als Inline-Text und in den Nebendateien verwendet. Wird ein anderes Trennzeichen benötigt, so kann dieses in den Konfigurationsdateien (separators-2-) geändert werden. Siehe Konfigurationsdateien erstellen

3

Definition

Ist in der Konfigurationsdatei immer das erste Zeichen jeder Zeile (z.B. #, Leerschlag, Buchstabe). Das Definition-Trennzeichen muss unterschiedlich zum Hierarchie-Trennzeichen der entsprechenden Zeile sein.

4

Hierarchie

Das Hierarchie-Trennzeichen kann für jede Hierarchie unterschiedlich oder immer gleich sein. Das verwendete Hierarchie-Trennzeichen ist abhängig von der Betreiberstruktur.

Eigenschaft

Beschreibung

Verwendung

encoding

Eine Zeichenkodierung erlaubt die eindeutige Zuordnung von Schriftzeichen (Buchstaben oder Ziffern) und Symbolen innerhalb eines Zeichensatzes.

Diese Eigenschaft wird verwendet, wenn importierte Zeichen nicht korrekt dargestellt werden.

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.

Führen Sie eine der folgenden Aktionen aus, um diesen Fehler zu beheben:

Die explizite Eingabe des richtigen Encodings liefert normalerweise die korrekten Ergebnisse. Die Vorteile dieser Variante sind:
‒ Es sind keine weiteren Einstellungen erforderlich, wenn der Lieferant eine neue EDE-Datei bereitstellt.
‒ Bei mehreren importierten EDE-Dateien muss das Encoding nur einmal in der Konfigurationsdatei definiert werden.

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

Die Nachteile dieser Variante sind:
‒ Wenn eine neue EDE-Datei vom Lieferanten geliefert wird, muss diese wieder mit UTF-8 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.

Optional

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.

Optional. Default = ";"

separators-2

Das Datei-Trennzeichen (separators-2) wird benutzt, um:

• In der EDE-Hauptdatei die Inline-Texte in einer Spalte zu erkennen, 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 (;).

Optional. Default = ";,"

column-name

Mit dem Spaltenname wird die Referenzspalte für die Erstellung der Objekthierarchie geliefert.

Optional.

Standard (logisch) = "object-name", Standard (Benutzer) = "keyname"

Family¹⁾

Familienname.

Optional.

Referenzspalte für Hierarchieabbildung

Ansicht im System Browser

Dateiname

Default
Column-name

Alternative
Column-name

Betreibersicht

Hierarchy-User.txt

keyname

Vendor-specific-address

object-name

Technische Sicht

Hierarchy-Logical.txt

object-name

keyname

Eigenschaft

Beschreibung

Definition-Trennzeichen

Dieses Trennzeichen ist das erste Zeichen in jeder einzelnen Zeile. Es kann ein Sonderzeichen, ein Buchstabe oder eine Ziffer sein.

Hinweis: Das Definition-Trennzeichen muss unterschiedlich zum definierten Hierarchie-Trennzeichen der entsprechenden Zeile sein.

Hierarchie-Trennzeichen

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

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

Minimallänge der Betreiberbezeichnung

Dieser Wert definiert die minimale Textlänge (1‒255) der entsprechenden Hierarchieebene.

Eine Warnung wird angezeigt, wenn die Bezeichnung kürzer ist als definiert.

Maximallänge der Betreiberbezeichnung

Dieser Wert definiert die maximale Textlänge (1‒255) der entsprechenden Hierarchieebene.

Eine Warnung wird angezeigt, wenn die Bezeichnung länger ist als definiert.

Beschreibung der Hierarchieebene

Dieser beschreibende Text entspricht der Beschreibung, die für die entsprechende Hierarchieebene im System Browser angezeigt wird. Diese Eigenschaft ist optional.

Excel-Tabelle

Inhalt

EDE

Datenpunktinformationen

State-Texts

State-Texts

Units-Text

Einheiten

Objekttypen

Ist nicht ausgefüllt