Flow Cards Reference

Complete guide to all available flow cards

Quick Navigation

WHEN (Triggers)

AND (Conditions)

THEN (Actions)

WHEN Cards (Triggers)

Trigger

Formula [formula] changed to [state]

Triggers when a formula evaluation result changes to TRUE or FALSE.

Parameters:

  • formula - Select which formula to monitor (dropdown)
  • state - TRUE or FALSE (dropdown)

Example:

WHEN Formula [security_alert] changed to [TRUE]

THEN Send notification "Security alert triggered!"

💡 Available for both Logic Device and Logic Unit

State changed (Logic Device only)

Triggers on ANY state change (TRUE→FALSE or FALSE→TRUE) with a token containing the new state.

Parameters:

  • None - Triggers on any change

Tokens:

  • state - The new state (true/false)
  • device_name - Name of the Logic Device

Example:

WHEN [Motion Light] State changed

THEN Send notification "Motion Light is now {{state}}"

✓ Logic Device exclusive feature - responds to both TRUE and FALSE changes

Formula [formula] timed out

Triggers when a formula's evaluation times out (inputs didn't arrive within timeout period).

Parameters:

  • formula - Select which formula to monitor (dropdown)

Example:

WHEN Formula [door_sequence] timed out

THEN Send notification "Door sequence incomplete - check sensors"

⚠️ Only triggers if timeout is configured in formula settings (timeout > 0)

AND Cards (Conditions)

Condition

Formula [formula] result is [state]

Checks if a formula's current result matches the specified state.

Parameters:

  • formula - Select which formula to check (dropdown)
  • state - TRUE or FALSE (dropdown)

Example:

WHEN Motion detected

AND Formula [nighttime] result is [TRUE]

THEN Turn on lights

Device is turned [on/off]

Checks if the Logic Device/Unit is enabled or disabled.

Parameters:

  • state - On or Off (dropdown)

Example:

WHEN Time is 23:00

AND [Security Logic] is turned [ON]

THEN Arm security system

Has error / Has any error

Checks if a specific formula or the entire device has any errors.

Variants:

  • Formula [formula] has error - Check specific formula
  • Has any error - Check if device has any errors

Example:

WHEN Every hour

AND [Security Logic] has any error

THEN Send notification "Check security logic configuration"

Wait until [device].[capability] becomes [value]

BETA

Pauses flow execution and waits for a device capability to reach a target value. Creates YES/NO paths.

Parameters:

  • device - Device to monitor (autocomplete)
  • capability - Capability to watch (dropdown, dynamic)
  • target_value - Value to wait for (text/number)
  • timeout_value - Maximum wait time (number)
  • timeout_unit - ms/s/m/h (dropdown)
  • waiter_id - Optional ID (auto-generated if empty)

Example:

WHEN Motion detected in hallway

AND Wait until [Hallway Light].onoff becomes [true] (timeout: 5 min)

THEN ✅ Announce "Light confirmed on"

ELSE ❌ Notify "Light didn't turn on - check bulb?"

⚠️ Experimental Feature

See Waiter Gates documentation for complete details and limitations.

THEN Cards (Actions)

Action

Set input [input] to [value]

Manually sets an input value for formula evaluation.

Parameters:

  • input - Which input (A, B, C...J) (dropdown)
  • value - true or false (dropdown)

Variants:

  • Set all inputs to [value] - Set all inputs at once
  • Set input [input] value to [device].[capability] - Use device capability as value

Example:

WHEN Door opened

THEN Set input [A] to [true]

💡 Input values trigger formula re-evaluation automatically

Evaluate formula [formula]

Manually triggers formula evaluation with current input values.

Parameters:

  • formula - Which formula to evaluate (dropdown)

Variants:

  • Evaluate all formulas - Evaluate all formulas at once (Logic Unit only)
  • Evaluate expression [expression] - Evaluate custom expression on-the-fly

Example:

WHEN Settings changed

THEN Evaluate all formulas

💡 Useful after setting multiple inputs, or to force re-evaluation

Clear error

Clears error state for a formula or device.

Variants:

  • Clear error for formula [formula] - Clear specific formula error
  • Clear all errors - Clear all errors on device

Example:

WHEN Configuration updated

THEN Clear all errors

Wait [duration] [unit]

Simple wait/delay action. Pauses flow execution for specified duration.

Parameters:

  • duration - How long to wait (number)
  • unit - Milliseconds, Seconds, Minutes, or Hours (dropdown)

Example:

WHEN Motion detected

THEN Turn on light

THEN Wait [30] [seconds]

THEN Turn off light

💡 This is a simple delay card, not related to Waiter Gates reactive waiting

Control Waiter Gate [waiter_id] → [action]

BETA

Enable, disable, or stop a running Waiter Gate.

Parameters:

  • waiter_id - ID of the waiter to control (text)
  • action - Enable, Disable, or Stop (dropdown)

Actions:

  • Enable - Re-enable a disabled waiter
  • Disable - Temporarily disable waiter (doesn't stop current wait)
  • Stop - Immediately stop waiter and resolve to NO path

Example:

WHEN Manual override triggered

THEN Control Waiter Gate [door_monitor] → [Stop]

⚠️ Experimental Feature

Part of Waiter Gates system. See full documentation.

Device-Specific Cards

Logic Device Only

  • ✓ State changed trigger (with tokens)
  • ✓ Device alarm state changed trigger
  • ✓ Device on state changed trigger

These cards leverage the Logic Device's unified state model

Logic Unit Only

  • ✓ Evaluate all formulas action
  • ✓ Set all inputs action
  • ✓ Multiple formula management

Logic Unit excels at managing complex multi-formula scenarios

Common Flow Patterns

Pattern 1: Simple Logic Flow

WHEN Motion detected

THEN Set input A to true

→ Formula evaluates automatically, triggers other flows if result changes

Pattern 2: React to Logic Result

WHEN Formula [security] changed to TRUE

THEN Turn on alarm

THEN Send notification

Pattern 3: Multi-Step Logic Setup

WHEN Time is sunset

THEN Set input A to true

THEN Set input B to [Living Room].motion

THEN Evaluate formula [evening_mode]

Pattern 4: Error Handling

WHEN Formula [critical] timed out

THEN Send notification "Formula timeout"

THEN Clear error for formula [critical]

THEN Evaluate formula [critical]

Pattern 5: Reactive Wait (BETA)

WHEN Button pressed

AND Wait until [Device].capability becomes [value]

THEN ✅ Action for success

ELSE ❌ Action for timeout

💡 Pro Tips

↑ Back to top