Somfy ESP8266 Remote Arduino rev 0.1

Somfy ESP8266 Remote 433.24 RTS

Description: Lightweight arduino code for an esp8266 NodeMCU (lolin)

This is a reverse engeneered 433 transmitter for Somfy 433 shutters, controlling the shutter without custumizations on or in the device itself.

This project is an forke of made in Platform IO

https://github.com/marmotton/Somfy_Remote

He forked it from

https://github.com/Nickduino/Somfy_Remote.

If you want to learn more about the Somfy RTS protocol, check out Pushtack.

Usage of this project is on your own risk.

Motivation

2 months ago I wanted a solution to control the shutters in the room of my daughter via HA.

Because I bought a Somfy shutter (8 years ago) I thought who would allready has invented a solution similar to mine.

My requirements would be:

Usable with Home Assisntant
Integrates with MQTT
Has state reporting
ESP8266 NodeMCU (lolin compatible)
A tight PCB for industry finish

Changes

Refarctored code from PlatformIO back to Arduino
Created some state calls and a statefull setup
Seperated some stuff for robustness
Made compatible with HA via MQTT
Matching PCB

Requirements:

MQTT bus
Home Assistant
Arduino IDE
ESP8266
Soldering iron (fine skills to desolder and solder)
433 transmitter
Led inidicator
resistor of 330ohm
2x 15 pin headers
Short 433 antenna
Somfy RT

Desolder 433.92Mhz and solder 433.42Mhz crystal on transmitter

So firstly remove the original crystal with the new 433.42Mhz (see list below). Tip, there is a pin on the side as marking to connect the new one in the correct order (if your unsure)

Order PCB

See this site: https://aisler.net/partners/fritzing You can order with this file: https://github.com/RoyOltmans/somfy_esp8266_remote_arduino/raw/master/esp%20somfy%20rf_v1.2.fzz

Assembling

tips:

You will need to use an resistor of 330ohm on the pin of the led if you want a indicator that the transmission is working
Use a 15pin header instead of direct soldering the ESP to the board (reusability and the possibiltiy of damaging the ESP)
You will also need to clip the pins on the back of the transmitter because the design is a little to tight

Flash with Arduino

Firstly use the standard libraries and at least version 1.8.9 of Arduino

Edit the config.h to match your environment (read previous forkes for some extra info)

Change:

[SSID] (remove brackets)
[SSID Password] (remove brackets)
IMPORTANT Change any accurance of [DEVICE ID YOU USE] 4 times int he file (remove brackets), use a string without special characters eg "abcd" not "a,b;c:/d"
[MQTT HOST Server] (remove brackets)

See for example this site (have not tested this one): http://henrysbench.capnfatz.com/henrys-bench/arduino-projects-tips-and-more/arduino-esp8266-lolin-nodemcu-getting-started/

Usage MQTT

I prosume you have installed mosquitto (any other mqtt client is ok)

The ESP will subscribe to the configured MQTT topics. Watch what is happening on the serial port to make sure it is working.

mosquitto_sub -h [MQTT Server HOST] -t '#' -v

The following commands will work: Shutter UP

mosquitto_pub -h server-01 -t 'home/nodemcu/somfy/attic_blinds' -m 'u'

Shutter STOP

mosquitto_pub -h server-01 -t 'home/nodemcu/somfy/attic_blinds' -m 's'

Shutter DOWN

mosquitto_pub -h server-01 -t 'home/nodemcu/somfy/attic_blinds' -m 'd'

Programming the blinds:

Press the program button on your actual remote. The blinds will move slightly. Publish 'p' message on the corresponding MQTT topic. The blinds will move slightly. Done !

Somfy PROGRAMING

mosquitto_pub -h server-01 -t 'home/nodemcu/somfy/attic_blinds' -m 'p'

The rolling code value is stored in the EEPROM, so that you don't loose count of your rolling code after a reset. In case you'd like to replace the ESP, write down the current rolling codes which can be read using the serial terminal (and use them as default rolling codes in config.h).

If all goes well you have an working Somfy set

Home Assistant

Under covers in HA, use this config

  - platform: mqtt
    name: "Somfy Shutter"
    availability_topic: "home/nodemcu/somfy/[DEVICE ID YOU USE]/status"
    state_topic: "home/nodemcu/somfy/[DEVICE ID YOU USE]/state"
    command_topic: "home/nodemcu/somfy/[DEVICE ID YOU USE]"
    qos: 1
    payload_open: "u"
    payload_stop: "s"
    payload_close: "d"
    retain: true

The hardware list is as followed (made by Marmotton):

The doc folder contains some photos.

ESP8266 board: AliExpress link
433MHz RF transmitter: AliExpress link
433.42MHz quartz: eBay link
Housing: Youmagine link

Toets / somfy_esp8266_remote_arduino