Set_Attribute_Single: Festlegen eines Attributs eines Objekts (Set)

Beschreibung des Funktionsbausteins

Dieser Funktionsbaustein legt den Inhalt eines bestimmten Attributs einer Objektinstanz fest.

Um den Funktionsbaustein verwenden zu können, müssen Sie mindestens ein EtherNet/IP-Gerät unter dem Protokoll-Manager hinzufügen. Siehe hierzu Hinzufügen eines Geräts.

Grafische Darstellung

Eingänge

In der folgenden Tabelle werden die Eingangsvariablen beschrieben:

Eingang

Datentyp

Kommentar

i_xExecute

BOOL

Wertebereich: FALSE, TRUE.

Standardwert: FALSE.

Eine steigende Flanke des Eingangs Execute startet den Funktionsbaustein. Der Funktionsbaustein setzt die Ausführung fort, und der Ausgang Busy wird auf TRUE gesetzt. Eine weitere steigende Flanke am Eingang Execute wird ignoriert, während der Funktionsbaustein ausgeführt wird.

  • FALSE: Wenn der Eingang Execute während der Ausführung des Funktionsbausteins auf FALSE gesetzt wird, wird der Ausgang Done oder Error für einen Zyklus auf TRUE gesetzt.

  • TRUE: Der Ausgang Done oder Error wird auf TRUE gesetzt, solange der Eingang Execute auf TRUE gesetzt ist.

i_xAbort

BOOL

Wertebereich: FALSE, TRUE.

Standardwert: FALSE.

  • FALSE: Die Ausführung wurde nicht abgebrochen.

  • TRUE: Die Ausführung wurde durch einen anderen Funktionsbaustein abgebrochen.

i_xMsgType

BOOL

  • FALSE: UCCM

  • TRUE: Verbundene Nachricht (Klasse 3)

i_adTargetIP

TCP_ADDR

IP-Adresse des Ziels

i_dwClass

DWORD

Zielklasse.

Siehe Finden von Objektinformationen in der Gerätedokumentation.

Muss 0xFFFFFFFF sein, wenn die Klasse nicht Teil des Requests ist.

i_dwInstance

DWORD

Zielinstanz.

Siehe Finden von Objektinformationen in der Gerätedokumentation.

Kann 0 sein, wenn das Ziel eine Klasseninstanz ist. Muss 0xFFFFFFFF sein, wenn die Instanz nicht Teil des Requests ist.

i_dwAttribute

DWORD

Zielattribut.

Siehe Finden von Objektinformationen in der Gerätedokumentation.

Muss 0xFFFFFFFF sein, wenn das Attribut nicht Teil des Requests ist.

i_abyRequestData

ARRAY OF BYTE

0…MAX_EIP_REQUEST_DATA_SIZE

Daten, die an das Ziel gesendet werden müssen. Wenn nicht verwendet, muss wDataSize gleich 0 (1) sein.

q_wDataSize

WORD

Tatsächliche Größe des abyRequestData1.

(1) Der Eingangsdatenpuffer muss ebenfalls formatiert sein. Siehe Set_Attribute_Single-Requestdaten in der ODVA-EtherNet/IP-Spezifikation Band 1.

Ausgänge

In der folgenden Tabelle werden die Ausgangsvariablen beschrieben:

Ausgang

Datentyp

Kommentar

q_xDone

BOOL

Wertebereich: FALSE, TRUE.

Standardwert: FALSE.

  • FALSE: Die Ausführung wurde nicht gestartet oder es wurde ein Fehler erkannt.

  • TRUE: Ausführung ohne Fehler beendet.

q_xBusy

BOOL

Wertebereich: FALSE, TRUE.

Standardwert: FALSE.

  • FALSE: Der Funktionsbaustein wird nicht ausgeführt.

  • TRUE: Der Funktionsbaustein wird ausgeführt.

q_xAborted

BOOL

Wertebereich: FALSE, TRUE.

Standardwert: FALSE.

  • FALSE: Die Ausführung wurde nicht abgebrochen.

  • TRUE: Die Ausführung wurde durch den Eingang Abort abgebrochen.

q_xError

BOOL

Wertebereich: FALSE, TRUE.

Standardwert: FALSE.

  • FALSE: Die Ausführung des Funktionsbausteins läuft, es wurde kein Fehler erkannt.

  • TRUE: Bei der Ausführung des Funktionsbausteins ist ein Fehler aufgetreten.

q_byCommError

BYTE

Liefert Informationen über den erkannten Fehler. Siehe CommunicationErrorCodes: Kommunikationsspezifische Fehlercodes.

q_dwOperError

DWORD

Liefert Informationen über den erkannten Fehler. Siehe OperationErrorCodes: Betriebsspezifische Fehlercodes.