FB_IotFunctions_Message

Der Funktionsbaustein bietet Lese- und Schreiboperationen für Nachrichten. Alle Nachrichtenparameter sowie die globalen Einstellungen sind als Eingabeparameter vorhanden.

Syntax

FUNCTION_BLOCK FB_IotFunctions_Message
VAR_INPUT
  nChannelId                : UINT;
  nRequestTimeout           : UDINT;
  nMessageRetryInterval     : UDINT;
  nMessageCumulativeTimeout : UDINT;
  iotFunctionsDriverOTCID   : OTCID;
END_VAR
VAR_OUTPUT
  hResult                   : HRESULT;
  pStMessageDetails         : POINTER TO ST_IotFunctionsMessage;
  pStRequestDetails         : POINTER TO ST_IotFunctionsRequest;
  bInitialized              : BOOL;
  fbTcResultEvent           : FB_TcIotFunctionsResultEvent;
END_VAR

Eingänge

Bezeichnung	Typ	Beschreibung
nChannelId	UINT	Kanal-ID des entsprechenden IotFunctions-Kanals in der Konfiguration der Zieldatenagenteninstanz.
nRequestTimeout	UDINT	Timeout-Wert in Millisekunden.
nMessageRetryInterval	UDINT	Meldungsintervall in Millisekunden (0 schaltet Wiederholungen aus).
nMessageCumulativeTimeout	UDINT	Kumulatives Timeout (der erfolgreiche Empfang von Nachrichtendaten verlängert den Timeout der betreffenden Anfrage um diesen Wert).
iotFunctionsDriverOTCID	OTCID	OTCID der Ziel-IotFunctions-Treiberinstanz (siehe driverOTCID von FB_IotFunctions_Connector)

Ausgänge

Bezeichnung	Typ	Beschreibung
hResult	HRESULT	Enthält das letzte hResultat (wird aktualisiert, wenn auf bBusy oder bError zugegriffen wird oder Read/Write aufgerufen wird)
pStMessageDetails	POINTER TO ST_IotFunctionsMessage	Zeiger auf Struktur mit detaillierten Informationen über die zugrunde liegende Nachricht
pStRequestDetails	POINTER TO ST_IotFunctionsRequest	Zeiger auf Struktur mit detaillierten Informationen über die zugrunde liegende Anfrage, in der diese Nachricht ausgeführt wird
bInitialized	BOOL	Zeigt an, ob die Schnittstellensuche und -initialisierung erfolgreich war
fbTcResultEvent	FB_TcIotFunctionsResultEvent	Instanz eines Helferbausteins, welcher Detailinformationen zum Sende- oder Empfangsvorgang enthält.

Methoden

Bezeichnung	Beschreibung
Read	Liest eine Nachricht aus dem Kanal
Acknowledge	Quittiert den Fehler-/Erfolgsstatus und gibt die zugehörigen Nachrichtenobjekte frei. Rufen Sie diese Methode nach der Statusquittierung auf, wenn in diesem Zyklus kein neuer Lese-/Schreibvorgang gestartet wird, um eine mehrfache Auswertung des letzten Status zu verhindern.
Write	Schreibt eine Nachricht in den Kanal

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT v3.1.4022.14	IPC oder CX (c86, x64, ARM)	Tc3_IotFunctions

Weiterführende Informationen