homebridge-ac-freedom 2.2.2 → 2.2.4

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2.2.3
+
+- Add localised features hint in config UI (14 languages)
+- Fix README configuration examples (was showing outdated `cloudDevices`/`localDevices` format)
+- Add `pollInterval` to `config.schema.json`
+- Move plugin/platform name constants to `platform.js`
+- Remove unused `FAN_SPEED.MUTE` constant
+
+## 2.2.2
+
+- Add custom Homebridge config UI (`homebridge-ui/public/index.html`)
+  - Collapsible device cards with Cloud/Local segmented toggle
+  - Feature toggle grid (Fan, Sleep, Display / Health, Clean, Eco, Comf. Wind)
+  - Auto-save on every change
+- Add i18n support with 14 languages (en, tr, ru, de, fr, es, it, ja, ko, zh-CN, ar, nl, pl, pt)
+
+## 2.2.1
+
+- Fan slider snaps to 25% increments only (0 / 25 / 50 / 75 / 100%)
+- Fix local device fan speed mapping (Low/High were swapped)
+- Fan resets to Auto when AC power toggles or HVAC mode changes
+- Sleep preset resets when AC power toggles or HVAC mode changes
+- Remove Mute/Silent fan speed option from slider
+
 ## 2.1.1
 
 - Mark plugin as compatible with Homebridge v2

package/README.md

@@ -87,12 +87,15 @@ npm install -g homebridge-ac-freedom
     {
       "platform": "AcFreedom",
       "name": "AC Freedom",
-      "cloudDevices": [
+      "devices": [
         {
           "name": "Living Room AC",
-          "email": "your-email@example.com",
-          "password": "your-password",
-          "region": "eu"
+          "connection": "cloud",
+          "cloud": {
+            "email": "your-email@example.com",
+            "password": "your-password",
+            "region": "eu"
+          }
         }
       ]
     }
@@ -108,11 +111,14 @@ npm install -g homebridge-ac-freedom
     {
       "platform": "AcFreedom",
       "name": "AC Freedom",
-      "localDevices": [
+      "devices": [
         {
           "name": "Bedroom AC",
-          "ip": "192.168.1.100",
-          "mac": "AA:BB:CC:DD:EE:FF"
+          "connection": "local",
+          "local": {
+            "ip": "192.168.1.100",
+            "mac": "AA:BB:CC:DD:EE:FF"
+          }
         }
       ]
     }
@@ -124,27 +130,30 @@ npm install -g homebridge-ac-freedom
 
 ## Configuration Options
 
-### Cloud Device Options
+### Device Options (all modes)
 
 | Option | Type | Required | Default | Description |
 |--------|------|----------|---------|-------------|
 | `name` | string | Yes | — | Device name in HomeKit |
+| `connection` | string | Yes | `"cloud"` | Connection mode: `cloud` or `local` |
+| `pollInterval` | integer | No | `30` | Polling interval in seconds (5–300) |
+| `tempStep` | number | No | `0.5` | Temperature step: `0.5` or `1` |
+
+### Cloud Settings (`cloud` object)
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
 | `email` | string | Yes | — | AC Freedom app email |
 | `password` | string | Yes | — | AC Freedom app password |
 | `region` | string | No | `"eu"` | Server region: `eu`, `usa`, `cn`, `rus` |
 | `deviceId` | string | No | — | Specific device ID (leave empty to auto-detect) |
-| `showExtras` | boolean | No | `false` | Show fan, sleep, and extra switches |
-| `pollInterval` | integer | No | `30` | Polling interval in seconds (5–300) |
 
-### Local Device Options
+### Local Settings (`local` object)
 
 | Option | Type | Required | Default | Description |
 |--------|------|----------|---------|-------------|
-| `name` | string | Yes | — | Device name in HomeKit |
 | `ip` | string | Yes | — | AC unit's local IP address |
 | `mac` | string | Yes | — | AC unit's MAC address (`AA:BB:CC:DD:EE:FF`) |
-| `showExtras` | boolean | No | `false` | Show fan, sleep, and extra switches |
-| `pollInterval` | integer | No | `30` | Polling interval in seconds (5–300) |
 
 ### Feature Switches
 

package/config.schema.json

@@ -91,6 +91,13 @@
               "type": "boolean",
               "default": true
             },
+            "pollInterval": {
+              "title": "Poll Interval (seconds)",
+              "type": "integer",
+              "default": 30,
+              "minimum": 5,
+              "maximum": 300
+            },
             "tempStep": {
               "title": "Temperature Step",
               "type": "number",

package/homebridge-ui/public/i18n/ar.json

@@ -37,5 +37,6 @@
   "pollInterval": "فترة الاستطلاع (ثانية)",
   "pollIntervalHint": "تكرار جلب حالة المكيف (5–300)",
   "addDevice": "إضافة جهاز",
-  "remove": "إزالة"
-}
+  "remove": "إزالة",
+  "featuresHint": "للحصول على مظهر HomeKit أنيق، يُوصى بتفعيل المروحة ووضع إعداد مسبق واحد فقط — يُقترح اختيار النوم."
+}

package/homebridge-ui/public/i18n/de.json

@@ -37,5 +37,6 @@
   "pollInterval": "Abfrageintervall (Sekunden)",
   "pollIntervalHint": "Wie oft der AC-Status abgerufen wird (5–300)",
   "addDevice": "Gerät hinzufügen",
-  "remove": "Entfernen"
-}
+  "remove": "Entfernen",
+  "featuresHint": "Für ein übersichtliches HomeKit-Layout wird empfohlen, nur den Lüfter und einen einzigen Voreinstellungsmodus zu aktivieren — empfohlen wird Schlaf."
+}

package/homebridge-ui/public/i18n/en.json

@@ -37,5 +37,6 @@
   "pollInterval": "Poll Interval (seconds)",
   "pollIntervalHint": "How often to fetch the AC state (5–300)",
   "addDevice": "Add Device",
-  "remove": "Remove"
-}
+  "remove": "Remove",
+  "featuresHint": "For a clean HomeKit appearance, it is recommended to enable Fan and only one preset mode — Sleep is the suggested choice."
+}

package/homebridge-ui/public/i18n/es.json

@@ -37,5 +37,6 @@
   "pollInterval": "Intervalo de consulta (segundos)",
   "pollIntervalHint": "Con qué frecuencia obtener el estado del AC (5–300)",
   "addDevice": "Agregar dispositivo",
-  "remove": "Eliminar"
-}
+  "remove": "Eliminar",
+  "featuresHint": "Para una apariencia limpia en HomeKit, se recomienda activar el Ventilador y solo un modo preestablecido — Sueño es la opción sugerida."
+}

package/homebridge-ui/public/i18n/fr.json

@@ -37,5 +37,6 @@
   "pollInterval": "Intervalle d'interrogation (secondes)",
   "pollIntervalHint": "Fréquence de récupération de l'état du climatiseur (5–300)",
   "addDevice": "Ajouter un appareil",
-  "remove": "Supprimer"
-}
+  "remove": "Supprimer",
+  "featuresHint": "Pour un affichage HomeKit épuré, il est recommandé d'activer le Ventilateur et un seul mode prédéfini — Sommeil est le choix conseillé."
+}

package/homebridge-ui/public/i18n/it.json

@@ -37,5 +37,6 @@
   "pollInterval": "Intervallo polling (secondi)",
   "pollIntervalHint": "Ogni quanto recuperare lo stato del AC (5–300)",
   "addDevice": "Aggiungi dispositivo",
-  "remove": "Rimuovi"
-}
+  "remove": "Rimuovi",
+  "featuresHint": "Per un aspetto HomeKit ordinato, si consiglia di abilitare il Ventilatore e un solo modo preimpostato — Sonno è la scelta suggerita."
+}

package/homebridge-ui/public/i18n/ja.json

@@ -37,5 +37,6 @@
   "pollInterval": "ポーリング間隔（秒）",
   "pollIntervalHint": "エアコンの状態を取得する頻度（5〜300）",
   "addDevice": "デバイスを追加",
-  "remove": "削除"
-}
+  "remove": "削除",
+  "featuresHint": "すっきりしたHomeKit表示のために、ファンと1つのプリセットモードのみ有効にすることをお勧めします — スリープが推奨です。"
+}

package/homebridge-ui/public/i18n/ko.json

@@ -37,5 +37,6 @@
   "pollInterval": "폴링 간격 (초)",
   "pollIntervalHint": "에어컨 상태 조회 빈도 (5–300)",
   "addDevice": "기기 추가",
-  "remove": "제거"
-}
+  "remove": "제거",
+  "featuresHint": "깔끔한 HomeKit 화면을 위해 팬과 프리셋 모드 하나만 활성화하는 것을 권장합니다 — 수면을 추천합니다."
+}

package/homebridge-ui/public/i18n/nl.json

@@ -37,5 +37,6 @@
   "pollInterval": "Poll-interval (seconden)",
   "pollIntervalHint": "Hoe vaak de AC-status wordt opgehaald (5–300)",
   "addDevice": "Apparaat toevoegen",
-  "remove": "Verwijderen"
-}
+  "remove": "Verwijderen",
+  "featuresHint": "Voor een overzichtelijk HomeKit-uiterlijk wordt aanbevolen alleen de Ventilator en één voorkeursmodus in te schakelen — Slaap is de aanbevolen keuze."
+}

package/homebridge-ui/public/i18n/pl.json

@@ -37,5 +37,6 @@
   "pollInterval": "Interwał odpytywania (sekundy)",
   "pollIntervalHint": "Jak często pobierać stan klimatyzatora (5–300)",
   "addDevice": "Dodaj urządzenie",
-  "remove": "Usuń"
-}
+  "remove": "Usuń",
+  "featuresHint": "Dla przejrzystego wyglądu HomeKit zaleca się włączenie tylko Wentylatora i jednego trybu predefiniowanego — rekomendowany jest Sen."
+}

package/homebridge-ui/public/i18n/pt.json

@@ -37,5 +37,6 @@
   "pollInterval": "Intervalo de consulta (segundos)",
   "pollIntervalHint": "Com que frequência buscar o estado do AC (5–300)",
   "addDevice": "Adicionar dispositivo",
-  "remove": "Remover"
-}
+  "remove": "Remover",
+  "featuresHint": "Para uma aparência limpa no HomeKit, recomenda-se ativar o Ventilador e apenas um modo predefinido — Sono é a escolha sugerida."
+}

package/homebridge-ui/public/i18n/ru.json

@@ -37,5 +37,6 @@
   "pollInterval": "Интервал опроса (сек)",
   "pollIntervalHint": "Как часто запрашивать состояние кондиционера (5–300)",
   "addDevice": "Добавить устройство",
-  "remove": "Удалить"
-}
+  "remove": "Удалить",
+  "featuresHint": "Для аккуратного вида HomeKit рекомендуется включить Вентилятор и только один режим предустановки — предпочтительно Сон."
+}

package/homebridge-ui/public/i18n/tr.json

@@ -37,5 +37,6 @@
   "pollInterval": "Sorgulama Aralığı (saniye)",
   "pollIntervalHint": "Klima durumunun ne sıklıkla sorgulanacağı (5–300)",
   "addDevice": "Cihaz Ekle",
-  "remove": "Kaldır"
-}
+  "remove": "Kaldır",
+  "featuresHint": "Temiz bir HomeKit görünümü için Fan ve yalnızca bir ön ayar modunun (önerilen: Uyku) etkinleştirilmesi tavsiye edilir."
+}

package/homebridge-ui/public/i18n/zh-CN.json

@@ -37,5 +37,6 @@
   "pollInterval": "轮询间隔（秒）",
   "pollIntervalHint": "获取空调状态的频率（5–300）",
   "addDevice": "添加设备",
-  "remove": "删除"
-}
+  "remove": "删除",
+  "featuresHint": "为保持 HomeKit 界面整洁，建议仅启用风扇和一个预设模式 — 推荐选择睡眠。"
+}

package/homebridge-ui/public/index.html

@@ -329,6 +329,7 @@
 
           <!-- Features -->
           <div class="section-hd">${t.features||'Features'}</div>
+          <div class="hint" style="margin-bottom:8px">💡 ${t.featuresHint||'For a clean HomeKit appearance, enabling only Fan and Sleep is recommended.'}</div>
           <div class="toggle-rows">
             <div class="toggle-row">
               ${featRow1.map(f => `

package/index.js

@@ -5,10 +5,7 @@
  * Exposes HeaterCooler with linked Switch services for presets inside the climate card.
  */
 
-const { AcFreedomPlatform } = require('./src/platform');
-
-const PLUGIN_NAME = 'homebridge-ac-freedom';
-const PLATFORM_NAME = 'AcFreedom';
+const { AcFreedomPlatform, PLUGIN_NAME, PLATFORM_NAME } = require('./src/platform');
 
 module.exports = (api) => {
   api.registerPlatform(PLUGIN_NAME, PLATFORM_NAME, AcFreedomPlatform);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-ac-freedom",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "displayName": "Homebridge AC Freedom",
   "description": "Homebridge plugin for AUX air conditioners via Broadlink (local UDP) and AUX Cloud API",
   "main": "index.js",

package/src/ac-accessory.js

@@ -29,7 +29,7 @@ const CLOUD = {
 const CLOUD_MODE = { AUTO: 4, COOL: 0, HEAT: 1, DRY: 2, FAN: 3 };
 
 // Fan speed values
-const FAN_SPEED = { AUTO: 0, LOW: 1, MEDIUM: 2, HIGH: 3, TURBO: 4, MUTE: 5 };
+const FAN_SPEED = { AUTO: 0, LOW: 1, MEDIUM: 2, HIGH: 3, TURBO: 4 };
 
 class AcFreedomAccessory {
   constructor(platform, accessory, config, deviceApi) {
@@ -524,7 +524,7 @@ class AcFreedomAccessory {
       const api = this.deviceApi.api;
       api.state.fanSpeed = speed;
       api.state.turbo = speed === FAN_SPEED.TURBO ? 1 : 0;
-      api.state.mute = speed === FAN_SPEED.MUTE ? 1 : 0;
+      api.state.mute = 0;
       await api.setState();
     }
   }

package/src/platform.js

@@ -10,6 +10,9 @@ const { AcFreedomAccessory } = require('./ac-accessory');
 const { AuxCloudAPI } = require('./cloud-api');
 const { BroadlinkAcApi } = require('./broadlink-api');
 
+const PLUGIN_NAME   = 'homebridge-ac-freedom';
+const PLATFORM_NAME = 'AcFreedom';
+
 class AcFreedomPlatform {
   constructor(log, config, api) {
     this.log = log;
@@ -68,7 +71,7 @@ class AcFreedomPlatform {
       this.log.info('Adding new accessory: %s', deviceConfig.name);
       const accessory = new this.api.platformAccessory(deviceConfig.name, uuid);
       new AcFreedomAccessory(this, accessory, deviceConfig, deviceApi);
-      this.api.registerPlatformAccessories('homebridge-ac-freedom', 'AcFreedom', [accessory]);
+      this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
       this.accessories.set(uuid, accessory);
     }
   }
@@ -133,4 +136,4 @@ class AcFreedomPlatform {
   }
 }
 
-module.exports = { AcFreedomPlatform };
+module.exports = { AcFreedomPlatform, PLUGIN_NAME, PLATFORM_NAME };