Soma Connect App
I have added a new Soma app which is now live at
This app connects to the the Soma hub which is different from the Soma app produced by Gerard Ricart which connects directly to the blinds via Bluetooth. The advantage is that Homey does not have to be withing Bluetooth range of the blinds, but the disadvantage is that you will need the hub or a Raspberry Pi running the Soma image. Gerard’s app also provides an MQTT interface but I didn’t think it necessary on mine as it is already talking to the hub over the WiFi.
Currently my app only supports one hub but I plan to enhance that in the future if there is demand for it.
I have only tested the app with the Soma Tilt devices as that is all I have but I see no reason why it won’t work with the Soma Shades as well as it is using the official Soma API.
I wrote the app to solve my requirements but thought it would be good to share it. If there are any feature requests then feel free to ask and I will do my best to accommodate them.
Using the app
To use the app you will need to enter the IP address of your Soma Connect hub into the app configuration page before adding devices. You can then go through the normal add devices procedure to select the blinds you want to control.
Each blind can be configured to the required open and close percentage that will be selected when the blind is switched on and off. This is in the advanced section of the device configuration. For the tilt modules that would be 50 for open and 0 or 100 for closed depending on which way you want then to tilt. For shades it would probably be 0 for open and 100 for closed.
Note (updated 19th Dec 2019)
The Connect box from Soma requires the latest version to work as they have only recently added the API interface. If you see the “ECONNREFUSED” error message in the log panel then it probably means the Connect firmware needs to be updated. Check the following link to get the latest Connect firmware: https://somasmarthome.zendesk.com/hc/en-us/articles/360035521234-Install-SOMA-Connect-software-on-SOMA-Connect-Raspberry-Pi
Note (updated 30th Oct 2020)
The Soma Connect Hub version 2.2.0 changes the Tilt position value. It used to be 0 to 100 but is now -100 to +100. Therefore, if you update the hub firmware make sure you install version 1.1.1 or later of this app.
There is also a new device setting to specify if it is a Shade or a Tilt so the app knows if it should apply the fix.
I have discussed the issue with Soma and they have said they will add more information to the data that is available via the API so the type can be automatically detected. However, they have not specified when that will be available.
- Fixed a memory leak.
- Spaces are now trimmed from the entered IP address.
- Converted to SDK 3 for Homey v5 and later.
- Fix issue with pairing.
- Add timeout to http requests
- Support for Soma Connect firmware 2.2.6