/hass-plejd

🔹 Plejd BLE integration for Home Assistant

Primary LanguagePython

Plejd integration for Home Assistant

Connects to your Plejd devices using your Home Assistant Bluetooth.

This integration requires a Bluetooth adapter which supports at least one Active connections.

Using an EspHome Bluetooth Proxy is recommended, but Shelly proxies will not work. If you make your own esphome configuration, make sure the bluetooth_proxy has active set to True.

Installation for testing

  • Make sure you have a working Bluetooth integration in Home Assistant (a bluetooth proxy should work too)

  • Make sure you have no other plejd custom components or add-ons running.

  • Install the integration:

    • Either: Download the plejd directory and place in your <config>/custom_components.
    • Or: Add this repo (thomasloven/hass_plejd) as a custom repository in HACS, add the integration from HACS

  • Restart Home Assistant

  • Hopefully, your Plejd mesh will be auto discovered and you should see a message popping up in your integrations page.

  • Log in with the credentials you use in the Plejd app when prompted (email address and password)

Supported devices

  • All known Plejd dimmers and relays should work.

    • DAL-01 is still largely untested. If you have a DAL-01 connected to a DALI bus with more than one device, or some non-light devices, please get in touch.

  • All known Plejd lights should work

  • Color temperature is supported for DWN-01 and DWN-02 (and possibly LED-75 and DAL-01, though this is untested)

    • Note that Plejd devices do not report back changes to the color temperature, so if you change temperature in Home Assistant, that will not be reflected in the plejd app and vice versa. Home Assistant may also "forget" what color temperature was set from time to time.

  • Pushbutton WPH-01 should work.

    • An event entity will be triggered when each button is pushed

  • Motion sensor WMS-01 should work

  • Rotary dimmer WRT-01 should register and fire events when pushed.

    • Rotations are not registered. This is a limitation in how Plejd works. Rotation events are not actually sent to the mesh, but directly to whatever device the WRT-01 is paired to. Therefore it is impossible to listen in on them.

  • Plejd Scenes should show up and be triggerable in Home Assistant (unless hidden in the Plejd app).

    • An event entity will be triggered when they are activated (even if hidden in the Plejd app).

Unsupported devices

  • GWY-01 doesn't do anything.

  • EXT-01 doesn't do anything

  • RTR-01 Is not actually a device but an addition to other devices.

Other integrations

There area several other integrations for Plejd with Home Assistant available, made by some awesome people.

The following is a list of the ones I have looked at in order to create this one, and how this one is different.

I could not have made this one without their great job in decoding the Plejd cloud API and Bluetooth communication protocol.
hassio-plejd @icanos Works only with Home Assistant OS.
Relies on MQTT for communication.
Requires exclusive access to a Bluetooth dongle.
Does not support Bluetooth Proxy.
plejd2mqtt @thomasloven Somewhat outdated stand-alone version of the above.
Relies on MQTT for communication.
Requires exclusive access to a Bluetooth dongle.
Does not support Bluetooth Proxy.
Does not support switches or scenes.
ha-plejd @klali
(also check this fork by @bnordli)		 Does not communicate with the Plejd API and therefore requires you to extract the cryptokey and device data from the Plejd app somehow.
No auto discovery.
Requires exclusive access to a Bluetooth dongle.
Does not support Bluetooth Proxy.
homey-plejd @emilohman For Homey
homebridge-plejd @blommegard For Homebridge

The Plejd name and logo is copyrighted and trademarked and belongs to Plejd AB. The author of this repository is not associated with Plejd AB.