Hass.io add-on for Plejd home automation devices. Gives you the ability to control the Plejd home automation devices through Home Assistant. It uses MQTT to communicate with Home Assistant and supports auto discovery of the devices in range.

It also supports notifications so that changed made in the Plejd app are propagated to Home Assistant.

Thanks to ha-plejd for inspiration.

Disclaimer: I am in no way affiliated with Plejd and am solely doing this as a hobby project.

Did you like this? Consider helping me continue the development:
Buy me a coffee

To get started, make sure that the following requirements are met:

• A Bluetooth device (BLE), for eg. the built-in device in Raspberry Pi 4.
• An MQTT broker (the Mosquitto Hass.io add-on works perfectly well).

The add-on has been tested on the following platforms:

• Mac OS Catalina 10.15.1 with Node v. 13.2.0
• Raspberry Pi 4 with Hass.io

• DIM-01
• DIM-02
• LED-10
• CTR-01
• REL-01
• REL-02
• WPH-01

Browse to your Home Assistant installation in a web browser and click on Hass.io in the navigation bar to the left.

• Open the Home Assistant web console and click Hass.io in the menu on the left side.
• Click on Add-on Store in the top navigation bar of that page.
• Paste the URL to this repo https://github.com/icanos/hassio-plejd.git in the Add new repository by URL field and hit Add.
• Scroll down and you should find a Plejd add-on that can be installed. Open that and install.
• Enjoy!

Browse your Hass.io installation using a tool that allows you to manage files, for eg. SMB or an SFTP client etc.

• Open the /addon directory
• Create a new folder named hassio-plejd
• Copy all files from this repository into that newly created one.
• Open the Home Assistant web console and click Hass.io in the menu on the left side.
• Click on Add-on Store in the top navigation bar of that page.
• Click on the refresh button in the upper right corner.
• A new Local Add-on should appear named Plejd. Open that and install.
• Enjoy!

When starting the add-on, the log displays this message:

parse error: Expected string key before ':' at line 1, column 4
[08:56:24] ERROR: Unknown HTTP error occured

However, the add-on still works as expected and this is something I'm looking into, but not with that much effort yet though.

If you're planning on running this add-on outside of HassOS, you might need to turn off AppArmor in the config.json file. This is due to missing AppArmor configuration that is performed in HassOS (if you've manually done it, ignore this).

Open the config.json file and locate host_dbus, after that line, insert: "apparmor": "no", and then restart the add-on.

More information about available parameters can be found here: https://developers.home-assistant.io/docs/en/hassio_addon_config.html

You need to add the following to your configuration.yaml file:

mqtt:
  broker: [point to your broker IP eg. 'mqtt://localhost']
  username: [username of mqtt broker]
  password: !secret mqtt_password
  discovery: true
  discovery_prefix: homeassistant
  birth_message: 
    topic: 'hass/status'
    payload: 'online'
  will_message: 
    topic: 'hass/status'
    payload: 'offline'

The above is used to notify the add-on when Home Assistant has started successfully and let the add-on send the discovery response (containing all devices).

The plugin needs you to configure some settings before working. You find these on the Add-on page after you've installed it.

With the Google Home integration in Home Assistant, you can get voice control for your Plejd lights right away, check this out for more information: https://www.home-assistant.io/integrations/google_assistant/

Check this out for more information on how you can get your Plejd lights controlled using HomeKit: https://www.home-assistant.io/integrations/homekit/

v 0.4.3:

• FIX: Updated add-on to work with the API changes made by Plejd.

v 0.4.0:

• NEW: Implemented support for Plejd scenes, each scene appears as a switch in Home Assistant.
• NEW: WPH-01 is supported and generates two switches (left and right button).
• NEW: Write queues, finally able to incorporate Plejd devices in HA automations/scenes etc.

v 0.3.4:

• NEW: connectionTimeout configuration parameter to enable tweaking of wait time on connection, usable for RPi 3B+.
• FIX: Reworked some logging to get better understanding of what happens.

v 0.3.0:

• NEW: New BLE manager, DBus instead of noble
• FIX: Adding entities as devices now as well
• FIX: Bug fixes

v 0.2.8:

• FIX: Reset characteristic state on disconnect

v 0.2.7:

• FIX: Added exception handling to unsubscribing lastData characteristic if already disconnected

v 0.2.6:

• FIX: Added null check to remove listeners for characteristics

v 0.2.5:

• FIX: Invalid scene id in events/scene message

v 0.2.4:

• Stability improvements

v 0.2.3:

• FIX: Container build error fix

v 0.2.2:

• Stability improvements

v 0.2.1:

• Stability improvements

v 0.2.0:

• Stability improvements
• Bugfixes

v 0.1.1:

• FIX: Fixed missing reference on startup, preventing add-on from starting

v 0.1.0:

• NEW: Rewrote the BLE integration for more stability
• FIX: discovery wasn't always sent

previous:

• FIX: bug preventing add-on from building
• NEW: Added support for Plejd devices with multiple outputs (such as DIM-02)

Copyright 2019 Marcus Westin <marcus@sekurbit.se>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.