6.7.1 Settings

To open the ‘Switch/Lamp’ dialog box, press [Draw] – [Switch/Lamp] or icon and click the background of the page.

Shape Configuration

On the left side of the configuration window, you can set up the appearance and position of the switch/lamp object. You can choose the shape of the switch/lamp object and configure its size and position.

Item	Description
Shape Select	You may decide the shape of the Switch/Lamp object.
Nil Shape	Hides the shape of the object. It is marked with dotted lines in the editor, but the lines are not shown in the project runtime.
Position Setting	Assign the position of the object. You can assign values from 0 to 32767. The X/Y position indicates the coordinates on the graphic page. When you manually set up the position, be cautious that the object does not exceed the page.
Size Setting	Assign the size of the object. You can assign values from 0 to 32767. The size is based on the default size of the shape you have selected. When you manually set up the size, be cautious that the object does not exceed the page’s size.

(1) Shape Select

When the lamp feature is disabled, only the switch shape will be selected. When the lamp feature is enabled, you can select images to indicate each status.

Item	Description
Part Palette	Images provided by XpanelDesigner are listed here. You can select the categories from the combo box.
Pattern	Displays each pattern of switch/lamp operation. You can apply the shape by double-clicking the item.
New Palette	You can create a new switch/lamp image. Enter the file name(*.ipx) and press the ‘Save’ button to create a part file.
Register	Registers each pattern of switch/lamp operation. You can use BMP, JPG, and PNG file format, from state 0 to state 16.
Delete	Deletes the selected switch/lamp image from the list. Note that you cannot delete the default images provided by XpanelDesigner.
OK	Applies the switch/lamp image with settings.
Cancel	Closes the ‘Shape Select’ dialog box without configuration.

Switch Feature

In this section, you can configure a function for the object when it is pressed in the project runtime. The Switch functionality has operations such as bit switch, word switch, page switch, and switch with special functions. You may check the operation order from the list.

Item	Description
Switch Function	Decides to use the object as a switch function. When the option is deselected, the object can only be used as a lamp function.
Display Touch Highlight	If the option is selected, the object will be displayed with its reversed color when touched.
Touch Down	Add the operation you wish to execute when pressing the button.
Touch Up	Add the operation you wish to execute when releasing the button.
Bit Switch	Defines a digital tag operation.
Word Switch	Defines an analog tag operation.
Page	Assigns the page to open when using the object.
Special Function	Assigns the command, key input, or writing momentary value function to the object.
Edit	Edits the selected operation of the switch.
Delete	Removes the selected operation from the switch.

(1) Bit Switch

Item	Description
Address	Controls the object with the address of the device registered in “I/O Device”. You can decide the unit of the data: BIT or WORD. The detailed configuration can be done by pressing the button.
Tag Name	Enter the tag name to change the value when the switch is pressed. You can manually enter the tag name or press the button to browse the tag. Do not enter the analog or string tag name.
Function	Defines the action when the switch is pressed.
	Set	Sets the digital tag value as ON(1).
	Reset	Sets the digital tag value as OFF(0).
	Set on touch	This feature can be treated the same as ‘Write momentary’. The tag value goes ON(1) as the switch is pressed, and the value goes OFF(0) as the switch is released. ※ ‘Set on touch’ function is supported in XpanelDesigner 2.53 and above versions.
	Toggle	Reverses the state of the digital tag when it is pressed. (OFF(0) → ON(1) or ON(1) → OFF(0))

(2) Word Switch

Item	Description
Action	Defines an analog tag operation.
	Write Analog Value		Writes the assigned value to the corresponding tag.
	Tag Operation		The tag value will be calculated based on the set value and operator.
Address	Controls the object with the address of the device registered in “I/O Device”. You can decide the unit of the data: BIT or WORD. The detailed configuration can be done by pressing the button.
Tag Name	Enter the tag name to change the value when the switch is pressed. You can manually enter the tag name or press the button to browse the tag. Do not enter the digital or string tag name.
Value	Assign a tag value to write when the switch is pressed.
	Hexa	Writes the value in hexadecimal in the input field.
	Using Tag	When you select this option, the input field is changed into a tag registering field. You can manually enter the tag name or browse the tag by clicking the button. You can add a digital or an analog tag. When the switch/lamp object operates, the tag value assigned to [Tag Name] becomes the value assigned to [Use Tag].
Operator	This item appears when you have selected the ‘Tag Operation’ action. The operators you can use are [+, -, AND, OR, XOR].

(3) Page Switch

Item	Description
Page Type	Assign the page to open when pressing the switch.
	General Page	Enter the page file name in the text field to open. You may browse the page file by pressing the button.
	Keypad Page	Enter the keypad page file name in the text field to open. You may browse the keypad page file by pressing the button.
Open Keypad Page	Assign the keypad page to open when pressing the switch.
	Address	Gets the value with the address of the device registered in “I/O Device”. You can decide the unit of the data: BIT, WORD, or STRING. The detailed configuration can be done by pressing the button.
	Tag Name	Enter the tag name to get the value when the switch is pressed. You can manually enter the tag name or press the button to browse the tag.
	Horizontal / Vertical	Assign the location where the keypad page will be opened at the ‘Vertical Scale’ and ‘Horizontal Scale’. It is recommended to enter a value smaller than the Xpanel’s resolution.
	Max / Min	You can select the ‘Use Max/Min’ option to assign the range of values. If the option is deselected, the minimum and the maximum values are set equal to the tag’s values.

(4) Special Function

Item	Description
Command	You can write a command expression to execute.
Key Input	Operates as a key in a keyboard. Supports 83 keys in total, such as Arrow keys, HOME, END, PAGE UP/DOWN, INSERT, DELETE, LOCK Keys, Alphabets, Numbers, ENTER, SPACE, ESCAPE, PRINT SCREEN, PAUSE, F1~F12, TAB, “/”, “*”, “-“, “+”, “.”, CLEAR.
Write Momentary	Writes an instant value when you touch or release the object.
	Down – Written Value	Inputs a value when you touch the object.
	Up – Written Value	Inputs a value when you release the object.

Switch Common

This section explains the conditions when the user touches the switch/lamp object. You can also set a security level on the object.

Item	Description
Touch Condition Setting	Logical operations can be used to control touch features. When the result of a logical operation is True, the touch feature operates; otherwise it does not.
Action Delay Setting	Sets a delay option that executes by a set number of seconds. This option will be executed only when the button is pressed and held down for the assigned value. The value you can assign is from 1(100msec) to 30(30000msec) seconds. Or you can input an analog tag name to specify delay time according to the assigned value.
	On Delay	When touching the object for the set amount of time, the assigned action set in ‘Touch Down’ would run. If untouched before reaching the set amount of time, the object would not operate. ‘On Delay’ is usable for the ‘Touch Down’ action. The ‘Touch Up’ action operates with no relation to ‘On Delay’.
	Off Delay	The assigned action would operate when releasing the object after the set amount of time (Delay time). ‘Off Delay’ is usable for the ‘Touch Down’ or ‘Touch Up’ action.
	Double Touch	The assigned action would operate when touching the object and retouch in intervals. ‘Double Touch’ is usable for the ‘Touch Down’ or ‘Touch Up’ action.
	Display Delay Status	When this option is selected, the ‘Delay’ status will be added in the ‘Shape Select’ window. While the ‘Delay setting’ is operating, the shape of the switch is changed into ‘Delay’ status so that you can view the delay time. ※ ‘Display Delay Status’ function is supported in XpanelDesigner 2.53 and above versions.
Visible	When the option is selected, enter the tag name in the input field to specify the tag for visible condition. When the visible condition is satisfied, the corresponding switch object will appear. ※ ‘Visible’ function is supported in XpanelDesigner 2.53 and above versions.
	ON	The switch object appears when the assigned digital tag value is ON(1) or the analog tag value is bigger than 0.
	OFF	The switch object disappears when the assigned digital tag value is OFF(0) or the analog tag value is 0.
Security	Sets a security level on the object. (1-10) ※ Please refer to the ‘Security’ manual for more information.

If multiple switches are defined, they are disabled when one switch is operating, including the ‘On/Off Delay’ setting. If the value of the PLC contact is changed, the shape of the linked switch will be changed together.

Lamp Feature

The ‘Lamp’ feature shows the appearance of an object based on a condition. If the lamp feature is disabled, the object will only display a switch image.

Item	Description
Enable Lamp	Decides the enablement of the lamp feature and type of the lamp.
	Digital Tag	Operates by a combination of digital tags. Lamp state is changed according to data value or bit combination.
	Analog Tag	Operates by a combination of analog tags. Changes the lamp state by tag value or bit combinations.
Number of States	Assigns the number of states to display a lamp object.
Condition of State	Changes the lamp state with two methods.

(1) Changing states with bit lamp

Item

Description

With Data Condition Conversion

Each digital tag composes each digit of the binary number. The state of data is defined according to the combination of each digit.

E.g.) If DIGITAL1 = 0, DIGITAL2 = 1, DIGITAL3 = 1 and DIGITAL4 = 0, they indicate 0110 in binary. Since it is equal to “6” in decimal, the ‘State 6’ is displayed.

You can use a maximum of 16 states with this option.

At Each Bit Conversion

Each digital tag represents a single state. If all digital tags’ values are “0”, “State 0” will be displayed. If the DIGITAL4 = 1, the “State 4” will be displayed. When multiple tags are set as “1”, the priority goes to the state with the lower number.
E.g.) If DIGITAL1 = 1, DIGITAL3 = 1, “State 1” will be displayed.

You can use a maximum of 5 states with this option.

(2) Changing states with word lamp

Item

Description

With Data Condition Conversion

Displays the state with a single analog tag. A maximum of 256 states can be displayed.

At Each Bit Conversion

Since an analog is composed of a word, it is possible to display the states with 16 bits. It indicates that a word can display 17 states. Only one bit can be turned ON at a time. If any other bit is ON simultaneously, the priority goes to the less significant bit.

E.g.) If the value of an analog tag is 3(0000 0000 0000 0011), State 1 and 2 are supposed to be ON. However, since State 1 has a higher priority, State 1 is ON.

Label

You can display text on the object. The text may differ according to the tag’s state. Users can enter the text manually or retrieve the contents from the string table.

Item	Description
State Select	Select a state of the tag (OFF or ON) when the label is displayed. If you have configured multiple states on the [Lamp Feature] tab, you can select a state in the range as shown below.
	Bit Lamp	With Data Condition Conversion	Max 16 states (0 ~ 15)
		At Each Bit Conversion	Max 5 states (0 ~ 4)
	Word Lamp	With Data Condition Conversion	Max 256 states (0 ~ 255)
		At Each Bit Conversion	Max 17 states (0 ~ 16)
Input Type	Direct Input	The operator manually enters the text to be displayed on the object. You can enter up to 30,000 characters.
	String Table	Retrieve the string you have entered in the string table. You can set group and string No. ※ Please refer to the ‘String Editor’ manual for more information about the string table.
	Font Set	Configure the manually entered text’s properties, such as font type, font size, alignment, and slant.
	RTL	RTL(Right-to-Left) language means the character writing starts from the right of the text field and continues to the left. When the option is selected, the text will be displayed in a reversed direction. This option is enabled when the label is directly entered in the input field. Use the ‘RTL’ setting in the ‘String Table’ function when you wish to display strings through the string table. The RTL setting of a label is applied at the Xpanel runtime. ※ ‘RTL’ option is supported in XpanelDesigner 2.53 and above versions.
Apply Label to All State	The current label setting will be applied to all states.
Apply Font to All state	The current font setting will be applied to all states.