2022-02-03 — Lux. AIC3. Light level unit of measurement. Footcandles ... Command the object to manual mode and enter the new PIN as the object value. 3. Restart the O3.
O3 Edge
BACnet Application Guide
Edition 2.5
© 2022 Delta Controls. All rights reserved.
No part of this document may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language (natural or computer), in any form or by any means, without the prior written permission of Delta Controls. Limited permission is granted to reproduce documents released in Adobe® Portable Document Format (PDF) electronic format in paper format. Documents released in PDF electronic format may be printed by end-users for their own use using a printer such as an inkjet or laser device. Authorized distributors of Delta Controls products (Delta Partners) may print PDF documents for their own internal use or for use by their customers. Authorized Delta Partners may engage a printing or copying company to produce copies of released PDF documents with the prior written permission of Delta Controls.
Information in this document is subject to change without notice and does not represent a commitment to past versions of this document on the part of Delta Controls. Delta Controls may make improvements and/or changes to this document at any time.
Document edition: 2.5
Contents
Introduction
1
About the O3 Edge
1
BACnet Objects in the O3
2
Sensor Objects
2
Device Objects
5
How Occupancy Works
8
Light Ring Patterns
9
Default Sounds
10
Setting Up the O3
11
Security Settings
11
Changing the BLE PIN
11
Disabling Bluetooth
12
Enabling the Internal MQTT Broker
12
Changing the Internal MQTT Broker Password
12
Configuration Settings
12
Upgrading the Firmware
12
Calibrating the Occupant Temperature
13
Changing Network Settings
14
Disabling NTP
15
Enabling a Startup Sound
16
Custom Settings
17
Creating a Custom Light Ring Color
17
Loading Custom Sounds
18
Controlling Colors and Sounds Remotely
18
GCL+ Programming
19
Configuring the IR Blaster
19
Working with Metrics
21
Viewing Metrics
22
Forcing Updates
23
Deleting Metrics
23
Revision History
24
Introduction
This guide describes the BACnet objects associated with O3 Edge series edge controllers. These objects are used to represent sensor and device properties and can be accessed and configured by BACnet front-end software. The information in this guide applies to the following models:
l O3-EDGE-02 l O3-EDGE-O2-E8 l O3-EDGE-O2-E9
About the O3 Edge
The O3 Edge ("O3") is a ceiling-mounted multisensor device that integrates temperature, humidity, motion, sound, and light sensing. Using sensor fusion technology and machine learning algorithms, the O3 delivers fast, accurate feedback on the monitored space. The O3 supports BACnet, MQTT, EnOcean, and Bluetooth® Low Energy (BLE) protocols, allowing it to integrate with almost any system. It also comes with two universal I/O points for controlling or accepting inputs from nearby devices. For more information about EnOcean, go to support.deltacontrols.com/Products/O3Edge Other features of the O3 include:
l dual Ethernet ports for daisy-chaining over large areas l pass-through communication during power loss l a full-color customizable LED light ring l user feedback via speaker l supports up to 32 EnOcean wireless devices l an IR blaster for remote control of audio-visual equipment l supports up to 32 EnOcean wireless devices For more information about the O3, go to support.o3hub.com.
© 2022 Delta Controls Inc.
1
BACnet Objects in the O3
BACnet objects are used to represent the O3's sensor and device properties. The objects can be grouped as follows.
Sensor
l Temperature l Humidity l Occupancy l Environmental l I/O
Device
l Light Ring l Sounds l Bluetooth l Firmware l Other l IR Blaster
The following tables list the default BACnet objects for the O3.
Sensor Objects
TABLE 1: TEMPERATURE OBJECTS
Name
Instance
Occupant Temperature
AI3
IR Temperature
AI4
Internal Temperature Temperature Setpoint Celsius Fahrenheit
AI5 AV33 AIC1 AIC2
Description
Temperature at 1 m (3 ft) above the floor. This is a composite value derived from the O3's internal temperature sensors and the IR temperature sensor. Range: 0°C to 59°C (32°F to 138°F).
Average temperature of surfaces in the O3's field of view. Range: 0°C to 59°C (32°F to 138°F).
Temperature at ceiling height. Range: 0°C to 59°C (32°F to 138°F).
User-entered temperature from mobile app. Measured by user at occupant height.
Temperature unit of measurement.
Temperature unit of measurement.
2
O3 Edge BACnet Application Guide
Edition 2.5
BACnet Objects in the O3
TABLE 2: HUMIDITY OBJECTS
Name Occupant Humidity
Instance AI6
Internal Humidity
AI7
TABLE 3: OCCUPANCY OBJECTS
Name Occupancy
Instance BI8
Motion Sensor Acoustic Activity Level Acoustic Occupancy
BI9 AI10 BI11
Motion Sensitivity
AV23
Occupancy Audio Sensitivity
AV24
Occupancy Audio Retrigger AV25 Period
Occupancy Remaining Latch Time
AV39
Description
Humidity at 1 m (3 ft) above floor. This is calculated from the occupant temperature and internal humidity using psychrometrics. Range: 0% to 100%.
Humidity at ceiling height. Range: 0% to 100%.
Description
Combined (motion + sound) occupancy signal. Active state when motion and sound is detected. See How Occupancy Works for more details.
Motion occupancy signal. Active state when motion is detected.
Audio level after certain frequencies are filtered out.
Acoustic occupancy signal. Active state when acoustic activity level is above the internal acoustic occupancy threshold.
Controls the sensitivity of the PIR sensor to changes in movement levels within the detection area. 100% = maximum sensitivity.
Controls the sensitivity of the acoustic occupancy sensor to changes in audio levels within the detection area. 100% = maximum sensitivity.
The amount of time (in seconds) that activity sounds can cause the O3 to remain in the occupied state after motion is detected. Default value is 1200 seconds (20 minutes). Measured from most recent motion detection event.
The amount of time (in seconds) remaining before the combined occupancy signal (BI8) deactivates. Read-only.
© 2022 Delta Controls Inc.
3
BACnet Objects in the O3
TABLE 4: ENVIRONMENTAL OBJECTS
Name
Instance
Light Level
AI12
Color Temperature
AI13
Light Sensor Red
AI14
Component
Light Sensor Green
AI15
Component
Light Sensor Blue
AI16
Component
Sound Level
AI17
Light Level Setpoint
AV34
Lux Footcandles 16bit Scale Decibel Kelvin
AIC3 AIC4 AIC5 AIC6 AIC7
TABLE 5: I/O OBJECTS
Name Universal IO Channel 1 AI Universal IO Channel 1 BI Universal IO Channel 1 AO Universal IO Channel 1 BO Universal IO Channel 2 AI Universal IO Channel 2 BI Universal IO Channel 2 AO Universal IO Channel 2 BO
Instance AI1 BI1 AO1 BO1 AI2 BI2 AO2 BO2
Description
Brightness of ambient light (lx or ft-candle). Color temperature of ambient light (K). Red component of ambient light. Range: 0 to 65535. Green component of ambient light. Range: 0 to 65535. Blue component of ambient light. Range: 0 to 65535. Level of ambient noise (dB SPL). Unfiltered audio level across the entire spectrum. (Optional) User-entered light level from mobile app. Records the light level read by the O3 (AI12) when the lighting in the space is set to the desired brightness. This setpoint can be retrieved later by the control system to set the feedback loop, etc. Light level unit of measurement. Light level unit of measurement. Analog-to-digital unit of measurement. Sound level unit of measurement. Color temperature unit of measurement.
Description
Displays analog input value on I/O point xP1. Displays binary input value on I/O point xP1. Displays analog output value on I/O point xP1. Displays binary output value on I/O point xP1. Displays analog input value on I/O point xP2. Displays binary input value on I/O point xP2. Displays analog output value on I/O point xP2. Displays binary output value on I/O point xP2.
4
O3 Edge BACnet Application Guide
Edition 2.5
BACnet Objects in the O3
Device Objects
TABLE 6: LIGHT RING OBJECTS
Name Play Light Ring Pattern
Instance MV1
Light Ring Pattern Repeats AV2
Light Ring Custom Color
AV3
Red
Light Ring Custom Color
AV4
Green
Light Ring Custom Color
AV5
Blue
Light Ring Brightness
AV6
Light Ring Activate Custom BV7 Colors
Power On Self Test Enable BV8
Light Ring Patterns
MIC1
Description
Plays light ring pattern (1-13). Default value is 1 (Off). See Light Ring Patterns for more details.
Sets number of times light ring pattern repeats.
Sets red component of light ring RGB value. Range: 0% to 100%. Only valid if BV7 is On.
Sets green component of light ring RGB value. Range: 0% to 100%. Only valid if BV7 is On.
Sets blue component of light ring RGB value. Range: 0% to 100%. Only valid if BV7 is On.
Sets overall brightness of light ring. Range: 0% to 100%. Default value is 50%.
Activates custom light ring color defined by Light Ring Custom Color Red (AV3), Light Ring Custom Color Green (AV4), and Light Ring Custom Color Blue (AV5). When set to On, it overrides Play Light Ring Pattern (MV1).
Activates power-on self-test (POST), which tests sensor, Bluetooth, and Ethernet functionality. POST status is indicated by the following colors: green = OK, red = sensor problem, blue = Bluetooth problem, and yellow = Ethernet problem.
Contains 12 light ring patterns. See Light Ring Patterns for more details.
© 2022 Delta Controls Inc.
5
BACnet Objects in the O3
TABLE 7: SOUND OBJECTS
Name Play Sound
Instance MV28
Sound Repeats Sound Volume Startup Sound Enable Default Sounds
AV29 AV30 BV44 MIC2
TABLE 8: BLUETOOTH OBJECTS
Name
Enable BLE Bluetooth Beacon MAC Address BLE PIN
Instance BV31 CSV32
CSV45
TABLE 9: FIRMWARE OBJECT
Name Firmware Upgrade
Instance CSV43
Description Plays a sound. There are 25 default sounds, contained in MIC2. You can also create up to 25 custom sounds. See Loading Custom Sounds for more details. Sets the number of times a sound is played. Sets the speaker volume in the range 0% to 100%. Default value is 75%. Enables "Power On" sound to play when the O3 restarts. Default value is Off. Contains 25 default sounds (FIL101 to FIL125). These sounds cannot be overwritten.
Description Enables Bluetooth LE communication. Displays MAC address of Bluetooth LE beacon.
Sets the 6-digit authentication code for read/write access via Bluetooth. Default value is 000000.
Description Initiates a firmware upgrade. See Upgrading the Firmware for more details.
6
O3 Edge BACnet Application Guide
Edition 2.5
BACnet Objects in the O3
TABLE 10: OTHER DEVICE OBJECTS
Name
Instance
NTP Enable
BV42
MQTT Password
CSV46
Internal MQTT Broker Enable
BV48
TABLE 11: IR BLASTER OBJECTS
Name Send IR Code
Instance MV9
IR Code Repeats
AV10
IR Code 1 IR Code 2 IR Code 3 IR Code 4 IR Code 5 IR Code 6 IR Code 7 IR Code 8 IR Code 9 IR Code 10 IR Code 11 IR Code 12 IR Codes
CSV11 CSV12 CSV13 CSV14 CSV15 CSV16 CSV17 CSV18 CSV19 CSV20 CSV21 CSV22 MIC3
Description
Sets time to Coordinated Universal Time (UTC) when connected to the internet. See Disabling NTP for more details. Sets the internal MQTT broker password. See Changing the MQTT Broker Password for more details. Enables external access to the O3's internal MQTT broker. See Enabling the Internal MQTT Broker for more details.
Description
Sends IR code (1-12). Default value is 1. See Configuring the IR Blaster for more details. Sets number of times IR code is sent per transmission. By default, code is sent once per transmission. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Sets IR code. Must be in Pronto hex format. Contains 12 IR codes (CSV11 to CSV22).
© 2022 Delta Controls Inc.
7
BACnet Objects in the O3
How Occupancy Works
A state change from unoccupied to occupied is triggered when a combination of motion and sound is detected in the room. Sound by itself does not trigger a state change. The occupied state is extended when additional motion or sound is detected in the room. The ambient sound level must be above the baseline audio level that the O3 has previously established. Activity sounds detected after the Occupancy Audio Retrigger Period (AV25) do not extend the occupied state. This reduces artificial extension of the occupied state by background noise.
8
O3 Edge BACnet Application Guide
Edition 2.5
BACnet Objects in the O3
Light Ring Patterns
The following light ring patterns are defined by the MIC1 (Light Ring Patterns) object. The states are supplied to the MV1 (Play Light Ring Pattern) object.
State 1 2
3
4 5
6 7 8 9
10 11 12
13
Name Idle (Off) Blue Swirl
Fast Blue Swirl Power On Occupancy Active Got Request Heating Active Cooling Active Don't Understand Error Alarm Christmas
Awake and Waiting
Description No pattern is displayed. Light circles ring once, followed by two short flashes, followed by long flash. Same as above but faster.
Color None Blue
Blue
Light circles ring three times. Light circles ring three times.
Green White
Three short flashes. Light ring fades in and out. Light ring fades in and out. Four short flashes, followed by long flash.
Green Red Blue Yellow
Eight short flashes. Sixteen short flashes on alternating sides of ring. Sixteen short flashes in alternating colors.
Light circles ring once, followed by long flash.
Red Red Red and green Blue
© 2022 Delta Controls Inc.
9
BACnet Objects in the O3
Default Sounds
The following default sounds are defined by the MIC2 (Default Sounds) object. The states are supplied to the MV28 (Play Sounds) object. States 2 to 26 correspond to FIL101 to FIL125.
1. Idle (Off) 2. Power On 3. Acknowledge 4. Chime Confirm 5. Ding 6. Reminder 7. Occupancy 01 8. Occupancy 02 9. Cooling 10. Heating 11. Alarm 12. Critical Alarm 13. Error
14. Alert 15. Security Alarm 16. Notification 17. Prompt 18. Question 19. Done 20. Short Cancel 21. Short Confirm Yes 22. Short Off 23. Short On 24. TNG Door 25. Scanning 26. Ambient Alert
10
O3 Edge BACnet Application Guide
Edition 2.5
Setting Up the O3
This section is divided into three parts: l Security Settings contains instructions for enabling the internal MQTT broker, changing the internal MQTT broker password, changing the BLE PIN, and disabling Bluetooth to protect the O3 against unauthorized writes. l Configuration Settings contains instructions for upgrading firmware, calibrating the occupant temperature, changing the network settings, disabling NTP time syncs, and enabling a startup sound. l Custom Settings contains instructions for creating custom light ring colors and loading custom sounds. It also describes GCL+ programs that you can use with the O3.
Security Settings
Changing the BLE PIN
The BLE PIN is a 6-digit code used to authenticate Bluetooth-enabled mobile devices. To secure writes to the O3 via Bluetooth, you must change the BLE PIN after the initial configuration with the O3 Setup app is complete. The BLE PIN must consist of digits between 0 and 9 and must be exactly 6 digits in length. The new PIN cannot be 000000. To change the PIN:
1. Create object CSV45 with the name "BLE PIN." 2. Command the object to manual mode and enter the new PIN as the object value. 3. Restart the O3. If you're using enteliWEB, on the object list page, click Device Actions >
Reset.
The CSV45 object value should clear after the new PIN is entered. If it doesn't clear, the PIN was not accepted. Check the PIN length and try again.
© 2022 Delta Controls Inc.
11
Setting Up the O3
Disabling Bluetooth
Another way to secure writes to the O3 via Bluetooth is to disable Bluetooth LE communication. To disable Bluetooth:
1. Command object BV31 (Enable BLE) to manual mode and set the object value to Off. 2. Restart the O3. If you're using enteliWEB, on the object list page, click Device Actions >
Reset.
Enabling the Internal MQTT Broker
The O3 has an internal MQTT broker that allows you to write directly to the device's configuration file. The broker is disabled by default. To enable the internal MQTT broker:
l Command object BV48 (Internal MQTT Broker Enable) to manual mode and set the object value to On, then click Save.
Changing the Internal MQTT Broker Password
The default username/password to access the internal MQTT broker is user/admin. To secure writes to the broker, you must change this password. The MQTT broker password is case-sensitive and must be 5 to 31 characters in length. Special characters are allowed. To change the password:
1. Create object CSV46 with the name "MQTT Password". 2. Command the object to manual mode and enter the new password as the object value. 3. Restart the O3. If you're using enteliWEB, on the object list page, click Device Actions >
Reset.
The CSV46 object value should clear after the new password is entered. If it doesn't clear, the password was not accepted. Check the password length and try again.
Configuration Settings
Upgrading the Firmware
If the O3 has an active internet connection, you can get firmware updates from the default URL.
12
O3 Edge BACnet Application Guide
Edition 2.5
Setting Up the O3
The O3 must have the correct time for the firmware upgrade to work. Before continuing, make sure object BV42 (NTP Enable) is set to On.
To upgrade a single O3: 1. Create object CSV43 with the name "Firmware Upgrade." 2. Command the object to manual mode and enter the firmware version as the object value. Use the following JSON format: {"version": "FIRMWARE_VERSION"}
To batch upgrade multiple O3s using enteliWEB: 1. Create object CSV43 with the name "Firmware Upgrade." 2. In the left pane, hold down the Shift key and select up to 8 O3s that you want to update. 3. Filter on CSV43. 4. Select the checkbox at the top left to select all the objects. 5. Click Command > Manual Value, then enter the firmware version as the object value. Use the following JSON format: {"version": "FIRMWARE_VERSION"} 6. Click Save.
When the O3 receives the upgrade command, it validates the server URL and firmware build before proceeding. If the validation check fails, the light ring flashes red 8 times. If the validation check is successful, the light ring turns orange to indicate that the upgrade is in progress. The upgrade may take several minutes. If the firmware upgrade fails for any reason, the light ring flashes red 8 times. If the upgrade command is sent simultaneously to multiple O3s in a daisy chain, some downstream devices may fail to upgrade if there are interruptions in the network. Open the DEV object, and check that the Application Version shows the correct firmware version. Once the upgrade process is complete, verify that CSV43 has cleared its value.
Calibrating the Occupant Temperature
The O3 models the room temperature at occupant height using its internal temperature sensors and IR temperature sensor. Because each room is different (due to air flow, heating sources, height of the ceiling, etc.), the O3's initial prediction is likely to be slightly off. This difference can be calibrated out by measuring the current room temperature and sending that value to the O3. The offset is calculated automatically. For best results, observe the following guidelines:
l Try to get the room temperature as close to your setpoint as reasonably possible. The calibration should hold within ± 5°C, but the closer you are to the control point the better it will be.
© 2022 Delta Controls Inc.
13
Setting Up the O3
l Make sure the temperature in the space has been reasonably stable for at least 15 minutes. That is, don't go from 10°C to 20°C and then calibrate the reading as soon as you reach 20°C. Hold at approximately 20°C for 15 minutes and then calibrate.
l Try to calibrate within the O3's IR envelope, but also make sure it isn't directly next to a heating or cooling source.
l Calibrate at approximately 1 m (3 ft) off the floor. Normally, the occupant temperature is calibrated using the O3 Setup mobile app. However, you can also update the calibration value over BACnet. To update the calibration value:
1. Open object AI3 (Occupant Temperature). 2. Set the object to manual mode. 3. Enter the new calibration value in the Calibration field and save your changes.
If AI3 is not set to manual mode, the entered value will be discarded and the previous calibration value will be shown after a refresh.
Changing Network Settings
The O3 supports both BACnet over Ethernet (BACnet/Ethernet) and BACnet over UDP/IP (BACnet/IP). By default, the BACnet protocol type is set to BACnet/Ethernet. To change the protocol type, connect to the device over BACnet/Ethernet and configure the BACnet/IP settings. To configure BACnet/IP settings in enteliWEB:
1. Open object NP6 (Ethernet1 - IP1). 2. Clear the Out Of Service checkbox. 3. Leave the UDP Port number as the default value (47808) unless you want to create
independent groups of BACnet devices on the same IP subnet. 4. Set IP Mode to Foreign if you want the O3 to join a BACnet/IP network with a different IP
subnet address. Otherwise, leave it as Normal. 5. If IP Mode is set to Foreign, in the BBMD Address field, enter the IP address of the BACnet
Broadcast Management Device (BBMD) that you want to register with, then enter the Subscription Lifetime (Time-To-Live) value. This is the interval at which the O3 must reregister with the BBMD to keep participating on the BACnet/IP network. 6. Click Save. The message "Changes Pending" appears at the top of the page. 7. Return to the object list page and click Device Actions > Activate Network Change. 8. Open object NP5 (Ethernet1 - BACnet) and select the Out of Service checkbox to disable BACnet/Ethernet.
14
O3 Edge BACnet Application Guide
Edition 2.5
Setting Up the O3
The O3 does not route and cannot function as a BBMD.
Disabling NTP
Network Time Protocol (NTP) service is enabled by default, which allows the O3 to synchronize with Coordinated Universal Time (UTC) time when connected to the internet.
Time zone offsets are not currently supported by the firmware. If you are using enteliWEB, you cannot enable the time zone setting in the DEV object.
If you want the O3 to get its time from another BACnet device or from enteliWEB, you must disable the NTP service.
© 2022 Delta Controls Inc.
15
Setting Up the O3
To disable NTP: l Command object BV42 (NTP Enable) to manual mode and set the object value to Off.
Enabling a Startup Sound
You can enable the "Power On" startup sound to play when the O3 is restarted. By default, this option is disabled. To enable the startup sound:
1. Command object BV44 (Startup Sound Enable) to manual mode and set the object value to On.
2. Restart the O3 to verify that the sound plays. If you're using enteliWEB, on the object list page, click Device Actions > Reset.
16
O3 Edge BACnet Application Guide
Edition 2.5
Setting Up the O3
Custom Settings
Creating a Custom Light Ring Color
The light ring consists of red, green, and blue LEDs. You can create custom colors by adjusting the intensity of the component LEDs.
To create a custom light ring color:
1. Command object BV7 (Light Ring Activate Custom Colors) to manual mode and set the object value to On.
2. Open one or more of the following objects: AV3 (Light Ring Custom Color Red), AV4 (Light Ring Custom Color Green), or AV5 (Light Ring Custom Color Blue).
3. Set the object(s) to manual mode. 4. For each object, enter an object value between 0 (Off) and 100 (full intensity) and save your
changes.
Possible light ring color settings include the following:
Color
Red Green Blue Cool White Yellow Orange Pink Teal
AV3 (Red)
100 0 0 100 100 100 100 0
AV4 (Green)
0 100 0 100 50 25 0 100
AV5 (Blue)
0 0 100 50 0 0 25 50
The light ring displays the custom color until object BV7 is set to Off.
Light ring commands are processed in the following order: Device status display BV8 (highest priority) > Light ring brightness AV6 > Activate custom light ring color BV7 > Play light ring pattern MV1 (lowest priority).
© 2022 Delta Controls Inc.
17
Setting Up the O3
Loading Custom Sounds
You can load up to 25 custom sounds, saved as WAV files, to the O3. Each sound file should not exceed 1 MB. The total number and size of custom sounds supported will depend on the amount of remaining free space in the system. To load custom sounds to the O3:
1. Create a FIL object for each audio file, with instances between 126 and 150. 2. Open each FIL object and upload the audio file that you want to associate with that FIL. 3. Update the existing MIC2 object and add states 26 to xx for the custom sounds (FIL126 to
FIL1xx). To play a sound, command object MV28 (Play Sound) to manual mode and set the object value to the sound you want to play. For example, "1. Power On".
Controlling Colors and Sounds Remotely
You can control the device's light ring and/or sounds remotely using GCL+ code executed on a BACnet system controller. For example, you could write a program to activate the light ring and play a sound when motion is detected. If the O3 has a BACnet Device_Instance property (Device Number or Device ID) of 1503, the GCL+ code on the system controller might look something like this:
//play light ring and sound on motion detection IfOnce 1503.BI9 Then 1503.MV1 = 5 //play "occupancy active" light ring 1503.MV28 = 7 //play "occupancy sound" End If
18
O3 Edge BACnet Application Guide
Edition 2.5
Setting Up the O3
GCL+ Programming
GCL+ programming language makes it easier to develop application control logic in a simplified way. Use Program (PG) objects to develop, validate, download, and debug GCL+ programs. You can create up to five PG objects, PG1PG5, in one device. You can also copy PG objects between various V4 devices. For more information about using GCL+, see help.deltacontrols.com
You need enteliWEB 4.20, or enteliWEB 4.19 with the patch to use GCL+. If you don't have enteliWEB or enteliCLOUD, you can contact Delta Professional Development Services to develop your GCL+.
You can write GCL+ code directly into the device to write application control logic, such as controlling the local I/O, reading values from other devices, writing values to other devices, etc. Additionally, you can use existing code available in other Delta products to write GCL+ code. GCL+ does not replace Node-RED; Node-RED can still be used for IoT integrations. Contact Delta Professional Development Services to create your Node-RED flows.
Configuring the IR Blaster
Set up the O3 to transmit infrared remote control signals using enteliWEB or MQTT. To configure the IR blaster using enteliWEB:
1. Obtain the remote control codes specific to your appliance brand and model in Pronto hex format (4-digit hexadecimal values separated by spaces). Remote control codes are available online on websites such as remotecentral.com.
2. Specify the CSV object (there are 12 default CSV objects per O3) with specific instances as listed in the IR Blaster table, command it to manual mode, then enter the remote control code as the Value property.
3. Specify how many times you want to repeat the code in the AV10 object. By default, code is sent once per transmission.
4. In the MV9 (Send IR Code) object, command the object value (select one of 12 options available) to the state corresponding to the remote control signal that you want to transmit.
To configure the IR blaster over MQTT: 1. Publish the remote control code using the format {"data": "IRCODE"} to
commands/object/irCode
© 2022 Delta Controls Inc.
19
Setting Up the O3
For example, the following code {"data": "0000 006d 0022 0003 00a9 00a8 0015
003f 0015 003f 0015 003f 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 003f 0015 003f 0015 003f 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 003f 0015 003f 0015 003f 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 003f 0015 003f 0015 003f 0015 003f 0015 003f 0015 0702 00a9 00a8 0015 0015 0015
0e6e"} can be published to commands/object/irCode1 2. To send the IR code, publish {"data":IR CODE INDEX} to commands/object/irPattern.
IR CODE INDEX specifies the index of the IR code you want to send. Allowable index values range from 1 to 13. 1 is Idle so the IR code index must start at 2 for irCode1, 3 for irCode2, 4 for irCode3, and so on. For example, {"data":2}
20
O3 Edge BACnet Application Guide
Edition 2.5
Working with Metrics
Edge analytics collected on the O3 are known as metrics. Metrics are computed using a rolling database of archived sensor information, providing immediate insight into room conditions without the need for post-processing. The O3 archives temperature, humidity, light level, sound level, and occupancy data every time there is a change of value. This archived data is then analyzed hourly to compute the following metrics:
l min/mean/max occupant temperature l min/mean/max occupant humidity l min/mean/max light level l min/mean/max sound level l occupancy utilization Once the metrics have been computed, the raw sensor data is purged. The metrics are kept for 30 days. This 30-day history is available as a data dump via MQTT. See the O3 Edge MQTT API Reference Guide for more details.
You can set up Trend Log (TL) objects to monitor the metrics and collect sample data. This allows you to visualize the metrics on a line chart or in a table, or archive them if you'd like to report on them historically.
© 2022 Delta Controls Inc.
21
Working with Metrics
Viewing Metrics
To view metrics over BACnet, manually create the following objects.
TABLE 1: READ-ONLY METRICS OBJECTS
Name
Instance
Metrics - Occupant Temperature - mean
Metrics - Occupant Temperature - min
AV201 AV202
Metrics - Occupant Temperature - max
Metrics - Occupant Humidity - mean
Metrics - Occupant Humidity - min
AV203 AV211 AV212
Metrics - Occupant Humidity - max
Metrics - Light Level mean
Metrics - Light Level - min
Metrics - Light Level - max
Metrics - Sound Level mean
AV213
AV221
AV222 AV223 AV231
Metrics - Sound Level min
Metrics - Sound Level max
Metrics - Occupancy Utilization
AV232 AV233 AV241
Description Average occupant temperature during previous hour. Lowest occupant temperature during previous hour. Highest occupant temperature during previous hour. Average occupant humidity during previous hour. Lowest occupant humidity during previous hour. Highest occupant humidity during previous hour Average light level during previous hour.
Lowest light level during previous hour. Highest light level during previous hour. Average sound level during previous hour.
Lowest sound level during previous hour.
Highest sound level during previous hour.
Percentage of time the space was occupied during previous hour.
22
O3 Edge BACnet Application Guide
Edition 2.5
Working with Metrics
Forcing Updates
Metrics are normally computed at the beginning of every hour (12:00, 1:00, 2:00, etc.). However, you can force a metrics update at any time. To force a metrics update:
1. Create object BV292 with the name "Compute Metrics." 2. Command the object to manual mode and set the object value to On.
Deleting Metrics
Metrics are archived for 30 days. However, you can delete all metrics from the database at any time. Normally, this is done during commissioning to clear any metrics acquired during the installation and setup of the O3. To delete all metrics:
1. Create object BV291 with the name "Clear Metrics Database." 2. Command the object to manual mode and set the object value to On.
© 2022 Delta Controls Inc.
23
Revision History
Edition 1.0 2.0
Date February 9, 2021 May 12, 2021
2.1
June 14, 2021
2.2
June 29, 2021
2.3
July 8, 2021
2.4
September 8, 2021
2.5
February 3, 2022
Description
New document.
Removed unsupported BACnet objects (AI18, AV27, AV38, CSV41) and added section on metrics.
Removed BACnet objects (MV40 and MIC4). Updated firmware upgrade instructions. Added BV48 object.
Changed document formatting.
Added procedure to enable the internal MQTT broker.
Added 'GCL+ Programming' section. Updated introduction to include O3 Edge support for EnOcean.
Added IR blaster feature.
24
O3 Edge BACnet Application Guide
Edition 2.5
madbuild