LTBT TM PRGRMR
LTBT TM PRGRMR
LTBT TM PRGRMR
BACtalk Systems
Contents
Chapter 4: Programming VLC DDC for the BACtalk Microset and Microtouch 43
About the Microset 43
About the Microtouch 43
Analog and binary values assigned to Microset operation 43
Setpoint calculation 46
Occupied and unoccupied modes 47
Typical DDC for a Microset 48
Field Service Mode 48
Balance Mode 49
About BACnet
BACnet identifies all information in terms of properties and objects. An object
might represent a physical input or output, or it may represent something more
abstract, such as a setpoint. And each property of the object provides data to
describe something about the object. All data in a BACnet system is identified in
this way. The most common property of almost all objects is the present-value. The
property of an object is equivalent to what is traditionally known in control
systems as a data point.
• Device instance
• Object ID
• Property
Each object has an instance number that, along with its type, forms the object ID
(for example, AI-1, represents Analog Input 1). This object ID allows the BACnet
system to identify and use data.
For example, in a VAV–SD (a VAV box controller), AI-0 is a physical input. Its
most important property is the room temperature, which is conveyed by its present-
value property. Other properties of the object convey more information: the units
property tells the system that the value is in degrees F and the description property
that it is a space temperature.
All objects have some required properties and some that are optional. You can
examine the device’s protocol information conformance statement (PICS) to
determine which objects a device supports. See the BACnet specification for more
information about BACnet and PICS.
About BACtalk
BACtalk is Alerton’s BACnet-compliant system. Operator workstations, global
controllers, expandable controllers, and VLCs together make up a BACtalk
system. All BACtalk components make their operational data available to other
BACnet-compliant devices according to the BACnet standard.
BACtalk controllers
There are three classes of controllers, and each has different capabilities with
respect to DDC and building automation features.
About DDC
The programmable logic that controls the sequence of operations in BACtalk
devices is called DDC (direct digital control). DDC sequences are stored and
carried out in BACtalk controllers. Similarly, automation features—such as
optimum start, demand limiting, trendlogs, schedule, and alarms—that you set
up in Envision for BACtalk are downloaded and stored in host controllers (that
is, a BTI, BTI-100, VLCP, VLX, or BCM).
No te For more information about how a DDC program loops and executes, see
Figure 2 on page 17.
Likewise, DDC files authored for global controllers, expandable controllers, and
BACtalk control modules are compatible with the Global/Building Controller
DDC programming environment. A DDC sequence saved or loaded in one
environment can be opened and viewed in the other.
Every VLC is fully programmable, although many VLCs are designed for
specific applications and have downloadable, standard operating sequences
created by Alerton (Alerton Standard applications). Values are stored differently
in C3-series and Gen4 VLCs.
The present values of AVs 50-89 are stored directly in EEPROM and should be
used for setpoints or other user input data that will not change frequently. With
the exception of the Runtime Accumulator, these values can not be referenced in
the output of a DDC function. The Runtime Accumulator only writes to the
output once for every hour of accumulated runtime to help enforce the 100,000
write cycle limitation.
No te You will start to have indeterminate problems with a device if you exceed
the 100,000 write limitation.
• v4.0 has a 248 byte and a 191 bit limit (GEN4 VLCs)
• v3.01 (only used in the VAV-SDA), v1.15, and earlier versions have a 72
byte and a 39 bit limit (C3 VLCs)
• v 2.04 has a 206 byte and a 143 bit limit
Each time you use one of these functions in DDC, the function uses some of this
RAM. If the sum of either bytes or bits used by your DDC exceeds the RAM
capacity, no more functions can execute.
Limit usage of devices in Table 1 accordingly so that your VLC DDC program
does not exceed the byte/bit limit.
All field-level controllers have the same number of logical outputs (BOs and AOs),
but the configuration of the hardware determines the actual number of physical
outputs.
However, there are a couple of things to consider when working with multistate
objects:
Comm Fail VLC A flag that is set ON only when the VLC loses
communications with a global controller. The
VLC Comm Fail flag is set when
communications have been lost for 5 minutes
and reset whenever a valid MS/TP message
for the given VLC is received.
CA U TIO N When you view live data (F2 View Data) in Global/Building
Controller DDC, values that have had a NOT or REV applied may not display
correct values.
REV Reversing applies to analog-type inputs and outputs (real numbers). When
an analog value is reversed, the result is a value equal to 100 minus the initial
value. For example, if you reverse a function’s input whose value is 20, the
actual value passed to the function is 80. The same is true of outputs.
NOT Notting applies to binary inputs and outputs. When you NOT an ON value,
it results in an OFF, and vice versa.
No te In VLC DDC, you can NOT inputs and outputs on binary DDC functions.
Priority arrays
BACnet uses a priority array to control the present-value property of certain
objects. In BACtalk devices, only AOs, BOs, and BV-40 in VLCs, BVs in global
controllers, and AOs, BOs, AVs, in VLX controllers use a priority array. Because
a number of commands may be issued simultaneously for a present-value
property—for instance, an operator may command a fan ON while a schedule
calls for it to be OFF—a scheme for prioritizing commands is necessary. This is
achieved with the priority-array property. Other manufacturers may use a
priority-array for other object types.
Subroutine DDC
You can use subroutine DDC to make your DDC program more efficient. You
should program a subroutine any time a calculation or control sequence needs to
be implemented repeatedly. For instance, you may need to convert fpm to cfm
for a number of VAV boxes. Or you may need to control equipment in 65 hotel
rooms in exactly the same way, but each must control equipment according to its
own ambient conditions. These are both perfect opportunities for using
subroutine DDC.
NORMAL DDC
represent any
m iscellaneous DDC
functions.
3
Num bers represent 3 2830 67 Sub-Caller (Start 7530)
each tim e a subroutine 4 2840 67 Sub-Caller (Start 7530)
is called from within 4 2850 yy
norm al DDC. The lines
indicate the
progression of the
logic. Bold lines
indicate when the
subroutine is
sum m oned by a sub- 3100 zz
5
caller function, while 3110 67 Sub-Caller (Start 6500)
regular lines indicate 5
3120 xx
the return to norm al
DDC when function 2
is encountered.
yy
with different values,
it's called an iteration.
In VisualLogic, the DDC program and the drawing are one and the same. When
you save your drawing, code for the VLC or global controller is saved along with
it. This means you can generate a DDC program from a Visio drawing or convert
DDC from a device into a Visio drawing.
The following graphic helps you identify the key elements in VisualLogic that
you use to execute commands, author DDC, and set device and drawing
properties.
Drawing with
sample code.
Visio toolbars and menu items enable The device settings icon lets you set scaling,
you to draw, format, and manipulate custom Microset programming, and other
objects in the drawing and set drawing operating specifics for the device. A VLC or
properties. On the View menu, point to global controller appears depending on the type
Toolbars to select the toolbars you want to of DDC program you are viewing. Double-click
view. the icon to view the Device Settings dialog box.
Installing Visio
Install Visio 2000, 2002, or 2003 if you plan to use VisualLogic. Alerton
recommends you install Visio in the default installation directory. For detailed
installation procedures, see your Visio documentation.
IMPO R TAN T Set the Macro security level to “Low” before installing Envision
for BACtalk.
CA U TIO N If you upgrade from Visio version 5.0 or 2000 to Visio 2002, you
must completely uninstall the older version before installing version 2002.
Otherwise, VisualLogic will not work properly.
No te Computers that meet only the minimum system requirements should not
use Visio and VisualLogic.
Starting VisualLogic
When you start VisualLogic, the Visio development environment opens with a
blank workspace. You then use the VisualLogic menu to either create a new
VisualLogic program, load one from file, or load one from a BACtalk controller
on the network.
X To start VisualLogic
1. On the Tools menu in Envision for BACtalk, point to DDC, and then
click VisualLogic.
-OR-
As long as Envision for BACtalk is running, you can start VisualLogic
from the Envision for BACtalk program group.
DDC files contain all DDC program information, but may also contain drawing
information (descriptors and geometric information) if they were created and
saved in VisualLogic (VisualLogic > Options > DDC Save Options).
Visio drawing files To ensure that you save Visio drawing elements, in addition
to saving DDC program information, you can save your work as a Visio drawing
file (*.vsd) using Visio's Save command on the File menu. Visio drawing files
are typically much larger than their corresponding DDC files and open more
quickly. The Visio drawing file contains all drawing information as well as all
DDC program information. You can't use VLC or Global/Building Controller
DDC to open Visio files.
A Visio drawing file is automatically saved when you choose to send an open
DDC file to a controller with the Save option selected.
2. Select the type of device you are programming and then click OK. A
new drawing opens for the type of device you selected.
3. In the list of files, select the file name you want, and then click Open.
VisualLogic generates a new drawing based on information in the DDC
file. Conditions under which the file was created and saved dictate the
rendering in VisualLogic.
3. Click Save.
2. Select the folder you want and type a file name in the File Name box.
N ote If you don’t use the same filename and rep/job that are displayed
in the title bar, it may appear not to save.
4. Click Save.
Application Name The file name used when you save a DDC file or Visio
drawing file through the VisualLogic menu. Maximum
of 8 characters.
3. Click OK.
3. In the Descriptor Entry dialog box, select the object type and object
instance, and type a description in the boxes provided, and then click
OK.
The description appears in the list of descriptors.
The selection of English versus metric units here can be read in DDC from BV-
71, which is read-only. Most Alerton Standard applications use BV-71 to modify
measurement related calculations according to the program units selection.
Table 3 BV-71 settings for English/metric
Metric ON
2. Click the General tab, and then type or select English or Metric in the
Program Units box., and then click OK.
3. For DDC Read Inhibit, select Reads Inhibited, and then click OK.
This topic briefly summarizes the options available for AI Setup in the Device
Settings dialog box. For more detailed information about the appropriate setup
for different types of hardware and notes about scaling and input options, see the
bulletin TB-BTW-INCFG, Input Setup Reference for VLCs.
3. For each AI you want to work with, under Type, select the input type
according to the following guidelines (see TB-BTW-INCFG for further
details).
Type Explanation
Counts Input is read in raw counts from 0-4095.
Scaled When you select a Scaled input type, the Zero (time
base) and Range (pulse value) fields appear. AI = Zero +
(Input * Range/ 4096) where “Input” is the pre-scaled
input count. See the “Scaled (two point)” below for a
simpler method.
3K Thermistor Use this input type for 3K ohm thermistor inputs. The AI
then reports temperature (in °F or °C according to the
Program Units setting).
Scaled (two point) Select the VLC and input type and VisualLogic
automatically calculates and enters Zero (time base) and
Range (pulse value) values for you.
4. Under Units, select the type of engineering units you want to assign to
this input. This option is not available when 10K Thermistor or 3K
Thermistor is selected as Type.
5. Type zero and range values according to the guidelines for Scaled in
step 3 and the information in the VLC Installation and Operations
Guide (LTBT-TM-GEN4VLC).
N ote You only need to select the VLC and input type for the Scaled
(two point) option and the time base and pulse values are populated
automatically.
6. Select the Filter check box if you want filtering applied to the input. The
filter calculation is performed every 0.1 seconds and is expressed as:
NewCount 31
FilteredCount = --------------------------- + ------ 〈 PreviousCount〉
32 32
CA U TIO N Do not filter any Microset/Microtouch inputs.
Relinquish Default Type a default value for the AO. The valid range is 0
to 100. The relinquish default determines the value
of the AO when all elements in the AO's priority-
array are NULL–essentially the default value of the
AO.
Out of Service Select this check box to set the AO's out-of-service
property = TRUE. The out-of-service property
controls the relationship of the physical AO to its
present-value. When out-of-service = TRUE, the AO
is decoupled from its present-value, and the
physical AO value is the result only of DDC
execution in the VLC, while the present-value still
reflects the priority array.
4. For each BO, if you want to decouple the physical BO from its present-
value and consign control exclusively to the VLC's DDC, select the out-
of-service check box.
As a technician scrolls through the list of Microset field service codes, the codes
at the top of the list appear first. You can arrange codes in VisualLogic so the
more frequently queried values appear first. For a list of the standard Microsoft
codes, see “Microset Field Service mode custom codes” on page 161.
No te When a Microset II is in balance mode, only the first five items in this list
are available. This means, if you are programming DDC for a VAV controller,
you should put the items most useful to your air balancer first.
2. To add a new field service code, click the Insert New button, and then
double-click the blank code entry in the list.
—or—
To edit an existing code, double-click the code entry on the list. The
Edit Microset Entry dialog box opens.
3. In the Display Digits boxes, type or select the first and second digits you
want displayed at the Microset.
Tab le 4 Acceptable Microset Field Service mode characters
0 1 2
3 4 5
6 7 8
9a A b
c C d
E F g
h H i
J L n
o p r
u U y
- _
a.The characters 9 and g are virtually indistinguishable on the Microset display.
4. In the Object boxes, type the object type and instance whose present-
value you want associated with the Display Digits.
6. Click OK.
VisualLogic doesn't require that the DDC functions appear in any order (they
always execute in order of sequence number) or that they be linked with
connectors. However, arranging functions in logical order makes the DDC much
easier to read, and using connectors enables you to use the Check Drawing and
Propagate Parameter commands.
When you link functions with a connector, the output of one function isn't
necessarily linked to the input of another. You still assign inputs and outputs in
the functions’ setup dialog box. The exception is when you use the Propagate
Parameters command.
3. Click the connection point, drag the mouse pointer to the connection
point on the target function, and then release the mouse button.
A red rectangle appears over the connection points as the mouse pointer
is moved close to them.
N ote Use CTRL+Shift to drag a window and zoom in on an area of
the drawing. Right-click while holding CTRL+Shift to zoom out.
You can save all comments for a drawing to a rich text file (*.rtf) and use it as a
source for creating a sequence of operations for your job. Topics are saved to file
in the order that they appear in the Program Comments dialog box. You can
adjust the order of topics.
X To view comments
1. Select the function whose comments you want to view.
2. On the VisualLogic menu, point to Comments, and then click View.
-or-
Right-click the function whose comments you want to view, and then
click View Comments.
3. Replace the "New Comment" title with your own text (the title
automatically appears in the list of topic titles), and then type comment
text.
4. In the Range box, type the sequence number of the function or the range
of functions (separated by a dash, for example 10-100) you want this
comment associated with.
5. Repeat steps 2-4 for each comment topic you want to add.
2. In the Program Comments dialog box, select the topic title you want to
rearrange, and then click the Up button to move it toward the top of the
list or click the Down button to move it toward the bottom of the list.
N ote Topics are saved to the *.rtf file in the order of appearance in the
list of topics. This order is independent of their assignment to function
sequence numbers.
3. Select a folder and file name to save to, and then click Save.
2. In the Program Comments dialog box, select the comment topic you
want to work with from the list.
4. Click the Font button, and then choose font details in the box provided.
If errors are found, select one from the list, and then click Goto
Error to jump to the area of the drawing where the error occurs.
VisualLogic prompts you for information about the device and the DDC file (the
rep, job, file name, and version). You can save the file to the rep and job
directory in conjunction with the Send command, or you can send files without
saving them (not recommended). VisualLogic requires DDC file information
even if you don't choose to save. This is because the VLC retains the rep/job
information along with the DDC.
CA U TIO N VLCs and global controllers have a limited amount of memory for
DDC. Occasionally, the controller won’t have enough memory to save the
geometric information—the spatial relationship of functions and connectors—in
the controller. When this occurs, the message appears: There is not enough
space for DDC on this device. Clear the Geometric Info option (VisualLogic
> Options > DDC Send Options) and then try again. Always save a copy of
such files to disk. If edits are necessary, open the Visio drawing file from disk,
edit it, and resend DDC to the controller.
Representative and The Alerton representative and job name. The DDC
Job file keeps a pointer to the rep\job folders in the
BACtalk root directory. If you choose to save files, this
is the rep\job they are saved in.
Send and save files Click this option if you want a DDC file and Visio
drawing file saved to disk at the same time you send
the DDC to a device. Files are saved to <bactalk
root>\<rep>\<job> with the name <file>.bd3|bd4 and
<file>.vsd.
3. Click Send.
2. Select the folder and file you want to send, and then click Open.
3. In the Device Instance dialog box, type the device instance of the VLC
or global controller you want to receive the DDC, and then click OK.
When you load the drawing file, you can either read DDC from the device or
from a file on disk. You can view real-time data for a single function or any
number of functions. The speed of data updates depends on many factors:
network traffic and the number of functions you choose to view, for example. As
a general rule, choosing to view data for fewer functions results in quicker data
updates.
2. On the File menu, click Open. Browse to the Visio file you want to
work with, and then click Open.
CA U TIO N Make sure that it is the same file loaded in your controller;
otherwise, erroneous data appears.
Additionally, if you read DDC from a device or file (VisualLogic > File
> Read DDC from Device/Read DDC from File), and geometric
information was not saved to the device/file, DDC functions will appear
on numerous pages in no particular order.
3. Select the functions for which you want to view live data values.
4. On the VisualLogic menu, point to Tools, and then click View Live
Function Data.
5. In the Device Instance dialog box, type the device instance of the device
(VLC or global controller) you want to monitor, and then click OK.
Data from the controller appears in red beside its associated I/O
connector.
sec Init-N
AV-62 on BR-1
60
BR-0 on
BV-26 BR-0
on DOB on
on 3170
3160
Modifying DDC
When you edit DDC in VisualLogic, the DDC program you work on is stored in
the memory of the computer running VisualLogic. No changes are made to the
DDC programming in the controller until you save the new DDC program to the
controller.
You can adjust the DDC program at the computer without affecting the
controller’s operation. The controller continues to execute the most recently
downloaded DDC program until a new program replaces the old one.
CA U TIO N If you have multiple I/O assignments using the Junction shape, the
Propagate Parameters command will automatically propagate the assignment of
the output with the lowest sequence number to all the outputs, overwriting
previous assignments, if any.
Repeating functions
This feature provides a way to create several DDC functions of any kind at one
time. For example, to create multiple subcallers in Global./Building Controller
DDC. You can increment DDC function parameters with input specific to each
DDC function.
You can also increment the following optional parameters: branch numbers,
device instances, object instances, array indexes, substitution numbers, and
‘Real’ data values. Only some of these parameters are applied to particular DDC
functions. If the increment value is zero, the correspondent parameter does not
increment.
X To repeat functions
1. Select the function you want to repeat.
4. Select the parameters you want to repeat and how you want to
increment them.
5. Click OK.
Resequencing functions
Often, a programmer needs to change the sequence of a range of functions while
programming, usually because functions were added or omitted. VisualLogic
enables you to select a range of functions and renumber them as a whole. Rather
than changing sequence numbers one-by-one, you assign a starting sequence
number and specify the increment of sequential function numbers—10, 20, 30,
or 5, 10, 15, for example.
X To resequence functions
1. Select the functions you want to resequence. Use Shift+click to add
functions to an initial selection.
3. In the Start box, type the lowest sequence number you want assigned to
the selected functions.
4. In the Step box, type the increment by which you want sequence
numbers to increase.
5. Click OK.
The function with the lowest sequence number is renumbered with the
Start sequence number. Other functions are numbered in increasing
increments of the Step value.
Cross-referencing functions
The DDC cross-reference table displays all DDC functions matching the input
criteria. Users can select any DDC function in the output cross-reference table
and go to the drawing shape associated with the DDC function.
X To cross-reference functions
1. On the VisualLogic menu, point to Tools, and then click Cross-
Reference Table.
2. By default, All Data is shown. Select how you want to filter functions in
the table. For example, you can choose to view only sub caller data.
In addition, a reserved range of AVs and BVs in the Microset enable customized
control of the unit. These features greatly simplify DDC programming for zone
temperature control.
Table 5 VLC data points reserved for Microset and Microtouch operation
Object
Function Remarks
Instance
AV-90 Setpoint Displayed at the Microset and
adjusted up or down when the
WARMER or COOLER button is
pressed.
AV-95 Unoccupied Cooling Setpoint The cooling setpoint used when BV-
67 is OFF.
AV-96 Unoccupied Heating Setpoint The heating setpoint used when BV-
67 is OFF.
Table 5 VLC data points reserved for Microset and Microtouch operation
Object
Function Remarks
Instance
AV-104 Microtouch Lever Offset Automatically calculated from
current lever position and the value
of AV-105.
BV-72 Fan Low Speed When BV-72 is set to ON, the fan
icon on the Microset II moves at slow
speed.
BV-73 Fan Medium Speed When BV-73 is set to ON, the fan
icon on the Microset II moves at
medium speed.
Table 5 VLC data points reserved for Microset and Microtouch operation
Object
Function Remarks
Instance
BV-74 Fan High Speed When BV-74 is set to ON, the fan
icon on the Microset II moves at high
speed.
BV-75 Door Open Icon Reserved for future door open icon
on the Microset II.
BV-83 24HR Time Format Select 12- or 24- hour time format on
the Microset II.
Setpoint calculation
Throughout your DDC, use AV-99 and AV-100 for the actual current cooling and
heating setpoints, respectively. The VLC automatically includes offsets and
switches between occupied and unoccupied setpoints as appropriate. The
Microtouch lever offset is also automatically considered if a Microset is not
detected.
When the VLC is in unoccupied mode, it sets the current cooling (AV-99) and
heating (AV-100) setpoints to the unoccupied cooling (AV-95) and unoccupied
heating (AV-96) setpoints, respectively. When the VLC is in occupied mode, the
current cooling setpoint is set to the occupied setpoint (AV-90) plus the
Microtouch lever offset (AV-104, only included if Microset is not detected), plus
the cooling offset (AV-93), plus the demand offset (AV-106).
The current heating setpoint is set to the occupied setpoint (AV-90), plus the
Microtouch lever offset (AV-104, only included if Microset is not detected),
minus the heating offset (AV-94), minus the demand offset (AV-106).
Microtouch offsets
If a Microset is not detected, the VLC assumes a Microtouch is connected, and
input 1 is read as a Microtouch bias. The VLC calculates the Microtouch offset
(AV-104) based on the position of the lever and the Microtouch lever value (AV-
105). Typically, when a Microtouch is used, the Microtouch lever value (AV-
105) is placed on a display to provide an easy way to adjust the amount of
influence the Microtouch lever has on the occupied setpoint. If the lever is in the
full up position, the Microtouch offset will be a positive value equal to the
Microtouch lever value. Conversely, if the lever is in the full down position, the
Microtouch offset will be a negative value equal to the Microtouch lever value.
As the lever is moved between the two stops, the Microtouch offset will vary
between these two values, with a value of zero at the center position.
After-hours operation
When BV-64 is OFF, the VLC remains in unoccupied mode unless the after-
hours timer (BV-66) is activated.
The value of the after-hours timer (AV-98) automatically counts down at a rate of
0.5 every 30 minutes until it reaches zero, at which time the after-hours timer
status (BV-66) turns OFF. The after-hours timer automatically resets to zero
when BV-64 turns ON. As long as BV-64 is OFF, the after-hours timer (AV-98)
can be manually adjusted in increments of 0.5 hours from a BACtalk data
display.
Microset
When a Microset is connected, the user can activate the after-hours timer by
pressing the ON button. For each press of the ON button, the after-hours timer
(AV-98) increments 0.5 hours, up to the after-hours limit (AV-97). Similarly, the
occupant can press the OFF button to decrement the after-hours timer in 0.5 hour
increments.
Microtouch
When a Microtouch is used, pressing the Microtouch center will set the after-
hours timer to the value of the after-hours duration (AV-97). The after-hours
timer status is ON whenever the after-hours timer is above zero.
Heating and cooling control sequences can use AV-99 and AV-100 as the current
cooling and heating setpoints. These setpoints are automatically calculated as
described above depending on occupied mode status, offsets, and other factors.
BV-67 can be used as an indication of when the VLC transitions between
occupied and unoccupied mode. This can be useful for resetting Proportional
Integral (PI) functions when the setpoint changes.
VLC DDC must be used to transfer the space temperature to AV-101. Typically,
the space temperature will be AI-0, but in some applications you may wish to
average two or more sensors or use a different sensor. We recommend that you
use AV-101 as the space temperature throughout your programming, then if you
want to change your sensor configuration you only have to modify your DDC in
one place.
The demand offset is included in the setpoint calculation to allow for the future
implementation of a demand limiting program. The demand offset will be sent
from a global controller to AV-106.
The Microset present flag (BV-70) allows you to create display items that will
change depending on whether or not a Microset is installed. The English/metric
flag (BV-71) allows you to write DDC programming that will automatically
adjust tuning parameters and limits depending upon the mode to which the VLC
is set.
to any custom codes set up in the DDC header (see “Microset Field Service
mode custom codes” on page 161).
Table 6 Default fixed codes for Microset Field Service Mode
Custom codes can be entered in the DDC device settings header. You are allowed
to assign a custom code for up to 26 BI, BV, AV, BO, or AO objects. For each
entry, you can specify whether the number will appear with or without one
decimal place, and if the item is to be read-only. Items can also be restricted to
positive numbers only. Note that if a BI, BV, or BO is specified, an ON value is
represented on the Microset as .1 and an OFF value is 0. You must therefore
activate the decimal point for binary items.
Balance Mode
The button sequence BLANK-BLANK-ROOM-ON-COOLER enables a special
VAV Box Balance Mode, which is used for air balancing and airflow sensor
calibration. This mode allows access to the codes listed in Table 7 as well as
entries 0–3 (for Microset v1.15) in the Microset Field Service Mode Setup
screen of VLC DDC (entries 0-4 apply for Microset II v1.17). See “Microset
field service code setup” on page 30 and “Microset Field Service mode custom
codes” on page 161, for more information.
Table 7 Additional default fixed codes for VAV Box Field Service Mode
Table 7 Additional default fixed codes for VAV Box Field Service Mode
HF. Hot Deck cfm (Dual Duct Only) (Range is 0-32767) AI-8
CF and HF (if applicable) show the current cfm, which can be adjusted by
modifying the calibration factor (k) during balancing. While in VAV Box Field
Service Mode, the WARMER and COOLER buttons change the k factor in
increments of ± 0.01, while the ROOM and OUTSIDE buttons change the k
factor in increments of ± 0.1. Using the VAV Box Field Service Mode, you can
adjust the k factor until the CF and HF readings match those from a balancing
hood.
Use VLC DDC to view the value of the k factor (see “Setting parameters for a
VAV airflow sensor” on page 163).
The following data points are available in VLC DDC, Alerton/Standard Device
Templates 82330000.DVT and 82340000.DVT and can be used to view and edit
balancing data.
Table 8 Air balance data points
Data
Description Remarks
point
AV-250 Cold Duct Box Size Range 0~63 inches
Document meticulously
As you develop the program, document the point assignments, starting with all
the physical control points at the VLC level. The control point list should include
all logical and physical points for VLC DDC. The control point list for Global/
Building Controller DDC should include all points. Be sure to note the point type
(AI, BI, AO, BO, AV, BV) and whether any additional automated control
features are required (alarms, schedules, optimum start, for example).
Leave a written history of the assignment of inputs and outputs to equipment and
how control sequences were implemented. Document in such a way that another
engineer or programmer can decipher your work.
CA U TIO N When using the REDs DDC function, be sure to assign network
number 0 if the MS/TP device is on the local MS/TP network.
The BACtalk Automation Object essentially exposes BACtalk data so that it can
be used by scripts, programs, and applications that support Automation. This
enables you to read property values, write property values, and send a time sync
from another application.
No te EBT v1.3 and later includes a Comm Failure Object that can be used
instead of DDC.
Method 1
The Delay on Make and Delay on Break Functions (DOM and DOB) in VLC
DDC combine to produce a pulse (BV-63) every 240 seconds. The Exclusive OR
(XOR) Function in the Global Controller DDC reacts to the pulse generated by
the VLC. As BV-63 switches from ON to OFF and back to ON, the XOR resets
the DOB, turning the VLC Comm Fail (BV-201) OFF. As long as the Global
Controller can read the pulse (BV-63) from the VLC, the XOR will continually
reset the DOB. If communications between the Global Controller and the VLC
fails, a Comm Failure condition will be reported through BV-201 after 900
seconds (15 minutes) has elapsed. This elapsed time is set using the delay input
to the DOB. The sequence numbering of the DDC functions in the global
controller is very important. Note that the XOR, at sequence 4500, executes
before the Transfer (XFR), at sequence 4510. This is the trick in getting the XOR
to pulse ON to OFF and repeat. Also, the branch point between the XFR and the
XOR (BR-401) must be a reserved branch point. This means that BR-401 cannot
be referenced anywhere else in Global Controller DDC.
Set up the VLC Comm Fail Alarm (BV-201) as you would any other binary point
alarm using the Alarm Wizard in BACtalk. The delay setting in the alarm point
setup should be set to zero so as not to conflict with the DOB in Global
Controller DDC.
Figure 6 Method 1: VLC and global controller DDC sequences for detecting VLC communications failure at the
global controller
Method 2
The Two-Input AND Function (&) in VLC DDC generates a pulse (BV-63) to
the global controller. BV-63 pulses between ON and OFF every time the global
controller transfers BV-63 to BV-62. As long as communication is established
between the VLC and the global controller, BV-63 will continually pulse
between ON and OFF. The Change of State Detector (COS) Function in Global
Controller DDC reacts to the pulse generated by the VLC. As BV-63 switches
from OFF to ON, the COS resets the Delay on Break (DOB), turning the VLC
Comm Fail (BV-201) OFF. As long as the global controller can read the pulse
(BV-63) from the VLC, the COS will continually reset the DOB. If
communications between the global controller and the VLC fail, a Comm
Failure condition will be reported through BV-201 after 300 seconds (5 minutes)
have elapsed. This elapsed time is set through the delay input to the DOB.
Set up the VLC Comm Fail Alarm (BV-201) as you would any other binary point
alarm using the Alarm Wizard in BACtalk. The delay setting in the alarm point
setup should be set to zero so as not to conflict with the DOB in Global
Controller DDC.
Figure 7 Method 2: VLC and global controller DDC sequences for detecting VLC communications failure at the
global controller
As a result, the Comm Fail flag in the VLC is useful in DDC only insofar as it
enables VLC DDC to revert to a stand-alone mode of operation (for example,
causing setpoints to revert to stand-alone, default settings) in the absence of all
other devices, not just the global controller. It is not useful for determining
whether a VLC is online with a global controller, or whether global controller
DDC has halted.
No te The VLC Comm Fail flag is set when communications have been lost for
5 minutes and reset whenever a valid MS/TP message for the VLC is received.
Explanation of DDC
The DDC sequences shown are for an global controller with Device Instance 211
and a VLC with Device Instance 702. It shows only the heartbeat and pickup
sequences.
Figure 9 Pickup sequence in the VLC, which uses BV-11 (selected arbitrarily)
as the global controller communications failure flag
Actual results depend on how Microset AVs are used in the control sequence. In
certain applications, AV-101 has been used as a space temperature input to the
proportional component of a proportional integral (PI) routine. AV-101 varied by
0.5 when the actual space temperature change was much smaller. This caused a
disproportional response and frequent equipment response, causing over cycling
of the controlled variable and possible premature wear on controlled equipment.
Do not use AVs 90-107 in control sequences where their limited resolution may
be an issue. Instead, use actual input values. For example, use AI-0 for space
temperature.
PID logic has been used with industrial controls for a long time. The Alerton
BACtalk PI and PID controllers use industry-standard terminology wherever
possible.
PI vs. PID
For virtually all HVAC applications, it is generally wiser to use PI control rather
than PID control. The Derivative component generally does not add much
responsiveness, and it can be difficult to tune. Erratic response often results from
using Derivative control in HVAC applications. Although PID control is often
included as a specification requirement, the Derivative component should
probably not be used unless you are very confident in your understanding of the
complexities of tuning PID controllers.
Output = 50 + P + I
The primary inputs are the setpoint (SP) and feedback input (FB). The other
inputs are tuning parameters, and they are generally set to fixed values as needed
to achieve responsive yet stable control. Both the P and I components are
calculated from the difference between the setpoint and the feedback input. This
difference is called the error (E), and it represents how far away from setpoint
the feedback input is.
E = FB - SP
The goal of the control function is to get this error value to go to zero (that is,
feedback input = setpoint.)
P = E x Kp
I = Iprevious + (E x Ki /60)
The integral adjustment value is limited by the maximum integral change (Imax),
which is the maximum amount the integral component is allowed to change per
minute. The maximum allowed integral adjustment (which is added once per
second) is then Imax/60.
Finally, the value of the integral component is limited by the integral limit
(Ilimit). I is not allowed to be greater than Ilimit or less than -Ilimit.
For RA applications, use the REV feature of DDC on the output of the function.
When this is done, the Reversed Output = (100 - Output).
A typical value for Kp for room temperature control applications would be 12.0
for English unit applications. This means that if the room temperature (feedback
input) is 76° and the Setpoint is 74°, the proportional component would be 2 x
12.0 = 24. If the integral component was zero, the output would then be 50 + 24
= 74.
When it takes a long time for the feedback input to change once the controlled
item is adjusted (for example, when modulating a VAV cooling damper to
achieve a desired room temperature), it generally reduces the value of Ki relative
to Kp. The proportional constant often helps prevent overshooting in these cases.
When the feedback input responds quickly to changes in the controlled item (for
example, when modulating a damper to achieve a desired airflow), the
proportional constant should generally be set fairly low, perhaps even to zero,
leaving most of the control to be performed by the integral component.
To determine an appropriate initial value for Kp, divide 3 by the smallest amount
you would typically adjust the Setpoint. For example, for controlling a supply
fan speed to maintain duct pressure, the smallest setpoint adjustment would
probably be 0.1. Thus, the starting value might be 3/0.1, or 30. You will of
course have to use your judgment as to whether to adjust this value up or down
depending on the stability and responsiveness of what you are controlling as well
as the consequences of overshooting the value.
Integral Constant is the amount the Output will change over the course of
one minute, in response to an error value equal to one.
A typical value for Ki for room temperature control applications would be 1.0.
This means that if the room temperature (feedback input) is 76° and the setpoint
is 74°, the integral component would increase by 2.0 every minute (provided
Imax is greater than 2.0).
Imax represents the maximum amount of change allowed for the integral
component in one minute.
Typically, Imax should be set to match the speed of the actuator being controlled.
It should equal the percentage of full stroke that can be achieved in one minute.
For example, if a VAV damper is being controlled, either to achieve a desired
room temperature or to achieve a desired airflow, and the full stroke damper time
is 5 minutes, then Imax should be set to 20. This is because the damper can only
stroke 20% of its full stroke in one minute. As another example, if a valve can be
actuated in 30 seconds, then Imax should be set to 200, since the valve can stroke
200% in one minute.
If you use a number greater than 50, the output could potentially stay fixed at 0
or 100 for a while, even when the error indicates a need to adjust the output in
the opposite direction. The industry term for this phenomenon is “integral
windup.” It can be useful for certain applications when you want the integral
component to be able to build up. Building up the integral component will delay
any change from 0 or 100 (depending on whether the integral component is
negative or positive).
Upon initialization (or when Ki is set to zero), the Integral component will equal
STUP. For applications where the Kp is equal to zero or when the Feedback
Input happens to match the setpoint, the output will be equal to 50 plus STUP
upon initialization. You can calculate a good value for STUP by taking the
output you wish to see upon startup, and then subtracting 50. For example, if you
want the output to start at 20, the STUP should be 20 - 50 = -30.
For example, consider an application where you are controlling a VAV damper to
achieve a desired room temperature. If the throttling range is set to 5, the damper
will be adjusted from fully closed to fully open as the input varies from 2.5
degrees below the setpoint to 2.5 degrees above the setpoint. To determine the
corresponding value of Kp, you simply look at how much you want the output to
change for every degree of change in the Input. In this case, it would be 20. A
simple way to convert throttling range to Kp is to use the formula: Kp = 100/
Throttling Range.
Primarily, these DDC routines enable integration of a BACtalk system and third-
party devices that write or read multiple bits in a single control point. Some
manufacturers use a single 8-bit or 16-bit number to issue up to 16 different
digital commands. The number of bits used is dependent on the manufacturer.
Each bit in the number represents a different command. For example, you can
use this DDC to integrate your BACtalk system with a Modbus VFD, which may
use a single register/coil address to represent multiple points, each point
represented by a bit in the register/coil address number.
Once you understand the DDC routines, you can scale them to manage only the
number of bits you need to work with.
The DDC assigns the appropriate value to each BV and writes the output value
as AV-0, including DDC to write only on change-of-state. For example, turning
BV-4 ON activates a Function 40: Switch to pass the value of 16 (BV-4
represents the 16's position) to a Function 33: 6-input Addition. The 16 is then
added to any other bit values that have been set to ON. As written, any number in
the range 0 (all BVs OFF) to 255 (all BVs ON) is possible.
The bit-unpacker DDC has a three-function, bit-checker DDC sequence for each
possible bit in the value. Each sequence consists of a Function 39: Within,
Function 30: Subtraction, and Function 40: Switch. Beginning with the largest
possible bit-value, the bit-checker sequence reads the value from the register coil
address and checks to see if it is within a specific bit range. If the bit-encoded
value is detected within the analog value, the bit-checker sequence sets the BV
representing the bit to ON, subtracts the bit value from the total value, and then
passes the reduced value to the next bit-checking sequence. The process repeats
for all bit-encoded values to be checked.
CA U TIO N Do not host DDC and automation for devices on several TUX
trunks in a single BCM-TUX. The increased communication load between
modules will compromise system performance.
For example, if you replace a fully loaded APEX with four BCM-TUXs, you
will need to split the DDC program into four separate programs: one for each
BCM-TUX. Similarly, alarms and trendlogs in a BCM-TUX should be set up
only for directly connected TUXs, where the alarmed or trended data originates.
Enable heating, cooling, and Some application specific TUXs require Use BCM-TUX DDC to write to appropriate BOs in
unit operation that ON values be sent to DOs. This is the virtual device. See the installation and operations
done in APEX DDC. guide for the specific TUX at hand for a data point
reference. Typically BO-1, BO-2, and sometimes BO-
8 are used.
Enable expanded mode Use Device 79. Expanded mode is automatically enabled in the
BCM-TUX and no action is required. Important! The
BCM-TUX does not support 1200 baud TUX trunk
communications.
Trend a data point Use IBEX trendlogs. Any virtual device points can be trended using
Envision for BACtalk trendlogs.
Alarm a data point Use IBEX alarms. Any virtual device points can be alarmed using
Envision for BACtalk alarms.
Programming with Zone IBEX allows you to use APEX DDC to There are AVs and BVs available in the virtual
Custom points generate values for Zone Custom points, devices that are not mapped to specific TUX points.
which can then be placed on control These can be used in DDC programming in a similar
panel template. (This is part of the method to Zone Custom DDC. These points can be
"control panel" concept.) placed on a device template, similar to the way zone
custom points are placed on a control panel template.
Ta ble 9 Functions and features performed by the global controller in an IBEX system.
Allow use of TUX values in Use Zone TUX points. Global controller DDC allows this through use of the
control panel DDC Set context function.
Data display re-use Use Control Panel templates. Use Device templates.
Convert pulse data APEX DDC allowed use of Device 9 to Pulse count and pulse width can be converted to
convert compound data (AI-1 through AI- consumption and rate using DDC math functions in
6) from a TX-651-Pulse to both the BCM-TUX.
consumption and rate.
Pulse width comes from the TUX in tenths of a
second (AI-11 through AI-16). These values can be
converted to a rate by taking the reciprocal and
multiplying by 10 times the amount per pulse. This
will give a rate in units per second. Multiply this value
by 60 to get rate per minute or 3600 to get rate per
hour. Pulse counts (AI-21 through AI-26) may be
multiplied by the pulse value to yield consumption.
The gateway string may also be used to convert data,
but this adds complexity and should be avoided.
Make data available Use global points. No action required. BACnet data can be seen from
throughout the system anywhere on the network.
Control panel subroutines TUX is linked to control panel using Function 67: Subroutine caller allows reference to a
Device 80. changing device in subroutine DDC.
2. Use Device Manager to save point data from the VLC in step 1. Be sure
to select the present values, priority arrays, and the relinquish defaults
box.
3. Create folders (unless they already exist) for all VLCs that you wish to
copy descriptors to. Manually create these folders or have Device
Manager automatically do it for when you save point data from the
controllers. The folders should reside in the same rep/job folder as the
job you are working in and should be named DEVnnnnn (where nnnnn
is the device instance). If the device instance is longer than five
numbers, then the DEV portion must be truncated as needed to allow
numbers to be in the name. Folder names cannot exceed 8 characters.
The process will be faster if you choose only to save the VAV
calibration factors (even if the VLCs are not VAV controllers).
4. Copy the PointData.mdb file from the folder corresponding to the VLC
in steps 1 and 2 to all the folders created in step
5. Use Device Manager to send point data to all the VLCs you want to
send descriptors to. Be sure to select the present values, priority arrays,
and relinquish defaults box. THIS WILL ALSO CHANGE ALL
POINT DATA TO MATCH THE ORIGINAL CONTROLLER FROM
WHICH YOU SAVED DATA. You probably won't want to select the
VAV calibration factors, box sizes, or zero cutoffs box.
100
END OF
NORMAL
100
END OF
SUBROUTINE
Remarks When you enter a data point in Global/Building Controller DDC, you
have three options: you can specify the device where the data point originates,
you can specify the local device (the global controller in which the DDC
executes), or you can choose a set context device. If you choose the set context
device, the function references the data point in the device instance of the last Set
Context Function to execute.
Device
Instance SET
CONTEXT
100
Remarks The inputs are input, zero, and k factor. Input should be a signal
representing the velocity pressure (vp) of the measured airflow. The k factor is
used as a multiplier. The zero is used to compensate for variations in transducer
readings at zero airflow; set the zero input equal to the value of the vp input
when there is no airflow. The output of Function 6 can be expressed as:
Output = k vp – z
where
k = k factor
z = zero
The k factor can be used to correct for the pickup multiplier and any other factors
necessary to convert the input signal value to actual velocity pressure. Most vp
pickups (except true pitot tubes) produce a pressure differential that is greater
than the actual vp. The conversion factor is typically referred to as a pickup
multiplier. Use the following equation to calculate the k factor using the pickup
multiplier (PM).
No te This assumes the input has been scaled to equal the sensed pressure in
inches of water column.
1
kfactor = 4005 ---------
PM
Input
Zero
ZERO
Output
OUT
K factor K
100
No te To use this function to calculate the square root of a variable, enter Data 0
in (zero), Data 1 in (K factor), and assign your variable as the input. The output
will be the square root of your input variable.
Temp.
°F Output
%RH
%RH 100
ENTHALPY CALCULATOR
Remarks The output will be set to ON only if both inputs are ON. If either
input is OFF, the output is OFF.
Input 1
Output
Input 2
100
ON OFF OFF
OFF ON OFF
ON ON ON
The function uses all six inputs to set the output ON or OFF. If any of the six
inputs is OFF, the output is set to OFF. The output is set to ON only if all of the
six inputs are ON.
Input 1
Input 2
Input 3
Output
Input 4
100
Input 5
Input 6
Remarks The output is ON if either or both inputs is ON. The output is OFF
only if both inputs are OFF.
Input 1
Output
Input 2
100
ON OFF ON
OFF ON ON
ON ON ON
The function uses all six inputs to set the output as ON or OFF. If any of the six
inputs is ON, the output will be ON. The output will be OFF only if all six inputs
are OFF.
Input 1
Input 2
Input 3
Output
Input 4
100
Input 5
Input 6
Remarks The output remains ON only for a single pass of DDC, even if the
input stays ON for a longer or period.
Input Output
100
ONE SHOT
Remarks When the input transitions from OFF to ON, the function or output
transitions ON only after the specified delay time (t). If the input value
transitions OFF at any time during the delay period, the timer is reset. The delay
time (t) resolution is one tenth of a second. The output transitions OFF
immediately when the input transitions OFF.
In Global Controller DDC, changes to the delay time have no affect on the
operation of the function when the input is ON. In VLC DDC, changes to the
delay time affect output status unless the output is already ON.
No te The time delay function contains logic to adjust for DDC cycles that take
longer than 0.1 second to complete, therefore keeping accurate time regardless
of the DDC cycle time. The stored delay timer associated with each time delay
function is limited by timing range. For delays less than 1638.3 seconds (27.3
minutes), resolution is in 0.1 second increments. For delays between 1638.3 and
16383 seconds (0.45 hour to 4.5 hours) resolution is in 1 second increments. For
delays between 16383 seconds and 163830 seconds (4.5 hours to 45.5 hours)
resolution is in 10 second increments. The delay is limited internally to a
maximum of 45.5 hours.
sec
Delay
Input Output
DOM
100
Remarks When the input changes from ON to OFF, the output changes to OFF
after a delay time (t). If the input value changes to ON at any time during delay
time (t), the timer is reset. The output transitions ON immediately when the input
transitions ON.
In Global Controller DDC, changes to the delay time have no affect on the
operation of the function when the input is OFF. In VLC DDC, changes to the
delay time affect output status unless the output is already OFF.
No te The time delay function contains logic to adjust for DDC cycles that take
longer than 0.1 second to complete, therefore keeping accurate time regardless
of the DDC cycle time. The stored delay timer associated with each time delay
function is limited by timing range. For delays less than 1638.3 seconds (27.3
minutes), resolution is in 0.1 second increments. For delays between 1638.3 and
16383 seconds (0.45 hour to 4.5 hours) resolution is in 1 second increments. For
delays between 16383 seconds and 163830 seconds (4.5 hours to 45.5 hours)
resolution is in 10 second increments. The delay is limited internally to a
maximum of 45.5 hours.
sec
Delay
Input Output
DOB
100
Input 1
Output
Input 2
100
ON OFF ON
OFF ON ON
ON ON OFF
Remarks Function 20 has two binary inputs, set (S) and reset (R), which
determine how the output is set. A momentary ON of the set (S) input turns the
output ON if the reset (R) input is OFF. The output stays ON once it is set, even
if the set (S) input transitions OFF. If the reset (R) input turns ON, the output
transitions OFF. The reset (R) input has priority over the set (S) input, so the
output is OFF if both inputs are ON.
Set Output
Reset
100
FLIP/FLOP
ON ON OFF
Remarks Once the output turns ON, it will stay ON for the minimum ON time,
even if the input goes OFF.
When the output goes OFF, it will stay OFF for the minimum OFF time, even if
the input goes ON.
For VLCs, the time resolution is 0.1 second. For global controllers, the time
resolution is 1 second and must be entered in whole seconds; the decimal value
is ignored. For example, 308.7 = 308.
M inim um O n
Inp ut O utp ut
M inim um O ff 100
A NTI SH O RT CY C LE
Remarks The output will be ON when the plus input is greater than or equal to
the minus input plus the trigger deadband (TDB). The output will go OFF when
the plus input is less than or equal to the minus input minus the restore deadband
(RDB).
T DB=
RDB=
Plus Input
Output
Minus Input
100
COM PARATOR
Condition Output
Plus Input > (Minus Input + TDB) ON
(Minus Input - RDB) < Plus Input < (Minus Input + TDB) No change
No te For direct acting control assign the Process Feedback to the Plus Input,
and the Process Setpoint to the Minus Input.
No te For reverse acting control assign the Process Feedback to the Minus Input
and the Process Setpoint to the Plus Input.
Remarks Function 23 compares the input value to a stored value. The stored
value is set to the input value each time the output is ON and does not change
while the output is OFF.
The output is ON when the input is greater than the stored value plus the DB, or
the input is less than the stored value minus the DB. Otherwise, the output is
OFF.
Example If DB is set to 1.0, and the input when the DDC is first initiated is
13.2 (which then becomes the stored value), then the output turns ON for one
pass of the DDC the first time the input reaches 14.3 or greater or 12.1 or less. If
the input varies between 12.2 and 14.2, the stored value remains the same.
If the input were to suddenly change to 14.6, for example, the output would turn
ON and 14.6 would become the new stored value.
Deadband
Input Output
100
CHANGE OF STATE
DETECTOR
Remarks The inputs to Function 24 are made up of an analog data input (IN),
binary reset input (RST), maximum up count (MUP), and maximum down count
(MDN). As long as the binary reset input is ON, the output attempts to match the
analog data input; however, the rate of change of the output is limited by the
maximum up and maximum down inputs. The maximum up input regulates the
maximum increase allowed in the output per second, while the maximum down
input regulates the maximum decrease allowed in the output per second. The
maximum up count and maximum down count are independently adjustable.
The output is set immediately to zero when the reset input turns OFF.
Input
Output
Reset
Maximum Up
100
Maximum Down
RESTRICTOR
Remarks The BACnet object (OBJ) and priority-array index (PR) are inputs to
this function. The data output equals the current value of the specified element of
the priority array, except when the element is NULL, in which case the data
output is 0 (or OFF when used as a binary value).
Data
Object Output
OBJ
Null
Priority
PR Output
100
PRIORITY READ
Remarks For each pass of the DDC, the value of the UPCNT value is added to
IO whenever UP is ON.
Note that this function only adds to IO or subtracts from IO when either UP or
DN is ON.
Upper Limit
+ Amount
+ In
Output
- In
- Amount
INCREMENT/DECREMENT
Remarks This function will not write to the output if the Gate input is OFF.
Note that, unlike Function 47: Sample and Hold, this function does not store the
value of the output, meaning the output will not necessarily remain constant
when the Gate input is OFF.
Gate
Input Output
100
GATED
TRANSFER
Remarks When the binary gate control is ON, the value of the input is written
to the output (which should be a BACnet object), with the priority specified by
the priority input. The output must be a BACnet object that has a priority array.
PRIORITY WRITE
Object
Input
OBJ
Priority
PR
100
Gate
Remarks Function 30 subtracts the value of analog input 2 (-) from the value of
analog input 1 (+). The output is then set to the result.
Input 1
Output
Input 2
100
Remarks Function 31 adds analog input 1 and analog input 2. The output is
then set to the result.
Input 1
Output
Input 2
100
Input Output
100
TRANSFER
Input Output
100
Multiplier
Input Output
100
Divisor
Remarks Function 39 has three analog inputs and one binary output. Although
the limits are labeled High Limit and Low Limit, The High Limit does not have
to be greater than the Low Limit. The output is ON whenever the input value is
greater than or equal to the Low Limit value and the input value is less than or
equal to the High Limit value. Otherwise, the output is OFF.
Note that the output is ON if the input value is equal to either of the limits, and
one does not necessarily have to be less than the other.
High Limit
HI
Input Output
IN
Low Limit
LO 100
WITHIN
Remarks Function 40 has two analog inputs, one binary input, and an analog
output. The output equals the ON analog input if the binary control input is ON,
and the output equals the OFF analog input if the binary control input is OFF.
Control
ON
Output
OFF
100
SWITCH
100 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Remarks Function 41 has three analog inputs and one analog output. The
output will equal the analog input as long as it is within the range defined by the
high limit and low limit.
If the analog input exceeds the high limit, the output is set to the value of the
high limit. If the analog input is less than the low limit, the output is set to the
low limit.
If the high limit value is less than the low limit value, the high limit has priority
(that is, the output is set to the high limit, regardless of the analog input value).
High Limit
HI
Input Output
IN
Low Limit
LO
100
LIMITER
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 101
Programmer’s Guide and Reference | BACtalk Systems
Remarks The output (run time) equals the total accumulated time, in hours,
that the binary input has been ON. Run time increases by 1 for each hour that the
input has been ON. The AV is written to only when an additional hour of run
time has accumulated.
No te This is the only VLC DDC function that can write to an EEPROM-stored
AV in C3-series VLCs.
Input Output
100
RUNTIME
ACCUMULATOR
102 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Remarks A straight line relationship (of the form y = a + bx) determines the
output as a function of the input.
When input = IN1, output = OUT1, and when input = IN2, output = OUT2. You
can use this function to convert degrees Fahrenheit to degrees Celsius, using the
following values for IN1, OUT1, IN2 and OUT2:
• IN1=32
• OUT1=0
• IN2=212
• OUT2=100
Input
OUT 2
Output
OUT 1
IN 1
100
IN 2
2 INPUT SCALER
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 103
Programmer’s Guide and Reference | BACtalk Systems
Slope
S Output
Zero
Z
Input 100
LINEAR SCALER
104 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Remarks Function 47 has one analog input, one binary sample control (CTRL)
input, and an analog output. When the CTRL input is ON, the output and the
stored value are set equal to the input. When the CTRL input is OFF, the output
is set to the last stored value.
Control
Input Output
100
Delay
4.8s
Input O utput
Input of
DO M
Delay O n Make
is Negated
Control
Input Output
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 105
Programmer’s Guide and Reference | BACtalk Systems
Remarks The output turns ON only if the calculated ON time is greater than the
MON. If the output is ON, it remains ON until it has been ON for the calculated
ON time and the MON has expired. The output remains ON continuously if the
calculated OFF time is less than the MOF.
Time resolution is 1 second for VLC DDC and Global/Building controller DDC.
Input
CalculatedOnTime = CycleTime 〈 --------------〉
100.0
Input
IN
Cycle Output
CYC
Min. ON
MON
Min. OFF
MOF
100
Analog to
Binary Output
Timer
106 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
THERMAL
VALVE
MODULATOR TMV
Input Output
100
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 107
Programmer’s Guide and Reference | BACtalk Systems
Remarks Function 50 has six analog inputs and two analog outputs. The high
output will equal the value of the highest input. The low output will equal the
value of the lowest input. All inputs must be assigned.
If fewer than six inputs are needed, repeat one or more of the input assignments
to fill the remaining inputs.
Input 1
High
Input 2 Output
HI
Input 3
Input 4
Input 5 Low
LO Output
Input 6
100
HIGH/LOW SELECTOR
108 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Output = P + I + 50
where
P = Kp(E)
K
Iinc= E ⎛ ------i⎞ , which is calculated once per second. (Iinc is limited to a maximum
⎝ 60⎠
Imax
of ------------- .)
60
Iprev is I from the most recent calculation. When DDC initializes, Iprev is set to
STUP for the first DDC loop.
Proportional
Constant
Integral
Kp PI
Constant
Ki
Setpoint
SP Output
Feedback
FB
Max. Integral
Change
Integral
I max
Limit
I lim
Integral 100
Startup
STUP
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 109
Programmer’s Guide and Reference | BACtalk Systems
Output = P + I + D + 50
where
D = Kd(E – Eprev). Eprev represents the value of E from the previous pass of
DDC. D is calculated every 1 second in VLCs, global controllers, and
expandable controllers.
Proportional
Constant
Integral
Kp PID
Constant
Ki
Derivative
Component Kd
Setpoint SP Output
Feedback FB
Max. Integral
Change I max
Integral
Limit I lim
Integral
Startup STUP 100
110 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Remarks Function 54 has three analog inputs, two binary outputs, and one
analog output. The input control signal (0.0–100.0) is compared to the current
motor position (as estimated internally by the function). If the desired position is
greater than the current position by more than deadband (DB), the open motor
(OP) output will be ON. If the desired position is less than the current position by
more than DB, the close motor (CL) output will be ON. If the current position is
within DB of the input, both binary outputs will remain OFF.
The motor time (MT) input represents the time required (in seconds) for the
motor to go from fully closed to fully open. The function estimates the current
motor position (%) output based on the motor time and the cumulative ON times
of the open motor and close motor outputs.
As the motor modulates open and closed, the function-estimated motor position
will typically deviate further from the actual position. Also, the VLC assumes on
power up that the motor is fully closed and will pulse the motor open to the
currently desired position.
This means that the motor can also get out of phase with the function-estimated
position if it is driven open and a power interrupt occurs. Use the initialization
flag, which is ON only during the first DDC loop, and additional DDC to
eliminate this out-of-phase condition on power-up. When the control signal
reaches 0.0 or 100.0 and the motor is driven fully closed or open for twice the
duration of the Motor time, the estimated position is automatically recalibrated.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 111
Programmer’s Guide and Reference | BACtalk Systems
Remarks This function is the same as Function 54, with the addition of a time-
out feature. When the input remains at 0.0 for an extended period, the close
command (CL) output turns OFF Motor time (MT) seconds after the estimated
damper position is fully closed. When the input remains at 100.0 for an extended
period, the open command (OP) output turns OFF MT seconds after the
estimated damper position is fully open.
112 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Remarks The INPUT is the device instance, object, and property that will be
transferred to the present-value of the OUTPUT object. If the VLC can
successfully read the INPUT, the DATA RELIABILITY is 1 (ON), otherwise it
is 0 (OFF). NULL OUTPUT is normally 0 (OFF). If the device object being read
contains a BACnet value of NULL (empty), the NULL OUTPUT is set to 1
(ON) to indicate the DATA OUTPUT is invalid.
CA U TIO N Use the RED function to "pull" data rather than "push" it using the
WED function because troubleshooting can become complex where WED
functions are used. For example, if a VLC value changes with no apparent
explanation, and there are some WED functions used in some VLCs, the user
will need to examine the DDC in every VLC in the system to determine which
one has the WED function.
CA U TIO N When DDC is first started after being loaded or after a power cycle,
data values from RED and REDS functions will be 0 (or OFF if a binary value).
They will remain at 0 until a successful read is completed. In the event that the
RED or REDS function loses communication with the target device, the data
value will remain at the last retrieved value. You should use the data integrity
output of the RED and REDS functions in your DDC as appropriate to prevent
problems.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 113
Programmer’s Guide and Reference | BACtalk Systems
Remarks The NETWORK and MS/TP MAC specify the network and MAC
address of the external object. The INPUT is the device instance, object, and
property that will be transferred to the present-value of the OUTPUT object. If
the VLC can successfully read the INPUT, the DATA RELIABILITY is 1 (ON),
otherwise it is 0 (OFF). NULL OUTPUT is normally 0 (OFF). If the device
object being read contains a BACnet value of NULL (empty), the NULL
OUTPUT is set to 1 (ON) to indicate the DATA OUTPUT is invalid. Otherwise,
NULL OUTPUT is set to 0 (OFF).
No te If the slave device that is being read is on the same MSTP network, set
the Network number to 0 (zero).
CA U TIO N When DDC is first started after being loaded or after a power cycle,
data values from RED and REDS functions will be 0 (or OFF if a binary value).
They will remain at 0 until a successful read is completed. In the event that the
RED or REDS function loses communication with the target device, the data
value will remain at the last retrieved value. You should use the data integrity
output of the RED and REDS functions in your DDC as appropriate to prevent
problems.
114 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
CA U TIO N Use the RED function to "pull" data rather than "push" it using the
WED function because troubleshooting can become complex where WED
functions are used. For example, if a VLC value changes with no apparent
explanation, and there are some WED functions used in some VLCs, the user
will need to examine the DDC in every VLC in the system to determine which
one has the WED function.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 115
Programmer’s Guide and Reference | BACtalk Systems
Remarks The NETWORK and MS/TP MAC specify the BACnet network and
MAC where the slave device resides. The DESTINATION specifies the object,
property, and index to be written to. A write is attempted whenever the DATA
TO WRITE changes by the amount of DEADBAND from the last written value.
DATA/NULL is set to 0 (DATA) to send the value in DATA TO WRITE, and 1
(NULL) if the special BACnet NULL (empty) value is to be written. The
WRITE RELIABILITY is set to 1 (ON) when the external device acknowledges
the write. It is set to 0 (OFF) whenever the external device does not respond.
116 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 6 | DDC function reference
Remarks When Function 67: Subroutine Caller executes, the next function
executed is the sequence number specified as the Subroutine's Starting Sequence
in the Subroutine Caller setup. The Subroutine Starting Sequence must be
programmed at a sequence number higher than Function 1: End of Normal and
lower than Function 2: End of Subroutine (that is, it must be outside normal
DDC space and within subroutine DDC space). Functions execute in order until
End of Subroutine is encountered, at which point program execution returns to
the normal DDC space, beginning with the function immediately after the
Subroutine Caller.
Each Subroutine Caller can have different data points assigned. In this way, a
single DDC subroutine can execute using different data points and values, as
long as the subroutine is called with different Subroutine Callers.
NULL
NULL
TO : 5000 NULL
NULL
NULL
NULL
NULL
100 NULL
SUBROUTINE CALLER
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 117
Programmer’s Guide and Reference | BACtalk Systems
Remarks For the Data Writer, you must specify the controller I/O point (data
point) to write to. Additionally, you can set values for points to be inserted into
the device during a DDC view live data troubleshooting session.
To configure, right-click the data writer function and enter the following data.
X Data Value:
• Value - this is the value that you want to write to the controller I/O
point. What you enter here depends on your Type selection. For Real
numbers, enter any value with up to six significant digits of resolution.
For Boolean values, enter ON or OFF.
• Type - this is the type of value you want to write. Select Real to write a
real number (usually for analog values). Select Boolean to write an ON
or OFF value (usually for binary values). Select Null to write a Null
value (with Null selected, Value is unavailable).
0
VALUE
I/O Data Point
DATA WRITER
118 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Object and property reference 7
This chapter lists the objects in BACtalk unitary, global, and expandable
controllers followed by a reference to the properties of those objects. Use this list
to interpret the source and nature of system data.
Notes
• The W column indicates whether the property is writable. Properties
without a check mark in this column are read-only. Some items can only
be written to through special setup. These are checked as writable and
noted under Remarks.
• In the Example column, items in Boldface always appear as listed for that
item. For example, the object-type property of a device object will always
return the word “Device” to the Envision for BACtalk display.
• The Type column indicates a BACnet data type. Unsigned and Signed
indicate integer values; enumerated indicates an enumerated value table;
other data types may exist.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 119
Programmer’s Guide and Reference | BACtalk Systems
AO (0-7999) Analog output objects associated with physical output terminals on EXPs. AOs are identified as
AO-e0nn, where e is the EXP address (0-7) and nn is the output terminal number.
AV (0–7999) RESERVED AVs for EXP configuration, status, and backup values. Do not use these AVs for
general programming or automation. These AVs do not support the priority-array property.
AV (8000–8499) General use AVs. These AVs support the priority-array property.
BI (0-7999) Binary input objects associated with physical, universal input terminals on EXPs. BIs are
identified as BI-e0nn, where e is the EXP address (0-7) and nn is the input terminal number.
BO (0-7999) Binary output objects associated with physical output terminals on EXPs. BOs are identified as
BO-e0nn, where e is the EXP address (0-7) and nn is the output terminal number.
BV (8000-8499) General use BVs. These BVs support the priority-array property.
Calendar Describes a list of calendar dates, special event dates, holiday dates, and date ranges.
Event Enrollment Defines an event and connects the occurrence of the event to the transmission of an event
notification. Used in BACtalk primarily for alarms.
Notification Class Stores a list of available recipients for the distribution of event notifications (alarms, trendlog
gathering, and so on).
Program 1024 Stores program status information about the current DDC program.
Schedule Controls designated properties by periodic schedule that may recur during a range of dates.
description 9 Character string Return Air An editable description of the object’s location or
Temp function.
object-identifier BACnet_ Object_ AI 5 This property consists of the object-type property and the
Identifier object instance, which is a numeric code that identifies
the object of interest.
120 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
present-value 9 Real 72.3 Writable only when out-of-service = TRUE (see herein).
Range of present-value depends on input setup. See
“Setting inputs, outputs, and other function parameters”
on page 32.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
units 9 Enumerated Deg F Indicates the unit of measure for the AI, in BACnet
engineering units.
object-identifier BACnet_ Object_ AO 5 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-type Enumerated AO
out-of-service 9 Boolean FALSE TRUE decouples the present-value property from the
physical output. While TRUE, the present-value can be
changed to any value to simulate conditions for testing
without affecting the actual physical output.
present-value 9 REAL 75 Valid values are real numbers in the range 0–100.
Values greater than 100 are interpreted as 100. When
commanded, values are written to the present-value with
a priority for writing, which corresponds to a priority-
array index (see “priority-array” herein).
priority-array BACnet Priority <Array of An array of prioritized values (indexes 1-16) controlling
Array BACnet the present-value, index 1 having the highest priority.
Priority The value with the highest priority for writing controls the
Value> present-value. Possible values for priority-array indexes
are real values or NULL. A NULL value indicates no
command is issued at that priority level.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 121
Programmer’s Guide and Reference | BACtalk Systems
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
description 9 Character string Occupied A description assigned to describe the object’s function.
Setpoint
object-identifier BACnet_ Object_ AV 1 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-name Character string For reserved AVs, shows the EXP and AV of interest.
For example, EXP 0 AV 01. Otherwise shows AV
<instance>.
object-type Enumerated AV
present-value 9 Real 76.4 Range is +/−3 x 1038 (six significant digits of resolution).
status-flags Bit string <Bit string> A four-position bit string that indicates the status of the
AV. If a status bit =1, that status is TRUE.
122 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
object-identifier BACnet_ Object_ BI 10 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
out-of-service 9 Boolean FALSE TRUE decouples the present-value property from the
physical input, and the present-value does not track
further physical input changes. While TRUE, the
present-value can be changed to any value to simulate
conditions for testing. FALSE indicates that the present-
value is tracking changes to the physical input.
polarity NORMAL
present-value 9 Logical state ACTIVE ACTIVE or INACTIVE. Writable only when out-of-service
= TRUE (see herein).
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 123
Programmer’s Guide and Reference | BACtalk Systems
event-state Enumerated Normal If the object does not support intrinsic reporting, the
value will be NORMAL.
object-identifier BACnet_ Object_ BO 1 This property consists of the object-type property and the
Identifier object instance, which is a numeric code that identifies
the object of interest.
object-type Enumerated BO
out-of-service 9 Boolean FALSE TRUE decouples the present-value property from the
physical output. While TRUE, the present-value can be
changed to any value to simulate conditions for testing
without affecting the actual physical output.
present-value 9 Enumerated INACTIVE Either ACTIVE or INACTIVE. Note that a NULL value
can be written to the present-value on data displays, but
the value is actually written to a priority-array property.
The present-value is the result of the priority-array.
priority-array BACnet Priority <Array of A read-only array of prioritized values (1-16) controlling
Array BACnet the present-value, priority 1 having the highest priority.
Priority The value with the highest priority controls the present-
Value> value. Possible values for priority-array indexes are
ACTIVE, INACTIVE, or NULL. A NULL value indicates
no command is issued at that priority level.
relinquish-default 9 Enumerated INACTIVE Default value used for present-value property when all
priority-array values are NULL.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
description 9 Character string Occupied A description assigned for the object’s function.
Setpoint
inactive-text OFF
object-identifier BACnet_ Object_ BV 8413 This property consists of the object-type property and the
Identifier object instance, which is a numeric code that identifies
the object of interest.
124 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
apdu-timeout 9 Unsigned 6000 The time after transmission of an APDU until the lack of
a reply means it was assumed to be lost. The APDU
time-out value for this device in milliseconds (1000 = 1
sec). Default = 6000.
application-software- Character string VLX V1.0 Indicates the ROC file version.
version
description 9 Character string Second floor Assigned by the user to describe the device’s function.
controller
firmware-revision Character string BACtalk VLX Indicates the VLX boot code version.
v1.1 02/02/
2002
local-date 9 Date Sunday, 02/ Indicates date: day of the week, month/day/year.
24/2002 Writable through Time Sync.
local-time 9 Time 10:15:56.00 Indicates the time stored in the device. Writable through
am Time Sync.
location 9 Character string East Wing Indicates the physical location of the device.
max-apdu-length- Unsigned 1476 The maximum message packet size that the device can
accepted handle.
max-info-frames 9 Unsigned 60 Number of MS/TP messages the device will send per
token hold. Default = 60. Max. = 200.
max-master Unsigned 127 Highest MAC address (above this unit's) that another
MS/TP master should be set to.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 125
Programmer’s Guide and Reference | BACtalk Systems
object-identifier BACnet_ Object_ Device 200 This property consists of the object-type property and
Identifier the device instance, which is a numeric code that
identifies the device of interest.
object-name Character string Controller No two devices are permitted to have the same object
200 name.
protocol- Unsigned 3 Integer from 1–6 indicating the conformance class of the
conformance-class device. A device must support a standardized set of
services and object types to claim a particular class
conformance.
protocol-object-types- Bit string <Bit string> An internally used bit string. Indicates which BACnet
supported object types reside in the device.
protocol-services- Bit string <Bit string> An internally used bit string. Indicates which BACnet
supported services the device can process.
description 9 Character string Event A description assigned to describe the object’s function.
enrollment 0
event-enable 9 bit string To-offnormal Indicates whether notifications are enabled for these
=1 , To-fault event transition types. A 1 indicates that the transition
= 1, To- will be reported. Set in the Event Enrollment Editor at the
normal = 1 operator workstation.
126 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
event-type 9 Enumerated CHANGE_OF Indicates the type of event algorithm to be used to detect
_BITSTRING events.
notify-type Unsigned alarm Indicates whether the object is set up for alarms or
events.
object-identifier BACnet_ Object_ Event- This property consists of the object-type property and
Identifier enrollment the Object Instance, which is a numeric code that
0 identifies the object of interest.
object-property- 9 Boolean FALSE Indicates whether the file has been saved for backup.
reference
object-type Event-
enrollment
description 9 Character string VLX ROC A description assigned to describe the object’s function.
File
modification-date Time 4/29/1997 The date and time the file was last modified.
10:22:20:00a
object-identifier BACnet_ Object_ file 0 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
read-only Boolean TRUE Indicates whether the file can be written to by BACnet
services.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 127
Programmer’s Guide and Reference | BACtalk Systems
object-identifier BACnet_ Object_ Notification This property consists of the object-type property and the
Identifier -class 1 object instance, which is a numeric code that identifies
the object of interest.
recipient-list 9 List <List of Lists the devices that will receive notification when the
BACnet notification class transitions. Set up at the operator
Destination> workstation.
priority 9 Array of Unsigned Indicates the priority to be used for event notifications for
TO-OFFNORMAL, TO-FAULT, and TO-NORMAL
events, respectively.
instance-of Character string alerton hq Header information for the file. Program 0 does not
alerVLX support this property.
0*00000000*
object-identifier BACnet_ Object_ program This property consists of the object-type property and
Identifier 1024 the object instance, which is a numeric code that
identifies the object of interest.
program-change 9 Enumerated READY Used to command the program state. A program can be
stopped using the HALT command, for example, and
started again with RESTART.
128 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
list-of-object-property- 9 List <List of The list of objects that this schedule commands.
references BACnet
Object
Property
Reference>
object-identifier BACnet_ Object_ schedule 0 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-name 9 Character string schedule Assigned in schedule setup at the operator workstation.
000
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 129
Programmer’s Guide and Reference | BACtalk Systems
Notes
• The W column indicates whether the property is writable. Properties
without a check mark in this column are read-only. Some items can only
be written to through special setup. These are checked as writable and
noted under Remarks.
• In the Example column, items in boldface always appear as listed for
that item. For example, the object-type property of a device object will
always return the word “Device” to the Envision for BACtalk display.
• The Type column indicates a BACnet data type. Unsigned and Signed
indicate integer values; enumerated indicates an enumerated value table;
other data types may exist.
130 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
BV (0–999) Binary values. These BVs support the priority-array property. ACTIVE or INACTIVE
Demand Limiter Proprietary Alerton object for demand limiting function. 0-100 (ramp value)
Event Enrollment Defines an event and connects the occurrence of the event
to the transmission of an event notification. Used in BACtalk
primarily for alarms.
File 1024 Stores file information about the current DDC program.
Notification Class Stores a list of available recipients for the distribution of event
notifications (alarms, trendlog gathering, etc.).
Program 1024 Stores program status information about the current DDC
program.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 131
Programmer’s Guide and Reference | BACtalk Systems
description 9 Character string Occupied A description assigned to describe the object’s function.
Setpoint
object-identifier BACnet_ Object_ AV 1 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-type Enumerated AV
status-flags Bit string <Bit string> A four-position bit string that indicates the status of the
AV. If a status bit =1, that status is TRUE.
object-identifier BACnet_ Object_ BV 1 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
132 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
description 9 Character string Holidays A description assigned to describe the object’s function.
1997
object-identifier BACnet_Object_ calendar 1 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
present-value 9 Boolean FALSE TRUE if the current date is in the date list; FALSE if it is
not.
object-type BACnet_Object_
Type
aler-meter-inputs 9 BACnet Array 1 of <List of The list of meter inputs to the demand limiter. Currently
BACtalk Meter Input meter limited to one meter input.
inputs>
aler-instantaneous- Real Reflects the current reading from the meter (after
demand applying conversion factors).
aler-ramp-control 9 BACtalk Device The input that identifies the ramp parameters.
Object Property
Reference or Value
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 133
Programmer’s Guide and Reference | BACtalk Systems
aler-active-ramp Real The current ramp value (0-100%) being used to control
loads. This value will be between zero and the
Aler_Ramp_Value. The exact value depends on
whether the demand limiter object is enabled or
disabled.
aler-binary-load- List of BACtalk The status of each binary and custom binary load.
status Demand Load
Status
aler-total-binary-loads Unsigned The total number of binary and custom binary loads.
aler-binary-loads- Unsigned The total number of binary and custom binary loads that
shed have been shed.
aler-analog-loads- Unsigned The total number of analog loads that have been shed.
in-shed
aler-recent-history List of BACtalk A list of historical data with the most recent data first.
Demand History
Sample
134 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
APDU-timeout 9 Unsigned 3000 The time after transmission of an APDU until the lack
of a reply means it was assumed to be lost. The APDU
timeout value for this device in milliseconds (1000 = 1
sec).
description 9 Character string Second floor Assigned by the user to describe the device’s function.
controller
local-date Octet String Wednesday, Indicates date: day of the week, month/day/year.
5/14/1997
location 9 Character string East Wing Indicates the physical location of the device.
max-APDU-length- Unsigned 1476 The maximum message packet size that the device
accepted can handle.
max-info-frames 9 Unsigned 200 Number of MS/TP messages the BTI will send per
(maximum token hold.
number)
max-master Unsigned 127 The highest MS/TP MAC address the BTI will attempt
to pass the token to.
model-name Character string BTI Controller Assigned by the vendor to indicate the device model.
object-identifier BACnet_ Object_ Device 200 This property consists of the object-type property and
Identifier the device instance (a numeric code that identifies the
device) of the device of interest.
object-name Character string Controller 200 No two devices are permitted to have the same object
name.
protocol-object-types- Bit string <Bit string> An internally used bit string. Indicates which BACnet
supported object types reside in the device.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 135
Programmer’s Guide and Reference | BACtalk Systems
136 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
description 9 Character string Event A description assigned to describe the object’s function.
enrollment 0
event-enable 9 Bitstream To-offnormal Indicates whether notifications are enabled for these
=1 , To-fault event transition types. A 1 indicates that the transition
= 1, To- will be reported. Set in the Event Enrollment Editor at the
normal = 1 operator workstation.
event-parameters Time <BACnet Determines the method used to monitor the referenced
Event object.
Parameter>
event-state Boolean TRUE Indicates whether the file can be written to by BACnet
services.
notify-type Unsigned alarm Indicates whether the object is set up for alarms or
events.
object-identifier BACnet_ Object_ Event- This property consists of the object-type property and
Identifier enrollment 0 the object instance, which is a numeric code that
identifies the object of interest.
object-property- 9 Boolean FALSE Indicates whether the file has been saved for backup.
reference
object-type event-
enrollment
priority Unsigned 9 Priority for issuing event notifications. Set in the Event
Enrollment Editor at the operator workstation.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 137
Programmer’s Guide and Reference | BACtalk Systems
description 9 Character string BTI ROC A description assigned to describe the object’s function.
File
modification-date Time 4/29/1997 The date and time the file was last modified.
10:22:20:00
a
object-identifier BACnet_ Object_ file 0 This property consists of the object-type property and the
Identifier object instance, which is a numeric code that identifies
the object of interest.
read-only Boolean TRUE Indicates whether the file can be written to by BACnet
services.
object-identifier BACnet_ Object_ Notification- This property consists of the object-type property and
Identifier class 1 the object instance, which is a numeric code that
identifies the object of interest.
recipient-list 9 List <List of Lists the devices that will receive notification when the
BACnetDesti notification class transitions. Set up at the operator
nation> workstation.
to-fault-priority Unsigned Indicates the priority used for event notifications, 0–255.
Lower numbers indicate a higher priority.
to-normal-priority Unsigned Indicates the priority used for event notifications, 0–255.
Lower numbers indicate a higher priority.
to-offnormal-priority Unsigned Indicates the priority used for event notifications, 0–255.
Lower numbers indicate a higher priority.
138 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
instance-of Character string alerton hq Header information for the file. Program 0 does not
alerbti support this property.
0*00000000
*
object-identifier BACnet_ Object_ program This property consists of the Object_Type property and
Identifier 1024 the Object Instance, which is a numeric code that
identifies the object of interest.
program-change 9 Enumerated READY Used to command the program state. A program can be
stopped using the HALT command, for example, and
started again with RESTART.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 139
Programmer’s Guide and Reference | BACtalk Systems
list-of-object-property- 9 List <List of The list of objects that this schedule commands.
references BACnet
Object
Property
Reference>
object-identifier BACnet_ Object_ schedule 0 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-name 9 Character string schedule Assigned in schedule setup at the operator workstation.
000
object-name 9 Character string Assigned during zone setup at the operator workstation.
aler-weekly-schedule- Array [n] of This array works exactly like a priority array and allows
inputs BACnetPriorityValue up to [n] schedule objects to write weekly schedule
commands to the zone.
aler-weekly-schedule- 9 Array [n] of An array that points to the schedule objects used for
object BACtalkOptionalDev weekly schedules.
ObjRef
140 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
aler-event-schedule Array [n] of This array works exactly like a priority array and allows
-inputs BACnetPriorityValue up to [n] schedule objects to write weekly schedule
commands to the zone.
aler-event-schedule 9 Array [n] of An array that points to the schedule objects used for
-objects BACtalkOptionalDev event schedules.
ObjRef
present-value 9 BACtalkZoneState Occupied Alerton Enumerated type that reflects the current state of
the zone: Occupied, Unoccupied, Warmup, Cooldown,
or Tenant Override.
units 9 BACnetEngineering A value that indicates the unit of measure for all
Units temperatures in the zone object.
aler-oa-temp-reference BACtalkDevObjProp The reference that indicates the outside air temperature
RefOrValue to use in optimum start calculations.
aler-oa-limit 9 Real 65.0 A real value used in optimum start calculations for
heating operations. The default value is 65.0.
aler-building-mass 9 Real 4.0 A real value that indicates the amount of desired
temperature change. Values are limited between 0-10.
aler-warmup-factor Real 1.0 A real value used in warmup calculations for a zone.
This value is adjusted each time warmup mode is
initiated. Valid range is 0-10. A 0 (zero) disables warmup
calculations.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 141
Programmer’s Guide and Reference | BACtalk Systems
aler-alt-warmup-factor Real An alternate value used for the warmup factor when the
zone was not occupied during the previous 24 hours. Set
to NULL to disable alternate warmup.
aler-alt-cooldown- Real An alternate value used for the cooldown factor when
factor the zone was not occupied during the previous 24 hours.
Set to NULL to disable alternate cooldown.
aler-tuning-factor Real A real value that determines how aggressive the system
should self-tune the warmup and cooldown factors.
aler-cooling- Real A real value that indicates the rate (in degrees per hour)
temperature-rate that the cooldown mode is expected to change the
temperature of the zone when in manual optimum start
mode.
aler-heating- Real A real value that indicates the rate (in degrees per hour)
temperature-rate that the warmup mode is expected to change the
temperature of the zone when in manual optimum start
mode.
aler-occupied- BACnetBinaryPV active Active is written to this value when the zone is occupied.
command-value If the zone is unoccupied or in warmup or cooldown
mode, Inactive is written to this value.
aler-occupied- BACtalkDevObjProp
command-reference RefOrValue
aler-warmup- BACnetBinaryPV Active is written to this value when the zone is in warmup
command-value mode. Otherwise, Inactive is written.
aler-warmup- BACtalkDevObjProp
command-reference RefOrValue
aler-cooldown- BACtalkDevObjProp
command-reference RefOrValue
aler-occupied-heating- BACtalkDevObjProp
setpoint-reference RefOrValue
aler-occupied-cooling- BACtalkDevObjProp
setpoint-reference RefOrValue
aler-tenant-override- BACnetBinaryPV
value
aler-tenant-act- BACnetRecipient Indicates the device to which tenant override events are
recipient sent. A NULL value prevents tenant override events from
being sent.
142 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
zone-main-truth-table Array [3] of Indicates the value to be written to each of the three
BACtalkZoneTruth main output points for each of the four possible modes of
TableEntry operation. The array elements are mapped as follows.
Element 1= Defines the values written to aler-occupied-
command-reference.
Element 2= Defines the values written to aler-warmup-
command-reference.
Element 3= Defines the values written to aler-cooldown-
command-reference.
Even though each entry is the table is a
BACnetPriorityValue type, only Unsigned values may be
written to the table elements. In all cases, the zone
object writes values of the correct data type (unsigned
for multistate mode and BinaryPV in all other cases)
when sending commands.
If a property reference is NONE, then the corresponding
array element is ignored. It is good practice to write a
zero into the array element in this case.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 143
Programmer’s Guide and Reference | BACtalk Systems
BACtalk VLCs
This section lists the objects in a BACtalk VLC, followed by a reference to the
properties of those objects. Use this list to interpret the source and nature of
system data.
Notes
• The W column indicates whether the property is writable. Properties
without a check mark in this column are read-only. Some items can only
be written to through special setup. These are checked as writable and
noted under Remarks.
• In the Example column, items in boldface always appear as listed for
that item. For example, the object-type property of a device object will
always return the word “Device” to the Envision for BACtalk display.
• The Type column indicates a BACnet data type. Unsigned and Signed
indicate integer values; enumerated indicates an enumerated value table;
other data types may exist.
144 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
Objects in VLCs
Ta ble 40 Objects in BACtalk VLCs
AI 99 In Gen4 VLCs, AI-99 When the supply voltage connected to the VLC
represents the unregulated DC is 24 VAC, AI-99 will have a value of 40.6 VDC.
voltage resulting from The value of AI-99 is filtered in software to
rectification of the 24 volt AC screen out electrical noise. AI-99 varies
supply voltage. proportionally with the voltage of the 24 VAC
supply power to the VLC, which in turn is
proportional to the supply voltage to the
transformer. AI-99 can be used in DDC to
detect brownouts and limit operation of
compressors or other voltage sensitive
equipment if appropriate. You can also set up
trendlogs for AI-99 to track longer term
variations in power supply voltage.
AI inputs are scanned just prior to every 0.1
second pass of DDC.
AI (100-107) Diagnostic AIs to aid in Only the Present Value of these objects is
troubleshooting available. These Present Value properties can
be viewed by placing a read-only item on a
data display. The properties cannot be used in
DDC.
AI inputs are scanned just prior to every 0.1
second pass of DDC.
AO (0-7) Physical analog output. 0–100 AO present-value property is the result of the
priority array.
AO outputs are refreshed every 0.1 second
following each DDC pass. The Present Value
is resolved from its priority array at this time.
When a write to the output occurs during DDC,
the Present Value of the object is not affected
until after the DDC pass is complete.
AV (0-107) Real numbers not directly ±3 x 1038 Six significant digits of resolution. All AVs are
associated with physical input used in RAM and backed up in Flash memory
or output terminals. Typically on loss of power.
used for setpoints and
IMPORTANT NOTE: 90–107 reserved for
intermediate calculations. Microset use. In C3 VLCs, AVs 0–49 stored in
VLC RAM, and 50–89 stored in VLC EEPROM.
AV (250-255) Provide read/write access to 0-102.3 These objects only have a Present Value
airflow calibration data in VAV- property. No other properties are available.
series VLCs. See Table 8 on page 50.
BI (0-15) Associated with physical input ACTIVE or INACTIVE BIs correspond to the same input terminals as
terminals. Number of inputs AIs. BI-1 corresponds to input terminal IN-1,
varies with VLC model. and so ON. The BI turns ON when the
associated AI drops to a value in counts less
than or equal to 448. It reads OFF when the AI
rises to a value in counts greater than or equal
to 512. The BI does not change state while the
value is in the range 449–512.
BI inputs are scanned just prior to every 0.1
second pass of DDC.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 145
Programmer’s Guide and Reference | BACtalk Systems
BV (0–84) Binary value. ACTIVE or INACTIVE BV 0-63 are for general use. BV 64-84 are
reserved for Microset control.
BV 40 is refreshed every 0.1 second following
each pass of DDC. The Present Value is
resolved from its priority array at this time.
When a write to the output occurs during DDC,
the Present Value of the object is not affected
until after the pass of DDC is complete.
146 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
object-identifier BACnet_ Object_ AI 5 This property consists of the object-type property and the
Identifier object instance, which is a numeric code that identifies
the object of interest.
reliability BACnet_ Reliability NO FAULT Other possibilities are OVER RANGE, UNDER RANGE,
DETECTED UNRELIABLE_OTHER.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
object-identifier BACnet_ Object_ AO 1 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-type Enumerated AO
out-of-service Boolean FALSE Options are TRUE or FALSE. If TRUE, the physical
output is de coupled from the AO and its present-value,
and internal DDC execution alone determines the status
of the physical output.
present-value 9 REAL 75 Valid values are real numbers in the range 0–100.
Values greater than 100 are interpreted as 100. When
commanded from a data display, values are actually
written to the priority array (see priority-array entry
herein) and read back from the present-value for
display.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 147
Programmer’s Guide and Reference | BACtalk Systems
reliability BACnet_ Reliability NO FAULT Other possibilities are OVER RANGE, UNDER RANGE,
DETECTED UNRELIABLE_OTHER.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
148 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
present-value 9 Real 0.02 Real number in the range ± 3 x 1038 with six significant
digits of resolution.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
object-identifier BACnet_ Object_ BI 10 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
polarity NORMAL
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 149
Programmer’s Guide and Reference | BACtalk Systems
event-state Enumerated Normal If the object does not support intrinsic reporting, the
value shall be NORMAL.
object-identifier BACnet_ Object_ BO 1 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
object-type Enumerated BO
out-of-service Boolean FALSE Options are TRUE or FALSE. If TRUE, the physical
output is de coupled from the BO and its present-value,
and internal DDC execution alone determines the status
of the physical output.
present-value 9 Enumerated INACTIVE Either ACTIVE or INACTIVE. Note that a NULL value
can be written to the present-value on data displays, but
the value is actually written to a priority-array property.
The present-value is the result of the priority-array.
reliability BACnet_ Reliability NO FAULT Other possibilities are OVER RANGE, UNDER RANGE,
DETECTED UNRELIABLE_OTHER.
relinquish-default 9 Enumerated INACTIVE Default value used for present-value property when all
priority-array values are NULL. Set up in DDC or
VisualLogic.
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
object-identifier BACnet_ Object_ BV 20 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
150 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
status-flags Bit string In alarm = 0, A four-position bit string that indicates the status of the
fault = 0, object. If a status bit =1, that status is TRUE.
overridden =
0, out of
service = 0
description Character string Generic Data from program information in the DDC header.
Generic
v0011
modification-date Time Wednesday, Date and time that the DDC file was downloaded to the
5/29/1997 VLC.
10:22:20:00
a
object-identifier BACnet_ Object_ file 0 This property consists of the object-type property and
Identifier the object instance, which is a numeric code that
identifies the object of interest.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 151
Programmer’s Guide and Reference | BACtalk Systems
application-software- Character string BTI Controller V3.20 Indicates the ROC version.
version
description 9 Character string Mechanical Room An editable description that identifies the
BTI device’s location or function.
firmware-revision Character string BACtalk BTI v3.2 Indicates the firmware version.
11/17/2002
local-date 9 Octet String Wednesday, 5/14/ Indicates date: day of the week, month/day/year.
2002
location 9 Character string East Wing Indicates the physical location of the device.
max-APDU-length- Unsigned 206 The maximum message packet size that the
accepted device can handle.
max-master Unsigned 127 The highest MS/TP MAC address the VLC will
attempt to pass the token to.
model-name Character string VLC Controller Assigned by the vendor to indicate the device
model.
object-identifier BACnet_ Object_ Device 200 This property consists of the object-type property
Identifier and the device instance of the device of interest.
object-name 9 Character string Device 200 No two devices are permitted to have the same
object name.
protocol-object-types- Bit string <Bit string> A bit string that indicates the BACnet object
supported types that reside in the device. A 1 indicates the
device is present.
protocol-services- Bit string <Bit string> A bit string that indicates the BACnet services
supported the device can process. A 1 indicates that
service is supported.
152 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 7 | Object and property reference
object-identifier BACnet_ Object_ program 0 This property consists of the object-type property
Identifier and the object instance, which is a numeric code
that identifies the object of interest.
program-change 9 Enumerated READY One can use this property to manipulate the
Program State property. Doing this is not
recommended.
reliability BACnet_ Reliability no fault detected Other possibilities are OVER RANGE, UNDER
RANGE, UNRELIABLE_OTHER.
status-flags Bit string In alarm = 0, fault = A four-position bit string that indicates the status
0, overridden = 0, of the object. If a status bit =1, that status is
out of service = 0 TRUE.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 153
Programmer’s Guide and Reference | BACtalk Systems
154 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Scaling factors 8
Input scaling refers to the conversion of an electrical signal from an input device to
some useful range, whatever that range is for your application: 0-100 %RH, 50-100
deg. F or 0-10 deg. C, -0.1 to 0.1 inches WC for static air pressure, and so on.
There are three key elements at work during this conversion: the electrical signal,
the raw counts, and the scaled input value.
Analog input signals to a VLC are fed into an analog-to-digital (A/D) converter in
the VLC. The A/D converts this into a binary number, which is the foundation for
the raw counts. This is necessary so the microprocessor and other components on
the VLC can interpret the signal. Software in the VLC then converts the raw counts
to a usable range, what you see in Envision for BACtalk as the present-value of an
analog input (AI).
When setting up inputs from the Analog Input Setup tab of the Device Settings
dialog box in VisualLogic, choose "Scaled (Two Point)" from the Type drop-down
menu. The Two Point Scale Setup dialog box opens, enabling you to enter two mA
or voltage values along with the desired AI values.
Select "5.12V w/jumper or switch" for all Gen4 VLCs that include an input jumper
or switch and select "5.12V no jumper or switch" for all Gen4 VLCs that do not
have an input jumper or switch. The input scaling utility automatically calculates
the correct values for zero and range.
VAV-SD VAVi-SD
VAV-DD VAV-DD7
VAV-SD2A VLC-660R
VLC-651R VLC-16160
VLC-1188 VLC-853
VLC-550 VLC-1600
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 155
Programmer’s Guide and Reference | BACtalk Systems
156 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
DDC header file setups in VLC DDC 9
Each VLC has a header file with information about the VLC’s configuration and
addressing. The header is part of the DDC program.
2. From the VLC DDC Main menu, choose F2 DDC, and then choose F2
Edit DDC Header.
The Program Information screen (F1 Program Information from the DDC Header
menu) gives you data about the currently viewed DDC file. This file information
helps you identify the origin of the DDC file for troubleshooting. Use the mouse to
position the cursor in the field you want to change, press Enter, and then type the
settings you want according to the following guidelines.
Representative and Job The representative and job name under which the file
was saved on the operator workstation hard disk. You must have security to
modify, save, or send DDC files with a given representative and job name.
Program The file name (minus the file extension) of the DDC program when it
was saved to disk.
Revision A revision number for the DDC program, which is typically important
only for Alerton Standard DDC files. This revision number can also be used by any
DDC author to manage versions of custom DDC.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 157
Programmer’s Guide and Reference | BACtalk Systems
AI setup
The Analog Input Setup screen (F2 AI from the DDC Header menu) is where
you perform scaling options for AIs. Use this screen to designate the type of
scaling you want to use for an input or the type of thermistor connected to the
input.
These setup factors affect the software count that results from a given electrical
input.
Setting the AI type and scaling factors In the Type field of the AI Setup
screen, you can select one of the following:
• The zero and range options apply only to scaled input types. No
additional scaling is required for 3K ohm and 10k ohm thermistor AIs.
• For any AI set up as a thermistor, the input will be configured
automatically to degrees F or degrees C as appropriate for the selection
of English or Metric units.
• Use F10 to view setup parameters for additional inputs.
• The scaling options you select are saved with the DDC as part of the
DDC header.
Scaling example 1 A 0-10VDC pressure transducer with a range of 0”-4” water
column (WC) is used to measure duct static pressure. The value for range is
calculated as the value of AI with an input of 10VDC (input count = 4095) minus
the value of AI with an input of 0VDC (input count =0). Range = 4”. The value
for zero is the value of AI when the input is 0. Zero = 0”.
158 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 9 | DDC header file setups in VLC DDC
In this example, however, the transducer output only goes down to 4mA, not
0mA. The challenge is to figure out what the pressure range would be if the
sensor output went all the way from 0mA to 20mA. Since the 16mA change
from 4mA to 20mA corresponds to pressure range of 0.5" (0.25" to -0.25"
=0.5"), a 20mA would theoretically correspond to a pressure range of 0.625"
(20/16 x 0.5). The value for range in this example is then equal to 0.625”. To
calculate and enter values for range, AI, and input at 20mA, 0.25” = zero + (4000
x 0.625)/4096. Zero is then equal to -.375”.
Using input filters VLCs use a 10-bit A/D converter, which is very responsive
to changes in electrical signals. This makes the inputs of the VLCs extremely
sensitive to minute changes, which may or may not be desirable.
You can turn filtering ON and OFF by placing the cursor in the Filter field for an
AI and pressing Enter to toggle the value.
The filter calculation is performed every 0.1 seconds and is expressed as:
NewCount 31
FilteredCount = --------------------------- + ------ 〈 PreviousCount〉
32 32
English/Metric Mode setup VLCs support English or metric units. Once set up
from the AI Setup screen in the DDC header, the VLC makes all of its
calculations and writes to the Envision for BACtalk displays and Microset
display.
Having the unit of measure specified in the DDC header enables DDC programs
to individually accommodate different measurement systems.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 159
Programmer’s Guide and Reference | BACtalk Systems
AV setup
In the AV Setup screen (F3 AV from the DDC Header menu), you determine the
units property of all the AV objects present in the VLC. The units property has
no effect on the present-value of the AV. For most applications, it is unnecessary
to set up units unless you use the property on a display.
No te You can also press Enter in the Units field and type the engineering unit
code directly.
4. Position the cursor in the Units field for the AV you want to configure.
5. Press F5 to view a list of engineering unit codes and descriptions.
7. Position the mouse pointer on the unit code you want to use and click
once.
On the AV Setup screen, the unit type you selected appears in the Units
field.
BO setup
In the BO Setup screen (F4 BO from the DDC Header menu), you configure two
important features for each BO—the relinquish-default and the out-of-service
property. The relinquish-default and out-of-service properties relate to the
priority-array.
Options are ACTIVE (ON) and INACTIVE (OFF). Position the cursor in this
field for the BO you want to configure, and then press Enter to toggle between
ACTIVE and INACTIVE.
160 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 9 | DDC header file setups in VLC DDC
array. Position the cursor in the Out of Service field for the BO you want to
configure, and then press Enter to toggle between TRUE and FALSE.
AO setup
The AO Setup screen (F5 AO from the DDC Header menu) allows you to
configure the units, out-of-service property, and relinquish-default for AOs. The
relinquish-default and out-of-service properties relate to the priority-array.
No te Set the units property of the AO as you do for AVs. See “AV setup” on
page 160 for details.
Entry Identifies the entry and can’t be edited. In Field Service mode, entry 0
appears first, entry 25 appears last.
Point ID Defines the VLC data point whose value will be associated with the
display code. AI, BI, AO, BO, AV, and BV are acceptable point types. Position
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 161
Programmer’s Guide and Reference | BACtalk Systems
the cursor in this field, press Enter, and then type an acceptable point type. Press
Enter again and type the point’s instance (for AI 1, type 1, for example). Make
sure the point you reference actually exists in the VLC.
Writable Determines whether the value will be writable from the Microset
(YES) or read only (NO). Position the cursor in the field and press Enter to
toggle the value. AIs and BIs are not writable.
Decimal Determines whether the Microset will show the value with a decimal
(YES) or without one (NO). Position the cursor in this field and press Enter to
toggle the value.
Positive only Determines whether only positive values can be displayed (YES)
or negative values as well (NO). Position the cursor in this field and press Enter
to toggle the value.
Program Units Determines how the VLC interprets 10K ohm and 3K ohm
thermistor inputs as well as Microset- and Microtouch-related objects. For VAV
controllers, if program units are set to metric, enter box size in cm; the device
then reports flow in liters per second (lps).
2. In the English/Metric mode field, press the tab key to toggle between
English and Metric.
162 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 9 | DDC header file setups in VLC DDC
DDC Read Inhibit Some users may want to protect the DDC file in the VLC.
You can do this by preventing reads of the DDC file.
CA U TIO N Be sure to back up your DDC file before setting this option. There
is no workaround to this protection once it has been set. You must download a
new DDC file.
2. In the DDC Read Inhibit field, press the tab key to toggle between
Reads Allowed and Reads Inhibited.
No te You can also adjust the values for the hot duct and cold duct calibration
factors from the BACtalk Microset using the Microset Airflow Calibration
mode.
This is a one-time setup you perform for each VAV VLC; the setup is stored in
the VLC independently of DDC or header information. This configuration
affects the values that represent airflow for VAV VLCs.
No te The program units setting (English or metric) in the Analog Input Setup
screen (see “AI setup” on page 158) determines whether AIs report airflow in
cfm or lps, and whether temperatures are reported in degrees F or C.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 163
Programmer’s Guide and Reference | BACtalk Systems
4. Position the cursor in the field you want to edit, press Enter, and then set
parameters according to the following guidelines.
164 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009
Chapter 9 | DDC header file setups in VLC DDC
Box diameter The box diameter of the VAV box to be controlled by this VLC.
Enter this value in inches or centimeters as appropriate for English or metric
setup in the AI Setup screen (see “AI setup” on page 158). Obtain box diameter
data from the VAV box manufacturer. The box diameter represents the round
duct equivalent diameter of the duct where the pressure pickup is located.
Calibration factor Adjusts the VLC airflow readings to match the specific VAV
box, airflow pickup, and conditions of an installation. Increasing the value of the
calibration factor will increase the value of the corresponding airflow (AI-8 for
hot duct flow, if applicable; AI-10 for cold duct flow).
The calibration factor for each duct should be adjusted until the corresponding
airflow matches the airflow measured using a balancing hood. The default value
for the calibration factor, 1.00, accounts for no pressure loss in the tubes.
Increase the calibration factor to compensate for tube loss.
Velocity zero cutoff This value is entered in percent of full airflow (0-100).
Airflows lower than the cutoff are reported as zero. This feature eliminates non-
zero airflow readings due to ambient fluctuations when the main fan is off.
© Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009 165
Programmer’s Guide and Reference | BACtalk Systems
166 © Honeywell International Inc. All Rights Reserved. LTBT-TM-PRGRMR Rev. 0009