Manual Override for Switch Group

This API allows you to manually override fixture profile settings associated with a switch and dim the fixtures for a period of time on the floor.

Request

POST https://{em_ip_address_or_hostname}/ems/api/org/switch/v1/op/dimGroup/{floor_id}/{switch_name}/ {dimLevel}?time=60  

Parameters

Request 
em_ip_address or hostname The Enlighted Manage (EM) IP address or hostname.
floor_id Floor identifier. Returned in Get All Floors API ,or in EM, select Facility > Floor > in the left panel, and click the Settings tab to obtain the Floor ID.
switch_name Switch name. Returned in Get Switch Groups API. However, note that all switches on the floor are returned.
The recommended path to determine a specific switch name in EM is select Facility > Floor in the left panel, click Floor Plan tab, and hover the cursor over the switch icon to see the switch name.
dimLevel Specifies the dim level to which the fixtures in the group should be set to (0-100%, 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 – Override success.
1 – Override failed.

Sample Code

Manually override fixture profile settings on floor 1 associated with switch ‘SwitchGrp1’ (returned in the Get Switch Groups API) to dim the fixtures for 60 minutes using the EM IP address. In the example below, all fixtures controlled by 'SwitchGrp1' switch on Floor 1 will be dimmed for 60 minutes.

Post https://192.80.3.2/ems/api/org/switch/v1/op/dimGroup/1/SwitchGrp1/50?time=60

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/json
Content-Length: 7582
Date: Sat, 21 Jul 2015 17:06:51 GMT
{
  "status": "0"
}

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Article is closed for comments.