jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 23:06:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add SmartThings Light platform (#8365)

Browse Source 
* Add SmartThings Light platform docs

* Minor tweaks

* Specify the classic ST mobile app

* Updated ha_version
This commit is contained in:
Andrew Sayre 2019-02-02 09:48:00 -06:00 committed by Paulus Schoutsen
parent 88a61503dc
commit 253a13e025
2 changed files with 31 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
source/_components/smartthings.light.markdown Normal file
View 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>

7
source/_components/smartthings.markdown
View File

@ -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.