You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Maurice Makaay 1735a7d6fd A few new pictures for the flashing docs. 3 years ago
.github Update FUNDING.yml 3 years ago
binary_sensor Applied ESPHome-style code styling. 3 years ago
doc A few new pictures for the flashing docs. 3 years ago
light Dropped the use of exceptions. 3 years ago
output Applied ESPHome-style code styling. 3 years ago
sensor Applied ESPHome-style code styling. 3 years ago
text_sensor Applied ESPHome-style code styling. 3 years ago
.clang-format Applied ESPHome-style code styling. 3 years ago
.clang-tidy Applied ESPHome-style code styling. 3 years ago
.gitignore Moved to a proper ESPHome component structure. 3 years ago
CHANGELOG.md Formatted the codebase using the ESPHome clang rules. 3 years ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 3 years ago
LICENSE.md Create LICENSE.md 3 years ago
README.md Added features list. 3 years ago
__init__.py Use DISABLE_ASYNCTCP_ACK_TIMEOUTS to fix client disconnects (depends on not yet accepted pull request: https://github.com/esphome/esphome/pull/1712). 3 years ago
common.h Applied ESPHome-style code styling. 3 years ago
front_panel_hal.h One small typo for man, one big bug for compiler kind. 3 years ago
light_hal.h Applied ESPHome-style code styling. 3 years ago

README.md

ESPHome components for Xiaomi Mijia Bedside Lamp 2

[ Changelog | License | Code of conduct ]

The Bedside Lamp 2 is a smart RGBWW LED lamp, produced by Yeelight. It can be controlled via the WiFi network and using a touch panel on the front of the device. The touch panel contains a power button, a button that changes the color of the light and a slider that can be used to change the brightness of the light.

This project provides custom components for ESPHome, which make it possible to fully control every aspect of the lamp and to integrate the lamp in your Home Assistant setup.

Features

  • The lamp integrates easily with Home Assistant using the ESPHome integration.

  • The lamp no longer phones home to the Mijia Cloud. Using this firmware, you can rest assured that the network traffic is limited to your own network. This matches the ideas behind Home Assistant, of providing a local home automation platform, that puts privacy first.

  • No more need for the LAN control option to integrate the lamp with Home Assistant. Especially important, because Xiaomi decided in all their wisdom to remove LAN control from the device, breaking existing integrations.

  • The night light supports multiple colors. The original firmware only supports a single warm white night light color.

  • Smooth light color transitions, unlike the current version of the Yeelight integration. The Homekit integration does provide good transitions, but on my system, the color temperature white light mode is missing in the Home Assistant GUI.

  • Since the components of the lamp are exposed as ESPHome components, you don't have to stick with the lamp's original behavior. You can hook up the lamp in your home automation as you see fit. Use the slider to control the volume of your audio set? Long press the power button to put your house in night mode? Use the illumination behind the slider bar to represent the progress of your sour dough bread bulk fermentation? Go ahead, make it so! :-)

Quick start guide

For those who have experience with flashing ESPHome onto devices:

  • Clone the GitHub repo into your ESPHome config/custom_components directory.
  • Copy [doc/example.yaml](doc/example.yaml) to config/your_device_name.yaml.
  • Modify the configuration to your needs (see the configuration guide]).
  • Compile the firmware.bin file and download it to the device to which you have connected your serial to USB adapter (FTDI).
  • Open up the lamp and connect its TX, RX, GND and GPIO0 debug pads to the serial adapter (see the installation guide for the debug pad locations).
  • Power up the lamp with GPIO0 connected to GND to enable flashing mode.
  • Flash firmware.bin onto the device.

If you experience regular disconnects between Home Assistant and the lamp, then take a look at the known issues document.

Table of contents