You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
v1.10.0 (test): Circadian Light Group with form UI, solar/lux anchors and 24 flow cards
New device that adjusts dim and color temperature for a group of real lights
following a circadian rhythm.
Anchor modes per phase: time, solar event (14 events via suncalc with offset
and polar fallback) or lux sensor crossing (rising/falling with fallback).
Light profile: per-phase dim + temperature with smooth interpolation, plus
red mode threshold — color-capable lights shift to red as calculated
temperature drops below the threshold, with saturation scaling linearly.
Outdoor source: astronomical, Homey lux sensor, Open-Meteo, MET.no or
external value pushed via Flow.
Form-based pair + repair UI replaces the JSON textarea, with sensor pickers,
event dropdowns and per-light tweaks (enable, prewarm, allow red, min/max
dim). The device tile always shows the calculated dim/temp regardless of
on/off or paused state — the on/off only gates whether updates are pushed
to the underlying lights.
24 new/updated flow cards: triggers (phase changed, red mode started/ended,
paused/resumed, turned on/off, plus app-level solar event occurred);
conditions (is in phase, red mode active, is paused, is on); actions (pause
with sec/min/hour unit, pause until time, pause until solar, turn on/off/
toggle, set red threshold, apply temporary state, force red mode, apply
now, set outdoor lux).
Stable channel still ships v1.9.2 — v1.10.0 is in test only.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: CHANGELOG.md
+24-1Lines changed: 24 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,30 @@ All notable changes to Smart (Components) Toolkit for Homey will be documented i
6
6
7
7
---
8
8
9
-
## [1.9.2] - February 2026 (Current)
9
+
## [1.10.0] - May 2026 (Test channel)
10
+
11
+
> Available only via [the test channel](https://homey.app/a/no.tiwas.booleantoolbox/test/). Stable channel still ships v1.9.2.
12
+
13
+
### ✨ New Device: Circadian Light Group
14
+
A virtual light device that follows a circadian rhythm — adjusts dim and color temperature for a group of real lights based on time, sun position or ambient lux, with optional red mode at night.
15
+
16
+
-**Anchor modes (per phase)**: clock time, solar event (sunrise, sunset, civil/nautical/astronomical dawn/dusk, golden hour morning/evening, blue hour morning/evening, solar noon, solar midnight) with offset and polar fallback, or lux sensor crossing (rising/falling) with polar/cloudy fallback.
17
+
-**Light profile**: per-phase dim + temperature, smooth interpolation, red mode threshold (lower temperature → more saturated red on color-capable lights).
18
+
-**Outdoor source**: astronomical, Homey lux sensor, weather API (Open-Meteo, MET.no) or external value pushed via Flow.
19
+
-**Per-light settings**: enable, prewarm before on, allow red mode, min/max dim.
20
+
-**Form-based pair + repair**: full UI for schedule, profile, sensors and per-light tuning. JSON config kept available as advanced fallback.
21
+
-**Live tile**: dim/temperature on the device tile always reflects the calculated target, regardless of on/off or paused state.
22
+
23
+
### ✨ New Flow Cards
24
+
**Triggers**: phase changed, red mode started/ended, paused/resumed, turned on/off, target changed, error occurred, outdoor light requested. Plus app-level **Solar event occurred** with all 14 events and offset, usable from any flow.
25
+
26
+
**Conditions**: is in phase, red mode active, is paused, is on.
27
+
28
+
**Actions**: pause (with seconds/minutes/hours unit), pause until time, pause until solar event, resume, turn on/off/toggle, set red threshold, apply temporary state (dim/temp/saturation/force red — overwritten on next scheduler tick), force red mode (on/off/clear with optional duration), apply now, set outdoor lux.
> **📚 Full Documentation:**https://tiwas.github.io/SmartComponentsToolkit/
6
6
@@ -10,173 +10,120 @@ Replace complex flow networks with powerful logic devices controlled by dynamic
10
10
11
11
---
12
12
13
-
## Device Types at a Glance
13
+
## 🧪 New in test (v1.10.0): Circadian Light Group
14
14
15
-
| Device | Purpose |
16
-
|--------|---------|
17
-
|**Logic Device**| Boolean logic with visual wizard. Combine device states into TRUE/FALSE using formulas like `A AND B`. |
18
-
|**Logic Unit**| Advanced boolean logic with multiple formulas per device. JSON configuration. |
19
-
|**State Device**| Scene management. Capture states at setup, apply with one action. "Virtual device". |
20
-
|**State Capture Device**| Dynamic state capture at runtime. Push/pop stack for temporary changes. |
15
+
A virtual **light device** that adjusts brightness and color temperature for a group of real lights — automatically following a circadian rhythm. Available now in the [test channel](https://homey.app/a/no.tiwas.booleantoolbox/test/) only; the stable channel still ships v1.9.2 without this device.
21
16
22
-
## Flow Cards (no device needed)
17
+
**Why use it?**
18
+
- Bright cool light during the day, warm dim light in the evening, deep red at night to preserve melatonin and night vision.
19
+
- Works at any latitude — pick clock times, solar events, or lux-sensor thresholds per phase.
20
+
- Doesn't turn lights on or off; it only adjusts already-on lights, so it never fights with your other automations.
23
21
24
-
| Flow Card | Purpose |
25
-
|-----------|---------|
26
-
|**Conditional Gates**| Simple GO/NO GO flow control without needing variables or devices. |
27
-
|**Waiter Gates**| Pause flow until a device capability reaches a specific value. |
28
-
|**Evaluate Expression**| Range checking and value mapping with AND/OR logic. |
22
+
### Anchor modes (mix and match per phase)
29
23
30
-
---
24
+
| Mode | Description |
25
+
|------|-------------|
26
+
|**Time**| Fixed clock time (HH:MM). Best near the equator. |
27
+
|**Solar event**| Sunrise, sunset, civil/nautical/astronomical dawn/dusk, golden hour, blue hour, solar noon/midnight — with offset minutes and a polar fallback time. |
28
+
|**Lux sensor**| A real lux sensor crosses a configurable threshold (rising or falling). Falls back to a fixed time until the first crossing of the day. |
31
29
32
-
##State Capture Device
30
+
### Light profile
33
31
34
-
A device type for dynamic state capture with templates, named slots, and push/pop stack operations:
32
+
- Per-phase **dim** and **temperature** with smooth interpolation between anchors.
33
+
-**Red mode threshold**: when the calculated temperature drops below the threshold, color-capable lights shift to red. Saturation scales with how deep below the threshold you are.
34
+
- Per-light tweaks: enable/disable, prewarm before on, allow red mode, min/max dim.
35
35
36
-
-**Template-based:** Define which devices/capabilities to capture (values read at runtime)
37
-
-**Named states:** Store up to 50 named snapshots per device
38
-
-**Push/Pop stack:** Temporary state management with up to 20 levels
39
-
-**Backup/Restore:** Export all named states as JSON, import to restore or transfer
40
-
-**Homey tokens:** Use dynamic state names from flow variables
36
+
### Outdoor light source
41
37
42
-
**Example use case:**
43
-
```
44
-
WHEN: Doorbell rings
45
-
THEN: Push current state to stack
46
-
THEN: Set all lights to 100%
47
-
THEN: Wait 5 minutes
48
-
THEN: Pop state (restore previous)
49
-
```
38
+
Choose how the device knows how bright it is outside:
<ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/state-capture-device.html"target="_blank">→ Read State Capture Device Documentation</a>
44
+
### 24 new flow cards
52
45
53
-
---
46
+
**Triggers**: phase changed, red mode started/ended, paused/resumed, turned on/off, target changed, error, outdoor light requested. Plus an **app-level "Solar event occurred"** card with all 14 events + offset, usable from any flow.
54
47
55
-
## Conditional Gates (NEW in v1.9.0) — Flow Cards
48
+
**Conditions**: is in phase, red mode active, is paused, is on.
56
49
57
-
A lightweight alternative to variables and virtual switches for flow control. **No device needed**- just use the flow cards directly. Gates have two states: **GO** or**NO GO**.
50
+
**Actions**: pause (sec/min/hour), pause until time, pause until solar event, resume, turn on/off/toggle, set red threshold, **apply temporary state**(override dim/temp/saturation/red — restored on next tick, perfect for testing or quick "moods"),**force red mode** (with optional duration), apply now, set outdoor lux.
58
51
59
-
**Why use Conditional Gates?**
60
-
- No need to create devices or variables just to control flow execution
61
-
- Named gates give you overview of all your flow controls in one place
62
-
- Simple GO/NO GO logic is perfect for many automation scenarios
52
+
<ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/circadian-light-group.html"target="_blank">→ Read full Circadian Light Group guide</a>
63
53
64
-
**Flow Cards:**
54
+
<ahref="https://homey.app/a/no.tiwas.booleantoolbox/test/"target="_blank">→ Install v1.10.0 test version</a>
65
55
66
-
| Card Type | Card | Description |
67
-
|-----------|------|-------------|
68
-
|**Condition**| Gate is GO/NO GO | Check if a gate is currently GO or NO GO |
69
-
|**Then**| Conditional Gate: Wait for GO | Pauses flow until the gate becomes GO (with timeout) |
70
-
|**Then**| Modify Conditional Gate | Set a gate to GO or NO GO by name |
56
+
---
71
57
72
-
**Example use case:**
73
-
```
74
-
Flow 1 - Motion detected:
75
-
WHEN: Motion sensor triggered
76
-
THEN: Modify Conditional Gate "allow_lights" → GO
77
-
78
-
Flow 2 - Turn on lights:
79
-
WHEN: Door opened
80
-
AND: Gate "allow_lights" is GO
81
-
THEN: Turn on lights
82
-
83
-
Flow 3 - Disable at night:
84
-
WHEN: Time is 23:00
85
-
THEN: Modify Conditional Gate "allow_lights" → NO GO
86
-
```
58
+
## What's already in stable (v1.9.2)
87
59
88
-
---
60
+
| Device | Purpose |
61
+
|--------|---------|
62
+
|**Logic Device**| Boolean logic with visual wizard. Combine device states into TRUE/FALSE using formulas like `A AND B`. |
63
+
|**Logic Unit**| Advanced boolean logic with multiple formulas per device. JSON configuration. |
64
+
|**State Device**| Scene management — capture states at setup, apply with one action. |
65
+
|**State Capture Device**| Dynamic state capture at runtime. Push/pop stack for temporary changes, named slots, JSON backup/restore. |
89
66
90
-
## Waiter Gates — Flow Cards
67
+
| Flow Card (no device needed) | Purpose |
68
+
|------------------------------|---------|
69
+
|**Conditional Gates**| Simple GO/NO GO flow control without variables or devices. |
70
+
|**Waiter Gates**| Pause flow until a device capability reaches a target value. |
71
+
|**Evaluate Expression**| Range checking and value mapping with AND/OR logic. |
91
72
92
-
Flow cards that pause execution until a device capability reaches a target value. **No device needed** - just use the flow cards directly.
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/getting-started.html"target="_blank">**Getting Started Guide**</a> - Create your first logic device in 5 minutes
163
-
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/devices.html"target="_blank">**Device Types Guide**</a> - Understanding all device types
164
-
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/state-device.html"target="_blank">**State Device**</a> - Pre-defined scene management
165
-
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/state-capture-device.html"target="_blank">**State Capture Device**</a> - Dynamic state capture and restore
166
-
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/waiter-gates.html"target="_blank">**Waiter Gates**</a> - Flow control with wait conditions
167
-
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/conditional-gates.html"target="_blank">**Conditional Gates**</a> - Simple GO/NO GO flow control
168
-
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/flow-cards.html"target="_blank">**Flow Cards Reference**</a> - Complete guide to all available cards
169
-
109
+
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/getting-started.html"target="_blank">**Getting Started Guide**</a>
Copy file name to clipboardExpand all lines: README.md
+26-1Lines changed: 26 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,9 +6,12 @@
6
6
7
7
Advanced logic and state management for your Homey automations. Create smart devices that react to multiple inputs with customizable formulas, and manage device states with powerful capture/restore functionality.
> **🧪 v1.10.0 in test channel** — adds the new **Circadian Light Group** virtual device with time/solar/lux anchors, red mode threshold, outdoor light providers and a wide set of new flow cards. Install via [test channel](https://homey.app/a/no.tiwas.booleantoolbox/test/). [Read the guide →](https://tiwas.github.io/SmartComponentsToolkit/docs/circadian-light-group.html)
14
+
12
15
---
13
16
14
17
## 🛠️ Interactive Tools
@@ -107,6 +110,28 @@ THEN: Pop state (restore previous)
107
110
108
111
---
109
112
113
+
### Circadian Light Group 🧪 *(test channel only — v1.10.0)*
114
+
115
+
Virtual light device that adjusts brightness and color temperature for a group of real lights based on time, sun position or ambient lux.
116
+
117
+
| Feature | Description |
118
+
|---------|-------------|
119
+
|**Schedule**| Per anchor: clock time / solar event / lux sensor crossing |
120
+
|**Solar events**| Sunrise, sunset, civil/nautical/astronomical dawn/dusk, golden hour, blue hour, solar noon/midnight — with offset and polar fallback |
121
+
|**Light profile**| Per-phase dim + temperature, red mode threshold |
0 commit comments