mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 15:26:59 +00:00
Add SmartThings Light platform (#8365)
* Add SmartThings Light platform docs * Minor tweaks * Specify the classic ST mobile app * Updated ha_version
This commit is contained in:
parent
88a61503dc
commit
253a13e025
27
source/_components/smartthings.light.markdown
Normal file
27
source/_components/smartthings.light.markdown
Normal file
@ -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.
|
||||||
|
|
||||||
|
<p class='note'>
|
||||||
|
Entities for this platform are loaded automatically when you configure the [SmartThings component](/components/smartthings). This platform cannot be manually configured.</p>
|
@ -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'.
|
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'
|
2. Enter the personal access token created above and click 'Submit'
|
||||||
3. When prompted, install the SmartApp:
|
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'.
|
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'
|
3. Optionally change the display name and press 'Done'
|
||||||
4. Authorize the app by pressing 'Allow'
|
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:
|
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.
|
Support for additional capabilities will be added in the future.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user