Discussions

Ask a Question
Back to All

what is the difference between toggle and on_off?

"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": "gradientToggle",
    "parameters": {
      "dataType": "ENUM",
      "options": [
        {
          "name": "on",
          "value": 1
        },
        {
          "name": "off",
          "value": 0
        }
      ]
    }
  },

The powerSwitch has an on/off state that I can query, but the gradientToggle always reports its state as an empty string.

Is the toggle intended to be a push button that doesn't report a state? If so, what is the purpose of the on/off enum values? How is it intended to be used?