Connect a Dimmable Switch to Alexa
The following shows an example of how to use the capability interfaces to connect a dimmable switch to Alexa.
Capabilities
The dimmable switch declares the following capabilities.
| Capability | Purpose | Example utterance |
|---|---|---|
|
Allows a customer to turn the device on or off. |
"Turn on the Pool Lights" |
|
|
Allows a customer to control the brightness of the light. |
"Set the Pool Lights to thirty percent" |
|
|
Enables in-depth reporting of the state of the device to the customer through experiences like the Alexa app. |
Not applicable. |
|
|
Contains directives and events related to state and error reporting. Make sure to explicitly include this interface and the supported version in the discovery response. |
Not applicable. |
Discovery
The dimmable switch provides the following AddOrUpdateReport.
{
"event": {
"header": {
"namespace": "Alexa.Discovery",
"name": "AddOrUpdateReport",
"payloadVersion": "3",
"messageId": "00000000-0000-0000-0000-000000000000"
},
"payload": {
"endpoints": [
{
"endpointId": "appliance-001",
"friendlyName": "Pool Lights",
"description": "Smart Switch by Sample Manufacturer",
"manufacturerName": "Sample Manufacturer",
"displayCategories": [
"SWITCH"
],
"cookie": {},
"capabilities": [
{
"type": "AlexaInterface",
"interface": "Alexa.PowerController",
"version": "3",
"properties": {
"supported": [
{
"name": "powerState"
}
],
"proactivelyReported": true,
"retrievable": true
}
},
{
"type": "AlexaInterface",
"interface": "Alexa.BrightnessController",
"version": "3",
"properties": {
"supported": [
{
"name": "brightness"
}
],
"proactivelyReported": true,
"retrievable": true
}
},
{
"type": "AlexaInterface",
"interface": "Alexa.EndpointHealth",
"version": "3",
"properties": {
"supported": [
{
"name": "connectivity"
}
],
"proactivelyReported": true,
"retrievable": true
}
},
{
"type": "AlexaInterface",
"interface": "Alexa",
"version": "3"
}
]
}
]
}
}
}
Related resources
For information about building a smart home skill for switches that control lights, see Build a Smart Home Skill for Lights.
For more details on state reporting, see Understand State Reporting for a Smart Home Skill.
If the device has additional capabilities, you can add other capability interfaces.
