A Device Profile defines a Device and its features on the SmartThings Platform. It contains the Components (which contain Device Capabilities) and metadata (ID, name, ownership, and more) of a Device, defining how a Device on the SmartThings Platform behaves. Before joining your Device to the SmartThings Platform, you'll need to create a Device Profile.
Devices using SmartThings Schema or SmartThings Edge use "implicit profiles" and do not require you to create a Device Profile for these Devices.
Components are used to include and group Capabilities in a Device Profile. A Device Profile must have at least one Component. This Component is named
main by convention for all profiles with a single Component. Each Component must include at least one Capability:
Using multiple components is suggested when the Device is separated into different endpoints that use the same Capability. A Capability cannot be added more than once in a single component (e.g. a 3-gang Switch).
Each component appears separate and is labeled in the Device's Detail View so you can identify its status.
categories is an optional parameter that helps define the kind of device that is being interacted with. SmartThings has an expanding list of device categories that work with our Platform.
Below is a list of currently supported categories. The Platform provides a default icon based on the category specified for the device.
#Create a Device Profile
You can create a new Device Profile from the Developer Workspace Develop menu. Here, you can specify Device metadata including Device Profile name, Device Type, and Vendor ID. You can also add Capabilities to your
main Component from the Workspace.
Alternatively, you can use the SmartThings CLI to create, retrieve, update, and delete Device Profiles. The Device Profiles API can also be used to interact with and maintain Device Profiles.