Socket

The described widget is suitable for displaying a socket in the app. The various configuration options are described below. In the figure all available features of the widget are active.

Socket 1:

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' := 'Plug'}
{attribute 'iot.PlugModeVisible' := 'true'}
{attribute 'iot.PlugModeChangeable' := 'true'}
stPlugWidgetSample : ST_PlugWidgetSample;

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: Plug.

iot.PlugModeVisible

BOOL

Determines whether the mode is displayed (TRUE) or not (FALSE).

iot.PlugModeChangeable

BOOL

Determines whether the mode is adjustable (TRUE) or not (FALSE).

TYPE ST_PlugWidgetSample :
STRUCT
    sDisplayName    : STRING := '';
    bOn             : 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 socket on (TRUE) or off (FALSE).

Toggle switch top right.

sMode

STRING

Mode of the socket.

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.