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
Update docs and fix conditional gate bugs for v1.9.2
- Fix conditional gate condition cards to return boolean values
- Fix dropdown argument extraction for gate state/modify cards
- Improve gate state handling in WaiterManager
- Update README, CHANGELOG, and community listing to v1.9.2
- Add Conditional Gates and Evaluate Expression to all docs
- Add Conditional Gates nav link across all HTML doc pages
- Fix broken ../README.md nav links to ../index.html
- Fixed dropdown argument extraction for gate state and modify cards
14
+
- Improved gate state handling in WaiterManager
15
+
16
+
---
17
+
18
+
## [1.9.1] - January 2026
19
+
20
+
### 🐛 Bug Fixes
21
+
- Minor fixes
22
+
23
+
---
24
+
25
+
## [1.9.0] - January 2026
26
+
27
+
### ✨ New Features
28
+
-**Conditional Gates** - Simple GO/NO GO flow control without needing variables or devices
29
+
- Gate is GO/NO GO condition card - instant state check
30
+
- Conditional Gate: Wait for GO - pause flow until gate opens (with timeout)
31
+
- Modify Conditional Gate action - set GO, NO GO, or Toggle
32
+
- Gates persist in memory until explicitly changed
33
+
- Named gates for easy management across flows
34
+
35
+
---
36
+
37
+
## [1.8.2] - December 2025
12
38
13
-
This release includes improved documentation with clear descriptions of all device types:
39
+
### 🐛 Bug Fixes
40
+
- Fixed some errors with IDs in waiter gates
14
41
15
-
-**Logic Device** - Boolean logic with visual pairing wizard. Combine multiple device states (motion sensors, door contacts, etc.) into a single TRUE/FALSE output using formulas like `A AND B`.
16
-
-**Logic Unit** - Advanced boolean logic with multiple formulas per device. For power users who need JSON configuration.
17
-
-**State Device** - Scene management. Capture device states during setup and apply them later with a single action.
18
-
-**State Capture Device** - Dynamic state capture at runtime. Push/pop stack for temporary state changes.
19
-
-**Waiter Gates** (BETA) - Flow control that pauses and waits for device states to change.
42
+
---
43
+
44
+
## [1.8.1] - December 2025
45
+
46
+
### 🐛 Bug Fixes
47
+
- Bug fix + better hints
48
+
49
+
---
50
+
51
+
## [1.8.0] - December 2025
52
+
53
+
### 📦 Name Change & Scene Functionality
54
+
- Name change from "Boolean Toolbox" to "Smart (Components) Toolkit"
55
+
- Scene functionality live
56
+
57
+
### 📦 Device Types Overview
58
+
-**Logic Device** - Boolean logic with visual pairing wizard
59
+
-**Logic Unit** - Advanced boolean logic with multiple formulas per device
60
+
-**State Device** - Scene management with predefined states
61
+
-**State Capture Device** - Dynamic state capture at runtime
62
+
-**Waiter Gates** - Flow control that pauses and waits for device states to change
20
63
21
64
### 🔗 Documentation
22
65
- Full documentation available at: https://tiwas.github.io/SmartComponentsToolkit/
@@ -175,8 +218,7 @@ This release includes improved documentation with clear descriptions of all devi
175
218
176
219
## Roadmap (Future Considerations)
177
220
178
-
- Waiter Gates improvements based on user feedback
> **📚 Full Documentation:**https://tiwas.github.io/SmartComponentsToolkit/
6
6
@@ -18,7 +18,14 @@ Replace complex flow networks with powerful logic devices controlled by dynamic
18
18
|**Logic Unit**| Advanced boolean logic with multiple formulas per device. JSON configuration. |
19
19
|**State Device**| Scene management. Capture states at setup, apply with one action. "Virtual device". |
20
20
|**State Capture Device**| Dynamic state capture at runtime. Push/pop stack for temporary changes. |
21
-
|**Waiter Gates**| Flow control that pauses and waits for device states to change. |
21
+
22
+
## Flow Cards (no device needed)
23
+
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
29
23
30
---
24
31
@@ -45,6 +52,80 @@ THEN: Pop state (restore previous)
45
52
46
53
---
47
54
55
+
## Conditional Gates (NEW in v1.9.0) — Flow Cards
56
+
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**.
58
+
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
63
+
64
+
**Flow Cards:**
65
+
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 |
71
+
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
+
```
87
+
88
+
---
89
+
90
+
## Waiter Gates — Flow Cards
91
+
92
+
Flow cards that pause execution until a device capability reaches a target value. **No device needed** - just use the flow cards directly.
93
+
94
+
**Flow Cards:**
95
+
96
+
| Card Type | Card | Description |
97
+
|-----------|------|-------------|
98
+
|**Then**| Wait until device capability becomes X | Pauses flow until capability matches target (YES) or timeout (NO) |
99
+
|**Then**| Control Waiter Gate | Enable, disable or stop a waiter gate by ID |
100
+
101
+
**Example use case:**
102
+
```
103
+
WHEN: Button pressed
104
+
THEN: Turn on coffee machine
105
+
THEN: Wait until coffee machine temperature ≥ 90°C (timeout: 5 min)
106
+
→ YES: Send notification "Coffee ready!"
107
+
→ NO: Send notification "Coffee machine timeout"
108
+
```
109
+
110
+
---
111
+
112
+
## Evaluate Expression — Flow Card
113
+
114
+
A powerful flow card for range checking and value mapping. **No device needed** - use directly in your flows.
115
+
116
+
**Flow Card:**`Evaluate [[input]] [[op1]] min [[logical_op]] [[op2]] max with rules [[rules]]`
117
+
118
+
- Check if a value is within a range (e.g., temperature between 18-22°C)
119
+
- Use AND/OR logic for complex conditions
120
+
- Returns output value and error message tokens
121
+
122
+
**Example:** Check if temperature is comfortable (18-24°C):
123
+
- Input: temperature token
124
+
- Rules: `18,24` (min, max)
125
+
- Operators: `≥` AND `≤`
126
+
127
+
---
128
+
48
129
## Device Types
49
130
50
131
**Logic Device** - Recommended for beginners
@@ -68,11 +149,6 @@ THEN: Pop state (restore previous)
68
149
- Push/pop stack for temporary interruptions
69
150
- Backup/restore via JSON export/import
70
151
71
-
**Waiter Gates***(BETA)* - Flow control
72
-
- Pause flows until a device state changes
73
-
- Wait for specific conditions to become true
74
-
- Control flow execution with pause/resume gates
75
-
76
152
**Logic Unit X** - Deprecated
77
153
- Fixed input counts (2, 3, 4...10)
78
154
- Still functional but not recommended for new setups
@@ -88,6 +164,7 @@ THEN: Pop state (restore previous)
88
164
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/state-device.html"target="_blank">**State Device**</a> - Pre-defined scene management
89
165
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/state-capture-device.html"target="_blank">**State Capture Device**</a> - Dynamic state capture and restore
90
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
91
168
- <ahref="https://tiwas.github.io/SmartComponentsToolkit/docs/flow-cards.html"target="_blank">**Flow Cards Reference**</a> - Complete guide to all available cards
Copy file name to clipboardExpand all lines: README.md
+68-8Lines changed: 68 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@
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.
0 commit comments