The chat responses are generated using Generative AI technology for intuitive search and may not be entirely accurate. They are not intended as professional advice. For full details, including our use rights, privacy practices and potential export control restrictions, please refer to our Generative AI Service Terms of Use and Generative AI Service Privacy Information. As this is a test version, please let us know if something irritating comes up. Like you get recommended a chocolate fudge ice cream instead of an energy managing application. If that occurs, please use the feedback button in our contact form!
Skip to content
Enlighted

The Enlighted lighting solution optimizes energy savings while enhancing occupant productivity, well-being, and security.

Change Color¶

The API changes the color temperature of the Tunable White fixtures to a specified setting for the specified duration.

Request¶

POST https://{em_ip_address_or_hostname}/ems/api/org/sensor/tunable-white/change-color/value/{target_color_value}/{time}
<fixtures>
  <fixture>
   <id>63</id>
  </fixture>
  <fixture>
    <id>145</id>
  </fixture>
</fixtures> 

Parameters¶

NameDescription
Request
em_ip_address_or_hostnameManage IP address or hostname
target_color_valueColor Temperature in Kelvin degrees.The valid range depends on the Fixture Manufacturer Table (FMT) supplied by the manufacturer for the fixture.
timeDuration in minutes
Response
statusIf the request is successfully handled “Change color success” message is displayed. When sensor details are missing or inaccurate in the Post command, “Sensors list is empty while requesting API” message is displayed.

Sample Request¶

Change the color temperature value to 3200 for 60 minutes using the Fixture ID. The response ‘Change color success’ indicates that the color change is successfully applied to the Tunable White fixtures. Note that the response is a group response for all fixtures. The response is reported as a success if the message is successfully sent to the sensors.

POST https://10.8.1.90/ems/api/org/sensor/tunable-white/change-color/value/3200/60
<fixtures>
  <fixture>
   <id>63</id>
  </fixture>
  <fixture>
    <id>145</id>
  </fixture>
</fixtures> 

Sample Response¶

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <response>
      <status>0</status>
      <msg>change color success</msg>
   </response>