Supla Integration

logo

Welcome to the integration of Supla with OpenHAB! Supla is a versatile platform designed for smart home automation, offering a wide range of devices that enhance the convenience and efficiency of your living space. This OpenHAB plugin brings the power of Supla to your home automation system, supporting two types of devices: cloud-based and native. Cloud-based devices leverage Supla’s robust cloud infrastructure for seamless connectivity and remote access, while native devices operate directly within your local network, ensuring rapid response times and offline capabilities. Together, these options provide flexibility and reliability for all your smart home needs.

Native Server

This binding supports Supla native devices using the native protocol, allowing the binding to act as a server and enabling direct communication with your Supla devices without the need for a third-party server.

By using the native protocol, all interactions with your Supla devices are contained within your local network. This approach offers several benefits, including increased security, reduced latency, and the ability to continue operating even if your internet connection is down. This setup ensures that your smart home system remains efficient, reliable, and responsive at all times.

However, it’s important to note that by opting for this setup, you lose the integration with Supla Cloud. This means you won’t have remote access through the Supla Cloud app or benefit from cloud-based services and updates provided by Supla. Ensure this trade-off aligns with your smart home requirements before proceeding with the native device configuration.

Cloud

To connect your Supla cloud devices to OpenHAB, you’ll need to use the Supla Cloud Bridge. This bridge facilitates communication between OpenHAB and Supla’s cloud infrastructure. The first step in setting up this connection is to generate an OAuth token from the Supla Cloud.

Follow these steps to generate your OAuth token:

  1. Visit the Supla Cloud security page at SUPLA Cloud.
  2. Create a new personal access token by following the instructions on the page.
  3. An example token might look like this: MzI4YjJiYTdmMjF4MDY3NDZmMmE5NDUyZTEnOTc2ZThwNjc0Yjc0Y1lhMjc0NjViDGM5ZVQwMzBkMTAmMzg1Ng.aHR0cHM6Ly9zdnIxLnN1cGxhLm9yZw==.

Cloud API Limits

It’s important to be aware that the Supla Cloud API has limits on the number of invocations per hour. By default, this limit is set to 2000 requests per hour. If you find that you are exceeding this limit, you may encounter issues with connectivity and data updates.

To monitor your API usage and check your current limits, you can visit SUPLA Cloud. Navigate to Account > Show my limits to see your API invocation details.

If you consistently exceed the 2000 requests per hour limit, you can request an increase from Supla administrators. Alternatively, you can adjust the refresh interval and cache eviction settings in the bridge properties within OpenHAB. By increasing the refresh interval and managing cache settings, you can reduce the frequency of API calls, ensuring you stay within the allowable limits and maintain smooth operation of your smart home system.

Comparison: Native vs. Cloud Approach

Aspect Native Cloud
Request Limits :white_check_mark: None :x: 2000 req/h limit
Response Time :white_check_mark: Faster :x: Slower
Supla Application :x: Not compatible :white_check_mark: Compatible
Online Access :x:/:white_check_mark: None (Can be achieved with myOpenHAB) :white_check_mark: Available
Internet Requirement :white_check_mark: Not required :x: Required

When deciding between a native or cloud approach for integrating Supla devices into your OpenHAB system, consider factors such as request limits, response time, compatibility with Supla applications, online access requirements, and the need for internet connectivity. Choose the approach that best aligns with your smart home setup and preferences.

Support :heart:

If you want to support the author of this binding, buy him a coffee:

ko-fi Postaw mi kawę na buycoffee.to

Resources

supla-1.1.0.jar

openhab-supla Github

1 Like