homebridge-tesy-heater-mqtt 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,84 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2025-12-15
+
+### Added
+- **Platform plugin architecture** - complete rewrite from Accessory to Platform
+- **Automatic device discovery** - finds all Tesy heaters in your account automatically
+- **Multi-device support** - manages multiple heaters with single configuration
+- Shared MQTT connection for all devices
+- Device name discovery from Tesy Cloud
+- Persistent device caching across restarts
+- Automatic device addition/removal based on account
+- GitHub Actions CI/CD workflows
+- Automated testing on push and PR (Node.js 18, 20, 22, 24)
+- Automated NPM publishing on version tags
+- `.npmignore` file to exclude dev files from package
+- Debug logging for device discovery
+- Support for Node.js v24
+
+### Changed
+- **BREAKING**: Configuration format changed from `accessories` to `platforms`
+- **BREAKING**: No longer requires `device_id` parameter (automatic discovery)
+- Simplified configuration - only credentials needed
+- Updated README with Platform configuration
+- Added setup guide for GitHub Actions
+- Improved logging with per-device context
+- Default pullInterval changed from 10000ms to 60000ms (1 minute)
+- Updated config.schema.json for Platform type with helpful UI
+
+### Fixed
+- Device name retrieval from correct API field (`deviceData.deviceName`)
+- MQTT connection now shared across all devices
+- Better error handling for missing credentials
+
+### Technical
+- Single MQTT connection for all devices (better resource usage)
+- Devices cached by Homebridge (faster startup)
+- Platform meets Homebridge Verified Plugin requirements
+- Cleaner codebase with better separation of concerns
+
+## [0.0.1] - 2025-12-15
+
+### Added
+- Initial release based on homebridge-tesy-heater
+- Support for Tesy API v4
+- MQTT control protocol implementation
+- Real-time device control via MQTT WebSocket
+- Temperature setter and getter
+- On/Off control
+- Current temperature reporting
+- Target temperature configuration
+- Unit tests with ~35% coverage
+- Test scripts for MQTT debugging
+- Support for Homebridge v2.x
+
+### Changed
+- Migrated from Tesy API v3 to v4
+- Replaced REST API control with MQTT
+- Updated configuration for Homebridge v2 compatibility
+- Modernized Node.js compatibility (18.x, 20.x, 22.x)
+
+### Fixed
+- Missing getter for HeatingThresholdTemperature characteristic
+- Device not responding to REST API commands
+- Compatibility issues with latest Homebridge versions
+
+### Technical Details
+- MQTT broker: wss://mqtt.tesy.com:8083/mqtt
+- Command topics: v1/{MAC}/request/{MODEL}/{TOKEN}/{COMMAND}
+- Response topics: v1/{MAC}/response/{MODEL}/{TOKEN}/{COMMAND}
+- Supported commands: onOff, setTemp, setMode
+
+### Tested Devices
+- Tesy CN 06 100 EА CLOUD AS W
+
+[Unreleased]: https://github.com/svjakrm/homebridge-tesy-heater-mqtt/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/svjakrm/homebridge-tesy-heater-mqtt/releases/tag/v0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Original work Copyright (c) 2021 Dobriyan Benov
+Modified work Copyright (c) 2025 Aleksey Molchanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,244 @@
+# homebridge-tesy-heater-mqtt
+
+[![Test](https://github.com/svjakrm/homebridge-tesy-heater-mqtt/actions/workflows/test.yml/badge.svg)](https://github.com/svjakrm/homebridge-tesy-heater-mqtt/actions/workflows/test.yml)
+[![npm version](https://badge.fury.io/js/homebridge-tesy-heater-mqtt.svg)](https://badge.fury.io/js/homebridge-tesy-heater-mqtt)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Homebridge plugin for Tesy heaters using MQTT control (Tesy API v4).
+
+## Overview
+
+This plugin allows you to control your Tesy smart heaters through Apple HomeKit using Homebridge. It uses the latest Tesy API v4 with MQTT for real-time device control.
+
+**Features:**
+- **Automatic device discovery** - finds all Tesy heaters in your account
+- **Multi-device support** - manages multiple heaters with one configuration
+- Turn heater on/off
+- Set target temperature
+- View current temperature
+- View heating status
+- Temperature range configuration
+- Real-time MQTT control
+- Persistent device caching
+
+## Compatibility
+
+This plugin has been tested and confirmed working with:
+- **Tesy CN 06 100 EА CLOUD AS W**
+
+It will most likely work with other **Tesy CN06 series** devices and possibly with other [Tesy FinEco Cloud](https://tesy.bg/produkti/otoplenie-i-grija-za-vyzduha/elektricheski-konvektori/view_group/1) convectors that support the Tesy Cloud v4 API.
+
+If you successfully use this plugin with other Tesy models, please let us know!
+
+## Credits
+
+This project is based on [homebridge-tesy-heater](https://github.com/benov84/homebridge-tesy-heater) by [Dobriyan Benov](https://github.com/benov84). The original plugin was updated to work with Tesy API v4 and MQTT control protocol.
+
+**Major changes from original:**
+- Migrated from Tesy API v3 to API v4
+- Implemented MQTT control for device commands
+- Added `mqtt` dependency for real-time communication
+- Removed obsolete authentication methods
+- Added getter for `HeatingThresholdTemperature` characteristic
+
+## Installation
+
+### Option 1: Install from npm (when published)
+```bash
+npm install -g homebridge-tesy-heater-mqtt
+```
+
+### Option 2: Install from GitHub
+```bash
+npm install -g https://github.com/svjakrm/homebridge-tesy-heater-mqtt.git
+```
+
+### Option 3: Manual installation
+```bash
+git clone https://github.com/svjakrm/homebridge-tesy-heater-mqtt.git
+cd homebridge-tesy-heater-mqtt
+npm install -g .
+```
+
+## Configuration
+
+Add this platform to your Homebridge `config.json`:
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "TesyHeater",
+      "name": "TesyHeater",
+      "userid": "YOUR_USER_ID",
+      "username": "your.email@example.com",
+      "password": "your_password",
+      "maxTemp": 30,
+      "minTemp": 10,
+      "pullInterval": 60000
+    }
+  ]
+}
+```
+
+**Note:** The plugin will **automatically discover** all Tesy heaters linked to your account. No need to specify device IDs!
+
+### Configuration Parameters
+
+| Parameter | Required | Description | Default |
+|-----------|----------|-------------|---------|
+| `platform` | **Yes** | Must be `TesyHeater` | - |
+| `name` | **Yes** | Platform name | `TesyHeater` |
+| `userid` | **Yes** | Your Tesy account user ID | - |
+| `username` | **Yes** | Your Tesy account email | - |
+| `password` | **Yes** | Your Tesy account password | - |
+| `maxTemp` | No | Maximum temperature (°C) | `30` |
+| `minTemp` | No | Minimum temperature (°C) | `10` |
+| `pullInterval` | No | Status update interval (ms) | `60000` |
+
+### How to Get Configuration Values
+
+**Get your credentials** (`userid`, `username`, `password`):
+- These are your Tesy Cloud account credentials
+- `userid` can be found in the Tesy Cloud web interface or via API
+- `username` is your email used to log in to Tesy Cloud
+- `password` is your Tesy Cloud password
+
+**To find your User ID**, run this command:
+```bash
+curl -s 'https://ad.mytesy.com/rest/get-my-devices?userEmail=YOUR_EMAIL&userPass=YOUR_PASSWORD&lang=en' | python3 -m json.tool
+```
+
+The response will show your `userid` and all your devices. Example:
+```json
+{
+  "AA:BB:CC:DD:EE:FF": {
+    "deviceName": "Living Room Heater",
+    "token": "abc1234",
+    "state": {
+      "id": 123456,
+      "mac": "AA:BB:CC:DD:EE:FF",
+      "status": "on",
+      "temp": 20,
+      ...
+    }
+  }
+}
+```
+
+**That's it!** The plugin will automatically discover all devices in your account.
+
+## Technical Details
+
+### How it Works
+
+1. **Device Discovery**: Fetches all devices from Tesy API v4 (`/rest/get-my-devices`) on startup
+2. **Status Updates**: Polls device status periodically (default: 60 seconds)
+3. **Device Control**: Single MQTT connection (`wss://mqtt.tesy.com:8083`) shared by all devices
+4. **MQTT Topics**: `v1/{MAC}/request/{MODEL}/{TOKEN}/{COMMAND}`
+5. **Commands**: `onOff` (power), `setTemp` (temperature), `setMode` (heating mode)
+6. **Caching**: Devices persist across Homebridge restarts
+
+### MQTT Protocol
+
+The plugin automatically:
+- Connects to Tesy MQTT broker using shared credentials
+- Retrieves device-specific token and model from API
+- Publishes commands to device-specific MQTT topics
+- Subscribes to response topics for acknowledgments
+
+## Troubleshooting
+
+### Device not responding to commands
+- Check that your device is online in Tesy Cloud app
+- Verify your credentials are correct
+- Check Homebridge logs for MQTT connection errors
+
+### Temperature slider not showing in Home app
+- Make sure you're running the latest version of this plugin
+- Restart Homebridge after updating configuration
+- Remove and re-add the accessory in Home app if needed
+
+### HomeKit shows "No Response"
+- Check your internet connection
+- Verify Homebridge is running
+- Check if device is online in Tesy Cloud
+
+## Development
+
+### Testing MQTT Commands
+
+Test scripts are included in the repository:
+
+```bash
+# Test connection and monitor messages
+node test-mqtt.js
+
+# Test on/off control
+node test-mqtt-control.js
+
+# Test temperature setting
+node test-mqtt-temp.js
+```
+
+### Unit Tests
+
+The plugin includes unit tests for core functionality:
+
+```bash
+# Run tests
+npm test
+
+# Run tests with coverage report
+npm run test:coverage
+```
+
+Tests cover:
+- MQTT connection and initialization
+- Command formatting and sending
+- Device control (on/off, temperature)
+- Error handling
+- Configuration validation
+
+## Support
+
+If you find this plugin useful, consider supporting:
+
+[![Revolut](https://img.shields.io/badge/Revolut-Support-blue)](https://revolut.me/molchaoxez)
+
+## License
+
+MIT License
+
+Original work Copyright (c) 2021 Dobriyan Benov
+Modified work Copyright (c) 2025 Aleksey Molchanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Contributing
+
+Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
+
+## Links
+
+- [GitHub Repository](https://github.com/svjakrm/homebridge-tesy-heater-mqtt)
+- [Original Plugin](https://github.com/benov84/homebridge-tesy-heater)
+- [Homebridge](https://github.com/homebridge/homebridge)
+- [Tesy Cloud](https://v4.mytesy.com)
+- [Tesy FinEco Cloud Convectors](https://tesy.bg/produkti/otoplenie-i-grija-za-vyzduha/elektricheski-konvektori/view_group/1)

package/config.schema.json

@@ -0,0 +1,113 @@
+{
+  "pluginAlias": "TesyHeater",
+  "pluginType": "platform",
+  "singular": true,
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Platform Name",
+        "type": "string",
+        "default": "TesyHeater",
+        "required": true
+      },
+      "userid": {
+        "title": "Tesy Cloud User ID",
+        "type": "string",
+        "required": true,
+        "description": "Your Tesy Cloud account user ID (numeric)"
+      },
+      "username": {
+        "title": "Tesy Cloud Email",
+        "type": "string",
+        "required": true,
+        "format": "email",
+        "description": "Your Tesy Cloud account email address"
+      },
+      "password": {
+        "title": "Tesy Cloud Password",
+        "type": "string",
+        "required": true,
+        "description": "Your Tesy Cloud account password"
+      },
+      "maxTemp": {
+        "title": "Maximum Temperature (°C)",
+        "type": "integer",
+        "default": 30,
+        "minimum": 10,
+        "maximum": 40,
+        "description": "Maximum temperature limit for all heaters"
+      },
+      "minTemp": {
+        "title": "Minimum Temperature (°C)",
+        "type": "integer",
+        "default": 10,
+        "minimum": 5,
+        "maximum": 25,
+        "description": "Minimum temperature limit for all heaters"
+      },
+      "pullInterval": {
+        "title": "Status Update Interval (ms)",
+        "type": "integer",
+        "default": 60000,
+        "minimum": 30000,
+        "maximum": 300000,
+        "description": "How often to poll device status (in milliseconds). Default: 60000 (1 minute)"
+      }
+    }
+  },
+  "layout": [
+    {
+      "type": "help",
+      "helpvalue": "<h5>Tesy Heater Platform</h5><p>This plugin will <strong>automatically discover</strong> all Tesy heaters linked to your Tesy Cloud account. Simply enter your credentials below and restart Homebridge.</p>"
+    },
+    "name",
+    {
+      "type": "section",
+      "title": "Tesy Cloud Credentials",
+      "expandable": true,
+      "expanded": true,
+      "items": [
+        {
+          "key": "userid",
+          "type": "string",
+          "placeholder": "27356"
+        },
+        {
+          "key": "username",
+          "type": "string",
+          "placeholder": "your.email@example.com"
+        },
+        {
+          "key": "password",
+          "type": "string",
+          "placeholder": "Your password"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "title": "Advanced Settings",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        {
+          "key": "maxTemp",
+          "type": "number"
+        },
+        {
+          "key": "minTemp",
+          "type": "number"
+        },
+        {
+          "key": "pullInterval",
+          "type": "number"
+        }
+      ]
+    },
+    {
+      "type": "help",
+      "helpvalue": "<p><strong>How to find your User ID:</strong></p><ol><li>Log in to <a href='https://v4.mytesy.com' target='_blank'>Tesy Cloud</a></li><li>Check the browser URL or use the API to retrieve your user ID</li><li>Or run: <code>curl 'https://ad.mytesy.com/rest/get-my-devices?userEmail=YOUR_EMAIL&userPass=YOUR_PASSWORD&lang=en'</code></li></ol>"
+    }
+  ]
+}

package/index.js

@@ -0,0 +1,537 @@
+var Service, Characteristic, API;
+const mqtt = require('mqtt');
+const request = require('request');
+const querystring = require('querystring');
+
+module.exports = function(homebridge) {
+  Service = homebridge.hap.Service;
+  Characteristic = homebridge.hap.Characteristic;
+  API = homebridge;
+
+  homebridge.registerPlatform("homebridge-tesy-heater-mqtt", "TesyHeater", TesyHeaterPlatform, true);
+};
+
+class TesyHeaterPlatform {
+  constructor(log, config, api) {
+    this.log = log;
+    this.config = config || {};
+    this.api = api;
+
+    this.accessories = [];
+    this.devices = {};
+    this.mqttClient = null;
+
+    // Configuration
+    this.userid = this.config.userid;
+    this.username = this.config.username;
+    this.password = this.config.password;
+    this.pullInterval = this.config.pullInterval || 60000;
+    this.maxTemp = this.config.maxTemp || 30;
+    this.minTemp = this.config.minTemp || 10;
+
+    if (!this.userid || !this.username || !this.password) {
+      this.log.error("Missing required credentials (userid, username, password) in config!");
+      return;
+    }
+
+    this.log.info("TesyHeater Platform Plugin Loaded");
+
+    if (api) {
+      this.api.on('didFinishLaunching', () => {
+        this.log.info("Homebridge finished launching, discovering devices...");
+        this.discoverDevices();
+      });
+    }
+  }
+
+  configureAccessory(accessory) {
+    this.log.info("Configuring cached accessory:", accessory.displayName);
+
+    accessory.reachable = true;
+    this.accessories.push(accessory);
+  }
+
+  discoverDevices() {
+    this.log.info("Fetching devices from Tesy Cloud...");
+
+    const queryParams = querystring.stringify({
+      'userID': parseInt(this.userid),
+      'userEmail': this.username,
+      'userPass': this.password,
+      'lang': 'en'
+    });
+
+    const options = {
+      'method': 'GET',
+      'url': 'https://ad.mytesy.com/rest/get-my-devices?' + queryParams
+    };
+
+    request(options, (error, response) => {
+      if (error) {
+        this.log.error("API Error:", error);
+        return;
+      }
+
+      try {
+        const data = JSON.parse(response.body);
+
+        if (!data || Object.keys(data).length === 0) {
+          this.log.warn("No devices found in your Tesy Cloud account");
+          return;
+        }
+
+        this.log.info("Found %d device(s) in your account", Object.keys(data).length);
+
+        // Initialize MQTT connection once before adding devices
+        this.initMQTT();
+
+        // Add each device
+        for (const mac in data) {
+          const deviceData = data[mac];
+          const state = deviceData.state;
+
+          if (!state || !state.id) {
+            this.log.warn("Skipping device with MAC %s - missing state data", mac);
+            continue;
+          }
+
+          // Try to get device name from various possible fields
+          const deviceName = state.deviceName ||
+                            state.name ||
+                            deviceData.deviceName ||
+                            deviceData.name ||
+                            `Tesy Heater ${state.id}`;
+
+          this.log.debug("Device data for %s:", mac, JSON.stringify({
+            'state.deviceName': state.deviceName,
+            'state.name': state.name,
+            'deviceData.deviceName': deviceData.deviceName,
+            'deviceData.name': deviceData.name,
+            'using': deviceName
+          }));
+
+          this.addDevice({
+            id: state.id.toString(),
+            mac: mac,
+            token: deviceData.token,
+            model: deviceData.model || 'cn05uv',
+            name: deviceName,
+            state: state
+          });
+        }
+
+        // Remove devices that are no longer in account
+        this.removeOldDevices(data);
+
+        // Start status polling
+        this.startPolling();
+
+      } catch(e) {
+        this.log.error("Error parsing device data:", e);
+      }
+    });
+  }
+
+  addDevice(deviceInfo) {
+    const uuid = this.api.hap.uuid.generate('tesy-' + deviceInfo.id);
+    let accessory = this.accessories.find(acc => acc.UUID === uuid);
+
+    if (accessory) {
+      this.log.info("Restoring existing accessory:", deviceInfo.name);
+
+      // Always update name to ensure HomeKit has the latest value
+      if (accessory.displayName !== deviceInfo.name) {
+        this.log.info("Updating accessory name from '%s' to '%s'", accessory.displayName, deviceInfo.name);
+      }
+
+      // Update displayName
+      accessory.displayName = deviceInfo.name;
+
+      // Update context
+      accessory.context.deviceInfo = deviceInfo;
+
+      // Update AccessoryInformation service name
+      const infoService = accessory.getService(Service.AccessoryInformation);
+      if (infoService) {
+        infoService.setCharacteristic(Characteristic.Name, deviceInfo.name);
+      }
+
+      // Update HeaterCooler service name
+      const service = accessory.getService(Service.HeaterCooler);
+      if (service) {
+        service.setCharacteristic(Characteristic.Name, deviceInfo.name);
+        service.displayName = deviceInfo.name;
+      }
+
+      // Also update the internal HAP accessory displayName
+      if (accessory._associatedHAPAccessory) {
+        accessory._associatedHAPAccessory.displayName = deviceInfo.name;
+      }
+
+      this.api.updatePlatformAccessories([accessory]);
+    } else {
+      this.log.info("Adding new accessory:", deviceInfo.name);
+      accessory = new this.api.platformAccessory(deviceInfo.name, uuid);
+      accessory.context.deviceInfo = deviceInfo;
+
+      this.accessories.push(accessory);
+      this.api.registerPlatformAccessories("homebridge-tesy-heater-mqtt", "TesyHeater", [accessory]);
+    }
+
+    // Setup accessory
+    this.setupAccessory(accessory);
+
+    // Store device reference
+    this.devices[deviceInfo.id] = {
+      accessory: accessory,
+      info: deviceInfo
+    };
+  }
+
+  removeOldDevices(currentData) {
+    const currentDeviceIds = Object.values(currentData)
+      .filter(d => d.state && d.state.id)
+      .map(d => d.state.id.toString());
+
+    const accessoriesToRemove = this.accessories.filter(acc => {
+      if (!acc.context.deviceInfo) return false;
+      return !currentDeviceIds.includes(acc.context.deviceInfo.id);
+    });
+
+    if (accessoriesToRemove.length > 0) {
+      this.log.info("Removing %d device(s) that are no longer in account", accessoriesToRemove.length);
+      this.api.unregisterPlatformAccessories("homebridge-tesy-heater-mqtt", "TesyHeater", accessoriesToRemove);
+
+      accessoriesToRemove.forEach(acc => {
+        const index = this.accessories.indexOf(acc);
+        if (index > -1) {
+          this.accessories.splice(index, 1);
+        }
+
+        if (acc.context.deviceInfo) {
+          delete this.devices[acc.context.deviceInfo.id];
+        }
+      });
+    }
+  }
+
+  setupAccessory(accessory) {
+    const deviceInfo = accessory.context.deviceInfo;
+
+    // Information Service
+    const informationService = accessory.getService(Service.AccessoryInformation) ||
+                               accessory.addService(Service.AccessoryInformation);
+
+    informationService
+      .setCharacteristic(Characteristic.Manufacturer, 'Tesy')
+      .setCharacteristic(Characteristic.Model, deviceInfo.model || 'Convector')
+      .setCharacteristic(Characteristic.SerialNumber, deviceInfo.id);
+
+    // HeaterCooler Service
+    let service = accessory.getService(Service.HeaterCooler);
+    if (!service) {
+      service = accessory.addService(Service.HeaterCooler, deviceInfo.name);
+    }
+
+    // Configure characteristics
+    service.getCharacteristic(Characteristic.Active)
+      .on('get', this.getActive.bind(this, deviceInfo))
+      .on('set', this.setActive.bind(this, deviceInfo));
+
+    service.getCharacteristic(Characteristic.CurrentHeaterCoolerState)
+      .updateValue(Characteristic.CurrentHeaterCoolerState.INACTIVE);
+
+    service.getCharacteristic(Characteristic.TargetHeaterCoolerState)
+      .on('get', callback => callback(null, Characteristic.TargetHeaterCoolerState.HEAT))
+      .setProps({
+        validValues: [Characteristic.TargetHeaterCoolerState.HEAT]
+      });
+
+    service.getCharacteristic(Characteristic.CurrentTemperature)
+      .on('get', this.getCurrentTemperature.bind(this, deviceInfo))
+      .setProps({ minStep: 0.1 });
+
+    service.getCharacteristic(Characteristic.HeatingThresholdTemperature)
+      .on('get', this.getHeatingThresholdTemperature.bind(this, deviceInfo))
+      .on('set', this.setHeatingThresholdTemperature.bind(this, deviceInfo))
+      .setProps({
+        minValue: this.minTemp,
+        maxValue: this.maxTemp,
+        minStep: 0.5
+      });
+
+    // Cooling threshold (for HomeKit UI)
+    service.getCharacteristic(Characteristic.CoolingThresholdTemperature)
+      .setProps({
+        minValue: this.minTemp,
+        maxValue: this.maxTemp,
+        minStep: 0.5
+      })
+      .updateValue(this.minTemp);
+  }
+
+  initMQTT() {
+    if (this.mqttClient) {
+      this.log.debug("MQTT client already initialized");
+      return;
+    }
+
+    this.log.info("Initializing MQTT connection...");
+
+    this.mqttClient = mqtt.connect('wss://mqtt.tesy.com:8083/mqtt', {
+      username: 'client1',
+      password: '123',
+      clientId: 'mqttjs_' + Math.random().toString(16).substr(2, 8),
+      protocol: 'wss',
+      reconnectPeriod: 5000,
+    });
+
+    this.mqttClient.on('connect', () => {
+      this.log.info("✓ Connected to MQTT broker");
+
+      // Subscribe to all device response topics
+      Object.values(this.devices).forEach(device => {
+        const info = device.info;
+        const responseTopic = `v1/${info.mac}/response/${info.model}/${info.token}/#`;
+        this.mqttClient.subscribe(responseTopic, (err) => {
+          if (err) {
+            this.log.error("MQTT subscribe error for %s:", info.name, err);
+          } else {
+            this.log.debug("✓ Subscribed to MQTT topic for %s", info.name);
+          }
+        });
+      });
+    });
+
+    this.mqttClient.on('error', (error) => {
+      this.log.error("MQTT Error:", error);
+    });
+
+    this.mqttClient.on('close', () => {
+      this.log.warn("MQTT connection closed");
+    });
+
+    this.mqttClient.on('offline', () => {
+      this.log.warn("MQTT client offline");
+    });
+  }
+
+  sendMQTTCommand(deviceInfo, command, payload, callback) {
+    if (!this.mqttClient || !this.mqttClient.connected) {
+      this.log.error("MQTT not connected");
+      return callback(new Error("MQTT not connected"));
+    }
+
+    const topic = `v1/${deviceInfo.mac}/request/${deviceInfo.model}/${deviceInfo.token}/${command}`;
+    const message = {
+      app_id: 'hb' + Math.random().toString(16).substr(2, 7),
+      ...payload
+    };
+
+    this.log.debug("Sending MQTT command to %s: %s", deviceInfo.name, command);
+
+    this.mqttClient.publish(topic, JSON.stringify(message), (err) => {
+      if (err) {
+        this.log.error("MQTT publish error:", err);
+        callback(err);
+      } else {
+        callback(null);
+      }
+    });
+  }
+
+  fetchDeviceStatus(deviceInfo, callback) {
+    const queryParams = querystring.stringify({
+      'userID': parseInt(this.userid),
+      'userEmail': this.username,
+      'userPass': this.password,
+      'lang': 'en'
+    });
+
+    const options = {
+      'method': 'GET',
+      'url': 'https://ad.mytesy.com/rest/get-my-devices?' + queryParams
+    };
+
+    request(options, (error, response) => {
+      if (error) {
+        return callback(error, null);
+      }
+
+      try {
+        const data = JSON.parse(response.body);
+        const deviceData = data[deviceInfo.mac];
+
+        if (!deviceData || !deviceData.state) {
+          return callback(new Error("Device not found"), null);
+        }
+
+        callback(null, deviceData.state);
+      } catch(e) {
+        callback(e, null);
+      }
+    });
+  }
+
+  startPolling() {
+    if (this.pollingInterval) {
+      clearInterval(this.pollingInterval);
+    }
+
+    this.log.info("Starting status polling every %d ms", this.pullInterval);
+
+    this.pollingInterval = setInterval(() => {
+      this.updateAllDevices();
+    }, this.pullInterval);
+
+    // Initial update
+    this.updateAllDevices();
+  }
+
+  updateAllDevices() {
+    Object.values(this.devices).forEach(device => {
+      this.fetchDeviceStatus(device.info, (error, status) => {
+        if (error) {
+          this.log.error("Error fetching status for %s:", device.info.name, error);
+          return;
+        }
+
+        this.updateAccessoryStatus(device.accessory, status);
+      });
+    });
+  }
+
+  updateAccessoryStatus(accessory, status) {
+    const service = accessory.getService(Service.HeaterCooler);
+    if (!service) return;
+
+    try {
+      // Update current temperature
+      const currentTemp = parseFloat(status.current_temp);
+      if (!isNaN(currentTemp) && currentTemp >= this.minTemp && currentTemp <= this.maxTemp) {
+        const oldTemp = service.getCharacteristic(Characteristic.CurrentTemperature).value;
+        if (currentTemp !== oldTemp) {
+          service.getCharacteristic(Characteristic.CurrentTemperature).updateValue(currentTemp);
+          this.log.debug("%s: CurrentTemperature %s -> %s", accessory.displayName, oldTemp, currentTemp);
+        }
+      }
+
+      // Update target temperature
+      const targetTemp = parseFloat(status.temp);
+      if (!isNaN(targetTemp) && targetTemp >= this.minTemp && targetTemp <= this.maxTemp) {
+        const oldTarget = service.getCharacteristic(Characteristic.HeatingThresholdTemperature).value;
+        if (targetTemp !== oldTarget) {
+          service.getCharacteristic(Characteristic.HeatingThresholdTemperature).updateValue(targetTemp);
+          this.log.debug("%s: HeatingThresholdTemperature %s -> %s", accessory.displayName, oldTarget, targetTemp);
+        }
+      }
+
+      // Update active status
+      const isActive = status.status.toLowerCase() === 'on' ?
+                       Characteristic.Active.ACTIVE :
+                       Characteristic.Active.INACTIVE;
+      const oldActive = service.getCharacteristic(Characteristic.Active).value;
+      if (isActive !== oldActive) {
+        service.getCharacteristic(Characteristic.Active).updateValue(isActive);
+        this.log.info("%s: Active %s -> %s", accessory.displayName, oldActive ? 'ON' : 'OFF', isActive ? 'ON' : 'OFF');
+      }
+
+      // Update heating state
+      const isHeating = status.heating === 'on';
+      const heatingState = isHeating ?
+                          Characteristic.CurrentHeaterCoolerState.HEATING :
+                          Characteristic.CurrentHeaterCoolerState.IDLE;
+      const oldState = service.getCharacteristic(Characteristic.CurrentHeaterCoolerState).value;
+      if (heatingState !== oldState) {
+        service.getCharacteristic(Characteristic.CurrentHeaterCoolerState).updateValue(heatingState);
+        this.log.debug("%s: Heating state %s -> %s", accessory.displayName, oldState, heatingState);
+      }
+    } catch(e) {
+      this.log.error("Error updating %s status:", accessory.displayName, e);
+    }
+  }
+
+  // Characteristic Handlers
+
+  getActive(deviceInfo, callback) {
+    this.fetchDeviceStatus(deviceInfo, (error, status) => {
+      if (error) {
+        return callback(error);
+      }
+
+      const isActive = status.status.toLowerCase() === 'on' ?
+                       Characteristic.Active.ACTIVE :
+                       Characteristic.Active.INACTIVE;
+      callback(null, isActive);
+    });
+  }
+
+  setActive(deviceInfo, value, callback) {
+    const newValue = value === 0 ? 'off' : 'on';
+    this.log.info("%s: Setting active to %s", deviceInfo.name, newValue);
+
+    this.sendMQTTCommand(deviceInfo, 'onOff', { status: newValue }, (error) => {
+      if (error) {
+        this.log.error("%s: Error setting active status:", deviceInfo.name, error);
+        return callback(error);
+      }
+
+      this.log.info("%s: ✓ Active status changed to %s", deviceInfo.name, newValue);
+      callback(null);
+    });
+  }
+
+  getCurrentTemperature(deviceInfo, callback) {
+    this.fetchDeviceStatus(deviceInfo, (error, status) => {
+      if (error) {
+        return callback(error);
+      }
+
+      const currentTemp = parseFloat(status.current_temp);
+      callback(null, currentTemp);
+    });
+  }
+
+  getHeatingThresholdTemperature(deviceInfo, callback) {
+    this.fetchDeviceStatus(deviceInfo, (error, status) => {
+      if (error) {
+        return callback(error);
+      }
+
+      const targetTemp = parseFloat(status.temp);
+      callback(null, targetTemp);
+    });
+  }
+
+  setHeatingThresholdTemperature(deviceInfo, value, callback) {
+    // Clamp value
+    if (value < this.minTemp) value = this.minTemp;
+    if (value > this.maxTemp) value = this.maxTemp;
+
+    this.log.info("%s: Setting target temperature to %s°C", deviceInfo.name, value);
+
+    // First set mode to manual
+    this.sendMQTTCommand(deviceInfo, 'setMode', { mode: 'manual' }, (error) => {
+      if (error) {
+        this.log.error("%s: Error setting mode to manual:", deviceInfo.name, error);
+        return callback(error);
+      }
+
+      this.log.debug("%s: ✓ Mode set to manual", deviceInfo.name);
+
+      // Then set temperature
+      this.sendMQTTCommand(deviceInfo, 'setTemp', { temp: value }, (error) => {
+        if (error) {
+          this.log.error("%s: Error setting temperature:", deviceInfo.name, error);
+          return callback(error);
+        }
+
+        this.log.info("%s: ✓ Temperature set to %s°C", deviceInfo.name, value);
+        callback(null);
+      });
+    });
+  }
+}
+
+// Export for testing
+module.exports.TesyHeaterPlatform = TesyHeaterPlatform;

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "homebridge-tesy-heater-mqtt",
+  "displayName": "Homebridge Tesy Heater MQTT",
+  "version": "1.0.0",
+  "description": "Tesy heater plugin for Homebridge using MQTT control (API v4). Supports on/off control and temperature adjustment.",
+  "license": "MIT",
+  "keywords": [
+    "homebridge-plugin",
+    "tesy",
+    "heater",
+    "convector",
+    "mqtt",
+    "smart-home",
+    "homekit"
+  ],
+  "engines": {
+    "node": "^18.20.4 || ^20.15.1 || ^22 || ^24",
+    "homebridge": "^1.6.0 || ^2.0.0"
+  },
+  "author": {
+    "name": "Aleksey Molchanov",
+    "email": "molchanov.alex@gmail.com"
+  },
+  "contributors": [
+    {
+      "name": "Dobriyan Benov",
+      "url": "https://github.com/benov84/homebridge-tesy-heater"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/svjakrm/homebridge-tesy-heater-mqtt.git"
+  },
+  "dependencies": {
+    "homebridge-http-base": "2.1.6",
+    "mqtt": "^5.14.1",
+    "request": "^2.65.0"
+  },
+  "bugs": {
+    "url": "https://github.com/svjakrm/homebridge-tesy-heater-mqtt/issues"
+  },
+  "homepage": "https://github.com/svjakrm/homebridge-tesy-heater-mqtt#readme",
+  "main": "index.js",
+  "scripts": {
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  },
+  "funding": [
+    {
+      "type": "revolut",
+      "url": "https://revolut.me/molchaoxez"
+    }
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0"
+  }
+}