RTC_EX2
The "RTC_EX2" (Extended Real Time Clock) function block allows an internal Software clock to be implemented in TwinCAT PLC. The clock must be initialized with a starting date and time. After the initialization the time and date are updated with each call of the function block. A CPU system clock is used to calculate the current time and date. The function block should be called in every PLC cycle, so that the current time can be calculated. At the output of the function block the current date and time is available in the Windows system time format. In contrast to the RTC function block, RTC_EX2 has an accuracy of one microsecond. Multiple instances of the RTC_EX2 function block can be created within one PLC program.
 | The way the system works means that the RTC_EX2 time can differ from the reference time. The difference depends on the PLC's cycle time, the value of the basic system ticks, and on the hardware being used. In order to avoid larger deviations the RTC_EX2 instance should be synchronized cyclically (e.g. with a radio clock or with the local Windows system time). The local Windows system time you can be synchronized with a reference time via the SNTP protocol. |
VAR_INPUT
VAR_INPUT
EN : BOOL;
PDT : TIMESTRUCT;
PMICRO : DWORD;
END_VAR
EN: The RTC_EX2 function block is re-initialized with a specified date, time and millisecond by a rising edge at this input.
PDT: ( Preset Date and Time ) The initialization values for the function block's date and time. A rising edge at the EN input will cause the function block to adopt this value.
PMICRO: ( Preset Microseconds ) The initialization value for the microseconds. A rising edge at the EN input will cause the function block to adopt this value.
VAR_OUTPUT
VAR_OUTPUT
Q : BOOL;
CDT : TIMESTRUCT;
CMICRO : DWORD;
END_VAR
Q: This output is set if the function block has been initialised at least once. If the output is set, the values for the date, time and milliseconds at the PDT and CMSEK outputs are valid.
CDT: ( Current Date and Time ) The current date and time from the RTC_EX2 instance. The CDT output is only updated when the function block is called. For this reason, instances of the function block should be called once in each PLC cycle.
CMICRO: (Current Microseconds) The microseconds output.
Example:
Requirements
Development environment | Target System | PLC libraries to include |
|---|---|---|
TwinCAT v2.9.0 Build > 1030 and higher | PC or CX (x86) | TcUtilities.Lib |
TwinCAT v2.10.0 Build >= 1301 | CX (ARM) |