Control Somfy blinds (with RTS Protocol) througt an Arduino Wemos D1.
It is based from the work of Nickduino at Somfy_Remote
Solder a 433.42 MHz crystals to replace the one on a 433.92MHz transmitter. A RTL-SDR comes in handy to check the frequency and make sure the transmitter is working.
Once binaries (Core and UI) uploaded. Connect to the Hotspot SomfyController Fallback Hotspot (defined in includes/config.h). Use the password 5cKErSRCyQzy (also defined in includes/config.h). Then, connect to 192.168.4.1 to setup your WiFi connection.
On the UI, you can create, read, update and delete remotes.
UI is build with HTML/CSS/JS. It use library like tailwind and alpine.js.
TODO
- Support non ASCII chars in names ?
- Add OTA
- Improve HTML part
- Create a HA integration
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
POST /api/v1/system/restart (Resuqests a restart)
None
http code content-type response 200application/json{"message":"Restart requested."}400application/json{"message":"error"}
curl -X POST -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/system/restart
GET /api/v1/system/infos (Gets system informations)
None
http code content-type response 200application/jsonJSON string
curl -X GET -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/system/infos
GET /api/v1/wifi/networks (Gets scanned networks)
None
http code content-type response 200application/jsonJSON string
curl -X GET -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/wifi/networks
GET /api/v1/wifi/config (Gets WiFi configuration)
None
http code content-type response 200application/jsonJSON string
curl -X GET -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/wifi/config
POST /api/v1/wifi/config (Updates WiFi configuration)
name type data type description ssid required string The SSID of the network to connect password optional string The Password of the network to connect
http code content-type response 200application/json{"ssid":"foo","password":"bar"}400application/json{"message":"error"}
curl -X POST -H "application/x-www-form-urlencoded" -d "ssid=foo&password=bar" http://192.168.4.1/api/v1/wifi/config
GET /api/v1/mqtt/config (Gets MQTT configuration)
None
http code content-type response 200application/jsonJSON string
curl -X GET -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/mqtt/config
POST /api/v1/mqtt/config (Updates MQTT configuration)
name type data type description enabled required bool Enable or not MQTT broker required string The MQTT server address port required int The port of MQTT server username optional string Login to connect to the server password optional string Password to connect to the server
http code content-type response 200application/json{"enabled":true, "broker": "", "port": 42, "username": "", "password":""}400application/json{"message":"error"}
curl -X POST -H "application/x-www-form-urlencoded" -d "enabled=true&broker=bar&port=42&username=&password=" http://192.168.4.1/api/v1/mqtt/config
GET /api/v1/remotes (Gets all registered remotes)
None
http code content-type response 200application/jsonJSON string
curl -X GET -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/remotes
POST /api/v1/remotes (Creates a new remote)
name type data type description name required string Name of the remote
http code content-type response 201application/json{"name":"foo", "id": 42, "rolling_code": 42}400application/json{"message":"error"}
curl -X POST -H "application/x-www-form-urlencoded" -d "name=foo" http://192.168.4.1/api/v1/remotes
GET /api/v1/remotes/{remote_id} (Gets a specific remote)
None
http code content-type response 200application/jsonJSON string 400application/json{"message":"error"}
curl -X GET -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/remotes/0
PATCH /api/v1/remotes/{remote_id} (Updates a remote)
name type data type description name optional string Name of the remote rolling_code optional int Rolling code of the remote (Not implemented yet)
http code content-type response 200application/json{"name":"foo", "id": 42, "rolling_code": 42}400application/json{"message":"error"}
curl -X PATCH -H "application/x-www-form-urlencoded" -d "name=foo&rolling_code=0" http://192.168.4.1/api/v1/remotes/0
DELETE /api/v1/remotes/{remote_id} (Deletes a remote)
None
http code content-type response 200application/json{"name":"foo", "id": 42, "rolling_code": 42}400application/json{"message":"error"}
curl -X DELETE -H "application/x-www-form-urlencoded" http://192.168.4.1/api/v1/remotes/0
POST /api/v1/remotes/{remote_id}/action (Send a command with the remote)
name type data type description action required string Action to do. (up, down, stop, pair, reset)
http code content-type response 200application/json{"message": "Command sent."}400application/json{"message":"error"}
curl -X POST -H "application/x-www-form-urlencoded" -d "action=up" http://192.168.4.1/api/v1/remotes/0/action
/esprtsomfy/system/infos/version (Gets Firmware version)/esprtsomfy/system/infos/mac (Gets MAC Address)/esprtsomfy/system/infos/ip (Gets IP Address)/esprtsomfy/remotes/+/rolling_code (Gets the Rolling Code of a specific remote)/esprtsomfy/remotes/+/name (Gets the Name of a specific remote)/esprtsomfy/remotes/+/last_action (Gets the last action of a specific remote)/esprtsomfy/remotes/+/set/name (Updates the Name of a specific remote)/esprtsomfy/remotes/+/set/action (Sends a command (up, stop, down, pair, reset) with the remote)