Get all BLE Fixtures by Floor
The API returns the sensor location for all BLE sensors on the floor. The data is returned as X, Y coordinates of the measured and scaled-down distance from the lower-left corner of the uploaded floor plan. The API also returns the sensor Product code.
Request
GET https://{em_ip_address_or_hostname}/ems/api/org/fixture/blefixture/list/floor/{floor_id}
Parameters
Request | |
em_ip_address: | The Enlighted Manage (EM) IP address or hostname |
floor_id: | Floor identifier. Use the Floor ID returned in the Get All Floors API, or in EM select Facility > Floor > in the left panel, and click the Settings tab. |
Response | |
id: | Sensor identifier. |
name: | Sensor name. For example, Sensorxxxxxx. |
x-axis: | Scaled reference of the distance measured in the horizontal dimension from the lower-left corner of the uploaded floor plan. |
y-axis: | Scaled reference of the distance measured in the vertical dimension from the lower-left corner of the uploaded floor plan. |
groupid: | Profile group identifier. The ID of the profile associated with the fixture. |
macAddress: | MAC address. |
bleMode: |
Represents the Bluetooth Low Energy (BLE) mode of the fixture.
|
modelNo: | Sensor product code. For product codes, refer to the list of Sensors and Product codes in the Spec Sheets. |
Sample Code
Using the Floor ID '1' returned by the Get All Floors API, request EM to return the x- and y-axis of the scaled-down distance from the lower-left corner of the floor plan for all BLE sensors on Floor 1.
GET https://{em_ip_address_or_hostname}/ems/api/org/fixture/blefixture/list/floor/2 |
Set BLE Mode of Sensor
The API sets the BLE mode of the sensor.
Request
POST https://{em_ip_address_or_hostname}/ems/api/org/fixture/op/assignblemode/{blemode}
<fixtures> |
Parameters
Request | |
em_ip_address: | The Enlighted Manage (EM) IP address or host name. |
blemode: | Sensor BLE mode: OFF – BLE mode is off. SCAN – The sensor scans for BLE signals. BEACON – The sensor sends out BLE signals. |
id: | A unique identifier of the sensor. |
Response | |
status: | nnn – Number of sensors where the BLE mode was updated successfully. -1 – Error message. |
msg: | Error message description. |
Sample Code
Set the BLE Mode of the sensor for two fixtures to OFF. The response indicates that two fixtures have been updated successfully. If there is an error, the error message is displayed.
POST https://192.80.30.2/ems/api/org/fixture/op/assignblemode/OFF |
or
HTTP/1.1 200: OK { "status": "-1", "msg": "Error..." } |