@willieee802/zigbee-herdsman-converters 15.0.8-4.1

package/lib/light.js

@@ -0,0 +1,111 @@
+const utils = require('./utils');
+
+async function readColorCapabilities(endpoint) {
+    await endpoint.read('lightingColorCtrl', ['colorCapabilities']);
+}
+
+async function readColorTempMinMax(endpoint) {
+    await endpoint.read('lightingColorCtrl', ['colorTempPhysicalMin', 'colorTempPhysicalMax']);
+}
+
+function readColorAttributes(entity, meta, additionalAttributes=[]) {
+    /**
+      * Not all bulbs suport the same features, we need to take care we read what is supported.
+      * `supportsHueAndSaturation` indicates support for currentHue and currentSaturation
+      * `enhancedHue` indicates support for enhancedCurrentHue
+      *
+      * e.g. IKEA Tådfri LED1624G9 only supports XY (https://github.com/Koenkk/zigbee-herdsman-converters/issues/1340)
+      *
+      * Additionally when we get a get payload, only request the fields included.
+     */
+    const attributes = ['colorMode'];
+    if (meta && meta.message) {
+        if (!meta.message.color || (typeof meta.message.color === 'object' && meta.message.color.hasOwnProperty('x'))) {
+            attributes.push('currentX');
+        }
+        if (!meta.message.color || (typeof meta.message.color === 'object' && meta.message.color.hasOwnProperty('y'))) {
+            attributes.push('currentY');
+        }
+
+        if (utils.getMetaValue(entity, meta.mapped, 'supportsHueAndSaturation', 'allEqual', true)) {
+            if (!meta.message.color || (typeof meta.message.color === 'object' && meta.message.color.hasOwnProperty('hue'))) {
+                if (utils.getMetaValue(entity, meta.mapped, 'enhancedHue', 'allEqual', true)) {
+                    attributes.push('enhancedCurrentHue');
+                } else {
+                    attributes.push('currentHue');
+                }
+            }
+            if (!meta.message.color || (typeof meta.message.color === 'object' && meta.message.color.hasOwnProperty('saturation'))) {
+                attributes.push('currentSaturation');
+            }
+        }
+    }
+
+    return [...attributes, ...additionalAttributes];
+}
+
+function findColorTempRange(entity, logger) {
+    let colorTempMin;
+    let colorTempMax;
+    if (entity.constructor.name === 'Group') {
+        const minCandidates = entity.members.map(
+            (m) => m.getClusterAttributeValue('lightingColorCtrl', 'colorTempPhysicalMin'),
+        ).filter((v) => v != null);
+        if (minCandidates.length > 0) {
+            colorTempMin = Math.max(...minCandidates);
+        }
+        const maxCandidates = entity.members.map(
+            (m) => m.getClusterAttributeValue('lightingColorCtrl', 'colorTempPhysicalMax'),
+        ).filter((v) => v != null);
+        if (maxCandidates.length > 0) {
+            colorTempMax = Math.min(...maxCandidates);
+        }
+    } else {
+        colorTempMin = entity.getClusterAttributeValue('lightingColorCtrl', 'colorTempPhysicalMin');
+        colorTempMax = entity.getClusterAttributeValue('lightingColorCtrl', 'colorTempPhysicalMax');
+    }
+    if ((colorTempMin == null) || (colorTempMax == null)) {
+        const entityType = entity.constructor.name.toLowerCase();
+        const entityId = (entityType === 'group') ? entity.groupID : entity.deviceIeeeAddress;
+        logger.debug(`Missing colorTempPhysicalMin and/or colorTempPhysicalMax for ${entityType} ${entityId}!`);
+    }
+    return [colorTempMin, colorTempMax];
+}
+
+function clampColorTemp(colorTemp, colorTempMin, colorTempMax, logger) {
+    if ((colorTempMin != null) && (colorTemp < colorTempMin)) {
+        logger.debug(`Requested color_temp ${colorTemp} is lower than minimum supported ${colorTempMin}, using minimum!`);
+        return colorTempMin;
+    }
+    if ((colorTempMax != null) && (colorTemp > colorTempMax)) {
+        logger.debug(`Requested color_temp ${colorTemp} is higher than maximum supported ${colorTempMax}, using maximum!`);
+        return colorTempMax;
+    }
+    return colorTemp;
+}
+
+async function configure(device, coordinatorEndpoint, logger, readColorTempMinMaxAttribute) {
+    if (device.powerSource === 'Unknown') {
+        device.powerSource = 'Mains (single phase)';
+        device.save();
+    }
+
+    for (const endpoint of device.endpoints.filter((e) => e.supportsInputCluster('lightingColorCtrl'))) {
+        try {
+            await readColorCapabilities(endpoint);
+
+            if (readColorTempMinMaxAttribute) {
+                await readColorTempMinMax(endpoint);
+            }
+        } catch (e) {/* Fails for some, e.g. https://github.com/Koenkk/zigbee2mqtt/issues/5717 */}
+    }
+}
+
+module.exports = {
+    readColorCapabilities,
+    readColorTempMinMax,
+    readColorAttributes,
+    findColorTempRange,
+    clampColorTemp,
+    configure,
+};

package/lib/ota/OTA_URLs.md

@@ -0,0 +1,119 @@
+# Zigbee OTA source provider sources for these and others
+
+Collection of external Zigbee OTA firmware images from official and unofficial OTA provider sources.
+
+### Koenkk zigbee-OTA repository
+
+Koenkk zigbee-OTA repository host third-party OTA firmware images and external URLs for many third-party Zigbee OTA firmware images.
+
+https://github.com/Koenkk/zigbee-OTA/tree/master/images
+
+https://raw.githubusercontent.com/Koenkk/zigbee-OTA/master/index.json
+
+### Dresden Elektronik
+
+Dresden Elektronik Zigbee OTA firmware images are made publicly available by Dresden Elektronik (first-party) at the following URL:
+
+https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/OTA-Image-Types---Firmware-versions
+
+Dresden Elektronik also provide third-party OTA firmware images and external URLs for many third-party Zigbee OTA firmware images.
+
+### Inovelli OTA Firmware provider
+
+Inovelli Zigbee OTA firmware images are made publicly available by Inovelli (first-party) at the following URLs:
+
+https://files.inovelli.com/firmware/firmware.json
+
+https://files.inovelli.com/firmware
+
+Experimental Inovelli OTA URL for zigpy:
+
+https://files.inovelli.com/firmware/firmware-zha.json
+
+### Sonoff OTA Firmware provider
+
+Sonoff Zigbee OTA firmware images are made publicly available by Sonoff (first-party) at the following URLs:
+
+https://zigbee-ota.sonoff.tech/releases/upgrade.json
+
+### EUROTRONICS
+
+EUROTRONICS Zigbee OTA firmware images are made publicly available by EUROTRONIC Technology (first-party) at the following URL:
+
+https://github.com/EUROTRONIC-Technology/Spirit-ZigBee/releases/download/
+
+### IKEA Trådfri 
+
+IKEA Tradfi Zigbee OTA firmware images are made publicly available by IKEA (first-party) at the following URL:
+
+Download-URL: 
+
+http://fw.ota.homesmart.ikea.net/feed/version_info.json
+
+Release changelogs
+
+https://ww8.ikea.com/ikeahomesmart/releasenotes/releasenotes.html
+
+### LEDVANCE/Sylvania and OSRAM Lightify
+
+LEDVANCE/Sylvania and OSRAM Lightify Zigbee OTA firmware images are made publicly available by LEDVANCE (first-party) at the following URL:
+
+https://update.ledvance.com/firmware-overview
+
+https://api.update.ledvance.com/v1/zigbee/firmwares/download
+
+https://consumer.sylvania.com/our-products/smart/sylvania-smart-zigbee-products-menu/index.jsp
+
+### Legrand/Netatmo
+
+Legrand/Netatmo Zigbee OTA firmware images are made publicly available by Legrand (first-party) at the following URL:
+
+https://developer.legrand.com/documentation/operating-manual/ https://developer.legrand.com/documentation/firmwares-download/
+
+### LiXee
+
+LiXee Zigbee OTA firmware images are made publicly available by Fairecasoimeme / ZiGate (first-party) at the following URL:
+
+https://github.com/fairecasoimeme/Zlinky_TIC/releases
+
+### SALUS/Computime
+
+SALUS/Computime Hue Zigbee OTA firmware images are made publicly available by SALUS (first-party) at the following URL:
+
+https://eu.salusconnect.io/demo/default/status/firmware
+
+### Sengled
+
+Sengled Zigbee OTA firmware images are made publicly available by Dresden Elektronik (third-party) at the following URL:
+
+https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/OTA-Image-Types---Firmware-versions#sengled
+
+### Philips Hue (Signify)
+
+Philips Hue OTA firmware images are available for different Hue devices for several official sources that do not all use the same APIs:
+
+https://firmware.meethue.com/v1/checkUpdate
+
+https://firmware.meethue.com/storage/
+
+http://fds.dc1.philips.com/firmware/
+
+Philips Hue (Signify) Zigbee OTA firmware images direct URLs are available by Koenkk zigbee-OTA repository (third-party) at following URL:
+
+https://raw.githubusercontent.com/Koenkk/zigbee-OTA/master/index.json
+
+Philips Hue (Signify) Zigbee OTA firmware images are also made publicly available by Dresden Elektronik (third-party) at following URL:
+
+https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/OTA-Image-Types---Firmware-versions#philips-hue
+
+### Ubisys
+
+Ubisys Zigbee OTA firmware images are made publicly available by Ubisys (first-party) at the following URL:
+
+https://www.ubisys.de/en/support/firmware/
+
+### Third Reality (3reality)
+
+ThirdReality (3reality) Zigbee OTA firmware images are made publicly available by Third Reality, Inc. (first-party) at the following URL:
+
+https://tr-zha.s3.amazonaws.com/firmware.json