SendData

SendData sendet den Inhalt einer Variablen beliebigen Typs an die mit der Eingangsvariablen TxBuffer (vom Typ ComBuffer) korrespondierende Schnittstelle.

Eingänge

VAR_INPUT
  pSendData           : POINTER TO BYTE;
  Length              : UDINT;
END_VAR

Name	Typ	Beschreibung
pSendData	POINTER TO BYTE	pSendData ist die Adresse der Sendedaten und wird mit ADR(Sendedaten) ermittelt. Die Sendedaten dürfen nicht verändert werden, solange Busy=TRUE ist und die Daten noch nicht vollständig gesendet wurden.
Length	UDINT	Length ist die Anzahl der zu sendenden Datenbytes und kann kleiner oder gleich der Größe der verwendeten Datenstruktur sein. Wenn der gesamte Inhalt einer Variablen gesendet werden soll kann Length mit SIZEOF(Sendedaten) ermittelt werden.

Name

Typ

Beschreibung

pSendData

POINTER TO BYTE

pSendData ist die Adresse der Sendedaten und wird mit ADR(Sendedaten) ermittelt.

Die Sendedaten dürfen nicht verändert werden, solange Busy=TRUE ist und die Daten noch nicht vollständig gesendet wurden.

Length

UDINT

Length ist die Anzahl der zu sendenden Datenbytes und kann kleiner oder gleich der Größe der verwendeten Datenstruktur sein. Wenn der gesamte Inhalt einer Variablen gesendet werden soll kann Length mit SIZEOF(Sendedaten) ermittelt werden.

Ein-/Ausgänge

VAR_IN_OUT
  TxBuffer         : ComBuffer;
END_VAR

Name	Typ	Beschreibung
TxBuffer	ComBuffer	Sendedatenpuffer der mit der verwendeten Schnittstelle korrespondiert.

Ausgänge

VAR_OUTPUT
  Busy            : BOOL;
  Error           : ComError_t;
END_VAR

Name	Typ	Beschreibung
Busy	BOOL	Solange der Ausgang `Busy=TRUE` ist, wurde das Senden noch nicht abgeschlossen. Die Daten wurden erfolgreich gesendet, sobald `Busy=FALSE` und `Error=0` ist. Der Ausgang Busy wird demnach nicht TRUE, wenn die Daten bereits mit dem ersten Aufruf abgeschickt werden konnten. `Busy` wird FALSE sobald die Daten gesendet wurden oder ein Fehler oder ein Timeout aufgetreten ist.
Error	ComError_t	`Error` gibt im Fehlerfall einen Fehlercode aus.

Name

Typ

Beschreibung

Busy

BOOL

Solange der Ausgang Busy=TRUE ist, wurde das Senden noch nicht abgeschlossen. Die Daten wurden erfolgreich gesendet, sobald Busy=FALSE und Error=0 ist.

Der Ausgang Busy wird demnach nicht TRUE, wenn die Daten bereits mit dem ersten Aufruf abgeschickt werden konnten.

Busy wird FALSE sobald die Daten gesendet wurden oder ein Fehler oder ein Timeout aufgetreten ist.

Error

ComError_t

Error gibt im Fehlerfall einen Fehlercode aus.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT v3.1.4012	PC oder CX (ARM, x86, x64)	Tc2_SerialCom