node-red-contrib-time-controller

Time Controller

Time Controller is a node-red node for light controller (or other devices) that can fade the light or color channels in a specified time range. It is possible to control each channel separately or in rgb mode. It calculates the values depending on the start and end value and time.
The input values can be an integer or an array. The range doesn't matter, so it is possible to use percentages or rgb values or what ever you'd like.

Configuration

Data

At the moment Data is defined as an array of objects including the start time and value, the end time and value and the topic. The values can be an integer or an array of integers. It doesn't matter whether they are percentages or color values.
See example.json for a full set of a RGBWW controller.

Each object has the following format:

 {
    "start": {
        "time": "06:00:10",
        "value": 0
    },
    "end": {
        "time": "solarNoon",
        "offset": 10,
        "value": 78
    },
    "topic": "rgbw/cmnd/channel1"
},
{
   "start": {
       "time": "06:00",
       "value": [80, 50, 10, 100, 100]
   },
   "end": {
       "time": "solarNoon",
       "offset": 10,
       "value": [500, 50, 10, 1, 255]
   },
   "topic": "light-entity"
}

Example for the home-assistant call service node if the input is defined as array

Data:

{
    "rgbw_color": [
        "{{payload.0}}",
        "{{payload.1}}",
        "{{payload.2}}",
        "{{payload.3}}"
    ],
    "brightness": "{{payload.4}}"
}

Or:

{
    "brightness_pct": "{{payload.0}}",
    "color_temp": "{{payload.1}}"
}

Entity id:

{{topic}}

---

data object	description
start.time	start time, begin fading, "hh:mm:ss" or "suncalc event"
start.offset	start offset in minutes, integer
start.value	start value, integer or array [red, green, blue, brigthness, ...]
end.time	end time, stop fading, "hh:mm:ss" or "suncalc event"
end.offset	end offset in minutes, integer
end.value	end value, integer or array [red, green, blue, brigthness, ...]
topic	topic, e.q. a MQTT topic/ command like a channel or the light entity

Interval

The interval in seconds to refresh the topics. Default: 1

Latitude and Longitude

The coordinates of the location to calculate the correct sun events.

Use previous state of event on reload

If enabled then the Time Controller will emit the state of the previous event. Default: false

Output type

If enabled then the input values must be in percentage and will be returned as color value (0 - 255).

possible suncalc events

https://github.com/mourner/suncalc

sunclac event	datetime
nadir	2020-04-13T01:14:05.769Z
nightEnd	2020-04-13T04:14:23.086Z
nauticalDawn	2020-04-13T05:02:54.596Z
dawn	2020-04-13T05:46:23.778Z
sunrise	2020-04-13T06:21:37.913Z
sunriseEnd	2020-04-13T06:25:11.302Z
goldenHourEnd	2020-04-13T07:06:30.077Z
solarNoon	2020-04-13T13:14:05.769Z
goldenHour	2020-04-13T19:21:41.462Z
sunsetStart	2020-04-13T20:03:00.236Z
sunset	2020-04-13T20:06:33.626Z
dusk	2020-04-13T20:41:47.761Z
nauticalDusk	2020-04-13T21:25:16.942Z
night	2020-04-13T22:13:48.453Z

Inputs

msg.payload	description
"on"	start the timecontroller interval
"off"	stop the timecontroller interval
"hh:mm:ss"	emit events at given time once without interval
"suncalc event"	emit events at given time once without interval

Programmatic Control

todo

Coming soon/ Todo

• fullcalendar to define the time events in the frontend
• programmatic control
• instant on/ off events