Add Per-Light Settings for Maximum Brightness Adjustment

config.schema.json

@@ -75,6 +75,32 @@
         "description": "ID of the Homebridge Hue2 migration resource link.",
         "type": "string"
       },
+      "lightSettings": {
+        "type": "array",
+        "title": "Light Settings",
+        "description": "Define limits for brightness using the light's serial number.",
+        "items": {
+          "type": "object",
+          "properties": {
+            "serialNumber": {
+              "type": "string",
+              "title": "Serial Number",
+              "description": "The serial number of the light."
+            },
+            "limit": {
+              "type": "integer",
+              "title": "Brightness Limit (%)",
+              "description": "The maximum brightness allowed (1-100%).",
+              "minimum": 1,
+              "maximum": 100
+            }
+          },
+          "required": [
+            "serialNumber",
+            "limit"
+          ]
+        }
+      },
       "lights": {
         "description": "Expose lights.",
         "type": "boolean"
@@ -376,6 +402,31 @@
       "title": "Advanced Settings",
       "description": "Don't change these, unless you understand what you're doing.",
       "items": [
+        {
+          "type": "fieldset",
+          "expandable": true,
+          "title": "Light Brightness Limits",
+          "description": "Define brightness limits for specific lights using their serial numbers.",
+          "items": [
+            {
+              "key": "lightSettings",
+              "type": "array",
+              "addButtonTitle": "Add Light Limit",
+              "items": [
+                {
+                  "key": "lightSettings[].serialNumber",
+                  "title": "Serial Number",
+                  "description": "Enter the unique serial number of the light."
+                },
+                {
+                  "key": "lightSettings[].limit",
+                  "title": "Brightness Limit (%)",
+                  "description": "Enter the maximum brightness percentage (1-100)."
+                }
+              ]
+            }
+          ]
+        },
         {
           "key": "brightnessAdjustment",
           "condition": {

lib/HueLight.js

@@ -1170,41 +1170,78 @@ class HueLight {
     // if (bri === this.hk.bri) {
     //   return callback()
     // }
+    const lightConfig = this.bridge.platform.config.lightSettings.find(
+        (setting) => setting.serialNumber === this.serialNumber
+    );
+
+    const originalBri = bri; // Store original brightness for logging.
+
+    if (lightConfig && lightConfig.limit) {
+      const maxBrightness = lightConfig.limit;
+      bri = Math.round((bri * maxBrightness) / 100);
+      this.log.info(
+          '%s: Adjusting brightness from %s%% to %s%% of limit (%s%%)',
+          this.name,
+          originalBri,
+          bri,
+          maxBrightness
+      );
+    }
+
     this.log.info(
-      '%s: homekit brightness changed from %s%% to %s%%', this.name,
-      this.hk.bri, bri
-    )
-    const oldBri = this.hk.bri
-    this.hk.bri = bri
-    this.checkAdaptiveLighting()
-    const newBri = Math.round(this.hk.bri * 254.0 / 100.0)
-    this.put({ bri: newBri }).then(() => {
-      this.obj.state.bri = newBri
-      callback()
-    }).catch((error) => {
-      this.hk.bri = oldBri
-      callback(error)
-    })
+        '%s: homekit brightness changed from %s%% to %s%%',
+        this.name,
+        this.hk.bri,
+        bri
+    );
+    const oldBri = this.hk.bri;
+    this.hk.bri = bri;
+    this.checkAdaptiveLighting();
+    const newBri = Math.round(this.hk.bri * 254.0 / 100.0);
+    this.put({ bri: newBri })
+        .then(() => {
+          this.obj.state.bri = newBri;
+          callback();
+        })
+        .catch((error) => {
+          this.hk.bri = oldBri;
+          callback(error);
+        });
   }
 
   setBriChange (delta, callback) {
-    delta = Math.round(delta)
+    const lightConfig = this.bridge.platform.config.lightSettings.find(
+        (setting) => setting.serialNumber === this.serialNumber
+    );
+
+    if (lightConfig && lightConfig.limit) {
+      const maxBrightness = lightConfig.limit;
+      delta = Math.round((delta * maxBrightness) / 100);
+      this.log.info(
+          '%s: Adjusting brightness change by %s%% of limit (%s%%)',
+          this.name,
+          delta,
+          maxBrightness
+      );
+    }
+
+    delta = Math.round(delta);
     if (delta === 0) {
-      return callback()
+      return callback();
     }
-    this.log.info(
-      '%s: homekit brightness change by %s%%', this.name,
-      delta
-    )
-    const briDelta = Math.round(delta * 254.0 / 100.0)
-    this.put({ bri_inc: briDelta }).then((obj) => {
-      setTimeout(() => {
-        this.service.setCharacteristic(my.Characteristics.BrightnessChange, 0)
-      }, this.config.resetTimeout)
-      callback()
-    }).catch((error) => {
-      callback(error)
-    })
+
+    this.log.info('%s: homekit brightness change by %s%%', this.name, delta);
+    const briDelta = Math.round(delta * 254.0 / 100.0);
+    this.put({ bri_inc: briDelta })
+        .then(() => {
+          setTimeout(() => {
+            this.service.setCharacteristic(my.Characteristics.BrightnessChange, 0);
+          }, this.config.resetTimeout);
+          callback();
+        })
+        .catch((error) => {
+          callback(error);
+        });
   }
 
   setCt (ct, callback) {

lib/HuePlatform.js

@@ -100,6 +100,7 @@ class HuePlatform {
       .boolKey('hueDimmerRepeat')
       .boolKey('hueMotionTemperatureHistory')
       .stringKey('homebridgeHue2')
+      .arrayKey('lightSettings')
       .boolKey('lights')
       .boolKey('lightSensors')
       .boolKey('linkButton')
@@ -142,6 +143,7 @@ class HuePlatform {
           }
         }
       }
+      this.config.lightSettings = this.config.lightSettings || [];
       this.config.brightnessAdjustment /= 100
       const excludeSensorTypes = this.config.excludeSensorTypes
       this.config.excludeSensorTypes = {}