GET /engine/resources/ble-room-devices/{resourceIndex}/
Used when you are operating a browser without access to the header parameter. This allows you to choose which encoding you want to use for the response:
All these resources can be used according what the resource allows.
The $select system query option allows clients to request a limited set of properties for each entity.
The value pass in the parameter can be:
If there is no value after the select query option, the parameter will be ignored. All the values that are not specified will not be printed in the response.
Object Name: BleRoomDevice
| Property Name | Type | Description | Method |
|---|---|---|---|
| resourceIndex | integer | This is the unique identifier of the BLE Room Device | GET POST |
| bluetoothMode | integer | This is the Bluetooth mode required for the device. Possible values are: - 0 for Disabled: Bluetooth connection is disabled and does not allow any wireless connections to the device. - 1 for Open: Bluetooth connection is open and is not authenticated with a PIN code. We recommend this option for rooms or areas that are accessible to anyone. - 2 for Commissioning: Bluetooth connection is used for commissioning the device. This option is the factory default mode (default PIN code 999995) and has short range for commissioning purposes only. - 3 for Private: Bluetooth connection is authenticated with a six (6) digit PIN code. When this mode is selected, you will be prompted to change the PIN code as the default PIN code is not allowed while using Private mode. We recommend this option for private rooms and areas. |
GET POST |
| modelType | Integer | This is the model type of the BLE Room Device Possible values are: - 0 for Unitouch - 2 for Unitouch-H - 3 for Unitouch-CH - 4 for EC-Multi-Sensor-BLE |
GET |
| name | empty | This is the name | GET |
| roomName | empty | Description of the room or location of where the device is located. This name will appear on the UNITOUCH screen as well as in the my PERSONIFY mobile application device list. | GET POST |
| pinCode | empty | This is the Bluetooth PIN Code. If Private Bluetooth mode is enabled, the PIN code is required to wirelessly connect to the device using a smartphone or tablet. A minimum of six (6) digit PIN code which must be different that the default PIN code (999995) |
GET POST |
| subnetId | empty | This is the current subnet ID assigned to the device. | GET |
| uuid | empty | This is the universally unique identifier (UUID) to uniquely identify your your beacons’ network. A UUID is composed of 32 hexadecimal digits split into 5 groups separated by hyphens. Example : 74be2bd-47e1-5995-889b-4f0316eed60a |
GET POST |
| sunBlindGroups | empty | This a list of Sunblind Group | GET POST |
| lightGroups | empty | This is a list of Light Group | GET POST |
| spaceOwners | empty | This is the list of name of the space owners | GET POST |
Object Name: sunBlindGroup
| Property Name | Type | Description | Method |
|---|---|---|---|
| id | empty | This is the unique identifier of the group | GET POST |
| enabled | empty | This indicates if the group is enabled | GET POST |
| index | empty | This is the creation order as defined in EC-gfxProgram | GET |
| displayName | empty | Defines the display name. | GET POST |
| name | empty | This is the name of the group as defined in EC-gfxProgram | GET |
Object Name: lightGroup
| Property Name | Type | Description | Method |
|---|---|---|---|
| id | empty | This is the unique identifier of the group | GET POST |
| enabled | empty | This indicates if the group is enabled | GET POST |
| index | empty | This is the creation order as defined in EC-gfxProgram | GET |
| displayName | empty | Defines the display name. | GET POST |
| name | empty | This is the name of the group as defined in EC-gfxProgram | GET |
URL Example: https://0.0.0.0/api/rest/v1/engine/resources/ble-room-devices/1
<?xml version="1.0" encoding="utf-8"?>
<BleRoomDevice>
<ResourceIndex>2</ResourceIndex>
<SubnetId>10</SubnetId>
<Name>Room Device 2</Name>
<RoomName>Lounge</RoomName>
<ModelType>0</ModelType>
<BluetoothMode>2</BluetoothMode>
<PinCode>999995</PinCode>
<SpaceOwners>
<SpaceOwner>Admin</SpaceOwner>
<SpaceOwner>Operator</SpaceOwner>
</SpaceOwners>
<LightGroups>
<LightGroup>
<Id>1</Id>
<Index>0</Index>
<Name>Group1</Name>
<DisplayName>Group1</DisplayName>
<Enabled>true</Enabled>
</LightGroup>
<LightGroup>
<Id>2</Id>
<Index>3</Index>
<Name>Group2</Name>
<DisplayName>Group2</DisplayName>
<Enabled>true</Enabled>
</LightGroup>
</LightGroups>
<SunBlindGroups>
<SunBlindGroup>
<Id>1</Id>
<Index>0</Index>
<Name>Group1</Name>
<DisplayName>Group1</DisplayName>
<Enabled>true</Enabled>
</SunBlindGroup>
</SunBlindGroups>
</BleRoomDevice>