Skip to content

Add SmartThings Light platform #8365

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
arsaboo merged 4 commits into from
Feb 2, 2019
Merged

Add SmartThings Light platform #8365

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9d22615
Add SmartThings Light platform docs
andrewsayre Jan 31, 2019
44098b6
Minor tweaks
andrewsayre Jan 31, 2019
d122721
Specify the classic ST mobile app
andrewsayre Feb 1, 2019
16a7421
Updated ha_version
andrewsayre Feb 2, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions source/_components/smartthings.light.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 changes: 4 additions & 3 deletions source/_components/smartthings.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,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'
Expand All @@ -66,8 +66,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.