{
  "title": "lamp.color",
  "description": "Color-changing lamp",
  "lang": "en",
  "documentation": "http://recherche.imt-atlantique.fr/xaal/documentation/",
  "ref": "http://recherche.imt-atlantique.fr/xaal/documentation/lamp.color",
  "license": "Copyright Christophe Lohr IMT Atlantique 2019 - Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.",
  "extends": "lamp.dimmer",
  "attributes": { "hsv":"hsv_t", "mode":"mode_t", "scene":"scene_t" },
  "methods": {
    "get_attributes": {
      "description": "Return attributes of the device",
      "in": { "attributes":"attributes_t" },
      "out": { "light":"light_t", "brightness":"brightness_t", "white_temperature":"white_temperature_t", "hsv":"hsv_t", "mode":"mode_t", "scene":"scene_t" }
    },
    "set_hsv": {
      "description": "Change the color of the lamp",
      "in": { "hsv":"hsv_t", "smooth":"smooth_t" },
      "related_attributes": [ "hsv", "mode" ]
    },
    "set_mode": {
      "description": "Change the mode of the lamp",
      "in": { "mode":"mode_t" },
      "related_attributes": [ "mode" ]
    },
    "set_scene": {
      "description": "Change the scene played by the color-changing lamp",
      "in": { "scene":"scene_t", "options":"options_t" },
      "related_attributes": [ "scene", "mode" ]
    },
    "get_scenes": {
      "description": "Get scenes names supported by the lamp",
      "out": { "scenes":"scenes_t" }
    }
  },
  "notifications": {
    "attributes_change": {
      "description": "Report attributes that have changed",
      "out": { "light":"light_t", "brightness":"brightness_t", "white_temperature":"white_temperature_t", "hsv":"hsv_t", "mode":"mode_t", "scene":"scene_t" }
    }
  },
  "datamodel": {
    "hsv_t": {
      "description": "Color description in hue-saturation-value coding",
      "type": "data = [ H, S, V ]\n H = angle = (0...360)/(0.0...360.0) ; Hue\n S = (0..100)/(0.0..100.0) ; Saturation\n V = (0..100)/(0.0..100.0) ; Value"
    },
    "mode_t": {
      "description": "Mode of the lamp",
      "type": "data = \"white\" / \"color\" / \"scene\""
    },
    "scene_t": {
      "description": "Scene name",
      "type": "data = tstr"
    },
    "options_t": {
      "description": "Options for a scene, if any, deeply dependent of the lamp",
      "type": "data = any"
    },
    "scenes_t": {
      "description": "List of scene names",
      "type": "data = [ * tstr ]"
    },
    "attributes_t": {
      "description": "List of wanted attributes",
      "type": "data = [ ? \"light\", ? \"brightness\", \"white_temperature\", \"hsv\", \"mode\", \"scene\" ]"
    }
  }
}