Somfy module¶
Since | Origin / Contributor | Maintainer | Source |
---|---|---|---|
2016-09-27 | vsky279 | vsky279 | somfy.c |
This module provides a simple interface to control Somfy blinds via an RF transmitter (433.42 MHz). It is based on Nickduino Somfy Remote Arduino skecth. It also allows listening to commands transmitted by the Somfy remote control.
The hardware used is the standard 433 MHz RF transmitter. Unfortunately these chips are usually transmitting at he frequency of 433.92MHz so the crystal resonator should be replaced with the resonator on this frequency though some reporting that it is working even with the original crystal.
To understand details of the Somfy protocol please refer to Somfy RTS protocol and also discussion here.
The module is using hardware timer so it cannot be used at the same time with other NodeMCU modules using the hardware timer, i.e. sigma delta
, pcm
, perf
, or pwm
modules.
somfy.sendcommand()¶
Builds an frame defined by Somfy protocol and sends it to the RF transmitter.
Syntax¶
somfy.sendcommand(pin, remote_address, command, rolling_code, repeat_count, callback)
Parameters¶
pin
GPIO pin the RF transmitter is connected to.remote_address
address of the remote control. The device to be controlled is programmed with the addresses of the remote controls it should listen to.command
command to be transmitted. Can be one ofsomfy.SOMFY_UP
,somfy.SOMFY_DOWN
,somfy.SOMFY_PROG
,somfy.SOMFY_STOP
rolling_code
The rolling code is increased every time a button is pressed. The receiver only accepts command if the rolling code is above the last received code and is not to far ahead of the last received code. This window is in the order of a 100 big. The rolling code needs to be stored in the EEPROM (i.e. filesystem) to survive the ESP8266 reset.repeat_count
how many times the command is repeatedcallback
a function to be called after the command is transmitted. Allows chaining commands to set the blinds to a defined position.
My original remote is TELIS 4 MODULIS RTS. This remote is working with the additional info - additional 56 bits that follow data (shortening the Inter-frame gap). It seems that the scrambling algorithm has not been revealed yet.
When I send the somfy.DOWN
command, repeating the frame twice (which seems to be the standard for a short button press), i.e. repeat_count
equal to 2, the blinds go only 1 step down. This corresponds to the movement of the wheel on the original remote. The down button on the original remote sends also somfy.DOWN
command but the additional info is different and this makes the blinds go full down. Fortunately it seems that repeating the frame 16 times makes the blinds go fully down.
Returns¶
nil
Example¶
To start with controlling your Somfy blinds you need to:
- Choose an arbitrary remote address (different from your existing remote) -
123
in this example - Choose a starting point for the rolling code. Any unsigned int works, 1 is a good start
- Long-press the program button of your existing remote control until your blind goes up and down slightly
- execute
somfy.sendcommand(4, 123, somfy.PROG, 1, 2)
- the blinds will react and your ESP8266 remote control is now registered - running
somfy.sendcommand(4, 123, somfy.DOWN, 2, 16)
- fully closes the blinds
For more elaborated example please refer to somfy.lua
.
somfy.listen()¶
Using RF receiver listens to Somfy commands and triggers a callback when command is identified.
Syntax¶
somfy.listen(pin, callback)
Parameters¶
pin
GPIO pin the RF receiver is connected to.callback(address, command, rc, frame)
a function called when a Somfy command is identified. Usenil
to stop listening.address
of the remote controller sending the commandcommand
sent by the remote controller. A number between 0 and 0xf. Can besomfy.SOMFY_UP
,somfy.SOMFY_DOWN
,somfy.SOMFY_PROG
,somfy.SOMFY_STOP
.rc
rolling codeframe
String of 10 characters with the full captured data frame.
Returns¶
nil
Example¶
somfy.listen(4, function(address, command, rc, frame)
print(("Address:\t0x%x\nCommand:\t0x%x\nRolling code:\t%d"):format(address, command, rc))
print(("Frame:\t"..("%02x "):rep(#frame)):format(frame:byte(1, -1)))
end)
Use somfy.listen()
or somfy.listen(4, nil)
to unhook the GPIO and free the callback.