GetSyncInformation (FUN) ¶ FUNCTION GetSyncInformation : RTS_IEC_RESULT Fills structure SYNC_INFO with information about the redundancy synchronizsation status. InOut: Scope Name Type Return GetSyncInformation RTS_IEC_RESULT Input pSyncInfo POINTER TO SYNC_INFO
IsAddressInArea (FUN) ¶ FUNCTION IsAddressInArea : BOOL It checks if a generic memory address belongs to a registered memory area. InOut: Scope Name Type Comment Return IsAddressInArea BOOL Input pAddress POINTER TO BYTE Address to check Output eType AREA_TYPE Redundancy area type where the address belong to pArea POINTER TO BYTE Start address of area udiSize UDINT Size of area
RedundancySynchronizeData (FUN) ¶ FUNCTION RedundancySynchronizeData : BOOL Synchronze global data once. This includes the areas registered in redundancy. Can be called from active or standby controller. InOut: Scope Name Type Return RedundancySynchronizeData BOOL
SwitchToActive (FUN) ¶ FUNCTION SwitchToActive : BOOL Switches a plc to redundancy state RS_CYCLE_ACTIVE. Can be called in state RS_SIMULATION and RS_CYCLE_STANDBY. In state RS_SIMULATION, plc will become RS_CYCLE_ACTIVE (if second plc is running) or RS_CYCLE_STANDALONE (if second plc is not running). In state RS_CYCLE_STANDBY, plc will become RS_CYCLE_ACTIVE. State change is not performed immediately. A commend send to other plc in next StartCycle or EndCycle. InOut: Scope Name Type Return SwitchToActive BOOL
Structures ¶ RdtInitStructClientTCP (Struct) RdtInitStructServerTCP (Struct) RdtProtStructCommPh (Struct) RdtProtStructConnection (Struct) RdtProtStructResPh (Struct)
SwitchToSimulation (FUN) ¶ FUNCTION SwitchToSimulation : BOOL Switches a plc to redundancy state RS_SIMULATION. Can be called in state RS_CYCLE_STANDBY, RS_CYCLE_ACTIVE and RS_CYCLE_STANDALONE InOut: Scope Name Type Return SwitchToSimulation BOOL
RdtInitStructClientTCP (STRUCT) ¶ TYPE RdtInitStructClientTCP : STRUCT Structurce for TCP client initialization InOut: Name Type Initial Comment sName STRING Name of the client, the name can be completely user defined sIPAddress STRING IpAdd of the server to connect with uiPort UINT Port of the server to connect with tTrsTimeout TIME Transmission timeout tRcvTimeout TIME Receiving timeout tConnActTimeout TIME Connection active timeout xUseTLS BOOL If the TLS encryption is used or not xUseCert BOOL If the certificate is used or not sCertCommonName STRING A string to select the correct certificate in local certificate store, hCert RTS_IEC_HANDLE RTS_INVALID_HANDLE External cert handle to use. Exclusive use vs cert name udiVerificationMode UDINT 2 1 => No peer verification 2 => Active Peer verification (4) => 2+4 = 6 => Force termination, if no client certificate (8) => 2+8=10 or 2+4+8 = 14 => Request client certificate only whithin initial handshake sTLSVersion STRING ‘1.2’ A string to select the correct protocol version, e.g.: ‘1.1’, ‘1.2’, sHostname STRING ‘’ A hostname to select the correct certificate on the server side. sCipher STRING ‘HIGH’ The cipher strings. See for example: https://www.openssl.org/docs/man1.1.1/man1/ciphers.html#CIPHER - LIST-FORMAT itfCertVerifer NBS.ICertificateVerifier 0 A callback for application specific certificate verification
SwitchToStandalone (FUN) ¶ FUNCTION SwitchToStandalone : BOOL Switches a plc to redundancy state RS_CYCLE_STANDALONE. Can be called in state RS_SIMULATION_START and RS_CYCLE_STANDBY. In state RS_SIMULATION_START, if application is not loaded: state is set and application is loaded and started. In state RS_CYCLE_STANDBY, with next StartCycle or EndCycle, command is sent to other PLC to switch to RS_SIMULATION. Then, own state is changed. InOut: Scope Name Type Return SwitchToStandalone BOOL
SwitchToStandby (FUN) ¶ FUNCTION SwitchToStandby : BOOL Switches a plc in redundancy state RS_CYCLE_ACTIVE to RS_CYCLE_STANDBY InOut: Scope Name Type Return SwitchToStandby BOOL
Synchronize (FUN) ¶ FUNCTION Synchronize : BOOL Synchronizes a plc in redundancy state RS_START, RS_BOOTUP_ERROR, RS_SYNCHRO_ERROR, RS_CYCLE_ERROR, RS_CYCLE_STANDALONE, RS_SIMULATION or RS_SIMULATION_START. Please note that the current application is stopped and unloaded before trying to sync with the other controller. In standlone mode, value of xReadyForSync of structure SYNC_INFO may be checked before calling this function. InOut: Scope Name Type Return Synchronize BOOL