Bosch rexroth IndraWorks 15VRS Anwendungsbeschreibung Seite 385

IndraWorks 15VRS Feldbusse
ReadRange Service Hook
Wenn während der Abarbeitung ein Property bearbeitet wird, das nicht geän‐
dert werden kann, dann gibt der PI eine Basis-Fehlermeldung mit der Fehler‐
ursache aus.
Das Ergebnis dieses Services ist:
● Entweder alle der angegebenen Propertys werden geändert, oder es
werden nur die Propertys geändert, bis zu dem Property, das im First
Failed Write Attempt-Parameter angegeben ist (nicht einschließ‐
lich des angegebenen Propertys)
Meldungen / Fehlerreaktion:
Wenn keine Schreibaktion erfolgreich ausgeführt wurde und die Service-An‐
frage komplett zurückgewiesen wurde, wird BACnet-Reject-PDU ange‐
zeigt.
Wenn eine der Schreiboperationen aus List of Write Access Speci-
fications nicht erfolgreich ausgeführt werden konnte, wird eine Fehlermel‐
dung mit der Fehlerursache zurückgegeben.
Das API wird verifiziert zunächst die Gültigkeit der Parameter:
●
Object Identifier
●
Property Identifier
●
Property Array Index
Wenn der Range-Parameter nicht existiert, liest das API alle verfügbaren
Elemente in der Liste, oder im Array aus und gibt die ausgelesenen Elemente
zurück.
Wenn der Range-Parameter existiert und er die By Position-Parameter
angibt, liest das API alle angegebenen Elemente aus und gibt die ausgelese‐
nen Elemente zurück.
Die angegebenen Elemente schließen das Element an der Indexposition ein,
die durch Reference Index definiert ist, plus die bis Count - 1 folgenden
Elemente, wenn Count positiv ist, oder die bis -1 - Count vorangehenden
Elemente, wenn Count negativ ist.
Das erste Element einer Liste wird mit Index 1 verknüpft.
Wenn es den Range-Parameter gibt und er den By Time-Parameter angibt,
oder die By Sequence Number-Parameter, dann weist das API die Anfrage
zurück, indem es eine Fehlermeldung mit entsprechender Fehlerklasse und
Fehler-Code zurückgibt.
Die zurückgelieferte Antwort überträgt mit Hilfe des Item Count-Parameter
die Anzahl der gelesenen und zurückgegebenen Elemente.
Die aktuellen Elemente werden im Item Data-Parameter zurückgegeben.
Wenn die zurückgegebene Antwort den ersten Positionsindex einschließt,
dann ist im Result Flags-Parameter das FIRST_ITEM-Flag auf TRUE ge‐
setzt, andernfalls auf FALSE.
Wenn die zurückgelieferte Antwort den letzen Positionsindex einschließt,
dann ist in Result Flags das LAST_ITEM-Flag auf TRUE gesetzt, andern‐
falls auf FALSE.
Wenn in der Liste keine Elemente sind, die den Range-Parameterkriterien
entsprechen, dann wird ein ComplexAck mit einem Item Count von 0 und
keinem First Sequence Number-Parameter zurückgegeben.
Die Standard-Implementierung dieses Services unterstützt NICHT den Zugriff
auf das log-buffer-Property der Trend- und Event-logging Objekte.
Meldungen / Fehlerreaktion:
Gebäudeautomatisierung
R911393282_Ausgabe 05 Bosch Rexroth AG
373/395