Color Bulb

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Color Bulb
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID. 000000000000 when the device itself is a Hub or it is connected through Wi-Fi.

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Color Bulb
hubDeviceIdStringdevice's parent Hub ID. 000000000000 when the device itself is a Hub or it is connected through Wi-Fi.
powerStringON/OFF state
brightnessIntegerthe brightness value, range from 1 to 100
versionStringthe current BLE and Wi-Fi firmware version, e.g. V3.1-6.3
colorStringthe color value, RGB "255:255:255"
colorTemperatureIntegerthe color temperature value, range from 2700 to 6500

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Color BulbcommandturnOndefaultset to ON state
Color BulbcommandturnOffdefaultset to OFF state
Color Bulbcommandtoggledefaulttoggle state
Color BulbcommandsetBrightness{1-100}set brightness
Color BulbcommandsetColor"{0-255}:{0-255}:{0-255}"set RGB color value
Color BulbcommandsetColorTemperature{2700-6500}set color temperature

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringthe type of the device
deviceMacStringthe MAC address of the device
powerStateStringthe current power state of the device, "ON" or "OFF"
brightnessIntegerthe brightness value, range from 1 to 100
colorStringthe color value, in the format of RGB value, "255:255:255"
colorTemperatureIntegerthe color temperature value, range from 2700 to 6500
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoBulb",
        "deviceMac": DEVICE_MAC_ADDR,
        "powerState": "ON",
        "brightness": 10,
        "color":"255:245:235",
        "colorTemperature":3500,
        "timeOfSample": 123456789
    }
}