added ZactuatorSomfy (#816)

* added ZactuatorSomfy
* added Somfy RTS docs

docs/setitup/actuators.md

@@ -15,3 +15,9 @@
 
 Vcc pin of the board and the Module to a 5V supply source
 Ground pins of the board and the Module to the ground of the supply source.
+
+## Somfy RTS
+For this actuator a 433.42 MHz RF transmitter is required.
+The standard 433.92 MHz transmitter don't work.
+The CC1101 Transceiver supports both 433.42 MHz and 433.92 MHz and can be used with the Somfy RTS actor.
+The wiring of the hardware is described in the [RF gateway](rf).

docs/setitup/rf.md

@@ -27,6 +27,7 @@ Connect the Emitter and Receiver to a 5V (**3.3V** for CC1101) supply source, an
 |ESP8266|D2/**D3**/D1/D8|**RX**/D2|D5|**3V3**|D7|D6|D8|GND
 |ESP32|**27**/26|12|D18|**3V3**|D23|D19|D5|GND
 
+To use the CC1101 module, `ZradioCC1101` must be uncomment in the `User_config.h` or added to the `build_flags`.
 More information about the [CC1101 wiring](https://github.com/LSatan/SmartRC-CC1101-Driver-Lib#wiring).
 
 

docs/use/actuators.md

@@ -74,3 +74,42 @@ After this calibration, if you set the `r` channel to 0.0, it will be remapped t
 Also, the gamma curve for this channel will be set to 2.5.
 This means that input values are raised to the power 2.5 internally.
 This can be used to improve the linearity of inputs.
+
+## Somfy RTS
+This actuator allows to control Somfy RTS devices.
+
+### Setup
+Before the module can be used, virtual Somfy RTS remotes must be created.
+This is done in `config_Somfy.h`.
+
+`SOMFY_REMOTE_NUM` must be set to the number of virtual Somfy RTS remotes you want to have.
+Then create for each of the virtual Somfy RTS remotes a unique 3-byte code and add them to `somfyRemotes`.
+After a remote is setup, the order and codes should not be changed, else the setup process for all remotes have to be repeated.
+Adding new codes at the end of the list is no problem.
+Example of three virtual Somfy RTS remote codes:
+```C
+const uint32_t somfyRemotes[SOMFY_REMOTE_NUM] = {0x5184c8, 0xba24d0, 0xb77753};
+```
+
+Next the virtual Somfy RTS remotes must be paired with the Somfy RTS devices you want to control.
+The next section describes how the PROG command/button of the virtual remote can be used.
+Use the manual of the device you want to control for instructions on how to pair the virtual remote with the device.
+
+### Commands
+Commands must be send to the `commands/MQTTtoSomfy` subtopic.
+Only json messages are supported.
+The json message must contain two properties:
+* remote: the index of the remote which is used to send the command (index start at zero)
+* command: the command which should be send with the remote as string, see [table of command names](https://github.com/Legion2/Somfy_Remote_Lib#available-commands).
+
+::: tip NOTE
+The middle button on physical Somfy RTS Remote controls is called "My".
+:::
+
+Send PROG command with remote 0:
+
+`mosquitto_pub -t home/OpenMQTTGateway_Somfy/commands/MQTTtoSomfy -m '{"remote":0,"command":"Prog"}'`
+
+Send Up command with remote 1:
+
+`mosquitto_pub -t home/OpenMQTTGateway_Somfy/commands/MQTTtoSomfy -m '{"remote":1,"command":"Up"}'`