iobroker.homewizard 0.3.0 → 0.3.2

package/README.md

@@ -51,14 +51,34 @@ Real-time energy monitoring from HomeWizard devices via API v2 with WebSocket pu
 
 ## Configuration
 
-Devices are added via the **pairing mode**, not manually:
+### Prerequisites
 
-1. Open the **Objects** tab in ioBroker Admin
+The **local API** must be enabled on your HomeWizard device:
+
+1. Open the **HomeWizard app** on your phone
+2. Go to **Settings** > **Meters** > select your device > **Local API** > **Enable**
+
+### Adding a device (automatic via mDNS)
+
+1. Go to the **Objects** tab in ioBroker Admin
 2. Set `homewizard.0.startPairing` to `true`
 3. **Press the physical button** on your HomeWizard device within 60 seconds
-4. The device is discovered automatically and appears in the adapter settings
+4. The device is discovered automatically and appears under `homewizard.0`
 
-The Admin UI shows all paired devices. You can update the IP address if a device gets a new one.
+### Adding a device (manual IP)
+
+If mDNS is not available (e.g. different VLAN, Docker, or firewall blocking multicast):
+
+1. Set `homewizard.0.pairingIp` to the IP address of your device
+2. Set `homewizard.0.startPairing` to `true`
+3. **Press the physical button** on the device within 60 seconds
+
+### Managing devices
+
+All paired devices are listed in the **Objects** tab under `homewizard.0`. Each device has its own folder (e.g. `hwe-p1_5c2fafaabbcc`) with measurement data, system settings, and device info.
+
+- **Remove a device:** Set its `remove` data point to `true` — the device and all data points are deleted immediately
+- **IP changes:** Handled automatically via mDNS. No manual action needed
 
 ---
 
@@ -134,6 +154,12 @@ homewizard.0.
 
 ## Changelog
 
+### 0.3.2 (2026-04-05)
+- Improve Admin UI and README with detailed configuration guide
+
+### 0.3.1 (2026-04-05)
+- Fix uncaught exception on device removal (invalid WebSocket frame during close)
+
 ### 0.3.0 (2026-04-05)
 - Store device config in device objects (no adapter restart on pairing/remove)
 - Fix datapoint issues (startPairing, pairingIp, button states)

package/admin/i18n/de/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Kopplung",
-  "pairingInfo": "Um ein neues Gerät hinzuzufügen: Setze den Datenpunkt 'startPairing' im Objekte-Tab auf true und drücke dann innerhalb von 60 Sekunden den physischen Knopf am HomeWizard-Gerät. Das Gerät wird automatisch per mDNS erkannt. Für Netzwerke ohne mDNS setze vorher 'pairingIp'.",
-  "headerDevices": "Geräte",
-  "devicesInfo": "Gekoppelte Geräte werden im Objekte-Tab unter dieser Adapterinstanz angezeigt. Jedes Gerät hat Info-, System- und Messwert-Datenpunkte. Um ein Gerät zu entfernen, setze dessen 'remove'-Datenpunkt auf true.",
+  "headerPairing": "Gerät hinzufügen",
+  "pairingAutoHeader": "Automatisch (mDNS)",
+  "pairingAutoInfo": "1. Gehe zum Objekte-Tab und setze 'homewizard.0.startPairing' auf true.\n2. Drücke innerhalb von 60 Sekunden den physischen Knopf am HomeWizard-Gerät.\n3. Das Gerät wird automatisch erkannt und erscheint unter dieser Adapterinstanz.",
+  "pairingManualHeader": "Manuell (feste IP)",
+  "pairingManualInfo": "Falls mDNS nicht verfügbar ist (z.B. anderes VLAN oder Docker):\n1. Setze 'homewizard.0.pairingIp' auf die IP-Adresse des Geräts.\n2. Setze dann 'homewizard.0.startPairing' auf true.\n3. Drücke innerhalb von 60 Sekunden den physischen Knopf am Gerät.",
+  "headerDevices": "Geräte verwalten",
+  "devicesInfo": "Alle gekoppelten Geräte sind im Objekte-Tab unter 'homewizard.0' aufgelistet. Jedes Gerät hat einen eigenen Ordner (z.B. hwe-p1_5c2fafaabbcc) mit Messdaten, Systemeinstellungen und Geräteinformationen.\n\nUm ein Gerät zu entfernen, setze dessen 'remove'-Datenpunkt auf true. Das Gerät und alle zugehörigen Datenpunkte werden sofort gelöscht.",
+  "headerPrerequisites": "Voraussetzungen",
+  "prerequisitesInfo": "Die lokale API muss am HomeWizard-Gerät aktiviert sein. Öffne die HomeWizard-App → Einstellungen → Messgeräte → dein Gerät → Lokale API → Aktivieren.",
   "supportHeader": "Unterstützung",
   "aboutInfo": "Dieser Adapter ist kostenlos und Open Source. Wenn er dir nützlich ist, erwäge die Entwicklung zu unterstützen:",
   "donateKofi": "Ko-fi",

package/admin/i18n/en/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Pairing",
-  "pairingInfo": "To add a new device: Set the 'startPairing' data point to true in the Objects tab, then press the physical button on your HomeWizard device within 60 seconds. The device will be discovered automatically via mDNS. For networks without mDNS, set 'pairingIp' first.",
-  "headerDevices": "Devices",
-  "devicesInfo": "Paired devices are shown in the Objects tab under this adapter instance. Each device has info, system, and measurement states. To remove a device, set its 'remove' data point to true.",
+  "headerPairing": "Add Device",
+  "pairingAutoHeader": "Automatic (mDNS)",
+  "pairingAutoInfo": "1. Go to the Objects tab and set 'homewizard.0.startPairing' to true.\n2. Press the physical button on your HomeWizard device within 60 seconds.\n3. The device is discovered automatically and appears under this adapter instance.",
+  "pairingManualHeader": "Manual (fixed IP)",
+  "pairingManualInfo": "If mDNS is not available (e.g. different VLAN or Docker):\n1. Set 'homewizard.0.pairingIp' to the IP address of your device.\n2. Then set 'homewizard.0.startPairing' to true.\n3. Press the physical button on the device within 60 seconds.",
+  "headerDevices": "Manage Devices",
+  "devicesInfo": "All paired devices are listed in the Objects tab under 'homewizard.0'. Each device has its own folder (e.g. hwe-p1_5c2fafaabbcc) with measurement data, system settings, and device info.\n\nTo remove a device, set its 'remove' data point to true. The device and all its data points will be deleted immediately.",
+  "headerPrerequisites": "Prerequisites",
+  "prerequisitesInfo": "The local API must be enabled on your HomeWizard device. Open the HomeWizard app → Settings → Meters → your device → Local API → Enable.",
   "supportHeader": "Support",
   "aboutInfo": "This adapter is free and open source. If you find it useful, consider supporting the development:",
   "donateKofi": "Ko-fi",

package/admin/i18n/es/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Emparejamiento",
-  "pairingInfo": "Para añadir un dispositivo: establece el punto de datos 'startPairing' en true en la pestaña Objetos y luego presiona el botón físico en tu dispositivo HomeWizard dentro de 60 segundos. El dispositivo se descubrirá automáticamente por mDNS. Para redes sin mDNS, establece primero 'pairingIp'.",
-  "headerDevices": "Dispositivos",
-  "devicesInfo": "Los dispositivos emparejados se muestran en la pestaña Objetos bajo esta instancia del adaptador. Cada dispositivo tiene puntos de datos de información, sistema y medición. Para eliminar un dispositivo, establece su punto de datos 'remove' en true.",
+  "headerPairing": "Agregar dispositivo",
+  "pairingAutoHeader": "Automático (mDNS)",
+  "pairingAutoInfo": "1. Ve a la pestaña Objetos y establece 'homewizard.0.startPairing' en true.\n2. Presiona el botón físico en tu dispositivo HomeWizard dentro de 60 segundos.\n3. El dispositivo se descubre automáticamente y aparece bajo esta instancia del adaptador.",
+  "pairingManualHeader": "Manual (IP fija)",
+  "pairingManualInfo": "Si mDNS no está disponible (ej.: VLAN diferente o Docker):\n1. Establece 'homewizard.0.pairingIp' en la dirección IP del dispositivo.\n2. Luego establece 'homewizard.0.startPairing' en true.\n3. Presiona el botón físico en el dispositivo dentro de 60 segundos.",
+  "headerDevices": "Gestionar dispositivos",
+  "devicesInfo": "Todos los dispositivos emparejados están listados en la pestaña Objetos bajo 'homewizard.0'. Cada dispositivo tiene su propia carpeta (ej.: hwe-p1_5c2fafaabbcc) con datos de medición, configuraciones del sistema e información del dispositivo.\n\nPara eliminar un dispositivo, establece su punto de datos 'remove' en true. El dispositivo y todos sus puntos de datos se eliminarán inmediatamente.",
+  "headerPrerequisites": "Requisitos previos",
+  "prerequisitesInfo": "La API local debe estar activada en tu dispositivo HomeWizard. Abre la app HomeWizard → Configuración → Medidores → tu dispositivo → API Local → Activar.",
   "supportHeader": "Apoyo",
   "aboutInfo": "Este adaptador es gratuito y de código abierto. Si te resulta útil, considera apoyar el desarrollo:",
   "donateKofi": "Ko-fi",

package/admin/i18n/fr/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Appairage",
-  "pairingInfo": "Pour ajouter un appareil : définissez le point de données 'startPairing' sur true dans l'onglet Objets, puis appuyez sur le bouton physique de votre appareil HomeWizard dans les 60 secondes. L'appareil sera découvert automatiquement par mDNS. Pour les réseaux sans mDNS, définissez d'abord 'pairingIp'.",
-  "headerDevices": "Appareils",
-  "devicesInfo": "Les appareils appairés sont affichés dans l'onglet Objets sous cette instance d'adaptateur. Chaque appareil possède des points de données pour les informations, le système et les mesures. Pour supprimer un appareil, définissez son point de données 'remove' sur true.",
+  "headerPairing": "Ajouter un appareil",
+  "pairingAutoHeader": "Automatique (mDNS)",
+  "pairingAutoInfo": "1. Allez dans l'onglet Objets et définissez 'homewizard.0.startPairing' sur true.\n2. Appuyez sur le bouton physique de votre appareil HomeWizard dans les 60 secondes.\n3. L'appareil est découvert automatiquement et apparaît sous cette instance d'adaptateur.",
+  "pairingManualHeader": "Manuel (IP fixe)",
+  "pairingManualInfo": "Si mDNS n'est pas disponible (ex. : VLAN différent ou Docker) :\n1. Définissez 'homewizard.0.pairingIp' sur l'adresse IP de l'appareil.\n2. Puis définissez 'homewizard.0.startPairing' sur true.\n3. Appuyez sur le bouton physique de l'appareil dans les 60 secondes.",
+  "headerDevices": "Gérer les appareils",
+  "devicesInfo": "Tous les appareils appairés sont listés dans l'onglet Objets sous 'homewizard.0'. Chaque appareil a son propre dossier (ex. : hwe-p1_5c2fafaabbcc) avec les données de mesure, les paramètres système et les informations de l'appareil.\n\nPour supprimer un appareil, définissez son point de données 'remove' sur true. L'appareil et tous ses points de données seront supprimés immédiatement.",
+  "headerPrerequisites": "Prérequis",
+  "prerequisitesInfo": "L'API locale doit être activée sur votre appareil HomeWizard. Ouvrez l'application HomeWizard → Paramètres → Compteurs → votre appareil → API Locale → Activer.",
   "supportHeader": "Soutien",
   "aboutInfo": "Cet adaptateur est gratuit et open source. Si vous le trouvez utile, envisagez de soutenir le développement :",
   "donateKofi": "Ko-fi",

package/admin/i18n/it/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Associazione",
-  "pairingInfo": "Per aggiungere un dispositivo: imposta il punto dati 'startPairing' su true nella scheda Oggetti, poi premi il pulsante fisico sul dispositivo HomeWizard entro 60 secondi. Il dispositivo verrà scoperto automaticamente tramite mDNS. Per reti senza mDNS, imposta prima 'pairingIp'.",
-  "headerDevices": "Dispositivi",
-  "devicesInfo": "I dispositivi associati sono mostrati nella scheda Oggetti sotto questa istanza dell'adattatore. Ogni dispositivo ha punti dati per informazioni, sistema e misurazioni. Per rimuovere un dispositivo, imposta il suo punto dati 'remove' su true.",
+  "headerPairing": "Aggiungi dispositivo",
+  "pairingAutoHeader": "Automatico (mDNS)",
+  "pairingAutoInfo": "1. Vai alla scheda Oggetti e imposta 'homewizard.0.startPairing' su true.\n2. Premi il pulsante fisico sul dispositivo HomeWizard entro 60 secondi.\n3. Il dispositivo viene scoperto automaticamente e appare sotto questa istanza dell'adattatore.",
+  "pairingManualHeader": "Manuale (IP fisso)",
+  "pairingManualInfo": "Se mDNS non è disponibile (es. VLAN diverso o Docker):\n1. Imposta 'homewizard.0.pairingIp' sull'indirizzo IP del dispositivo.\n2. Poi imposta 'homewizard.0.startPairing' su true.\n3. Premi il pulsante fisico sul dispositivo entro 60 secondi.",
+  "headerDevices": "Gestione dispositivi",
+  "devicesInfo": "Tutti i dispositivi associati sono elencati nella scheda Oggetti sotto 'homewizard.0'. Ogni dispositivo ha la propria cartella (es. hwe-p1_5c2fafaabbcc) con dati di misurazione, impostazioni di sistema e informazioni sul dispositivo.\n\nPer rimuovere un dispositivo, imposta il suo punto dati 'remove' su true. Il dispositivo e tutti i suoi punti dati verranno eliminati immediatamente.",
+  "headerPrerequisites": "Prerequisiti",
+  "prerequisitesInfo": "L'API locale deve essere attivata sul dispositivo HomeWizard. Apri l'app HomeWizard → Impostazioni → Contatori → il tuo dispositivo → API Locale → Attiva.",
   "supportHeader": "Supporto",
   "aboutInfo": "Questo adattatore è gratuito e open source. Se lo trovi utile, considera di supportare lo sviluppo:",
   "donateKofi": "Ko-fi",

package/admin/i18n/nl/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Koppelen",
-  "pairingInfo": "Om een apparaat toe te voegen: zet het datapunt 'startPairing' op true in het tabblad Objecten en druk vervolgens binnen 60 seconden op de fysieke knop op je HomeWizard-apparaat. Het apparaat wordt automatisch gevonden via mDNS. Voor netwerken zonder mDNS, stel eerst 'pairingIp' in.",
-  "headerDevices": "Apparaten",
-  "devicesInfo": "Gekoppelde apparaten worden weergegeven in het tabblad Objecten onder deze adapterinstantie. Elk apparaat heeft datapunten voor info, systeem en metingen. Om een apparaat te verwijderen, zet het 'remove'-datapunt op true.",
+  "headerPairing": "Apparaat toevoegen",
+  "pairingAutoHeader": "Automatisch (mDNS)",
+  "pairingAutoInfo": "1. Ga naar het tabblad Objecten en zet 'homewizard.0.startPairing' op true.\n2. Druk binnen 60 seconden op de fysieke knop op je HomeWizard-apparaat.\n3. Het apparaat wordt automatisch gevonden en verschijnt onder deze adapterinstantie.",
+  "pairingManualHeader": "Handmatig (vast IP)",
+  "pairingManualInfo": "Als mDNS niet beschikbaar is (bijv. ander VLAN of Docker):\n1. Stel 'homewizard.0.pairingIp' in op het IP-adres van het apparaat.\n2. Zet vervolgens 'homewizard.0.startPairing' op true.\n3. Druk binnen 60 seconden op de fysieke knop op het apparaat.",
+  "headerDevices": "Apparaten beheren",
+  "devicesInfo": "Alle gekoppelde apparaten staan in het tabblad Objecten onder 'homewizard.0'. Elk apparaat heeft een eigen map (bijv. hwe-p1_5c2fafaabbcc) met meetgegevens, systeeminstellingen en apparaatinformatie.\n\nOm een apparaat te verwijderen, zet het 'remove'-datapunt op true. Het apparaat en al zijn datapunten worden onmiddellijk verwijderd.",
+  "headerPrerequisites": "Vereisten",
+  "prerequisitesInfo": "De lokale API moet ingeschakeld zijn op je HomeWizard-apparaat. Open de HomeWizard-app → Instellingen → Meters → jouw apparaat → Lokale API → Inschakelen.",
   "supportHeader": "Ondersteuning",
   "aboutInfo": "Deze adapter is gratis en open source. Als je het nuttig vindt, overweeg dan de ontwikkeling te steunen:",
   "donateKofi": "Ko-fi",

package/admin/i18n/pl/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Parowanie",
-  "pairingInfo": "Aby dodać urządzenie: ustaw punkt danych 'startPairing' na true w zakładce Obiekty, a następnie naciśnij fizyczny przycisk na urządzeniu HomeWizard w ciągu 60 sekund. Urządzenie zostanie wykryte automatycznie przez mDNS. Dla sieci bez mDNS najpierw ustaw 'pairingIp'.",
-  "headerDevices": "Urządzenia",
-  "devicesInfo": "Sparowane urządzenia są wyświetlane w zakładce Obiekty pod tą instancją adaptera. Każde urządzenie ma punkty danych informacji, systemu i pomiarów. Aby usunąć urządzenie, ustaw jego punkt danych 'remove' na true.",
+  "headerPairing": "Dodaj urządzenie",
+  "pairingAutoHeader": "Automatycznie (mDNS)",
+  "pairingAutoInfo": "1. Przejdź do zakładki Obiekty i ustaw 'homewizard.0.startPairing' na true.\n2. Naciśnij fizyczny przycisk na urządzeniu HomeWizard w ciągu 60 sekund.\n3. Urządzenie zostanie wykryte automatycznie i pojawi się pod tą instancją adaptera.",
+  "pairingManualHeader": "Ręcznie (stały IP)",
+  "pairingManualInfo": "Jeśli mDNS nie jest dostępny (np. inny VLAN lub Docker):\n1. Ustaw 'homewizard.0.pairingIp' na adres IP urządzenia.\n2. Następnie ustaw 'homewizard.0.startPairing' na true.\n3. Naciśnij fizyczny przycisk na urządzeniu w ciągu 60 sekund.",
+  "headerDevices": "Zarządzanie urządzeniami",
+  "devicesInfo": "Wszystkie sparowane urządzenia są wymienione w zakładce Obiekty pod 'homewizard.0'. Każde urządzenie ma własny folder (np. hwe-p1_5c2fafaabbcc) z danymi pomiarowymi, ustawieniami systemowymi i informacjami o urządzeniu.\n\nAby usunąć urządzenie, ustaw jego punkt danych 'remove' na true. Urządzenie i wszystkie jego punkty danych zostaną natychmiast usunięte.",
+  "headerPrerequisites": "Wymagania",
+  "prerequisitesInfo": "Lokalne API musi być włączone na urządzeniu HomeWizard. Otwórz aplikację HomeWizard → Ustawienia → Liczniki → twoje urządzenie → Lokalne API → Włącz.",
   "supportHeader": "Wsparcie",
   "aboutInfo": "Ten adapter jest darmowy i otwartoźródłowy. Jeśli uważasz go za przydatny, rozważ wsparcie rozwoju:",
   "donateKofi": "Ko-fi",

package/admin/i18n/pt/translations.json

@@ -1,10 +1,15 @@
 {
-  "headerPairing": "Emparelhamento",
-  "pairingInfo": "Para adicionar um dispositivo: defina o ponto de dados 'startPairing' como true na aba Objetos e pressione o botão físico no dispositivo HomeWizard dentro de 60 segundos. O dispositivo será descoberto automaticamente via mDNS. Para redes sem mDNS, defina 'pairingIp' primeiro.",
-  "headerDevices": "Dispositivos",
-  "devicesInfo": "Os dispositivos emparelhados são exibidos na aba Objetos sob esta instância do adaptador. Cada dispositivo possui pontos de dados de informação, sistema e medição. Para remover um dispositivo, defina seu ponto de dados 'remove' como true.",
-  "supportHeader": "Apoio",
-  "aboutInfo": "Este adaptador é gratuito e de código aberto. Se você achar útil, considere apoiar o desenvolvimento:",
+  "headerPairing": "Adicionar dispositivo",
+  "pairingAutoHeader": "Automático (mDNS)",
+  "pairingAutoInfo": "1. Vá para a aba Objetos e defina 'homewizard.0.startPairing' como true.\n2. Pressione o botão físico no dispositivo HomeWizard dentro de 60 segundos.\n3. O dispositivo é descoberto automaticamente e aparece sob esta instância do adaptador.",
+  "pairingManualHeader": "Manual (IP fixo)",
+  "pairingManualInfo": "Se o mDNS não estiver disponível (ex.: VLAN diferente ou Docker):\n1. Defina 'homewizard.0.pairingIp' com o endereço IP do dispositivo.\n2. Depois defina 'homewizard.0.startPairing' como true.\n3. Pressione o botão físico no dispositivo dentro de 60 segundos.",
+  "headerDevices": "Gerenciar dispositivos",
+  "devicesInfo": "Todos os dispositivos emparelhados estão listados na aba Objetos sob 'homewizard.0'. Cada dispositivo tem sua própria pasta (ex.: hwe-p1_5c2fafaabbcc) com dados de medição, configurações do sistema e informações do dispositivo.\n\nPara remover um dispositivo, defina seu ponto de dados 'remove' como true. O dispositivo e todos os seus pontos de dados serão excluídos imediatamente.",
+  "headerPrerequisites": "Pré-requisitos",
+  "prerequisitesInfo": "A API local deve estar ativada no dispositivo HomeWizard. Abra o app HomeWizard → Configurações → Medidores → seu dispositivo → API Local → Ativar.",
+  "supportHeader": "Suporte",
+  "aboutInfo": "Este adaptador é gratuito e de código aberto. Se for útil para você, considere apoiar o desenvolvimento:",
   "donateKofi": "Ko-fi",
   "donatePaypal": "PayPal"
 }

package/admin/i18n/ru/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Сопряжение",
-  "pairingInfo": "Чтобы добавить устройство: установите точку данных 'startPairing' в true на вкладке Объекты, затем нажмите физическую кнопку на устройстве HomeWizard в течение 60 секунд. Устройство будет обнаружено автоматически через mDNS. Для сетей без mDNS сначала установите 'pairingIp'.",
-  "headerDevices": "Устройства",
-  "devicesInfo": "Сопряжённые устройства отображаются на вкладке Объекты под этим экземпляром адаптера. Каждое устройство имеет точки данных для информации, системы и измерений. Чтобы удалить устройство, установите его точку данных 'remove' в true.",
+  "headerPairing": "Добавить устройство",
+  "pairingAutoHeader": "Автоматически (mDNS)",
+  "pairingAutoInfo": "1. Перейдите на вкладку Объекты и установите 'homewizard.0.startPairing' в true.\n2. Нажмите физическую кнопку на устройстве HomeWizard в течение 60 секунд.\n3. Устройство будет обнаружено автоматически и появится под этим экземпляром адаптера.",
+  "pairingManualHeader": "Вручную (фиксированный IP)",
+  "pairingManualInfo": "Если mDNS недоступен (например, другой VLAN или Docker):\n1. Установите 'homewizard.0.pairingIp' на IP-адрес устройства.\n2. Затем установите 'homewizard.0.startPairing' в true.\n3. Нажмите физическую кнопку на устройстве в течение 60 секунд.",
+  "headerDevices": "Управление устройствами",
+  "devicesInfo": "Все сопряжённые устройства перечислены на вкладке Объекты под 'homewizard.0'. Каждое устройство имеет свою папку (например, hwe-p1_5c2fafaabbcc) с данными измерений, системными настройками и информацией об устройстве.\n\nЧтобы удалить устройство, установите его точку данных 'remove' в true. Устройство и все его точки данных будут немедленно удалены.",
+  "headerPrerequisites": "Предварительные требования",
+  "prerequisitesInfo": "Локальный API должен быть включён на устройстве HomeWizard. Откройте приложение HomeWizard → Настройки → Счётчики → ваше устройство → Локальный API → Включить.",
   "supportHeader": "Поддержка",
   "aboutInfo": "Этот адаптер бесплатный и с открытым исходным кодом. Если он вам полезен, рассмотрите поддержку разработки:",
   "donateKofi": "Ko-fi",

package/admin/i18n/uk/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "Сполучення",
-  "pairingInfo": "Щоб додати пристрій: встановіть точку даних 'startPairing' на true у вкладці Об'єкти, потім натисніть фізичну кнопку на пристрої HomeWizard протягом 60 секунд. Пристрій буде виявлено автоматично через mDNS. Для мереж без mDNS спочатку встановіть 'pairingIp'.",
-  "headerDevices": "Пристрої",
-  "devicesInfo": "Сполучені пристрої відображаються у вкладці Об'єкти під цим екземпляром адаптера. Кожен пристрій має точки даних для інформації, системи та вимірювань. Щоб видалити пристрій, встановіть його точку даних 'remove' на true.",
+  "headerPairing": "Додати пристрій",
+  "pairingAutoHeader": "Автоматично (mDNS)",
+  "pairingAutoInfo": "1. Перейдіть на вкладку Об'єкти і встановіть 'homewizard.0.startPairing' на true.\n2. Натисніть фізичну кнопку на пристрої HomeWizard протягом 60 секунд.\n3. Пристрій буде виявлено автоматично і з'явиться під цим екземпляром адаптера.",
+  "pairingManualHeader": "Вручну (фіксований IP)",
+  "pairingManualInfo": "Якщо mDNS недоступний (напр. інший VLAN або Docker):\n1. Встановіть 'homewizard.0.pairingIp' на IP-адресу пристрою.\n2. Потім встановіть 'homewizard.0.startPairing' на true.\n3. Натисніть фізичну кнопку на пристрої протягом 60 секунд.",
+  "headerDevices": "Керування пристроями",
+  "devicesInfo": "Всі сполучені пристрої перелічені на вкладці Об'єкти під 'homewizard.0'. Кожен пристрій має власну папку (напр. hwe-p1_5c2fafaabbcc) з даними вимірювань, системними налаштуваннями та інформацією про пристрій.\n\nЩоб видалити пристрій, встановіть його точку даних 'remove' на true. Пристрій та всі його точки даних будуть негайно видалені.",
+  "headerPrerequisites": "Передумови",
+  "prerequisitesInfo": "Локальний API повинен бути увімкнений на пристрої HomeWizard. Відкрийте додаток HomeWizard → Налаштування → Лічильники → ваш пристрій → Локальний API → Увімкнути.",
   "supportHeader": "Підтримка",
   "aboutInfo": "Цей адаптер безкоштовний і з відкритим кодом. Якщо він вам корисний, розгляньте підтримку розробки:",
   "donateKofi": "Ko-fi",

package/admin/i18n/zh-cn/translations.json

@@ -1,8 +1,13 @@
 {
-  "headerPairing": "配对",
-  "pairingInfo": "要添加新设备：在对象选项卡中将 'startPairing' 数据点设置为 true，然后在 60 秒内按下 HomeWizard 设备上的物理按钮。设备将通过 mDNS 自动发现。对于没有 mDNS 的网络，请先设置 'pairingIp'。",
-  "headerDevices": "设备",
-  "devicesInfo": "已配对的设备显示在此适配器实例下的对象选项卡中。每个设备都有信息、系统和测量数据点。要移除设备，请将其 'remove' 数据点设置为 true。",
+  "headerPairing": "添加设备",
+  "pairingAutoHeader": "自动 (mDNS)",
+  "pairingAutoInfo": "1. 转到对象选项卡，将 'homewizard.0.startPairing' 设置为 true。\n2. 在 60 秒内按下 HomeWizard 设备上的物理按钮。\n3. 设备将被自动发现并显示在此适配器实例下。",
+  "pairingManualHeader": "手动 (固定 IP)",
+  "pairingManualInfo": "如果 mDNS 不可用（如不同 VLAN 或 Docker）：\n1. 将 'homewizard.0.pairingIp' 设置为设备的 IP 地址。\n2. 然后将 'homewizard.0.startPairing' 设置为 true。\n3. 在 60 秒内按下设备上的物理按钮。",
+  "headerDevices": "管理设备",
+  "devicesInfo": "所有已配对的设备都列在对象选项卡中的 'homewizard.0' 下。每个设备都有自己的文件夹（如 hwe-p1_5c2fafaabbcc），包含测量数据、系统设置和设备信息。\n\n要移除设备，请将其 'remove' 数据点设置为 true。设备及其所有数据点将被立即删除。",
+  "headerPrerequisites": "前提条件",
+  "prerequisitesInfo": "必须在 HomeWizard 设备上启用本地 API。打开 HomeWizard 应用 → 设置 → 仪表 → 您的设备 → 本地 API → 启用。",
   "supportHeader": "支持",
   "aboutInfo": "此适配器免费且开源。如果您觉得有用，请考虑支持开发：",
   "donateKofi": "Ko-fi",

package/admin/jsonConfig.json

@@ -2,16 +2,43 @@
   "i18n": true,
   "type": "panel",
   "items": {
+    "_headerPrerequisites": {
+      "type": "header",
+      "text": "headerPrerequisites",
+      "size": 3
+    },
+    "_prerequisitesInfo": {
+      "type": "staticText",
+      "text": "prerequisitesInfo",
+      "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
+      "style": { "fontSize": 14, "marginBottom": 16 }
+    },
     "_headerPairing": {
       "type": "header",
       "text": "headerPairing",
       "size": 3
     },
-    "_pairingInfo": {
+    "_pairingAutoHeader": {
+      "type": "header",
+      "text": "pairingAutoHeader",
+      "size": 5
+    },
+    "_pairingAutoInfo": {
       "type": "staticText",
-      "text": "pairingInfo",
+      "text": "pairingAutoInfo",
       "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
-      "style": { "fontSize": 14, "marginBottom": 16 }
+      "style": { "fontSize": 14, "marginBottom": 16, "whiteSpace": "pre-line" }
+    },
+    "_pairingManualHeader": {
+      "type": "header",
+      "text": "pairingManualHeader",
+      "size": 5
+    },
+    "_pairingManualInfo": {
+      "type": "staticText",
+      "text": "pairingManualInfo",
+      "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
+      "style": { "fontSize": 14, "marginBottom": 16, "whiteSpace": "pre-line" }
     },
     "_headerDevices": {
       "type": "header",
@@ -22,7 +49,7 @@
       "type": "staticText",
       "text": "devicesInfo",
       "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
-      "style": { "fontSize": 14, "marginBottom": 16 }
+      "style": { "fontSize": 14, "marginBottom": 16, "whiteSpace": "pre-line" }
     },
     "_supportHeader": {
       "newLine": true,

package/build/lib/websocket-client.js

@@ -137,9 +137,9 @@ class HomeWizardWebSocket {
   cleanup() {
     if (this.ws) {
       this.ws.removeAllListeners();
-      if (this.ws.readyState === import_ws.default.OPEN || this.ws.readyState === import_ws.default.CONNECTING) {
-        this.ws.close();
-      }
+      this.ws.on("error", () => {
+      });
+      this.ws.terminate();
       this.ws = null;
     }
   }

package/build/lib/websocket-client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/websocket-client.ts"],
-  "sourcesContent": ["import WebSocket from \"ws\";\nimport { HW_AGENT } from \"./cacert\";\nimport type { Measurement, WsMessage } from \"./types\";\n\n/** Callback interface for WebSocket events */\nexport interface WsCallbacks {\n  /** Called when measurement data is received */\n  onMeasurement: (data: Measurement) => void;\n  /** Called when connection is established and authenticated */\n  onConnected: () => void;\n  /** Called when connection is lost */\n  onDisconnected: (error?: Error) => void;\n  /** Log functions */\n  log: {\n    debug: (msg: string) => void;\n    warn: (msg: string) => void;\n  };\n}\n\n/**\n * WebSocket client for HomeWizard real-time measurement push.\n * Handles auth handshake, subscription, and auto-reconnect.\n */\nexport class HomeWizardWebSocket {\n  private readonly ip: string;\n  private readonly token: string;\n  private readonly callbacks: WsCallbacks;\n  private ws: WebSocket | null = null;\n  private destroyed = false;\n\n  /**\n   * @param ip Device IP address\n   * @param token Bearer token\n   * @param callbacks Event callbacks\n   */\n  constructor(ip: string, token: string, callbacks: WsCallbacks) {\n    this.ip = ip;\n    this.token = token;\n    this.callbacks = callbacks;\n  }\n\n  /** Connect to WebSocket and start auth handshake */\n  connect(): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.cleanup();\n\n    const url = `wss://${this.ip}/api/ws`;\n    this.callbacks.log.debug(`WS connecting to ${url}`);\n\n    this.ws = new WebSocket(url, {\n      agent: HW_AGENT,\n      handshakeTimeout: 10_000,\n    });\n\n    this.ws.on(\"open\", () => {\n      this.callbacks.log.debug(`WS open to ${this.ip}`);\n    });\n\n    this.ws.on(\"message\", (raw: WebSocket.RawData) => {\n      this.handleMessage(raw);\n    });\n\n    this.ws.on(\"close\", (code: number, reason: Buffer) => {\n      this.callbacks.log.debug(`WS closed: ${code} ${reason.toString()}`);\n      this.ws = null;\n      if (!this.destroyed) {\n        this.callbacks.onDisconnected();\n      }\n    });\n\n    this.ws.on(\"error\", (err: Error) => {\n      this.callbacks.log.debug(`WS error: ${err.message}`);\n      // close event will follow\n    });\n  }\n\n  /** Gracefully close connection */\n  close(): void {\n    this.destroyed = true;\n    this.cleanup();\n  }\n\n  /** Whether the WebSocket is currently open */\n  get isConnected(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN;\n  }\n\n  /**\n   * Handle incoming WebSocket message\n   *\n   * @param raw Raw message data\n   */\n  private handleMessage(raw: WebSocket.RawData): void {\n    const text = Buffer.isBuffer(raw)\n      ? raw.toString(\"utf8\")\n      : raw instanceof ArrayBuffer\n        ? Buffer.from(raw).toString(\"utf8\")\n        : Array.isArray(raw)\n          ? Buffer.concat(raw).toString(\"utf8\")\n          : \"\";\n    let msg: WsMessage;\n    try {\n      msg = JSON.parse(text) as WsMessage;\n    } catch {\n      this.callbacks.log.warn(`WS invalid JSON: ${text.substring(0, 200)}`);\n      return;\n    }\n\n    switch (msg.type) {\n      case \"authorization_requested\":\n        this.callbacks.log.debug(\"WS auth requested, sending token\");\n        this.send({ type: \"authorization\", data: this.token });\n        break;\n\n      case \"authorized\":\n        this.callbacks.log.debug(\"WS authorized, subscribing to measurement\");\n        this.send({ type: \"subscribe\", data: \"measurement\" });\n        this.callbacks.onConnected();\n        break;\n\n      case \"measurement\":\n        if (msg.data) {\n          this.callbacks.onMeasurement(msg.data as Measurement);\n        }\n        break;\n\n      default:\n        this.callbacks.log.debug(`WS message type: ${msg.type}`);\n        break;\n    }\n  }\n\n  /**\n   * Send a message over WebSocket\n   *\n   * @param msg Message to send\n   */\n  private send(msg: WsMessage): void {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  /** Close WebSocket without triggering reconnect */\n  private cleanup(): void {\n    if (this.ws) {\n      this.ws.removeAllListeners();\n      if (\n        this.ws.readyState === WebSocket.OPEN ||\n        this.ws.readyState === WebSocket.CONNECTING\n      ) {\n        this.ws.close();\n      }\n      this.ws = null;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import WebSocket from \"ws\";\nimport { HW_AGENT } from \"./cacert\";\nimport type { Measurement, WsMessage } from \"./types\";\n\n/** Callback interface for WebSocket events */\nexport interface WsCallbacks {\n  /** Called when measurement data is received */\n  onMeasurement: (data: Measurement) => void;\n  /** Called when connection is established and authenticated */\n  onConnected: () => void;\n  /** Called when connection is lost */\n  onDisconnected: (error?: Error) => void;\n  /** Log functions */\n  log: {\n    debug: (msg: string) => void;\n    warn: (msg: string) => void;\n  };\n}\n\n/**\n * WebSocket client for HomeWizard real-time measurement push.\n * Handles auth handshake, subscription, and auto-reconnect.\n */\nexport class HomeWizardWebSocket {\n  private readonly ip: string;\n  private readonly token: string;\n  private readonly callbacks: WsCallbacks;\n  private ws: WebSocket | null = null;\n  private destroyed = false;\n\n  /**\n   * @param ip Device IP address\n   * @param token Bearer token\n   * @param callbacks Event callbacks\n   */\n  constructor(ip: string, token: string, callbacks: WsCallbacks) {\n    this.ip = ip;\n    this.token = token;\n    this.callbacks = callbacks;\n  }\n\n  /** Connect to WebSocket and start auth handshake */\n  connect(): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.cleanup();\n\n    const url = `wss://${this.ip}/api/ws`;\n    this.callbacks.log.debug(`WS connecting to ${url}`);\n\n    this.ws = new WebSocket(url, {\n      agent: HW_AGENT,\n      handshakeTimeout: 10_000,\n    });\n\n    this.ws.on(\"open\", () => {\n      this.callbacks.log.debug(`WS open to ${this.ip}`);\n    });\n\n    this.ws.on(\"message\", (raw: WebSocket.RawData) => {\n      this.handleMessage(raw);\n    });\n\n    this.ws.on(\"close\", (code: number, reason: Buffer) => {\n      this.callbacks.log.debug(`WS closed: ${code} ${reason.toString()}`);\n      this.ws = null;\n      if (!this.destroyed) {\n        this.callbacks.onDisconnected();\n      }\n    });\n\n    this.ws.on(\"error\", (err: Error) => {\n      this.callbacks.log.debug(`WS error: ${err.message}`);\n      // close event will follow\n    });\n  }\n\n  /** Gracefully close connection */\n  close(): void {\n    this.destroyed = true;\n    this.cleanup();\n  }\n\n  /** Whether the WebSocket is currently open */\n  get isConnected(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN;\n  }\n\n  /**\n   * Handle incoming WebSocket message\n   *\n   * @param raw Raw message data\n   */\n  private handleMessage(raw: WebSocket.RawData): void {\n    const text = Buffer.isBuffer(raw)\n      ? raw.toString(\"utf8\")\n      : raw instanceof ArrayBuffer\n        ? Buffer.from(raw).toString(\"utf8\")\n        : Array.isArray(raw)\n          ? Buffer.concat(raw).toString(\"utf8\")\n          : \"\";\n    let msg: WsMessage;\n    try {\n      msg = JSON.parse(text) as WsMessage;\n    } catch {\n      this.callbacks.log.warn(`WS invalid JSON: ${text.substring(0, 200)}`);\n      return;\n    }\n\n    switch (msg.type) {\n      case \"authorization_requested\":\n        this.callbacks.log.debug(\"WS auth requested, sending token\");\n        this.send({ type: \"authorization\", data: this.token });\n        break;\n\n      case \"authorized\":\n        this.callbacks.log.debug(\"WS authorized, subscribing to measurement\");\n        this.send({ type: \"subscribe\", data: \"measurement\" });\n        this.callbacks.onConnected();\n        break;\n\n      case \"measurement\":\n        if (msg.data) {\n          this.callbacks.onMeasurement(msg.data as Measurement);\n        }\n        break;\n\n      default:\n        this.callbacks.log.debug(`WS message type: ${msg.type}`);\n        break;\n    }\n  }\n\n  /**\n   * Send a message over WebSocket\n   *\n   * @param msg Message to send\n   */\n  private send(msg: WsMessage): void {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  /** Close WebSocket without triggering reconnect */\n  private cleanup(): void {\n    if (this.ws) {\n      this.ws.removeAllListeners();\n      // Prevent uncaught errors from frames received during close\n      this.ws.on(\"error\", () => {});\n      this.ws.terminate();\n      this.ws = null;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": ["WebSocket"]
 }

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "homewizard",
-    "version": "0.3.0",
+    "version": "0.3.2",
     "news": {
+      "0.3.2": {
+        "en": "Improve Admin UI and README with detailed configuration guide (prerequisites, manual IP pairing)",
+        "de": "Admin UI und README verbessert mit detaillierter Konfigurationsanleitung (Voraussetzungen, manuelles IP-Pairing)",
+        "ru": "Улучшен Admin UI и README с подробным руководством по настройке (предварительные требования, ручное IP-сопряжение)",
+        "pt": "Admin UI e README melhorados com guia de configuração detalhado (pré-requisitos, emparelhamento manual por IP)",
+        "nl": "Admin UI en README verbeterd met gedetailleerde configuratiegids (vereisten, handmatig IP-koppelen)",
+        "fr": "Admin UI et README améliorés avec guide de configuration détaillé (prérequis, appairage IP manuel)",
+        "it": "Admin UI e README migliorati con guida di configurazione dettagliata (prerequisiti, associazione IP manuale)",
+        "es": "Admin UI y README mejorados con guía de configuración detallada (requisitos, emparejamiento IP manual)",
+        "pl": "Ulepszono Admin UI i README ze szczegółowym przewodnikiem konfiguracji (wymagania, ręczne parowanie IP)",
+        "uk": "Покращено Admin UI та README з детальним посібником з налаштування (передумови, ручне IP-сполучення)",
+        "zh-cn": "改进 Admin UI 和 README，提供详细配置指南（前提条件、手动 IP 配对）"
+      },
+      "0.3.1": {
+        "en": "Fix uncaught exception on device removal (invalid WebSocket frame during close)",
+        "de": "Uncaught Exception beim Geraet entfernen behoben (ungueltiger WebSocket-Frame beim Schliessen)",
+        "ru": "Исправлено необработанное исключение при удалении устройства (недопустимый кадр WebSocket при закрытии)",
+        "pt": "Corrigida exceção não capturada ao remover dispositivo (frame WebSocket inválido durante fechamento)",
+        "nl": "Onafgevangen uitzondering bij verwijderen apparaat opgelost (ongeldig WebSocket-frame bij sluiten)",
+        "fr": "Correction d exception non capturée lors de la suppression d appareil (frame WebSocket invalide à la fermeture)",
+        "it": "Corretta eccezione non gestita alla rimozione del dispositivo (frame WebSocket non valido durante la chiusura)",
+        "es": "Corregida excepción no capturada al eliminar dispositivo (frame WebSocket inválido durante cierre)",
+        "pl": "Naprawiono nieprzechwycony wyjątek przy usuwaniu urządzenia (nieprawidłowa ramka WebSocket podczas zamykania)",
+        "uk": "Виправлено необроблений виняток при видаленні пристрою (недійсний кадр WebSocket при закритті)",
+        "zh-cn": "修复删除设备时的未捕获异常（关闭时无效的 WebSocket 帧）"
+      },
       "0.3.0": {
         "en": "Store device config in device objects (no adapter restart), fix datapoint issues, reconnect workflow",
         "de": "Gerätekonfiguration in Geräteobjekten gespeichert (kein Adapter-Neustart), Datenpunkt-Fixes, Reconnect-Workflow",
@@ -67,19 +93,6 @@
         "pl": "Dodano testy jednostkowe (129 testów), poprawiono konfigurację Dependabot",
         "uk": "Додано модульні тести (129 тестів), виправлено конфігурацію Dependabot",
         "zh-cn": "添加单元测试（129个测试），修复 Dependabot 配置"
-      },
-      "0.1.0": {
-        "en": "Initial release with API v2, WebSocket push, mDNS discovery, multi-device pairing",
-        "de": "Erstveröffentlichung mit API v2, WebSocket-Push, mDNS-Discovery, Multi-Geräte-Pairing",
-        "ru": "Первый выпуск с API v2, WebSocket push, mDNS discovery, сопряжение нескольких устройств",
-        "pt": "Lançamento inicial com API v2, WebSocket push, descoberta mDNS, emparelhamento multi-dispositivo",
-        "nl": "Eerste release met API v2, WebSocket push, mDNS discovery, multi-device pairing",
-        "fr": "Version initiale avec API v2, WebSocket push, découverte mDNS, appairage multi-appareils",
-        "it": "Rilascio iniziale con API v2, WebSocket push, scoperta mDNS, associazione multi-dispositivo",
-        "es": "Lanzamiento inicial con API v2, WebSocket push, descubrimiento mDNS, emparejamiento multi-dispositivo",
-        "pl": "Pierwsze wydanie z API v2, WebSocket push, odkrywanie mDNS, parowanie wielu urządzeń",
-        "uk": "Початковий випуск з API v2, WebSocket push, mDNS виявлення, з'єднання кількох пристроїв",
-        "zh-cn": "初始版本，支持 API v2、WebSocket 推送、mDNS 发现、多设备配对"
       }
     },
     "titleLang": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.homewizard",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "ioBroker adapter for HomeWizard Energy devices — real-time energy monitoring via API v2 with WebSocket push",
   "author": {
     "name": "krobi",