Zum Hauptinhalt springen
Version: 5.6

OPC-UA-Statuscodes

Dieses Dokument beschreibt die nativen Statuscodes, die im OPC-UA-Umfeld zur Bewertung von Datenwerten verwendet werden. Im OPC-UA-Kontext kann der OPC Router diese Zustände auch als Quality-String oder Quality-ID bereitstellen, zum Beispiel wenn Trigger Metadaten zu überwachten Datenpunkten ausgeben.

Grundlagen

OPC UA verwendet keinen kleinen festen Satz numerischer Qualitätswerte wie OPC DA, sondern einen strukturierten StatusCode. Dieser enthält einen Hauptzustand sowie zusätzliche Unterzustände und Informationsbits.

Dadurch lassen sich Zustände deutlich feiner unterscheiden, zum Beispiel:

  • Wert ist grundsätzlich gültig.
  • Wert ist vorhanden, aber nur eingeschränkt belastbar.
  • Datenquelle ist nicht verbunden.
  • Für den Knoten liegen noch keine ersten gültigen Daten vor.
  • Der angeforderte Knoten ist dem Server nicht bekannt.

Typische Statuscodes

Die folgende Tabelle enthält typische OPC-UA-Statuscodes, die in Projekten häufig auftreten können.

StatuscodeBedeutung
GoodDer Wert ist gültig und ohne erkennbare Einschränkung verwendbar.
UncertainDer Wert liegt vor, ist jedoch nur eingeschränkt belastbar.
BadDer Wert ist ungültig oder kann nicht zuverlässig verwendet werden.
BadNodeIdUnknownDer angeforderte Knoten ist dem Server nicht bekannt.
BadNodeIdInvalidDie angegebene Node-ID ist formal ungültig.
BadAttributeIdInvalidDas angeforderte Attribut ist für den Knoten nicht gültig oder nicht verfügbar.
BadNotConnectedDie zugrunde liegende Verbindung oder Datenquelle ist nicht verbunden.
BadNoCommunicationDie Kommunikation mit der Datenquelle ist unterbrochen.
BadWaitingForInitialDataFür den Datenpunkt liegen noch keine ersten gültigen Werte vor.
BadOutOfServiceDer Knoten oder die Datenquelle ist außer Betrieb.
BadUserAccessDeniedDer aktuelle Benutzer oder die aktuelle Sitzung hat keine Berechtigung für den Zugriff.
BadTypeMismatchDer angeforderte oder gelieferte Datentyp passt nicht zur erwarteten Definition.
UncertainInitialValueEs liegt ein Initialwert vor, dessen Aussagekraft noch eingeschränkt ist.
UncertainSubNormalDer Wert wurde aus mehreren Quellen ermittelt, jedoch stehen nicht genügend gute Quellen zur Verfügung.

Verwendung im OPC Router

Im OPC-UA-Kontext kann der OPC Router Statusinformationen als Quality-String oder Quality-ID bereitstellen, zum Beispiel in Metadaten von Triggern wie Data-Change oder Multi-Datachange.

Diese Werte sind fachlich von den unter OPC-DA-Qualitäten beschriebenen klassischen Qualitätswerten zu unterscheiden. Sie bilden einen größeren Statusraum ab und werden in dieser Dokumentation deshalb separat beschrieben.

hinweis

Diese Übersicht ist bewusst keine vollständige Referenz aller OPC-UA-Statuscodes. Je nach Server, Informationsmodell und Zugriffssituation können weitere Statuscodes auftreten.