Required Attribute

`fade`

{
  "name": "fade",
  "value": {"enabled": true, "duration": 2, "durationRange": {"min": 1, "max": 10}}
}

Example Device Model

{
  "Ultron Device": {
    "type": "ULTRON",
    "traits": ["UltronCommand", "BluetoothGateway", "ReportState", "UltronConfig"],
    "disabled": false,
    "attrs": [
      {"name": "rebootTime", "value": 20},
      {"name": "fwUpgradeTime", "value": 60},
      {"name": "iotConfigurableIntervals", "value": true},
      {"name": "schedulable", "value": { "Light": ["OnOff"] }},
      {"name": "periodicity", "value": true}
    ]
  },
  "Light": {
    "type": "LIGHT",
    "traits": ["OnOff", "Brightness", "ColorSetting"],
    "disabled": false,
    "attrs": [
      {"name": "commandOnlyOnOff", "value": false},
      {"name": "commandOnlyBrightness", "value": false},
      {"name": "colorTemperatureRange", "value": {"temperatureMinK": 2700, "temperatureMaxK": 6500} },
      {"name": "fade", "value": { "durationRange": {"min": 1, "max": 10} }},
      {"name": "brightnessRangeConfigurable", "value": true}
    ]
  }
}

Config Item Attributes

Field Name	Type	Note
`brightnessStart`	Integer	Required
`brightnessEnd`	Integer	Required
`duration`	Integer	Required
`temperature` *	Integer
`spectrumRGB` *	Integer
`spectrumHSV` *	Object
`spectrumHSV.hue`	Number
`spectrumHSV.saturation`	Number
`spectrumHSV.value`	Number

*:temperature, spectrumRGB, spectrumHSV these there fields are mutually exclusive. Please use one of them according to the device model.

If colorTemperatureRange is defined, then should use temperature
If colorModel is defined, when value of colorModel
- is "rgb": use spectrumRGB
- is "hsv": use spectrumHSV

Example

Config

[
  {
    "config":"Fade",
    "iotName":"Light",
    "items":{
      "brightnessStart":0,
      "brightnessEnd":100,
      "duration":3,
      "temperature":3460
    }
  }
]

API Example: /usr/v5/SetDeviceConfigs

Turn on fade feature:

{
  "sn": "UT2Z02-3BXXXXX",
  "configs": [
    {
      "config":"Fade",
      "iotName":"Light",
      "items":{
        "brightnessStart":0,
        "brightnessEnd":100,
        "duration":3,
        "temperature":3460
      }
    }
  ]
}

Turn off fade feature:

{
  "sn": "UT2Z02-3BXXXXX",
  "configs": [
    {
      "config":"Fade",
      "iotName":"Light",
      "items": null
    }
  ]
}