diff --git a/source/_components/smartthings.light.markdown b/source/_components/smartthings.light.markdown new file mode 100644 index 00000000000..6c9723b2c79 --- /dev/null +++ b/source/_components/smartthings.light.markdown @@ -0,0 +1,27 @@ +--- +layout: page +title: "SmartThings Light" +description: "Instructions on setting up Samsung SmartThings lights within Home Assistant." +date: 2018-01-30 00:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: samsung_smartthings.png +ha_category: Light +ha_release: "0.87" +ha_iot_class: "Cloud Push" +--- + +The SmartThings light platform lets you control Samsung SmartThings connected devices that have light-control related capabilities. + +| Capability |Light Features +|-------------------|------------------------------------------------------------| +| [`switchLevel`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch-Level) | `brightness` and `transition` +| [`colorControl`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Color-Control) | `color` +| [`colorTemperature`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Color-Temperature) | `color_temp` + +For a SmartThings device to be represented by the light platform, it must have one or more of the capabilities above in addition to the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. + +
+Entities for this platform are loaded automatically when you configure the [SmartThings component](/components/smartthings). This platform cannot be manually configured.
\ No newline at end of file diff --git a/source/_components/smartthings.markdown b/source/_components/smartthings.markdown index e82b4c3c7fc..e622cf93361 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -59,7 +59,7 @@ The SmartThings component is configured exclusively through the front-end. Manua 1. From the Home Assistant front-end, navigate to 'Configuration' then 'Integrations'. Under 'Set up a new integration' locate 'SmartThings' and click 'Configure'. 2. Enter the personal access token created above and click 'Submit' 3. When prompted, install the SmartApp: - 1. Open the SmartThings mobile app. Navigate to 'Automation' and select the 'SmartApps' tab. + 1. Open the SmartThings Classic mobile app. Navigate to 'Automation' and select the 'SmartApps' tab. 2. Click 'Add a SmartApp', scroll to the bottom, and select 'My Apps', then choose 'Home Assistant'. 3. Optionally change the display name and press 'Done' 4. Authorize the app by pressing 'Allow' @@ -75,8 +75,9 @@ Advanced: If you have multiple locations in SmartThings, each can be integrated SmartThings represents devices as a set of [capabilities](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html) and the SmartThings component follows the following rules to represent those as entities in Home Assistant: -| Capability |Platform +| Capabilities |Platform |-------------------|------------------------------------------------------------| -| [switch](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) | [switch](/components/smartthings.switch) +| `switchLevel`, `colorControl` and `colorTemperature` | [light](/components/smartthings.light) +| `switch` | [switch](/components/smartthings.switch) Support for additional capabilities will be added in the future.