Start the Functional or Duration Test for a Fixture

When this API call is issued, the sensor sends a message to the connected DALI driver to initiate a Functional or Duration test on the fixture. You can only send this command to sensors or fixtures designated as emergency fixtures. 

The Functional test checks the unit's functionality to ensure that the lamps and circuitry are all working correctly.  The Duration test allows the device to change to emergency mode, checking for the lamps and the circuit's status to ensure that the device is working correctly.

Since you will not be able to perform any lighting control operations on the fixture during this time, set the fixture light level before starting the test. Otherwise, the fixture will stay at the light level it was when the test was started. Use the Manual Override for a Fixture API to set the fixture light level. Likewise, set the fixture color temperature prior to starting the test using the Change Color API.  

Include the Fixture ID of the sensor controlling the fixture in the PUT request. Use the Get Sensor Details by Floor API to obtain the Fixture ID. The driver begins executing the Functional or Duration test when it receives the request. The API returns OK to indicate that the Enlighted Manage (EM) has sent the sensor's start test command.

Request

PUT https: //{em_ip_address_or_hostname}/ems/api/org/fixture/v1/{fixture-id}/emergencyMode

{
 "emergencyMode": "..."
}

Response

{
  “emFixtureStatus”: ems/api/org/fixture/v1/{fixture-id}/emFixtureStatus 
}

Parameters

Sample Code

Start the functional test (16) on the emergency fixture with the Fixture ID '28'. The API returns status code 200 OK to indicate that the Enlighted Manage has sent the start test command to the sensor with Fixture ID '28'.

PUT https: //10.45.9.120/ems/api/org/fixture/v1/28/emergency Mode
{
 "emergencyMode": "16"
}

HTTP/1.1 200
Server: Apache-Coyote/1.1
Content-Type: application/json
Content-Length: 62
Date: Sat, 26 Sep 2020 10:36:51 GMT
{
  “emFixtureStatus”: "ems/api/org/fixture/v1/28/emFixtureStatus" 
}