From a0d2949e4b643f4561b42253f812cb072ac276e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tiit=20R=C3=A4tsep?= Date: Tue, 1 Oct 2019 12:24:42 +0300 Subject: [PATCH] Added documentation page for Soma (#10460) * Added documentation page for Soma * Update source/_components/soma.markdown Co-Authored-By: Klaas Schoute * Update source/_components/soma.markdown Co-Authored-By: Klaas Schoute * Added paragraphs --- source/_components/soma.markdown | 40 ++++++++++++++++++++++++ source/images/supported_brands/soma.png | Bin 0 -> 6255 bytes 2 files changed, 40 insertions(+) create mode 100644 source/_components/soma.markdown create mode 100644 source/images/supported_brands/soma.png diff --git a/source/_components/soma.markdown b/source/_components/soma.markdown new file mode 100644 index 00000000000..390e45540c0 --- /dev/null +++ b/source/_components/soma.markdown @@ -0,0 +1,40 @@ +--- +title: "Soma" +description: "Instructions on how to set up the Soma Connect within Home Assistant." +logo: soma.png +ha_category: + - Cover +ha_iot_class: Local Polling +ha_config_flow: true +ha_release: "0.100" +--- + +The Soma integration will allow users to integrate their Soma Smarthome devices into Home Assistant using the Soma Connect hub. + +You can build a Soma Connect yourself if you have a spare Raspberry Pi. You just need to follow the [ official instructions](https://somasmarthome.zendesk.com/hc/en-us/articles/360035521234-Install-SOMA-Connect-software-on-SOMA-Connect-Raspberry-Pi). After you have the SD card plug in the Pi and use an ethernet cable or [set up WiFI](https://somasmarthome.zendesk.com/hc/en-us/articles/360026210333-Configuring-Wi-Fi-access). Then find the IP address by checking your routers DHCP table (we will work on this step). + +The Connect will automatically find all your Smartshade devices in range and expose them through this integration and through Home Kit. This integration will only enumerate new shades when it is first set up. If you add shades after that you just need to restart Home Assistant or reconfigure this integration. Soma Connect will automatically discover new shades as they appear and expose them. + +To actually move the shades you have to first set them up according to the instructions that come with them. + +## Configuration + +```yaml +# Example configuration.yaml entry +soma: + host: CONNECT_IP_ADDR + port: CONNECT_PORT +``` + +{% configuration %} +host: + description: Your Soma Connect IP address. + required: true + type: string +port: + description: Your Soma Connect port. + required: true + default: 3000 + type: string +{% endconfiguration %} + diff --git a/source/images/supported_brands/soma.png b/source/images/supported_brands/soma.png new file mode 100644 index 0000000000000000000000000000000000000000..9ad8a13d5d6253d8282e6770e3ffc930fc91e294 GIT binary patch literal 6255 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 Dj5xY? literal 0 HcmV?d00001