lib/BaseDriver.js | BaseDriver.js |
lib/BatteryManagerV3.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/BatteryManagerV4.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/DeviceFingerprintDB.js | _no header_ |
lib/DiagnosticEngine.js | _no header_ |
lib/FlowCardHelper.js | FlowCardHelper v5.5.533 Utility to register flow cards for button drivers. |
lib/GlobalTimeSyncEngine.js | P206 - orphan shim: canonical engine lives in lib/tuya/GlobalTimeSyncEngine.js (TuyaTimeSyncFormats + safe timers). |
lib/IASAlarmFallback.js | IAS ALARM FALLBACK - v5.5.796 (Forum #1159 Lasse_K ZG-222Z fix) Handles devices where IAS Zone bind is unsupported (INVALID_EP) Fallback strategies: polling, Tuya DP mirror, attribute read v5.5.796: FORUM FIX - Enhanced |
lib/IASZoneEnroller.js | IASZoneEnroller - Stub for backward compatibility Real implementation is in lib/managers/IASZoneManager.js |
lib/IntelligentDeviceLearner.js | IntelligentDeviceLearner v5.5.336 Autonomous capability discovery and device profile learning system. |
lib/IntelligentSensorInference.js | _no header_ |
lib/LocalFirstEngine.js | _no header_ |
lib/LowLevelBridge.js | +==============================================================================+ \| LowLevelBridge v1.0.0 - P34 ZIGBEE/TUYA BYPASS ENGINE \| +============================================================================== |
lib/ManufacturerVariationManager.js | _no header_ |
lib/OnOffBoundCluster.js | WHY: stale duplicate historically lacked 0xFD. |
lib/ProductValueValidator.js | _no header_ |
lib/ProtocolAutoOptimizer.js | _no header_ |
lib/SDK3BestPractices.js | SDK3BestPractices - v5.5.453 (+ P2547 Sdk3ZclSafe re-export) Utility class implementing Homey SDK3 best practices from official documentation: https://apps.developer.homey.app/ SSOT: config/architecture/external-app-sdk3 |
lib/SDK3CompatBridge.js | +==============================================================================+ \| SDK3CompatBridge v1.0.0 - P36 SDK3 COMPENSATION ENGINE \| +============================================================================= |
lib/TuyaColorControlCluster.js | _no header_ |
lib/TuyaDataPoints.js | Tuya Data Points (DP) This file defines a comprehensive list of Tuya-specific data points for various device types, such as thermostats, curtains, fans, and switches. |
lib/TuyaDeviceClassifier.js | _no header_ |
lib/TuyaEpochDetector.js | _no header_ |
lib/TuyaHelpers.js | Tuya Helpers This file provides a set of utility functions to handle common operations for Tuya Zigbee devices in a Homey driver. |
lib/TuyaLevelControlCluster.js | _no header_ |
lib/TuyaOnOffCluster.js | _no header_ |
lib/TuyaRtcDetector.js | _no header_ |
lib/TuyaSpecificCluster.js | TuyaSpecificCluster This class defines the Tuya-specific Zigbee cluster and its associated commands. |
lib/TuyaSpecificClusterDevice.js | _no header_ |
lib/TuyaTimeDebugProbe.js | _no header_ |
lib/TuyaTimeManager.js | _no header_ |
lib/TuyaUniversalBridge.js | _no header_ |
lib/TuyaWindowCoveringCluster.js | _no header_ |
lib/TuyaZigBeeLightDevice.js | _no header_ |
lib/UniversalDataHandler.js | _no header_ |
lib/UniversalZigbeeDevice.js | _no header_ |
lib/UniversalZigbeeProtocol.js | UniversalZigbeeProtocol v4.0 - Complete Universal Zigbee Stack v5.5.657: Full universal engine (ZCL + DP + private clusters) Architecture: ONE universal engine interpreting ALL Zigbee variants - ZCL standard clusters - T |
lib/Util.js | Util.js - Universal Permissive Utilities As of v10.0.0 (P82, 2026-07-23), this module is a BACKWARD-COMPAT shim that delegates to lib/utils/TuyaNormalizer.js (the ULTIMATE single source of truth). |
lib/ZigbeeClusterManager.js | ZigbeeClusterManager - Universal Cluster Handler for Homey Handles all standard ZCL clusters for direct Zigbee communication: - IAS Zone (0x0500) - Security sensors - IAS WD (0x0502) - Warning devices (sirens, strobes) - |
lib/ZigbeeTimeSync.js | +==============================================================================+ \| ZIGBEE TIME SYNC - PRODUCTION READY \| \| \| \| [GOAL] POUR: TS0601 _TZE284_vvmbj46n et autres devices avec RTC + outCluster \| \| [OK] |
lib/adapters/ExternalDeviceAdapter.js | ExternalDeviceAdapter - Unified adapter combining Z2M, ZHA, deCONZ, and other sources into a single enrichment pipeline for the Homey app. |
lib/adapters/SecurityManager.js | _no header_ |
lib/adapters/Z2MConverterAdapter.js | _no header_ |
lib/adapters/ZHAQuirkAdapter.js | _no header_ |
lib/adapters/ZclToHomeyMap.js | _no header_ |
lib/adapters/index.js | Adapters Index Central export point for all adapter modules. |
lib/analytics/AdvancedAnalytics.js | ADVANCED ANALYTICS & INSIGHTS Rich data visualization and tracking system - Device health monitoring - Energy consumption analytics - Network quality tracking - Predictive maintenance - Usage patterns analysis |
lib/analytics/AnalyticsSystem.js | Advanced Analytics and Insights Optimized for Homey Pro limits (512 MB RAM) SDK3 COMPLIANT: Uses this.homey |
lib/analytics/index.js | _no header_ |
lib/autonomous/AutonomousVerificationEngine.js | lib/autonomous/AutonomousVerificationEngine.js - v2.0 (P58.6) |
lib/autonomous/index.js | lib/autonomous/index.js - v1.0 (P37.8) |
lib/battery/BatteryCalculator.js | +==============================================================================+ \| BATTERY CALCULATOR v5.5.47 - ULTRA PRECISE \| +==============================================================================+ \| \| \| |
lib/battery/BatteryCascadeEngine.js | _no header_ |
lib/battery/BatteryChemistryCurves.js | P2710 - Battery Chemistry Precision Curves WHY (P215): - Pourquoi: precise measure_battery % + measure_voltage from non-linear discharge curves per energy type (pile / akku / lithium techno). |
lib/battery/BatteryCore.js | BatteryCore v2 - P54 comprehensive battery solution ========================================================================== Consolidates ALL battery-related methods, measurements, estimations, and fallback chains in O |
lib/battery/BatteryHealthIntelligence.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/battery/BatteryHelper.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/battery/BatteryHybridManager.js | +==============================================================================+ \| BATTERY HYBRID MANAGER - v5.5.42 \| +==============================================================================+ \| \| \| Gestion in |
lib/battery/BatteryIconDetector.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/battery/BatteryManager.js | BatteryManager - Intelligent Battery Management Accurate calculations per battery type with voltage-based algorithms |
lib/battery/BatteryManagerV3.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/battery/BatteryMasterEngine.js | _no header_ |
lib/battery/BatteryMonitoringMixin.js | _no header_ |
lib/battery/BatteryMonitoringSystem.js | _no header_ |
lib/battery/BatteryProfileDatabase.js | _no header_ |
lib/battery/BatterySystem.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/battery/MultiProtocolBatteryPercent.js | MultiProtocolBatteryPercent (P209) Fine-grained battery % support across every transport: ZCL / Zigbee · Tuya DP (EF00) · WiFi / local Tuya · IAS/ACE ("acl") · voltage · raw frame · MCU · estimated/cached Rules (project |
lib/battery/SmartBatteryAdaptivePrecision.js | P2689 - Smart Battery Adaptive Precision WHY (P215): - Pourquoi: recover precise % for piles/accus without draining CR2032 or flooding the mesh with powerCfg polls / tight reportableChange. |
lib/battery/SmartBatteryLowAlarm.js | SmartBatteryLowAlarm (P2506) WHY: Homey SDK forbids measure_battery + alarm_battery on the same device (duplicate UI + Flow). |
lib/battery/UnifiedBatteryHandler.js | _no header_ |
lib/battery/UniversalBatteryFallback.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/battery/ZclBatteryMonitor.js | ZclBatteryMonitor - v9.0.413 (P92.118) / v9.0.581 Universal battery wiring for drivers that declare measure_battery but have NO runtime battery path (raw ZigBeeDevice Johan-style drivers: doorwindowsensor, pirsensor, f |
lib/battery/button-battery-report.js | A tile percent is a report only when a sample path stored both a time and last_battery_from_report. |
lib/battery/index.js | Battery Management Index - P54 cleaned Centralized exports for active battery-related utilities. |
lib/battery/zcl-percent.js | Single entry point for ZCL powerConfiguration battery normalization. |
lib/buttons/ButtonEventRouter.js | ButtonEventRouter (P2926) - one small place that turns every way a Tuya/Zigbee button press can reach us into { button, type } and lets one press fire once. |
lib/buttons/attachButtonPaths.js | P2926 - optional, additive button paths on top of the native ones. |
lib/cache/FingerprintCache.js | FingerprintCache.js - Fingerprint Lookup Cache Caches device fingerprint lookups for fast access. |
lib/cache/NetworkCache.js | NetworkCache.js - HTTP Request Caching Layer Wraps HTTP/HTTPS requests with intelligent caching. |
lib/cache/SmartCache.js | SmartCache.js - LRU + TTL Cache with Disk Persistence Implements a Least Recently Used (LRU) eviction strategy with per-entry Time To Live (TTL) support. |
lib/cache/index.js | Cache Module - Centralized exports for caching infrastructure WHY: Pairing uses mfs_db + fingerprint-matcher; CI HTTP uses smart-fetch. |
lib/catalog/ComplementaryCoverageCatalog.js | ComplementaryCoverageCatalog (P2544) WHY: Inventory every complementary I/O / wrapper / OTA / antispam path beyond Homey native zigbee/tuya libs - polymorphic coverage without inventing pids. |
lib/clusters/CustomClusterManager.js | CustomClusterManager v5.8.36 Discovers, binds, listens to custom clusters Homey skips during interview 0xEF00-0xEFFF (Tuya) on ALL EPs + 0xFC00-0xFFFF (manufacturer-specific) |
lib/clusters/IasAceCluster.js | _no header_ |
lib/clusters/LevelControlBoundCluster.js | _no header_ |
lib/clusters/OnOffBoundCluster.js | _no header_ |
lib/clusters/RawClusterFallback.js | RawClusterFallback v5.12.0 Fixes: bind before listen, configureReporting, readAttributes, proper skip |
lib/clusters/ScenesBoundCluster.js | _no header_ |
lib/clusters/TuyaBatterySafeCluster.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/clusters/TuyaBoundCluster.js | _no header_ |
lib/clusters/TuyaColorControlCluster.js | _no header_ |
lib/clusters/TuyaE000BoundCluster.js | _no header_ |
lib/clusters/TuyaE000Cluster.js | _no header_ |
lib/clusters/TuyaE001BoundCluster.js | _no header_ |
lib/clusters/TuyaE001Cluster.js | _no header_ |
lib/clusters/TuyaE002BoundCluster.js | _no header_ |
lib/clusters/TuyaE002Cluster.js | _no header_ |
lib/clusters/TuyaE003BoundCluster.js | _no header_ |
lib/clusters/TuyaE003Cluster.js | _no header_ |
lib/clusters/TuyaOnOffCluster.js | TuyaOnOffCluster - Extended OnOff cluster with Tuya-specific attributes Source: Johan Bendz (JohanBendz/com.tuya.zigbee), integrated complementarily. |
lib/clusters/TuyaOnOffExtCluster.js | _no header_ |
lib/clusters/TuyaSpecificCluster.js | _no header_ |
lib/clusters/TuyaWindowCoveringCluster.js | _no header_ |
lib/clusters/UniversalClusterBinder.js | WHY(C2 lazy-load): EnrichedDPMappings is ~230 KB of heap and only needed once a Tuya DP is parsed or a per-manufacturer DP list is asked for, so it is resolved on first use instead of at module load. |
lib/clusters/UnknownClusterHandler.js | _no header_ |
lib/clusters/ZosungIRControlBoundCluster.js | _no header_ |
lib/clusters/ZosungIRControlCluster.js | _no header_ |
lib/clusters/ZosungIRTransmitBoundCluster.js | _no header_ |
lib/clusters/ZosungIRTransmitCluster.js | _no header_ |
lib/clusters/index.js | Clusters Index - v5.12.2 Centralized exports for all Zigbee cluster handlers |
lib/compat/StableV5Compat.js | =========================================================================== StableV5Compat.js - Module de compatibilité stable-v5 -> master =========================================================================== CONT |
lib/compensation/FirmwareLimitCompensation.js | P3101 (t656u / #560): optional firmware-limit compensation, data-driven per exact mfr+pid (config/firmware-limits.json). |
lib/configs/IntelligentDeviceConfig.js | _no header_ |
lib/constants/DeviceConstants.js | DeviceConstants - Centralized magic numbers and thresholds for device management Eliminates hardcoded values scattered across BaseUnifiedDevice.js and related files |
lib/constants/REPORTING_CONFIGS.js | REPORTING_CONFIGS v5.12.12 - Adjusted values to prevent Zigbee network flooding |
lib/constants/ZigbeeConstants.js | ZigbeeConstants - Centralized Zigbee Cluster and Attribute IDs Unified Phoenix Sovereign structure. |
lib/converters/TuyaDeviceDefinitions.js | _no header_ |
lib/converters/ValueConverterRegistry.js | ValueConverterRegistry - Central registry of value converters Inspired by Z2M (zigbee-herdsman-converters) converter patterns. |
lib/converters/index.js | CONVERTERS INDEX Central export point for all converter modules. |
lib/coordinator/DeviceCoordinator.js | _no header_ |
lib/coordinator/attach.js | Spec 003 T3 - opt-in attachment of DeviceCoordinator to a Homey device instance. |
lib/covers/CoverCommandQueue.js | _no header_ |
lib/covers/CoverFlowActions.js | CoverFlowActions - give real behaviour to cover flow actions that were registered as log-only placeholders (open / close / stop / favorite). |
lib/covers/CoverMotionTracker.js | _no header_ |
lib/covers/CoverTahomaActions.js | CoverTahomaActions: TaHoma-style extras for covers, as app-level flow actions. |
lib/covers/PositionSupportTracker.js | P2772 - hide the position slider on curtains that only support open/stop/close. |
lib/covers/normalizeDpScalar.js | normalizeDpScalar: turn a numeric string DP value ("2", " 50 ", "-3.5") into a number, and leave everything else alone. |
lib/detectors/BseedDetector.js | BseedDetector - Detect BSEED devices that need Tuya DP protocol BSEED devices often have firmware that requires Tuya DataPoint protocol instead of standard Zigbee On/Off commands for multi-gang switches. |
lib/detectors/EnergyCapabilityDetector.js | ENERGY CAPABILITY DETECTOR Détecte intelligemment les capacités de mesure d'énergie: - Voltage, Current, Power, Energy - Battery percentage, voltage - Power source type (mains, battery, DC) - Consumption modes (AC/DC) S' |
lib/detectors/MotionAwarePresenceDetector.js | _no header_ |
lib/device/ButtonVisual.js | ButtonVisual v2 - P54 comprehensive button visual rendering ========================================================================== Provides enhanced visual states for button devices in the Homey app. |
lib/devices/AirPurifierFilterLife.js | Air Purifier Filter Life - DEVICE #24 Tracks filter usage and remaining life for Tuya air purifiers. |
lib/devices/BaseTuyaDPDevice.js | _no header_ |
lib/devices/BaseUnifiedDevice.js | _no header_ |
lib/devices/ButtonDevice.js | _no header_ |
lib/devices/CameraPTZController.js | Camera PTZ Control - DEVICE #23 Pan/Tilt/Zoom controller for Tuya Zigbee cameras. |
lib/devices/CurtainMotorTilt.js | Curtain Motor Tilt Control - DEVICE #33 Extended curtain/blind motor control with tilt/slat angle support. |
lib/devices/DeviceTypeManager.js | [HOME] Device Type Manager Gère les différents types d'appareils connectés aux modules de contrôle Permet l'inversion logique pour radiateurs électriques et autres cas spéciaux |
lib/devices/DoorWindowContactHelper.js | v9.0.415 (P92.123): DoorWindowContactHelper - shared IAS contact logic for the door/windowsensor family. |
lib/devices/DoorbellCameraSnapshot.js | Doorbell Camera Snapshot - DEVICE #31 Manages snapshot/capture functionality for Tuya doorbell cameras. |
lib/devices/EnergyMeterPerPhase.js | Energy Meter Per-Phase - DEVICE #30 Multi-phase energy monitoring for 3-phase Tuya energy meters. |
lib/devices/FingerprintLockFeatures.js | Fingerprint Lock Features - DEVICE #27 Manages smart lock features for Tuya Zigbee fingerprint locks: - User/fingerprint management (add/delete/query) - Lock/unlock event tracking - Tamper detection - Access log manageme |
lib/devices/GangCountAdapter.js | GangCountAdapter - P2794 runtime gang detection for switches (additive, non-blocking). |
lib/devices/HybridSwitchBase.js | _no header_ |
lib/devices/IRBlasterCodeDatabase.js | IR Blaster Code Database - DEVICE #26 Manages IR code libraries for Tuya IR blasters (Zosung, Tuya generic). |
lib/devices/InPlaceIdentityLayer.js | _no header_ |
lib/devices/LedControllerSpiTuyaDevice.js | _no header_ |
lib/devices/MiBoxerFut089zZones.js | Folded into button_wireless_4 (exact couple _TZ3000_xwh1e22x + TS1002). |
lib/devices/PlugDevice.js | _no header_ |
lib/devices/SensorDevice.js | _no header_ |
lib/devices/SmokePreAlarm.js | Smoke Pre-Alarm - DEVICE #37 Early warning system for smoke/CO detectors using: - Trend analysis (gradual rise in smoke density) - Pre-alarm thresholds before critical alarm - Multi-sensor fusion (smoke + CO + temperatur |
lib/devices/SwitchDevice.js | _no header_ |
lib/devices/Ts004xDedicatedComplement.js | Ts004xDedicatedComplement (P2616) Complementary hotfix stacks that historically lived on dedicated TS0044 drivers and must NOT be wiped when fleet WallSceneRemoteHybridInit is installed (P2520). |
lib/devices/TuyaDpProfileDevice.js | _no header_ |
lib/devices/TuyaUnifiedDevice.js | _no header_ |
lib/devices/UnifiedCoverBase.js | _no header_ |
lib/devices/UnifiedLightBase.js | _no header_ |
lib/devices/UnifiedPlugBase.js | _no header_ |
lib/devices/UnifiedSensorBase.js | _no header_ |
lib/devices/UnifiedSwitchBase.js | _no header_ |
lib/devices/UnifiedThermostatBase.js | _no header_ |
lib/devices/WallSceneRemoteHybridInit.js | WallSceneRemoteHybridInit (P2608) Battery wall scene remotes (TS0043 / TS0044 / Zemismart / Moes / Lonsonho): multi-path RX - Homey does not natively decode Tuya mfr OnOff 0xFD / E000 / EF00. |
lib/devices/WallTouchDevice.js | _no header_ |
lib/devices/held/WallSwitchRfEws1154zDevice.js | P3330: moved from drivers/wall_switch_rf_ews1154z/device.js (which re-exports it) so the published driver wall_switch_1gang_1way can run it for these exact couples while wall_switch_rf_ews1154z stays held out of the Atho |
lib/devices/index.js | Devices Index - v5.5.797 Centralized exports for all device base classes |
lib/diagnostics/DebugManager.js | DEBUG MANAGER Centralized debug/logging control - Developer Debug Mode flag - Controlled logging levels - Performance impact awareness AUDIT V2: Reduce log spam for production users |
lib/diagnostics/DeviceDiagSnapshot.js | DeviceDiagSnapshot (P3198) WHY: diag fb5be1fe (Zigbee energy meter pairs, reports nothing) carried only app startup lines - no mfr/pid/clusters/DPs, so nothing could be fixed. |
lib/diagnostics/DeviceDiagnostics.js | DeviceDiagnostics - Comprehensive diagnostic tool for Tuya/Zigbee devices v5.2.9 - Based on user feedback and diagnostic reports Detects and reports: - USB/Zigbee communication issues - Battery reporting problems - Drive |
lib/diagnostics/DeviceHealth.js | _no header_ |
lib/diagnostics/DiagContentEnricher.js | DiagContentEnricher - structured extraction from Homey diagnostic emails / stdout. |
lib/diagnostics/DiagnosticAPI.js | [LAB] DIAGNOSTIC API Expose logs and diagnostics for external access (MCP, AI agents, debugging) Allows intelligent monitoring and auto-correction by AI agents |
lib/diagnostics/DiagnosticLogger.js | DiagnosticLogger - Structured logging utility for verbose debugging Provides: - Timestamp with milliseconds - Module name identification - Log levels (info, warn, error, debug, verbose) - Device ID context (when availabl |
lib/diagnostics/DiagnosticLogsCollector.js | DiagnosticLogsCollector - Mixin pour ajouter la collecte de logs aux rapports diagnostics de device Usage: const DiagnosticLogsCollector = require('./DiagnosticLogsCollector'); class MyDevice extends DiagnosticLogsCollec |
lib/diagnostics/FleetIdentityLog.js | FleetIdentityLog (P2248) WHY: Peter_van_Werkhoven diags (0cea6870 / 1cf775a2 / 634f7b19) never carried zb_manufacturer_name + zb_model_id - couples stayed ABSENT. |
lib/diagnostics/HealthCheck.js | HEALTH CHECK SYSTEM Vérifie la santé du device et du réseau Zigbee Fournit diagnostic détaillé en cas de problème Basé sur best practices IKEA TRÅDFRI et Xiaomi Mi Home |
lib/diagnostics/SystemLogsCollector.js | SystemLogsCollector - Collecte les logs système et autres logs utiles pour inclusion dans les rapports diagnostics de l'app |
lib/discovery/AutonomousAdvertisingDiscovery.js | AutonomousAdvertisingDiscovery (P2410) WHY: Users need LAN + mesh devices that are currently advertising (UDP beacons / mDNS / recent Zigbee RX) without waiting for cloud. |
lib/discovery/SmartDeviceDiscovery.js | _no header_ |
lib/discovery/SmartDiscovery.js | Smart Device Discovery AI-powered device identification and configuration |
lib/discovery/index.js | _no header_ |
lib/drivers/BaseZigBeeDriver.js | _no header_ |
lib/drivers/ContinuationFlowAlias.js | WHY(P3233, 02/11/2026 Paris): a continuation driver (DRIVER_CONTINUATIONS.md) owns its own flow card ids (<cont>_x, filtered on driver_id=<cont>) but runs the root code, which asks for '<root>_x' cards. |
lib/drivers/DriverContinuations.js | WHY(P3206, 02/11/2026 Paris): one shared resolver for driver chains (root -> <root>_2 -> <root>_3 ...). |
lib/drivers/DynamicDriverMatcher.js | lib/drivers/DynamicDriverMatcher.js |
lib/drivers/FlowGangControl.js | _no header_ |
lib/drivers/HeldDriverFolds.js | P3330 / P3331: runtime side of lib/drivers/held-driver-folds.json. |
lib/drivers/ZigBeeDriverFlowCardPatch.js | ZigBeeDriverFlowCardPatch WHY(P2676 / Bastien diag cb3c0c87 @ 1.0.51): hard require('homey-zigbeedriver') at app.js load crashed the WHOLE app (MODULE_NOT_FOUND) -> no lights/relays. |
lib/dynamic/AutoAdaptiveDevice.js | _no header_ |
lib/dynamic/AutonomousEnricher.js | +==============================================================================+ \| [NET] AUTONOMOUS ENRICHER (Zero-Touch Updates) \| +==============================================================================+ \| Ru |
lib/dynamic/DPAdaptationEngine.js | DPAdaptationEngine - v6.0.0 Real-time DP pattern analysis and adaptation engine for Tuya Zigbee devices. |
lib/dynamic/DPAutoMapper.js | DPAutoMapper - v6.0.0 DP-to-capability auto-mapping engine with value-range inference. |
lib/dynamic/DynamicCapabilityManager.js | _no header_ |
lib/dynamic/DynamicEnergyManager.js | DynamicEnergyManager - v5.3.59 Intelligent real-time energy monitoring and adaptation. |
lib/dynamic/DynamicFlowCardManager.js | DynamicFlowCardManager - v5.3.57 Automatically creates and registers flow cards based on: - Device capabilities (existing + dynamically discovered) - Capability type (boolean -> triggers, number -> conditions/triggers) - |
lib/dynamic/IntelligentDriverHotSwap.js | IntelligentDriverHotSwap - v2.0.0 (MASTER_ONLY) =================================================================== HARD CONSTRAINT: Homey SDK3 has NO setDriver() at runtime. |
lib/dynamic/LiveDataUpdater.js | LiveDataUpdater (P92.77 / P148) - OTA fingerprint overlay from our GitHub Pages. |
lib/dynamic/SelfHealingDevice.js | +==============================================================================+ \| [DNA] SELF-HEALING BASE DEVICE (Autonomous Repair) \| +==============================================================================+ \ |
lib/dynamic/SmartBiorhythmHandler.js | SmartBiorhythmHandler - Local Solar Sync via DaylightAtmosphere SSOT. |
lib/dynamic/SmartButtonRouter.js | _no header_ |
lib/dynamic/SmartDoorlockHandler.js | SmartDoorlockHandler Universal Tuya DP mapping for Doorlocks (Tuya MCU and Standard) |
lib/dynamic/SmartFlowManager.js | SmartFlowManager - v5.3.59 Intelligent real-time flow card management. |
lib/dynamic/UniversalSmartFeaturesHandler.js | UniversalSmartFeaturesHandler Intercepts common Tuya "Smart Features" DPs (Child Lock, Eco Mode, Calibration, Window Open) and dynamically injects them into Homey as capabilities. |
lib/dynamic/VirtualTelemetryCompensationEngine.js | +==============================================================================+ \| VIRTUAL TELEMETRY COMPENSATION & ADAPTATION ENGINE - v5.6.1 \| +======================================================================== |
lib/dynamic/index.js | Dynamic Auto-Adaptive System - v5.3.59 FULL intelligent self-adapting system for Tuya devices. |
lib/emergency/EmergencyDeviceFix.js | _no header_ |
lib/energy/EstimatedEnergyCaps.js | P3130 / t699u: deterministic estimated-energy capabilities. |
lib/energy/ExportEnergyConfig.js | #105 follow-up: drivers that only gain meter_power.exported at runtime (power clamps, metering plugs that report produced energy) cannot declare it in driver.compose.json energy, because Homey requires the capability |
lib/energy/IntelligentEnergyAdapter.js | IntelligentEnergyAdapter (P2672) Pourquoi: Homey Energy UI + mesh flood need ONE dynamic decision per device - metered / approximate / battery / sleepy - without inventing parallel managers. |
lib/energy/PowerEnergySanity.js | PowerEnergySanity - P3021c (forum topic 140352 post #2092, Lucas360). |
lib/energy/PowerEstimator.js | P3170 / t759u: pure power-estimation helpers (no timers, no device state). |
lib/energy/PowerSelfCalibration.js | PowerSelfCalibration - learn a light/dimmer/plug's own power curve from the moments it DOES report real power (P3067, user t581u/t582u). |
lib/energy/PowerSourceResolver.js | PowerSourceResolver - one precedence for "how many watts is this device using" (P3067, user t577u/t580u). |
lib/energy/UniversalEnergyHandler.js | UniversalEnergyHandler Manages 'Metering' (0x0702) and 'ElectricalMeasurement' (0x0B04) clusters universally. |
lib/energy/WifiDp17Energy.js | P2705 - Tuya WiFi DP17 (add_ele) energy, auto-detected per device. |
lib/energy/mainsEnergy.js | P3070-energy: energy object for a device just confirmed as mains powered. |
lib/enrichment/ComplementaryMerge.js | ComplementaryMerge (P2520) WHY: Enrichments are variants/additions - never wipe or shrink working compose. |
lib/enrichment/EnrichmentRegistry.js | EnrichmentRegistry — single loader for config/enrichment manifest + layers. |
lib/enrichment/HeuristicUnknownResolver.js | HeuristicUnknownResolver (P2218 / P2228) Predictive / heuristic ranking when mfr+pid or symptoms are incomplete. |
lib/enrichment/NeedActionInvestigator.js | NeedActionInvestigator — auto-investigate forum need-action without waiting for user reply. |
lib/enrichment/PhaseRunner.js | PhaseRunner — manifest-driven silent enrichment pipeline. |
lib/enrichment/ProfileSynchronizer.js | ProfileSynchronizer — merge forum/diag signals into catalog stubs (never overwrite curated rows). |
lib/errors/UserFriendlyErrors.js | UserFriendlyErrors - v1.0.0 Translates technical errors into user-friendly messages Features: - Error categorization and mapping - Context-aware suggestions - Multi-language support ready - Error history for pattern dete |
lib/errors/index.js | _no header_ |
lib/ewelink-local/EweLinkCrypto.js | _no header_ |
lib/ewelink-local/EweLinkLANClient.js | _no header_ |
lib/ewelink-local/EweLinkLocalDevice.js | _no header_ |
lib/ewelink-local/EweLinkLocalDriver.js | _no header_ |
lib/ewelink-local/eweLinkRepair.js | P3072 - one Repair "configure" handler for every eWeLink/Sonoff LAN device. |
lib/features/AbsenceEnergySoft.js | AbsenceEnergySoft (P2565) - unbranded absence->eco (Aqara presence energy-save feel). |
lib/features/AdvancedMultiConditionFlows.js | _no header_ |
lib/features/CapabilityExportImport.js | Device Capability Export/Import - FEATURE #50 Export and import device capability configurations: - Export device capability profile - Import capability settings between devices - Capability diff/comparison |
lib/features/ConditionEngine.js | ConditionEngine - Flexible Condition Evaluation FEATURE #85 Evaluates complex condition trees for flow card triggers: - Device state conditions (capability value comparisons) - Time conditions (before/after, day-of-week, |
lib/features/ConfigurationBackupRestore.js | Configuration Backup/Restore - FEATURE #56 Backup and restore device configurations: - Full app configuration backup - Per-device settings backup - Flow card backup - Export/import as JSON |
lib/features/ContactEntrySoft.js | ContactEntrySoft (P2566) - unbranded door/contact -> lights (ST/Lutron entry routine). |
lib/features/CustomCapabilityTemplates.js | Custom Capability Templates - FEATURE #45 Provides reusable capability templates for common Tuya device patterns: - Pre-configured capability sets by device type - Automatic capability generation from DP mappings - Capab |
lib/features/DaylightAtmosphere.js | DaylightAtmosphere - community SSOT for solar white / brightness curves. |
lib/features/DeviceGroupSceneManager.js | Device Group Scene Management - FEATURE #52 Manages scenes across groups of devices: - Save/restore device states as scenes - Group scene activation - Scene transitions (fade, ramp) - Schedule-based scene activation |
lib/features/DeviceMigrationWizard.js | Device Migration Wizard - FEATURE #54 Helps users migrate devices between drivers: - Pre-migration compatibility check - Settings migration - Flow migration - Rollback support |
lib/features/DiagnosticReportExport.js | Diagnostic Report Export - FEATURE #57 Generates and exports comprehensive diagnostic reports: - Network health report - Device status report - Performance metrics - Error logs - Exportable as JSON/text |
lib/features/EnergyHistoryStore.js | EnergyHistoryStore - Persistent Energy Data Storage FEATURE #82 Stores energy readings with rolling window retention: - Per-device energy history (watt-hours) - Configurable retention (hours, days, weeks) - Automatic dat |
lib/features/IdleAutoOffSoft.js | IdleAutoOffSoft (P2566) - unbranded idle auto-off (Lutron Auto-Off Timer feel). |
lib/features/LampMeshOccupancy.js | LampMeshOccupancy (P2563/P2564) - full Homey-feasible lamp-as-sensor occupancy. |
lib/features/LocalSelfImproveCatalog.js | LocalSelfImproveCatalog (P2542) WHY: Homey Pro has no cloud AI - document/wire local compensators for agents & soft boot notes. |
lib/features/LuxAdaptiveDim.js | LuxAdaptiveDim (P2565) - unbranded lux->brightness follow (Aqara illuminance lighting feel). |
lib/features/MirrorLightSync.js | MirrorLightSync (P2565) - unbranded master->follower light sync (SmartThings/HA mirror feel). |
lib/features/NetworkTopologyCollector.js | NetworkTopologyCollector - Zigbee Mesh Topology Mapping FEATURE #87 Collects and maps the Zigbee mesh network topology: - Device neighbor discovery - Router/end-device classification - Signal path quality analysis - Mesh |
lib/features/NetworkTopologyTrigger.js | _no header_ |
lib/features/NightPathBias.js | NightPathBias (P2566) - unbranded night dim bias (Xiaomi/Aqara night path feel). |
lib/features/PeakLoadSoftShed.js | PeakLoadSoftShed (P2566) - unbranded peak power -> soft dim (energy-hub load shed feel). |
lib/features/PredictiveHealthEngine.js | PredictiveHealthEngine - Device Health Trend Analysis FEATURE #86 Analyzes device health trends for predictive maintenance: - Battery drain rate prediction - Signal degradation detection - Failure probability estimation |
lib/features/QuietHoursGuard.js | QuietHoursGuard (P2566) - unbranded quiet-hours window check (Lutron/Aqara feel). |
lib/features/ScheduleManager.js | ScheduleManager - Core Scheduling Engine FEATURE #84 Manages device schedules with complex recurrence patterns: - Cron-style scheduling (second to day-of-week) - One-shot scheduled actions - Recurring patterns with end d |
lib/features/ShadeDaylightSoft.js | ShadeDaylightSoft (P2566) - unbranded solar->cover (Lutron Sunset Tracker / shade feel). |
lib/features/SmartGatewayFeatureHub.js | SmartGatewayFeatureHub (P2563-P2568) - branding-free gateway smart features. |
lib/features/SoftAmbientSync.js | SoftAmbientSync (P2564) - branding-free Soft Ambient Sync. |
lib/features/SoftDaylightFade.js | SoftDaylightFade (P2563/P2564) - full branding-free daytime white / Adaptive-Lighting feel. |
lib/features/SoftDeviceLink.js | SoftDeviceLink (P2565) - unbranded soft remote->light link (IKEA Tradfri/Dirigera binding feel). |
lib/features/SoftFeatureCatalog.js | SoftFeatureCatalog (P2567) - loads 200 unbranded smart-feature vectors. |
lib/features/SoftRecipeRunner.js | SoftRecipeRunner (P2567/P2568) - executes ALL 200 catalog vectors end-to-end. |
lib/features/SolarElevation.js | SolarElevation - NOAA Solar Position Calculator FEATURE #80 Calculates solar elevation angle for a given geographic location and timestamp using the NOAA Solar Calculator algorithm: https://gml.noaa.gov/grad/solcalc/sola |
lib/features/StaggeredLeaveOff.js | StaggeredLeaveOff (P2565) - unbranded mesh-friendly leave-home all-off (Lutron/ST feel). |
lib/features/StateHistoryTrigger.js | _no header_ |
lib/features/TariffCalculator.js | TariffCalculator - Multi-Rate Energy Cost Calculation FEATURE #83 Calculates energy costs across multiple tariff tiers: - Time-of-use (TOU) tariffs with day/night/peak/shoulder/off-peak - Tiered pricing (progressive rate |
lib/features/TransitionEngine.js | TransitionEngine - Smooth Multi-Step Transitions FEATURE #81 Provides smooth multi-step transitions for device capabilities: - Linear, ease-in, ease-out, ease-in-out, cubic bezier interpolation - Color temperature transi |
lib/features/TuyaCloudSceneSync.js | Tuya Cloud Scene Sync - FEATURE #49 Synchronizes scenes between Tuya Cloud and Homey: - Import Tuya cloud scenes as Homey flows - Map scene actions to device commands - Bidirectional scene sync |
lib/features/WelcomeHomeSoft.js | WelcomeHomeSoft (P2565) - unbranded arrival lighting (SmartThings/Aqara welcome feel). |
lib/features/ZigbeeMeshMap.js | ZigbeeMeshMap - settings spider-web snapshot (MASTER_ONLY) WHY: Homey users want a Z2M-style mesh view without leaving App Settings. |
lib/features/index.js | Features Index - v9.1.0 Centralized exports for all feature modules |
lib/filter/EventDeduplicationLayer.js | +==============================================================================+ \| EVENT DEDUPLICATION LAYER v9.0.47 (porté de stable-v5 v5.5.670) \| +==================================================================== |
lib/filter/SanityFilter.js | _no header_ |
lib/flow/ActuatorFlowHelper.js | P130 - Shared actuator flow helpers. |
lib/flow/AdaptiveLightingCards.js | P3065 D11 (t576u) - Flow cards for adaptive lighting (Solar Sync / Daylight Atmosphere curve), per device. |
lib/flow/AdvancedFlowCardManager.js | ADVANCED FLOW CARD MANAGER Inspiré des meilleures pratiques de: - Johan Bendz (Philips Hue Zigbee) - Maxmudjon (Aqara & Xiaomi) - StyraHem (SONOFF Zigbee) - Device Capabilities App Implémente des flow cards avancées pour |
lib/flow/BatteryHealthFlowHandler.js | BatteryHealthFlowHandler v1.0.0 Handles flow card run listeners for the battery health intelligence system: - Triggers: battery_health_changed, battery_needs_replacement - Conditions: battery_health_below_threshold - Act |
lib/flow/CapabilityChangedFlowEmitter.js | P2747 / P2748 - Emit declared Homey Flow cards that carry TAGS (tokens) when a capability value actually changes - from ANY paint path (safeSet, confirmInbound, raw setCapabilityValue, complementary RX/TX). |
lib/flow/CapabilityValueCards.js | P3065 flow uplift (t569u/t570u) - three generic, app-level cards that cover EVERY capability of every driver, including sub-capabilities (per gang / channel / phase: onoff.gang2, measure_power.l1) and app-defined custom |
lib/flow/DeadFlowAutoWire.js | DeadFlowAutoWire: give dead driver triggers and listener-less conditions a capability-based behaviour (P2803). |
lib/flow/DeclaredFlowCardAutoWire.js | P2449 - Auto-wire declared flow cards that were historically dead. |
lib/flow/DeviceSettingAction.js | P2773 - generic "Set a device setting" Flow action (app-level card device_set_setting). |
lib/flow/FamilyCapabilityCards.js | P3065 D10 (b) - dedicated, app-level family cards for the custom capabilities that so far only had the generic capability_value_* cards: alarm_human, frost_protection, power_on_behavior. |
lib/flow/FeatureFlowCards.js | FeatureFlowCards - Flow Card Registration for Feature Modules v9.1.0 Registers run listeners for all flow cards declared in .homeycompose/flow/ that correspond to the new feature modules: - SolarElevation (Adaptive Light |
lib/flow/FlowCardDeviceResolve.js | P2635 - Shared Homey Flow device/arg/state helpers (switches, buttons, actuators) WHY: Homey SDK3 device triggers with dropdown args require registerRunListener to compare args <-> state. |
lib/flow/FlowCardGetters.js | Flow card getter stubs for incomplete Homey flow includes. |
lib/flow/FlowCardHeuristics.js | Universal flow-card ID heuristics (P104 + P108 case-less) Homey compose often has hybrid/copied IDs (air_purifier_switch_1gang_physical_on) or truncated hash suffixes. |
lib/flow/FlowCardManager.js | Flow Card Manager v5.9.0: DYNAMIC registration of ALL flow cards from app.json manifest. |
lib/flow/FlowCardPresence.js | FlowCardPresence (P2830) - cheap, cached "is this flow card declared in the manifest?" check and a bounded fan-out limiter for event-driven flow triggers. |
lib/flow/FlowStormGuard.js | P3065 D13 (t582u) - one shared, bounded guard for every generic Flow card module. |
lib/flow/FlowTriggerHelpers.js | _no header_ |
lib/flow/GenericDeviceCards.js | P2775 - generic, app-level device Flow cards (one card for every driver, keeps the manifest small). |
lib/flow/InteractionHistory.js | P2687 - Interaction history helpers (pure + ring prune). |
lib/flow/LeftOpenScheduler.js | P3077 flow batch 7: "Left open for duration" triggers declared on contact drivers had no emitter. |
lib/flow/ManifestDriverFlowIndex.js | WHY: Homey builds driver.flow.compose.json into the ROOT app manifest (homey.manifest.flow.*) with a device arg filter driver_id=<id>. |
lib/flow/PlaceholderActionWiring.js | PlaceholderActionWiring (#113): some generated driver action cards only logged and returned success. |
lib/flow/PredictiveFlowCards.js | P2777 - predictive / smart Flow cards (master only, additive, app-level). |
lib/flow/SceneRecallCards.js | P3065 D12 (t575u) - raw "scene recalled" trigger for any remote that sends a ZCL Scenes recall (cluster 0x0005, command recall / recallScene, or a currentScene report). |
lib/flow/SwitchActuatorFlowAutoWire.js | P2635 - Fleet auto-wire for switch / wall_switch / plug actuator Flow cards. |
lib/flow/TriggerGuards.js | P2770 - generic trigger guards (additive, non-blocking). |
lib/flow/UniversalFlowCardLoader.js | UniversalFlowCardLoader - v5.5.597 Fixes forum posts 1015/1016: Dynamic FlowCard listeners for sub-capabilities |
lib/flow/UnknownCommandFlowCards.js | P3016: app-level Flow cards for unknown commands and DPs. |
lib/flow/index.js | _no header_ |
lib/garage/garageTrigger.js | P3144 (forum Apps cat. topic 149230 #5 + Z2M tuya.ts TS0603 _TZE608_*): these openers expose DP1 as a raw "trigger the door movement" (Z2M: state STATE_SET, valueConverter.raw) and DP3 as the contact. Writing DP1=false ( |
lib/green_power.js | +==============================================================================+ \| GREEN POWER & UTILITY ENDPOINTS MODULE v1.0 \| +==============================================================================+ \| \| \| |
lib/groups/DeviceGroupManager.js | _no header_ |
lib/groups/index.js | _no header_ |
lib/health/DeviceHealthDashboard.js | _no header_ |
lib/health/HealthMonitor.js | _no header_ |
lib/health/index.js | Health Module Index - v9.1.0 Centralized exports for all health monitoring modules. |
lib/helpers/BatteryRouter.js | BATTERY ROUTER - Smart Battery Source Selection WHY (P215 / P2269): - Pourquoi: pick ZCL vs Tuya DP vs voltage without inventing linear % curves. |
lib/helpers/CalibrationLedger.js | CalibrationLedger - P3002: one calibration per reading. |
lib/helpers/CapabilityCleanup.js | CapabilityCleanup - Remove incorrect capabilities from devices Fixes capability issues caused by wrong driver assignment or dynamic capability detection errors. |
lib/helpers/ColorConverter.js | _no header_ |
lib/helpers/CustomPairingHelper.js | CustomPairingHelper - Universal helper for custom pairing views Handles driver selection when multiple drivers match same device fingerprint Compatible with Homey SDK3 official Custom Pairing Views API SDK3 COMPLIANT: No |
lib/helpers/DeviceDataHelper.js | _no header_ |
lib/helpers/DeviceHintsDatabase.js | _no header_ |
lib/helpers/DeviceIdentificationDatabase.js | _no header_ |
lib/helpers/FallbackSystem.js | FALLBACK SYSTEM - Intelligent Multi-Strategy Système intelligent qui essaye multiple stratégies jusqu'à succès Basé sur best practices d'autres apps Homey (IKEA, Xiaomi, SONOFF) Features: - Multi-level fallback (Strategy |
lib/helpers/IntelligentDPAutoDiscovery.js | Keep the legacy helper path alive while using the hardened central learner. |
lib/helpers/IntelligentPresenceInference.js | _no header_ |
lib/helpers/LateCapability.js | P3064: add an optional capability the first time the device proves it has the feature (a real report arrives), then write the value. |
lib/helpers/ManufacturerCatalog.js | ManufacturerCatalog - Maps manufacturer names/prefixes to IoT categories, recommended capabilities, and flow cards. |
lib/helpers/ManufacturerDeviceQuirkRegistry.js | _no header_ |
lib/helpers/ManufacturerNameHelper.js | _no header_ |
lib/helpers/MeterSilenceWatchdog.js | P3213 - MeterSilenceWatchdog (t783u, diag fb5be1fe "energy meter pairs but cannot be read"). |
lib/helpers/PairingHelper.js | PAIRING HELPER - SDK v3 Compliant Fournit feedback utilisateur pendant le pairing Basé sur Homey SDK v3 PairSession Résout issue forum: "Nothing happens" pendant pairing |
lib/helpers/PowerSourceIntelligence.js | Intelligent Power Source Detection (v6.0) Replaces hardcoded mainsPowered arrays with dynamic detection |
lib/helpers/ProbabilisticDeviceDetector.js | _no header_ |
lib/helpers/QuietMainsAvailPoll.js | P2321 - Quiet mains availability poll heuristics (HomeSuite idea, MIT). |
lib/helpers/RobustInitializer.js | RobustInitializer - Defensive initialization with retry/backoff Implements ChatGPT recommendations + Homey SDK3 best practices Features: - Retry/backoff for missing zclNode - Safe cluster binding with error handling - Ve |
lib/helpers/TuyaOnOffSettingsSync.js | Spec 006 (#1503-class): read-only startup sync of Tuya OnOff manufacturer attributes (0x8000 childLock, 0x8001 indicatorMode, 0x8002 relayStatus = power-on state) into the existing Homey settings. |
lib/helpers/UniversalCapabilityDetector.js | UNIVERSAL CAPABILITY DETECTOR Détecte AUTOMATIQUEMENT toutes les capabilities d'un device: - Clusters Zigbee standards (ON_OFF, TEMPERATURE, etc.) - Clusters Tuya custom (0xEF00 avec DataPoints) - Clusters propriétaires/ |
lib/helpers/UniversalDriverInit.js | UniversalDriverInit - v5.5.929 Universal initialization for ZCL, Tuya DP, and protocols |
lib/helpers/UnknownCaseRealigner.js | UnknownCaseRealigner (P2218) - runtime bridge for incomplete / imprecise cases. |
lib/helpers/UnknownDeviceHandler.js | _no header_ |
lib/helpers/VirtualCapabilities.js | Virtual Capabilities Manager Gere les capabilities derivees et calculees |
lib/helpers/ZclHumidityScale.js | P3245 (GH#581 hogseto): shared ZCL relativeHumidity scaling for every driver. |
lib/helpers/batteryPowerSource.js | WHY(P2296): Homey SDK battery-status - measure_battery XOR alarm_battery; energy.batteries required when either is present. |
lib/helpers/device_helpers.js | Device Helpers - Utility functions for device management Based on: Mega-Prompt V2, SDK3 best practices, Zigbee2MQTT research Functions: - safeAddCapability: Add capability with blacklist & error handling - detectMultiGan |
lib/helpers/powerUtils.js | Power Management Utilities Based on Homey Battery Best Practices Official Doc: https://apps.developer.homey.app/the-basics/devices/best-practices/battery-status CRITICAL RULE: Never use both measure_battery AND alarm_bat |
lib/hosted/air_conditioner_aetz01/device.js | P3331 shim: replaced in the Athom payload by drivers/air_conditioner_aetz01/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/curtain_sonoff_mini_zbrbs/device.js | P3331 shim: replaced in the Athom payload by drivers/curtain_sonoff_mini_zbrbs/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/energy_meter_3ch_bidirectional/device.js | P3331 shim: replaced in the Athom payload by drivers/energy_meter_3ch_bidirectional/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/gpo_double_light_mg_au03/device.js | P3331 shim: replaced in the Athom payload by drivers/gpo_double_light_mg_au03/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/gpo_double_mg_gpo02z/device.js | P3331 shim: replaced in the Athom payload by drivers/gpo_double_mg_gpo02z/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/heiman_siren/device.js | P3331 shim: replaced in the Athom payload by drivers/heiman_siren/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/heiman_siren/driver.js | P3331 shim: replaced in the Athom payload by drivers/heiman_siren/driver.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/keypad_alarm_wke502z/device.js | P3331 shim: replaced in the Athom payload by drivers/keypad_alarm_wke502z/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/presence_radar_aoyan_ay204t/device.js | P3331 shim: replaced in the Athom payload by drivers/presence_radar_aoyan_ay204t/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/siren_moes_mg_bjq002/device.js | P3331 shim: replaced in the Athom payload by drivers/siren_moes_mg_bjq002/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/smoke_sensor_ts0601_dp/device.js | P3331 shim: replaced in the Athom payload by drivers/smoke_sensor_ts0601_dp/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/switch_2gang_ts0002/device.js | P3331 shim: replaced in the Athom payload by drivers/switch_2gang_ts0002/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/switch_2gang_ts0002/driver.js | P3331 shim: replaced in the Athom payload by drivers/switch_2gang_ts0002/driver.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/switch_wall_6gang_metering/device.js | P3331 shim: replaced in the Athom payload by drivers/switch_wall_6gang_metering/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/thermostat_vrf_bvrf_l001/device.js | P3331 shim: replaced in the Athom payload by drivers/thermostat_vrf_bvrf_l001/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/ufh_controller_ch8z/device.js | P3331 shim: replaced in the Athom payload by drivers/ufh_controller_ch8z/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/ufh_controller_pro_line_x10/device.js | P3331 shim: replaced in the Athom payload by drivers/ufh_controller_pro_line_x10/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/valve_novato_zpv01/device.js | P3331 shim: replaced in the Athom payload by drivers/valve_novato_zpv01/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/water_leak_aoyan_ay222z/device.js | P3331 shim: replaced in the Athom payload by drivers/water_leak_aoyan_ay222z/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/hosted/water_leak_blitzwolf_bw_is9/device.js | P3331 shim: replaced in the Athom payload by drivers/water_leak_blitzwolf_bw_is9/device.js (see docs/rules/HOSTED_HELD_DRIVERS.md). |
lib/index.js | Tuya Unified Zigbee - Main Library Index v5.5.797: Complete audit and reorganization Provides organized access to all library modules Usage: const { Battery, Security, Tuya, Flow } = require('./lib'); const batterySystem |
lib/intelligent/IntelligentDeviceAdapter.js | =============================================================================== INTELLIGENT DEVICE ADAPTER - v5.5.373 =============================================================================== Smart adaptive system |
lib/interpreters/UniversalRawInterpreter.js | UniversalRawInterpreter - v5.5.795 Interprets raw Zigbee data that doesn't go through standard Homey methods. |
lib/io/DeviceFusionHooks.js | _no header_ |
lib/io/DeviceIOFacade.js | _no header_ |
lib/io/HomeyCompensationLayer.js | HomeyCompensationLayer (P102 Phase 2 / P2250 / P2699) Compensates incomplete Homey interview / SDK cluster coverage. |
lib/io/NonNativeComplementary.js | P2699 / P2700 - Non-native Homey DP / clusters -> complementary only (never mandatory). |
lib/io/ProtocolFallbackChain.js | ProtocolFallbackChain (P102 Homey compensation) Ordered TX/RX strategies with per-step try/catch - never fatal. |
lib/io/healZigbeeNodeIdentity.js | healZigbeeNodeIdentity - P2314 PresentSky / Gmail m1cvyneb WHY: Homey throws "Missing Zigbee Node's IEEE Address (token: ...)" when zclNode lost ieeeAddr after re-pair while getData().token still exists. |
lib/io/index.js | lib/io - Homey compensation + protocol I/O surface (P102) |
lib/io/shouldSkipIasOnlyEf00Tx.js | IAS leftover EF00 TX skip (P2287 / ias_sleepy). |
lib/ir/HomeyInfraredTx.js | P2487c - Homey Pro 2023 onboard IR TX (third Intelligent IR path). |
lib/ir/IRCodeLibrary.js | IRCodeLibrary - Universal IR code database for ir_blaster driver Provides brand/device/function lookup with pre-loaded codes from IRDB Also includes hardcoded common codes for popular brands (NEC protocol) |
lib/ir/IRFloodGuard.js | P2501 - IRFloodGuard (Intelligent IR anti-spam / anti-flood) WHY: Flow loops, virtual remotes, and double-presses flood IR LEDs, Zosung chunk TX, WiFi DP201, and Homey Pronto RF - causes MCU lag / missed codes. |
lib/ir/IRFormatConverter.js | P2487 - IR format converters (Pronto / Broadlink / HEX / Global Caché -> Zosung or opaque WiFi). |
lib/ir/IntelligentIRRouter.js | P2487 - IntelligentIRRouter WHY: One send/learn/list API for Zigbee Zosung + WiFi Tuya + Homey Pro 2023 onboard IR. |
lib/ir/TuyaWifiIRProtocol.js | P3063 - Tuya Wi-Fi IR blaster local DP protocol (pure, testable). |
lib/ir/ZosungIRProtocol.js | P3063 - Zosung / Tuya IR protocol helpers (pure, no Homey dependency). |
lib/ir/irWizardSession.js | P2487 - Homey pair/repair session handlers for shared IR wizard HTML. |
lib/layers/CrossLayerRedundancy.js | CrossLayerRedundancy (P207) Purpose (user doctrine): layers exist to compensate incompatible ZCL / DP / proprietary clusters, interview gaps, unsupported attrs from diags/crashes, and to confirm inbound/outbound data via |
lib/layers/LayerInterface.js | Spec 004 - common contract for NON-native channels (Tuya DP 0xEF00, 0xE000-0xE002, manufacturer-specific clusters, raw frames). |
lib/layers/LayerSignalFusion.js | LayerSignalFusion (P211) Intelligent gate when the same Homey capability is fed by two+ protocol layers (ZCL + Tuya DP, IAS + DP, voltage + ZCL battery, ...). |
lib/layers/LegacyLayerAdapters.js | Spec 004 T2 - expose the existing low-level bridge (lib/LowLevelBridge.js) and the RX/TX chain (lib/layers/ProtocolRxTxChain.js) through the common layer contract (lib/layers/LayerInterface.js) without changing their beh |
lib/layers/ProtocolRxTxChain.js | ProtocolRxTxChain (P208 / P2270) ARCH / SSOT: Function table of every Zigbee/Tuya I/O path Homey may use. |
lib/layers/ReconnectBurstCoalescer.js | Power-restore burst: ZCL switches dump relay + backlight + button-mode attributes in a few dozen ms. |
lib/layers/UniversalLayerBootstrap.js | UniversalLayerBootstrap - soft-attach proprietary protocol layers that Unified* bases already wire, but bare TuyaZigbeeDevice lineages (lights, IR, DIY, TuyaSpecificCluster) often miss. |
lib/layers/commitCapability.js | commitCapability - single RX funnel into CrossLayer confirmInbound / L14. |
lib/learning/DpScaleLearner.js | DpScaleLearner - per-device memory of which scale (/1, /10, /100, /1000) the SmartDivisor auto-convert path keeps choosing for each unmapped DP (P3073 §3). |
lib/lighting/AdaptiveLightingCurve.js | AdaptiveLightingCurve - pure math for the app-level adaptive lighting engine. |
lib/lighting/AdaptiveLightingEngine.js | AdaptiveLightingEngine - ONE app-level, owned, bounded scheduler that makes every opted-in light follow the sun (P3067, inspiration: iGen 2026-10-26). |
lib/lighting/ColorEffectManager.js | ColorEffectManager - RGB Color Effects Inspired by fairecasoimeme/ZigWS2812_controller Provides stunning color effects for RGB lights Features: - Rainbow effect - Breathe effect - Strobe effect - Fade effect - Custom eff |
lib/lighting/index.js | Lighting Module - RGB Effects and Control |
lib/managers/AdaptiveLightingManager.js | _no header_ |
lib/managers/AlarmPolarityManager.js | AlarmPolarityManager - IAS / SOS / water / contact / motion polarity (MASTER_ONLY smart-learn). |
lib/managers/AutonomousMigrationManager.js | _no header_ |
lib/managers/BatchCapabilityUpdater.js | v9.0.40: Batch Capability Updater Collects multiple capability changes and applies them in a single batch to reduce UI update overhead and prevent rapid-fire SDK calls |
lib/managers/CapabilityFallbackManager.js | CapabilityFallbackManager Provides robust fallback, sanitization, and interception for setCapabilityValue to protect Homey SDK from raw Zigbee anomalies, rogue data (e.g. |
lib/managers/CircadianEngine.js | CircadianEngine - Solar Sync for enrolled lights (P92.110 / L99 smart features) Driven by DaylightAtmosphere + SolarElevation (real sun), not a clock guess. |
lib/managers/DPCache.js | v9.0.40: DP Response Cache Caches last known DP values per device for timeout fallback and stale reads Helps maintain UI consistency during brief disconnections |
lib/managers/DeviceAvailabilityManager.js | DeviceAvailabilityManager - v9.0.401 (P92.104) Availability monitoring inspired by zigbee2mqtt's availability feature and ZHA timeouts, adapted to Homey SDK3 and hardened for a 400+ driver app: - Every incoming frame mar |
lib/managers/DriverMigrationManager.js | _no header_ |
lib/managers/DynamicCapabilityManager.js | _no header_ |
lib/managers/EnergyManager.js | EnergyManager - Comprehensive Energy Monitoring System Features: - Power threshold alerts (high/low) - Energy consumption tracking - Cost calculation - Daily/weekly/monthly statistics - Power factor monitoring - Overload |
lib/managers/FeatureFallbackRouter.js | FeatureFallbackRouter - v9.0.407 (P92.109) Principle requested by the maintainer: EVERY native feature/flow must have a software fallback when the device does not support the native path, so the feature works on ALL driv |
lib/managers/HomeModeManager.js | HomeModeManager - v9.0.409 (P92.113) Home modes (day/evening/night/away) inspired by Hubitat Mode Manager and SmartThings location modes - smarter than the references: - Auto transitions driven by the REAL sun (SolarElev |
lib/managers/IASZoneEnhanced.js | IAS ZONE ENHANCED MANAGER Improved IAS Zone (cluster 1280/0x500) handling for: - Contact sensors - Motion/PIR sensors - Smoke detectors - Water leak sensors - Vibration sensors Based on Homey Apps SDK documentation: http |
lib/managers/IASZoneManager.js | _no header_ |
lib/managers/IEEEAddressManager.js | IEEEAddressManager - Centralized IEEE Address Management for Zigbee devices v5.5.807: SDK3 COMPLIANCE FIX - Per Homey documentation - Removed hardcoded fallback IEEE address (was causing enrollment failures) - Homey v8.1 |
lib/managers/IEEEAdvancedEnrollment.js | IEEEAdvancedEnrollment - Advanced IAS Zone enrollment Extends IEEEAddressManager with: - reEnrollCie: zero + write per ZCL 8.2.2.2.3 - sendProactiveEnroll: SDK3 best practice - setupEnrollListener: auto-respond to enroll |
lib/managers/IntelligentDataManager.js | [SMART] INTELLIGENT DATA MANAGER Système intelligent de gestion des données capteurs basé sur: - ZHA (Home Assistant Zigbee integration) - Zigbee2MQTT best practices - Tuya Gateway protocols - Zigbee Cluster Library spec |
lib/managers/MotionCascadeManager.js | MotionCascadeManager - v9.0.408 (P92.110) Path lighting ((quoted passage, see the file header)) + autonomous auto-off, inspired by Hue motion-activated rooms and Xiaomi/Aqara gateway |
lib/managers/MultiEndpointManager.js | MultiEndpointManager - Gestion devices multi-endpoint Résout: Bseed 2 gang -> Endpoint 2 pas configuré Configure reporting pour TOUS les endpoints |
lib/managers/PowerManager.js | PowerManager - Intelligent AC/DC Power Management Handles power measurements, estimations, and dynamic capability management |
lib/managers/PowerSourceDetector.js | _no header_ |
lib/managers/PresenceSimulationManager.js | PresenceSimulationManager - v9.0.403 (P92.106) Inspired by Tuya Smart Life "random timing" schedules and Philips Hue Labs "presence mimicking": toggles lights at random intervals within a daily window so the home looks o |
lib/managers/SensorSuppressionManager.js | SensorSuppressionManager - v9.0.402 (P92.105) Inspired by the Philips Hue app's "suppress sensor" flow action: temporarily mute a motion/presence sensor's flow triggers (e.g. |
lib/managers/SmartBatteryManager.js | _no header_ |
lib/managers/SmartDivisorManager.js | +==============================================================================+ \| SMART DIVISOR MANAGER - v9.1.0 (Cross-Protocol) \| +==============================================================================+ \| W |
lib/managers/SmartDriverAdaptation.js | _no header_ |
lib/managers/SmartEnergyManager.js | SmartEnergyManager - measured vs estimated energy discovery (P108 + P2556 provenance) Lifecycle: 1. |
lib/managers/UniversalFlowCardManager.js | UniversalFlowCardManager - Centralized registration for all Algorithmic/Smart flow cards. |
lib/managers/UniversalVariantManager.js | UniversalVariantManager - v5.8.44 Dynamic capability detection for manufacturer variants. |
lib/managers/VirtualEnergyEstimator.js | +==============================================================================+ \| VIRTUAL ENERGY ESTIMATOR - v1.0.0 (Opus 4.6 Feature) \| +==============================================================================+ |
lib/managers/VirtualEnergyManager.js | _no header_ |
lib/managers/availability-learning.js | availability-learning - P3028 (master soak) Small pure helpers used by DeviceAvailabilityManager to learn how often each device really talks, so that a sleepy sensor or a remote is not reported "unavailable" just because |
lib/managers/index.js | Managers Index - v5.5.797 Centralized exports for all system managers |
lib/memory/BoundedCollections.js | P3068: drop-in bounded collections for long-lived runtime caches (Homey heap ~64 MB). |
lib/memory/BoundedMap.js | P3023: BoundedMap - a Map with a HARD entry cap (LRU eviction) and an optional TTL. |
lib/memory/CatalogStore.js | P3023: CatalogStore - one lazy, sharded, releasable view of the DP catalogue. |
lib/memory/DeviceTrim.js | P3023: DeviceTrim - shrink one device's OPTIONAL in-memory caches under memory pressure. |
lib/memory/MemoryBudget.js | _no header_ |
lib/memory/SettingsBudget.js | P3312: a boot-time size budget for app settings. |
lib/memory/budget-hooks.js | P3023: wire the app-wide MemoryBudget (one instance per app) to the optional caches. |
lib/mesh/DriverConsequenceTiering.js | =========================================================================== DriverConsequenceTiering.js - Adaptation du consequence_class de Polos Classifie chaque driver Tuya par niveau de conséquence pour tiering d'ove |
lib/mixins/ButtonCaptureCascade.js | ButtonCaptureCascade (P2223 / P2228 / P2395) Complements PhysicalButtonMixin with declarative L1-L8 capture levels. |
lib/mixins/CapabilityManagerMixin.js | _no header_ |
lib/mixins/CoreCapabilityMixin.js | CoreCapabilityMixin - v6.1.1 (P2330) Provides common helper methods to drivers that might not inherit correctly from BaseUnifiedDevice. |
lib/mixins/DeviceEnhancementsMixin.js | _no header_ |
lib/mixins/LegacyButtonDetectionMixin.js | +==============================================================================+ \| LegacyButtonDetectionMixin v9.0.47 \| \| Fallback de détection boutons porté depuis stable-v5 + masterwlan \| +========================= |
lib/mixins/LockControlMixin.js | P130 - Writable lock control for devices that expose locked. |
lib/mixins/MultiGangMixin.js | MultiGangMixin - v7.0.22 Native Homey SDK 3 grouping for multi-button/gang Tuya devices. |
lib/mixins/NamedButtonFallback.js | v9.0.411 (P92.119): Named maintenance-button fallbacks. |
lib/mixins/NaturalLightMixin.js | _no header_ |
lib/mixins/PeriodicAutoEnricherMixin.js | PeriodicAutoEnricherMixin - v5.8.44 REWRITE VALUE REFRESH ONLY - no longer adds capabilities. |
lib/mixins/PhysicalButtonMixin.js | _no header_ |
lib/mixins/PowerSwitchFeaturesMixin.js | PowerSwitchFeaturesMixin - v1.0.0 Adds power-on behavior (DP 12) and backlight mode (DP 2) to Tuya switches/plugs. |
lib/mixins/SafeCapabilityMixin.js | SafeCapabilityMixin - v9.0.240 Adds safeSetCapabilityValue(capability, value) to every device. |
lib/mixins/SmartEnrichmentMixin.js | _no header_ |
lib/mixins/SmartFeatureEmulationMixin.js | _no header_ |
lib/mixins/SmartKnobRotationMixin.js | SmartKnobRotationMixin (P2448 / P2449) Shared rotate RX + flow UX for smart_knob / smart_knob_switch / rotary siblings. |
lib/mixins/SonoffEnergyMixin.js | _no header_ |
lib/mixins/SonoffEwelinkMixin.js | _no header_ |
lib/mixins/SonoffSensorMixin.js | _no header_ |
lib/mixins/SonoffTRVZBMixin.js | _no header_ |
lib/mixins/TuyaDeviceMixin.js | _no header_ |
lib/mixins/TuyaThermostatEnhancedMixin.js | TuyaThermostatEnhancedMixin - v1.0.0 Dynamic thermostat mode injection for Tuya Zigbee radiators/thermostats. |
lib/mixins/UnifiedButtonEngine.js | =========================================================================== UnifiedButtonEngine.js - VERSION COMPACTE UNIFIÉE Combine le MEILLEUR de toutes les versions (v5.11.x -> master v9.x) Toutes les root causes rés |
lib/mixins/VirtualButtonMixin.js | VirtualButtonMixin - Homey app UI <-> physical multi-gang devices Contract: 1. |
lib/mixins/VirtualEnergyMeterMixin.js | _no header_ |
lib/mixins/ZigbeeHealthMixin.js | _no header_ |
lib/multichannel/ChannelAdapters.js | lib/multichannel/ChannelAdapters.js - v1.0 (P37.1) |
lib/multichannel/MultiChannelManager.js | lib/multichannel/MultiChannelManager.js - v1.0 (P37.2) |
lib/multichannel/ParallelDetector.js | lib/multichannel/ParallelDetector.js - v1.0 (P37.3) |
lib/multichannel/ReceptionManager.js | lib/multichannel/ReceptionManager.js - v1.1 (P211) |
lib/multichannel/TransmissionManager.js | lib/multichannel/TransmissionManager.js - v1.0 (P37.4) |
lib/multichannel/index.js | lib/multichannel/index.js - v1.0 (P37.8) |
lib/ota/HomeyDeviceUpdates.js | Homey Device Updates helper (P2357 / P2359) Native Zigbee OTA via Homey >=13.2 + Mobile >=9.10. |
lib/ota/OTARepository.js | OTARepository - Firmware Image Repository Inspired by fairecasoimeme/zigbee-OTA and Zigbee2MQTT OTA guide Multi-source OTA firmware repository for Zigbee devices Features: - Multi-source support (Koenkk, fairecasoimeme) |
lib/ota/OTAUpdateManager.js | OTAUpdateManager - OTA Update Orchestration Inspired by fairecasoimeme/zigbee-OTA Manages OTA firmware updates for Zigbee devices Features: - Automatic update checking - Progress monitoring - Retry mechanism - User notif |
lib/ota/TuyaMcuOtaFrames.js | P2932 - Tuya EF00 MCU OTA frames (observation only). |
lib/ota/TuyaXiaomiOTAProvider.js | _no header_ |
lib/ota/index.js | OTA Module - Firmware Updates |
lib/overlays/LumiVibrationOverlay.js | P2934 - Optional Aqara DJT11LM (LUMI / lumi.vibration.aq1) overlay. |
lib/pairing/AntiFallbackGeneric.js | AntiFallbackGeneric - Prevents zigbee generic fallback |
lib/pairing/AutoDetectionPairingWizard.js | AutoDetectionPairingWizard - v1.0.0 Enhanced pairing flow with automatic device detection Features: - Auto-detect device type from manufacturer/product ID - Suggest optimal driver based on device capabilities - Auto-conf |
lib/pairing/DynamicEndpointDiscovery.js | DynamicEndpointDiscovery - Find functional endpoint dynamically Problem: Many Tuya devices don't use endpoint 1 |
lib/pairing/EnrichmentScheduler.js | EnrichmentScheduler - Post-pairing enrichment with retry & fallback CRITICAL: Implements retry logic with exponential backoff - Time sync (immediate) - IAS binding (with fallback to polling) - Cluster discovery (all endp |
lib/pairing/EventDeduplicator.js | EventDeduplicator - Prevents duplicate flow triggers |
lib/pairing/LearnmodeTemplates.js | LearnmodeTemplates (P2498) WHY(P215): Athom owns Zigbee pair UI - our only pairing UX surface is zigbee.learnmode.instruction (+ image). |
lib/pairing/PermissiveMatchingEngine.js | _no header_ |
lib/pairing/TuyaTimeSyncEngine.js | TuyaTimeSyncEngine - Critical for Tuya devices that wait for time sync Many Tuya sensors won't report until they receive time sync |
lib/pairing/TwoPhaseEnrichment.js | TwoPhaseEnrichment - 2-phase pairing for Tuya devices Phase 1: Accept device (minimal matching) Phase 2: Post-pairing enrichment |
lib/pairing/UXMessages.js | UXMessages - User-friendly status messages for pairing Reduces 80% of forum tickets by showing clear status |
lib/pairing/UniversalPairingManager.js | UniversalPairingManager - Universal Device Pairing Inspired by fairecasoimeme/ZiGate pairing patterns Intelligent device identification and configuration Features: - Automatic device type detection - Quirk application - |
lib/pairing/UserMisattributionRegistry.js | UserMisattributionRegistry - community wrong-driver / pairing conflict cases. |
lib/pairing/index.js | Pairing Module - Universal Pairing System |
lib/pairing/logPairingIdentity.js | logPairingIdentity.js (P2366) WHY: Unknown Zigbee Device diags often lack mfr+pid - emit at pairing for next diag. |
lib/performance/AutoDiscoveryPollingOptimizer.js | Auto-Discovery Polling Optimization - PERFORMANCE #63 Optimizes device discovery polling with: - Adaptive polling intervals based on network activity - Priority-based device scanning - Batch discovery requests - Smart co |
lib/performance/BootBudget.js | BootBudget - keep Homey Pro JS heap + RSS free for driver onNodeInit, then run the same features later when RAM and radio allow it. |
lib/performance/DiagnosticLoggerRotation.js | DiagnosticLogger Buffer Rotation - PERFORMANCE #70 Manages diagnostic log buffer with automatic rotation: - Size-based rotation (rotate when buffer exceeds limit) - Time-based rotation (rotate every N minutes) - Compress |
lib/performance/FragmentBufferMemoryLimiter.js | Fragment Buffer Memory Limit - PERFORMANCE #64 Monitors and limits memory usage of fragment reassembly buffers: - Per-device buffer size tracking - Global memory budget enforcement - LRU eviction when limits exceeded - M |
lib/performance/IntelligentLazyLoad.js | IntelligentLazyLoad - Ship M / P2586 (Homey-safe) WHY: Homey Pro ~64MB RSS - defer/scale, never eager-load giant JSON at boot. |
lib/performance/MemoryLeakDetector.js | Memory Leak Detection - PERFORMANCE #74 Monitors heap usage for memory leaks: - Periodic heap snapshots - Growth rate analysis - Object count tracking - Leak suspicion scoring |
lib/performance/PerformanceOptimizer.js | _no header_ |
lib/performance/SmartClusterEngineThrottling.js | SmartClusterEngine Throttling - PERFORMANCE #69 Intelligent throttling for cluster read/write operations: - Per-device operation queuing - Adaptive rate limiting based on network congestion - Priority-based operation sch |
lib/performance/StartupTimeProfiler.js | _no header_ |
lib/performance/TuyaDPCompression.js | TuyaDP JSON Compression - PERFORMANCE #67 Compresses and optimizes Tuya DP data storage: - Dictionary encoding for repeated string values - Delta encoding for sequential numeric values - Run-length encoding for repeated |
lib/performance/index.js | _no header_ |
lib/presence/AdvancedPresenceEngine.js | AdvancedPresenceEngine - Multi-technology fusion and occupancy prediction Combines: - RoomSignalAggregator capability events - MotionAwarePresenceDetector / ZigbeeHealthMixin RSSI/LQI inputs - SignalCartography coverage |
lib/presence/NetworkPresenceCorrelation.js | NetworkPresenceCorrelation - WiFi / Bluetooth / router-based presence proxy Homey SDK3 does not expose raw WiFi RSSI, ARP tables, or Bluetooth scans, so this module uses indirect signals that are available inside Homey a |
lib/presence/PresenceConfidenceScorer.js | PresenceConfidenceScorer - Multi-signal confidence scoring engine v1.0.0: Calculates presence confidence (0-100%) from multiple device signals. |
lib/presence/RoomSignalAggregator.js | RoomSignalAggregator - Listens to device capability changes and maps them to presence signals v1.0.0: Subscribes to Homey device capability events, maps them to SIGNAL types, and feeds them into PresenceConfidenceScorer. |
lib/presence/SignalCartography.js | SignalCartography - Zigbee LQI-based signal mapping engine Builds a live radio map of the home from device-reported LQI values. |
lib/presence/SignalTriangulation.js | SignalTriangulation - Zigbee signal-space room estimation This does NOT perform physical RF triangulation. |
lib/presence/VirtualPresenceDetector.js | VirtualPresenceDetector - Core engine for inferring room presence v1.0.0: Orchestrates PresenceConfidenceScorer + RoomSignalAggregator to provide real-time room occupancy estimation without a dedicated presence sensor. |
lib/profile-engine/ProfileEngine.js | P-KB2 declarative device profile engine (optional, additive, kill switch). |
lib/profile-engine/ProfileLayerAttach.js | P-KB3 profile layer - wires the declarative profile engine into TuyaZigbeeDevice as an OPTIONAL, ADDITIVE layer. |
lib/profile-engine/availability.js | P-KB2 availability (idea from Z2M availability feature: active vs passive timeouts). |
lib/profile-engine/groups.js | P-KB3 Zigbee groups (Z2M groups idea, own implementation): opt-in membership via setting pe_group_id (1..0xFFF7). |
lib/profile-engine/options.js | P-KB2 generic report options (own implementation of ideas from Zigbee2MQTT generic device options: debounce, throttle, filtered_attributes, optimistic - https://www.zigbee2mqtt.io/guide/configuration/devices-groups.html) |
lib/profile-engine/transforms.js | P-KB2 profile engine - value transforms (own implementation). |
lib/profile-engine/transition.js | P-KB3 transition (Z2M "transition" option, own implementation): optional transitionTime (1/10 s) for level/color commands. |
lib/profiles/LinptechES1Profile.js | P2258 / P2261 - Linptech ES1ZZ(TY) / Moes ZSS-LP-HP02-MS mmWave presence (TS0225) WHY: Settings must NOT go to EF00 DP9 (distance RX collision). |
lib/profiles/ZsSf00Profile.js | P3019: Arteco ZS-SF00 soil fertility sensor - exact couple A89G12C \| Arteco. |
lib/protocol/BindingPersistence.js | Binding Persistence - PROTOCOL #11 Persists Zigbee binding state across restarts and handles: - Binding state persistence to device store - Automatic rebinding on device rejoin - Binding conflict resolution - Group bindi |
lib/protocol/BitmapMultiFieldParser.js | Bitmap Multi-Field Parser - PROTOCOL #3 Parses Tuya bitmap/byte-field DPs into individual boolean/numeric sub-fields. |
lib/protocol/CommunicationPathFinder.js | ARCH / SSOT: Rank Zigbee/Tuya I/O paths for flexible device communications (P2270). |
lib/protocol/DPFragmentationHardening.js | DP Fragmentation Hardening - PROTOCOL #2 Robust reassembly of fragmented Tuya DP payloads with: - Multi-frame reassembly with checksum validation - Timeout-based session cleanup - Duplicate fragment detection - Out-of-or |
lib/protocol/HardwareDetectionShim.js | HardwareDetectionShim - Runtime hardware detection & capability correction Détecte le hardware réel d'un device et corrige automatiquement les capabilities si le driver assigné ne correspond pas au hardware. |
lib/protocol/HybridProtocolArbitrator.js | _no header_ |
lib/protocol/HybridProtocolManager.js | +==============================================================================+ \| [MIX] HYBRID PROTOCOL MANAGER - v5.5.41 INTELLIGENT PROTOCOL DETECTION \| +============================================================= |
lib/protocol/IntelligentProtocolDetect.js | IntelligentProtocolDetect - single source of truth for ZCL <-> Tuya EF00 (0xEF00). |
lib/protocol/IntelligentProtocolRouter.js | _no header_ |
lib/protocol/KnownProtocolsDatabase.js | _no header_ |
lib/protocol/MoesZemismartActionMerge.js | P2834 - Moes / Zemismart complementary action merge (UNION, never degrade). |
lib/protocol/OccupancySensingEnhancement.js | Occupancy Sensing Enhancement - PROTOCOL #5 Enhanced motion/occupancy detection with: - Configurable hold time (auto-clear after N seconds) - Multi-zone occupancy aggregation - Sensitivity levels (low/medium/high) - Pres |
lib/protocol/ScheduleDataEncoder.js | Schedule Data Encoder - PROTOCOL #9 Encodes/decodes Tuya timer and schedule data for thermostats, switches, curtains. |
lib/protocol/ZigbeeProtocolComplete.js | _no header_ |
lib/quirks/FirmwareQuirks.js | FirmwareQuirks - pair-scoped (mfr + pid) workarounds for known firmware bugs. |
lib/quirks/QuirksDatabase.js | QuirksDatabase - Device-Specific Fixes and Workarounds Inspired by fairecasoimeme/zha-device-handlers Contains device quirks, workarounds, and special handling Quirk types: - forceOnOff: Force OnOff cluster instead of Le |
lib/registry/CapabilityMetadata.js | v9.0.40: Capability Metadata Registry (Z2M pattern) Exposes min/max/unit/decimals for capabilities Used by flow cards, UI, and validation |
lib/registry/CentralizedDPRegistry.js | CentralizedDPRegistry - v1.0.0 Single source of truth for all Tuya DataPoint mappings Features: - Consolidated DP definitions from multiple sources - Priority-based conflict resolution - Device type grouping - Runtime qu |
lib/registry/DeviceProfileRegistry.js | _no header_ |
lib/registry/index.js | Device Profile Registry - Index v5.8.80 - Centralizes ALL device profiles and exports registry singleton |
lib/registry/profiles/buttons.js | Button Device Profiles - v5.8.80 Covers: TS0041-TS0046, TS004F, scene switches |
lib/registry/profiles/covers.js | Cover/Curtain Device Profiles - v5.8.80 Covers: TS0601 curtains, TS130F ZCL, TS0302, blind motors |
lib/registry/profiles/lights.js | Light Device Profiles - v5.8.80 Covers: TS0501-TS0505 dimmers/bulbs, TS0601 LED strips |
lib/registry/profiles/plugs.js | Plug Device Profiles - v5.8.80 Covers: TS011F energy plugs, TS0121, TS0601 plugs, water valves |
lib/registry/profiles/sensors.js | Sensor Device Profiles - v5.8.80 Covers: contact, motion, water leak, climate, smoke, vibration, illuminance |
lib/registry/profiles/switches.js | Switch Device Profiles - v5.8.80 Static profiles for all known switch variants Covers: TS0001-TS0004, TS0011-TS0014, TS0601 switches, TS0726 |
lib/registry/profiles/thermostats.js | Thermostat Device Profiles - v5.8.80 Covers: TRVs, thermostats, heater controllers (mostly TS0601) |
lib/reliability/ZigbeeResilience.js | _no header_ |
lib/resilience/FirmwareQuirkCompensator.js | FirmwareQuirkCompensator (P2392) - fleet-wide Homey/Tuya firmware gap compensations. |
lib/resilience/HomeyGapCompensator.js | HomeyGapCompensator (P2222 / P2224 / P2228) - Homey app runtime only. |
lib/scraper/FreeScrapeStack.js | FREE SCRAPE STACK - keyless-first multi-reader orchestrator ========================================================================== Philosophy: burn $0 by default. |
lib/scraper/reader-fallback.js | READER FALLBACK - free web-reader chain for fetches blocked by the origin. |
lib/scraper/smart-fetch.js | SMART FETCH - P55 unified smart scraper lib ========================================================================== One entry point for ALL scrapers, crawlers, dumpers, and fetchers in the project. |
lib/security/CommandRateLimiter.js | Command Rate Limiting Per User - SECURITY #79 Rate limits device commands to prevent abuse: - Per-user command rate tracking - Per-device command rate tracking - Burst allowance with sustained rate limiting - Adaptive ra |
lib/security/DPValueInputValidator.js | DP Value Input Validation - SECURITY #78 Validates incoming DP values before processing: - Type checking - Range validation - Injection prevention - Rate-based anomaly detection |
lib/security/LocalKeyValidator.js | Local Key Validation - SECURITY #76 Validates Tuya local encryption keys: - Format validation (16-byte hex) - Key strength checking - Key rotation tracking - Encrypted communication verification |
lib/security/SecurityGuard.js | lib/security/SecurityGuard.js - v1.0 (P37.7) |
lib/security/UDPDiscoveryKeyRotation.js | UDP Discovery Key Rotation - SECURITY #83 Manages rotation of UDP discovery keys: - Scheduled key rotation - Key derivation from master key - Grace period for old key acceptance - Discovery packet signing/verification |
lib/security/UntrustedContentGuard.js | UntrustedContentGuard (P2527) WHY: Forum / scrape / Gmail / GitHub issue bodies are untrusted DATA - never instructions. |
lib/security/index.js | Security Module Index - v5.5.797 Re-exports security-related managers from their actual locations Using lazy loading to avoid circular dependencies |
lib/sensors/ContactDefaultInvert.js | WHY(P3011): contact_sensor_zigbee + sensor_contact_water had an invertedByDefault list checked with includesCI(mfr, id) - argument order reversed (includesCI expects (array, value)), so it was ALWAYS false and the v5.1 |
lib/sensors/ContactSourceLatch.js | ContactSourceLatch - single source of truth for alarm_contact (P2763). |
lib/sensors/IasZoneTypeRouter.js | IAS zoneType -> Homey alarm capability (ZCL spec 8.2.2.2.1.3). |
lib/sensors/IntelligentDPAutoDiscovery.js | _no header_ |
lib/sensors/IntelligentPresenceInference.js | IntelligentPresenceInference - v8.0.0 Calculates presence from multiple data sources when DP1 returns null Sources: Z2M #27212, #30326, #8939, HA t/862007, ZHA #3969 |
lib/sensors/RadarDirectMode.js | P2791 / GH#550 - radar "direct mode" (per-device opt-in setting radar_direct_mode). |
lib/sensors/SoilDpGuards.js | P3021c - forum #2093 (blutch32, diag 3690dfdb, app v9.0.13, mfr A89G12C). |
lib/sensors/SoilTempScale.js | WHY(P3011): soil drivers checked includesCI(mfr, '_tze200_oitavov2') - reversed argument order, always false, so oitavov2 DP5 always went through the legacy scaling branch. |
lib/session/SessionManager.js | _no header_ |
lib/settings/migrateSettingKey.js | Read the old settings key, write the new one, leave the old value in place. |
lib/shims/color-space-shim.js | Color Space Shim v5.8.25 Fixes: Cannot find module './rgb' error in Homey sandbox |
lib/smart/AdaptiveBackoff.js | P3023: adaptive re-probe backoff (pure). |
lib/smart/ClusterModel.js | ClusterModel - Modèle de données pour les clusters intelligents Types de clusters: - room: pièce implicite (devices corrélés spatialement) - functional: groupe fonctionnel (toutes les lumières, tous les switches) - energ |
lib/smart/ClusterScoring.js | ClusterScoring - Moteur de scoring pour le clustering intelligent Calcule la similarité entre 2 devices en croisant 5 signaux: A. |
lib/smart/ClusterStorage.js | ClusterStorage - Persistance des clusters intelligents Stocke les clusters dans Homey settings (homey.settings) pour survivre aux redémarrages de l'app. |
lib/smart/ConfidenceModel.js | P3023: confidence scoring for interpretations (pure). |
lib/smart/CoupleKnowledge.js | _no header_ |
lib/smart/SmartClusterEngine.js | SmartClusterEngine - Moteur de clustering intelligent Architecture demandée: lib/smart/ +-- SmartClusterEngine.js <- ce fichier +-- ClusterModel.js +-- ClusterScoring.js +-- ClusterStorage.js +-- SmartCoordinator.js Pipe |
lib/smart/SmartCoordinator.js | SmartCoordinator - Orchestrateur des Smart Features Centralise: - SmartEnergyEngine (estimation conso sans capteur) - PresenceEngine (détection présence sans capteur) - SmartClusterEngine (clustering intelligent de devic |
lib/smart/SoakFlags.js | P3023: behaviour changes that SOAK on master before reaching stable-v5 / bastien-home. |
lib/smart/ValueAnomaly.js | P3023: generic value-anomaly detection for reported measurements (per device, bounded). |
lib/smart/index.js | lib/smart/ - Module Smart Features Architecture: lib/smart/ +-- index.js <- Point d'entrée +-- SmartCoordinator.js <- Orchestrateur principal +-- SmartClusterEngine.js <- Moteur de clustering intelligent +-- SmartEnergyE |
lib/smartadapt/SuggestionEngine.js | SuggestionEngine - Non-Destructive Smart Adaptation Instead of automatically removing/adding capabilities, this engine: 1. |
lib/suppress-punycode.js | Suppress punycode deprecation warning (DEP0040) The punycode built-in module is deprecated since Node.js 21 in favor of userland alternatives. |
lib/telemetry/DataProvenance.js | DataProvenance (P2556 -> P2558) - measured-first + elegant estimate/calc/predict UX WHY(P215): - Pourquoi: prioritize precise real measurements; never confuse with smart estimate, complete calculation, or forward predict |
lib/telemetry/LocalSmartEnergyLearner.js | LocalSmartEnergyLearner (P2560) - on-device habit + power learning (no cloud AI). |
lib/templates/BEST_PRACTICE_DEVICE_TEMPLATE.js | SDK3 Best Practice Device Template This template follows all Athom SDK3 best practices: - CLUSTER constants instead of numeric IDs - reportOpts integrated in registerCapability - triggerFlow() method for flow cards - JSD |
lib/templates/TuyaTS0601DeviceTemplate.js | TuyaTS0601DeviceTemplate - v5.3.15 CORRECT implementation template for Tuya TS0601 devices in Homey SDK3 USE THIS AS REFERENCE for all TS0601 drivers! KEY PRINCIPLES: 1. |
lib/temporal/EvolutionTracker.js | EvolutionTracker.js - Temporal Consciousness: Evolution Engine Tracks the evolution of key project metrics over time: - Driver count (Zigbee + WiFi) - Fingerprint count (manufacturerName + productId) - Capability count - |
lib/temporal/ProjectTimeline.js | ProjectTimeline.js - Temporal Consciousness: Timeline Engine Tracks all project evolution over time: commits, PRs, issues, forum posts. |
lib/temporal/RegressionDetector.js | RegressionDetector.js - Temporal Consciousness: Regression Engine Detects regressions in the project by analyzing: - Fix reversions (a fix commit whose changes are later undone) - Bug reintroduction (same issue number re |
lib/temporal/index.js | Temporal Consciousness System - Index Exports the three temporal engines as a unified API: - ProjectTimeline (T0): commit/PR/issue history - EvolutionTracker (T1): metric snapshots & trends - RegressionDetector (T2): reg |
lib/testing/TestFramework.js | TestFramework - v1.0.0 Unified test infrastructure for Tuya Zigbee drivers Features: - Mock DP report generation - Capability update verification - Flow card trigger testing - Device simulation - Assertion helpers |
lib/testing/index.js | _no header_ |
lib/tuya-camera/TuyaCameraClient.js | _no header_ |
lib/tuya-engine/VirtualBidirectionalSync.js | +==============================================================================+ \| [SYNC] VIRTUAL BI-DIRECTIONAL PHYSICS (Mode B) \| +==============================================================================+ \| Ha |
lib/tuya-engine/converters/battery.js | Battery Converter - SDK3 Optimized Handles battery percentage conversions: - Zigbee standard: 0..200 (0.5% resolution) - Homey capability: 0..100 (1% resolution) - Tuya DP: Usually 0..100 directly SDK3 BEST PRACTICES: - |
lib/tuya-engine/converters/dim.js | _no header_ |
lib/tuya-engine/converters/humidity.js | _no header_ |
lib/tuya-engine/converters/illuminance.js | Illuminance Converter Handles illuminance conversions: - Zigbee: measuredValue in log-lux format - Homey: lux (linear scale) - Tuya DP: Usually lux directly |
lib/tuya-engine/converters/index.js | CONVERTERS INDEX Export tous les converters disponibles |
lib/tuya-engine/converters/onoff.js | _no header_ |
lib/tuya-engine/converters/temperature.js | _no header_ |
lib/tuya-engine/index.js | TUYA DP ENGINE - Production Ready Moteur universel pour devices Tuya (TS0601 et autres) Architecture: - fingerprints.json: manufacturer+model -> profile - profiles.json: profile -> capabilities + dpMap + options - conver |
lib/tuya-engine/traits/index.js | _no header_ |
lib/tuya-engine/utils/dp.js | _no header_ |
lib/tuya-engine/utils/logger.js | Leveled logging utility for Tuya Zigbee devices LOG_LEVEL environment variable controls verbosity: - 'info' (default): Essential events only - 'debug': Detailed operational information - 'trace': Full packet-level inform |
lib/tuya-local/AirQualityVerdict.js | P2647 - WiFi AQI verdict helpers (com.tuyalocal Store Test inspiration). |
lib/tuya-local/CloudDpTable.js | P2956 - Read a cloud DP table carried on a discovered device, when one is present. |
lib/tuya-local/CoverModeInference.js | P2950 - Roller-shutter switch that only shows DP1. |
lib/tuya-local/CoverPositionSource.js | P2952 - Target vs actual position on Wi-Fi curtain motors. |
lib/tuya-local/CoverTravelEstimator.js | CoverTravelEstimator - opt-in time-based position for Wi-Fi covers that only expose open/close/stop (no position DP). |
lib/tuya-local/DPValueParser.js | _no header_ |
lib/tuya-local/DeviceFingerprintDB.js | DeviceFingerprintDB.js - v1.0.0 THE "CLOUD-LESS / IA-LESS" MASTER DATABASE. |
lib/tuya-local/Dp17EnergyHandler.js | P2705 - glue between TuyaLocalDevice and lib/energy/WifiDp17Energy (see there for WHY). |
lib/tuya-local/EvChargerChargeHistory.js | EvChargerChargeHistory.js - P2642 complementary WHY: Phase-JSON "e"/"d" fields are ambiguous; completed charge records prove kWh. |
lib/tuya-local/EvChargerPhaseJson.js | EvChargerPhaseJson.js - P2641 complementary WHY: Some Tuya EV chargers (category qccdz) send all phase measurements as one JSON DP (often 102) instead of packed binary phase blocks. |
lib/tuya-local/GenericDpAutoMapper.js | P2930 - Last-resort DP guesser for unknown WiFi products (no category, no catalog hit). |
lib/tuya-local/LanRepairStatus.js | P3072c: what the repair screen shows for a Tuya Wi-Fi device, and a one-shot re-probe. |
lib/tuya-local/LocalConnectionGate.js | P2930 - One LAN session per Tuya device id, app-wide. |
lib/tuya-local/LocalDeviceInsights.js | P2951 - Glue between the P2950 inference modules and the device / pairing flow. |
lib/tuya-local/LocalIpSettings.js | P3072 - one IP for a Wi-Fi Tuya device, whatever setting key holds it. |
lib/tuya-local/LocalTuyaOptions.js | P3080 - opt-in LAN options, ideas from localtuya (rospogrigio/localtuya, xZetsubou/hass-localtuya). |
lib/tuya-local/ManualEntryNormalizer.js | P2931 - Normalise what a user types in the manual LAN pairing / repair form. |
lib/tuya-local/MultiSocketInference.js | P2950 - Power strip paired as a single plug (only DP1 driven). |
lib/tuya-local/OemEnumTokens.js | P2647 - OEM enum tokens (com.tuyalocal Cloud Lookup lesson). |
lib/tuya-local/SupportBundle.js | P2950 - Support-bundle style diagnostic export for a Tuya LAN device. |
lib/tuya-local/TinyTuyaImport.js | P2930 - Import local keys from a tinytuya wizard export (devices.json / snapshot.json, jasonacox/tinytuya, MIT) or a tuya-cli / localtuya style list. |
lib/tuya-local/TuyaAuthCatalog.js | TuyaAuthCatalog.js (P2409) SSOT for Tuya / SmartLife cloud auth regions, app schemas, and device-list APIs. |
lib/tuya-local/TuyaCloudAPI.js | v5.12.7: TuyaCloudAPI - Tuya Open API client for WiFi device discovery Pattern from jurgenheine/com.tuya.cloud + Drenso/com.tuya2 Used during pairing to discover devices on the user's Tuya account |
lib/tuya-local/TuyaCloudMQTT.js | v5.12.7: TuyaCloudMQTT - MQTT real-time updates for Tuya Cloud devices |
lib/tuya-local/TuyaCommandPlan.js | P2930 - Which Tuya LAN command to use, per protocol and firmware family. |
lib/tuya-local/TuyaDeviceDiscovery.js | _no header_ |
lib/tuya-local/TuyaDeviceTemplates.js | TuyaDeviceTemplates - pure, side-effect-free helpers that translate between Homey capability values and the value conventions seen on Tuya Wi-Fi (LAN protocol) devices. |
lib/tuya-local/TuyaDpDetector.js | _no header_ |
lib/tuya-local/TuyaGatewayHub.js | P2932 - One shared LAN client per Tuya WiFi gateway; each sub-device gets a channel that filters by cid. |
lib/tuya-local/TuyaKeyTypes.js | TuyaKeyTypes.js (P2408) Document + normalize all Tuya WiFi credential shapes used on Homey. |
lib/tuya-local/TuyaLocalClient.js | _no header_ |
lib/tuya-local/TuyaLocalDevice.js | _no header_ |
lib/tuya-local/TuyaLocalDriver.js | _no header_ |
lib/tuya-local/TuyaPairingOrchestrator.js | TuyaPairingOrchestrator.js (P2409 + P2411) Max discovery: UDP burst + mDNS + TinyTuya TCP/6668 force scan + cloud<->LAN match. |
lib/tuya-local/TuyaProtocolVersions.js | P2930b - What a Tuya "version" label really means, and how to fall back. |
lib/tuya-local/TuyaQuirk.js | v9.0.40: TuyaQuirk - ZHA-inspired quirk class for WiFi Tuya devices Pattern from zhaquirks/tuya/__init__.py Provides device-specific overrides for firmware quirks |
lib/tuya-local/TuyaReconnectPolicy.js | TuyaReconnectPolicy - pure helpers for LAN reconnect pacing and sleepy-device availability. |
lib/tuya-local/TuyaShadowPulsar.js | _no header_ |
lib/tuya-local/TuyaSharingClient.js | TuyaSharingClient.js - Smart Life / Tuya Smart "User Code + QR" account link. |
lib/tuya-local/TuyaSmartLifeAuth.js | TuyaSmartLifeAuth.js (P2409) SmartLife / Tuya Smart / IoT Platform auth for local_key extraction (pairing only). |
lib/tuya-local/TuyaTcpForceScan.js | TuyaTcpForceScan.js (P2411) WHY: Silent 3.5 / filtered-UDP devices still listen on TCP/6668 (TinyTuya Force Scan). |
lib/tuya-local/TuyaUDPDiscovery.js | _no header_ |
lib/tuya-local/TuyaUserLogin.js | TuyaUserLogin.js (P2471) SSOT for Smart Life / Tuya Smart Easy Login identity + country/region heuristics. |
lib/tuya-local/TuyaWhiteLabelCatalog.js | TuyaWhiteLabelCatalog.js - Wi-Fi brands that ship Tuya modules under their own app. |
lib/tuya-local/TuyaWiFiHybridManager.js | v9.0.40: DEPRECATED - This module is currently unused (dead code). |
lib/tuya-local/TuyaZigbeeBridge.js | WHY(P2656): Local control of Zigbee sub-devices via Tuya WiFi gateway (cid). |
lib/tuya-local/UdpDiscoveryKeys.js | UdpDiscoveryKeys.js (P2367 + P2408) Shared Tuya UDP discovery crypto - SSOT for TuyaUDPDiscovery + TuyaDeviceDiscovery. |
lib/tuya-local/WiFiDPRegistry.js | WiFiDPRegistry.js (P2367 + P2407 + P2619) Product/category -> DP capability hints (tuya-local / TinyTuya / LocalTuya / com.tuyalocal). |
lib/tuya-local/WifiDriverWiring.js | P2954 - Driver-side wiring for the P2950/P2953 helpers. |
lib/tuya-local/WifiLanLessons.js | P2953 - Further lessons from the Tuya Local Homey thread (topic 154077, author Andi), rewritten in our own words. |
lib/tuya-local/normalizeTuyaUsername.js | P2476 - Normalize Smart Life / Tuya Smart username (email OR phone). |
lib/tuya-local/tuya-local-wizard.js | _no header_ |
lib/tuya-local/wifiLanReliabilitySettings.js | P2619 / P2642 - WiFi LAN reliability settings (complementary from andiwirz/com.tuyalocal). |
lib/tuya/BatteryMixin.js | Its functionality has been consolidated into UnifiedBatteryHandler.js. |
lib/tuya/DataRecoveryManager.js | _no header_ |
lib/tuya/DeviceFingerprintDB.js | ============================================================================== UNIVERSAL ZIGBEE DEVICE FINGERPRINT DATABASE ============================================================================== v8.0.0: Externali |
lib/tuya/DpByteArrayProfiles.js | DpByteArrayProfiles - parse Tuya DP type 0 (RAW / byte_array) per locked couple. |
lib/tuya/DpCoalescer.js | WHY(2026-10-10): Tuya light controllers (Gledopto SPI, TS0601 RGB) drop or mis-apply bursts of DP writes and sometimes freeze. |
lib/tuya/Ef00MultiGangProfiles.js | P2485 - EF00 multi-gang profile heuristics (Z2M-locked couples). |
lib/tuya/EnergyJumpGuard.js | +==============================================================================+ \| ENERGY JUMP GUARD - Defensive cumulative-energy check \| +============================================================================== |
lib/tuya/EnrichedDPMappings.js | _no header_ |
lib/tuya/FaultBitmapDecoder.js | v9.0.40: Fault Bitmap Decoder Inspired by Z2M's fault bitmap decoding for Tuya circuit breakers and water meters Decodes bitfield fault codes into human-readable descriptions v9.0.40+: Extended with Z2M's full 17-fault c |
lib/tuya/GlobalTimeSyncEngine.js | GlobalTimeSyncEngine - Time sync for Tuya devices Supports configurable time epoch: - Unix epoch (1970): seconds since 1970-01-01 (standard Unix/Linux) - Tuya/Zigbee epoch (2000): seconds since 2000-01-01 (ZCL standard) |
lib/tuya/HobeianZg301zHeal.js | P2632 - HOBEIAN ZG-301Z wall module heal (Bastien kitchen light) Symptom: light turns off ~5s after ON without a second click. |
lib/tuya/IntelligenceHealth.js | _no header_ |
lib/tuya/LocalTuyaEntityHandler.js | _no header_ |
lib/tuya/LocalTuyaInspired.js | LocalTuyaInspired.js - v5.5.682 Inspired by LocalTuya + TinyTuya |
lib/tuya/LocalWiFiTuyaBridge.js | [BRIDGE] LocalWiFiTuyaBridge - v2.0.0 Inspired by LocalTuya, this bridge allows the Universal Tuya Engine to manage WiFi devices via local network communication. |
lib/tuya/MCUFormatDatabase.js | _no header_ |
lib/tuya/MCUVersionHelper.js | MCUVersionHelper - TS0601 init: optional mcuVersionRequest (0x10) then dataQuery (0x03). |
lib/tuya/MagicPacketRegistry.js | MagicPacketRegistry - restored from pre-P92.17 (was deleted as "dead" but profiles were never elevated). |
lib/tuya/PassiveDpRx.js | _no header_ |
lib/tuya/PayloadNormalizer.js | P2972 - PayloadNormalizer: turn any "shape" of a Tuya DP payload into a Buffer, then into DP records. |
lib/tuya/RainDpDecoder.js | P2972 - Tuya rain sensor DP decoder (old and new firmware layouts). |
lib/tuya/SanityFilter.js | SanityFilter - v9.0.0 (L14 Hardening Layer) Provides sophisticated signal processing for Tuya sensors: 1. |
lib/tuya/SpiPixelColour.js | Pure helpers for the Gledopto GL-SPI-206P (DP layout from zigbee-herdsman-converters gledopto.ts, Koen Kanters and contributors; own implementation). |
lib/tuya/SpmPhaseDecoder.js | Decoder for Tuya SPM01 (1P+N) / SPM02 (3P+N) DIN energy monitors. |
lib/tuya/TS0601_EMERGENCY_FIX.js | TS0601 EMERGENCY FIX Force TuyaEF00Manager initialization for specific TS0601 sensors that are not reporting data. |
lib/tuya/ThermostatMeteringDps.js | P3067: power metering datapoints of a few Tuya thermostats / TRVs, exact manufacturer names only (facts from Zigbee2MQTT tuya.ts; own implementation, credit Koen Kanters and the zigbee-herdsman-converters contributors): |
lib/tuya/TimeSyncPolicy.js | Per-device opt-out of Tuya time sync (#110, Z2M #13004): some devices misbehave when the time is pushed to them. |
lib/tuya/TongouAcFrequency.js | TongouAcFrequency - Homey port of Z2M herdsman #12993 WHY(P2580): _TZE284_6ocnqlhn DP32 sometimes reports centihertz (4999->49.99) and sometimes already-truncated Hz (49/50). |
lib/tuya/Ts0004SwitchModuleHeal.js | P2634 - TS0004 4-gang switch module heal (SML-04Z family) Sacred couples (Z2M TS0004_switch_module / ZHA Switch_4G_Metering): _TZ3000_ltt60asa + TS0004 _TZ3000_mmkbptmx + TS0004 _TZ3000_liygxtcq + TS0004 WHY: Homey showe |
lib/tuya/Ts0049Countdown.js | P3019: Haozee HZ-WT02 water valve (TS0049 _TZ3000_kz1anoi8) - watering countdown through the Tuya private cluster 0xE001, command 0xFE (setCountdown). |
lib/tuya/TuyaAdapter.js | TuyaAdapter - Tuya Unified EF00 send adapter Handles multiple API variations across Homey SDK versions Feature-detects available methods and uses appropriate fallback |
lib/tuya/TuyaBrightnessScale.js | Tuya MCU brightness scale (0-1000). |
lib/tuya/TuyaClusterWrapper.js | TuyaClusterWrapper - v5.3.15 Correct implementation of Tuya EF00 cluster for Homey SDK3 CRITICAL: Homey SDK3 does NOT natively support: - Cluster 0xEF00 (Tuya specific) - dataRequest method - DP parsing This wrapper prov |
lib/tuya/TuyaCommandSender.js | TuyaCommandSender - v5.3.16 Universal helper for sending commands to Tuya EF00 cluster PROBLEM: The method tuyaCluster.dataRequest() doesn't exist in Homey SDK3 SOLUTION: Try multiple methods in order of availability T |
lib/tuya/TuyaDPDataLogger.js | _no header_ |
lib/tuya/TuyaDPDatabase.js | _no header_ |
lib/tuya/TuyaDPDeviceHelper.js | Tuya DP Device Helper According to CURSOR_REFACTOR_GUIDE_PART1.md Phase 6 Purpose: Separate Tuya DP devices from standard Zigbee devices to avoid timeout errors on cluster configuration |
lib/tuya/TuyaDPFlowCardManager.js | _no header_ |
lib/tuya/TuyaDPManager_Enhanced.js | TuyaDPManager_Enhanced - Gestion optimale des DataPoints Tuya Améliorations v4.9.336: - Détection automatique des DPs critiques - Mapping intelligent batterie multi-source - Cache des valeurs DP avec timestamp - Retry au |
lib/tuya/TuyaDPMapper.js | TUYA DP AUTOMATIC MAPPER Inspiré de: - Zigbee2MQTT converters (github.com/Koenkk/zigbee-herdsman-converters) - LocalTuya (github.com/rospogrigio/localtuya) - Home Assistant Tuya integration - TinyTuya (pypi.org/project/t |
lib/tuya/TuyaDPParser.js | TUYA DATA POINT (DP) PARSER Parses the raw buffer from Tuya cluster 0xEF00 into structured DP data Handles encoding/decoding of Tuya proprietary Data Points |
lib/tuya/TuyaDataPointEngine.js | TuyaDataPointEngine.js COMPLETE Tuya DataPoint (DP) engine for TS0601 devices Handles ALL Tuya climate sensors, motion sensors, etc. |
lib/tuya/TuyaDataPointsComplete.js | TuyaDataPointsComplete - COMPLETE Tuya DataPoints Database Sources: - https://github.com/zigbeefordomoticz/wiki/blob/master/en-eng/Technical/Tuya-0xEF00.md - https://github.com/zigpy/zha-device-handlers/blob/dev/zhaquirk |
lib/tuya/TuyaDataPointsJohan.js | TuyaDataPointsJohan.js - Versioned DP Definitions from Johan Bendz Source: https://github.com/JohanBendz/com.tuya.zigbee/blob/master/lib/TuyaDataPoints.js This file provides comprehensive, versioned data point definition |
lib/tuya/TuyaDataPointsZ2M.js | _no header_ |
lib/tuya/TuyaDataQuery.js | _no header_ |
lib/tuya/TuyaDpCommandArgs.js | P3050 - build the argument object of an outgoing Tuya DP command (0xEF00 cmd 0x00 / 0x04) from the schema of the cluster class that is ACTUALLY live on the node. |
lib/tuya/TuyaDpProfileCodec.js | Pure value codec for TuyaDpProfileDevice profiles (kept free of Homey imports so it is testable). |
lib/tuya/TuyaDpValue.js | P2769 - Tuya DP type VALUE (0x02) decoding. |
lib/tuya/TuyaE002AlarmManager.js | TuyaE002AlarmManager - write climate/LCD alarm thresholds on 0xE002 WHY P2267: Google/Z2M/ZHA/HA - E002 is alarm config only (not live temp/hum). |
lib/tuya/TuyaEF00Base.js | TuyaEF00Base - Central Helper for Tuya EF00 Manager Initialization PHASE 1 - Safe EF00 Manager Access Provides safe initialization and access to the global TuyaEF00Manager to prevent "tuyaEF00Manager not initialized" cra |
lib/tuya/TuyaEF00Manager.js | _no header_ |
lib/tuya/TuyaEF00Parser.js | TuyaEF00Parser - v5.3.15 Lightweight parser for Tuya EF00 frames Use this for quick DP parsing without full cluster wrapper |
lib/tuya/TuyaGatewayEmulator.js | _no header_ |
lib/tuya/TuyaHelpersJohan.js | TuyaHelpersJohan.js - Helper Functions from Johan Bendz Source: https://github.com/JohanBendz/com.tuya.zigbee/blob/master/lib/TuyaHelpers.js Provides utility functions for: - Parsing Tuya DP values (getDataValue) - Sched |
lib/tuya/TuyaMCUManager.js | TuyaMCUManager - v3.0.0 (P2472b) MCU negotiation for TS0601 / EF00 devices: - Version query + store cache - Magic packet wake - Time-sync format guess (couple -> MCUFormatDatabase -> TuyaTimeSyncFormats) - Heartbeat + so |
lib/tuya/TuyaManufacturerCluster.js | _no header_ |
lib/tuya/TuyaMcuTimeService.js | P2933 - Tuya MCU time & housekeeping service (optional overlay, additive). |
lib/tuya/TuyaModernExtend.js | TuyaModernExtend - v9.0.0 Reusable "Traits" for Tuya devices, inspired by Z2M Modern Extend. |
lib/tuya/TuyaMotorDirection.js | TuyaMotorDirection - Homey port of Z2M herdsman PR #13207 / #13191 WHY(P2580): tubular / Moes covers occasionally report motor_direction as a string ("back"/"forward"/"reversed"/"normal") instead of enum 0/1. |
lib/tuya/TuyaMultiDpFrame.js | WHY(2026-10-10, Gledopto GL-SPI-206P): bursts of single-DP writes freeze some Tuya light MCUs (Koenkk/zigbee2mqtt#32754). |
lib/tuya/TuyaMultiGangManager.js | _no header_ |
lib/tuya/TuyaNegPower24.js | Signed decoding of the 24-bit active power field found in Tuya packed "phase" DPs. |
lib/tuya/TuyaPhaseLongV2.js | P3002b - 18-byte "V2" phase datapoint (phase_a DP6 on Powbay JGQW01-class breakers). |
lib/tuya/TuyaPhaseStruct.js | Decoder for the 8-byte "phase" raw datapoint some Tuya DP meters and breakers send (voltage, current and power of one phase packed together). |
lib/tuya/TuyaProfiles.js | _no header_ |
lib/tuya/TuyaProtocolManager.js | [MIX] TUYA PROTOCOL MANAGER - Système Unifié Intelligent Fusion et optimisation de: - TuyaAdapter.js - TuyaDataPointEngine.js - TuyaManufacturerCluster.js - TuyaSpecificCluster.js - IntelligentProtocolRouter.js Documenta |
lib/tuya/TuyaRadarRangeScale.js | TuyaRadarRangeScale - dual-scale range DPs (Z2M /100 vs ZHA x0.1) WHY(P2583 / GH#547 gkfbdvyx + Z2M#27445 + ZHA quirk): near/far detection DPs arrive as cm (/100) OR decimeters (/10). |
lib/tuya/TuyaSensorDatabase.js | _no header_ |
lib/tuya/TuyaSpecificCluster.js | TuyaSpecificCluster - Custom Homey SDK3 Implementation Implements Tuya's manufacturer-specific cluster 0xEF00 Based on Homey's zigbee-clusters architecture References: - https://athombv.github.io/node-zigbee-clusters - h |
lib/tuya/TuyaSpecificClusterDevice.js | _no header_ |
lib/tuya/TuyaSpecificDevice.js | _no header_ |
lib/tuya/TuyaSyncManager.js | _no header_ |
lib/tuya/TuyaTimeSync.js | _no header_ |
lib/tuya/TuyaTimeSyncFormats.js | _no header_ |
lib/tuya/TuyaTimeSyncHandler.js | TuyaTimeSyncHandler v1.2.0 - Stabilized & Exhaustive Centralized handler for Tuya Cluster 0xEF00 Command 0x24 (TUYA_MCU_SYNC_TIME). |
lib/tuya/TuyaTimeSyncManager.js | _no header_ |
lib/tuya/TuyaUnifiedParser.js | _no header_ |
lib/tuya/TuyaUniversalMapper.js | _no header_ |
lib/tuya/TuyaUnsignedValue.js | TuyaUnsignedValue - harden Tuya VALUE (type 2) as unsigned 32-bit WHY(P2580 / Z2M#32561 MTG275 detection_range): some MCU reports / host stacks surface VALUE as signed int32. |
lib/tuya/TuyaZigbeeDevice.js | _no header_ |
lib/tuya/TuyaZigbeeProfileOverlay.js | P2931 - Optional overlay: builds the per-device Tuya Zigbee protocol profile at runtime (TuyaZigbeeProtocolProfile) from Basic attributes and the EF00 commands actually seen. |
lib/tuya/TuyaZigbeeProtocolProfile.js | P2930c - Tuya Zigbee (EF00) protocol profile, per device, built at runtime. |
lib/tuya/UniversalDPReceiver.js | UniversalDPReceiver v5.7.29 - Audited & Improved (20+ hooks) MODES: 1. |
lib/tuya/UniversalDPSender.js | UniversalDPSender v5.7.42 - Curtain Motor Fix v5.7.42: FIX - Tuya 'value' type ALWAYS uses 4 bytes (GitHub #122 elgato7) Types: bool, enum, bitmap(1-8bytes+BigInt), value(4bytes fixed), string, raw |
lib/tuya/UniversalTimeSync.js | UniversalTimeSync - v5.5.107 Enhanced Time Synchronization Provides hourly time synchronization for all Tuya devices with clocks/displays. |
lib/tuya/UniversalTuyaParser.js | QUARANTINED (P2269) - UniversalTuyaParser was dead (no live requires). |
lib/tuya/UpstreamDpGuards.js | P3150 (t733u findings): small, additive DP guards confirmed by upstream sources. |
lib/tuya/_quarantine/UniversalTuyaParser.legacy.js | _no header_ |
lib/tuya/dp-parser-enhanced.js | dp-parser-enhanced.js - Enhanced Tuya DP parser Handles multiple payload formats: - Raw Buffer - Base64 string - JSON string - Endpoint 242 special handling Supports multi-gang DP mappings (e.g., DP 1 = gang 1, DP 2 = ga |
lib/tuya/dpMapper.js | dpMapper.js - v5.3.17 Tuya Unified DP to Homey Capability mapper Usage: const mapTuyaDPToCapabilities = require('./dpMapper'); mapTuyaDPToCapabilities(device, dp, value); |
lib/tuya/fingerprintShardId.js | P2678 - Fingerprint shard id (shared builder + runtime) WHY: Homey Pro ~64MB - never JSON.parse the full ~0.9MB broad catalog at once. |
lib/tuya/index.js | [SKY] Tuya Protocol Index - v7.0.0 (Antigravity Overhaul) Centralized exports for all Tuya protocol handlers. |
lib/tuya/profiles/P3013DedicatedZ2MProfiles.js | P3013 - exact DP tables for four master-only dedicated drivers. |
lib/tuya/tuya-universal-mapping.js | TUYA UNIVERSAL MAPPING SYSTEM Système ultra-complet de mapping entre: - Tuya DataPoints (DPs) - Zigbee Clusters (standard + manufacturer-specific) - Homey Capabilities (standard + custom) Sources consolidées: - Zigbee2MQ |
lib/tuya/tuyaDpBool.js | True, false, or null when the report is not a Tuya bool. |
lib/ui/TileStateGuard.js | P3130 / t699u: Homey tile state consistency. |
lib/util/color.js | _no header_ |
lib/util/index.js | _no header_ |
lib/utils/AdaptiveDataParser.js | AdaptiveDataParser - Universal data type handler v5.3.62: Auto-adapts to ANY data format (raw, string, buffer, object, etc.) Handles: - Tuya DP values (all types: bool, value, enum, string, raw, bitmap) - ZCL attribute r |
lib/utils/AdaptiveEventEmitter.js | _no header_ |
lib/utils/AppVersion.js | AppVersion - Dynamic Version Utility Utility to get the current app version from app.json This ensures all version banners stay synchronized with the actual version. |
lib/utils/BatteryCurveFallback.js | _no header_ |
lib/utils/BidirectionalButtonState.js | BidirectionalButtonState - P2283 SSOT helpers for physical <-> virtual buttons. |
lib/utils/BoundedJsonCache.js | BoundedJsonCache - load big read-only JSON data files lazily, at first use, into a bounded LRU that the memwarn guard can drop. |
lib/utils/ButtonE000RawInterceptor.js | ButtonE000RawInterceptor - P2387 SSOT for E000 raw frame gap-fill on button remotes. |
lib/utils/CacheManager.js | CacheManager - SHA-256 based HTTP cache for MFS Aggregator Stores ETag / Last-Modified headers and content hashes per source URL. |
lib/utils/CapabilityAutoAdapter.js | CapabilityAutoAdapter - Auto-adapt capabilities per device variant Detects manufacturer capability gaps, auto-removes unused capabilities, and adapts ranges per manufacturer |
lib/utils/CapabilityManager.js | CapabilityManager - Safe capability creation and management Prevents duplicate capability errors by checking existence before creation. |
lib/utils/CapabilityMapCache.js | CapabilityMapCache - Caches capabilityMap computation for devices Problem: The capabilityMap getter in TuyaLocalDevice (and Zigbee devices) creates new closures on every call, causing GC pressure. |
lib/utils/CapabilityMigrator.js | v9.0.40: Capability Migration Helper Inspired by gpmachado/com.gpm.homesuite migrateCapabilities.js Handles driver updates that add/remove capabilities gracefully |
lib/utils/CaseInsensitiveMatcher.js | CaseInsensitiveMatcher v10.0.0 - BACKWARD-COMPAT SHIM As of v10.0.0 (P82, 2026-07-23), this module is a backward-compat shim that delegates to lib/utils/TuyaNormalizer.js (the ULTIMATE single source of truth). |
lib/utils/CircuitBreaker.js | CircuitBreaker - Resilience pattern for external API calls States: CLOSED = normal operation, requests pass through OPEN = failing, requests are rejected immediately HALF_OPEN = testing recovery, limited requests allowed |
lib/utils/ClassExtendsGuard.js | lib/utils/ClassExtendsGuard.js P24.7 - Safe class extends wrapper for TuyaZigbeeDevice / TuyaSpecificClusterDevice P64.0 - Belt-and-suspenders: handles destructured modules, double-fallback chain, and NEVER returns undef |
lib/utils/ClickAggregator.js | ClickAggregator (P2798) - app-level multi-click counting for remotes whose firmware only sends one command per press (e.g. |
lib/utils/ClickWindowAuto.js | ClickWindowAuto (P2910) - decides, per device and per button, whether the app-level click window (ClickAggregator, P2798) is needed. |
lib/utils/ClimateSensorClassHeal.js | ClimateSensorClassHeal - one-shot class fix for a temperature/humidity sensor that was paired through a socket-class driver (Wilhelm Dall suggestion, 2026-10-17, _TZ3000_bjawzodf / TY0201). |
lib/utils/ClusterDPDatabase.js | ClusterDPDatabase - Universal Cluster & DataPoint Database Comprehensive mapping of: - Zigbee standard clusters - Tuya DataPoints (DP) - Manufacturer-specific clusters - Capabilities mapping Covers ALL device types for m |
lib/utils/ConnectionStateTracker.js | ConnectionStateTracker - Track device connection state with history and statistics v5.0.0 - TITAN Protocol V5 Tracks connection state transitions for WiFi and Zigbee devices. |
lib/utils/CoupleGuard.js | P3039d / t524u - per-couple runtime guard. |
lib/utils/CrashPrevention.js | CrashPrevention - v9.0.260 (P63) Centralized "never-throw" wrappers for the most common device crash patterns observed in Gmail diagnostics 2026-07-15: - 7x "this._inferCapabilityFromValue is not a function" (UnifiedSens |
lib/utils/DeviceClassMigration.js | One-shot device class migration for already-paired devices. |
lib/utils/DeviceTelemetryEstimator.js | _no header_ |
lib/utils/DriverMappingLoader.js | _no header_ |
lib/utils/DriverUtils.js | DRIVER UTILITIES Reusable functions based on discovered patterns and best practices |
lib/utils/EnergyEstimator.js | _no header_ |
lib/utils/ErrorClassifier.js | _no header_ |
lib/utils/GangIndexResolver.js | v9.0.413 (P92.121): GangIndexResolver - 0-based vs 1-based normalisation. |
lib/utils/HomeyButtonUiCharter.js | HomeyButtonUiCharter (P2492) WHY: Physical wall presses and Homey UI tiles must stay coherent - Homey charter: switches = onoff primary; scene remotes = button.N in device view; never invent onoff on class:button; mainte |
lib/utils/HomeyCapabilityUx.js | HomeyCapabilityUx (P2500 / P2553) WHY: Athom + Device Capabilities (T43287) - sensor readables must stay getable so Homey shows tiles + Insights History. |
lib/utils/LifecycleCleanup.js | LifecycleCleanup - Shared cleanup utilities for device classes Extracts duplicated try/catch cleanup patterns from BaseUnifiedDevice, UnifiedSwitchBase, UnifiedSensorBase, and other device classes. |
lib/utils/LocalizedMessage.js | P3070 - localized device-status messages with a safe English fallback. |
lib/utils/LogBuffer.js | LogBuffer - Circular buffer for logs accessible via Homey.ManagerSettings Enables MCP (Model Context Protocol) agents to read app logs remotely by querying Homey.ManagerSettings.get('debug_log_buffer') Features: - Circul |
lib/utils/Logger.js | LOGGER PROFESSIONNEL HOMEY SDK3 Système de logging avancé conforme à la documentation Homey SDK v3 - Niveaux de log: ERROR, WARN, INFO, DEBUG, TRACE - Logs structurés avec contexte - Support Zigbee (clusters, endpoints, |
lib/utils/ManufacturerNameAccessor.js | ManufacturerNameAccessor - v9.0.249 (P59) Patches ZigBeeDevice (the root base class from homey-zigbeedriver) with a getManufacturerName() method so every driver can use this.getManufacturerName() without each drive |
lib/utils/ManufacturerNameHelper.js | ManufacturerNameHelper.js - Normalisateur Canonique de Marques (v8.1.0) Fournit une normalisation centralisée des noms de fabricants Zigbee/Tuya. |
lib/utils/MathUtils.js | MATH UTILITIES (Safe arithmetic to prevent crashes) v1.0.0 - Extracted from tuyaUtils.js to break circular dependencies |
lib/utils/MemwarnGuard.js | MemwarnGuard: reacts to Homey's documented memwarn event (Homey emits it before killing an app that uses too much memory). |
lib/utils/MeterWriteCoalescer.js | MeterWriteCoalescer (P3298) - per-capability write coalescing for chatty metering devices. |
lib/utils/NetworkResilience.js | NetworkResilience - shared local-first network guard for Homey Pro (~64MB budget). |
lib/utils/OwnedTimerSweep.js | P3065: owned-timer sweep, run when a device is deleted or uninitialised. |
lib/utils/PromiseUtils.js | PromiseUtils - Safe promise handling utilities Prevents "Cannot read properties of undefined (reading 'catch')" errors |
lib/utils/ProtocolQuirkLookup.js | ProtocolQuirkLookup (P116) Shared, case-insensitive lookup into data/protocol_quirk_table.json. |
lib/utils/RateLimiter.js | RateLimiter v1.0.0 Prevents network flooding by debouncing high-frequency updates (e.g. |
lib/utils/ReconnectNoticeGate.js | WHY(P3037b / forum 157537, Device Watchdog by Rick_D, v1.9.49-v1.9.51): a monitoring app must not raise "device lost" alerts while Homey is still starting (routers and sleepy end devices need minutes to report back), and |
lib/utils/RejoinDetector.js | v9.0.40: Rejoin Detector - Burst-based power-restore detection Inspired by gpmachado/com.gpm.homesuite rejoin detection Detects power-restore rejoin by monitoring 3+ DP bursts within 600ms (all gangs dump state simultane |
lib/utils/ReportingConfig.js | ReportingConfig - Optimized attribute reporting configurations Based on analysis of professional Homey Zigbee apps (Philips Hue, Xiaomi, Aqara) Key findings: - Battery: min 1 hour, max 16 hours (slow changing) - Motion: |
lib/utils/RetryWithBackoff.js | RetryWithBackoff - Exponential backoff retry utility for Zigbee operations v5.2.9 - Handle stubborn battery devices that don't respond immediately |
lib/utils/SafeCapability.js | SafeCapability - v9.0.240 (P58) Standalone safe-capability helpers. |
lib/utils/SafeTimerAccessor.js | SafeTimerAccessor - v9.0.253 (P62) Patches ZigBeeDevice (the root base class from homey-zigbeedriver) with a safeSetTimeout method that survives the device being destroyed. |
lib/utils/Sdk3ZclSafe.js | Sdk3ZclSafe - Homey Apps SDK3 Zigbee init / ZCL promise helpers (P2547). |
lib/utils/SleepyDeviceInit.js | _no header_ |
lib/utils/SmartValueProcessor.js | _no header_ |
lib/utils/TitleSanitizer.js | TitleSanitizer - Smart Name Cleanup for Devices PROBLÈME (Diagnostic 5bbbabc5): (quoted passage, see the file header) SOLUTION: |
lib/utils/TuyaDataPointUtils.js | TuyaDataPointUtils v5.5.740: Utility module for Tuya DataPoint handling Source: Inspired by PR #740 (maccyber) utils.js pattern This module provides a centralized location for: - DataPoint ID constants - DataType constan |
lib/utils/TuyaDatapointArgs.js | Fill the fields of a Tuya EF00 datapoint command that a caller left out. |
lib/utils/TuyaDeviceHelper.js | _no header_ |
lib/utils/TuyaNormalizer.js | TuyaNormalizer v10.0.0 ULTIMATE The DEFINITIVE case-insensitive normalizer for all Tuya device matching across the entire app. |
lib/utils/TuyaPressTypeMap.js | v5.9.22: Centralized 0-indexed press type map (prevents v5.9.19 regression). |
lib/utils/UniversalDataHandler.js | UniversalDataHandler - v5.5.397 Unified facade for all data handling operations Imports modular components from lib/utils/data/ Architecture: - DataConverter: Raw data format conversion (Buffer/Hex/Array/Binary) - TuyaPr |
lib/utils/UniversalThrottleManager.js | _no header_ |
lib/utils/UnknownDPLogger.js | _no header_ |
lib/utils/ZigbeeRetry.js | Zigbee Retry Utilities Handles "Zigbee est en cours de démarrage" and other transient errors |
lib/utils/battery-reader.js | Battery Reader - Enhanced battery & voltage reading with fallbacks Handles: standard clusters, voltage fallback, Tuya DP protocol Based on: User feedback - "Aucune data sur les batteries" |
lib/utils/battery-reporting-manager.js | Battery Reporting Manager - HYBRID VERSION Handles automatic battery reporting for BOTH: - Standard Zigbee devices (genPowerCfg cluster) - Tuya TS0601 devices (Tuya DP protocol) Based on Athom best practices and Homey SD |
lib/utils/boundedJson.js | P3068: bounded JSON for logs in frame / DP / attribute handlers. |
lib/utils/capability-safe-create.js | Safe Capability Creation - Prevents duplicate capability crash Homey throws error if capability already exists: (quoted passage, see the file header) This wrapper catches the e |
lib/utils/capability-safe.js | capability-safe.js - Safe capability creation with persistence Prevents "Capability already exists" crashes by tracking created capabilities in device store and checking before creation. |
lib/utils/cluster-configurator.js | v5.2.77: Use centralized Tuya detection |
lib/utils/clusterUtils.js | _no header_ |
lib/utils/data-collector.js | Data Collector - Comprehensive data collection & storage Inspired by: Homey SDK3 best practices, community apps Collects data from: - Standard Zigbee clusters (battery, power, climate, etc.) - Tuya DP protocol (hidden cl |
lib/utils/dp-log-sampler.js | P3065: per-DP receive log volume. |
lib/utils/dp-transform.js | P3065: one place to apply a DP transform - plain function or ValueConverterRegistry { fromDevice } object. |
lib/utils/driver-preference.js | Driver Preference Manager Stores user's manual driver selection to prevent auto-adaptation from overriding it Based on: User feedback - "USB 2 socket s'affecte au mauvais driver même si bon sélectionné" |
lib/utils/driver-switcher.js | Driver Switcher - Safe automatic driver switching with heuristics Respects user preference and only switches when proven necessary Based on: User feedback - "Bascule automatique safe si driver recommandé faux" |
lib/utils/endpointCapability.js | Strict multi-gang endpoint -> capability mapping. |
lib/utils/energy-kpi.js | Energy KPI Collector - Rolling window metrics for energy monitoring Inspired by: Homey SDK3 best practices & community apps Stores energy samples in rolling windows for: - Average power consumption - Peak power detection |
lib/utils/ensureGangUiCapabilities.js | P2397 - Soft-ensure Homey UI gang representations (button.N + onoff.gangN). |
lib/utils/fingerprint-matcher.js | fingerprint-matcher v1.0.0 (P92 heuristic matching) Heuristic, case-insensitive matcher for Tuya manufacturerName / productId fingerprints. |
lib/utils/heapGate.js | P3214 (02/11/2026, Bastien diag 7f72cffe "c3 crache souvent"): the app died with heap out of memory in JSON.parse of the 2 MB zigbee-OTA index while HEAP-SENTINEL already read 57 MB. |
lib/utils/index.js | _no header_ |
lib/utils/interviewEndpoints.js | Homey Zigbee interview helpers. Interviews always expose endpoint 242 (Green Power proxy) plus the real application endpoints. Counting Object.keys(endpoints) as gangs is how TS0002 (EP1+EP2+242) becomes a 3-gang and TS0 |
lib/utils/json-load-note.js | Bounded note of large JSON loads (Bastien 1.0.229). |
lib/utils/lazyRequire.js | P2931 - lazy module handle. lazy(() => require('./X')) returns a stand-in that loads the module on first real use (new, call, property read, instanceof) and then forwards everything to it. WHY: every driver loads at ap |
lib/utils/log-buffer.js | lib/utils/log-buffer.js |
lib/utils/manufacturerResolver.js | lib/utils/manufacturerResolver.js Résolution d'identité des fabricants selon la Rule 24 (normalisation insensible à la casse) v10.0.0: Now delegates NFKD + accents to TuyaNormalizer (single source of truth) |
lib/utils/mask-pii.js | _no header_ |
lib/utils/memwarn-cleaners.js | WHY: Homey emits memwarn before killing an app over its memory budget (SDK docs). |
lib/utils/migration-queue.js | Migration Queue System Safe alternative to device.setDriver() (SDK2 only, not available in SDK3) Instead of calling device.setDriver() directly (which crashes): 1. |
lib/utils/nativeTimer.js | P3068: the single gateway for NATIVE timers in lib/. |
lib/utils/parse-trace.js | Stderr breadcrumbs for large app-owned JSON.parse calls. |
lib/utils/rf-channel-coexistence.js | RF channel coexistence helpers (2.4 GHz). |
lib/utils/safe-auto-migrate.js | Safe Auto-Migration System Validates migration before execution: - Confidence must be high (>90%) - Target driver must exist - User preference must not be set - Tuya DP devices protected (never auto-migrate) - Invalid dr |
lib/utils/safe-capability.js | Prefer device.safeSetCapabilityValue (L14) when available. |
lib/utils/safe-get-driver-patch.js | P2306 / P2351 / P2373 / P2480 / P2481 / P2482 - Soft-fail ManagerDrivers.getDriver for foreign driver IDs. |
lib/utils/safe-guards.js | Safe Guards - Protection NPE |
lib/utils/safe-timers.js | lib/utils/safe-timers.js - defensive setTimeout helpers |
lib/utils/safeLogger.js | v9.0.40: Safe Logger - Replaces direct console.log fallbacks in lib/ utilities Provides a consistent interface that works with or without a device reference |
lib/utils/safeMemoryUsage.js | safeMemoryUsage (P3045) - read the process memory figures without ever throwing. |
lib/utils/safeMigrate.js | safeMigrate.js - Safe device driver migration wrapper Prevents crashes during driver migration by validating target driver and catching errors gracefully. |
lib/utils/scene-remote-classify.js | Shared scene-remote / button-actuator classification (P2235/P2237). |
lib/utils/transientNetRetry.js | P2930e (21/10/2026 Paris): bounded retry for cloud HTTPS calls that die on a transient socket error. |
lib/utils/tuya-dp-detector.js | Tuya DP Detector - extracted from lib/helpers/device_helpers.js Single source of truth for "is this device a Tuya DP device?" Extracted to break the circular dependency between: - lib/helpers/device_helpers.js - lib/util |
lib/utils/tuya-dp-parser.js | Tuya DP Parser - Parse cluster 0xEF00 data points Handles: Soil sensors, PIR sensors, climate sensors, etc. |
lib/utils/tuyaUtils.js | _no header_ |
lib/utils/zigbee-retry.js | lib/utils/zigbee-retry.js |
lib/utils/zigbee-tuya-evolution.js | Zigbee + Tuya evolution brief (P2537). |
lib/ux/PrePairingCompatibilityCheck.js | Pre-Pairing Compatibility Check - UX #90 / P2498 Soft advisories only. |
lib/ux/RealTimeCommunicationMonitor.js | Real-Time Communication Monitor - UX #89 Monitors and displays real-time device communication: - Live message feed - TX/RX statistics per device - Protocol distribution (ZCL vs Tuya DP) - Error rate tracking - Signal qua |
lib/ux/SettingsUITooltips.js | Settings UI with Tooltips - UX #88 Provides tooltip definitions and settings validation for device settings: - Human-readable tooltip text for every setting - Settings validation with descriptive error messages - Setting |
lib/ux/VisualBatteryHealthIndicator.js | Visual Battery Health Indicator - UX #92 Provides rich battery health information for display: - Health score (0-100) - Trend analysis (charging/discharging/stable) - Estimated remaining life - Color-coded status levels |
lib/ux/index.js | UX Modules Index - v9.1.0 Centralized exports for all UX modules |
lib/validation/ConfigSchemaValidator.js | _no header_ |
lib/validation/index.js | _no header_ |
lib/version.js | _no header_ |
lib/wifi/CloudHealthState.js | Process-local cloud health signals for local-first WiFi decisions. |
lib/wifi/LanRebindRouter.js | P3072 step B - follow a Wi-Fi Tuya device to its new IP (DHCP lease change, router reboot). |
lib/wifi/LocalCredentialPersist.js | LocalCredentialPersist (P2525) WHY (T146735 Smart Life cloud thread): Homey reboot / update often forces QR re-login and devices go offline (error 2001) because cloud session died. |
lib/wifi/LocalFirstResolver.js | LocalFirstResolver - v9.1.1 Local-first transport resolver for Tuya WiFi devices (tuya-local inspired). |
lib/wifi/WiFiConnectionPolicy.js | _no header_ |
lib/wifi/WifiFixIt.js | P2621 / P2647 - WiFi Fix-It helpers (inspired by com.tuyalocal Fix It + Cloud Lookup). |
lib/xiaomi/XiaomiSpecialHandler.js | XiaomiSpecialHandler - Xiaomi/Lumi Device Special Handling Inspired by fairecasoimeme/Xiaomi repository Handles Xiaomi-specific attributes and keep-alive Features: - Attribute 0xFF01 parsing (battery, temp, etc.) - Keep- |
lib/xiaomi/index.js | Xiaomi Module - Xiaomi/Lumi Device Support |
lib/zigbee/BastienIeeeIdentity.js | P2667 / P2694 - Bastien Developer Tools "Unknown Node" IEEE -> sacred couple map Homey Zigbee tools show Unknown when interview lost mfr/pid but the IEEE was previously live-interviewed. |
lib/zigbee/CapabilityCommandRouter.js | CapabilityCommandRouter - low-level UNSUPPORTED_CLUSTER handling When Homey/ZCL rejects a control cluster (status 0x81 / "UNSUPPORTED_CLUSTER"), cascade through parallel protocol methods and remember the winner: 1. |
lib/zigbee/DeviceOperatingMode.js | Device operating modes - one policy for remotes, relays, and DP switches. |
lib/zigbee/DpCatalogDecoder.js | P3018: exact Tuya DP decoding from the shipped per-couple catalogue (lib/zigbee/data/unknown-dp-catalog.json v2: names + converter tokens). |
lib/zigbee/DynamicBindingAdapter.js | P3207 DynamicBindingAdapter - GH#598 generalised (docs/rules/DYNAMIC_ADAPTATION.md). |
lib/zigbee/Ef00OnlyInterview.js | P2473 / P2573 - EF00-only interview shape (Joep Insoma / Moes ZTS / FrankEver / Michaelp #2244 TRV / VicHY clrdrnya radar) WHY: Homey pairs Unknown when compose requires clusters the interview lacks (classic: OnOff 6 w |
lib/zigbee/EndpointCoverage.js | P3018: every interviewed endpoint is inventoried, listened to (read-only) and routed or exposed. |
lib/zigbee/ExoticQuirkEngine.js | _no header_ |
lib/zigbee/FallbackChains.js | v9.0.414 (P92.122): FallbackChains - every "unsupported" gets a working alternative, and the working path is REMEMBERED. |
lib/zigbee/GreenPowerCluster.js | GreenPowerCluster - Zigbee Green Power Cluster (0x0021) Implementation This cluster handles Green Power Device (GPD) communication for: - Energy-harvesting switches (kinetic/solar) - Friends of Hue switches - Philips Hue |
lib/zigbee/GreenPowerManager.js | _no header_ |
lib/zigbee/InferredDpLayer.js | P3018b: OPTIONAL low-confidence "inferred" Tuya DP layer (master only). |
lib/zigbee/InitTxPacer.js | P3040 - first-start / pairing TX pacer. |
lib/zigbee/IntelligentFrameAnalyzer.js | _no header_ |
lib/zigbee/ManufacturerFeatureMapper.js | _no header_ |
lib/zigbee/MatterCompatibilityLayer.js | _no header_ |
lib/zigbee/MeshFloodCalm.js | P2663 - Zigbee mesh flood calm WHY (P215): - Pourquoi: Bastien live mesh (~8x HOBEIAN switch_1gang) saturated with thousands of msgs - tip 1.0.34 configured haElectricalMeasurement reporting (minInterval 10) on modules w |
lib/zigbee/MethodChain.js | P3017: MethodChain - ordered, self-healing method chains per device and per operation. |
lib/zigbee/MethodCoverage.js | P3017: MethodCoverage - the 20 indirect/alternative methods applied to every capability of every device family, plus a generic per-capability READ/REFRESH chain built on MethodChain. |
lib/zigbee/MultiEndpointCommandListener.js | MultiEndpointCommandListener - Listen for commands on ALL endpoints. |
lib/zigbee/PollControlPolicy.js | Poll Control (0x0020 / genPollCtrl) - do not bind or answer check-in on sleepy nodes. |
lib/zigbee/PowerClusterPolicy.js | Power Configuration cluster (0x0001) policy - listen, do not poll sleepy nodes. |
lib/zigbee/RawAdaptiveObserver.js | P3207 RawAdaptiveObserver - raw-data level of docs/rules/DYNAMIC_ADAPTATION.md (t778u/t780u). |
lib/zigbee/RawFrameDeduplicator.js | _no header_ |
lib/zigbee/RejectionTriage.js | P3011: triage for process-level unhandled rejections. |
lib/zigbee/SmartGestureEngine.js | SmartGestureEngine - v1.0.0 Deciphers complex button gestures (Single, Double, Triple, Hold) across multiple protocols. |
lib/zigbee/TimeClusterPolicy.js | Time cluster (0x000A) policy - respond on request, do not poll sleepy nodes. |
lib/zigbee/TimeServerBoundCluster.js | P2933 - ZCL Time cluster (0x000A) server on Homey's side: devices that read genTime (Tuya LCD/TRV clocks, ZCL spec 3.12) get UTC, timezone and DST from the Homey clock. |
lib/zigbee/TuyaMagicPacket.js | v9.0.413 (P92.121) + P103 era-enrich + P2249 + P2685: TuyaMagicPacket - complementary basic-cluster handshake (soft; never boot-fatal). |
lib/zigbee/UnknownCommandEngine.js | P3016: UnknownCommandEngine. Per-device orchestration for unknown frames and DPs. UnknownCommandSink.record -+ +-> app trigger unknown_command_received +-> interpret -> learn ---+-> app trigger inferred_button_action Unk |
lib/zigbee/UnknownCommandInterpreter.js | P3016: UnknownCommandInterpreter. |
lib/zigbee/UnknownCommandSink.js | P3011: UnknownCommandSink - nothing a device sends is lost. |
lib/zigbee/UnknownLearning.js | P3016: UnknownLearning. A bounded, persisted per-device memory that maps an unknown pattern (cluster/cmd/payload pattern, or dp/type/value pattern) to the action that was inferred. - LRU of at most MAX_KEYS entries, kept |
lib/zigbee/UnknownLifecycle.js | P3020 - lifecycle release for the P3011 / P3016 / P3017 per-device state. |
lib/zigbee/UnsupportedRegistry.js | v9.0.412 (P92.120): UnsupportedRegistry - negative cache for unsupported ZCL operations. |
lib/zigbee/ZclClusterLexicon.js | ARCH / SSOT: Lexer for ZCL + Tuya proprietary cluster IDs/names (P2270). |
lib/zigbee/ZclDefaultResponsePolicy.js | Some mains relays (ZBMINIR2, BASICZBR3) never send a ZCL Default Response to setOn/setOff. |
lib/zigbee/ZclErrorKind.js | P3011: ZclErrorKind - one classifier for every "this did not work" outcome of a Zigbee op. |
lib/zigbee/ZclFrameHeader.js | P3017: decode the ZCL header of a raw incoming frame for diagnostics. |
lib/zigbee/ZclSwitchConfigPolicy.js | Homey settings win over a Tuya ZCL power-restore dump. |
lib/zigbee/ZclTsnContinuity.js | P3029: ZclTsnContinuity: one outgoing ZCL transaction sequence number (TSN) per physical device, continued across app restarts. |
lib/zigbee/ZclUnsupportedGuard.js | P3011: ZclUnsupportedGuard - process-wide, per-device handling of "unsupported" outcomes at the zigbee-clusters layer, so EVERY call site (455 drivers, lib managers, Flow actions) benefits without being rewritten. |
lib/zigbee/ZigbeeCommandManager.js | ZigbeeCommandManager - Inspired by ZiGate Command Handling Robust command execution with: - Automatic retry on resource errors (0x80-0x86, 0x8B) - Queue management for concurrent requests - Error code handling (all 0x80- |
lib/zigbee/ZigbeeCommandPacer.js | Per-device Zigbee TX queue. Spacing (NOT retry): 15-50 ms between successive commands so multi-gang bursts do not collide on the air. Retry (separate): up to 3 attempts with a FIXED 350 ms delay on MAC/APS no-ack. Do not |
lib/zigbee/ZigbeeDataQuery.js | ZigbeeDataQuery - v5.5.33 Zigbee-native Data Query PHILOSOPHY: TRUE HYBRID - Query data via BOTH Tuya DP AND ZCL PROBLEM: Some devices use ZCL for some data and Tuya DP for others SOLUTION: Query BOTH protocols and merge |
lib/zigbee/ZigbeeDebug.js | ZIGBEE DEBUG HELPER Helper pour debugger les devices Zigbee selon la documentation SDK v3 - Inspection des clusters - Test d'attributs - Monitoring des reports - Diagnostic complet |
lib/zigbee/ZigbeeErrorCodes.js | ZigbeeErrorCodes - Complete Error Code Database Based on ZiGate comprehensive error handling Source: https://zigate.fr/documentation/commandes-zigate/ Provides: - Complete error code definitions - Error severity classifi |
lib/zigbee/ZigbeeHealthMonitor.js | _no header_ |
lib/zigbee/ZigbeeHelper.js | Zigbee Helper Utilities Fonctions utilitaires partagées pour tous les drivers Zigbee |
lib/zigbee/ZigbeeHelpers.js | _no header_ |
lib/zigbee/ZigbeeLibBackports.js | Local backports from newer Athom libraries, kept here because the app stays on zigbee-clusters 2.6.0 / homey-zigbeedriver 2.2.17: the newer releases require Node >= 22, which Homey only ships from firmware v12.9.0, while |
lib/zigbee/ZigbeeProtocolPatchManager.js | _no header_ |
lib/zigbee/ZigbeeTimeout.js | ZigbeeTimeout - Utility for adding timeouts to Zigbee operations Prevents infinite hangs when devices don't respond |
lib/zigbee/ZigpyIntegration.js | _no header_ |
lib/zigbee/cluster/AttributeIO.js | AttributeIO - readAttributes / writeAttributes with timeout, bounded retry and fallbacks: 1. |
lib/zigbee/cluster/BindingPlanner.js | BindingPlanner - bind the client (output) clusters a device uses to talk to Homey, on EVERY endpoint that declares them, with bounded retries. |
lib/zigbee/cluster/ClusterLayerAttach.js | ClusterLayerAttach (P2935) - wires the P2931 cluster layer into every TuyaZigbeeDevice, AFTER native setup (called from the deferred init block). |
lib/zigbee/cluster/ClusterRegistry.js | ClusterRegistry - idempotent, order-independent cluster registration. |
lib/zigbee/cluster/EndpointAdapter.js | EndpointAdapter - compare what the driver expects (driver.compose zigbee endpoints) with what the device really exposes (node descriptor from the interview) and produce an ADDITIVE adaptation plan: extra endpoints/ clust |
lib/zigbee/cluster/ReportingPlan.js | ReportingPlan - sensible configureReporting defaults per capability, and a bounded polling fallback ONLY for attributes whose reporting config failed. |
lib/zigbee/cluster/RoutedBoundCluster.js | RoutedBoundCluster - one BoundCluster factory for every client-side command a device sends to Homey (onOff, levelControl, scenes, colorControl, windowCovering, iasZone, iasACE, ota, time, pollControl, groups, and the Tuy |
lib/zigbee/cluster/ZclCodec.js | ZclCodec - frame-level fallback parser for raw ZCL frames, independent of zigbee-clusters' cluster registry. |
lib/zigbee/cluster/index.js | Lazy accessors: nothing is required until first use (startup memory budget). |
lib/zigbee/index.js | Zigbee Utilities Index - v5.5.797 Centralized exports for all Zigbee-related utilities |
lib/zigbee/obsolete/safe-io.js | Safe I/O wrapper with retry logic for Zigbee operations Handles "Timeout: Expected Response" and other transient errors |
lib/zigbee/obsolete/wait-ready.js | Wait for Zigbee to be ready before attempting operations Prevents "Zigbee est en cours de démarrage" errors |
lib/zigbee/registerClusters.js | _no header_ |
lib/zigbee/zigbee-cluster-map.js | ZIGBEE CLUSTER MAPPING Global cluster ID mapping table for Zigbee devices Maps symbolic names to numeric cluster IDs Usage: const CLUSTER_MAP = require('./zigbee-cluster-map'); const clusterId = CLUSTER_MAP.get('POWER_CO |