mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Add SmartThings cover platform and update cover device classes (#8625)
* Add SmartThings Cover docs
* Update cover component device classes
* Add additional cover types
* Sync device class descriptions
* ✏️ Tweaks
This commit is contained in:
Andrew Sayre
Franck Nijhof
parent
194a35f97e
commit
5cb1609b9d
@ -23,9 +23,15 @@ The display style of each entity can be modified in the [customize section](/get
|
||||
The way these sensors are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for covers:
|
||||
|
||||
- **None**: Generic cover. This is the default and doesn't need to be set.
|
||||
- **damper**: Ventilation damper controller.
|
||||
- **garage**: Garage door controller.
|
||||
- **window**: Window controller.
|
||||
- **awning**: Control of an awning, such as an exterior retractable window, door, or patio cover.
|
||||
- **blind**: Control of blinds, which are linked slats that expand or collapse to cover an opening or may be tilted to partially covering an opening, such as window blinds.
|
||||
- **curtain**: Control of curtains or drapes, which is often fabric hung above a window or door that can be drawn open.
|
||||
- **damper**: Control of a mechanical damper that reduces airflow, sound, or light.
|
||||
- **door**: Control of a door or gate that provides access to an area.
|
||||
- **garage**: Control of a garage door that provides access to a garage.
|
||||
- **shade**: Control of shades, which are a continuous plane of material or connected cells that expanded or collapsed over an opening, such as window shades.
|
||||
- **shutter**: Control of shutters, which are linked slats that swing out/in to covering an opening or may be tilted to partially cover an opening, such as indoor or exterior window shutters.
|
||||
- **window**: Control of a physical window that opens and closes or may tilt.
|
||||
|
||||
## {% linkable_title Services %}
|
||||
|
||||
|
||||
@ -13,6 +13,7 @@ ha_category:
|
||||
- Hub
|
||||
- Binary Sensor
|
||||
- Climate
|
||||
- Cover
|
||||
- Fan
|
||||
- Light
|
||||
- Lock
|
||||
@ -25,6 +26,8 @@ redirect_from:
|
||||
- /components/binary_sensor.smartthings/
|
||||
- /components/smartthings.climate/
|
||||
- /components/climate.smartthings/
|
||||
- /components/smartthings.cover/
|
||||
- /components/cover.smartthings/
|
||||
- /components/smartthings.fan/
|
||||
- /components/fan.smartthings/
|
||||
- /components/smartthings.light/
|
||||
@ -125,6 +128,7 @@ Event data payloads are logged at the debug level, see [debugging](#debugging) f
|
||||
SmartThings represents devices as a set of [capabilities](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html) and the SmartThings component maps those to entity platforms in Home Assistant. A single device may be represented by one or more platforms.
|
||||
- [Binary Sensor](#binary-sensor)
|
||||
- [Climate](#climate)
|
||||
- [Cover](#cover)
|
||||
- [Fan](#fan)
|
||||
- [Light](#light)
|
||||
- [Lock](#lock)
|
||||
@ -163,6 +167,18 @@ The SmartThings Climate platform lets you control devices that have thermostat-r
|
||||
| [`thermostatFanMode`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Thermostat-Fan-Mode) | `fan mode`
|
||||
| [`relativeHumidityMeasurement`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Relative-Humidity-Measurement) | `humidity` (state attribute)
|
||||
|
||||
### {% linkable_title Cover %}
|
||||
|
||||
The SmartThings Cover platform lets you control devices that have open/close related capabilities. For a device to be represented by the cover platform, it must have one of the capabilities from "set a" below.
|
||||
|
||||
| Capability |Cover Features
|
||||
|-------------------------------------|--------------------------------------------|
|
||||
| [`doorControl`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Door-Control) (set a) | `open` and `close`
|
||||
| [`garageDoorControl`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Garage-Door-Control) (seb a) | `open` and `close`
|
||||
| [`windowShade`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Window-Shade) (set a) | `open` and `close`
|
||||
| [`switchLevel`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Switch-Level) | `position`
|
||||
| [`battery`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Battery) | `battery_level` (state attribute)
|
||||
|
||||
### {% linkable_title Fan %}
|
||||
|
||||
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.
|
||||
@ -203,14 +219,12 @@ The SmartThings Sensor platform lets your view devices that have sensor-related
|
||||
| [`carbonMonoxideDetector`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Carbon-Monoxide-Detector) | `carbonMonoxide`
|
||||
| [`carbonMonoxideMeasurement`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Carbon-Monoxide-Measurement) | `carbonMonoxideLevel`
|
||||
| [`dishwasherOperatingState`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Dishwasher-Operating-State) | `machineState`, `dishwasherJobState` and `completionTime`
|
||||
| [`doorControl`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Door-Control) | `door`
|
||||
| [`dryerMode`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Dryer-Mode) | `dryerMode`
|
||||
| [`dryerOperatingState`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Dryer-Operating-State) | `machineState`, `dryerJobState` and `completionTime`
|
||||
| [`dustSensor`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Dust-Sensor) | `fineDustLevel` and `dustLevel`
|
||||
| [`energyMeter`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Energy-Meter) | `energy`
|
||||
| [`equivalentCarbonDioxideMeasurement`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Equivalent-Carbon-Dioxide-Measurement) | `equivalentCarbonDioxideMeasurement`
|
||||
| [`formaldehydeMeasurement`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Formaldehyde-Measurement) | `formaldehydeLevel`
|
||||
| [`garageDoorControl`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Garage-Door-Control) | `door`
|
||||
| [`illuminanceMeasurement`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Illuminance-Measurement) | `illuminance`
|
||||
| [`infraredLevel`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Infrared-Level) | `infraredLevel`
|
||||
| [`lock`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Lock) | `lock`
|
||||
@ -244,7 +258,6 @@ The SmartThings Sensor platform lets your view devices that have sensor-related
|
||||
| [`voltageMeasurement`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Voltage-Measurement) | `voltage`
|
||||
| [`washerMode`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Washer-Mode) | `washerMode`
|
||||
| [`washerOperatingState`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Washer-Operating-State) | `machineState`, `washerJobState` and `completionTime`
|
||||
| [`windowShade`](https://smartthings.developer.samsung.com/develop/api-ref/capabilities.html#Window-Shade) | `windowShade`
|
||||
|
||||
### {% linkable_title Switch %}
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user