ayatec logo
Home Store Blog Contact
unicontrol user guide by ayatec
Home Store Blog Contact

Topics

  1. Welcome
  2. Getting started
    1. What is unicontrol
    2. How it works
    3. Connectivity
    4. Integration options
    5. Basic I/O
    6. Special I/O
    7. Special inputs - Digital sensors
    8. Special outputs - RGB driver
    9. Special outputs - Audio driver
    10. Network API - HTTP
    11. Network API - MQTT
    12. Network security
    13. Downloads
  3. Web Interface
    1. Processes
      1. Process
      2. Name
      3. Main state
      4. Initial state
      5. Display
      6. Constraints
        1. Process timer
        2. Variable contraints
        3. Force output
      7. Input
        1. Input source
        2. Channel
        3. Control period
        4. Value
        5. Publish
        6. Frequency
        7. Subtopic
      8. Events
        1. On/Off event
        2. Condition
        3. Idle/running time
        4. Delay on/off
        5. Fade in/out
        6. High/low input
        7. Mid point/Tolerance
        8. Out on when
      9. Output
        1. Primary output
        2. Action
        3. Type
        4. Invert
        5. Duty cycle
        6. Mem value
        7. High/low output
        8. Folder/Track
        9. RGB mode
        10. RGB color
        11. RGB brightness
        12. RGB speed
        13. Publish
        14. Subtopic
        15. Secondary outputs
      10. Cycle
        1. Cycles
        2. High/Low phase
      11. On/Off button
    2. Peripheral
      1. Hardware
      2. Type
      3. Calibration
      4. Mapping (edit)
      5. IR remote (edit)
      6. Impulse_counter (edit)
      7. RGB driver (edit)
      8. DS18B20 (edit)
    3. Device
    4. Network
    5. System
    6. License
  4. Tutorials
    1. First boot
    2. First process
    3. Connect to MQTT
    4. Process sequencing
    5. DIY Project: Bath Fan

In this article

  • Introduction
advert
unicontrol > Web interface > Processes > Events > Condition

Condition

Defines the Condition for the On event (inval1) or the Off event (inval2), the satisfaction of which will trigger an output action. The interface consists of several elements:

  • Operator - defines the expected relation between the primary Input reading and the test value. If the reading is analogue, then the operator signifies inequality and can be changed by clicking on it in the interface. The default operator is < (less) and corresponds to [VALUE] = 0, while [VALUE] = 1 represents > (greater). If the reading is logical then the operator automatically changes to = (the choice of operator then has no effect).
  • Test value - threshold for the inequality or the expected value for the equality. Any [VALUE] between -9999 and +9999* can be provided.
    • * When the provided value is between -999.9 and +999.9, one decimal digit can be added to the integer part. The decimal part is automatically truncated if the value is outside of this range.
  • Unit - represents the measurement unit, either defined by the user or implied from the input choice, and is for informational purposes only as it does not affect the process in any way.

Two independent Conditions can be defined, one for switching the output ON and another for switching the output OFF:

Condition for switching the output on.
Condition for switching the output off.

A Control period, Delays, and Faders* apply.

* The Fader is only applicable to the PWM Type of output.
Properly defining a Control period can be crucial to prevent output's volatile behaviour when the readings are fluctuating.

HTTP

The device will accept HTTP requests at the following URLs related to:

  • Condition on threshold:

(POST) http://[IPv4]/var_set?param=inval1_[PROCESS ID]&val=[VALUE]
(GET) http://[IPv4]/var_request?param=inval1_[PROCESS ID]

  • Condition on operator:

(POST) http://[IPv4]/var_set?param=oncdsgn_[PROCESS ID]&val=[VALUE]
(GET) http://[IPv4]/var_request?param=oncdsgn_[PROCESS ID]

  • Condition off threshold:

(POST) http://[IPv4]/var_set?param=inval2_[PROCESS ID]&val=[VALUE]
(GET) http://[IPv4]/var_request?param=inval2_[PROCESS ID]

  • Condition off operator:

(POST) http://[IPv4]/var_set?param=offcdsgn_[PROCESS ID]&val=[VALUE]
(GET) http://[IPv4]/var_request?param=offcdsgn_[PROCESS ID]

A combination of:

POST: http://192.168.1.255/var_set?param=inval2_3&val=21
POST: http://192.168.1.255/var_set?param=offcdsgn_3&val=1

will cause the heater on Process #3 to turn off if the temperature reading surpasses 21°C.

Learn more in HTTP API.

Variables inval1 and inval2 are shared with the High/Low input and the Deadband Mid point and Tolerance.

MQTT

This parameter can also be accessed via MQTT using [PARAMETER] = inval1, inval2, oncdsgn and offcdsgn. Learn more in MQTT API.

Following two messages:

Topic: johndoe5896/home/garagedoor/sub/process_3/inval2
Payload: 21

Topic: johndoe5896/home/garagedoor/sub/process_3/offcdsgn
Payload: 1

will cause the Process #3 to turn off the heater attached to it if the temperature reading surpasses 21°C.

Example

The following example process will behave as a standard thermostat. The output will be turned ON once the temperature falls below 21°C and turned OFF when the reading rises above 22°C. Condition satisfaction of which will result into an output action. The interface consists of several elements:

© 2024 ayatec.eu • Found a mistake?  Let us know!