Rules

The Rules Module allows you to:

  • Create rules for device points using node-based editors.
  • Save an unlimited number of rules individually for later editing.

layout

To access the Device Module:

  • Click on the Rules icon on the main menu.
  • Click on the Menu icon on the top left to view the browser menu.
  • Alternatively, click on (>) to Expand or (<) Collapse the browser menu.
  • The browser menu lists all created rules under Rules tab and all available points of device in the Object browser tab.

Rules

Creating a New Rule

  1. Click on the Create New Rule button located in the Rules browser pane. layout

  2. Enter the name of the rule in the Name field at the top left corner of the canvas.

  3. Drag and drop the desired device points from the object browser pane to the canvas.

  4. Drag and drop the required blocks from the blocks pane at the right side of page to the canvas.

  5. Make the necessary connections between the blocks to complete the rule.

  6. Click the Save icon to save the rule.

Canvas Options

  • layout
OptionDescription
Zoom InZooms in on the canvas.
Zoom OutZooms out from the canvas.
Fit ViewFits all nodes within the canvas to the screen.
Toggle InteractivityLocks the position of the nodes.
  • layout
FeatureDescription
Save RulesSaves the current rule.
Save As RuleCreates a duplicate of the current rule configuration with a new name, allowing modifications without altering the original rule.
Clear All NodesDeletes all nodes from the canvas.
Export RulesAllows users to download and save all configured rules in a standardized file format (e.g., JSON or CSV) for backup, sharing, or transfer to another system.
Save Logic as Custom BlockSaves a group of connected logic blocks as a reusable custom block, allowing you to quickly reuse complex logic in other rules without rebuilding it from scratch.

Open Libaray

When you click the “+” icon, it will open the library containing all the blocks.

##Math Block

  • layout
FunctionDescription
Add2Adds two numbers together and returns the result.
Sub2Subtracts the second number from the first number and returns the result.
Mul2Multiplies two numbers together and returns the product.
DivDivides the first number by the second number and returns the quotient (second number must not be zero).
Add4Adds four numbers together and returns the result.
Avg10Calculates and returns the average of ten numbers.
AvgCalculates and returns the average of a list of numbers.
FloatOffsetApplies a specified float offset to a number and returns the adjusted value.
MinFinds and returns the minimum value in a list of numbers.
MaxFinds and returns the maximum value in a list of numbers.
Mul4Multiplies four numbers together and returns the product.
NegNegates a number by multiplying it by -1 and returns the result.
Sub4Subtracts four numbers sequentially from the first number and returns the result.
AbsReturns the absolute value of the input number
``

Logic Blocks

  • layout
FunctionDescription
Greater ThanCompares two numbers and returns TRUE if the first number is greater than the second, otherwise returns FALSE.
Less ThanCompares two numbers and returns TRUE if the first number is less than the second, otherwise returns FALSE.
Equal ToCompares two numbers and returns TRUE if both numbers are equal, otherwise returns FALSE.
AND2Performs a logical AND operation on two inputs and returns the result.
OR2Performs a logical OR operation on two inputs and returns the result.
XORPerforms a logical XOR (exclusive OR) operation on two inputs and returns the result.
NOTPerforms a logical NOT operation on an input and returns the result.
AND4Performs a logical AND operation on four inputs and returns the result.
OR4Performs a logical OR operation on four inputs and returns the result.
ADEMUX2Demultiplexes a single input to two outputs based on a control signal.
ASWSwitches an analog signal based on a control input and returns the switched signal.
ASW4Switches four analog signals based on control inputs and returns the switched signals.
B2PConverts a binary signal to a parallel format and returns the parallel signal.
BSWSwitches a binary signal based on a control input and returns the switched signal.
Logic MatrixEvaluates multiple logical conditions using a matrix configuration and produces outputs based on the defined logic combinations.
HysteresisIntroduces upper and lower threshold limits to prevent frequent switching when the input value fluctuates near a boundary.

Function Blocks

The Function Blocks library provides advanced processing and control functions that enable users to implement automation logic, scheduling, notifications, data processing, and device control. These blocks are commonly used to build intelligent workflows and automate system operations.

layout

FunctionDescription
PIDImplements a Proportional–Integral–Derivative (PID) controller to maintain a process variable at a desired setpoint. Commonly used in HVAC, temperature, pressure, and flow control applications.
CompareCompares two input values and returns the comparison result, such as Equal, Greater Than, or Less Than. This block is commonly used for conditional decision-making within automation rules.
CountIncrements or decrements a counter based on input signals and returns the current count. It is useful for counting events, pulses, production cycles, or equipment operations.
LimiterRestricts an input value within configured minimum and maximum limits. This block helps prevent values from exceeding safe operating ranges.
RampGradually increases or decreases an output value at a configured rate instead of changing instantly. It is commonly used for smooth equipment start-up and shutdown operations.
SRLatchImplements a Set-Reset latch that maintains its output state until a reset signal is received. This block is commonly used for start/stop logic and maintaining equipment status.
EngCompCalculates energy consumption using connected meter readings. This block is commonly used for energy monitoring, reporting, and consumption analysis.
SchedulerControls the execution of connected blocks based on configured dates, days, and time schedules. It is useful for automating equipment operation according to predefined schedules.
DelayDelays the execution or transmission of signals by a specified duration. This block helps prevent immediate responses and is useful for sequencing operations.
RunHoursCalculates the total operating time of equipment based on its running status. This information is commonly used for preventive maintenance and runtime analysis.
Concatenate StringCombines two or more text strings into a single output. It is commonly used for generating messages, labels, or dynamic text values.
CoV NotifierSends a notification whenever a Change of Value (CoV) occurs on the monitored point. This block helps notify users when significant value changes are detected.
SMS NotifierSends SMS notifications when configured conditions or events occur. It is commonly used for alarm notifications and critical event reporting.
Empty StringGenerates an empty text value that can be used as a placeholder or default string within automation logic.
Custom ScriptAllows users to write and execute custom scripts for implementing advanced calculations, processing logic, or custom automation that cannot be achieved using standard blocks.
Rotational Load SequencerRotates multiple connected loads according to a configured sequence to balance equipment runtime and distribute wear evenly across devices. This block is commonly used for pumps, fans, compressors, and similar equipment.

PID Block


layout

The PID (Proportional–Integral–Derivative) block is used to automatically control a process variable by comparing the measured value with a configured setpoint and generating an appropriate output. It is commonly used for temperature, pressure, flow, and other control applications.

Adding the PID Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the PID block onto the canvas.

  5. Right-click the PID block to open the configuration window.

  6. Configure the required parameters (KP, KI, KD, MIN, and MAX). Enable Reverse PID if required.

  7. Click Save to apply the configuration.


PID Connections

ConnectionDescription
ONEnables or disables the PID controller.
SPSpecifies the desired setpoint value.
PVRepresents the measured process value.
OutputReturns the calculated control output.

Configuring the PID Block

Double-click the PID block to open the configuration window.

layout

ParameterDescription
KPSets the proportional gain.
KISets the integral gain.
KDSets the derivative gain.
MINDefines the minimum output value.
MAXDefines the maximum output value.
Reverse PIDEnables reverse control action when required.

Click Save to apply the configuration.


TickTock Block

The TickTock block generates periodic output signals based on the configured time interval. It is commonly used to create repeating events, periodic triggers, and timed control operations within a rule.

layout

Adding the TickTock Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the TickTock block onto the canvas.

  5. Connect the ON/OFF input to the required control point and connect the output to the destination point or block.

  6. Right-click the TickTock block to open the TickTock Configuration window.

  7. Configure the required parameters and click Save.


TickTock Connections

ConnectionDescription
ON/OFFEnables or disables the TickTock block.
OutputGenerates periodic output signals based on the configured timing values.

Configuring the TickTock Block

Double-click or right-click the TickTock block to open the configuration window.

layout

ParameterDescription
Tick Interval (In Seconds)Specifies the time interval between generated ticks.
No of Ticks Per SecondSpecifies the number of output ticks generated during each second.

Click Save to apply the configuration.


Count Block

The Count block counts events based on the configured counting direction. It can increment or decrement the count value when the input changes and is commonly used for event counting, production tracking, and monitoring equipment operations.

layout

Adding the Count Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Count block onto the canvas.

  5. Connect the required input and output points.

  6. Double-click the Count block to open the Count Configuration window.

  7. Configure the required parameters and click Save.


Count Connections

ConnectionDescription
InputReceives the signal to be counted.
OutputReturns the current count value.

Configuring the Count Block

Double-click the Count block to open the configuration window.

layout

ParameterDescription
Count DirectionSelects the counting direction. Available options are Up, Down, or Any Changes.
Reset ValueSpecifies the value to which the counter resets.
ResetEnables or disables the reset operation by selecting True or False.

Click Save to apply the configuration.


Limiter Block

The Limiter block restricts the output value within a configured range. If the input exceeds the configured limits, the output is automatically limited to the defined minimum or maximum value.

Adding the Limiter Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Limiter block onto the canvas.

  5. Connect the required input and output points.

  6. Double-click the Limiter block to open the Limiter Configuration window.

  7. Configure the High Limit and Low Limit values.

  8. Click Save to apply the configuration.


Limiter Connections

ConnectionDescription
InputReceives the value to be limited.
OutputReturns the value after applying the configured limits.

Configuring the Limiter Block

Double-click the Limiter block to open the configuration window.

layout

ParameterDescription
High LimitSpecifies the maximum value allowed at the output. Any input above this value is limited to the High Limit.
Low LimitSpecifies the minimum value allowed at the output. Any input below this value is limited to the Low Limit.

Click Save to apply the configuration.


Ramp Block

The Ramp block gradually increases or decreases the output value between the configured minimum and maximum values over a specified period. It is commonly used to provide smooth transitions and prevent sudden changes in control signals.

Adding the Ramp Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Ramp block onto the canvas.

  5. Connect the required input and output points.

  6. Double-click the Ramp block to open the Ramp Configuration window.

  7. Configure the required parameters.

  8. Click Save to apply the configuration.


Ramp Connections

ConnectionDescription
InputReceives the value to be ramped.
OutputReturns the gradually changing output value.

Configuring the Ramp Block

Double-click the Ramp block to open the configuration window.

layout

ParameterDescription
Minimum ValueSpecifies the lowest output value of the ramp.
Maximum ValueSpecifies the highest output value of the ramp.
Ramp PeriodDefines the time taken for the output to change from the minimum value to the maximum value.
StepSpecifies the increment or decrement applied to the output during each ramp interval.

Click Save to apply the configuration.


SRLatch Block

The SRLatch block is used to maintain an output state until it is reset. It is commonly used for start/stop control, equipment latching, and maintaining the status of a device.

Adding the SRLatch Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the SRLatch block onto the canvas.

  5. Connect the required input and output points.

  6. Double-click or right-click the SRLatch block to open the SRLatch Configuration window.

  7. Configure the Reset Value.

  8. Click Save to apply the configuration.


SRLatch Connections

ConnectionDescription
Set (S)Sets the output to the active state.
Reset (R)Resets the output to the configured reset value.
OutputReturns the current latched output state.

Configuring the SRLatch Block

Double-click or right-click the SRLatch block to open the configuration window.

layout

ParameterDescription
Reset ValueSpecifies the value assigned to the output when the Reset input is activated.

Click Save to apply the configuration.


SRLatch Logic

The SRLatch block stores the output state when the Set input is activated. The output remains in the latched state until the Reset input is triggered, at which point the output changes to the configured Reset Value.


Energy Consumption Block

The Energy Consumption block calculates and displays energy consumption over a selected time interval. It is commonly used for monitoring and analyzing energy usage on an hourly, daily, weekly, monthly, or yearly basis.

Adding the Energy Consumption Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Energy Consumption block onto the canvas.

  5. Connect the required input and output points.

  6. Right-click the Energy Consumption block to open the Energy Consumption Configuration window.

  7. Select the required calculation interval.

  8. Click Save to apply the configuration.


Energy Consumption Connections

ConnectionDescription
InputReceives the energy meter or consumption value.
OutputReturns the calculated energy consumption for the selected interval.

Configuring the Energy Consumption Block

Right-click the Energy Consumption block to open the configuration window.

layout

ParameterDescription
HourlyCalculates energy consumption for every hour.
DailyCalculates energy consumption for each day.
WeeklyCalculates energy consumption for each week.
MonthlyCalculates energy consumption for each month.
YearlyCalculates energy consumption for each year.

Click Save to apply the configuration.


Delay Block

The Delay block postpones the execution of an output signal by a specified duration. It is commonly used to introduce a time delay before triggering the next operation in a rule.

Adding the Delay Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Delay block onto the canvas.

  5. Connect the required input and output points.

  6. Right-click the Delay block to open the Delay Configuration window.

  7. Configure the required delay duration.

  8. Click Save to apply the configuration.


Delay Connections

ConnectionDescription
InputReceives the signal to be delayed.
OutputReturns the input signal after the configured delay period.

Configuring the Delay Block

Right-click the Delay block to open the configuration window.

layout

ParameterDescription
HoursSpecifies the delay duration in hours.
MinutesSpecifies the delay duration in minutes.
SecondsSpecifies the delay duration in seconds.

Click Save to apply the configuration.


Custom Script Editor

The Custom Script Editor block allows users to write and execute custom scripts for implementing advanced automation logic, calculations, and data processing that cannot be achieved using standard function blocks.

Adding the Custom Script Editor

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Custom Script Editor block onto the canvas.

  5. Connect the required input and output points.

  6. Double-click or right-click the Custom Script Editor block to open the script editor.

  7. Write or modify the required script.

  8. Click Save to apply the script.


Custom Script Editor Connections

ConnectionDescription
InputReceives values that are used within the custom script.
OutputReturns the value calculated or processed by the script.

Using the Custom Script Editor

Double-click or right-click the Custom Script Editor block to open the script editor.

layout

The editor allows you to write and modify custom logic according to your application requirements.

Click Save to apply the script.


RLS Block

The RLS (Rotational Load Sequencing) block is used to control and sequence multiple loads efficiently. It helps distribute operating time among connected loads and supports automatic or manual sequencing.

Adding the RLS Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the RLS block onto the canvas.

  5. Connect the required input and output points.

  6. Right-click the RLS block to open the RLS Configuration window.

  7. Configure the required parameters.

  8. Click Save to apply the configuration.


RLS Connections

ConnectionDescription
InputReceives the control signal for load sequencing.
OutputControls the connected loads based on the configured sequence.

Configuring the RLS Block

Right-click the RLS block to open the configuration window.

layout

ParameterDescription
No of LoadsSpecifies the total number of loads to be controlled.
SequenceDefines the order in which the loads operate.
Minimum LoadSpecifies the minimum number of loads that must remain active.
Manual SequenceEnables manual sequencing of loads when the checkbox is selected.
Start DelaySpecifies the delay before starting the next load.
Stop DelaySpecifies the delay before stopping a load.
Feedback DelaySpecifies the waiting time for load feedback before proceeding to the next operation.

Click Save to apply the configuration.


Alarm Block

The Alarm block is used to generate alarms when configured conditions are met. It allows users to define an alarm message, configure the notification interval, and assign a priority level for the alarm.

Adding the Alarm Block

  1. Open the Rules module.

  2. Create a new rule or open an existing rule.

  3. Click the + icon and open the Function category.

  4. Drag and drop the Alarm block onto the canvas.

  5. Connect the required input and output points.

  6. Right-click the Alarm block to open the Alarm Configuration window.

  7. Configure the required parameters.

  8. Click Save to apply the configuration.


Alarm Connections

ConnectionDescription
InputReceives the signal or condition used to trigger the alarm.
OutputGenerates the configured alarm when the trigger condition is satisfied.

Configuring the Alarm Block

Right-click the Alarm block to open the configuration window.

layout

ParameterDescription
MessageSpecifies the alarm message displayed when the alarm is triggered.
IntervalSpecifies the time interval between consecutive alarm notifications.
PrioritySpecifies the priority level of the alarm. Available options are High, Medium, and Low.

Click Save to apply the configuration.


Creating and Using a Custom Block

A Custom Block allows you to save a group of connected logic blocks as a reusable block. This helps reduce development time and simplifies the creation of complex automation logic.

Creating a Custom Block

  1. Click Add New Rule to create a new rule.

  2. Build the required logic by adding and connecting the necessary blocks on the canvas.

  3. Select the group of connected logic blocks that you want to reuse.

  4. Click Save Logic as Custom Block.

    layout

  5. Enter a Name for the custom block.

  6. Click Save.

  7. Open the Custom Blocks library.

  8. The saved custom block appears in the library with the specified name.

  9. Drag and drop the custom block onto the canvas whenever it is required.

    layout


Configuring the Custom Block

Right-click the Custom Block on the canvas to open the configuration window.

ParameterDescription
LabelSpecifies the display name for the custom block parameter.
ValueSpecifies the value assigned to the corresponding label.

Click Save to apply the configuration.


Advanced

layout

Advanced FunctionDescription
PsychrometricCalculates air properties such as dry bulb temperature, wet bulb temperature, relative humidity, dew point, and enthalpy based on the provided input conditions. It is commonly used in HVAC and environmental control applications.

Delete a Rule

layout

To delete an existing rule:

  1. Open the Rules module.

  2. Select the rule you want to delete from the Rules browser.

  3. Click the Delete icon.

  4. A confirmation dialog will appear.

  5. Click Yes to permanently delete the selected rule.

Note: Once deleted, the rule cannot be recovered unless it has been exported previously.


Rename a Rule

layout

To rename an existing rule:

  1. Open the Rules module.

  2. Select the rule you want to rename from the Rules browser.

  3. Click the rule name or select the Rename option.

  4. Enter the new rule name.

  5. Click Save to apply the changes.


Export a Rule

layout

To export a rule:

  1. Open the Rules module.

  2. Select the rule you want to export.

  3. Click the Export Rule icon.

  4. Choose the location where you want to save the exported file.

  5. Click Save to export the rule.

Note: The exported rule can be used as a backup or shared with another system.


Import a Rule

layout

To import a previously exported rule:

  1. Open the Rules module.

  2. Click the Import Rule icon.

  3. Browse and select the exported rule file.

  4. Click Open or Import.

  5. The imported rule will be added to the Rules browser and can be edited or executed like any other rule.