aaribaud/ESPSomfy-RTS
0
0
Fork 0
mirror of https://github.com/rstrouse/ESPSomfy-RTS.git synced 2025-12-15 03:52:11 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated Configuring the Software (markdown)

rstrouse 2023-06-15 16:22:01 -07:00
parent d258a435fc
commit d71df8699f
1 changed files with 10 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

13
Configuring-the-Software.md

@ -85,8 +85,10 @@ At this point it is probably beneficial to provide a little bit of a glossary.
## Adding a Shade
To add a shade navigate to the Somfy tab and press the `Add Shade` button. This will open up the shade properties and allow you to enter the information about your shade. You can come back later and edit any of these values later but I caution editing the address after it has been paired. Once you pair the shade with the motor, the motor will store this address. If you change it later it will not know who it is.
### Protocol
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.
### Shade Type
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.
@ -100,25 +102,30 @@ Awnings add support for Sun/Wind sensors that retract the awning whenever the su
You must provide up to 20 characters for the name of the shade. This can include any printable character.
### Addressing
The Remote Address is expected to be unique for all known addresses and the default is generated from the MAC address of your ESP32. This can be any value so long as it is unique. Change it at will but did I mention that it must be unique and the algortithm to calculate a new address only makes sure the address is unique among all the addresses that the ESPSomfy RTS module already knows about.
Remote addresses are 24-bits long and are assigned at the factory for Telis remotes. So unless you have very old remotes you can probably safely assign these to some lower number if you want but only before pairing. Did I mention that these need to be unique for all controller channels and remotes within earshot of the ESPSomfy RTS module.
### Motor Timing
The `Up Time`, `Down Time`, and optional `Tilt Time` fields are the number of milliseconds it takes for the shade to travel from the down position to the up position and vice versa. This value is provided in milliseconds so if you are counting the number of seconds and it takes 10 seconds to fully travel then this equals 10000 milliseconds. The maximum number of milliseconds is around 54 days so if you have a reaaaaaaaly slow motor you too are supported.
In another example, if it takes 9.5 seconds to go from full down to full up then that would be 9500 milliseconds. Keep in mind the up time and the down time can be different depending on the weight of the fabric and you can make adjustments these values at any time in the future. You will find this to be remarkably precise and always in sync if you set this up correctly. Burn a minute to time your shades and they will always be in sync.
If you have an 80-bit motor you can select the step size. This is a relative size used for the tilt wheel on your remote. After selecting the 80-bit setting an additional slider will appear on the screen. You will need to experiment with this as it is a ratio of the lift and tilt timing. This is used to keep the position in sync whenever the nudge wheel is engaged.
### Invert Commands
The Invert Commands checkbox is for instances where when you press the up button on the remote and the blind or shade moves down or your awning extends or your drapery closes. This means that the motor is not configured properly and you ***should*** reverse its direction. Honestly, up is not down no matter what you do. Depending on your motor the way, to change it is different so prescriptive instructions in this wiki are not possible. But here is a link to get you started [Reverse Somfy Motor](https://lmddgtfy.net/?q=reverse%20somfy%20motor).
Really it is backwards. This checkbox will however allow you to live in an upside-down mirror and invert the commands while still having it all correct in the ESPSomfy-RTS application. If I were me and sometimes we are, I would seriously have a conversation with the man in the mirror to make this right.
### Next Steps
Once you are satisfied with your settings press the `Add Shade` button. This will change the screen to include more button functions. You can either perform these processes now or come back later to perform these functions once you have added all your shades.
* **Save Shade** - Saves the current settings for the shade
* **Pair Shade** - Allows you to pair the shade with the somfy motor
* **Link Remote** - Links the channel on your Somfy remote to the shade. This ensures the position of the shade can be known at all times. You can link up to 5 channels to each shade. Beyond that you probably need to simplify your life because you have remotes strewn everywhere. Honestly you should get checked.
The Invert Commands checkbox is for instances where when you press the up button on the remote and the blind or shade moves down or your awning extends or your drapery closes. This means that the motor is not configured properly and you ***should*** reverse its direction. Honestly, up is not down no matter what you do. Depending on your motor the way, to change it is different so prescriptive instructions in this wiki are not possible. But here is a link to get you started [Reverse Somfy Motor](https://lmddgtfy.net/?q=reverse%20somfy%20motor).
Really it is backwards. This checkbox will however allow you to live in an upside-down mirror and invert the commands while still having it all correct in the ESPSomfy-RTS application. If I were me and sometimes we are, I would seriously have a conversation with the man in the mirror to make this right.
## Editing a Shade
You can edit any shade that you have previously added by navigating to the Somfy tab under the config gears in the upper right. From the list of added shades simply click on the pencil to bring up the shade editing screen.