cozylife_local

KO | EN

gitlite — search

#python #ai #typescript #llm #go #android #deep-learning #macos #nodejs #windows #security #pytorch #mcp #open-source

(★ 20)

Home Assistant integration for CozyLife smart devices

cozylife_local 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CozyLife Local for Home Assistant

[![HACS Default](https://img.shields.io/badge/HACS-Default-orange.svg?style=for-the-badge)](https://github.com/hacs/default)
[![GitHub Release](https://img.shields.io/github/release/soulripper13/cozylife_local.svg?style=for-the-badge)](https://github.com/soulripper13/cozylife_local/releases)
[![GitHub License](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://raw.githubusercontent.com/soulripper13/cozylife_local/main/LICENSE)
[![GitHub Issues](https://img.shields.io/github/issues/soulripper13/cozylife_local.svg?style=for-the-badge)](https://github.com/soulripper13/cozylife_local/issues)
[![GitHub Stars](https://img.shields.io/github/stars/soulripper13/cozylife_local?style=for-the-badge&logo=github)](https://github.com/soulripper13/cozylife_local/stargazers)
![Maintenance](https://img.shields.io/maintenance/yes/2026.svg?style=for-the-badge)
[![Support Development](https://img.shields.io/badge/Support-Development-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/soulripper13)
[![Support via PayPal](https://img.shields.io/badge/Support-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/SKatoaroo)

<div align="center">
  <img src="assets/hero_banner.jpeg" alt="CozyLife Local Hero Banner" width="100%">
  <br><br>
  <strong>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.</strong> 
  <br><br> 
  
  <a href="https://my.home-assistant.io/redirect/hacs_repository/?owner=soulripper13&repository=cozylife_local&category=integration">
    <img src="https://my.home-assistant.io/badges/hacs_repository.svg" alt="Open in HACS">
  </a>
  <a href="https://my.home-assistant.io/redirect/config_flow_start/?domain=cozylife_local">
    <img src="https://my.home-assistant.io/badges/config_flow_start.svg" alt="Add Integration">
  </a>
</div>

---

## Stable Device Support

**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](docs/SETUP_GUIDE.md#6-analyzing-discovery-logs--submitting-new-models) to extract and share your device's raw discovery logs.

---

## Key Features

*   ⚡ **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.

---

## Quick-Start Guide

For complete, detailed instructions on onboarding new hardware, configuring your router, and optimizing your network, read our [Comprehensive Device Setup Guide](docs/SETUP_GUIDE.md).

### Installation via HACS

1. **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**.

2. **Download Integration**:
   * Click on the newly discovered **CozyLife Local** integration card.
   * Click **Download** in the bottom-right corner and select the desired version.

3. **Restart Home Assistant**:
   * Navigate to `Settings` ➔ `System` ➔ Click `Restart` in the top right.

---

## Configuration

Once HACS has completed installation and Home Assistant has restarted:

1. Navigate to `Settings` ➔ `Devices & Services`.
2. Click `+ ADD INTEGRATION` in the bottom-right.
3. Search for **"CozyLife Local"** and click to open the configuration flow.
4. 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).

### Sleeping Environment Sensor Intervals

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](docs/SETUP_GUIDE.md#sleeping-battery-powered-sensors-temphumidity) section for setup details and optional router isolation guidance.

---

## Switches and Metered Plugs

### Wall Switches

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 Smart 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`)

### Smart Lights

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 Data Point IDs (DPIDs)

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. |

---

## Troubleshooting & FAQ

Please refer to the [Troubleshooting & Network Tuning Section in our Setup Guide](docs/SETUP_GUIDE.md#5-network-troubleshooting--router-tuning) 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

---

## Contributing

We welcome community contributions, particularly new CozyLife model catalog additions!

1. Fork the repository and create a feature branch.
2. If adding a new device PID, update `model.json` to register the new mapping.
3. Test your changes locally.
4. 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.

---

## Support the Project

This project is developed and maintained in spare time and is provided free to the community. Any contribution is appreciated — but never required ❤️

### Ways to Support

*   **Ko-fi**: [https://ko-fi.com/soulripper13](https://ko-fi.com/soulripper13)
*   **PayPal**: [https://paypal.me/SKatoaroo](https://paypal.me/SKatoaroo)
*   **Bitcoin (BTC)**: `bc1qvu8a9gdy3dcxa94jge7d3rd7claapsydjsjxn0`
*   **Solana (SOL)**: `4jvCR2YFQLqguoyz9qAMPzVbaEcDsG5nzRHFG8SeaeBK`

Thank you for being part of the CozyLife Local community!

cozylife_local

cozylife_local 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cozylife_local

cozylife_local 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README