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 |
|
Oblong |
|
Rectangular |
|
Square |
|
Triangular Down |
|
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 |
|
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 |
|
Constant push button 0.
|
pb_const0_<shape>_<colour>
|
Writes 0 to the HMI server.
|
Write 0 Push Button
|
|
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 |
|
Increment push button.
|
pb_inc_<shape>_<colour>
|
Increments a value in the HMI server.
|
Increment Push Button
|
|
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 |
|
Write integer push button.
|
pb_int_<shape>_<colour>
|
Writes an integer to the HMI server.
|
Write Integer Push Button
|
|
Write float push button.
|
pb_float_<shape>_<colour>
|
Writes a float to the HMI server.
|
Write Float Push Button
|
|
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 |
|
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 |
|
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 |
|
Toggle push button.
|
pb_toggle1_<shape>_<colour>
|
Checks a tag value, and writes the opposite.
|
Toggle Push Button 1
|
|
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 |
|
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
|
|
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
|