Skip to content

Commit

Permalink
chore: wording changed
Browse files Browse the repository at this point in the history
  • Loading branch information
zinen committed Feb 24, 2021
1 parent f704c77 commit 6f270ea
Show file tree
Hide file tree
Showing 4 changed files with 13 additions and 13 deletions.
20 changes: 10 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,28 +3,28 @@
[![NPM Total Downloads](https://img.shields.io/npm/dt/node-red-contrib-hue-tunable-white.svg)](https://www.npmjs.com/package/node-red-contrib-hue-tunable-white)
[![Dependencies](https://david-dm.org/zinen/node-red-contrib-hue-tunable-white.svg)](https://david-dm.org/zinen/node-red-contrib-hue-tunable-white)

Node-RED node automatic change white color temperature of lights as the day progress.
Node-RED node to automatic change white color temperature of lights as the day progress.

A tiny script just to give you a feeling of varying daylight. It's used to increase mental health for people, in this modern world, spending too much time inside.
A tiny script to give you a feeling of varying daylight. It's used to increase mental health for people, in this modern world, spending too much time inside.

## What is tunable white
*Aliases: 'tunable white', 'dynamic white', 'tunable dynamic white', 'kelvin changing'*

Its the possibility to change the 'color' of the white light according to the colors of the sun **automatically**. From the light orange shine at the morning and evening to the blueish light at midday. Basically to simulate daylight even if you don't go outside or during winter when daylight is scares.
Its the possibility to change the 'color' of the white light according to the colors of the sun **automatically**. From the light orange shine in the morning and evening to the blueish light at midday. Basically to simulate daylight even if you don't go outside or during winter when daylight is scares.

## Usage
Give the node an input every so often to make it do its thing. Eg. every 15 minutes seams to work good. Also i recommend sending a ``msg.reset`` once a day, eg. at night, to overrule any manually changed lights back to having its color temperature automated.
Give the node an input every so often to make it do its thing. E.g. every 15 minutes seams to work good. Also i recommend sending a ``msg.reset`` once a day e.g. at night to overrule any manually changed lights back to having its color temperature automated.

### To get easy started
In Node-RED editor, click menu at top right corner -> Import -> Examples -> node-red-contrib-hue-tunable-white -> basic.

# How it works
At first run all lights are controlled to the right color temperature for the current time. Once this first run is completed the node will do a more careful update of the color temperature.
It will only change the color if the lights currently has the default startup color temperature or has the value has this node specified last. This means you can still change you lights and this node will respect that you manually took control of the light. If you turn your lights on and off from the mains this is also handled just fine if you lights startup with its standard value.
It will only change the color if the lights currently has the default startup color temperature or has the value this node specified last. This means you can still change you lights and this node will respect that you manually took control of the light. If you turn your lights on and off from the mains this is also handled just fine (if you lights startup with its standard value and not the last setting).

![Edit dialog image](./img/edit-dialog.jpg)
![Edit dialog image](./img/edit-dialog.png)
## Calculating the color
The node will use system time of the server to do a calculation of the color. A caveat to only relying on time is the color does not follow the real state of the sun at your location, as I found it more usable to control the light according to a fix schema.
The node will use system time of the server to do a calculation of the color. A caveat to only relying on time is the color does not follow the real state of the sun at your location as I found it more usable to control the light according to a fixed schema.

So this is how its calculated pr default settings:
At 7:00 and again at 21:00 the color will be the most orange. At 14:00 the color will be white-blueish.
Expand All @@ -33,16 +33,16 @@ The graph below shows how the color will change according to the current hour.

![Graph](./img/graph.png)

You can change the setting by defining your own data point in the edit dialog.
You can change the setting by defining your own data points in the edit dialog.

# Requirements
Requires a Hue Bridge and for you to grab a API key from it:
[Official guide to getting the API key (aka. *username*)](https://developers.meethue.com/develop/get-started-2/)

## Supported devices
Tested with these lights:
Tested with these lights\*:
* Philips hue white ambiance
* Philips hue color
* Osram LIGHTIFY

*Not tested with lights that only does dimming, as I don't got access to any*
*\*Not tested with lights that only does dimming as I don't got access to any*
2 changes: 1 addition & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "node-red-contrib-hue-tunable-white",
"version": "1.1.0",
"version": "1.1.1",
"description": "Node-RED node automatic change white color temperature of lights as the day progress.",
"main": "tunable-white.js",
"scripts": {
Expand Down
2 changes: 1 addition & 1 deletion tunable-white.html
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@
<span>CT</span>: <input type="number" id="node-input-dataPoint3CT" style="width:100px;" autocomplete="off" placeholder="400">
</div>
<div class="form-row">
<label>Color temperature max/min</label>
<label>Color temperature limits</label>
<span>min</span>: <input type="number" id="node-input-CTMin" style="width:100px;" autocomplete="off" placeholder="200">
&nbsp;&nbsp;
<span>max</span>: <input type="number" id="node-input-CTMax" style="width:100px;" autocomplete="off" placeholder="400">
Expand Down

0 comments on commit 6f270ea

Please sign in to comment.