Updated Configuring the Software (markdown)

rstrouse 2023-06-10 10:15:01 -07:00
parent c8f7590921
commit ce4a54a7dd

@ -73,6 +73,7 @@ No matter if I am standing on my head or in any other position, I cannot square
At this point it is probably beneficial to provide a little bit of a glossary.
* **Blind** - A window covering made up of slats with a single up/down motor and an optional tilt motor.
* **Shade** - A window covering that is made up of fabric with a single motor that drives the shade covering up or down on a roller tube. This term is also used as a generic term referring to a defined Shade, Blind, or Drapery in the ESPSomfy RTS software.
* **Awning** - A structured shade that extends and retracts horizontally from a fixed point.
* **Remote** - A physical device such as a Telis or Situo channel that is used to control the said motor(s). Keep in mind a Telis 4 is actually 5 remotes but who's counting.
* **Linked Remote** - A remote that is used to control a particular motor that the ESPSomfy RTS module should know about. ESPSomfy RTS needs to know about these so that if a button is pressed on an external remote it knows what the current position is of the shade should be.
* **Pairing** - The process of linking the defined shade in this software so it can control the shade.
@ -82,13 +83,14 @@ To add a shade navigate to the Somfy tab and press the `Add Shade` button. This
First choose the protocol that the motor understands. Most Somfy motors, use a 56-bit protocol. However, some use 80-bits to communicate and will require you to select the 80-bit setting for the `Bit Length`. The easiest way to tell if you have this scenario is to open the frame log described above then press a button on the remote that is currently being used to control the motor. When ESPSomfy RTS hears the commands from the remote it will indicate whether it was 56-bits or 80-bits.
Next select the type of shade motor you are adding. This can be a Roller Shade, Blind, or Drapery. Roller shades and draperies do not support the optional tilt function. If your window covering has a tilt motor then you will need to use the blind type in order to support it. If you select Blind from the dropdown then a Tilt Type option will become available and the icon will change.
Next select the type of shade motor you are adding. This can be a Roller Shade, Blind, Drapery, or Awning. This determines what type of functions are available for control. Roller shades and draperies typically only support one function where they open and close with the motor. Blinds however support an optional tilt function. If your window covering has a tilt motor or integrated tilt functions, then you will need to use the blind type in order to support it. If you select Blind from the dropdown then a Tilt Type option will become available and the icon will change.
There are a number of tilt mechanisms supported by ESPSomfy RTS. If this is a blind with a tilt function you should select the appropriate type of tilt mechanism that is used on the motor. These are described below.
* ***None*** - The slats of the blind are manually controlled or not controllable remotely.
* ***Tilt Motor*** - The motor assembly is actually two motors in one where a long press on the remote moves the slats open or closed and a short press raises or lowers the blind.
* ***Integrated*** - When the up button is pressed the slats fully open before the motor raises the blind. Conversely, the down button fully closes the slats before lowering the blind.
Awnings add support for Sun/Wind sensors that retract the awning whenever the sun goes away or the wind may damage your precious butterfly wing attached to the house. Selecting Awning as the motor type will add these options to the interface and integrations. For the sensor to work properly you will need to link it to the motor using the link remote function. After all this sensor operates as if it were a remote.
![image](https://github.com/rstrouse/ESPSomfy-RTS/assets/47839015/d7d645fb-341f-4cce-a041-6b070cd022b1)
You must provide up to 20 characters for the name of the shade. This can include any printable character.