Giter VIP home page Giter VIP logo

homebridge-yeelight-wifi's Introduction

Homebridge YeeLight Wi-Fi

YeeLight plugin for Homebridge supporting Wi-Fi lighting devices.

This allows you to control your YeeLight wi-fi devices, such as the YeeLight Bulb and the YeeLight Stripe with HomeKit and Siri. No apps required.

Requirements

  • Node.js >= 7.6.0
  • Avahi

Installation

  1. Install homebridge, sudo npm install -g homebridge
  2. Install this plugin using, npm install -g homebridge-yeelight-wifi

Setting up devices

Devices that already have the API enabled should be autodiscovered without any other actions on your part.

However, out of the factory, the YeeLight devices do come with the API disabled and you will have to enable it for them to work with Homebridge. To do so, go to settings and enable Developer Mode.

Configuration (Optional)

The following parameters can be changed in case you need to change the defaults.

{
    "bridge": {
        "name": "Raspberry Pi",
    },
    "accessories": [{
    }],
    "platforms": [{
        "platform": "yeelight",
        "name": "Yeelight",
        "transitions": {
            "power": 400,
            "brightness": 400,
            "color": 1500,
            "temperature": 1500
        },
        "connection": {
            "retries": 5,
            "timeout": 100,
        },
        "multicast": {
            "interface": "0.0.0.0"
        },
        "defaultValue": {
            "aed78s": {
                "name": "Kitchen",
                "blacklist": ["set_hsv"]
            }
        }
    }]
}

Motivation

When I got my first YeeLight bulb, there was already a homebridge plugin supporting it, however, it did not deal with transient failures. Frequently I would turn on a lamp, it would report it as On but no sign of light could be seen. Manually turning the lamp off and on would solve the issue but was a nuisance.

This plugin was born to solve this issue and end up being a complete rewrite fixing a lot of other bugs and minor problems and also implementing a cleaner architecture.

This plugin keeps track of all your commands until a successful response is received from the lamp. It implements exponential backoff to retry commands to which no response was received or a failure was reported by the lamp.

It also keeps track of known lamps and will continue to ocasionally look for them if they suddenly disappear. This is useful when you accidentally power off a lamp and later turn it on.

Bugs and feature requests

Please report any issues you might find, on GitHub.

Feature requests and specially pull requests are very welcome.

homebridge-yeelight-wifi's People

Contributors

banzalik avatar deviousm avatar ivofrolov avatar vieira avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.