Homey Apps SDK
📖 Apps SDK Reference🌍 Web API🛠 Developer Tools
  • Welcome to the Apps SDK documentation 👋
  • The Basics
    • Getting Started
      • Homey CLI
    • App
      • Manifest
      • Internationalization
      • Permissions
      • Persistent Storage
    • Drivers & Devices
      • Pairing
        • System Views
          • Devices List
          • Add Devices
          • OAuth2 Login
          • Credentials Login
          • Pincode
          • Loading
          • Done
        • Custom Views
      • Capabilities
      • Energy
      • Settings
      • Best practices
        • Lights
        • Window coverings
        • Battery status
    • Flow
      • Arguments
      • Tokens
    • Widgets
      • Settings
      • Styling
      • Debugging
  • Wireless
    • Wi-Fi
      • Discovery
    • Bluetooth LE
    • Z-Wave
    • Zigbee
    • 433 MHz
    • Infrared
    • Matter
  • Cloud
    • OAuth2
    • Webhooks
  • App Store
    • Publishing
    • Guidelines
    • Verified Developer
    • Updating
  • Advanced
    • Custom Views
      • App Settings
      • Custom Pairing Views
      • HTML & CSS Styling
    • Web API
    • Images
    • LED Ring
    • Homey Compose
  • Guides
    • Homey Cloud
    • Breaking Changes
    • Tools
      • Bluetooth LE
      • Zigbee
      • TypeScript
    • Using ESM in Homey Apps
  • Upgrade Guides
    • Homey v6.0.0
    • Upgrading to SDK v3
      • Zigbee Apps
    • Device Capabilities
Powered by GitBook
On this page

Was this helpful?

  1. The Basics
  2. Drivers & Devices
  3. Best practices

Window coverings

Window coverings device best practices.

A window coverings device should only be assigned the window_coverings device class if one of the following is not more applicable: curtains, blinds, sunshade.

There are a number of capabilities relevant for window coverings devices:

  • windowcoverings_state

  • windowcoverings_tilt_up

  • windowcoverings_tilt_down

  • windowcoverings_tilt_set

  • windowcoverings_closed

  • windowcoverings_set

In general there are two types of window coverings which should receive a subset of these capabilities:

window coverings that can only be controlled with up/down and stop commands

This type should only implement the windowcoverings_state capability and in case the device supports horizontal tilt of venetian blinds also the windowcoverings_tilt_up and windowcoverings_tilt_down capabilities.

window coverings that can be controlled by sending a command with a precise open/close level

This type should only implement the windowcoverings_set capability and in case the device supports horizontal tilt of venetian blinds also the windowcoverings_tilt_up and windowcoverings_tilt_down capabilities.

Never implement both windowcoverings_state and windowcoverings_set for one driver. This creates duplicate UI components and Flows cards.

PreviousLightsNextBattery status

Last updated 3 years ago

Was this helpful?