What is the value for colorControl color state?

Developer Programs Writing Device Types
1

I’m developing my own device handler and I have an RGB light.
So, I get with setColorcommand a {hue:NN.NNN,saturation:NN.NNN} map, but I have to return a string. What has to be in that string, how does it have to be encoded? None of the documentation is specifying that. There’s just always “this is a string”.
And the ST application doesn’t like my output.

2

Hi, where do you have this issue, in a DTH or a command sent directly to the API?

3

I have a cloud connector from st-schema, so it’s almost a direct send

4

I think you are asking what form the color attribute of the colorControl capability takes and I believe it is a hex RGB string, so #RRGGBB.

I’ll defer to others at this point as colour conversions aren’t one of my things, and I believe ST has its own ideas.

5

Ok, when you select a new color in the app, you receive a command request similar to:

{
      "externalDeviceId": "device-id-value",
      "commands": [
        {
          "component": "main",
          "capability": "st.colorControl",
          "command": "setColor",
          "arguments": [
            {
              "saturation": 49,
              "hue": 10.833333333333334
            }
          ]
        }
      ]
    }

The response should include the new states for those attributes, not color, because it receives HEX values. Eg.

"deviceState": [
    {
      "externalDeviceId": "device-id-value",
      "states": [
        {
          "component": "main",
          "capability": "st.colorControl",
          "attribute": "hue",
          "value": 72
        },
        {
          "component": "main",
          "capability": "st.colorControl",
          "attribute": "saturation",
          "value": 10
        }
      ]
    }
]
6

It should be documented. Because the documentation lacks clarity

7

Thanks for the feedback @complynx :slightly_smiling_face:, I’ll share your comments with our engineering team.

8

I have another question related to this capability. Is there any way to define what the Preset colors are that show in the mobile app?

InkedScreenshot 2022-03-09 at 12.53.52 PM_LI
InkedScreenshot 2022-03-09 at 12.53.52 PM_LI1170×636 28.1 KB

9

Hi! Let me check with the engineering team and I’ll get back to you