irrigation.lua

-- irrigation dzVents Script
-- Martin Saidl (c) 2023 - 2025

        local version = '1.1'                   -- current version of script 
        ------------------------------------------------------------------------
        local LOGGING = false                    -- true or false LOGGING info to domoticz log.
        local NOTIFYING = true                  -- true or false to enable or disable notification
        
        -- Source devices
        local OutsideTempHum =    'Venkovní teplota a vlhkost'
        local RainMeter =           'Srážkoměr'
        
        local Switch =              'Zalévání'
        local Trigger =             'Zalévání - Start'
        
        local WaterLevel =          'Vodojem kapacita'
        
        -- Destination devices
        local Pump =                'Vodojem čerpadlo'
        local Blower =              'Vodojem dmychadlo'
        
        -- Constants
        -- Maximum time from last update in minutes
        local AliveTime =           60
        -- Regulation contants in seconds
        local AbsoluteTime =        40
        local TemperatureTime =     40
        --local RepeatCycles =        2
        
        -- Notification
        local NotificationMessagePump = 'Probíhá zalévání'
        local NotificationMessageBlower = 'Ozonifikace aktivována'


--********
-- FUNCTIONS
--********
        
local function log(domoticz, text, lvlError)
    local lvlLog = domoticz.LOG_INFO
    if lvlError ~= nil and lvlError == true then lvlLog = domoticz.LOG_ERROR end 
    if LOGGING then domoticz.log(text, lvlLog) end 
end     

-- Geting actual rain conditions
local function actualRainConditions(domoticz)
	local iRain = 1
	    
    if RainMeter ~= '' and domoticz.devices(RainMeter).lastUpdate.minutesAgo < AliveTime then
        local rain = domoticz.devices(RainMeter).rain
        local rainRate = domoticz.devices(RainMeter).rainRate
        
        log(domoticz,'Rain today: ' .. rain .. 'mm')
        
        if rain > 0.8 and rain <= 2 then
            iRain = 0.5
        elseif rain > 2 or rainRate > 0 then
            iRain = 0
        end
    else
        log(domoticz,'Rain value is unknown, setting value to 0 mm')
    end
    
    return iRain
end	    

-- Getting actual temperature conditions
local function actualTemperatureConditions(domoticz)
    local temp
    local iTemp = 0
    
    if OutsideTempHum ~= '' and domoticz.devices(OutsideTempHum).lastUpdate.minutesAgo < AliveTime then
        temp = domoticz.devices(OutsideTempHum).temperature
    else
        temp = 22
        log(domoticz,'Temperature is unknown, setting value to 22 °C')
    end
    
    if temp > 20 and temp <= 35 then
        iTemp = (temp - 20)/15
    elseif temp > 20 then
        iTemp = 1
    end
        
    log(domoticz,'Temperature: ' .. temp .. '°C; Temperature index: ' .. iTemp)
    
    return iTemp
end

-- Testing Water level in tank
local function checkWaterLevel(domoticz)
    if WaterLevel ~= '' and domoticz.devices(WaterLevel).lastUpdate.minutesAgo < AliveTime then
        if domoticz.devices(WaterLevel).percentage > 5 then
            return true
        end
    end

    return false
    
end
        
--********
-- Main Loop
--********
return {
	logging = {
        marker = "irrigation"
  },
	on = {
        timer = { 
            'at 8:00',
            'at 12:00',
            'at 16:00',
            'at 20:00',
        },
        devices = {
            Trigger,
        },
	},
	execute = function(domoticz, item)
	    local booster = 1
	    
	    if domoticz.devices(Pump).state == 'On' then
	        log(domoticz,'Pump is already ON -> skipping.')
            return
        end
	
	    if (item.isTimer or (domoticz.devices(Trigger).state == 'On')) and (domoticz.devices(Switch).state == 'On') then
	    --if (domoticz.devices(Switch).state == 'On') then
            local now = domoticz.time.hour
            log(domoticz,'Actual time hour is: ' .. now)
            
            if now == 8 then
                booster = 2
                domoticz.devices(Blower).switchOn().forSec(600)
                if NOTIFYING then
                    domoticz.notify(NotificationMessageBlower)
                end
            elseif now == 20 then
                booster = 1.5
                domoticz.devices(Blower).switchOn().forSec(600)
                if NOTIFYING then
                    domoticz.notify(NotificationMessageBlower)
                end
            end
            
            local iRain = actualRainConditions(domoticz)
            local iTemp = actualTemperatureConditions(domoticz)
        
            -- Counting "pump on" interval 
            local interval = (AbsoluteTime + iTemp * TemperatureTime) * iRain * booster
            
            if checkWaterLevel(domoticz) and interval > 0 then
                
                -- Sensor issue protection
                if interval > 200 then 
                    interval = 200 
                end
                
                --domoticz.devices(Pump).switchOn().forSec(interval).repeatAfterSec(15, RepeatCycles)
                domoticz.devices(Pump).switchOn().forSec(interval)
                --log(domoticz,'Pump is ON for: ' .. RepeatCycles .. ' interval(s) of ' .. interval .. 'seconds.')
                log(domoticz,'Pump is ON for: ' .. interval .. ' seconds.')
                if NOTIFYING then
                    domoticz.notify(NotificationMessagePump)
                end
            else
                log(domoticz,'Pump has not been switched on.')
            end
        end
	end
}