Handy functions for dzVents

[HvdW]

I used to 'C', so I missed the IFF(this,then that,else) in dzVents
Here's mine:

Code: Select all

        IIF = function(condition, trueValue, falseValue)
            if condition then
                return trueValue
            else
                return falseValue
            end
        end,

The function is placed in the global_data script under helpers.
To call the function (example)

Code: Select all

domoticz.helpers.IIF(mySwitch.state == 'On', otherSwitch.switchOn(),otherSwitch.switchOff() )

Like the example in Quickstart in the dzVents WiKi.

There is a quick sleep(seconds) function as well:

Code: Select all

        sleep = function(seconds)
            os.execute("sleep " .. tonumber(seconds))
        end,

Called with

Code: Select all

domoticz.helpers.sleep(3)

The sleep() command produces some kind of error when time is set to >= 7 seconds.
The log displays

Code: Select all

Finished Test Script after >7 seconds. (using 0.040 seconds CPU time !)

[waltervl]

Never use sleep in a dzvents script! It will halt dzvents and other Domoticz executions.

That is also why we have the asynchronous os execute function in dzvents to prevent that these os executions halt Domoticz unexpectedly.

[RonkA]

Nice little global_data knowledge nugget, thanks for that.

This has the potential to shorten my scripts a lot by centralizing all the same functions that are used in multiple scripts..

These type of handy uses of dzVents feel buried in the wiki and are not easily found and understand by people that have limited coding skills like me..

[HvdW]

spaces() is a function to help you align data when writing to a Text Sensor

Code: Select all

-- Helper functions
local function spaces(count)
    return string.rep(" ", count)
end

local function round(num, decimals)
    local mult = 10^(decimals or 0)
    return math.floor(num * mult + 0.5) / mult
end

Here is an example how to use it, plus it is a structured way to fill a Text Sensor with text

Code: Select all

        -- Update text display
        domoticz.devices('YourTextSensor').updateText(string.format(
            'lostChargeTime today %s%s min\n' ..
            'Connected Time today %s%s min\n' ..
            'NOT Connected Time today %s%s min',
            spaces(9),domoticz.data.lostChargeTime,
            spaces(8),domoticz.data.connectedTime,
            spaces(0),domoticz.data.notConnectedTime
        ))