rfbcRawSend (Function)

This function will send a raw RFBC packet.

If a destination address is given an acknowledgment is expected to be received.

If no destination address is given the function simply returns without waiting for an acknowledge.

Input:

id  : DINT [0 .. 16_777_215] (default 0)

ID of the device the request is sent to.

0 = Broadcast notification to all listening devices.

number : INT [-1,0 .. 255] (default -1)

This sets the current packet number.

If "-1", then last packet number +1 will be used.

flags    : INT [0 .. 255] (default 0)

Packet flags.

type     : INT [0 .. 255] (default 0)

Packet message type.

datasize : INT [0 .. 54]

Size of data.

data : PTR

Address of the memory block that will be sent as a payload.

wait : BOOL [TRUE, FALSE] (default TRUE)

Wait for acknowledgment of reception, if set to FALSE then the function will return without waiting for an acknowledgment after transmitting the packet once.

Output:

None.

Returns: INT

Declaration:

FUNCTION rfbcRawSend : INT;
VAR_INPUT
  id       : DINT := 0;
  number   : DINT := -1;
  flags    : INT := 0;
  type     : INT := 0;
  datasize : INT;
  data     : PTR;
  wait     : BOOL := TRUE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR_INPUT
  send     : BOOL R_EDGE;
END_VAR;
 
PROGRAM example;
VAR
data : ARRAY[1..54] OF SINT;
 msg   : STRING := "Hello world!";
END_VAR;
 
BEGIN
 IF send THEN
   // Copy contents of a string to memory
  strToMemory(dst:=ADDR(data), str:=msg, len:=strLen(str:=msg));
   // Broadcast the message as a raw packet
  rfbcRawSend(data:=ADDR(data), datasize:=strLen(str:=msg));
 END_IF;
 ...
END;
END_PROGRAM;