Unified device categories (and some bugs)

Developer Programs Writing Device Types
2

Hi, there!

First things first, thanks for the feedback!

I’ll split the issues into parts:

First, I’d like to know what kind of devices would you like to integrate (Cloud-connected, Hub-connected, etc.), so please, give more details about that.

Device categories and icons available

The Developer Documentation is being constantly updated and I’ll make sure your comments are taken into consideration, for now, we can take reference from the Schema Connector list.
You can use the OCF configuration directly, here’s a list of the device types along with this value:
Editing DH - Where is the icons - #2 by orangebucket

They should be included on the device metadata:

//For device profiles:
{
    "id": "e4509e32-d91f-4...",
    "name": "capsinDashboardThree",
    "components": [
        {
            "label": "main",
            "id": "main",
            "capabilities": [
                {
                    "id": "switch",
                    "version": 1
                }
            ],
            "categories": []
        }
    ],
    "metadata": {
        "vid": "ST_35928f4a-cf19-4...",
        "deviceType": "Blind",
        "mnmn": "xxx",
        "ocfDeviceType": "oic.d.blind",
        "deviceTypeId": "Blind",
        ...
    },
    "status": "DEVELOPMENT",
    "preferences": []
}
Specific icons inconsistencies
  • I see that for the cooktop and car icons, it appears the “other” icon instead of the correct one, so I’ll document this issue for our engineering team.
  • I’ll also report the air purifier icon as it behaves as you said.
  • Some icon names in the ST app catalog (Add device section) are called differently in the docs list, eg. “energy monitoring” > “energy-meter”
  • Icons change based on the capability’s presentation used in the Dashboard view. It must have active/inactive alternatives configured, eg.:
{
    "dashboard": {
        "states": [
            {
                "label": "{{switch.value}}",
                "alternatives": [
                    {
                        "key": "on",
                        "value": "{{i18n.attributes.switch.i18n.value.on.label}}",
                        "type": "active"
                    },
                    {
                        "key": "off",
                        "value": "{{i18n.attributes.switch.i18n.value.off.label}}",
                        "type": "inactive"
                    }
                ]
            }
        ]
    }
    ...
}
Capabilities

You can get a list of all the standard capabilities from the API.
Once you have the capability ID, you can query its definition and presentation, eg.

//definition
https://api.smartthings.com/v1/capabilities/colorControl/1

//presentation
https://api.smartthings.com/v1/capabilities/colorControl/1/presentation

There, you’ll see their status and know if you can use them.

Other issues

For issues with the ST app (non-development related), you should contact Customer Support.

What do you mean by device definition? Please, if possible, provide screen captures or in case you’re only working with device profiles share the IDs.

Note: If you are constantly changing the same device’s presentation, icon, etc., you might experience configuration caching. To force the refresh, you need to delete the ST app cache, to do so, go to your mobile device settings > apps > list apps > find the ST app > Storage > clear cache.