A Device Presentation is used by the SmartThings Platform to determine how the Capability Presentations of a Device are grouped and displayed in the SmartThings app. Using the SmartThings API, you can generate a custom Device Presentation based on your Device Configuration using the createDeviceConfiguration API call.
When you create a Device Presentation using the createDeviceConfiguration API
POST call, the SmartThings API will return the
mnmn of your newly created Device Presentation - you will use these properties to associate your Device Presentation with your Device Profile.
For Edge Drivers, Device Presentations are automatcally generated based on the Device Profile. Custom Device Presentations can still be used, but are not required for Edge Drivers.
What's the difference between a Device Presentation and a Capability Presentation?
A Device Presentation determines which Capabilities are displayed and how they are arranged when presented; a Capability Presentation determines how the Capability's attributes and commands are displayed within the Device Presentation.
#Using a Device Presentation
To use your Device Presentation, add your Device Presentations's
mnmn to your Device Profile's metadata.
You can update your Device Profile using the SmartThings API. After adding the appropriate metadata to your Device Profile, the SmartThings Platform will begin using the Device Presentation associated with the Device Profile. Below is an example Device Profile using a Device Presentation's
Using Device Presentations with SmartThings Edge Drivers
To associate a SmartThings Edge Driver with a Device Presentation, edit your Driver Profile to include your Device Presentations's
vid - no
mnmn is required.
#Verifying Your Presentation Is In Use
To ensure the correct Device Presentation is in use with your device, use the List Devices API call. Analyze the API response, making sure your device's
manufacturerName match the
mnmn respectively of your Device Presentation.