From fe5fa04c07b55c0f5a8e76690ba6cd961b53b254 Mon Sep 17 00:00:00 2001 From: andrewsayre <6730289+andrewsayre@users.noreply.github.com> Date: Sat, 2 Feb 2019 16:22:53 -0600 Subject: [PATCH 1/6] Conslidated SmartThings platforms docs --- source/_components/smartthings.light.markdown | 27 -------- source/_components/smartthings.markdown | 66 +++++++++++++++---- 2 files changed, 54 insertions(+), 39 deletions(-) delete mode 100644 source/_components/smartthings.light.markdown diff --git a/source/_components/smartthings.light.markdown b/source/_components/smartthings.light.markdown deleted file mode 100644 index 6c9723b2c79b..000000000000 --- a/source/_components/smartthings.light.markdown +++ /dev/null @@ -1,27 +0,0 @@ ---- -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 e622cf933612..f97f140f7248 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -12,11 +12,16 @@ logo: samsung_smartthings.png ha_category: - Hub - Switch + - Light + - Binary Sensor + - Fan ha_release: "0.87" ha_iot_class: "Cloud Push" redirect_from: - /components/smartthings.switch/ - - /components/switch.smartthings/ + - /components/smartthings.light/ + - /components/smartthings.binary_sensor/ + - /components/smartthings.fan/ --- Samsung SmartThings is integrated into Home Assistant through the SmartThings Cloud API. The SmartThings component is the main component to integrate all SmartThings related platforms. The basic features of this integration include: @@ -26,10 +31,6 @@ Samsung SmartThings is integrated into Home Assistant through the SmartThings Cl 3. Support for multiple SmartThings accounts and locations, each represented as a unique integration in the front-end configuration. 4. No brokers, bridges, or additional dependencies. -There is currently support for the following device types within Home Assistant: - -- Switch ([SmartThings switch platform](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch)) - ## {% linkable_title Basic requirements %} 1. A [personal access token](https://account.smartthings.com/tokens) tied to a Samsung or SmartThings account (see below for instructions). @@ -69,15 +70,56 @@ The SmartThings component is configured exclusively through the front-end. Manua Advanced: If you have multiple locations in SmartThings, each can be integrated into Home Assistant. Follow the steps above, then for each subsequent location, install the SmartApp and it will automatically add to Home Assistant. This can be completed during step 3 (install SmartApp) above or at any time after that.

-## {% linkable_title Additional information %} - -### Supported capabilities/device mapping +## {% linkable_title Platforms %} 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: -| Capabilities |Platform -|-------------------|------------------------------------------------------------| -| `switchLevel`, `colorControl` and `colorTemperature` | [light](/components/smartthings.light) -| `switch` | [switch](/components/smartthings.switch) +| Platform |Capabilities +|--------------------------------------------------------|--------------------------------------------------------------------------------------------| +[binary_sensor](#binary-sensor) | `accelerationSensor`, `contactSensor`, `filterStatus`, `motionSensor`, `presenceSensor`, `tamperAlert`, `valve` and `waterSensor` +[fan](#fan) | `fanSpeed` and `switch` +[light](#light) | `colorControl`, `colorTemperature`, `switch` and `switchLevel` +[switch](#switch) | `switch` Support for additional capabilities will be added in the future. + +### {% linkable_title Binary Sensor %} + +The SmartThings Binary Sensor platform lets you view Samsung SmartThings connected devices that have sensor-reading capabilities. A Binary Sensor entity will be created for each attribute (below) supported by the SmartThings device. + +| Capability |Attribute |On-Value |binary_sensor Device Class +|-------------------|--------------|----------------|---------------------------------| +| [`accelerationSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Acceleration-Sensor) | `acceleration` | `active` | `moving` +| [`contactSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Contact-Sensor) | `contact` | `open` | `opening` +| [`filterStatus`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Filter-Status) | `filterStatus` | `replace` | `problem` +| [`motionSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Motion-Sensor) | `motion` | `active` | `motion` +| [`presenceSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Presence-Sensor) | `presence` | `present` | `presence` +| [`tamperAlert`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Tamper-Alert) | `tamper` | `detected` | `problem` +| [`valve`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Valve) | `valve` | `open` | `opening` +| [`waterSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Water-Sensor) | `water` | `wet` | `moisture` + +### {% linkable_title Fan %} + +The SmartThings fan platform lets you control Samsung SmartThings connected devices that have fan-control related capabilities. + +| Capability |Fan Features +|-------------------|------------------------------------------------------------| +| [`fanSpeed`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Fan-Speed) | `speed` + +For a SmartThings device to be represented by the fan 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. + +### {% linkable_title Light %} + +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. + +### {% linkable_title Switch %} + +The SmartThings switch platform lets you control Samsung SmartThings connected devices that have the [switch capability](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch). \ No newline at end of file From 7ee272372ca8a77a344304a8272f268fd2bf2776 Mon Sep 17 00:00:00 2001 From: andrewsayre <6730289+andrewsayre@users.noreply.github.com> Date: Sat, 2 Feb 2019 16:35:09 -0600 Subject: [PATCH 2/6] Tweaks --- source/_components/smartthings.markdown | 28 ++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/source/_components/smartthings.markdown b/source/_components/smartthings.markdown index f97f140f7248..217a8e0f97a4 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -10,18 +10,22 @@ footer: true featured: true logo: samsung_smartthings.png ha_category: - - Hub - - Switch - - Light - Binary Sensor - Fan + - Hub + - Light + - Switch ha_release: "0.87" ha_iot_class: "Cloud Push" redirect_from: - - /components/smartthings.switch/ - - /components/smartthings.light/ - /components/smartthings.binary_sensor/ + - /components/binary_sensor.smartthings/ - /components/smartthings.fan/ + - /components/fan.smartthings/ + - /components/smartthings.light/ + - /components/light.smartthings/ + - /components/smartthings.switch/ + - /components/switch.smartthings/ --- Samsung SmartThings is integrated into Home Assistant through the SmartThings Cloud API. The SmartThings component is the main component to integrate all SmartThings related platforms. The basic features of this integration include: @@ -74,8 +78,8 @@ 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: -| Platform |Capabilities -|--------------------------------------------------------|--------------------------------------------------------------------------------------------| +| Platform |Capabilities +|---------------------------------|--------------------------------------------------------------------------------------------| [binary_sensor](#binary-sensor) | `accelerationSensor`, `contactSensor`, `filterStatus`, `motionSensor`, `presenceSensor`, `tamperAlert`, `valve` and `waterSensor` [fan](#fan) | `fanSpeed` and `switch` [light](#light) | `colorControl`, `colorTemperature`, `switch` and `switchLevel` @@ -100,17 +104,15 @@ The SmartThings Binary Sensor platform lets you view Samsung SmartThings connect ### {% linkable_title Fan %} -The SmartThings fan platform lets you control Samsung SmartThings connected devices that have fan-control related capabilities. +The SmartThings fan platform lets you control Samsung SmartThings connected devices that have fan-control related capabilities. For a SmartThings device to be represented by the fan 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. | Capability |Fan Features |-------------------|------------------------------------------------------------| | [`fanSpeed`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Fan-Speed) | `speed` -For a SmartThings device to be represented by the fan 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. - ### {% linkable_title Light %} -The SmartThings light platform lets you control Samsung SmartThings connected devices that have light-control related capabilities. +The SmartThings light platform lets you control Samsung SmartThings connected devices that have light-control related capabilities. 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. | Capability |Light Features |-------------------|------------------------------------------------------------| @@ -118,8 +120,6 @@ The SmartThings light platform lets you control Samsung SmartThings connected de | [`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. - ### {% linkable_title Switch %} -The SmartThings switch platform lets you control Samsung SmartThings connected devices that have the [switch capability](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch). \ No newline at end of file +The SmartThings switch platform lets you control Samsung SmartThings connected devices that have the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. \ No newline at end of file From 403859f6eb08c8e21642c8fac4838174509c9985 Mon Sep 17 00:00:00 2001 From: andrewsayre <6730289+andrewsayre@users.noreply.github.com> Date: Sat, 2 Feb 2019 23:29:31 -0600 Subject: [PATCH 3/6] Added button event docs --- source/_components/smartthings.markdown | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/source/_components/smartthings.markdown b/source/_components/smartthings.markdown index 217a8e0f97a4..f08b19bc9fa2 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -74,6 +74,31 @@ The SmartThings component is configured exclusively through the front-end. Manua Advanced: If you have multiple locations in SmartThings, each can be integrated into Home Assistant. Follow the steps above, then for each subsequent location, install the SmartApp and it will automatically add to Home Assistant. This can be completed during step 3 (install SmartApp) above or at any time after that.

+## {% linkable_title Events %} + +The SmartThings triggeres events for select device capabilities. + +### {% linkable_title smartthings.button %} + +The SmartThings component will trigger an event when a device with the [button](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Button) capability is pressed and can be used to trigger automations within Home Assistant. Below is an example of the data payload: + +```json +{ + "component_id": "main", + "device_id": "42a16cf2-fef7-4ee8-b4a6-d32cb65474b7", + "location_id": "2a54b9fa-f66c-42d9-8488-d8f036b980c8", + "value": "pushed", + "name": "Scene Button" +} +``` +| Attribute | Description +|---------------------------|-------------------------| +`component_id` | Describes which component of the device triggered the event. `main` represents the core device. For devices with child-devices, this attribute identifies the child that raised the event. +`device_id` | The unique id of the device in SmartThings. This can be located in the HASS device registry or in the [SmartThings Groovy IDE](https://developers.smartthings.com/). +`location_id` | The unique id of the location the device is part of. This can be found in the config entry registry or in the [SmartThings Groovy IDE](https://developers.smartthings.com/). +`value` | Describes the action taken on the button. See the [button](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Button) capability reference for a list of possible values (not all are supported by every device). +`name` | The name given to the device in SmartThings. + ## {% linkable_title Platforms %} 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: From 2d18926c0ea383eed43cc1d6819f89f9e0b17798 Mon Sep 17 00:00:00 2001 From: andrewsayre <6730289+andrewsayre@users.noreply.github.com> Date: Sun, 3 Feb 2019 08:29:00 -0600 Subject: [PATCH 4/6] Fixed event table --- source/_components/smartthings.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_components/smartthings.markdown b/source/_components/smartthings.markdown index f08b19bc9fa2..c5d43145e0bd 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -91,8 +91,9 @@ The SmartThings component will trigger an event when a device with the [button]( "name": "Scene Button" } ``` + | Attribute | Description -|---------------------------|-------------------------| +|---------------------------|------------------------------------------------------------------| `component_id` | Describes which component of the device triggered the event. `main` represents the core device. For devices with child-devices, this attribute identifies the child that raised the event. `device_id` | The unique id of the device in SmartThings. This can be located in the HASS device registry or in the [SmartThings Groovy IDE](https://developers.smartthings.com/). `location_id` | The unique id of the location the device is part of. This can be found in the config entry registry or in the [SmartThings Groovy IDE](https://developers.smartthings.com/). From 82440ace56db93befab7959413621f87d6762e72 Mon Sep 17 00:00:00 2001 From: andrewsayre <6730289+andrewsayre@users.noreply.github.com> Date: Sun, 3 Feb 2019 08:57:13 -0600 Subject: [PATCH 5/6] Clarifications --- source/_components/smartthings.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/smartthings.markdown b/source/_components/smartthings.markdown index c5d43145e0bd..f4ee76c91b4c 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -134,11 +134,11 @@ The SmartThings fan platform lets you control Samsung SmartThings connected devi | Capability |Fan Features |-------------------|------------------------------------------------------------| -| [`fanSpeed`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Fan-Speed) | `speed` +| [`fanSpeed`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Fan-Speed) | `speed` (off, low, medium, and high) ### {% linkable_title Light %} -The SmartThings light platform lets you control Samsung SmartThings connected devices that have light-control related capabilities. 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. +The SmartThings light platform lets you control Samsung SmartThings connected devices that have light-control related capabilities. For a SmartThings device to be represented by the light platform, it must have one or more of the capabilities below in addition to the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. | Capability |Light Features |-------------------|------------------------------------------------------------| @@ -148,4 +148,4 @@ The SmartThings light platform lets you control Samsung SmartThings connected de ### {% linkable_title Switch %} -The SmartThings switch platform lets you control Samsung SmartThings connected devices that have the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. \ No newline at end of file +The SmartThings switch platform lets you control Samsung SmartThings connected devices that have the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability that are not already represented by a more specific platform. \ No newline at end of file From 913e0d6738f6ee172df791663eea9101df935c81 Mon Sep 17 00:00:00 2001 From: andrewsayre <6730289+andrewsayre@users.noreply.github.com> Date: Sun, 3 Feb 2019 09:25:29 -0600 Subject: [PATCH 6/6] Clean-up --- source/_components/smartthings.markdown | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/_components/smartthings.markdown b/source/_components/smartthings.markdown index f4ee76c91b4c..c3301c683312 100644 --- a/source/_components/smartthings.markdown +++ b/source/_components/smartthings.markdown @@ -76,11 +76,11 @@ Advanced: If you have multiple locations in SmartThings, each can be integrated ## {% linkable_title Events %} -The SmartThings triggeres events for select device capabilities. +The SmartThings component triggers events for select device capabilities. ### {% linkable_title smartthings.button %} -The SmartThings component will trigger an event when a device with the [button](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Button) capability is pressed and can be used to trigger automations within Home Assistant. Below is an example of the data payload: +The component will trigger an event when a device with the [button](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Button) capability is actuated and can be used to trigger automations within Home Assistant. Below is an example of the data payload: ```json { @@ -94,7 +94,7 @@ The SmartThings component will trigger an event when a device with the [button]( | Attribute | Description |---------------------------|------------------------------------------------------------------| -`component_id` | Describes which component of the device triggered the event. `main` represents the core device. For devices with child-devices, this attribute identifies the child that raised the event. +`component_id` | Describes which component of the device triggered the event. `main` represents the parent device. For devices with child-devices, this attribute identifies the child that raised the event. `device_id` | The unique id of the device in SmartThings. This can be located in the HASS device registry or in the [SmartThings Groovy IDE](https://developers.smartthings.com/). `location_id` | The unique id of the location the device is part of. This can be found in the config entry registry or in the [SmartThings Groovy IDE](https://developers.smartthings.com/). `value` | Describes the action taken on the button. See the [button](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Button) capability reference for a list of possible values (not all are supported by every device). @@ -102,7 +102,7 @@ The SmartThings component will trigger an event when a device with the [button]( ## {% linkable_title Platforms %} -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 mapps those to entity platforms in Home Assistant. A single device may be represented by one or more platforms. | Platform |Capabilities |---------------------------------|--------------------------------------------------------------------------------------------| @@ -115,9 +115,9 @@ Support for additional capabilities will be added in the future. ### {% linkable_title Binary Sensor %} -The SmartThings Binary Sensor platform lets you view Samsung SmartThings connected devices that have sensor-reading capabilities. A Binary Sensor entity will be created for each attribute (below) supported by the SmartThings device. +The SmartThings Binary Sensor platform lets you view devices that have binary sensor-related capabilities. A Binary Sensor entity will be created for each attribute (below) supported by the device. -| Capability |Attribute |On-Value |binary_sensor Device Class +| Capability |Attribute |On-Value |Binary Sensor Device Class |-------------------|--------------|----------------|---------------------------------| | [`accelerationSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Acceleration-Sensor) | `acceleration` | `active` | `moving` | [`contactSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Contact-Sensor) | `contact` | `open` | `opening` @@ -130,15 +130,15 @@ The SmartThings Binary Sensor platform lets you view Samsung SmartThings connect ### {% linkable_title Fan %} -The SmartThings fan platform lets you control Samsung SmartThings connected devices that have fan-control related capabilities. For a SmartThings device to be represented by the fan 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. +The SmartThings fan platform lets you control devices that have fan-related capabilities. For a SmartThings device to be represented by the fan platform, it must have one or more of the capabilities below in addition to the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. | Capability |Fan Features |-------------------|------------------------------------------------------------| -| [`fanSpeed`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Fan-Speed) | `speed` (off, low, medium, and high) +| [`fanSpeed`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Fan-Speed) | `speed` (`off`, `low`, `medium`, and `high`) ### {% linkable_title Light %} -The SmartThings light platform lets you control Samsung SmartThings connected devices that have light-control related capabilities. For a SmartThings device to be represented by the light platform, it must have one or more of the capabilities below in addition to the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. +The SmartThings light platform lets you control devices that have light-related capabilities. For a SmartThings device to be represented by the light platform, it must have one or more of the capabilities below in addition to the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability. | Capability |Light Features |-------------------|------------------------------------------------------------| @@ -148,4 +148,4 @@ The SmartThings light platform lets you control Samsung SmartThings connected de ### {% linkable_title Switch %} -The SmartThings switch platform lets you control Samsung SmartThings connected devices that have the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability that are not already represented by a more specific platform. \ No newline at end of file +The SmartThings switch platform lets you control devices that have the [`switch`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch) capability that are not already represented by a more specific platform. \ No newline at end of file