Skip to content

Web UI

Jump to bottom
Gargano edited this page Nov 13, 2024 · 52 revisions

Pages

Home

Status

image

Background color for valve number :

Color Description
ligthgray disabled in config
green all ok
yellow mode=off
red error (tsValue or DS18 failed)

Background color for valve state :

Color Description
darkgray all ok
yellow one calibration blocked, but the following calibration was ok.
red calibration blocked or failed.

Network

Config

Configuration page of VdMot Controller
Here you can configure network settings, the control protocol, valve names and their temperature linkage, motor relevant parameters, calibration options and more.
Also you can restart the system and clear flash memory.

image

Network

Protocol

image

Please see MQTT description for further details

  • Data protocol - none | MQTT | MQTT HA

  • Broker IP - IP of the mqtt broker . In iobroker setup select server/broker

  • Broker Port - Port of the mqtt broker

  • User name - If there is a user name defined in the broker

  • Password - password of the user

  • re-type password - please re-type the password to confirm.

  • Interval - polling interval in ms (default 1000). This polls the mqtt connection for events coming from broker

  • Publish Interval - if Publish on change is not checked, it defines the publish interval of all values in seconds (default 10), otherwise it defines the time out to publish the values even the values are not changed.

  • Publish on change - publish values if changed or time out (defined in Publish interval, individually for each valve and temperature sensor)

  • Min. time for next publish - Minimum time (in seconds) the system wait for the next publishing values, individually for each valve and temperature sensor

  • Keep alive time - After this time the connection will be closed if there is no traffic

  • Publish - Flags for publishing

    • Retained - publish values with retained flag
    • Plaintext - publish values as plaintext instead of a numeric value
    • Strict separate topics - publish values separated for read and write. Recommended for Home Assist to set on.
      If activated then only write topics are accepted with '/set' added. E.g. (Station name).common.heatControl/set. These topics are not published by VDMot.
      If not set, write topics are accepted with and without '/set'
      For iobroker : if 'Strict separate topics' is set then also the function 'different names for topics' must be set in the instance.
      For home assistance : for write topics it is mandatory to add the '/set' to the topic
    • All Temps - publish all temperature values, even the sensors are linked to a valve
    • Path as root - if checked, a slash will be prefixed to the mqtt path
    • Up time- publish the system uptime. Please note that if it is checked more network traffic will occur.
    • Diag- publish the motor diagnostics as counts, moves, mean current.

  • DS18 - Time out for DS16 sensors (fixed 5 minutes)

  • Time out tsValue - If there is no tValue received via mqtt after this time the corresponding valve goes to the defined position
    Caution : If this option is activated it is absolutely mandatory to ensure that the tValue is received within the time frame. Publish on change on server side is not recommended with this option

  • Time out (min) - Time out in minutes for receiving tValue

  • Time out target position - Position the valve will goes to

Valves

  • No - Number of valve as it written on the PCB. Green background if a valve is connected.
  • Name - Here you can give the valve a speaking name.
  • Active - if unchecked , the valve is disabled and no control of the valve is possible.
  • TIdx1 - Choose the number of the 1-wire temperature sensor which should be linked to the valve as first linked sensor.
  • TIdx2 - Choose the number of the 1-wire temperature sensor which should be linked to the valve as second linked sensor.

Motor

  • Next Calibration
    • Movements - After choosen movements, a valve is newly calibrated by the controller. Every valve has it's own counter.
    • Hour time - Choose the hour time, when all valves are newly calibrated by the controller.
    • Days - Choose the days, when all valves should be newly calibrated by the controller.
  • Characteristic

image

  • Open - Detection threshold for end stop when opening. Calculates as follows: Low Value x Mean Current of valve = Threshold. E.g.: 2,0 * 21 mA = 42 mA threshold for detecting the endpoint when closing.
  • Close - Detection threshold for end stop when closing. Calculates as above value.
  • Start % - Set point of valves after startup of controller and initial calibration of the valves, even without external control signals.
  • Min. Count - Minimum count for detecting blocked valves.
  • Max. Calib. Repetitions - If a blocked valve is detected (detected count less than min. count), then the controller starts calibration repetitions. If the repetitions exceeds the max. number of repetitions , then the valve is marked as blocked. (0 : means no repetition)

Temperature sensor

The temperature sensors are DS18B20 1-Wire sensor connected to the 1-wire interface.

  • Name name of the sensor
  • Active activate the sensor
  • Offset offset of the temperature
  • ID select the sensor

Voltage sensors

The voltage sensors are DS2438 1-Wire sensor connected to the 1-wire interface.

  • Name name of the sensor
  • Active activate the sensor
  • Offset offset of the voltage
  • Factor factor of the voltage
  • Unit Unit
  • ID select the sensor

Example for offset and factor: Pressure sensor with 0..5 bar and a voltage of 0.5 .. 4.5 V

Offset = -0.5, so the voltage range is 4V equal to 5 bar Factor = 1.25 0.5 V => 0 bar 4.5 V => 5 bar

Messenger

image

  • Activate the reason to send a message
    • Valve failed (motor reached time out. Eventually is dropped off)
    • Valve blocked (number of count is less than the defined min. count in config)
    • Active valve not detected
    • Reset detected
      • PANIC : Software reset due to exception/panic
      • INT_WDT : Reset (software or hardware) due to interrupt watchdog
      • TASK_WDT : Reset due to task watchdog
      • WDT : Reset due to other watchdogs
      • BROWNOUT : Brownout reset (software or hardware)
    • MQTT failed after defined minutes
    • tValue failed
    • DS18 failed If a DS18 Sensor failed (fix Timeout 5 minutes)

Files

System

Control

Control page

image

  • No - Number of valve as it written on the PCB. Green background if a valve is connected.

  • Name - Here you can give the valve a speaking name.

  • Active - Set the valve to be controlled

  • Allow - Possible selection Heat/Cool, Heat, Cool . If Heat Control is set to On/Heating and the valve is allowed to Heat/Cool or Heat, then the pi-controller controls the valve with the parameters, otherwise the valve is set to the min value of active zone.

    Heat-Control Allow Valve
    On/Heating Heat/Cool Control
    On/Heating Heat Control
    On/Heating Cool go low active zone
    On/Cooling Heat/Cool Control
    On/Cooling Heat go low active zone
    On/Cooling Cool Control

  • Link - Link valves together if there are several heat circuits in one room.

  • Value - Source of values

  • Target - Source of targets

  • XP - Proportional band of the pi-controller kp = 100/xp

  • Offset - Enter an offset of the valve , this value will be added to the calculated one.

  • Ti - Integral part of the pi - control algorithm (in seconds)

  • Ts - Sampling time in seconds. This is the time the next calulation will be executed.

  • Scheme - Type of pi - calculation : dynamic ki the integral part is calculated with the difference of value and target / static ki the integral part is always static

  • ki - Integral part of the pi-controller (only used , if Scheme is selected static ki

  • Active Zone - Define the active zone of the valve. (closed|opened)

  • Window - Activate window handling. if active in mqtt exists two more objects : state and target (%). image

    • state = 0 : window is closed. If the window was open, then the controller returns to the previous state. The icon in the status page shows the closed window.
    • state = 1 : window is open. The valve will go to the target value. No further automatic control. The icon in the status page shows the open window.

  • Heat Control - Possible selection : Manual | On/Heating | On/Cooling | Off/Park Position.

    • Manual : The pi-controller is off, you can set the valves in the status page
    • On/Heating : The pi-controller is on, a positive difference of target-values opens the valves
    • On/Cooling : The pi-controller is on, a negative difference of target-values opens the valves
    • Off/Park Position : The pi-controller is on, but doesn't control. The valves are set to the park position

  • Save control settings - Saves the settings without reboot.

Update

About

Clone this wiki locally