Get MBLogic at SourceForge.net. Fast, secure and Free Open Source 
	software downloads

Push Buttons

All push buttons cause some action to be performed when pressed (or released in some cases). They come in a variety of different shapes and colours. In addition they come in a variety of categories, where each category performs a different type of action.


Push Button Shapes

Push buttons shapes come in the following shapes and sizes. Most buttons are available in multiple different shapes, and the images associated with the descriptions are examples only.

Name
clip-art Oblong
clip-art Rectangular
clip-art Square
clip-art Triangular Down
clip-art Triangular Up

Menu Push Buttons

A menu push button selects an SVG layer for display. This does not write data to the HMI server, but rather it just affects what is displayed on the HMI screen.

Type Name Description HMIBuilder Name
clip-art SVG menu push button. pb_menu_<colour> Push button for selecting SVG layers. Menu Push Button

HMIBuilder Parameters

Parameter Type Values Description
Layer Name Option menu Layer names The name of the layer ("screen") which the button is to activate.

Constant Push Buttons

A constant push button writes a constant value to the HMI server.

Description

Type Name Description HMIBuilder Name
clip-art Constant push button 0. pb_const0_<shape>_<colour> Writes 0 to the HMI server. Write 0 Push Button
clip-art Constant push button 1. pb_const1_<shape>_<colour> Writes 1 to the HMI server. Write 1 Push Button

HMIBuilder Parameters

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to

Increment/Decrement Push Buttons

Increment and decrement push button increment or decrement a value in the HMI server with respect to a reference value. Typically, the tag (address) of this reference value will be the same as the target address. However, it may be different address if that is required.

Description

Type Name Description HMIBuilder Name
clip-art Increment push button. pb_inc_<shape>_<colour> Increments a value in the HMI server. Increment Push Button
clip-art Decrement push button. pb_dec_<shape>_<colour> Decrements a value in the HMI server. Decrement Push Button

HMIBuilder Parameters

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to
Reference Tag Option menu Address tags The reference tag
Increment integer Any valid integer The amount to increment by each time the button is clicked
Limit integer Any valid integer The maximum limit for incrementing

Note: For a decrement button, the increment value should be negative. This will be added to the current value, so you want to add a negative number (which will result in a subraction). The limit should also be negative.

When the limit value is reached, the button will no longer increment the value.


Write Integer, Float or String Push Buttons

Write integer, float, or string push buttons will write an integer, float, or string constant to the HMI server when pressed. The write integer push button differs from the constant 0 and constant 1 push buttons in that the integer to be written is a parameter rather than a fixed value.

Description

Type Name Description HMIBuilder Name
clip-art Write integer push button. pb_int_<shape>_<colour> Writes an integer to the HMI server. Write Integer Push Button
clip-art Write float push button. pb_float_<shape>_<colour> Writes a float to the HMI server. Write Float Push Button
clip-art Write string push button. pb_string_<shape>_<colour> Writes a string to the HMI server. Write String Push Button

HMIBuilder Parameters

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to
Integer (or Float or String) Value Data entry box. Any valid integer (or float or string). The value to write

Momentary Push Buttons

Momentary push buttons write a 1 to the HMI server when pressed, and then a 0 when released. This means the value will only be turned on so long as the button is pressed.

Description

Type Name Description HMIBuilder Name
clip-art Momentary action push button. pb_moment_<shape>_<colour> Writes a 1 when pressed, and a 0 when released. Momentary Push Button

HMIBuilder Parameters

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to

Pulse Push Buttons

A pulse push buttons writes a 1 to the HMI server when pressed, followed by a 0 after a time delay. This differs from a momentary button in that the time between writing a 1 and a zero is predictable and regular.

Description

Type Name Description HMIBuilder Name
clip-art Momentary action push button. pb_pulse_<shape>_<colour> Writes a 1 when pressed, and a 0 after a time delay. Pulse Push Button

HMIBuilder Parameters

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to
Pulse Length (msec) Data entry box Any valid integer. The length of the time delay before writing 0

Note: The pulse length parameter is the time in milliseconds between the button being activated and the zero value being written.


Toggle Push Buttons

A toggle push buttons uses a reference address (tag) to decide what to write when activated. If the reference value is 0, it writes a 1 to the HMI server. If the reference value is not 0, it writes a zero. This causes it to toggle between 0 and 1.

Toggle push buttons that do not use a separate reference tag use the input tag as the reference value. Buttons that allow the use of a separate reference tag (address) would normally use a different tag for this, but may use the same tag for both parameters if desired.

Description

Type Name Description HMIBuilder Name
clip-art Toggle push button. pb_toggle1_<shape>_<colour> Checks a tag value, and writes the opposite. Toggle Push Button 1
clip-art Toggle push button with reference tag. pb_toggle2_<shape>_<colour> Checks a reference value, and writes the opposite. The reference tag may be different from the tag written to. Toggle Push Button 2

HMIBuilder Parameters

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to
Reference Tag 1 Option menu Address tags The reference tag

1Note: The reference tag parameter is only present for toggle push buttons that use a separate reference tag.


Illuminated Push Buttons

Illuminated push buttons combine the functions of pilot lights and push buttons. The push button component works the same way as the corresponding conventional push button. The button colour is controlled in the same manner as a pilot light.

Description

Type Name Description HMIBuilder Name
clip-art Toggle illuminated push button. pb_illum_toggle_<shape>_<colour> Checks a tag value, and writes the opposite. Also includes a pilot light function in place of the button colour. Toggle Illuminated Push Button
clip-art Pulse illuminated push button. pb_illum_pulse_<shape>_<colour> Writes a 1 when pressed, and a 0 after a time delay. Also includes a pilot light function in place of the button colour. Pulse Illuminated Push Button

HMIBuilder Parameters for Toggle Illminated Push Button

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to
Output Tag Option menu Address tags The HMI server tag to read the current state from
Init Colour Option menu Colour The colour to before starting
Off Colour Option menu Colour The colour to use when the output tag is 0
On Colour Option menu Colour The colour to use when the output tag is not 0

HMIBuilder Parameters for Pulse Illminated Push Button

Parameter Type Values Description
Input Tag Option menu Address tags The HMI server tag to write to
Pulse Length (msec) Data entry box Any valid integer. The length of the time delay before writing 0
Output Tag Option menu Address tags The HMI server tag to read the current state from
Init Colour Option menu Colour The colour to use before starting
Off Colour Option menu Colour The colour to use when the output tag is 0
On Colour Option menu Colour The colour to use when the output tag is not 0