Updated Integrations (markdown)

rstrouse 2023-09-24 10:58:00 -07:00
parent 40538fdb7a
commit a93da86b8a

@ -578,8 +578,55 @@ ESPSomfy-RTS publishes attributes to your MQTT broker and subscribes to topics t
![image](https://github.com/rstrouse/ESPSomfy-RTS/assets/47839015/b6c578ef-2d55-4d3a-b259-054ac99ef185)
## Subscribed Topics
ESPSomfy RTS subscribes to topics on your MQTT broker. These topics are responded to immediately so please do not set a retain flag or a QoS greater than 0 for these. If you do, when ESPSomfy RTS connects to the broker it will send these commands again and just booh.
### \[root topic\]/shades/\[shadeId\]/direction/set
Moves the shade in the direction of the numeric payload. This can be 0 for stop or toggle, 1 for down, and -1 for up.
To move the shade up, down, or stop set the `{root topic}/shades/{shadeId}/directon/set` topic to -1 for up 0 for stop or 1 for down. This will begin moving the shade in the specified direction or stop the shade if you set it to 0.
### \[root topic\]/shades/\[shadeId\]/target/set
Moves a shade to the position of the numeric payload from 0 to 100 percent where 0 equals fully open and 100 equal fully closed.
### \[root topic\]/shades/\[shadeId\]/tiltTarget/set
Moves a shade tilt to the position of the numeric payload from 0 to 100 percent where 0 equals fully open and 100 equal fully closed.
### \[root topic\]/shades/\[shadeId\]/mypos/set
Sets the my position for the shade in percentage from 0-100 or clears the my position if you set the value to the current mypos.
### \[root topic\]/shades/\[shadeId\]/myTiltPos/set
Sets the my position for the shade tilt if the shade has a tilt type from 0-100 or clears the my position for the tilt if you set the value to the current myTiltPos.
### \[root topic\]/shades/\[shadeId\]/position/set
Sets the current position of the shade. This will not move the motor it only sets the current synchronized position.
### \[root topic\]/shades/\[shadeId\]/tiltPosition/set
Sets the current tilt position of the shade. This will not move the motor it only sets the current synchronized position.
### \[root topic\]/shades/\[shadeId\]/sunFlag/set
Turns the sun flag on or off for the shade. A value of 1 turns on the sun sensor and a value of 0 turns it off.
### \[root topic\]/shades/\[shadeId\]/sunny/set
Sets the motor sensor status to sunny or not sunny. A value of 1 sets it to sunny and 0 to not sunny.
### \[root topic\]/shades/\[shadeId\]/windy/set
Sets the motor sensor status to windy or calm. A value of 1 sets it to windy and 0 to calm.
### \[root topic\]/groups/\[groupId\]/direction/set
Moves the members of the group in the direction of the numeric payload. This can be 0 for stop or toggle, 1 for down, and -1 for up.
To move the shade up, down, or stop set the `/{root topic}/groups/{groupId}/directon/set` topic to -1 for up 0 for stop or 1 for down. This will begin moving the group members in the specified direction or stop the group if you set it to 0.
### \[root topic\]/groups/\[groupId\]/sunFlag/set
Turns the sun flag on or off for the group. A value of 1 turns on the sun sensor and 0 turns it off.
### \[root topic\]/groups/\[groupId\]/sunny/set
Sets the member motor sensors status to sunny or not sunny. A value of 1 sets them to sunny and 0 to not sunny.
### \[root topic\]/groups/\[groupId\]/windy/set
Sets the member motor sensors status to windy or calm. A value of 1 sets them to windy and 0 to calm.
To move the shade up, down, or stop set the `/{shadeId}/directon/set` topic to -1 for up 0 for stop or 1 for down. This will begin moving the shade in the specified direction or stop the shade if you set it to 0. To move the shade to a position simply set the topic `/{shadeId}/target/set` to the percentage closed that you would like. Where 0 equals fully open and 100 equals fully closed.
![image](https://github.com/rstrouse/ESPSomfy-RTS/assets/47839015/a63ea9cd-db7a-4e28-bf23-06df5f0ced9f)