homebridge-ac-freedom 2.2.3 → 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/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.3",
+  "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 };