Skip to main content

Linking Products

Some products can interact with each other to create powerful automations and control mechanisms. For example, a remote control can operate shutters, lights, or pergolas. Sensors can trigger actions on other products based on environmental conditions.

What Are Product Links?

Product links (also called macros or product interactions) define how one product interacts with another. The middleware understands these interactions and provides a list of possible links based on the products in your installation.

Common Product Interactions​

Here are typical examples of product linking:

  • Remote Control → Shutter/Screen: A button on a remote opens or closes a shutter
  • Remote Control → Pergola: A button controls pergola louvres or screens
  • Remote Control → Lights: A button turns lights on/off or adjusts brightness
  • Sensor Platform → Awning: Wind or rain sensors automatically retract an awning
  • Gateway Weather → Products: Online weather data triggers product actions

You'll be prompted to link products:

  1. After adding a new product – The app checks if the new product can interact with existing products
  2. Manually in Product Settings – You can create, view, or remove links at any time
tip

If the middleware returns an empty list of possible interactions, you won't see any linking prompts. This means the product doesn't support interactions with other products in your installation.

How Product Linking Works​

The Middleware Knows the Rules​

The middleware understands:

  • Which products can interact with each other
  • What actions are possible (macros)
  • What parameters are required

You Select the Interaction​

You simply:

  1. Choose the products to link
  2. Select the desired interaction from available options
  3. Configure any required parameters
  4. Save the link

Linking Products: Step-by-Step​

When you add a new product, the app automatically checks for possible interactions.

  1. Add a Product

  2. Review Suggested Links

    • If interactions are available, you'll see a prompt: "This product can interact with other products"
    • The app displays a list of possible interactions

  3. Select a Link

    • Tap on the interaction you want to create
    • Example: "Remote Control Button 1 → Open/Close Pergola Screen"

  4. Configure Parameters (if required)

    • Some links require mandatory parameters (e.g., text fields, dropdowns, toggles)
    • Enter the required information
    • Example: Select which button triggers which action

  5. Save the Link

    • Tap Save or Create Link
    • The link is now active

  6. Skip for Now

    • You can skip linking during setup
    • Create links later in Product Settings

You can create, view, and manage links at any time.

  1. Navigate to Product Settings

    • Go to Products → Select Product → Settings

  2. Open Product Linking

    • Tap Links, Interactions, or Macros

  3. View Existing Links

    • See all links involving this product
    • View which products are linked and what actions are configured

  4. Create a New Link

    • Tap Add Link or New Interaction
    • The middleware provides a list of possible interactions for this product

  5. Select Products to Link

    • Choose the product(s) you want to link with
    • The list is filtered to show only valid interactions

  6. Select the Interaction Type

    • Choose the macro/interaction from available options
    • Example: "Button 2 controls Awning extend/retract"

  7. Configure Parameters

    • Set any mandatory parameters
    • Example: Map button presses to specific actions

  8. Save the Link

    • Tap Save
    • The link is now active

Method 3: Filter by Product​

For a more targeted approach:

  1. Go to Products Screen

    • View all products in the installation

  2. Select Products

    • Select one or more products (use multi-select if available)

  3. View Filtered Interactions

    • The app shows only interactions valid for the selected products
    • This limits the list to relevant links

  4. Create the Link

    • Follow the same steps as above

  1. Navigate to Product Settings

    • Go to Products → Select Product → Settings

  2. Open Links Section

    • Tap Links, Interactions, or Macros

  3. View Link Details

    • See which products are linked
    • View the interaction type (macro)
    • See configured parameters

  1. Navigate to Links Section

    • Go to Products → Select Product → Settings → Links

  2. Select the Link

    • Tap on the link you want to edit

  3. Modify Parameters

    • Change any configurable settings
    • Example: Remap buttons to different actions

  4. Save Changes

    • Tap Save

  1. Navigate to Links Section

    • Go to Products → Select Product → Settings → Links

  2. Select the Link

    • Tap on the link you want to remove

  3. Delete the Link

    • Tap Delete, Remove, or the trash icon
    • Confirm the deletion

  4. Result

    • The link is removed and the interaction is no longer active

Example 1: Remote Control → Shutter​

Scenario: A 4-button remote control operates a ZIP screen.

Link Configuration:

  • Product 1: Remote Control
  • Product 2: ZIP Screen
  • Interaction: "Button controls screen position"
  • Parameters:
    • Button 1: Open screen (move to 0%)
    • Button 2: Close screen (move to 100%)
    • Button 3: Stop screen
    • Button 4: Set screen to 50%

Result: Pressing Button 1 on the remote opens the screen.

Example 2: Sensor Platform → Awning​

Scenario: A sensor platform with wind and rain sensors automatically retracts an awning when conditions are unsafe.

Link Configuration:

  • Product 1: Sensor Platform
  • Product 2: Awning
  • Interaction: "Weather sensor controls awning"
  • Parameters:
    • Wind threshold: 30 km/h
    • Rain: On (retract when raining)
    • Action: Retract awning (move to 0%)

Result: When wind exceeds 30 km/h or rain is detected, the awning automatically retracts.

Example 3: Gateway Weather → Multiple Products​

Scenario: Online weather data from the gateway triggers actions on multiple outdoor products.

Link Configuration:

  • Product 1: Gateway (weather models)
  • Product 2: Pergola, Awning, Screens
  • Interaction: "Weather-based automation"
  • Parameters:
    • Thunderstorm: Close all outdoor products
    • High wind: Retract awning, close screens

Result: When a thunderstorm is detected, all linked products automatically close.

Expected Result​

After linking products:

  • Interactions work as configured (e.g., pressing a remote button controls a shutter)
  • Links are visible in Product Settings
  • You can edit or remove links at any time

Troubleshooting​

No Interactions Available​

  • Check product types: Not all products support linking
  • Check installation: Products must be in the same installation
  • Add more products: Some interactions require specific product combinations
  • Check product status: Ensure both products are online
  • Check gateway: Ensure the gateway is connected
  • Review parameters: Verify link configuration is correct
  • Test manually: Try controlling the target product manually first
  • Check the correct product: Links are shown for both products involved
  • Refresh: Pull down to refresh Product Settings
  • Check if deleted: The link may have been removed

Button Press Doesn't Trigger Action​

  • Check link configuration: Verify the button is mapped correctly
  • Check button model: Ensure the button model is working (press button and check state in Product Settings)
  • Check target product: Ensure the target product is online and controllable

Next Steps​

After linking products:

  1. Control Products – Test your linked products
  2. Create Scenes – Create scenes that include linked products
  3. Create Routines – Automate linked products based on schedules or events