This section lists the GATT services, characteristics, and their associated vendor UUIDs on the GATT server.
Send all values written to the O3 as strings in byte array format.
System Management Service
This service grouping contains characteristics related to management tasks for the O3.
| Service Definition | |
| Name | System Management |
| Service UUID | EFB39360-A7E3-438F-A20D-E9F00E0E22B1 |
System Management Service Characteristics
| Last Operation Result Characteristic | Description |
| Name | Last Operation Result |
| Characteristic UUID | BE5C2FF9-5D6D-4DE1-8F1D-1D2570F79D72 |
| Description |
Returns the result of the PIN verification. |
| Format | Integer |
| Properties | Read |
| Value | 0: OK, 102: wrong PIN, 101: general error |
| PIN Characteristic | Description |
|---|---|
| Name | PIN |
| Characteristic UUID | 839118E2-6975-4A09-99E1-14D5D4776178 |
| Description |
Writes the PIN to the O3 for the purpose of PIN verification. During the verification, the O3 compares this PIN to the PIN saved on the O3 and generates a last operation result. |
| Format | A string of 6 numbers |
| Properties | Write |
| Value Range | 0 to 9 |
| New PIN Characteristic | Description |
|---|---|
| Name | New PIN |
| Characteristic UUID | 3E11BB74-A208-479D-B9C7-B1DDFBB079B7 |
| Description |
Writes a new PIN to the O3 and saves it. Note: You can only write a new PIN after successfully entering the original PIN first. |
| Format | A string of 6 numbers |
| Properties | Write |
| Value Range | 0 to 9 |
Sensor Data Service
This service grouping contains characteristics related to sensor data (temperature, humidity, light level, sound, motion, occupancy).
| Service Definition | |
| Name | Sensor Data |
| Service UUID | F57793C9-9544-46DC-BFA0-5FD149953C86 |
Sensor Data Service Characteristics
| Color Temperature Characteristic | Description |
|---|---|
| Name | Color Temperature |
| Characteristic UUID | 71AEE317-F805-4C58-B069-13D08B12D75B |
| Description |
Reads the color temperature of ambient light (K). |
| Format | Float |
| Properties | Read, Notify |
| Value Range | 0 to 65535 |
| Mapped BACnet Object | AI13 |
| Internal Humidity Characteristic | Description |
|---|---|
| Name | Internal Humidity |
| Characteristic UUID | 12CE7390-C4BA-407E-B1CF-E248F84DC398 |
| Description |
Reads the humidity at ceiling height. |
| Format | Float |
| Properties | Read |
| Value Range | 0 to 100 |
| Mapped BACnet Object | AI7 |
| Internal Temperature Characteristic | Description |
|---|---|
| Name | Internal Temperature |
| Characteristic UUID | ECC9A665-6AF4-4144-9D42-35EEFC2E4D49 |
| Description |
Reads the temperature at ceiling height. |
| Format | Float |
| Properties | Read |
| Value Range | -81 to 257 |
| Mapped BACnet Object | AI5 |
| IR Temperature Characteristic | Description |
|---|---|
| Name | IR Temperature |
| Characteristic UUID | C789F9C6-1224-4670-9375-13D097C08478 |
| Description |
Reads the average temperature of surfaces in the O3's field of view, as determined by the device's IR temperature sensor. |
| Format | Float |
| Properties | Read |
| Value Range | -81 to 257 |
| Mapped BACnet Object | AI4 |
| Light Level Characteristic | Description |
|---|---|
| Name | Light Level |
| Characteristic UUID | EA74FAB1-E7A7-40FA-8EDC-38868EE8BD92 |
| Description |
Reads the brightness of ambient light (lx or ft‑candle). |
| Format | Float |
| Properties | Read, Notify |
| Value Range | 0 to 65535 |
| Mapped BACnet Object | AI12 |
| Motion Sensor Characteristic | Description |
|---|---|
| Name | Motion Sensor |
| Characteristic UUID | 292ABE4D-F45B-4AF0-B464-796F09DF41DB |
| Description |
Reads the motion occupancy signal. Active state when motion is detected. See How the O3 senses occupancy for more details about how occupancy is determined. |
| Format | Integer |
| Properties | Read, Notify |
| Value Range | 0: false, 1: true |
| Mapped BACnet Object | BI9 |
| Occupant Humidity Characteristic | Description |
|---|---|
| Name | Occupant Humidity |
| Characteristic UUID | D6A10DF9-7AF1-4CAA-8380-7FB618373397 |
| Description |
Reads the calculated humidity at 1 m (3 ft) above the floor. |
| Format | Float |
| Properties | Read, Notify |
| Value Range | 0 to 100 |
| Mapped BACnet Object | AI6 |
| Space Occupied/Unoccupied Characteristic | Description |
|---|---|
| Name | Space Occupied/Unoccupied |
| Characteristic UUID | 72B7F5DE-A24F-4FAB-B0CD-78F0582BDD00 |
| Description |
Reads the combined (motion + sound) occupancy signal. Active state when motion and sound is detected. See How the O3 senses occupancy for more details about how occupancy is determined. |
| Format | Integer |
| Properties | Read, Notify |
| Value Range | 0: unoccupied, 1: occupied |
| Mapped BACnet Object | BI8 |
| Occupant Estimation Characteristic | Description |
|---|---|
| Name | Occupant Estimation |
| Characteristic UUID | 8E9398F5-E4E8-4408-B082-92ECC4F488BE |
| Description |
Reads the estimated number of occupants in a space. |
| Format | Integer |
| Properties | Read, Notify |
| Value Range | 0 to 65535 |
| Mapped BACnet Object | AV40 |
| Occupant Temperature Characteristic | Description |
|---|---|
| Name | Occupant Temperature |
| Characteristic UUID | 287B7C85-C471-4146-B678-59832B6B4121 |
| Description |
Reads the calculated temperature at 1 m (3 ft) above the floor. |
| Format | Float |
| Properties | Read, Notify |
| Value Range | -81 to 257 |
| Mapped BACnet Object | AI3 |
| Sound Level Characteristic | Description |
|---|---|
| Name | Sound Level |
| Characteristic UUID | 1CC2B5DA-9F5F-4307-9544-2EF5464F1FA4 |
| Description |
Reads the level of ambient noise (dB SPL). Unfiltered audio level across the entire spectrum. |
| Format | Integer |
| Properties | Read, Notify |
| Value Range | 0 to 120 |
| Mapped BACnet Object | AI17 |
Setpoint Service
This service grouping contains characteristics related to light level, temperature, and user-defined setpoints.
| Service Definition | |
| Name | Setpoint |
| Service UUID | 5040556B-340F-4C6F-B411-448089694628 |
Setpoint Service Characteristics
| Light Level Setpoint Characteristic | Description |
|---|---|
| Name | Light Level Setpoint |
| Characteristic UUID | 725D3560-BBD3-47BE-920E-7843AEDFB0D5 |
| Description |
User-entered light level setpoint. Measured by user when the lighting in the space is set to the desired brightness. |
| Format | Float |
| Properties | Read, Write, Notify |
| Value Range | 0 to 65535 |
| Mapped BACnet Object | AV34 |
I/O and Indicator Service
This service grouping contains characteristics related to I/O (if applicable), light ring, and audio settings.
| Service Definition | |
| Name | I/O and Indicator |
| Service UUID | E05AD2AC-9A01-45F5-A56D-9C3C889D4DC6 |
I/O and Indicator Service Characteristics
| Play Light Ring Pattern Characteristic | Description |
|---|---|
| Name | Play Light Ring Pattern |
| Characteristic UUID | 2E2CEFB0-D026-4EC7-8856-8BDD05F9B62E |
| Description |
Plays light ring pattern, numbered 1 to 13. Default value is 1 (Off). Writing an On value to Activate Custom Light Ring Colors characteristic overrides this Play Light Ring Pattern characteristic. See the How the LED ring works for more details. |
| Format | Integer |
| Properties | Read, Write, Notify |
| Value Range | 1 to 13 |
| Mapped BACnet Object | MV1 |
| Play Light Ring Repeat Characteristic | Description |
|---|---|
| Name | Play Light Ring Repeat |
| Characteristic UUID | 49AC79E5-6E7E-404F-A1A2-FACB501BD9E9 |
| Description |
Sets number of times light ring pattern repeats. |
| Format | Integer |
| Properties | Read, Write, Notify |
| Value Range | 0 to 999999 |
| Mapped BACnet Object | AV2 |
| Set and Play Custom Audio File Characteristic | Description |
|---|---|
| Name | Set and Play Custom Audio File |
| Characteristic UUID | A2895C02-905E-4822-A711-29482675F501 |
| Description |
Defines the custom audio file to be played, and then plays it. Enter the file name, including the file extension. For example: Acknowledge.wav Note: The custom audio file must be uploaded to the O3 using enteliWEB software. See How the speaker works for more details. |
| Format | String |
| Properties | Read, Write |
| Value |
<string> |
| Sound Repeat Characteristic | Description |
|---|---|
| Name | Sound Repeat |
| Characteristic UUID | E5421778-0829-4EA1-A1D1-318124EBE6B0 |
| Description |
Sets the number of times a sound is played. |
| Format | Integer |
| Properties | Read, Write |
| Value Range |
0 to 999999 |
| Mapped BACnet Object | AV29 |
| Play Sound Characteristic | Description |
|---|---|
| Name | Play Sound |
| Characteristic UUID | ED4B8FAD-9922-4B51-BB20-A77A2592E51F |
| Description |
Plays a sound. 1 to 26 (default sounds), 27 to |
| Format | Integer |
| Properties | Read, Write |
| Value Range |
[1, 51] |
| Mapped BACnet Object | MV28 |
Sensor Configuration Service
This service grouping contains characteristics related to device and sensor configuration.
| Service Definition | |
| Name | Sensor Configuration |
| Service UUID | 51E16FF1-20D3-45EC-915C-F18290A893C5 |
Sensor Configuration Service Characteristics
| Assign BACnet Device ID Characteristic | Description |
|---|---|
| Name | Assign BACnet Device ID |
| Characteristic UUID | AE79CA8F-A333-4850-84EA-1AD9710FB5A7 |
| Description |
If the O3 is on a BACnet network, this characteristic defines its BACnet device address. For example: 4100080. Ensure the BACnet device address is unique for each O3. |
| Format | Integer |
| Properties | Read, Write |
| Value Range | 1 - 4194302 |
| Change TCP/IP Settings Characteristic | Description |
|---|---|
| Name | Change TCP/IP Settings |
| Characteristic UUID | 055FA816-E26E-4D82-BB77-456D5DA0D9EE |
| Description |
Sets the O3's IP address, which can either be static or assigned by a DHCP server. If a static address is used, ensure the IP address is unique for each O3. |
| Format | String |
| Properties | Read, Write |
| Value | <string> |
| Read Device Serial Number Characteristic | Description |
|---|---|
| Name | Read Device Serial Number |
| Characteristic UUID | 2E888D3C-AEC5-4193-B0F1-4735CAB9AFBD |
| Description |
Reads the O3's serial number. |
| Format | String |
| Properties | Read |
| Value |
<string> |
| Set Light Unit Characteristic | Description |
|---|---|
| Name | Set Light Unit |
| Characteristic UUID | 4A3B5382-2453-46A1-94CA-7F898122E35C |
| Description |
Set the unit used for light readings. The supported units are lux or foot-candles. |
| Format | String |
| Properties | Read, Write |
| Value |
lux or cd |
| Set Temperature Unit Characteristic | Description |
|---|---|
| Name | Set Temperature Unit |
| Characteristic UUID | 9BBA2752-A586-433D-98CF-888A5B8B09FC |
| Description |
Sets the unit used for temperature readings. |
| Format | String |
| Properties | Read, Write |
| Value |
C or F |
| TCP/IP Subnet Mask Characteristic | Description |
|---|---|
| Name | TCP/IP Subnet Mask |
| Characteristic UUID | 3923BA42-1269-4BF0-9E4C-855182372280 |
| Description |
Sets the O3's subnet mask. |
| Format | String |
| Properties | Read, Write, Notify |
| Value | <string> |
Network Configuration Service
This service grouping contains characteristics related to establishing a BACnet/Ethernet or BACnet/IP network connection.
| Service Definition | |
| Name | Network Configuration |
| Service UUID | E03D645C-3F2B-4693-A2FB-99840EE2581D |
Network Configuration Service Characteristics
| BACnet Ethernet Enable Characteristic | Description |
|---|---|
| Name | BACnet Ethernet Enable |
| Characteristic UUID | E0B25FF2-E97E-4D77-B4DC-7DEAD4A4AADF |
| Description | Enables or disables BACnet/Ethernet protocol support on the O3. |
| Format | Boolean |
| Properties | Read, Write |
| Value Range |
false or true |
| Secure Connect Enable Characteristic | Description |
|---|---|
| Name | Secure Connect Enable |
| Characteristic UUID | A88CE8AF-B1B7-4FB9-B675-8C4D7B17023E |
| Description | Enables or disables BACnet/SC protocol support on the O3. |
| Format | Boolean |
| Properties | Read, Write |
| Value Range |
false or true |
| Secure Connect Auto Config URL Characteristic | Description |
|---|---|
| Name | Secure Connect Auto Config URL |
| Characteristic UUID | AD6D0824-E505-46D8-B831-2195D9BD17EB |
| Description | Sets the auto config URL. |
| Format | String |
| Properties | Read, Write |
| Value Range |
<string> |
| BACnet IP Mode Characteristic | Description |
|---|---|
| Name | BACnet IP Mode |
| Characteristic UUID | 0C33C8F1-86E8-4CA5-A4DF-F1BDB6B96E22 |
| Description |
Reads how the O3 is set up as a BACnet/IP device. Currently, the O3 can only be set up as a foreign device using enteliWEB software. |
| Format | String |
| Properties | Read |
| Value Range |
normal or foreign |
| BACnet Protocol Characteristic | Description |
|---|---|
| Name | BACnet Protocol |
| Characteristic UUID | 61ABFC55-7A00-4B9B-93C9-1770356EDC8F |
| Description | Enables or disables the O3's ability to communicate using the BACnet protocol. |
| Format | Boolean |
| Properties | Read, Write |
| Value Range | false or true |
| BACnet UDP Number Characteristic | Description |
|---|---|
| Name | BACnet UDP Number |
| Characteristic UUID | 67358E4B-C841-4E6F-9822-EC92E388A4A3 |
| Description | Sets the UDP port number used by the O3 to communicate over BACnet/IP. |
| Format | Integer |
| Properties | Read, Write |
| Value Range | 0 to 65535 |
| DNS IP Characteristic | Description |
|---|---|
| Name | DNS IP |
| Characteristic UUID | D1035EB0-C93D-4C20-A4B2-C2E44D91C903 |
| Description | Sets the Domain Name Server IP address used by the O3 if DHCP is not used. |
| Format | String |
| Properties | Read, Write, Notify |
| Value Range | <string> |
| Ethernet MAC Address 2 Characteristic | Description |
|---|---|
| Name | Ethernet MAC Address 2 |
| Characteristic UUID | C417C455-C003-445A-ADA4-F203F0DA2F2A |
| Description | Reads the MAC address used on Ethernet port 2 on the O3. |
| Format | String |
| Properties | Read |
| Value Range | <string> |
| Ethernet 1 Status Characteristic | Description |
|---|---|
| Name | Ethernet 1 Status |
| Characteristic UUID | 73678CA9-B639-459E-890A-6E3B38962B2F |
| Description | Reads the status of the Ethernet port 1 on the O3. |
| Format | Integer |
| Properties | Read, Notify |
| Values |
0: Up and Running 1: Up and Not Running 2: Down and Not Running 3: Error Getting Link Status |
| Ethernet 2 Status Characteristic | Description |
|---|---|
| Name | Ethernet 2 Status |
| Characteristic UUID | ECD1CC9F-7A8E-4B4F-8BD2-8E7B13258F87 |
| Description | Reads the status of the Ethernet port 2 on the O3. |
| Format | Integer |
| Properties | Read, Notify |
| Values |
0: Up and Running 1: Up and Not Running 2: Down and Not Running 3: Error Getting Link Status |
| Secure Connect Connect Status Characteristic | Description |
|---|---|
| Name | Secure Connect Connect Status |
| Characteristic UUID | D7C45246-CE53-43ED-9B1C-EC0F01120852 |
| Description | Reads the BACnet Secure Connect status. |
| Format | String |
| Properties | Read |
| Value Range |
<string> |
| Gateway IP Characteristic | Description |
|---|---|
| Name | Gateway IP |
| Characteristic UUID | 265D3029-4B73-444A-B48D-5016AB25A659 |
| Description | Sets the Gateway IP address used by the O3. |
| Format | String |
| Properties | Read, Write, Notify |
| Value Range | <string> |
| Internal MQTT Enable Characteristic | Description |
|---|---|
| Name | Internal MQTT Enable Characteristic |
| Characteristic UUID | 425A685B-EFEB-432C-BA79-B0ACE5CC9E5D |
| Description |
Enables external access to the O3's internal MQTT broker. |
| Format | Integer |
| Properties | Read, Write |
| Value Range | 0: disable, 1: enable |
| Mapped BACnet Object | BV48 |
| Network Type Characteristic | Description |
|---|---|
| Name | Network Type |
| Characteristic UUID | 5E4E0A08-C27F-430D-8D8D-4993D38A1004 |
| Description |
Defines if the O3's IP address is static or assigned by a DHCP server. |
| Format | String |
| Properties | Read, Write, Notify |
| Value Range | Static or DHCP |
Calibration Configuration Service
This service grouping contains characteristics related to temperature calibration and the configuration of acoustic, motion, and occupancy settings.
| Service Definition | |
| Name | Calibration Configuration |
| Service UUID | 5526A99E-7975-42FF-A27B-94D5A1AD9986 |
Calibration Configuration Service Characteristics
| Acoustic Occupancy Characteristic | Description |
|---|---|
| Name | Acoustic Occupancy |
| Characteristic UUID | 5953C91C-8ECB-4991-AE13-6E619B005DF3 |
| Description |
Reads the occupancy state of the space based on the space's acoustic activity level. The characteristic reads true if the sound level in the space is high enough to indicate occupancy. |
| Format | Integer |
| Properties | Read |
| Value Range |
0: unoccupied because sound level below expected threshold 1: occupied because sound level above expected threshold |
| Mapped BACnet Object | BI11 |
| Acoustic Sensitivity Characteristic | Description |
|---|---|
| Name | Acoustic Sensitivity |
| Characteristic UUID | 88456249-05F8-4434-9C7C-61E1A9A0D5B0 |
| Description |
Sets how much the sound level (loudness) in the room must exceed the background level before the room is considered occupied. This parameter is the sensitivity of the audio portion of the occupancy algorithm, expressed as a percentage (0–100%), with 100% = maximum sensitivity, and 0% = minimum sensitivity. Default value is 80%. |
| Format | Integer |
| Properties | Read, Write |
| Value Range |
0 to 100 |
| Mapped BACnet Object | AV24 |
| Motion Sensitivity Characteristic | Description |
|---|---|
| Name | Motion Sensitivity |
| Characteristic UUID | CCDCE4F9-F8AD-40A4-97C5-43D895981814 |
| Description |
Sets the amount of movement needed to set the Motion Sensor to True. PIR motion sensor sensitivity is expressed as a percentage (0–100%), with 100% = maximum sensitivity, and 0% = minimum sensitivity. Default value is 80%. May need adjusting based on room size and layout. |
| Format | Integer |
| Properties | Read, Write |
| Value Range |
0 to 100 |
| Mapped BACnet Object | AV23 |
| Raw Temperature Characteristic | Description |
|---|---|
| Name | Raw Temperature |
| Characteristic UUID | EB625F90-DDEA-4723-BEAA-D4B09E6BBEA2 |
| Description |
Reads the occupant temperature without any calibration adjustments. For example, if the occupant temperature is 25°C and calibration is 0.5°C, then the raw temperature is 24.5°C. |
| Format | Float |
| Properties | Read, Notify |
| Value Range |
-81 to 257 |
| Temperature Calibration Characteristic | Description |
|---|---|
| Name | Temperature Calibration |
| Characteristic UUID | B3997D46-DEF4-43DE-B82F-DEB04B059C17 |
| Description |
Sets an offset value (positive or negative) used to correct the O3's temperature reading. |
| Format | Float |
| Properties | Read, Write |
| Value Range |
-81 to 257 |
| Mapped BACnet Object | Calibration property of AI3 |
System Configuration Service
This service grouping contains characteristics related to configuration parameters, model numbers, and version numbers.
| Service Definition | |
| Name | System Configuration |
| Service UUID | D72CE428-BA8C-4061-B6DE-6F682736FE08 |
System Configuration Service Characteristics
| BLE API Version Characteristic | Description |
|---|---|
| Name | BLE API Version |
| Characteristic UUID | A3BBD5B5-67B9-449E-924A-18DF526C40F1 |
| Description |
Reads the version of the Bluetooth API. |
| Format | String |
| Properties | Read |
| Value Range |
<string> |
| BLE Beacon ID Characteristic | Description |
|---|---|
| Name | BLE Beacon ID |
| Characteristic UUID | 038F5653-BE86-4200-8F07-34CDD9D41577 |
| Description |
Reads the ID of the Bluetooth LE beacon on the O3. |
| Format | String |
| Properties | Read |
| Value Range |
<string> |
| Firmware Upgrade URL Characteristic | Description |
|---|---|
| Name | Firmware Upgrade URL |
| Characteristic UUID | 8CFA4F33-CBEF-46EC-8D5C-D3DCE95FDB68 |
| Description |
The web site address where the firmware upgrade file can be downloaded from. |
| Format | String |
| Properties | Read, Write |
| Value Range |
<string> |
| Firmware Upgrade Version Characteristic | Description |
|---|---|
| Name | Firmware Upgrade Version |
| Characteristic UUID | BD908AC6-C0B5-4C79-9A2A-E9A556535FE8 |
| Description |
The firmware version number that the O3 can upgrade to. |
| Format | String. The format is x.y.z where x is the major version number, y is the minor version number, and z is the revision number. |
| Properties | Write |
| Value Range |
<string> |
| Firmware Version Characteristic | Description |
|---|---|
| Name | Firmware Version |
| Characteristic UUID | 9C25EE45-44BE-47B3-B0C4-16DB6EE79799 |
| Description |
Reads the O3's firmware version. |
| Format | String |
| Properties | Read |
| Value Range |
<string> |
| Model Name Characteristic | Description |
|---|---|
| Name | Model Name |
| Characteristic UUID | 8050C59A-170E-4206-848A-07EFB78C14BA |
| Description |
Reads the model name of the O3. |
| Format | String |
| Properties | Read |
| Value Range |
<string> |
| Time and Date Characteristic | Description |
|---|---|
| Name | Time and Date |
| Characteristic UUID | DC7ADCCC-E838-48F1-B216-6C06293EA686 |
| Description |
Sets time and date of the O3. |
| Format | String |
| Properties | Read, Write |
| Value Range |
<string> |
Mobile Device Data Service
This service grouping contains characteristics related to mobile devices.
| Service Definition | |
| Name | Mobile Device Data |
| Service UUID | 76A136D4-29FC-4217-B358-9BFF4D6601CE |
Mobile Device Data Service Characteristics
| Reset Hub Characteristic | Description |
|---|---|
| Name | Reset Hub |
| Characteristic UUID | 411225B6-82F0-4E5D-B980-E2099E9DD53F |
| Description |
When a value of 1 is written, the O3 is reset. |
| Format | Integer |
| Properties | Write |
| Value Range |
1: resets device, 0: no reset action |
Comments
0 comments
Please sign in to leave a comment.