Skip to main content

Control Products

Once your products are added and configured, you can control them from three different screens in the app. Each screen serves a different purpose and displays different levels of detail.

Understanding Model Types
  • Output Models (controllable): Lights, motors, heaters – devices you can control
  • Input Models (non-controllable): Buttons, sensors – devices that provide input to the system
  • Visible vs. Non-Visible: Some models are marked "non-visible" and don't appear on certain screens (e.g., button models)

Three Ways to Control Products​

1. Dashboard Screen​

Purpose: Quick access to control products

What's Shown:

  • Products with controllable (output) models
  • Only visible output models are displayed
  • Products with only input models or non-visible models are NOT shown

Best For: Daily control of lights, motors, shutters, and other output devices

2. Product Screen​

Purpose: View and control all models in a product

What's Shown:

  • All products in the installation
  • All visible models (both input and output)
  • Non-visible models are hidden

Best For: Viewing input models (sensors, buttons) and controlling specific products

3. Product Settings Screen​

Purpose: Advanced configuration and status monitoring

What's Shown:

  • All devices in the product
  • All models including non-visible ones (e.g., buttons)
  • Real-time state of all models
  • Configuration options, calibration, and linking information

Best For: Checking button states, reconfiguring products, recalibrating motors, viewing linked products

Using Each Screen​

Dashboard Screen​

  1. Navigate to Dashboard

    • Open the app
    • The Dashboard is usually the default home screen

  2. View Controllable Products

    • You'll see tiles or cards for each product with output models
    • Each tile shows the product name and its controllable models

  3. Control Output Models

    • Lights: Tap to toggle on/off, adjust brightness, or change color
    • Motors/Shutters: Use sliders or buttons to open, close, or set position
    • Heaters: Turn on/off or adjust intensity

  4. Quick Actions

    • Most controls allow immediate interaction without opening details
    • Tap a product to open its detail page for more options
tip

Products that have only input models (e.g., remote controls, sensor platforms) won't appear on the Dashboard. View them in the Products screen.

Product Screen​

  1. Navigate to Products

    • Tap Products in the main menu or navigation bar

  2. View All Products

    • You'll see a list of all products in the active installation
    • This includes products with only input models

  3. Open a Product

    • Tap on a product to open its detail page

  4. View and Control Models

    • Output Models: Control lights, motors, heaters, etc.
    • Input Models: View real-time state of sensors, buttons, etc.
    • Non-visible models are hidden on this screen

  5. Products with No Visible Models

    • Some products (e.g., remote controls) have all their models marked "non-visible"
    • You'll see a message like "No visible models for this product"
    • To view these models, go to Product Settings

Product Settings Screen​

  1. Navigate to Product Settings

    • Go to Products → Select a Product → Settings or gear icon

  2. View All Devices and Models

    • See a complete list of devices in the product
    • See all models, including non-visible ones (e.g., buttons)

  3. Monitor Real-Time State

    • Input Models: See live data from sensors and button presses
    • Output Models: See current state (on/off, position, etc.)

  4. Reconfigure Product

    • Tap Configure or Edit to modify product parameters
    • Adjust settings like names, thresholds, or behavior

  5. Recalibrate Motors

    • If the product has motors, you can recalibrate them
    • Tap Calibrate or Set Limits to restart the calibration process

  6. View Linked Products

    • See if this product is linked to other products (e.g., remote control linked to a shutter)
    • Manage or remove links

  7. Check Device Health

    • View the health status of all devices in the product
    • See if devices are online or offline

Controlling Different Model Types​

Lights​

Types:

  • Monochrome: Single-color lights with adjustable intensity
  • Tunable White: Adjustable intensity and color temperature (warm to cool white)
  • RGB: Full-color lights with red, green, and blue controls

Controls:

  • On/Off: Toggle light on or off
  • Brightness Slider: Adjust light intensity (0-100%)
  • Color Controls (for Tunable White and RGB):
    • TW: Adjust color temperature
    • RGB: Select color using color picker or RGB sliders

Motors / Shutters​

Types:

  • Motors with Feedback: Motors with position feedback (e.g., current-based or protocol-based)
  • Motors without Feedback: Motors without position tracking

Controls (Motors with Feedback):

  • Position Slider: Set exact position (0-100%)
  • Up / Retract: Move motor to fully retracted position
  • Down / Extend: Move motor to fully extended position
  • Stop: Stop motor movement
  • Preset Positions: Some products may have preset positions (e.g., 25%, 50%, 75%)

Controls (Motors without Feedback):

  • Up / Open: Start moving motor up/open
  • Down / Close: Start moving motor down/close
  • Stop: Stop motor movement
  • State: Shows current state (Stopped, Running Up, Running Down)

Heaters​

Types:

  • On/Off Heater: Simple on/off control
  • Dimmable Heater: Adjustable heat intensity

Controls:

  • On/Off: Toggle heater on or off
  • Intensity Slider (dimmable heaters): Adjust heat output (0-100%)

Sensors​

Types:

  • Temperature Sensor: Displays current temperature
  • Rain Sensor: On/Off (raining or not)
  • Wind Sensor: Displays current wind speed
  • Weather Sensor: Displays weather condition (Clear Sky, Clouds, Rain, Thunderstorm, Snow, Mist)

Display:

  • Sensors show real-time data
  • View sensor data in the Product Screen or Product Settings

Buttons​

Type: Input models (typically marked "non-visible")

Display:

  • Button models are usually hidden on the Dashboard and Product Screen
  • View button states in Product Settings
  • See real-time button presses (e.g., "Button 1: Pressed")

Expected Result​

  • Dashboard: Quick control of all output models
  • Products: View and control all visible models
  • Settings: Complete visibility and control, including non-visible models

Troubleshooting​

Product Not Showing on Dashboard​

  • Check for output models: Products with only input models or non-visible models don't appear on the Dashboard
  • View in Products screen: Go to Products to see all products

Can't Control a Model​

  • Check prerequisites: Ensure all prerequisites are complete (see Product Prerequisites)
  • Check device status: Ensure the device is online (check in Product Settings)
  • Check network: Ensure the gateway is connected

Model Shows Wrong State​

  • Refresh: Pull down to refresh the screen
  • Check connection: Ensure devices are online
  • Recalibrate: For motors, recalibrate if position seems incorrect

Button States Not Updating​

  • View in Product Settings: Button models show real-time state in Product Settings
  • Ensure device is online: Check device connectivity
  • Test button: Press the physical button and watch for state changes in the app

Next Steps​

After learning to control products:

  1. Create Scenes – Save product states for quick recall
  2. Create Routines – Automate product control based on time or events
  3. Linking Products – Connect products that interact