Python package for communicating with and controlling Plejd devices with Home Assistant
Contributors not listed in git history - in no particular order:
Much information below is taken from here: icanos/hassio-plejd#163
Other things I have disocvered myself
Used for communication both ways
(two digits or letters correspond to one byte)
AA 0110 CCCC ...
Command CCCC sent to address AA
Command 0420 is a group of command, followed by a three byte specifier:
AA 0110 0420 DDDDDD ...
Some commands can be both received and sent "(R/W)". Others can be received only "(RO)" or sent only "(WO)".
Activate scene SS
Always sent to address 00. Probably a broadcast address.
Turn on SS=01 or off SS=00 light at address AA.
Turn on SS=01 or off SS=00 light at address AA.
If turn on, set dim level to DDDD.
DDDD is encoded big-endian.
The easiest way to decode this is to ignore the first byte, and only care about the second.
When sending the command, send the same byte twice. That way you get the dim level in the range 0-255
instead of 0-65535, which is easieer to handle.
Set color temperature of light at address AA to TTTT Kelvin.
TTTT is encoded little-endian and seems to typically be the range 2200-4000 (declared in the device data from the cloud).
I have not discovered the significance of XX. When sending the command 03 seems to always work, but I have seen different values received.
Received when WMS-01 detects motion. Motion events are rate limited to about every 25-35 seconds.
The command is followed by eight bytes of data. I think the last two may be related to light level, but my experiments are inconclusive. The other's may or may not have something to do with battery voltage, maybe...
Button no. BB was pressed on the device with address AA.
If XX is included, XX=01 indicates the button was pressed and XX=00 indicates it was released.
Sending this command will cause ALL buttons to send the Button Pressed command when pressed. Otherwise only battery powered buttons (WPH-01) will do so.
This is what the Plejd app uses to identify a button when programming it. As far as I can tell, this does not affect the normal operation of the buttons.
Note that this is the same command as light dim level.
PPPP is the position of the cover. Encoded little-endian.
The cover will send the target position and SS=01 while moving and SS=00 when the movement is complete.
YY is somehow related to the angle of the cover slats (if applicable).
It seems to be two zero bytes followed by a six bit signed integer which gives the angle of the cover slats in 5 degree increments +/- 5.
If the cover is of a type going between -90 and +90, it will take those values. If the cover goes between 0 and +90, the value will be in the range [-90, 0].
I've given up on reliably decoding this for the time being...
It also seems that holding the buttons for a longer time sends different commands...
Set cover at address AA to position PPPP.
PPPP is encoded little-endian and sets a percentage between 00 and 0xFFFF.
I believe the angle of the cover slats (if applicable) is adjusted by small movements after reaching the target position. I've not dived into this at the time being (see above).
Immediately stops the movement of the cover.
