WHAT IS THE SOUND USER CONTROL?

The SOUND user control is a specialized control designed to announce specific events audibly on SCADA screens without requiring the operator to be looking at the screen. In industrial HMI/SCADA systems, audible notifications can complement visual information; modern industrial applications can also deliver alarm notifications through sound, text, and other channels.


What makes SOUND distinctive: This control is not limited to simply playing an alarm sound. The GNSesliAlarmTuru enumeration in the source code defines different triggering modes within a single control, including hourly alerts, multiple scheduled times, data levels, and the call to prayer.

SUPPORTED AUDIBLE ALARM TYPES

The most important feature of the SOUND control is its support for the following eight alarm types. Each type corresponds to a different operational scenario.

AUDIBLE ALARM ENGINE

ALARM / ANNOUNCEMENT ACTIVE
Time • Value • Call to Prayer

AUDIO OUTPUT · READY

SPOKEN INFORMATION

PRE-ANNOUNCEMENT Production
LIVE VALUE 100
POST-ANNOUNCEMENT MW
EXAMPLE OF A SPOKEN ANNOUNCEMENT “Production 100 MW”
01 • TIME

Hourly Alarm

This is the Hourlyalarm option. It is used to create a regular, time-based audible notification scenario. It can provide the operator with an audible time signal at specified hourly intervals.

02 • CALL TO PRAYER

Call to Prayer

This is the Calltoprayer option. It supports location-based prayer times through settings such as latitude, longitude, prayer calculation type, prayer calculation convention, and calculation method.

03 • ONE TIME

Single-Time Alarm

This is the Singlehouralarm option. It creates an audible alarm or announcement for a single hour-and-minute point during the day.

04 • TWO TIMES

Two-Time Alarm

This is the Doublehouralarm option. Two different hour-and-minute points can be defined to create a two-time audible alarm scenario.

05 • THREE TIMES

Three-Time Alarm

This is the Triplehouralarm option. Audible alarms or announcements can be scheduled for three different hour-and-minute points.

06 • ONE LEVEL

Single-Level Warning

This is the Singlelevelwarning option. It evaluates a connected SCADA data point against a specified level and generates an audible warning when the condition is met.

07 • TWO LEVELS

Two-Level Warning

This is the Doublelevelwarning option. It is used to create different or graduated audible warning scenarios based on two separate value levels.

08 • THREE LEVELS

Three-Level Warning

This is the Triplelevelwarning option. Its three-threshold structure, using values such as MinValue, MedValue, and MaxValue, allows audible warnings to be issued at different process-value levels.

AUDIBLE WARNINGS BASED ON DATA VALUES

One of the strengths of the SOUND control is its ability to convert a SCADA data value into a spoken sentence in the format pre-announcement + data value + post-announcement, rather than merely displaying the value numerically.

1. DATASelect a SCADA data point.
2. THRESHOLDSpecify the value level.
3. PRE-ANNOUNCEMENTDefine the initial text.
4. VALUEThe numeric value is spoken.
5. POST-ANNOUNCEMENTThe final text is spoken.
Pre-announcement: “Production”  +  100  +  Post-announcement: “MW”
→ “Production 100 MW”
MinValueLow level
MedValueMedium level
MaxValueHigh level

Example: Suppose the production value is the SCADA data point connected to the control. When FirstPreAnnouncement = "Production", FirstEndAnnouncement = "MW", and the data value is 100, the spoken output is logically constructed as “Production 100 MW”. The corresponding pre-announcement and post-announcement fields can also be used for the second and third levels.

TIME-BASED ALARMS AND ANNOUNCEMENTS

For time-based alarm types, the SOUND control uses hour and minute fields to generate automatic audible notifications at specified times of day.

ALARM TYPE TIME SETTINGS USED PURPOSE
Single-Time Alarm First Alarm Hour + First Alarm Minute Audible alarm/announcement at one time point
Two-Time Alarm First + Second hour/minute Audible alarm/announcement at two time points
Three-Time Alarm First + Second + Third hour/minute Audible alarm/announcement at three time points

The default times defined in the source code are 00:00, 08:00, and 16:00.

CALL TO PRAYER SUPPORT — LOCATION AND CALCULATION SETTINGS

The Call to Prayer mode is one of the most distinctive features that sets the SOUND control apart from a conventional time alarm. The source code defines three separate prayer-time settings alongside latitude and longitude. External sources also calculate prayer times using location coordinates and a selected calculation method.

SETTING ENUMERATION OPTIONS DESCRIPTION
Prayer Calculation Type Jafari, Karachi, Isna, Mwl, Makkah, Egypt, Custom, Tehran Selects the method used to calculate prayer times.
Prayer Calculation Convention Shafii, Hanafi Two jurisprudential calculation approaches are defined in the source code; similar prayer-time calculation libraries include a school-of-law setting that affects the Asr calculation.
Prayer Calculation Method None, Midnight, One-Seventh, Angle-Based These are the options defined in the source code. The names on this page follow the source code; the relevant implementation code is required to determine the exact algorithm used within EOS.

LOCATION

Latitude
39.912345

Longitude
32.827058

Location information is also a fundamental input for determining prayer times in calculation models provided by external sources.

Important: Different prayer-time calculation methods may produce different times for the same location. For example, MWL, ISNA, Egypt, Makkah, Karachi, Tehran, and Jafari methods use different astronomical parameters. Therefore, the selected method, convention, and location settings in the SOUND control must be considered together.

GENERAL PROPERTIES AND SETTINGS

The following tables are based on the properties specified in the source code, their equivalents in the Türkçe_set2(2) dictionary, and their default values.

PROPERTY EOS ENGLISH EQUIVALENT DEFAULT DESCRIPTION
UCType Control Type SES Defines the type of the user control.
UpdateInterval Update Interval 1000 Specifies the control's update interval.
DecimalPoint Decimal Places 0 Specifies the number of decimal places used when speaking or displaying numeric values.
UCBackColor Control Background Color Transparent Specifies the control's background color.
UCForeColor Control Text Color Black Specifies the control's primary text color.
UCFont Control Font Arial Narrow, 8.25 pt Specifies the control's font.
AlarmType Alarm Type Hourlyalarm Determines which audible alarm or announcement mode the SOUND control uses.
HideControl Hide Control false Specifies whether the control is hidden.
AlarmActive Alarm Active false Specifies whether the audible alarm behavior is enabled.

THRESHOLD AND AUDIBLE WARNING SETTINGS

PROPERTY EOS ENGLISH EQUIVALENT DEFAULT DESCRIPTION
MinValue Minimum Value 50 Provides the lower value or threshold input for a multi-level warning scenario.
MedValue Medium Value 100 Provides the intermediate value or threshold input for a multi-level warning scenario.
MaxValue Maximum Value 150 Provides the upper value or threshold input for a multi-level warning scenario.

Three-level operation: Using MinValue, MedValue, and MaxValue together provides a structure for evaluating a process value at three different levels. Since the source code does not specify the exact comparison operators used for these fields, only the threshold structure is described here.

ANNOUNCEMENT AND SPOKEN MESSAGE TEXT

To make audible warnings understandable, separate pre-announcement and post-announcement fields are defined for each alarm level.

PROPERTY EOS ENGLISH EQUIVALENT DEFAULT ROLE
FirstPreAnnouncement First Announcement Pre-Announcement "" Text spoken before the data value for the first level or first announcement.
FirstEndAnnouncement First Announcement Post-Announcement "" Text spoken after the data value.
SecondPreAnnouncement Second Announcement Pre-Announcement "" Pre-announcement text for the second level.
SecondEndAnnouncement Second Announcement Post-Announcement "" Post-announcement text for the second level.
ThirdPreAnnouncement Third Announcement Pre-Announcement "" Pre-announcement text for the third level.
ThirdEndAnnouncement Third Announcement Post-Announcement "" Post-announcement text for the third level.
CustomAnnouncement Custom Announcement "" Text field defined in the source code for custom announcement content.

GNSesliAlarmTuru — ENUMERATION

The GNSesliAlarmTuru options in the source code define the following eight operating modes.

ENUMERATION OPTION ENGLISH EQUIVALENT OPERATING MODE
Hourlyalarm Hourly Alarm Regular time-based audible notification.
Calltoprayer Call to Prayer Audible call-to-prayer scenario based on location and prayer-time settings.
Singlehouralarm Single-Time Alarm Alarm or announcement at one time point.
Doublehouralarm Two-Time Alarm Alarm or announcement at two time points.
Triplehouralarm Three-Time Alarm Alarm or announcement at three time points.
Singlelevelwarning Single-Level Warning Audible warning associated with one value level.
Doublelevelwarning Two-Level Warning Audible warning associated with two value levels.
Triplelevelwarning Three-Level Warning Audible warning associated with three value levels.

GNEzanYontemi — ENUMERATION

The prayer calculation type options in the source code largely correspond to widely used calculation methods found in external sources. For example, Pray Times and AlAdhan list methods such as MWL, ISNA, Egypt, Makkah, Karachi, Tehran, and Jafari. citeturn0search0turn0search3

OPTION DESCRIPTION
Jafari Jafari calculation method.
Karachi Karachi calculation method.
Isna ISNA — Islamic Society of North America method.
Mwl MWL — Muslim World League method.
Makkah Umm al-Qura / Makkah method.
Egypt Egyptian General Authority of Survey method.
Custom Custom method; defined as a custom option in the source code.
Tehran Tehran / Institute of Geophysics method.

GNEzanHukuk — ENUMERATION

OPTION ENGLISH EQUIVALENT DESCRIPTION
Shafii Shafii The jurisprudential/school-of-law option defined in the source code.
Hanafi Hanafi The jurisprudential/school-of-law option defined in the source code; this is the default value.

Prayer-time calculation documentation from external sources indicates that this type of school-of-law or jurisprudence setting can particularly affect the start time of Asr.

GNEzanAyar — ENUMERATION

OPTION ENGLISH EQUIVALENT DESCRIPTION
None None An option indicating that no additional calculation setting is applied.
Midnight Midnight A midnight-based approach.
Oneseventh One-Seventh The one-seventh approach defined in the source code.
Anglebased Angle-Based The angle-based approach defined in the source code.

Source fidelity note: The names of these four options are taken from the source code. Although external sources describe similar concepts related to high-latitude and midnight settings, the supplied source code does not show which mathematical formulas the EOS SOUND control uses to implement these options.

LOCATION SETTINGS

PROPERTY EOS ENGLISH EQUIVALENT DEFAULT DESCRIPTION
Latitude Latitude 39.912345 The latitude used for prayer-time calculations. The dictionary lists the equivalent as “Latitude”.
Longitude Longitude 32.827058 The longitude used for prayer-time calculations.

Location accuracy matters: Prayer-time calculation systems use geographic coordinates as fundamental inputs. Therefore, the Latitude/Longitude values must correspond to the actual installation location.

APPLICATION SCENARIOS

1. SPEAKING THE PRODUCTION VALUE

Connected data point: Production. FirstPreAnnouncement = "Production", FirstEndAnnouncement = "MW". When the data value is 100, the example spoken message is: “Production 100 MW”.

2. THREE-LEVEL PROCESS WARNING

Define MinValue, MedValue, and MaxValue levels for a process variable such as production, pressure, or temperature. Separate pre-announcement and post-announcement texts can be used for each level.

3. THREE SHIFTS / SCHEDULED DAILY ANNOUNCEMENTS

Select Three-Time Alarm to define three time points, such as 00:00, 08:00, and 16:00, and trigger an audible notification scenario at each time.

4. AUDIBLE NOTIFICATIONS BASED ON PRAYER TIMES

Select Calltoprayer for AlarmType, then configure the prayer calculation type, prayer calculation convention, and prayer calculation method together with Latitude/Longitude. The control can then be configured for a call-to-prayer scenario based on calculated times for the specified location.

TECHNICAL AND USAGE NOTES

  • The SOUND control complements visual alarms; it does not replace them. Combining audible notifications with visual status information is a common approach in industrial HMI/SCADA systems for attracting the operator's attention.
  • The AlarmActive property is used to manage whether audible alarm behavior is enabled.
  • HideControl manages the control's visibility on the screen and should be considered separately from the configuration of its audible behavior.
  • Too many or unnecessary audible warnings can make it difficult for operators to distinguish genuinely important alerts. Industrial alarm design emphasizes reducing nuisance alarms and helping operators focus on alarms that require action.
  • Because different prayer-time calculation methods can produce different results, location and method settings should be considered together.

WEB RESEARCH AND REFERENCES

The behavior of the SOUND control on the EOS side is described according to the supplied source code. The following external sources were used for general terminology related to prayer-time calculation methods and industrial audible alarm practices.

  • Pray Times — prayer-time calculation methods and method parameters.
  • AlAdhan — location, calculation methods, and prayer-time API approach.
  • AVEVA — examples of audible notifications and alarm management in industrial HMI/SCADA environments.

Note: External sources do not define the internal algorithm of the EOS SOUND control. EOS-specific behavior is described according to the properties and options in the source code.

SUMMARY

SOUND is one of the distinctive user controls in EOS SCADA, bringing audible awareness to SCADA screens. It supports eight operating modes: hourly alarms, single-, two-, and three-time alarms, single-, two-, and three-level warnings, and the call to prayer. In particular, the combination of a pre-announcement, live data value, and post-announcement, as in “Production 100 MW”, is a key feature that distinguishes this control from conventional fixed sound effects.

SOUND = Time + Data + Level + Announcement + Call to Prayer
A single user control combines time-based alarms, audible warnings based on data values, spoken announcements, and a location-based approach to prayer-time calculation.