RemoteControl

The #RemoteControl object is used for the remote control of several EPAM applications networked via Ethernet. For example, it can be used to implement from a main visualization the remote control of an HMI unit which is located at a different plant section. The #RemoteControl object shows here the frame in which the current image of the remote HMI can be displayed. Inputs, for example, are likewise transferred to the remote HMI station and have the same effect as local operation on the remote device itself. Conversely, only changes to the screen content of the remote HMI station are transferred (cf. remote desktop).

Column A, object	M/O	Default	Description
#RemoteControl	M		Remote control of networked EPAM applications

Column B, Text/File	M/O	Default	Description
	M/O	Empty string	IP address of the host from VarValue
192.168.0.%1	O/M		Part of the IP address of the host from VarValue
[<Host>[:<port>]]	O/M		IP address of the host and optionally the port, separated by a colon. Default port: 5900. e.g.192.168.0.99

C Font column	M/O	Default	Description
<Fontname>.FNT	O	Current font	Font for the display of text messages

Columns D-G

M/O

Default

Description

Integer constants

Autom. positioning

Position and dimension

The dimension of the object should if possible be a 1:1 equivalent of the remote screen or an integer multiple of it. The screen content is zoomed in all cases, however, the quality and performance is not optimal.

Variable of type INT

Column H	M/O	Default	Description
<color>	O	Current foreground color	Font color

Column I	M/O	Default	Description
<color>	O	Current background color	Background color

Column K	M/O	Default	Description
OnError:#Page=<name>	O		The #Page=<name> is called in the event of protocol errors
OnError:Close			The top page is closed in the event of protocol errors
OnError:Close=<name>			The #Page=<name> is closed in the event of protocol errors

Column P	M/O	Default	Description
<variable>	O		Variable with part or entire IP address

Column Q

M/O

Default

Description

STRING

Part (replaces %1) or whole IP address as string

WORD

UINT

INT

Part IP address numerical, replaces %1 in Text/File column

Column R	M/O	Default	Description
<variable>	O		See VarState column

Column S

M/O

Default

Description

Password=<password>

<password> The password is transferred without encryption

VarStateOnOffInverted

Inverts the On / Off functionality of the VarState Variable:

VarState = 0 -> Off

VarState = 1 -> On

If a #RemoteControl object is used from one device to access another device with the same resolution (e.g. 320x240, full screen), an Invisible button must be configured on the device with the #Page=xy action and a timeout (e.g. at the bottom right, DX, DY 1 pixel). This enables remote control to be shut down automatically after the defined timeout without operation.

Otherwise the device with the RemoteControl object must have a higher resolution (larger screen) than the remotely controlled device. For example, the screen of a 1/4VGA device (320x240) is displayed in a VGA device (640x480).

The following system variables are used in conjunction with the #RemoteControl object:

System variable

Description

/S/SYS/RCInput_enabled

Shows the current status:

•	1=Input enabled

•	0=Input disabled

/S/SYS/RC_Password

Password for RemoteControl server (alternative to Password= option)

/S/SYS/RemoteClient.connected

Indicates whether a client is currently connected to the device (target).

•	0 = No connection

•	>0 = One or several connections