homebridge-tuya-plus 3.14.0-dev.54 → 3.14.0-dev.58

package/config.schema.json

@@ -446,6 +446,16 @@
                 "functionBody": "return model.devices && model.devices[arrayIndices] && ['AirConditioner'].includes(model.devices[arrayIndices].type);"
               }
             },
+            "fanSpeedValues": {
+              "type": "array",
+              "description": "Ordered string values used by the device for each fan speed (low → high), e.g. [\"low\", \"middle\", \"high\"]. Overrides fanSpeedSteps.",
+              "items": {
+                "type": "string"
+              },
+              "condition": {
+                "functionBody": "return model.devices && model.devices[arrayIndices] && ['AirConditioner'].includes(model.devices[arrayIndices].type);"
+              }
+            },
             "noChildLock": {
               "type": "boolean",
               "condition": {

package/lib/AirConditionerAccessory.js

@@ -27,13 +27,28 @@ class AirConditionerAccessory extends BaseAccessory {
         }
 
         if (!this.device.context.noRotationSpeed) {
-            const fanSpeedSteps = (this.device.context.fanSpeedSteps && isFinite(this.device.context.fanSpeedSteps) && this.device.context.fanSpeedSteps > 0 && this.device.context.fanSpeedSteps < 100) ? this.device.context.fanSpeedSteps : 100;
-            this._rotationSteps = [0];
-            this._rotationStops = {0: 0};
-            for (let i = 0; i++ < 100;) {
-                const _rotationStep = Math.floor(fanSpeedSteps * (i - 1) / 100) + 1;
-                this._rotationSteps.push(_rotationStep);
-                this._rotationStops[_rotationStep] = i;
+            if (Array.isArray(this.device.context.fanSpeedValues) && this.device.context.fanSpeedValues.length) {
+                this._rotationSteps = [0];
+                this._rotationStops = Object.create(null);
+                this._rotationStops[0] = 0;
+                const steps = this.device.context.fanSpeedValues;
+                const count = steps.length;
+                for (let i = 1; i <= 100; i++) {
+                    const idx = Math.min(Math.floor((i - 1) * count / 100), count - 1);
+                    this._rotationSteps.push(steps[idx]);
+                }
+                steps.forEach((step, idx) => {
+                    this._rotationStops[step] = Math.ceil(((idx + 1) * 100) / count);
+                });
+            } else {
+                const fanSpeedSteps = (this.device.context.fanSpeedSteps && isFinite(this.device.context.fanSpeedSteps) && this.device.context.fanSpeedSteps > 0 && this.device.context.fanSpeedSteps < 100) ? this.device.context.fanSpeedSteps : 100;
+                this._rotationSteps = [0];
+                this._rotationStops = {0: 0};
+                for (let i = 0; i++ < 100;) {
+                    const _rotationStep = Math.floor(fanSpeedSteps * (i - 1) / 100) + 1;
+                    this._rotationSteps.push(_rotationStep);
+                    this._rotationStops[_rotationStep] = i;
+                }
             }
         }
     }
@@ -378,10 +393,18 @@ class AirConditionerAccessory extends BaseAccessory {
     }
 
     convertRotationSpeedFromTuyaToHomeKit(value) {
-        return this._rotationStops[parseInt(value)];
+        if (Array.isArray(this.device.context.fanSpeedValues) && this.device.context.fanSpeedValues.length) {
+            const hk = this._rotationStops[value];
+            return hk === undefined ? 0 : hk;
+        }
+        const hk = this._rotationStops[parseInt(value)];
+        return hk === undefined ? 0 : hk;
     }
 
     convertRotationSpeedFromHomeKitToTuya(value) {
+        if (Array.isArray(this.device.context.fanSpeedValues) && this.device.context.fanSpeedValues.length) {
+            return this._rotationSteps[value];
+        }
         return this.device.context.fanSpeedSteps ? '' + this._rotationSteps[value] : this._rotationSteps[value];
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-tuya-plus",
-  "version": "3.14.0-dev.54",
+  "version": "3.14.0-dev.58",
   "description": "A community-maintained Homebridge plugin for controlling Tuya devices locally over LAN, with an optional Tuya Cloud fallback for whatever the LAN can't reach. Includes new features, fixes, and updated device support. PRs welcome: if it runs, it ships (almost).",
   "main": "index.js",
   "scripts": {

package/wiki/Supported-Device-Types.md

@@ -232,6 +232,24 @@ Tuya devices don't follow a unified pattern for naming the modes, for example co
 
 The fan speed data-point (DP `5`, `windspeed`) is usually an **enum of string values** like `"1"`, `"2"`, `"3"`. Set `fanSpeedSteps` to the number of speeds (e.g. `3`); this both maps HomeKit's 0–100 % slider onto the right number of steps and — importantly — sends the speed as a string, which these firmwares require. Without it the fan may silently ignore speed changes.
 
+For devices that use named string values such as `"low"`, `"middle"` and `"high"`, set `fanSpeedValues` instead:
+
+```json5
+{
+    "fanSpeedValues": [
+        "low",
+        "middle",
+        "high"
+    ]
+}
+```
+
+This maps HomeKit's 0–100% slider across the configured values in order. For the example above:
+- 0% → Off (turns the AC off)
+- 1–34% → "low"
+- 35–67% → "middle"
+- 68–100% → "high"
+
 Many ACs have no child-lock data-point; if yours doesn't, set `noChildLock: true` so the plugin doesn't add a (non-functional) lock control. Likewise, set `noRotationSpeed: true` if the device has no fan-speed control.
 
 Additional parameters can be found in the sample below.