A premium, 100% local Home Assistant integration for CozyLife smart devices. Control your switches, lights, smart plugs, and environment sensors securely without any cloud dependency.
CozyLife Local is stable for the device families that have been confirmed through local validation and field reports.
Confirmed support currently includes multi-gang wall switches, dimmable and color-capable lights, sleeping temperature/humidity sensors, standard smart plugs, and power-metered outlets. Physical device specifications still vary by manufacturer and model layout, so unconfirmed CozyLife devices may need catalog or DPID adjustments.
We are still looking for reports to expand coverage for:
- Single gang wall switches & smart plugs
- High-power/power-monitoring smart plugs and outlets
- RGB & Tunable White lights (bulbs, ceiling fixtures, and LED strips)
- Battery-powered smart sensors (temperature, humidity, motion, door/window, smoke)
Note
If you have an unsupported device model or experience issues, please follow our Setup & Troubleshooting Guide to extract and share your device's raw discovery logs.
- ⚡ 100% Local Control: Zero reliance on the CozyLife cloud. All control commands and sensor polling happen locally over your Wi-Fi network, ensuring maximum security, privacy, and ultra-low latency.
- 🔌 Auto-Discovery Scanner: Instantly scans your local IPv4 subnet (supports customizable CIDR, e.g.
192.168.1.0/24) and displays the number of active CozyLife devices on the network. - 📍 Static IP & Sleep Sensor Modes: Easily provision devices individually via single static IP addresses. Includes a specialized "Sleeping temp/humidity sensor" mode that leverages cached metadata to safely pre-build battery-powered entities before the hardware wakes.
- 🧭 Visible Device IP Diagnostics: Exposes each configured device's local IP address as a diagnostic sensor in Home Assistant, making router checks and troubleshooting easier.
- 🎛️ Multi-Gang Switch Bitmasks: Native, low-level bitmask control on DPID 1 ensures multi-gang rockers (e.g., double or triple rocker switches) act as individual, responsive entities.
- 🧩 Switch Option Controls: Exposes supported wall-switch Power-on State, LED Status, and Home Assistant-backed schedule controls when the device catalog advertises the required DPIDs.
- 📈 Smart Energy Metering: Auto-detects power-monitoring smart plug chips to expose voltage, current, active power, and cumulative energy sensors (compatible with the HA Energy Dashboard), plus plug options such as countdowns, schedules, LED behavior, power-on restore, and overcurrent protection where supported.
- 💡 State & Color-Mode Safeguards: Smooth transitions and automatic work-mode state preservation prevents smart lights from glitching or flashing dark blue during custom RGB commands.
- 🕒 Light Schedules & Countdowns: Exposes Home Assistant-backed smart light schedule controls plus validated local countdown support on compatible bulbs.
- 🛠️ Developer-Mode Setup: Features a "Skip validation" config option, allowing advanced users to add remote devices or provision entities without waiting for active handshakes.
For complete, detailed instructions on onboarding new hardware, configuring your router, and optimizing your network, read our Comprehensive Device Setup Guide.
-
Add Custom Repository:
- Open HACS in Home Assistant ➔ Click Integrations.
- Click the three dots in the top-right corner ➔ Select Custom repositories.
- In the Repository field, paste:
https://github.com/soulripper13/cozylife_local - Select Integration under the Category dropdown ➔ Click Add.
-
Download Integration:
- Click on the newly discovered CozyLife Local integration card.
- Click Download in the bottom-right corner and select the desired version.
-
Restart Home Assistant:
- Navigate to
Settings➔System➔ ClickRestartin the top right.
- Navigate to
Once HACS has completed installation and Home Assistant has restarted:
- Navigate to
Settings➔Devices & Services. - Click
+ ADD INTEGRATIONin the bottom-right. - Search for "CozyLife Local" and click to open the configuration flow.
- Set up your device:
- Auto-Scan: Leave the IP field blank, review the CIDR, and hit submit to let the integration locate devices on your subnet.
- Manual Setup: Input the static IP address of your device.
- Sleeping Environment Sensor: If manual provisioning is for a battery-powered sensor, check the "Sleeping temp/humidity sensor" box to avoid handshake timeouts.
- Skip Validation: Check this option to add remote or offline devices immediately (Developer Mode).
Battery-powered environment sensors spend most of their time asleep. The standard report interval is 1800s / 30 minutes. For compatible firmware, the sleeping-sensor setup and options flow also provides an experimental short-interval mode that allows 600s / 10-minute updates.
Warning
The 600s interval is experimental. Long-run checks have shown mostly 10-minute wake cycles on compatible firmware, but some cycles can still fall back to about 30 minutes. Use 1800s when a predictable firmware-supported interval matters more than faster updates.
Home Assistant preserves the last valid temperature and humidity readings when a sleeping sensor returns placeholder values during a short wake window. See the Sleeping Battery-Powered Sensors section for setup details and optional router isolation guidance.
Multi-gang wall switches use DPID 1 as a bitmask. Home Assistant exposes each gang as its own switch entity while preserving one local device connection.
Some wall switches also advertise hidden option DPIDs in the bundled catalog. When available, CozyLife Local exposes:
- Power-on State (
DPID 18) - LED Status (
DPID 19) - Schedule controls (
DPID 3) backed by Home Assistant
Wall-switch schedules are executed by Home Assistant against the selected switch entity. They do not rely on the same native one-shot timer payload used by metered plugs.
Metered plugs expose outlet control plus electricity sensors:
- Energy (
DPID 26) as kWh using/1000 - Current (
DPID 27) as raw mA - Power (
DPID 28) as raw W - Voltage (
DPID 29) as raw V
Compatible plugs can also expose:
- Countdown (
DPID 2) - One-shot schedule controls (
DPID 3) with native device sync for decoded turn-off timers - Power-on State (
DPID 18) - LED Status (
DPID 19) - Overcurrent Protection (
DPID 32)
Compatible smart bulbs and light strips expose local light controls plus:
- Countdown (
DPID 13) exposed as the same seconds-based countdown number pattern used by compatible plugs - Schedule controls backed by Home Assistant for turn-on and turn-off actions, including enabled, time, action, and repeat controls
Light schedules run through Home Assistant and call the selected light entity. The native light normal_timer payload (DPID 14) is not written until its app timer format is decoded for more variants.
CozyLife devices report their functionalities via standard Data Point IDs (DPIDs). Below is a quick-reference mapping of known features exposed by this integration:
| DPID | Target Function | Description |
|---|---|---|
1 |
Power / Switch Bitmask | Master light power, plug power, or multi-gang rocker state bitmask. |
2 |
Work Mode / Countdown | Light profile settings on bulbs; gang-1 timer/countdown on switches. |
3 |
Color Temperature / Schedule | White light warmth control on lights; one-shot schedule payload on compatible plugs and schedule capability marker on some wall switches. |
4 |
Brightness / Humidity | Light intensity scaling, relative humidity levels on sensors, or gang-2 timers. |
5 |
Hue | 360-degree color hue control on addressable RGB lights. |
6 |
Saturation / Motion | Color saturation percentage, motion trigger status, or gang-3 timers. |
7 |
Contact / Color Mode | Door/window magnetic contact sensor; secondary color spectrum mapping. |
8 |
Temperature / Scene | Temperature sensor data (Celsius); pre-programmed lighting presets. |
9 |
Battery Level | Exposes remaining battery charge on supported portable sensors. |
10 |
Moisture Status | Water-leak detection and alarm sensor. |
11 |
Smoke Detection | Smoke alarm status and alarm sensor. |
13 |
Light Countdown | Countdown seconds on compatible lights. |
14 |
Report Interval / Light Timer | Sleep interval timer for battery-operated sensors (standard 1800s; experimental 600s on compatible firmware); native normal_timer payload on compatible lights. |
18 |
Power-on State | Relay restore behavior after power loss on compatible plugs and wall switches. |
19 |
LED Status | Indicator LED behavior on compatible plugs and wall switches. |
24 |
Humidity Sensitivity | Delta threshold to trigger updates on environmental sensor arrays. |
25 |
Temp Sensitivity | Delta threshold to trigger updates on environmental sensor arrays. |
26 |
Cumulative Energy (kWh) | Exposes total energy consumption, fully compatible with HA Energy Dashboard. |
27 |
Active Current (mA) | Live electrical current monitoring. |
28 |
Active Power (W) | Live active load power monitoring. |
29 |
Line Voltage (V) | Live grid voltage monitoring. |
30 |
Electrical Fault | Exposes physical load fault alarms reported by power monitoring plugs. |
32 |
Overcurrent Protection | Config switch for compatible metered plugs. |
101 |
Occupancy Sensor | Proximity and movement detection via millimeter-wave radar modules. |
Please refer to the Troubleshooting & Network Tuning Section in our Setup Guide if you encounter:
- Devices repeatedly dropping offline or showing as
Unavailable - Network firewall questions or router Access Point (AP) isolation settings
- Multicast auto-discovery failures or IGMP Snooping advice
- Missing electricity metering or power monitoring entities
We welcome community contributions, particularly new CozyLife model catalog additions!
- Fork the repository and create a feature branch.
- If adding a new device PID, update
model.jsonto register the new mapping. - Test your changes locally.
- Open a Pull Request detailing the device hardware, PID, and DPIDs.
Please include active debug logs (showing the Successfully discovered device handshake details) when opening issues or pull requests.
This project is developed and maintained in spare time and is provided free to the community. Any contribution is appreciated — but never required ❤️
- Ko-fi: https://ko-fi.com/soulripper13
- PayPal: https://paypal.me/SKatoaroo
- Bitcoin (BTC):
bc1qvu8a9gdy3dcxa94jge7d3rd7claapsydjsjxn0 - Solana (SOL):
4jvCR2YFQLqguoyz9qAMPzVbaEcDsG5nzRHFG8SeaeBK
Thank you for being part of the CozyLife Local community!