Skip to content

Latest commit

 

History

History
131 lines (95 loc) · 5.41 KB

README.md

File metadata and controls

131 lines (95 loc) · 5.41 KB

🧩 TECH Controllers integration for Home Assistant

GitHub Release GitHub Activity License

Project Maintenance

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
  • M-9r
  • L-X 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

Warning

Everything else might or might not work - needs community help, testing and reporting back what works. Check below for reported working controllers.

✨ 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 proper test suite for the integration
  • 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. Migration creates new devices, links appropriate entities to them, and removes entities that are no longer provided by the integration.

Caution

⚠️ This is tested only on one controller (M-9r) so please be aware there might be issues ⚠️ In case of problems, 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)
  • L-X WiFi (v1.0.6)

🙏 Thanks

Version 2 of the integration is based on work from several contributors and/or forks of the original integration:

⚠️ Disclaimer

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

📝 Copyright & License

Copyright (c) 2024, Released under the MIT license.