1. TOGGLE SWITCH
Switchtoggle
Visually represents the idea of moving a lever from one position to another. Toggle switches are generally associated with switching between two positions and maintaining the selected state.
SWITCH_BUTTON allows the operator to perform a command or change a state on a SCADA screen through a visual interface that gives the impression of using a physical switch. The SBSwitchTuru enumeration in the source code defines six different switch appearances.
An important characteristic of these six appearances is that they change the visual interaction model presented to the operator rather than the fundamental command logic of the control. The electrical details of a physical field toggle, rocker, or rotary switch should not be assumed to be identical to the command-writing behavior of this user control within SCADA. Here, these names primarily describe the visual and interactive design language. General switch terminology also describes the physical characteristics of these switch types in a similar way.
With SWITCH_BUTTON, a switch appearance suited to the operator screen design can be selected. The same command function can therefore be represented with different visual characteristics, such as a lever, rocker, LED, rotary, or panel-style switch. Especially in control panels, the switch shape is an important visual element that helps the operator identify the control at a glance.
The following six types are defined directly by the SBSwitchTuru enumeration in the source code. Treating each type as a distinct visual style is one of the key strengths of SWITCH_BUTTON.
Switchtoggle
Visually represents the idea of moving a lever from one position to another. Toggle switches are generally associated with switching between two positions and maintaining the selected state.
Switchled
This visual type emphasizes the switch state with a light indicator. The DefaultColor, SwitchedColor, OnStateText, and OffStateText properties in the source code can also help distinguish the state through color and text.
Switchlever
This switch appearance emphasizes the position of an elongated lever or handle. It allows the operator to perceive the switch position in a way similar to a physical control lever.
Switchrocker
Represents a switch with an actuator that rocks to either side around a central axis. The defining characteristic of physical rocker switches is likewise an actuator that pivots between two sides.
Switchrotary
Visually represents the idea of turning a central knob. In general rotary-switch terminology, rotation is used to select different positions or options; in the SWITCH_BUTTON source code, this appearance is one of the visual types of the same switch control.
Switchpanel
This is a compact switch appearance perceived together with its surrounding housing and status indicator, as if mounted on a panel. Panel-style switches are commonly used in industrial applications and control panels.
From a SCADA perspective, the basic operating flow of SWITCH_BUTTON is based on associating the operator's interaction with the visual switch with the command to be sent to the controller. The source code defines LevelThreshold = 0.5 as the threshold used for two-state visual evaluation. However, because the supplied source excerpt does not separately show which physical data point receives the command or which command values are written, this section explains only the visual and threshold behavior supported by the source code.
SWITCH_BUTTON should not be considered a monitoring indicator. Since operator interaction may trigger an operation on the controller, incorrect use can affect process behavior. Therefore, the connected data point, the meaning of the command, and user permissions must be carefully verified before commissioning. Particularly for critical equipment, the actual field state must not be assumed to have been definitively confirmed merely by looking at the switch's visual state.
| Property | EOS Turkish Equivalent | Default | Description |
|---|---|---|---|
UCType |
Control Type | SWITCH_BUTTON |
Defines the user control as type SWITCH_BUTTON. |
UpdateInterval |
Update Interval | 1000 |
Determines the control's update interval. |
DecimalPoint |
Decimal Places | 0 |
General numeric display setting for the control. |
UCBackColor |
Control Background Color | Transparent |
Determines the control's background color. |
UCForeColor |
Control Text Color | Black |
Determines the control's general text color. |
UCFont |
Control Font | Arial Narrow, 8.25 pt |
Determines the control's general font. |
LevelThreshold |
Level Threshold | 0.5 |
The threshold value used for two-state visual evaluation. |
DefaultColor |
Default Color | Red |
Determines the visual color of the switch in its default state. |
SwitchedColor |
Switched Color | Lime |
Determines the color used when the switch is in the switched state. |
CursorColor |
Cursor Color | Silver |
Determines the color of the switch's moving or position-indicating visual component. |
ButtonColor |
Button Color | Gold |
Determines the primary color of the switch button or actuator. |
CursorThickness |
Cursor Thickness | 40 |
Determines the thickness of the cursor graphic. |
DisplayBoder |
Display Border | false |
The technical property name from the source code is preserved; this setting determines whether the border around the switch is displayed. |
BorderColor |
Border Color | Black |
Determines the border color when the border is displayed. |
BorderThickness |
Border Thickness | 1 |
Determines the border thickness. |
BorderStyle |
Border Style | Flat |
Determines the visual style of the border. |
The switch state can be communicated not only through color or shape but also directly through text. The source code defines ON and OFF as the default text values.
| Property | EOS Turkish Equivalent | Default | Description |
|---|---|---|---|
OnStateText |
On-State Text | ON |
The text displayed when the switch is active or in the switched state. |
OffStateText |
Off-State Text | OFF |
The text displayed when the switch is in its default or inactive position. |
Technical screens can use ON / OFF, or short status labels consistent with the process terminology can be selected. It is important that operators can understand the text at a glance.
The GNAciBilgisi enumeration determines the on-screen orientation of the switch using four fixed angles. This allows the same switch appearance to be used in layouts suited to either horizontal or vertical placement.
| Technical Value | Option | Description |
|---|---|---|
Zerodegrees |
0 Degrees | Default orientation. |
Ninthydegrees |
90 Degrees | Rotates the switch appearance by 90 degrees. |
HundredEightydegrees |
180 Degrees | Rotates the switch appearance by 180 degrees. |
Twohundredseventhydegrees |
270 Degrees | Rotates the switch appearance by 270 degrees. |
The SBKenarSekli enumeration determines how the visual frame surrounding the switch is drawn. These options can be used particularly to enhance the panel appearance and make the switch boundaries more distinct on the screen.
| Technical Value | Option |
|---|---|
None |
None |
Raisedouter |
Raised Outer |
Raisedinner |
Raised Inner |
Raised |
Raised |
Sunkenouter |
Sunken Outer |
Sunkeninner |
Sunken Inner |
Sunken |
Sunken |
Roundedsides |
Rounded Sides |
Etched |
Etched |
Bump |
Bump |
Adjust |
Adjust |
Flat |
Flat |
Authorization for SWITCH_BUTTON is not merely an interface detail. Since it is a user control that sends commands to a controller, it must be clearly defined which users are permitted to perform which operational actions. The default AuthorizationLevel value in the source code is specified as Monitor.
The presence of a command-sending control on a screen must not imply that every user can execute that command. Authorization levels for controlling critical equipment such as pumps, valves, motors, circuit breakers, generators, and similar components must be considered as part of the project's security approach.
| Technical Value | Option | Meaning |
|---|---|---|
None |
No Authorization | A level at which command execution is not authorized. |
Monitor |
Monitoring | Monitoring-level access. |
Operation |
Operation | The authorization level used for operational actions. |
Engineering |
Engineering | The authorization level used for engineering operations. |
Superuser |
Superuser | The highest authorization level. |
On a screen where a motor command is represented by a two-state switch, an LED or Rocker appearance can be used. SwitchedColor can distinguish the active state from the default state using DefaultColor; the state can also be displayed using OnStateText / OffStateText.
A Lever or Toggle appearance can be selected for pump control so that the operator perceives the command as a physical lever or toggle switch. The selected visual appearance must be distinguished from the actual pump feedback state.
The Panel appearance can be used to present two-state commands, such as those for circuit breakers, disconnectors, or permissives, within a compact control-panel design. For critical operations, AuthorizationLevel must always be evaluated together with the project's authorization structure.
| Topic | Source Code | Turkish Equivalent | Default |
|---|---|---|---|
| Control | UCType |
Control Type | SWITCH_BUTTON |
| Switch Type | ButtonType |
Button Type | Switchled / LED Switch |
| Rotation | Rotation |
Rotation | 0 Degrees |
| Default Color | DefaultColor |
Default Color | Red |
| Switched Color | SwitchedColor |
Switched Color | Lime |
| Cursor | CursorColor |
Cursor Color | Silver |
| Button | ButtonColor |
Button Color | Gold |
| On State | OnStateText |
On-State Text | ON |
| Off State | OffStateText |
Off-State Text | OFF |
| Authorization | AuthorizationLevel |
Authorization Level | Monitor |
SWITCH_BUTTON provides significant flexibility in SCADA screen design by presenting a single command control through six different visual switch styles. The Toggle, LED, Lever, Rocker, Rotary, and Panel types each evoke a different kind of physical control for the operator.
Color, state text, cursor thickness, rotation angle, and border options allow the control's visual character to be configured in detail, while AuthorizationLevel enables command permissions to be controlled. The most important point is that this control is not merely a visual indicator; it is a user control that sends commands to a controller. Therefore, data connections, command meaning, and authorization must be considered as carefully as the visual design.
When the right switch appearance + a clear state indicator + an appropriate authorization level + a verified command connection are considered together, SWITCH_BUTTON can serve as a powerful and intuitive SCADA interface element for operator controls.