Skip to content
/ tech Public

TECH Controllers integration for Home Assistant

License

Notifications You must be signed in to change notification settings

anarion80/tech

Repository files navigation

🧩 TECH Controllers integration for Home Assistant

GitHub Release GitHub Activity License

Project Maintenance BuyMeCoffee

This is an integration of heating controllers from Polish company TECH Sterowniki Sp. z o.o. It uses API to their web control application eModul.eu, therefore your controller needs to be accessible from the Internet and you need an account either on https://emodul.eu or https://emodul.pl.

The integration is based on API provided by TECH which supports the following controllers:

  • L-4 Wifi
  • L-7
  • L-8
  • WiFi 8S
  • ST-8S WiFi

The integration was developed and tested against eModul demo account (username: test/password: test) which features 4 controllers:

  • I-3
  • L-8
  • Pellet
  • Solar

Additionally, I own M-9r so that is also tested. Everything else might or might not work - needs community help, testing and reporting back what works.

The integration is in no way supported or endorsed by TECH Sterowniki sp. z o.o.

⚠️ Disclaimer

Due to a stall on the original mariusz-ostoja-swierczynski/tech-controllers repo, we have forked. Most of the work was done by Mariusz Ostoja-Świerczyński, for which we're very thankful as the community. It's time to move on, however. New formats of plugins appear, HA goes on with the feature implementation, and as a community we need make sure that this plugin keeps up to the changing world. This repository also draws on work by MichalKrasowski, micles123 and nedyarrd - just putting it all together.

✨ Features

  • Configuration through UI
  • Support for multiple controllers which can be individually imported under given single account
  • Provides Climate entities representing zones
    • and their corresponding Temperature, Battery, Humidity sensors when available
  • Climate entities display data through Thermostat card
  • Provides sensors for eModul 'tiles'
  • Automatic naming and translations of tiles from eModul API

This integration will set up the following platforms.

Platform Description
binary_sensor Show info and status from Tech API.
sensor Show info and status from Tech API.
climate Thermostats.

Tech Thermostat Cards

✏ Plans for development

  • Publish the tech.py Python Package to PyPI
  • Write tests for HA component
  • Support for window opening sensor
  • Support for cold tolerance setting
  • Support for zones schedules
  • Services for pumps, operating mode changes, etc

🏗 Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called tech.
  4. Download all the files from the custom_components/tech/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Tech Controllers"
  8. Enter your username (could be email) and password for your eModule account and click "Submit" button.
  9. In the next step select the controllers you want to import/integrate
  10. You should see "Success!" dialog with the name of the imported controller(s).
  11. Now you should have Climate entities representing your home zones available in Home Assistant. Go to your UI Lovelace configuration and add Thermostat card with your Climate entities.

Tech Controllers Setup 1

Tech Controllers Setup 2

Tech Controllers Setup 3

Tech Controllers Setup 3

Tech Controllers Setup 4

⬆ Migration to version 2

Integration supports migration from version 1 (the original mariusz-ostoja-swierczynski/tech-controllers version). Migration creates new devices, links appropriate entities to them, and removes entities that are no longer provided by the integration. ⚠️ This is tested only on one controller (M-9r) so please be aware there might be issues ⚠️. In case of issues, delete the integration and its entities, restart Home Assistant and add/configure the integration again.

🚀 List of reported working TECH Controllers

  • L4-WiFi (v.1.0.24)
  • L-7 (v.2.0.8)
  • L-7E (v.1.0.6)
  • L-8 (v.3.0.14)
  • L-9r (v1.0.2)
  • WiFi 8S (v.2.1.8)
  • ST-8s WIFI (v.1.0.5)
  • ST-16s WIFI (v.1.0.5)
  • M-9 (v1.0.12)
  • M-9r (v1.3.8)

📝 Copyright & License

Copyright (c) 2024 anarion80 - Released under the MIT license.