FB_IEC870_5_101Master

VAR_IN_OUT

VAR_IN_OUT
    hSerial : T_HSERIALCTRL;
    hTable  : T_HAODBTable;
END_VAR

hSerial: Connection handle to the FB_IEC870_SerialLineCtrl function block. This variable is used to exchange the data to be sent and received via the FB_IEC870_SerialLineCtrl function block.

hTable: Application object database handle (hash table handle). The table handle must be initialized once with the function F_iecCreateTableHnd before it can be used.

VAR_INPUT

VAR_INPUT
    protPara        : ST_IEC870_5_101ProtocolParams :=  := ( eType := eIEC870_101_MASTER );
    sysPara         : ST_IEC870_5_101SystemParams := ( bEndOfInit := FALSE );
    acqPara         : ST_IEC870_5_101AcquisitionParams;
    pAOEntries      : POINTER TO ARRAY[0..IEC870_ANYSIZE_ARRAY] OF ST_IEC870_5_101AODBEntry := 0;
    cbAOEntries     : UDINT := 0;
    pInputs         : PVOID := 0;
    cbInputs        : UDINT := 0;
    pOutputs        : PVOID := 0;
    cbOutputs       : UDINT := 0;
    pMemory         : PVOID := 0;
    cbMemory        : UDINT := 0;
    pData           : PVOID := 0;
    cbData          : UDINT := 0;
    bEnable         : BOOL := TRUE;
END_VAR

protPara: IEC 60870-5-101 protocol parameter.

sysPara: System parameter.

acqPara: Parameter for cyclic data acquisition.

pAOEntries: Address of the first application object database variable.

cbAOEntries: Byte size of the application object database variables.

pInputs: Address of the PLC process data area for the inputs.

cbInputs: Byte size of the PLC process data area for the inputs.

pOutputs: Address of the PLC process data area for the outputs.

cbOutputs: Byte size of the PLC process data area for the outputs.

pMamory: Address of the PLC process data area for the flags.

cbMamory: Byte size of the PLC process data area for the flags.

pData: Address of the PLC data area.

cbData: Byte size of the PLC data area.

bEnable: Activates/deactivates the function block (communication and connections).

The addresses can be determined with the ADR operator and the byte sizes with the SIZEOF operator.

VAR_OUTPUT

VAR_OUTPUT
    system  : ST_IEC870_5_101ExSystemInterface;
    eState  : E_IEC870_5_101SerialLinkState := eSERIALLINK_DISCONNECTED;
END_VAR

system: System interface. This variable is used by other IEC application functions as a communication interface for the IEC device (here: central station).

• Member variable system.device is expected by the F_iecSetAOQuality function as VAR_IN_OUT parameter, for example.
• Member variable system.device.errors is a device error FIFO. The PLC application can read and analyse registered errors.

eState: Connection status to the slave.

Examples (High-Level interface):

• IEC 60870-5-101 minimal central station (master);
• IEC 60870-5-101 complex central station (master);

Further examples:

The device error Fifo is read cyclically and the registered errors are written in the TwinCAT XAE->"Error List" window.

...
fbClient : FB_IEC870_5_101Master; (* IEC 60870-5-101 control station function block instance *)
...

...
REPEAT
    fbClient.system.device.errors.RemoveError();
    IF fbClient.system.device.errors.bOk THEN
        ADSLOGSTR( ADSLOG_MSGTYPE_ERROR OR ADSLOG_MSGTYPE_LOG, 'IEC 60870-5-101 master communication error: 0x%s',
                DWORD_TO_HEXSTR( fbClient.system.device.errors.getError.nErrId, 8, FALSE) );
    END_IF
UNTIL NOT fbClient.system.device.errors.bOk
END_REPEAT
...

Requirements