diff --git a/plejd/CHANGELOG.md b/plejd/CHANGELOG.md index 43264bc..6491c1c 100644 --- a/plejd/CHANGELOG.md +++ b/plejd/CHANGELOG.md @@ -4,7 +4,7 @@ **BREAKING - READ BELOW FIRST** -Release 0.8 will break ALL EXISTING DEVICES. Unique mqtt id:s will change, meaning HA will create new devices. Scenes will be added as scenes not as switches. +Release 0.8 will break ALL EXISTING DEVICES. Unique mqtt id:s will change, meaning HA will create new devices. Scenes will be added as scenes not as switches. Devices will be installed to Areas named by the rooms defined in the Plejd app (can be changed) Recommendations to minimize impact @@ -13,7 +13,7 @@ Recommendations to minimize impact - Reboot HA - Go to Configuration => Integration => MQTT. Go to entities and after that devices and remove all Plejd devices (should be listed as unavailable) - Upgrade addon to latest version and start -- All devices should now be back. With luck they will have the same HA id:s as before so most things should work. Room assignments, icons, etc will be gone though. +- All devices should now be back. With luck they will have the same HA id:s as before so most things should work. Room assignments, icons, automations, scenes, etc will have to be gone though. ## [0.7.1](https://github.com/icanos/hassio-plejd/tree/0.7.1) (2021-03-25) diff --git a/plejd/README.md b/plejd/README.md index e126733..a95baea 100644 --- a/plejd/README.md +++ b/plejd/README.md @@ -1,9 +1,32 @@ # Hass.io Plejd add-on 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 uses MQTT to communicate with Home Assistant and supports auto discovery of the devices in range. Changed made in the Plejd app are propagated to Home Assistant. -It also supports notifications so that changed made in the Plejd app are propagated to Home Assistant. +Plejd output devices typically appears as either lights or switches in Home Assistant depending on how they are configured. + + + + + + + + + + + + + + + + + + + + + + +
DevicePlejd ConfigurationHome Assistant RoleComment
CTR-01Relay, LightLight
CTR-01Relay, OtherSwitch
REL-01Relay, LightLight
REL-01Relay, OtherSwitch
REL-02Relay, LightLight
REL-02Relay, OtherSwitch
SPR-01Relay, LightLightNot tested, not released by Plejd
SPR-01Relay, OtherSwitchNot tested, not released by Plejd
DIM-01-Light
DIM-02-Light
LED-10-Light
DAL-01--Not supported, not released by Plejd
WPH-01-Device Automationtype:button_short_press, subtype:button_1, button_2,button_3,button_4
WRT-01-Device Automationtype:button_short_press, subtype:button_1
GWY-01--
RTR-01--
Scene-Scene
Scene-Device Automationtype:scene, subtype:trigger
Room-AreaCan be changed by Home Assistant
Room-LightIf includeRoomsAsLights is set to true
Thanks to [ha-plejd](https://github.com/klali/ha-plejd) for inspiration. @@ -41,8 +64,8 @@ The add-on has been tested on the following platforms: - CTR-01 - REL-01 - REL-02 -- WPH-01 (Note: Available as Device Trigger short_button_press, button_1 .. button_4) -- WRT-01 (Note: Available as Device Trigger short_button_press, button_1. Rotation/dimming not offered by the device) +- WPH-01 +- WRT-01 ### Easy Installation @@ -52,6 +75,7 @@ Browse to your Home Assistant installation in a web browser and click on `Hass.i - 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. +- Configure hassio-plejd (see below) - Enjoy! ### Manual Installation @@ -108,7 +132,16 @@ If you restore a backup from a 32bit system to a new 64bit system, use the Rebui ### Configuration -You need to add the MQTT integration to Home Assistant either by going to Configuration -> Integrations and clicking the Add Integration button, or by adding the following to your `configuration.yaml` file: +#### Simple MQTT Configurations +When you are using the official Mosquitto Broker from Home Assistant Add-on store, minimal configuration is required. +
+ + + +
mqttBrokermqtt://localhost
mqttUsernamehomeassistant
mqttPasswordMosquitto password, fetched via Configuration->Integrations->Mosquitto broker->Configure->RE-CONFIGURE->Password
+ +#### Advanced MQTT Configurations +For more advanced instllations, you need to add the MQTT integration to Home Assistant either by going to Configuration -> Integrations and clicking the Add Integration button, or by adding the following to your `configuration.yaml` file: ``` mqtt: @@ -121,6 +154,8 @@ mqtt: 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 information about all Plejd devices found). +#### Configuration Parameters + The plugin needs you to configure some settings before working. You find these on the Add-on page after you've installed it. | Parameter | Value |