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.
Certified Devices
This binding has been tested and certified to work with a variety of Supla devices, ensuring reliable performance and seamless integration with your OpenHAB setup. The following devices are officially certified, listed in alphabetical order:
- AURATON Aries (successor to AURATON RTH 8D PRO) is an advanced wireless control strip, for managing underfloor heating actuators. Designed for installation in electrical boxes, it provides a versatile and reliable solution for modern heating systems. With its ability to integrate with other devices, the AURATON Aries is the ideal solution for homes concerned with thermal comfort and energy efficiency. By installing it with AURATON Vela actuators, you ensure a 10-year warranty on the strip!
- Auraton Heat Monitor brings comfort in your home to a new level. The device will ensure that your desired temperature is exactly where you are. This minimalist thermostat was created to be close to you and your loved ones. Available in two versatile colours: white and black.
- Zamel MEW-01 The highest standard of accuracy in electricity consumption monitoring available with tools for advanced data analysis. MEW-01 is designed for DIN-rail (TH35) mounting, occupies a width of two modules and offers the possibility of attaching an external antenna for use also outside the switchgear.
- Zamel ROW-01 belongs to a family of smart home control products via wi-fi. The device uses SUPLA cloud technology. The ROW-01 module allows you to control lighting, turn on and off sockets and electrical appliances using a smartphone or tablet. The ROW-01 extension modules are used both as elements for mounting in under- and surface-mounted installation boxes, and as actuators built directly into the housings of lighting fixtures.
- Zamel ROW-02 controller allows you to control lighting with buttons or switches in bistable mode. In addition, thanks to the built-in wi-fi module, it is possible to remotely manage lighting using a smartphone application. The device informs about the status of the lighting. The user can control the lighting from anywhere in the world. Thanks to the cloud application, it is also possible to automatically start or stop the lighting according to the schedule stored on the cloud.
These devices have been confirmed to work optimally with both the native and cloud-based approaches supported by this binding, providing a smooth and efficient smart home experience. For any additional devices or updates, please refer to the official documentation or the device compatibility section within the binding’s settings.
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:
- Visit the Supla Cloud security page at SUPLA Cloud.
- Create a new personal access token by following the instructions on the page.
- 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 |  None |
 2000 req/h limit |
| Response Time | Faster |
Slower |
| Supla Application | Not compatible |
Compatible |
| Online Access | / None (Can be achieved with myOpenHAB) |
Available |
| Internet Requirement | Not required |
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 
If you want to support the author of this binding, buy him a coffee:
