Dimmer

This configuration sets up the dimming type of the device.

Required Attribute:

availableDimmingTypes

{
  "name": "availableDimmingTypes",
  "value": ["0-10V", "1-10V"]
}

Device Model Example

{
  "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},
      {"name": "availableDimmingTypes",    "value": ["0-10V", "1-10V"] }
    ]
  },
  "Light": {
    "type": "LIGHT",
    "traits": ["OnOff", "Brightness"],
    "disabled": false,
    "attrs": [
      {
        "name": "queryOnlyOnOff",
        "value": false
      },
      {
        "name": "commandOnlyBrightness",
        "value": false
      },
      {
        "name": "colorProfile",
        "value": {"enabled": true, "brightnessStart": 0, "brightnessEnd": 50}
      },
      {
        "name": "fade",
        "value": {
          "enabled": true,
          "duration": 2,
          "durationRange": {"min": 1, "max": 10}
        }
      }
    ]
  }
}

Config Item Attributes

Field NameTypeNote
dimmingTypeStringOptions are defined in attribute: availableDimmingTypes.
  • 0-10V: Capable of dimming to off (0V signal means off).
  • 1-10V: Dims to a minimum brightness level (at 1V), but requires a separate switch to turn completely off.

Example

{
  "config": "Dimmer",
  "items": {
    "dimmingType": "0-10V"
  }
}

API Example: /usr/v5/SetDeviceConfigs

{
  "sn": "UT2Z02-4KXXXXX",
  "configs": [
    {
      "config": "Dimmer",
      "items": {
        "dimmingType": "0-10V"
      }
    }
  ]
}