LTBT TM Admin30
LTBT TM Admin30
Contents
About Envision for BACtalk and this guide 5
What’s new? 5
Using this guide 7
For more BACtalk information 9
For SQL Server information 9
Installation and upgrade quick steps 10
Important considerations: read this first 10
Quick steps–new Envision for BACtalk installation 12
Quick steps–upgrading single operator workstation sites 13
Quick steps–upgrading client/server sites 15
Quick steps–upgrading stand-alone controller sites 17
Installation detail 18
Documenting address numbering 18
Installing Visio 19
Compacting a BACtalk job database 19
Backing up BACtalk job data 20
Running the Envision for BACtalk installation program 21
Installing the Alerton/Honeywell BACtalk Driver 21
Configuring the Local Administrator 23
Installing the BACtalk software license key 24
Upgrading real-time operating code (ROC) 27
Client/server setup 29
Setting up a client/server relationship 29
Configuring servers and clients for a NAT environment 32
Setting up a large wide area network (WAN) 33
Connecting sites running different software versions 35
Scenario 1: Temporary connections 35
Scenario 2: Remote alarm logging 35
Scenario 3: Remote connections for point data exchange and
log gathering 36
Job setup and engineering 37
Local Administrator security scheme and directory structure 37
Saving displays and DDC 38
Logging in for the first time 40
Creating a default job 40
Using BACtalk for Windows job data in Envision for BACtalk 41
Verifying General System Setup 46
Creating user profiles 47
Understanding Device Manager 50
Defining device profiles 51
Populating the Device Manager table 61
Configuring controllers remotely 64
Renumbering VLCs 72
Assigning Alerton Standard applications to controllers 74
Envision for BACtalk v3.0 system requirements 76
Recommended system specifications 76
Minimum system requirements 77
BACtalk software license keys 78
Network key behavior 80
Remote site key behavior 80
Host device and automation feature compatibility 80
Sharing data displays in a client/server network 81
Verifying the client/server relationship 83
From the Envision for BACtalk operator workstation, operators can access any
BAS data made available on the network using the BACnet protocol standard—
even if it originates in another manufacturer’s device. Developers can use the
Envision for BACtalk operator workstation to program custom direct digital
control (DDC) sequences that run locally in BACtalk controllers. They can also
configure other site operational details.
What’s new?
Envision for BACtalk v3.0 supports the following added features and
functionality:
BACtalk. Version 3.0 ships with the new Trendlog List Report (Add-ins
> Setup Reports > Trendlog).
• Multiple Trendlog Viewer Now supports wild card searches for
improved search results.
• VisualLogic v3.0 Enhanced user interface and toolkit. Compatible with
existing DDC drawings. Use with Visio 2007 or Visio 2010. Visio
2010* recommended. New features include:
• New Toolkit combines all tools into a dockable window that supports
auto-hide and is available on every drawing page—reduces DDC
development and testing time.
• New Compare feature allows you to compare two DDC drawings and
print a report of the differences—saving critical time for troubleshooting
warranty issues and service calls.
• New Auto Sequence DDC feature automatically sequences DDC as you
place functions on the drawing—saving DDC development time
• New Auto Connect DDC feature automatically connects functions as
you place functions on the drawing —saving time in developing DDC
• New Auto Edit DDC feature automatically opens function for editing
parameters when you place functions on the drawing—saving DDC
development time
• New Auto Propagate DDC feature automatically propagates parameters
when you connect DDC functions on a drawing—saving DDC
development time
• New Find and Replace feature saves DDC editing time
• Cross Reference Table can be sorted by columns—saving DDC editing
and troubleshooting time
• Cross Reference Table supports Object Name property —saving DDC
editing and troubleshooting time (BD6 DDC file only)
• Cross Reference Table object description column displays the point
description and the point type-instance. The format is <BACnet point
description property> (<point type-instance>). For example, Space
Note If you are running BACtalk for Windows v3.02 or v2.33, you must first
upgrade to v3.1x (available from Alerton) before attempting to upgrade to
Envision for BACtalk v3.0. See “Important considerations: read this first” on
page 10 for more information. The BACtalk database structure was changed for
Envision for BACtalk versions 2.5, 2.6 and 3.0. Once a database is converted it
cannot be converted back.
Quick steps
After you identify the type of installation or upgrade you need to perform, start
with the quick steps for your installation type. Quick steps provide an overview
of the procedures you need to follow, with references to detailed instructions
later in this guide.
Installation detail
It is highly recommended that you read the detailed instructions. If you’re unsure
how to perform an operation, the detailed installation instructions will help.
Even if you’re an expert user who is familiar with BACtalk systems, you will
benefit from reading the detailed instructions.
Appendix
The appendix contains additional background and reference information on
topics including system requirements, software license keys, feature
compatibility, and sharing data displays across a network.
Note Upgrading from Envision for BACtalk v2.x to v2.6 or later with
Enterprise support (SQL Server) may take a long time due to the database
conversion.
How do I configure the What do I need to I need detailed What are some of the Are there some general
Envision for BACtalk know before I set up information about a considerations I need to guidelines or tips on
software? and use this feature? specific dialog box or think about before I start good data display
window. creating a DDC program? design?
How do I set up and How do I change the I need some help What do I need to know What are the steps for
engineer a job? settings for a feature figuring out what to before I begin using creating a new data
if it’s not working as I enter in this field on a VisualLogic? display?
expected? dialog box.
How do I enter or change I need an example of What are the steps What are BACnet objects How do I use Alerton
information in Device how I might use this for using a particular and properties? templates when
Manager? feature. feature? creating new displays?
How do I send What calculations is What does this term I need detailed How do I edit an
information or a DDC the system making mean? information about a existing display?
program to a controller? when I use this specific DDC function.
feature?
Because of the unique flexibility of Envision for BACtalk systems, there may be
portions of this guide that are not applicable to systems you deal with, as well as
portions that are not specifically detailed here. Use the quick steps in this section
to find information that applies to your installation.
Before you start the installation process, make sure you have the following:
CAUTION Upgrade the server first before upgrading the clients to avoid
locking users out from the server. Clients with newer BACtalk software cannot
log into earlier BACtalk servers.
CAUTION The Local Administrator user profile must be configured during the
initial launch of Envision for BACtalk on each workstation. It cannot be set up
later. Local Administrator provides access to special tasks requiring higher
privileges at the local workstation. If you lose the LocalAdministrator password,
you must reinstall Envision for BACtalk and set up a new LocalAdministrator
user ID. Vista users must run Envision for BACtalk as an Administrator to do
this step.
CAUTION Some controller ROC files must be updated to fully use Envision
for BACtalk features and functionality. See the Readme for a complete list of
new ROC files or visit the version histories on the ROCs download page on the
ASN at http://asn.alerton.com for a complete summary of ROC releases.
The system will not communicate and the protocol driver does not restart. You
must shut down and restart Envision for BACtalk.
CAUTION If running BACtalk for Windows v3.1x, do not dial into a stand-
alone controller site without first saving and backing up data in BACtalk for
Windows v3.1x format.
Note Depending on the size of the job, Envision for BACtalk v3.0 may take a
long time (possibly several hours) to initially launch when upgrading from an
earlier version due to a database conversion operation. Envision should launch
faster the next time it is started.
Note Upgrades on some operating systems may require you to update the
BACtalk communications driver. For more information, see “Installing the
Alerton/Honeywell BACtalk Driver” on page 21.
Note Sharing data displays across slow networks is not recommended. It can
severely impact network performance. It is recommended that you copy job
displays and templates to client workstations. See “Client/server setup” on
page 29 for more detailed information.
Task See
1 Document the address-numbering scheme on installation drawings. page 18
2 Install Visio 2007 or Visio 2010 if you plan to use VisualLogic. See page 19
page 76 for system requirements required to run Visio and
VisualLogic.
3 Run setup.exe from the Envision for BACtalk DVD. page 21
Note: Default installation location is C:\Alerton\BACtalk\3.0.
4 Verify that the Alerton/Honeywell BACtalk driver did install. page 21
5 Start Envision for BACtalk and set up the Local Administrator’s page 23
password.
6 Log in with “LocalAdministrator” and the password you just created. page 23
8 Create the default job, and then create the site key. page 40
11 Restart Envision for BACtalk and log in to the default rep/job created page 40
in the preceding step.
12 Create user profiles, including security level, start display, device page 47
access and privileges, and group membership.
13 Set up the Device Manager table and send all data to devices. page 50
Task See
1 Save Point Data and Device Configuration in Device Manager. page 63
Task See
14 Verify that all objects (for example, trendlogs and schedules) were --
successfully sent to all host devices.
Task See
1 Save Point Data and Device Configuration in Device Manager on the page 63
server.
8 Start Envision for BACtalk, set the Local Administrator’s password page 23
and log in to the job for this site.
Task See
13 Verify the Device Manager table and send all data to devices. page 50
• Verify that this computer’s device instance is listed in the table.
• Verify that all known devices connected to the same network are
listed in the table.
• Verify that the appropriate device capabilities are selected,
especially for host devices; poll by device.
14 Verify that all objects (for example, trendlogs and schedules) were --
successfully sent to all host devices.
4 If necessary, restore the job used in the earlier version of Envision for page 42
BACtalk. (This must be the same job set as the default on the server.)
5 Start the upgraded Envision for BACtalk, set the Local page 37
Administrator’s password and log into the job.
Note For more information about connecting to remote sites, see the Envision
for BACtalk Operator’s Manual (LTBT-OP-EBT).
Task See
1 Connect to the remote site with the currently installed version of --
BACtalk software and perform the reverse engineering function
(save data from devices to the operator workstation hard disk).
2 Disconnect. --
7 Connect to the site, and log in to the job for the remote site. --
Do not perform reverse engineering at this time.
9 Verify the Device Manager table and send all data to devices. page 50
Installation detail
This section provides more detailed instructions for the tasks listed in the
preceding quick steps sections. There may be portions of this section that are not
applicable to your installation. Use the quick steps tables (beginning on page 10)
as a guide to determine which of the following procedures you need to complete.
Installing Visio
Install Visio 2007 or Visio 2010 if you plan to use VisualLogic. Alerton
recommends you install Visio in the default installation directory. For detailed
installation procedures, see your Visio documentation.
IMPORTANT Always install Visio before installing Envision for BACtalk. The
VisualLogic macro will not run if Visio is installed after BACtalk. The remedy is
to uninstall and reinstall Envision for BACtalk.
IMPORTANT Set the Macro security level to “Low” before installing Envision
for BACtalk.
CAUTION If you upgrade from Visio version 5.0 or 2000 to Visio 2007 or
Visio 2010, you must completely uninstall the older version before installing a
newer version. Otherwise, VisualLogic will not work properly.
Note Computers that meet only the minimum system requirements should not
use Visio and VisualLogic. See page 76 for more information.
2. In the BACtalk program group (Programs > Alerton > Envision for
BACtalk), select Compact BACtalk Access Database.
The Compact and Repair Databases dialog box opens.
If you have upgraded the job from a previous version of BACtalk or have
successfully merged another job into this one using the Restore BACtalk Job
Utility and restarted Envision for BACtalk, you may safely remove the unused
files prior to backing up the job to save backup time and disk space. For a list of
files you may safely remove see the following knowledge base article on the
Alerton Support Network (ASN): White paper 08-0061-01-00
Note The Backup utility cannot span multiple disks. If you have a large job,
back up to the hard drive, and then write the zip file(s) to the appropriate media.
2. From Device Manager, select all devices, and then save all device data
to disk.
N o t e Choosing to save trendlog data may take a long time.
4. Under Job, select the rep/job that you want to back up. (The current
default rep/job appears in the BACtalk title bar.)
5. Under Archive File Name, type a path and file name for the backup file.
-or-
Click Browse and then select the folder and type the file name you want
to save to. Click Save to return to the Backup dialog box.
N o t e BACtalk automatically adds a zip file extension to the file name
you type when performing a backup.
6. Click Backup.
BACtalk creates a zip file with the name you specify in the folder you
select. Progress messages appear in the Output list.
CAUTION Do not install Envision for BACtalk to the same directory where
BACtalk for Windows is installed if you plan to continue using BACtalk for
Windows on this computer. If installed in the same directory, Envision for
BACtalk will fully replace BACtalk for Windows.
CAUTION Do not install newer versions of Envision for BACtalk in the same
directory where earlier versions of Envision for BACtalk are installed. Envision
for BACtalk versions 2.5, 2.6, and 3.0 have new database structures and the
databases get automatically converted during startup. A 2.5, 2.6 or 3.0 job cannot
be converted back to a previous version. Before upgrading to v2.5 or later, back
up your current job.
Required for
Operating systems Name Location
upgrades
Windows XP, Windows Alerton/Honeywell BACtalk Driver 3.0 C:\Alerton\BACtalk\3.0\Drivers\Win2 Yes
2000, Windows Server (ETHUIO.SYS) 000-XP
2003, Vista, and Win 7.
If you do not have the correct protocol driver installed, the following message is
displayed after you log into Envision for BACtalk. This message appears during
initial installation and every time a new job is created. The Ethernet Adapter
field on the Network tab will also have a blank list until the protocol is installed.
1. Open a command prompt, type “net stop ethuio”, and then press Enter.
This stops the existing Alerton/Novar Ethernet Driver from running and
allows it to be uninstalled without re-booting Windows.
The following message is displayed: “The Alerton/Honeywell BACtalk
Driver service was stopped successfully.”
7. In the Select Network Component Type dialog box, click Protocol, and
then click Add.
8. Click Have Disk, click Browse, and then locate and select the updated
Alerton/Honeywell BACtalk Driver 3.0. The drivers are typically
located at C:\Alerton\BACtalk\3.0\Drivers.
9. Ignore the message “This driver is not digitally signed” and click OK.
10. In the network connection properties dialog box, make sure that
Alerton/Honeywell BACtalk Driver is enabled (checked).
N o t e If you have both Envision for BACtalk and BACtalk for
Windows installed on an operator workstation running Windows 2000
or Windows XP, you must have both protocol drivers installed and
enabled.
11. Click Close, click Close again, and then close the Network Connections
dialog box.
Note The primary Ethernet adapter entry initially appears as None when you
start Envision for BACtalk with the new driver. You must select your Ethernet
adapter on the Network tab in the General System Setup dialog box.
Note The Ethernet Adapter field will have a blank drop-down device list until
the protocol is installed or the driver may not have been started.
Like other user IDs, all “Local Administrator” user activity is recorded in the
User Activity Log.
Figure 1 Email from Alerton Customer Service containing a sample BACtalk software license key
Depending on the job size, Envision for BACtalk supports a different number of
operator workstations and BACnet devices. If you are setting up a client/server
site, you must first set up the server. Software license should be installed on the
server; client installations do not require a software license. License files are not
required to work in offline mode.
The Alerton Building Suite startup processes require software license files that
are specific to the computer on which they are installed. During installation you
will be prompted to enter your software license key which activates the licensing
process. It is strongly recommended that the host computer/server be connected
to the Internet during installation.
1. Type your license key into the HostId field on the Install BACtalk
License dialog box. NOTE: Type capital letters only.
2. Click Install.
The licensing process should complete within seconds.
The Install BACtalk License dialog box will display every time you launch
Envision for BACtalk if the system has not been properly licensed.
3. Alerton Technical Support will email you your license files. Copy the
license files to your desktop.
Note If you experience an error message when installing the software license,
search for “license” in Envision for BACtalk Help for an explanation.
IMPORTANT! Keep a copy of your license key in a safe place for future
reference. You must have your license key in order to get it replaced if your host
computer must be replaced. It is strongly recommended that you physically
record the license key on the computer to which it is bound.
Using the appropriate ROC file for your job is extremely important. The ROC
file is integral to Device Manager operations and device capabilities. See
“Understanding Device Manager” on page 50 and “Device capabilities” on
Note Any new ROC files are copied to the operator workstation during
Envision installation and stored in the <BACtalk root>\System folder.
3. In the list of devices, select the devices you want to update, and then
click Send.
N o t e If you want to update more than one device, you can select and
send the ROC file to all of them at the same time.
5. Click Send or Send All if the “Read new device capabilities after
sending ROC” option is selected.
You can check the User Request Monitor (View > User Request
Monitor) to verify that the ROC was sent successfully.
6. To send previously saved objects, select all and then click Send.
N o t e The Save All button is intended for use with stand-alone sites.
Client/server setup
When more than one operator workstation is used on a site, one of the computers
must be configured as a server for the other workstations. This is done using the
General System Setup option on the Envision for BACtalk Tools menu. For
more information, see “Verifying General System Setup” on page 46.
Note It is recommended that you copy job displays and templates to client
workstations. Sharing data displays across a network is not recommended. It can
severely impact network performance. If your network has the bandwidth to
support sharing data displays this way, see “Sharing data displays in a client/
server network” on page 81 for more information about how to set it up.
The operator workstation you choose to be the server should have the best
hardware setup among operator workstations. A large hard disk and fast
processor are of particular importance. For more information, see
“Recommended system specifications” on page 76.
• Install Envision for BACtalk and set up the Local Administrator user
profile.
• Configure the active rep/job directory on the server.
• Identify the operator workstation as the server.
• Configure user profiles.
2. Start Envision for BACtalk and set the Local Administrator’s password
to allow for special tasks requiring higher privileges at the local
workstation.
5. Type a rep name and job name. Make a note of these; you will need
them later in this procedure whenever <repname> and <jobname> are
used.
6. Click Options to expand the dialog box, click Create Dir., and then
click OK to create the directory key for the current job.
This creates a job directory named <repname>/<jobname> and makes it
active. All support and database files will be created within this job
7. Click Select.
10. Close and restart Envision for BACtalk, and then log in with the initial
user’s user name and password.
7. Click OK to close the Site Configuration dialog box, and then click OK
to close the General System Setup dialog box.
8. Close and restart Envision for BACtalk for the setup to take effect.
Always on connection
For the always on option, set up Annex J on the Network tab of General System
Setup in Envision for BACtalk. This option allows BACnet messages to pass
over the IP network in the same way as any other application data: data displays,
schedules, trendlogs, and alarms can reference device instances and properties
anywhere on the internetwork. They appear to the Envision for BACtalk
operator workstation as though they were locally connected. Envision for
BACtalk initiates the connection on startup.
Temporary connection
For a temporary connection, set up Annex J in the Connection Manager for a
Remote Site. You can set up the connection type in a remote site profile to use
Annex J, just as you would normally use a modem or a serial cable. In this way,
you can temporarily connect to a remote site over the BACnet/IP network. Once
you establish your connection to the network—plugging into an available
Ethernet jack, dialing in through an Internet Point-to-Point Protocol (PPP) or
Windows Remote Access Service (RAS) connection, and so on—you can open
Envision for BACtalk and then use Connection Manager to initiate a BACtalk
session by registering with the BBMD.
You must perform the following steps for each client workstation:
• Start Envision for BACtalk and set the Local Administrator’s password.
• Log in with “LocalAdministrator” and the password you created.
• Configure the active rep/job directory.
• Identify the operator workstation as the client.
2. Start Envision for BACtalk and set the Local Administrator’s password
to allow for special tasks requiring higher privileges at the local
workstation.
5. Type the rep name and job name. These must match the <repname> and
<jobname> you established on the Envision server.
6. Click Options to expand the dialog box, click Create Dir., and then
click OK to create the directory key for the current job.
This creates a job directory named <repname>/<jobname> and makes it
active. All support and database files will be created within this job
directory. For example, a job directory might be
C:\Alerton\BACtalk\3.0\Myrep\Myjob.
7. Click Make Key if you want to allow users not logged in with a rep
name and password to modify job display files.
8. Click Select.
9. Restart Envision for BACtalk and log in to the new rep/job using the
LocalAdministrator credentials.
11. Set up an Initial User profile. (See page 37 for more information)
12. Restart Envision for BACtalk and log in with the initial user’s name and
password.
13. Copy job templates, displays, and bitmaps to the job subdirectory you
created. See Figure 2 on page 39 for the correct locations for these files.
Note If your network supports it and you want to share displays across the
network, follow the instructions in “Sharing data displays in a client/server
network” on page 81. Be aware that display sharing across a network may
increase network traffic and slow network performance.
6. Type the device instance assigned to the Envision for BACtalk server.
7. Click OK to close the Site Configuration dialog box, and then click OK
to close the General System Setup dialog box.
8. Close and restart Envision for BACtalk for your changes to take effect.
To configure a server
1. Open bactalk.ini in a text editor.
3. Set the value of PublicHttpPort to match the local IP port of the server.
4. Set the value of PublicHostName to match the local host name of the
server.
4. Set up each client with the same job directory as the server.
5. Copy job templates and displays to the job directory you created.
N o t e If your network supports sharing displays across the network,
see “Sharing data displays in a client/server network” on page 81.
WARN ING Significant changes were made to the BACtalk database structure
in versions 2.5, 2.6, and 3.0 to improve system performance, stability and
security. Once a job is upgraded to 2.5 or later, it cannot convert back to an
earlier version of BACtalk. Back up the current job before upgrading.
WARN ING Do not mix versions of BACtalk. For a large WAN upgrading to
Envision for BACtalk, you may not be able to upgrade all operator workstations
at the same time. If you must connect workstations running different versions of
BACtalk operator workstation software, some unexpected errors may occur. In
particular, do not edit schedules, trendlogs, alarms or make changes in Device
Manager from a workstation running BACtalk for Windows 3.1x. BACtalk for
Windows v3.1x does not support Envision for BACtalk features.
Note When you dial into a remote site, always save data from devices first.
Note On the server, you can leave the Secure Communication Capabilities
check box unchecked, until all clients are upgraded. If upgrading from BACtalk
v2.0 or later, you are already running the correct protocol used by v3.0.
WARN ING Significant changes were made to the BACtalk database structure
in versions 2.5, 2.6, and 3.0 to improve system performance, stability and
security. Once a job is upgraded to 2.5 or later, it cannot convert back to an
earlier version of BACtalk. Back up the current job before upgrading.
Note You can install Envision for BACtalk and BACtalk for Windows on the
same computer, but you can’t open and run both programs at the same time.
Use the following scenarios as a guide when connecting to sites running different
versions of BACtalk operator workstation software.
Note To work with new features, such as optimum start, tenant activity,
demand limiting, or multistate objects, you must upgrade the host device with
the latest real-time operating code (ROC) file.
The next day, Terry connects to Remote Site 2, which is a server-based site,
running BACtalk for Windows v3.11. To ensure compatibility, Terry uses the
same version of the software when he connects to this site. Fortunately, he had
the foresight to keep a copy of BACtalk for Windows 3.11 on his operator
workstation for just this purpose.
This scenario could be different if the workstation used to provide remote alarm
logging services is running BACtalk for Windows v3.1x and a customer site is
using Envision for BACtalk. If the customer had alarms set for Envision’s new
features, such as demand limiting, the remote alarm logging service would not
be able to view those alarms. In this scenario, it is recommended that you
upgrade the operator workstation before performing alarm logging.
Following are some key points and terms to keep in mind when creating jobs and
users:
• When you start Envision for BACtalk for the first time, you must set up
the Local Administrator for the local BACtalk workstation to perform
special tasks that no other user can perform.
• When you create a new job, there are no user profiles; you must create
them or users will not be able to log in. Create the Default User profile
for all jobs that will use the Dashboard.
• Each job has a unique system setup, specifying addressing information
for the operator workstation and devices on the BACtalk system.
The following list includes key terms used when discussing job setup.
Local The user profile that allows for special tasks requiring higher privileges at the
Administrator local workstation and provides stronger security. The Local Administrator
must be configured during initial setup. The Local Administrator is the user
that installs BACtalk on the local computer. Each computer has its own local
administrator. See “Configuring the Local Administrator” on page 23 and
“Logging in for the first time” on page 40 for more information.
Initial User By logging in with the Initial User ID and password assigned by the Local
Administrator, the initial user can work with new jobs and create user profiles,
displays, DDC, and security files that go with them. The Initial User should
have high access privileges if this user will finish setting up the job where the
Local Administrator left off. This Installation Guide assumes the Initial User
has high privileges. For example, give the Initial User a higher security level
and the “Configure Job Data Folder” and “Users and Group Setup” privileges.
Whereas the Local Administrator is limited to working in offline mode only,
the Initial User may work in online mode.
Default User The Dashboard Application uses the Default User to silently authenticate with
the Envision for BACtalk web server. It is recommended that the Default User
have the minimum privileges. The Default User does not have to be logged
into Envision for BACtalk for the Dashboard to work. Configure and enable
the Default User at Tools > General System Setup > Startup/Shutdown. The
Default User should not be the user who configures the dashboard.
Job Term used to describe a set of displays, DDC, and databases used for a specific
application or site. Displays and DDC for a job are stored in the job folder
beneath the representative folder. Displays and DDC saved in the job folder
cannot be modified from within Envision for BACtalk unless a user is
authorized to do so.
Default Job The job name last specified by the representative in the Set Rep and Job dialog
box, which appears only to privileged users. The default job name appears in
the Envision for BACtalk title bar when you log in.
Site Key A software file that enables users with sufficient security to edit and then
overwrite DDC and displays in a job folder. If the key is not created for a job,
that job cannot be the default job for Envision for BACtalk.
Alerton The displays and templates that are shipped with Envision for BACtalk and are
Standard stored in a special Alerton Standard job folder of the Alerton root folder.
applications Displays and DDC stored here cannot be overwritten by a representative or
user. They can be copied, then modified and saved to a job folder that has a site
key.
Generic Job The factory default job. A keyed job that provides a repository for DDC and
displays that can be modified. A representative or user can also use this job to
access Envision for BACtalk if something has gone wrong with the default
representative and job (for example, the user authorization file has been
deleted or corrupted, or the job folder has been renamed or deleted). For this
reason, do not delete the Generic job folder or any files in it on any operator
workstation.
You can use any displays, templates, and DDC files from any job folder on any
other job. If these are modified, however, they can only be saved to the default
job or by those logged in as a privileged user.
Settings in the Users and Groups dialog box still govern a user’s ability to edit
displays and templates. See “Creating user profiles” on page 47 for more
information about user privileges.
File locations
Displays and DDC files created for a particular job are saved in a subfolder of
the Alerton root folder (specified during installation) as shown in Figure 2.
Root directory
Alerton Standard directory
• Factory-standard displays and graphics and DDC.
• If displays and templates are modified, they must be saved to a job folder.
• Any job can use displays, bitmaps, DDC, and documentation from Alerton Standard.
• Documentation directory stores sequences and point list for standard applications.
Bitmaps directory
• Stores bitmaps used by data displays and templates in the displays directory. If not in
this location, Envision for BACtalk will not find bitmaps for displays and templates.
DDC directory
• Stores all DDC files for the job.
Displays directory
• Stores all displays and templates for the job.
System directory
• Stores core operating files for BACtalk system and ROC files for host devices.
VisualLogic directory
• Stores core operating files for VisualLogic.
3. If a Tech Key is detected, the system will display a code. Type the code
in the field provided.
4. Click Login.
You are now logged in to the Generic job with the highest security level.
Create a default job, set up user profiles, and configure the workstation.
novice user and the “Configure Job Data Folder” and “Users and Groups Setup”
privileges.
You can create as many job folders as you want, but only one job can be the
default. To change the default job, select it in the Set Rep and Job dialog box,
and then restart Envision for BACtalk.
Note If you upgraded from BACtalk for Windows v3.1x, you can use the job
data from that version in Envision for BACtalk. See “Using BACtalk for
Windows job data in Envision for BACtalk” on page 41 for more information.
3. Type a Rep name and Job name according to the following guidelines:
Rep Name This is the name of the job directory.
IMPORTANT! Do not use numbers in the rep name.
Job Name The name of the subfolder (up to eight characters) that will
be created under your Rep name to store job information.
7. Click Select and restart Envision for BACtalk to activate your changes.
N o t e You can create as many jobs as you want in one session, but the
job that appears in the Set Rep and Job dialog box is the default when
Envision restarts.
9. Restart Envision for BACtalk and log in with the initial user’s name and
password.
10. On the Tools menu, click Users and Groups, and then create at least
one user profile so users who are not the Local Administrator or do not
have the initial user’s name and password can log in to the job.
If you upgraded to Envision for BACtalk from BACtalk for Windows v3.1x, you
can use the job data from the previous installation.
4. Click Import.
The Import Rep/Job dialog box displays a list of previous BACtalk
versions.
6. In the list of Rep/Jobs, select the job you want to import, and then click
OK.
WARN ING Read this section before attempting to back up and restore job data
and follow the instructions carefully to ensure successful data migration.
BACtalk. Back up and restore conventional data and then configure the
restored job for SQL Server.
• Always merge a smaller job into a larger job. For example, merge a new
school building into the school district job and not the school district
into a single school building.
• Do not back up a job to a mapped network drive. Performance will be
slow due to other users on the same network.
• You must use unique device instances. The Restore Utility will not
overwrite existing files with the same name in newer versions of
Envision for BACtalk. Make sure all the files you need to add to an
existing upgraded database have a unique name or the restore process
will skip over them.
N o t e Merge data into an upgraded Envision for BACtalk job only
since some legacy databases may have files that will be overwritten.
• Make sure the job you are going to back up does not have any extra files
you don’t want to back up in it or you may restore files you do not need
or want into another job.
• Only data you backed up gets merged. DDC does not get merged.
backed up from the original job. SQL Server data is not backed up nor restored
by Envision for BACtalk. The database administrator must handle the SQL
Server backup and restore operations.
The BACTALK.INI and REP.INI files do not get backed up or restored because
they contain settings that apply to all jobs on a workstation and not individual
job settings. Manually copy these files if you want to configure an identical
workstation.
This restore option restores the following BACtalk client components only:
After the Restore Merge Components function completes, restart Envision for
BACtalk in the job you want to merge into and the new data will merge from the
backup into the target job.
This restore option does not restore the following files, some of which could
break the configuration settings of an upgraded Envision for BACtalk job:
To merge new data with a SQL Server Envision for BACtalk job
Note Server1 is Online and running a SQL Server Envision for BACtalk
database. Server2 is Offline and running BACtalk.
3. Merge the backed up job with the target job on Server1and then restart
Envision for BACtalk in the target job to complete the merge process.
Data automatically gets stored to the SQL Server database.
• Set the device instance for the operator workstation. This determines
how this operator workstation is identified to other devices on the
BACnet network.
• Verify the Ethernet setup. This determines how this operator
workstation communicates with other devices on the BACnet network.
• Identify the operator workstation as a server or client. See “Setting up a
client/server relationship” on page 29 for detailed instructions.
a security level of 7, the user will be able to access data display items that are
security level 7 and below.
Set up the system to automatically lock out trusted users when they are
scheduled to be off the job for a period of time and are expected to have future
access. You want to preserve their user profile. Once the authorized period is
scheduled, BACtalk will automatically lock the user out of the system when the
server registers midnight on the expiration date.
For a user you want to permanently lock out of BACtalk, delete the user’s
profile. Deleting the user ID does not impact records in the User Activity Log.
Deleted user IDs can be reused but no previous user settings are preserved.
2. Click Add.
3. On the General tab, type a User ID, name, and description in the boxes
provided.
User IDs must be from 1 to 40 characters. Spaces, numbers, lower and
upper case letters are all valid characters.
deleted, not expired. Deleting a user ID does not affect records in the
User Activity Log.
8. On the User Device Access and Privileges tab, specify the range of
devices this user shall have access to and then select privileges for this
user. Click the plus (+) symbol to expand the level of detail. Select
check boxes beside a feature to enable access for this user. A check
mark indicates full access. A grayed box indicates partial access within
a feature category. A cleared box indicates no access.
10. On the Effective Device Access and Privileges tab, specify which
devices for which this user has access and privileges. The Effective
Device List displays a complete list of all the devices this user has
access to, even devices he can access due to group membership that
exceed his/her individual user access.
12. Repeat steps 2 through 11 for each user profile you want to create.
13. Click Close when you have finished adding user profiles.
Device Manager serves as an engineering tool to set up a job with all the devices
used in that job. Use this guide to learn how to add a device to Device Manager
by providing the following descriptive information about the device:
Once the system and devices are installed and set up, Device Manager serves as
a site management tool. See the Envision for BACtalk Operator’s Manual
(LTBT-OP-EBT) for more information about using Device Manager to:
Identification
You set up device profiles in Device Manager using the Add/Edit Device Profile
dialog box. The Identification tab allows you to enter or display the following
information about a device.
MAC address The unique MAC address for this device. All
devices on a BACnet internetwork must have a
unique MAC address/Network number
combination. For global controllers, BACtalk
control modules, expandable controllers, and
operator workstations, this number is hard-coded
in the network interface card.
Device model The model name assigned by the manufacturer.
Read only.
Firmware version The firmware version assigned by the
manufacturer. Read only.
Application software The application software (ROC file) loaded on the
device. Read only.
Commissioning status The date this device was commissioned and the
technician who commissioned it.
Note Each BACtalk control module (BCM) has its own device instance and
each is set up separately as a global controller in Envision for BACtalk. (The
BCM-PWS and BCM-MDM are exceptions; they do not have device instances
and do not appear in Envision for BACtalk’s Device Manager.)
Device capabilities
A device profile also includes the capabilities or attributes that a device supports.
If a particular capability isn’t selected for a device in Device Manager, the device
cannot support it in Envision for BACtalk. On the Capabilities tab in the Add/
Edit Device Profile dialog box, you can select attributes for devices in one of
four ways:
Capabilities tell Envision for BACtalk how to talk to connected devices. Default
capabilities are assigned when you select a device type from the Auto-Select
menu on the Capabilities tab in the Add/Edit Device Profile dialog box. These
are the minimum capabilities for the device type selected. You may need to
modify the selections, depending on the specific device you are defining. Default
capabilities are used when upgrading from BACtalk for Windows 3.1x.
Capabilities are assigned based on the device unit type previously defined in the
Device Manager table. Incorrectly selected capabilities results in inoperable
schedules, trendlogs and alarms. Make sure you are using the correct ROC
version. See “Device capability descriptions” on page 53 for a brief description
of each capability.
Note The most accurate method to set capabilities for any device is to either
scan or poll the device. If working offline, poll the device once you are
connected to ensure that the correct capabilities are selected.
Send UTC offset UTC time offset is a property of The UTC offset for your time Sending UTC will cause the UTC
property to device the device object. It is used to zone is normally set within the offset value from Device
(BACnet-Device denote the geographic location Alerton global controller and in Manager>Preference>UTC
and its corresponding time. It is Device Manager's preferences. offset to be used. This will
Object>UTC_Offset
used to synchronize clocks in The UTC offset is taken from overwrite the controller setting.
property
network devices. Device Managers Preference
settings tab.
The UTC offset can be set in the
following ways:
1) Sent using Device Manager
using the value entered on the
Preferences tab.
2) Adjusted using HyperTerminal
when connected to the global
controller.
3) Remote device configuration
editor.
4) From a Data Display (BACnet
property).
5) General System Setup>Time
Sync.
NOTE: UTC is internally linked
to the Tenant Billing program
and if UTC is not implemented
for your time zone, Tenant Billing
will not be calculated and display
the correct data.
Supports schedules The Schedule Object type Create schedules that reference Checking this capability allows
(BACnet Schedule defines a standard object used points within the selected you to create schedules that
to describe a periodic schedule device. An example controller of reference points within the
Object
that may recur during a range of this type includes the VLCP, selected device. This capability
dates, with optional exceptions which did not support additional may not be set when “Supports
at arbitrary times on arbitrary MSTP controllers. schedules with external points”
dates. is checked.
Supports BACnet par- Device supports schedules as Envision for BACtalk adds partial Identifies the device as
tial-day scheduling day scheduling to the schedule supporting BACnet Protocol
defined in the BACnet Protocol
(BACnet) object. Version 1, Revision 4 schedules.
Version 1, Revision 4. This setting is used in
conjunction with the “Supports
schedules” or “Supports
schedules with external points”
device capabilities
Supports calendar The Calendar object type Envision for BACtalk does not Checking this capability allows
defines a standardized object use the calendar object in its the Envision for BACtalk server
(BACnet Calendar
used to describe a list of standard schedule interface, to create calendar objects in the
Object)
calendar dates, which might be rather the schedule object is selected device (disk file or
thought of as “holidays,” “special used. Alerton global controllers global controller).
events” or simply a list of dates. such as the BCM-ETH, BCM-
MSTP, etc. do support these cal-
endar objects (See PICS for
supported BIBBs and Objects).
To use the calendar object the
user must use
Tools>Advanced>Calendars
and set the parameters there.
Supports alarms The Event Enrollment object Create alarms that reference Checking this capability allows
(EEO) type defines an event points within the selected you to create alarms that
(BACnet Event
Enrollment Object) (e.g. Alarm) and provides a device. The EEO will monitor the reference points within the
connection between the alarm state and provide a selected device. This capability
occurrence of an event and the notification to the alarm handler may not be set when “Supports
transmission of a notification for distribution to alarm alarms with external points” is
message. recipients. checked.
Supports alarms with The Event Enrollment object Create alarms that reference Checking this capability allows
external points (EEO) type defines an event points within or without the you to create alarms that
(e.g. Alarm) and provides a selected device. The EEO will reference points within the
(BACnet Event
connection between the monitor the alarm state and selected device or points on
Enrollment Object)
occurrence of an event and the provide a notification to the other network devices. This
transmission of a notification Alarm handler for distribution to capability may not be set when
message. alarm recipients. “Supports alarms” is checked.
Supports alarm dia- Identifies the device as a BCM modules support alarm dial Enables dial out communication
lout controller with modem dial-out out via the BCM-MDM. BTI- capabilities.
support. MDM (on board modem), BTI-
(Alerton proprietary
100 and VLX support alarm dial
out via serial communication
port to a connected modem. BTI-
Smoke does not support alarm
dial-out.
Supports current Device supports the BACnet Indicates the device will support Allows the device to be scanned
alarms report Get-Event-Summary service. Envision for BACtalk's “Current for current alarm
Alarms” feature.
Supports alarms for Device communication failure The Device Comm fail object is Selecting this option allows Aler-
communication failure alarms notify users with a pop- created in the global controller. Dev-Comm-Fail objects to be
up alarm message that The global controller hosting the sent to devices. For example, to
(Alerton proprietary)
communication between the object will periodically poll to see monitor communication between
server and a device has been if the devices are present. If one global controller and the device.
lost. is detected as absent, a Further setup is required to fully
notification is popped-up on the deploy this feature; refer to
workstation. online Help.
Supports Alerton pro- The Process ID is a component Alerton global controllers use Select this option to indicate that
cess IDs of the BACnet Destination used these process IDs in a the device can send, receive,
(Alerton proprietary) by the Notification Class Object predictable way. The same and support pre-defined or
to deliver a notification to a process IDs are used repeatedly custom Alerton process IDs for
recipient. For example, pop-up, when a user adds new pagers or event notifications
log, page, or e-mail the alarm, e-mail recipients; the new
etc. process IDs are created
dynamically. Also, some 3rd
party controllers may create
these process IDs manually, so
the user may have to configure
this in the BACtalk server to get
3rd party alarms to pop-up,
annunciate, and log to alarm
history.
Initiates event notifi- Controls EBT Event Summary Auto-select this option and leave If the device generates event
cations UI drop down lists showing only it at the default setting. notifications (alarms or
devices checked. trendlogs), the user will now be
(BACnet)
able to use Event Summary,
Alarms and Trendlogs features.
Supports trend log Alerton trendlogs (proprietary Create trendlogs that reference Checking this capability allows
objects format). Alerton created a trend- points within the selected you to create trendlogs setup
log format in advance of the device. that reference points within the
(Alerton proprietary or
BACnet standard definition. This selected device. This capability
BACnet) If this capability is used without
proprietary object is used to log the “Supports BACnet Trendlog” may not be set when “Supports
data within Alerton controllers. trendlog objects with external
capability, an Alerton log is
points” is checked
May or may not be an Alerlog created (proprietary format).
(See Supports BACnet trendlog
capabilities setting).
Supports BACnet A trendlog object monitors a When used in combination with Select this option to configure
trendlog capabilities property of a referenced object the Alerton Trendlog option, the the device for BACnet trendlog
and, when predefined conditions combined result is a trendlog reporting.
(BACnet-Trend Log
Object) are met, saves the value of the setup that is formatted as
logged property and a defined in the BACnet Standard
timestamp in an internal buffer Protocol revision 4.
for subsequent retrieval.
Supports trend log Trendlog samples are logged COV trendlogs show changes in Enabling this feature tells the log
objects with COV when the value of the monitored the values of monitored handler to subscribe to the
capabilities point changes. Can be properties. COV logging reduces monitored point. When the value
configured to log samples the total number of samples in of the point changes, the device
periodically in addition to COV the database. notifies the log handler and the
samples. value is logged.
Supports Alerton The Zone object is an Alerton A zone object pulls together the Checking this capability allows
zone objects proprietary object with an individual properties and you to create zone objects that
associated set of properties. references required to support reference points within the
(Alerton proprietary)
optimum start or tenant activity selected device. This capability
in a single object. It handles the may not be set when “Supports
user-defined inputs specified zone objects with external
during the zone setup to monitor points” is checked.
and control schedules, optimum
start, and tenant activity.
Supports Alerton The Zone object is an Alerton A zone object pulls together the Checking this capability allows
zone objects with proprietary object with an individual properties and you to create zone objects that
external points associated set of properties. references required to support reference points within the
(Alerton proprietary) optimum start or tenant activity selected device or points on
in a single object. It handles the another network. This capability
user-defined inputs specified may not be set when “Supports
during the zone setup to monitor zone objects” is checked.
and control schedules, optimum
start, and tenant activity
Supports Alerton The Demand Limiting object is Envision for BACtalk enables Checking this capability allows
demand limiter an Alerton proprietary object you to monitor energy demand you to create demand limiter
objects with an associated set of and then automatically adjust objects that reference points
(Alerton proprietary) properties. equipment operation to limit the within the selected device. This
demand and reduce costs. This capability may not be set when
NEVER USED... is known as demand limiting. Supports demand limiter objects
because demand with external points is checked.
limiter refers to I/O in
external devices
Supports Alerton The Demand Limiting object is Envision for BACtalk enables Checking this capability allows
demand limiter an Alerton proprietary object you to monitor energy demand you to create demand limiter
objects with external with an associated set of and then automatically adjust objects that reference points
points properties. equipment operation to limit the within the selected device or
demand and reduce costs. This points on another network. This
(Alerton proprietary)
is known as demand limiting. capability may not be set when
Supports demand limiter objects
is checked.
Supports Viewport Viewport displays are used by Envision for BACtalk has a Checking this capability allows
displays the Alerton Viewport Controller Viewport Display editor that the Envision for BACtalk server
(Alerton proprietary) and permits the user to logically allows the user to create Device Manager to send/save
group elements that are displays for the Viewport Viewport Displays to a
displayed on a multi-line product, and those displays can connected device
controller with a LCD display. later be sent via Device Manager
directly to the Viewport
Acts as operator Controls EBT user interface Auto-select this option and leave The operator workstation will
workstation drop-down lists showing only it at the default setting. appear in the related drop down
(Alerton proprietary) workstations. list, like e-mail workstation.
Supports Device Identifies VLCs that allow the To renumber VLCs. Enables user to renumber VLC
Instance renumbering device instance (BACnet-Device NOTE: Global controller device device instance (BACnet-Device
object identifier) to be changed. object identifier) with Device
(Alerton proprietary) instances are changed using
Manager: Advanced-
HyperTerminal or the remote
device configuration editor. >Renumber VLCs.
Supports Alerton BACnet service used by a Alerton workstations (server or When this capability is selected,
read/write multiple BACtalk operator workstation client) and global controller DDC the “Send device properties”
properties (server or client) to request can issue RPM/WPM messages option in Device Manager sends
values of one or more specified to VLCs or global controllers the current RPM/WPM settings
(BACnet)
properties of one or more which support the RPM/WPM as in Envision for BACtalk's Gen-
BACnet objects. noted on the respective PICS. eral System Setup to the
selected device. This specifies
the policy for the selected device
on whether or not to use RPM/
WPM (even when the device
indicates it does not support
those) when issuing a request to
non-Alerton devices and older
Alerton devices.
Some 3rd party BACnet
controllers may not support the
Read/Write Property Multiple
service. Refer to the PICS to
determine if it supports this
feature. If it does not, ensure this
capability is not selected.
Supports Alerton TUX IBEX TUX (.tdc) controller binary The .tdc files are created from Enables you to send/save your
DDC file format of a DDC application. IBEX VisualLogic, Envision for TUX DDC applications for IBEX
IBEX software>TUX DDC editor, programmable TUX controllers
(Alerton proprietary)
and TDS (TUX Development listed in Device Manager.
Software).
NOTE: The Save operation
NOTE: Only Alerton IBEX saves the DDC file *.tdc to the
programmable controllers ...\Rep\Job\DDC\ folder.
(APLC, 653P, etc.) support this
device capability.
Supports Alerton Alerton VLC (Visual Logic The .bd4 files are created from Enables you to send/save your
DDC type bd4 Controller) controller binary file VisualLogic DDC drawings or by DDC applications for VLC con-
(Alerton proprietary) format (.bd4) of a DDC using the VLC DDC editor. The trollers listed in Device Manager.
application. files can be retrieved from a
NOTE: Header information only
controller and re-engineered as
is saved; not the actual files. Use
needed. global controller DDC or
VisualLogic to retrieve the files
Supports Alerton Alerton Advanced VLC (Visual The .bd6 files are created from Enables you to send/save your
DDC type bd6 Logic Controller) controller VisualLogic DDC drawings or by DDC applications for VLC con-
binary file format (.bd6) of a using the Advanced VLC DDC trollers listed in Device Manager.
(Alerton proprietary)
DDC application. (green) editor. The files can be NOTE: Header information only
retrieved from a controller and
is saved; not the actual files. Use
re-engineered as needed.
global controller DDC or
VisualLogic to retrieve the files
Supports Alerton Real-time-Operating-Code Download these files using Allows users to use Device
ROC (OMF/BIN) (ROC) is the helper application Device Manager. Alerton con- Manager to download ROC files
(Alerton proprietary) that defines the controller trollers are pre-loaded with a for this device
characteristics and features. It is ROC file. The latest ROCs are
downloaded to the controller in available on the ASN. Be sure to
advance of any control logic. use the correct ROC files for the
The file extensions are *.omf and front-end software. See KBA
*.bin. http://asn.alerton.com/Products/
downloads-rocs.aspx
NOTE: Identify the ROC file in a
global controller or VLC by
reading the Device Object>
Application Software Version.
Supports remote con- Enables users to scan and Configuration settings such as Enables users to send/save
figuration configure this device from a Device instance, Ethernet net- configuration settings to the
remote location. work, MSTP network, BACnet IP selected device using
(Alerton proprietary)
settings, etc. can be set via an EBT>Device
Envision workstation (server or Manager>Configure
client). Optionally, these set-
tings can be configured using
HyperTerminal via null modem
cable and a serial port connec-
tion.
The controller configuration
settings can be set, written, read
and saved as a data file. The
default file location\name is
\rep\job\devnnn*\devconfig.dcf.
The devconfig.dcf can be
opened using Notepad. *nnn is
the device instance (e.g.
\\\dev1234...).
Supports BACnet Enables the Envision server to To save and restore a BACnet Back up devices that have the
backup and restore back up BACnet compliant compliant devices configuration BACnet backup device capability
devices that have the BACnet data. A password is required selected in their device profile.
(BACnet- Backup and
Restore) backup device capability when backing up devices. You Device Manager: Select
selected in their device profile. can also select a character set (if
Advanced->Back up Devices...
necessary) and define a timeout
Or -> Restore Devices...
period after which the back up
process is stopped.
Password: Type the password
defined for the selected
device(s). The default password
for all Alerton controllers is
ALERcomm (case-sensitive).
Character set: This is the char-
acter set recognized by the
selected devices. ANSI X3.4 is
selected by default. You can
select ISO 8859-1 if appropriate.
Timeout: This is the amount of
time, in seconds, in which
Envision for BACtalk attempts to
back up a selected device before
stopping. If all of the devices use
the same timeout value, the
value is displayed here by
default. A valid timeout value is
between 10 and 65535 seconds.
Acts as a smoke Password protects the controller Select this capability and then Forces the user to enter a
controller so users can only download set the password. Remember password to send DDC, device
DDC to it if they enter the the password so you can configuration or Point Data to the
password. Protects some download DDC to this smoke device. Prevents unauthorized
systems from being modified in controller. users from modifying controllers
ways that prevent them from that have been configured as
functioning appropriately during part of a smoke system.
a smoke event.
Preferences
Use the Preferences tab in the Add/Edit Device Profile dialog box to identify the
DDC application that will control this device. You also use the Preferences tab to
identify the host controller for the device. This is where the trendlogs, schedules,
and alarms for the device are stored and run.
Do Not select the Auto Download option to automatically send a ROC file from
the operator workstation hard disk to controllers if it is different than the file on
the device. This automatic download occurs once a day at midnight. Instead,
ROC file downloads should be done under the direct supervision of a trained
technician only.
WARN ING Auto Download does not send DDC or objects. Safeguard your
DDC, schedules, trendlogs, alarms and other objects.
Note Some Envision for BACtalk features may not work properly if the UTC
offset is not set correctly.
You can calculate the UTC setting directly from your location’s longitude with
respect to Greenwich, England. Therefore BACnet UTC is:
Example
Moscow, Russia is approximately +45 degrees longitude (East of Greenwich), so
its BACnet UTC is -((45/15)*60 = -180.
Hawaii, USA is a bit further than -150 degrees longitude (West of Greenwich),
so its BACnet UTC is -((-150/15)*60) = +600.
There are a couple of different ways to set up the Device Manager table for a
site: while online at the site (communicating with devices) or while offline
(offline engineering). Offline engineering is the most common method and is
explained here.
Practical application
Terry is a technician for AlerRep Inc. One of his projects for the week is to set up
the Device Manager table for State University. His supervisor gave him the riser
diagrams and configuration worksheets for the site so he’s ready to begin.
• Student Union
• Health Sciences
• Administration
• Athletics
• Central Plant (facilities)
• Engineering
• 3 Dormitories
• Library
• Theatre/Auditorium
• Liberal Arts
• Fisheries/Forestry
• Math Sciences
The Student Union is fairly small with only 10 rooftop air conditioning units so
Terry begins there. According to the site documentation, each air conditioning
unit is controlled by a VLC-550. The documentation also shows the device
descriptions were created using the building name (SUB), unit type (ACU)
building number (21), floor number (5 for the rooftop), and a number to indicate
the number of the device (01-10). For example, the first device description is
SUB: ACU-21-501.
Terry quickly determines that he can create one device profile and then use the
Copy feature in Device Manager to create the other nine.
Since each VLC-550 is identical, Terry uses the Capabilities and Preferences
tabs to define the attributes, application, and host device for the controller before
copying the device profile.
After Terry copies the device profile, he can then edit each profile to replace any
“x” with a unique character.
You can also use the Renumber VLCs feature to help populate the Device
Manager table. See “Renumbering VLCs” on page 72 for more information.
See the Envision for BACtalk Operator’s Manual (LTBT-OP-EBT) for more
information about the send and save features.
Device Scan does not allow you to save scan results if multiple devices are found
with the same device instance. Duplicate device entries are not permitted. If
duplicate device instances are found, correct them, back up the job, and then
compact and repair the database. For more information about Device Scan, see
the Envision for BACtalk Operator’s Manual (LTBT-OP-EBT).
Note Currently, only BCMs (ROC v2.0 and later) and VLXs (ROC v2.3 and
later) support remote configuration.
Figure 1.1 Use Device Scan to locate, renumber, and reconfigure pre-configured BCMs and VLXs.
When you scan for configurable Alerton controllers, the output will look the
same as any other device scan with the following exceptions.
Scan Configurable Alerton Devices now appears on the Device Scan dialog
box. The Show Non-configured Devices Only option is only available when
Configurable Alerton Devices is selected. Results include only controllers that
match at least one of the following: a) device instance = 200 (factory default for
configurable Alerton devices), b) devices that do not have firmware loaded.
Any device that can be reached using BACnet services (through a series of
properly configured BACnet routers, BACnet over Ethernet, BACnet over IP,
Annex J, PTP, MS/TP, etc) will also show in scan results. Under these
circumstances, misconfigured devices may or may not show up in scan results.
Double-click a BCM in the list that is the only BCM in its array to open the Edit
Device Configuration dialog box. Or, select a device and then click Configure to
open the Edit Device Configuration dialog box.
Working in the View Array dialog box All BCMs may not show up in search
results if, for example, there are multiple BCM-MS/TPs. Select a BCM in the
scan results list and then click View Array to see a complete list of BCMs in the
array. The View Array dialog box shows the position of each BCM in the array.
Working in the Select Device dialog box Double-click a BCM in the list that
has other BCMs in its array to open the Select Device dialog. The same behavior
occurs if you select a device and then click Configure.
Double-click a BCM in the Select Device dialog box to open the Edit Device
Configuration dialog box. The same behavior occurs if you select a device and
then click OK.
The Edit Device Configuration dialog box is displayed when you select a device
to configure from either the Device Scan window or the Select Device dialog
box. After changing the device configuration, click OK to return to Device Scan.
The Edit Device Configuration dialog box displays configurable options from
the devconfig.dcf file.
Click to save or discard your changes and close the dialog box.
Click to save any changes to the currently displayed settings and leave the dialog box open.
• Add or replace a device for which the configuration and device entry
has already been configured in Envision for BACtalk
• Add a new device that does not yet exist in Device Manager
Close the
Click to return to the previous Wizard without
screen without sending the sending the
configuration file. configuration
file.
If there is an entry in Device Manager with the same net/MAC address as the
device being processed, it is used as the default device. Otherwise, it is shown as
blank.
Close the
Click to return to the previous Wizard.
screen without sending the
configuration file.
If you select Send ROC Now If It Is Different Than Server Copy or Send ROC
Now (even if there is no difference) and then click Next, Envision for BACtalk
attempts to send the ROC file. If the device is not yet defined in Device
Manager, the wizard prompts you to define the device.
The Back and Next buttons are disabled while the send operation is in progress.
CAUTION Objects are discarded when a new ROC file is sent so always send
objects (schedules, trendlogs, alarms, zones, etc.) when sending a ROC file.
Select the additional data options you want to send the files from the server to
the device. Click Next to start the transfer. Click Finish to close the wizard.
To configure a device from Device Manager, select the device and then click
Configure.... The Edit Device Configuration dialog box appears.
Envision for BACtalk loads the current device configuration file from disk and
displays it in the Edit Device Configuration dialog box. The device instance field
is read-only when the Edit Device Configuration dialog box is opened directly
from Device Manager.
When sending device data to disk, all target devices must be locatable by device
instance so do not change device instances when this operation is in progress.
BACtalk will
automatically read the
device capabilities
from the device after it
successfully sends the
ROC file to the device.
Selected by default
Renumbering VLCs
Use the Renumber VLCs feature (BACtalk > Device Manager > Renumber
VLCs) to set up device instances for a group of VLCs. This is useful when
setting up very large sites. The Results Preview pane shows you the results of the
changes you make before you make them to help you identify potential conflicts.
the VLC, DDC and display items must be manually updated to reflect the new
device instance.
You have 2 options for renumbering VLCs: Renumber based on device manager
records or Renumber based on VLC Network Number and MAC Address.
2. Add a device profile for each unitary controller (VLC) whose device
instance you want to set.
6. Click Apply.
7. Click Close.
5. Under Set New Device Instances, type the new Device Instance you
want applied to the first Net/MAC combination and the increment by
which that Device Instance increases for each successive device you
want to renumber.
6. Click Update Preview to see the effect your changes have. Look for
any warnings in the Status column of the Results Preview. This column
can also indicate Net/MAC conflicts. A conflict occurs when two or
more device profiles use the same Net/MAC address combination.
8. Click Apply.
Note You need to create a Documentation folder in the rep/job directory for
templates and displays that you copy from Alerton Standard applications.
2. In the Device Manager dialog box, click the device profile you want to
work with, and then click Edit.
4. Select the criteria you want to search on, and then click Search. For
example, you can search for applications for a particular unit type, such
as a main air handler or fan coil.
The first application that meets your search criteria is displayed. If there
is more than one, use the arrows under Go to Record to browse through
them and select the one you want to use.
6. In the Copy Application dialog box, note the application file name and
destination path, and then click Save. All application materials are
copied to the active rep/job folder.
8. Click Close, and then click Cancel to return to the Add/Edit Device
Profile dialog box.
9. Click Browse, and then select the rep/job to which you just copied the
application.
N o t e If the Browse button is dimmed, click the Capabilities tab and
ensure that one of the “Supports Alerton DDC type bd3 (or bd4 or bd6)”
capabilities is selected.
10. Select the DDC file from the list, and then click Select.
Appendix
This section contains reference information and forms that may be useful during
Envision for BACtalk installations and upgrades.
The server is the most important BACtalk component on site and should have
hardware capable to meet these demands. Performance of the server depends
mostly on available RAM, processor speed, and hard disk space.
Note Installing more hardware may help a slow Envision for BACtalk
conventional job speed up. However, the total performance is limited by reliance
on the Access/Jet database technology. Auto-archiving may slow down
conventional BACtalk jobs because Jet runs auto-archiving and job operations
such as trendlogs, the user interface, the opening of lists, and client/server
• Core i7-860
• 6 GB RAM
• USB port
• 90 GB hard disk or better (large jobs may require more)
• High-performance graphics adapter
• Network interface card (100/1000 Mbps or better)
• Printer access
• Keyboard, monitor, mouse, DVD drive
• Windows XP Professional SP3, Windows Server 2003 SP1, Windows
Server 2008, Windows Server 2008 R2, Vista, or Win 7
• Visio 2010 (optional)
Note For Envision for BACtalk, use the Aler-Modem, BCM-MODEM or the
MDM-100 to meet your modem needs.
For Envision for BACtalk, use the Aler-Modem, BCM-MODEM or the MDM-
100 to meet your modem needs.
Depending on the key level, Envision for BACtalk supports a different number
of operator workstations and devices. Devices are defined as BACnet devices
other than the BACtalk operator workstations.
You can check which software key is installed and the number of devices
supported by choosing About Envision on the Help menu.
Alerton Tech Key: Times out after 8 continuous hours. Use the tech key to do design work offline. The tech
key enables all functionality including SQL support and dashboards and is intended for Dealers only.
(ABS-3-TECH)**
* This recommended configuration for a Large or Enterprise job requires a 64-bit
operating system.
**The Alerton Building Suite Tech license accompanying this release works in
the same way as the older tech key. The only difference is that the Tech license is
non-transferable; once it is used it cannot be used with a different computer
because it gets associated to that host device only.
Envision for BACtalk uses Device Manager to enforce key level conformance.
When Envision for BACtalk starts, it checks the number of device records in
Device Manager and compares this count with the software key found. If more
records than are allowed are present in Device Manager, a message is displayed
and the first 11, 50, or 150 devices (depending on the key) appear. Envision for
BACtalk counts devices and monitors conformance on an ongoing basis. Any
time a device is added to Device Manager, Envision for BACtalk checks for
software key conformance.
If the device count is greater than the key allows, a message appears that a key
upgrade is required. This upgrade message is repeated once daily. Data from
devices in excess of what the key supports return “no entry” in lieu of system
data.
If no key is found on startup, Envision for BACtalk starts in offline mode for the
default rep and job. All data display points show “no entry” in lieu of system
data.
Envision for BACtalk periodically checks for a valid key during operation. If a
key is not found, Envision for BACtalk generates a message and then goes
offline. To bring Envision for BACtalk back online or to re-enable key detection,
restart Envision for BACtalk.
For temporary connections to a server-based system, the key found at the remote
site’s Envision server determines the device limit. Temporarily connected
operator workstations are not included in the device count.
Alarms dialed in from remote systems are not subject to the device count check.
However, receiving alarms at a workstation is disabled without a key.
• A BTI must have ROC file v3.20 or later to host optimum start, tenant
activity, or demand limiting. A BTI-100 must have ROC file v1.00 or
later. BCMs support the automation features.
• A BCM or BTI must have ROC file v3.21 or later to support multistate
objects. A BTI-100 must have ROC file v1.01 or later. BCMs support
the automation features.
• LSIs don’t support the automation features and may generate errors if
you try to use them.
• Envision for BACtalk automation features use the Coordinated
Universal Time (UTC) to start and complete operations accurately. See
When a site is set up in this way, trendlog data, energy log data, alarms, reports,
data displays, and bitmaps on a single computer—the Envision server—are
referenced by all other operator workstations. Edits or updates performed as the
result of actions at one workstation are immediately reflected at other
workstations.
Operator Workstation
Figure 2 Envision for BACtalk runs on each operator workstation locally and
accesses selected job data over the network.
The procedures described here involve sharing the Displays directory on the
server and then mapping to that directory from client operator workstations.
Variations on this procedure are possible for the purposes of flexibility. For
example, you may choose to share at a higher level than the Displays directory.
These variations are not addressed and require a thorough understanding of
Windows sharing and Envision for BACtalk.
4. In the Share Name box, type a name for the directory. Make a note of
this name; you will need it later in this procedure, whenever
<sharename> is referenced.
6. Click OK.
3. From the Drive list, select an unused drive letter and make a note of it.
You will need it later in this procedure whenever <mapdrive> is
referenced.
3. If necessary, type the rep and job name exactly as they were entered on
the server.
7. Type or select the mapped drive to the server’s Displays directory (for
example, L:<sharename>).
8. Click Select.