F_iecCopyStreamToBuffer

FUNCTION F_iecCopyStreamToBuffer: UDINT

VAR_INPUT
    pBuffer     : DWORD;
    cbBuffer    : UDINT;
END_VAR
VAR_IN_OUT
    stream  : ST_IEC870_5_101Stream;
END_VAR

pBuffer: Pointer (address) of external buffer variable.

cbBuffer: Maximum number of data bytes to be copied from the stream variable to the external buffer.

stream: Data buffer.

Example in ST:

After run 4 data bytes are copied to the stream variable. The first 4 data bytes of the stream variable are copied to the rxBuffer variable by a rising edge at bRx .

PROGRAM P_CopyStreamToBuffer
VAR
    stream  : ST_IEC870_5_101Stream;
    txBuffer    : ARRAY[0..3] OF BYTE := 1, 2, 3, 4;
    cbTx    : UDINT;
    bTx     : BOOL := TRUE;

    rxBuffer    : ARRAY[0..3] OF BYTE;
    cbRx    : UDINT;
    bRx     : BOOL;
END_VAR

IF bTx THEN
    bTx     := FALSE;
    cbTx    := cbTx + F_iecCopyBufferToStream( ADR( txBuffer ), SIZEOF( txBuffer ), stream );
    txBuffer[0] := txBuffer[0] + 1;
    txBuffer[1] := txBuffer[1] + 1;
    txBuffer[2] := txBuffer[2] + 1;
    txBuffer[3] := txBuffer[3] + 1;
END_IF

IF bRx THEN
    bRx     := FALSE;
    cbRx    := F_iecCopyStreamToBuffer( ADR( rxBuffer ), SIZEOF( rxBuffer ), stream );
END_IF

Memory description of stream variable after run:

Memory description of stream variable after first and each further F_CopyStreamToBuffer function call:

Requirements