Manual Override for a Fixture¶
Allows you to manually override the fixture or sensor profile settings and dim the light in the fixture to an absolute level for a period of time in minutes.
Request¶
POST https://{em_ip_address_or_hostname}/ems/api/org/fixture/v1/op/dim/{mode}/{amount}?time=60
Specify the following data payload to send along with the POST command.
<fixtures>
<fixture>
<id>27</id>
</fixture>
</fixtures>
Parameters¶
| Name | Description |
|---|---|
| Request | |
em_ip_address_or_hostname | The Enlighted Manage (EM) IP address or hostname |
fixture_id | The fixture or sensor identifier. Use the Fixture ID returned in the Get Sensor Details by Floor API or in EM, select Facility > Floor in the left panel, Floor Plan tab, and double-click the fixture icon in the floor plan to obtain the Fixture ID. |
mode | Set mode option |
| abs – Sets the mode to absolute light level dimming | |
amount | The percentage ranges from 0-100% light levels (must be a whole number) |
time | The manual override duration time (must be a whole number). The default time is set to 60 minutes. |
| Response | |
status | 0 – Light dimmed successfully |
| 1 – Light has not dimmed |
Sample Request¶
Manually override the sensor profile settings and dim the light to 50% for the fixture with ID ‘27’ for a period of 60 minutes. The status shows that the fixture light was set to dim successfully.
POST https://192.80.3.2/ems/api/org/21/v1/op/dim/abs/50?time=60
<fixtures>
<fixture>
<id>27</id>
</fixture>
</fixtures>
Sample Response¶
{
"status": "0"
}