Timer
The described widget is suitable for displaying a timer in the app. The various configuration options are described below. In the figure all available features of the widget are active.
![Timer 1:](Images/png/9007211960867851__Web.png)
The widget is transferred as a substructure in the overall structure of the SendData() method. To build the widget, various PLC attributes are used when declaring the structure.
{attribute 'iot.ReadOnly' := 'false'}
{attribute 'iot.DisplayName' := 'Name for Widget'}
{attribute 'iot.WidgetType' := 'TimeSwitch'}
{attribute 'iot.TimeSwitchStartTimeVisible' := 'true'}
{attribute 'iot.TimeSwitchEndTimeVisible' := 'true'}
{attribute 'iot.TimeSwitchStartDateVisible' := 'true'}
{attribute 'iot.TimeSwitchEndDateVisible' := 'true'}
{attribute 'iot.TimeSwitchDaysVisible' := 'true'}
{attribute 'iot.TimeSwitchDateYearlyVisible' := 'true'}
{attribute 'iot.TimeSwitchModeVisible' := 'true'}
{attribute 'iot.TimeSwitchModeChangeable' := 'true'}
stTimeSwitchWidgetSample : ST_TimeSwitchWidgetSample;
Attribute | Data type | Description |
---|---|---|
iot.ReadOnly | BOOL | Determines whether the widget on the app side gets only read access (TRUE) or also additional write access to the PLC (FALSE). |
iot.DisplayName | STRING | The display name of the widget in the app. This will be overwritten by sDisplayName as soon as sDisplayName is not an empty string. |
iot.WidgetType | STRING | Type specification for the widget, in this case: TimeSwitch. |
iot.TimeSwitchStartTimeVisible | BOOL | Determines whether the start time is displayed (TRUE) or not (FALSE). |
iot.TimeSwitchEndTimeVisible | BOOL | Determines whether the end time is displayed (TRUE) or not (FALSE). |
iot.TimeSwitchStartDateVisible | BOOL | Determines whether the start date is displayed (TRUE) or not (FALSE). |
iot.TimeSwitchEndDateVisible | BOOL | Determines whether the end date is displayed (TRUE) or not (FALSE). |
iot.TimeSwitchDaysVisible | BOOL | Determines whether the weekdays are displayed (TRUE) or not (FALSE). |
iot.TimeSwitchDateYearlyVisible | BOOL | Determines whether the attribute for the annual configuration is displayed (TRUE) or not (FALSE). |
iot.TimeSwitchModeVisible | BOOL | Determines whether the mode is displayed (TRUE) or not (FALSE). |
iot.TimeSwitchModeChangeable | BOOL | Determines whether the mode is adjustable (TRUE) or not (FALSE). |
TYPE ST_TimeSwitchWidgetSample :
STRUCT
sDisplayName : STRING := '';
bOn : BOOL;
tStartTime : TIME_OF_DAY;
tEndTime : TIME_OF_DAY;
dStartDate : DATE;
dEndDate : DATE;
bYearly : BOOL;
bMonday : BOOL;
bTuesday : BOOL;
bWednesday : BOOL;
bThursday : BOOL;
bFriday : BOOL;
bSaturday : BOOL;
bSunday : BOOL;
sMode : STRING := 'Automatic';
aModes : ARRAY[0..1] OF STRING := ['Manual', 'Automatic'];
END_STRUCT
END_TYPE
Attribute | Data type | Description | Display in widget |
---|---|---|---|
sDisplayName | STRING | Determines the display name of the widget and overwrites the PLC attribute 'iot.DisplayName'. | Display text of the widget. |
bOn | BOOL | Switches the timer on (TRUE) or off (FALSE). | Toggle switch top right. |
tStartTime | TIME_OF_DAY | Start time of the timer. | Time on the left side of the arrow. |
tEndTime | TIME_OF_DAY | End time of the timer. | Time on the right side of the arrow. |
dStartDate | DATE | Start date of the timer. | Date on the left side of the arrow. |
dEndDate | DATE | End date of the timer. | Date on the right side of the arrow. |
bYearly | BOOL | Yearly. | Yearly (Depending on the language of the operating system). |
bMonday | BOOL | Monday. | M. |
bTuesday | BOOL | Tuesday. | D. |
bWednesday | BOOL | Wednesday. | M. |
bThursday | BOOL | Thursday. | D. |
bFriday | BOOL | Friday. | F. |
bSaturday | BOOL | Saturday. | S. |
bSunday | BOOL | Sunday. | S. |
sMode | STRING | Mode of the timer. | The currently displayed mode. |
aModes | ARRAY [0..n] OF STRING | Array of the different modes that can be set by the user. | By pressing on the current mode, the adjustable modes can be displayed. |