Discussions

Ask a Question
Back to All

segmentedColorRgb and segmentedBrightness H6069

I am a developer and recently purchased H6069 for integration capabilities. The device reports having segmentedBrightness and segmentedColorRgb but they do not seem to work.

GET /router/api/v1/user/devices HTTP/1.1
Host: https://openapi.api.govee.com
Content-Type: application/json  
Govee-API-Key: <key>

Response:

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "sku": "H6069",
            "device": "<device>",
            "deviceName": "Mini Panel Lights",
            "type": "devices.types.light",
            "capabilities": [
                {
                    "type": "devices.capabilities.on_off",
                    "instance": "powerSwitch",
                    "parameters": {
                        "dataType": "ENUM",
                        "options": [
                            {
                                "name": "on",
                                "value": 1
                            },
                            {
                                "name": "off",
                                "value": 0
                            }
                        ]
                    }
                },
                {
                    "type": "devices.capabilities.toggle",
                    "instance": "dreamViewToggle",
                    "parameters": {
                        "dataType": "ENUM",
                        "options": [
                            {
                                "name": "on",
                                "value": 1
                            },
                            {
                                "name": "off",
                                "value": 0
                            }
                        ]
                    }
                },
                {
                    "type": "devices.capabilities.toggle",
                    "instance": "gradientToggle",
                    "parameters": {
                        "dataType": "ENUM",
                        "options": [
                            {
                                "name": "on",
                                "value": 1
                            },
                            {
                                "name": "off",
                                "value": 0
                            }
                        ]
                    }
                },
                {
                    "type": "devices.capabilities.range",
                    "instance": "brightness",
                    "parameters": {
                        "unit": "unit.percent",
                        "dataType": "INTEGER",
                        "range": {
                            "min": 1,
                            "max": 100,
                            "precision": 1
                        }
                    }
                },
                {
                    "type": "devices.capabilities.segment_color_setting",
                    "instance": "segmentedBrightness",
                    "parameters": {
                        "dataType": "STRUCT",
                        "fields": [
                            {
                                "fieldName": "segment",
                                "size": {
                                    "min": 1,
                                    "max": 20
                                },
                                "dataType": "Array",
                                "elementRange": {
                                    "min": 0,
                                    "max": 14
                                },
                                "elementType": "INTEGER",
                                "required": true
                            },
                            {
                                "fieldName": "brightness",
                                "dataType": "INTEGER",
                                "range": {
                                    "min": 0,
                                    "max": 100,
                                    "precision": 1
                                },
                                "required": true
                            }
                        ]
                    }
                },
                {
                    "type": "devices.capabilities.segment_color_setting",
                    "instance": "segmentedColorRgb",
                    "parameters": {
                        "dataType": "STRUCT",
                        "fields": [
                            {
                                "fieldName": "segment",
                                "size": {
                                    "min": 1,
                                    "max": 20
                                },
                                "dataType": "Array",
                                "elementRange": {
                                    "min": 0,
                                    "max": 14
                                },
                                "elementType": "INTEGER",
                                "required": true
                            },
                            {
                                "fieldName": "rgb",
                                "dataType": "INTEGER",
                                "range": {
                                    "min": 0,
                                    "max": 16777215,
                                    "precision": 1
                                },
                                "required": true
                            }
                        ]
                    }
                },
                {
                    "type": "devices.capabilities.color_setting",
                    "instance": "colorRgb",
                    "parameters": {
                        "dataType": "INTEGER",
                        "range": {
                            "min": 0,
                            "max": 16777215,
                            "precision": 1
                        }
                    }
                },
                {
                    "type": "devices.capabilities.color_setting",
                    "instance": "colorTemperatureK",
                    "parameters": {
                        "dataType": "INTEGER",
                        "range": {
                            "min": 2000,
                            "max": 9000,
                            "precision": 1
                        }
                    }
                },
                {
                    "type": "devices.capabilities.dynamic_scene",
                    "instance": "lightScene",
                    "parameters": {
                        "dataType": "ENUM",
                        "options": []
                    }
                },
                {
                    "type": "devices.capabilities.music_setting",
                    "instance": "musicMode",
                    "parameters": {
                        "dataType": "STRUCT",
                        "fields": [
                            {
                                "fieldName": "musicMode",
                                "dataType": "ENUM",
                                "options": [
                                    {
                                        "name": "Rhythm",
                                        "value": 1
                                    },
                                    {
                                        "name": "Energic",
                                        "value": 2
                                    },
                                    {
                                        "name": "Separation",
                                        "value": 3
                                    }
                                ],
                                "required": true
                            },
                            {
                                "unit": "unit.percent",
                                "fieldName": "sensitivity",
                                "dataType": "INTEGER",
                                "range": {
                                    "min": 0,
                                    "max": 100,
                                    "precision": 1
                                },
                                "required": true
                            },
                            {
                                "fieldName": "autoColor",
                                "dataType": "ENUM",
                                "options": [
                                    {
                                        "name": "on",
                                        "value": 1
                                    },
                                    {
                                        "name": "off",
                                        "value": 0
                                    }
                                ],
                                "required": false
                            },
                            {
                                "fieldName": "rgb",
                                "dataType": "INTEGER",
                                "range": {
                                    "min": 0,
                                    "max": 16777215,
                                    "precision": 1
                                },
                                "required": false
                            }
                        ]
                    }
                },
                {
                    "type": "devices.capabilities.dynamic_scene",
                    "instance": "diyScene",
                    "parameters": {
                        "dataType": "ENUM",
                        "options": []
                    }
                },
                {
                    "type": "devices.capabilities.dynamic_scene",
                    "instance": "snapshot",
                    "parameters": {
                        "dataType": "ENUM",
                        "options": []
                    }
                }
            ]
        }
    ]
}

Here is an example of the request I am sending, but the Rgb is not changing. I have tried with brightness and it does not work either.

POST /router/api/v1/device/control HTTP/1.1  
Host: https://openapi.api.govee.com
Content-Type: application/json  
Govee-API-Key: <key>

{  
    "requestId": "1",  
    "payload": {  
        "sku": "H6069",  
        "device": "<device>",  
        "capability": {  
            "type": "devices.capabilities.segment_color_setting",  
            "instance": "segmentedColorRgb",  
            "value": {  
                "segment": [0,1,2,3,4,5,6,7,8,9],  
                "rgb": 16711680  
            }  
        }  
    }  
}

Here is the response I receive:

{  
    "requestId": "1",  
    "msg": "success",  
    "code": 200,  
    "capability": {  
        "type": "devices.capabilities.segment_color_setting",  
        "instance": "segmentedColorRgb",  
        "state": {  
            "status": "success"  
        },  
        "value": {  
            "segment": [0,  1,  2,  3,  4,  5,  6,  7,  8,  9],  
            "rgb": 16711680  
        }  
    }  
}

I can confirm the device does not have a segmented color or brightness state:

POST /router/api/v1/device/state HTTP/1.1  
Host: https://openapi.api.govee.com
Content-Type: application/json  
Govee-API-Key: <key>
  
{
    "requestId": "1",
    "payload": {
    "sku": "H6069",  
    "device":  "<device>"
    }
}

Response shows that segmentedBrightness and segmentedColorRgb do not have a value.

{
    "requestId": "1",
    "msg": "success",
    "code": 200,
    "payload": {
        "sku": "H6069",
        "device": "<device>",
        "capabilities": [
            {
                "type": "devices.capabilities.online",
                "instance": "online",
                "state": {
                    "value": true
                }
            },
            {
                "type": "devices.capabilities.on_off",
                "instance": "powerSwitch",
                "state": {
                    "value": 1
                }
            },
            {
                "type": "devices.capabilities.toggle",
                "instance": "dreamViewToggle",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.toggle",
                "instance": "gradientToggle",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.range",
                "instance": "brightness",
                "state": {
                    "value": 100
                }
            },
            {
                "type": "devices.capabilities.segment_color_setting",
                "instance": "segmentedBrightness",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.segment_color_setting",
                "instance": "segmentedColorRgb",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.color_setting",
                "instance": "colorRgb",
                "state": {
                    "value": 100
                }
            },
            {
                "type": "devices.capabilities.color_setting",
                "instance": "colorTemperatureK",
                "state": {
                    "value": 0
                }
            },
            {
                "type": "devices.capabilities.dynamic_scene",
                "instance": "lightScene",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.music_setting",
                "instance": "musicMode",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.dynamic_scene",
                "instance": "diyScene",
                "state": {
                    "value": ""
                }
            },
            {
                "type": "devices.capabilities.dynamic_scene",
                "instance": "snapshot",
                "state": {
                    "value": ""
                }
            }
        ]
    }
}