Design, install, operate, and maintain IzoT and LONWORKS
networks with the IzoT Commissioning Tool.
®
078-0509-01A
Page 2
Echelon, LON, LONWORKS, IzoT, LonTalk,
Neuron, LONMARK, 3120, 3150, LNS,
LonMaker, LonSupport and the Echelon
logo are trademarks of Echelon Corporation
that may be registered in the United States
and other countries.
Other brand and product names are trademarks or
registered trademarks of their respective holders.
Neuron
Chips and other OEM Products were not
designed for use in equipment or systems which involve
danger to human health or safety or a risk of property
damage and Echelon assumes no responsibility or
liability for use of the Neuron
Chips in such applications.
Parts manufactured by vendors other than Echelon and
referenced in this document have been described for
illustrative purposes only, and may not have been tested
by Echelon. It is the responsibility of the customer to
determine the suitability of these parts for each
application.
ECHELON MAKES NO REPRESENTATION, WARRANTY, OR
CONDITION OF ANY KIND, EXPRESS, IMPLIED, STATUTORY,
OR OTHERWISE OR IN ANY COMMUNICATION WITH YOU,
INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED
WARRANTIES OF MERCHANTABILITY, SATISFACTORY
QUALITY, FITNESS FOR ANY PARTICUL AR PURP OSE,
NONINFRINGEMENT, AND THEIR EQUIVALENTS.
No part of this publication may be reproduced, stored in
a retrieval system, or transmitted, in any form or by any
means, electronic, mechanical, photocopying,
recording, or otherwise, without the prior written
permission of Echelon Corporation.
Appendix D Software License Transfer Agreement ........................ 377
Software License Transfer Agreement ........................................................ 378
x Preface
Page 11
Preface
The IzoT Commissioning Tool is a software package for designing, installing, and
maintaining multi-vendor, open, interoperable LONWORKS® control networks and
IzoT networks. Installing the IzoT Network Services Server on the same computer
with the OpenLNS Commissioning Tool converts the OpenLNS Commissioning Tool
to an IzoT Commissioning Tool. The product names referenced by the OpenLNS
Server and the OpenLNS Commissioning Tool are not all updated to the new IzoT
names by the IzoT Network Services Server. You will see references to both sets of
names in the software and documentation.
Based on Echelon's OpenLNS network operating system, the Izot Commissioning
Tool combines support for open LONWORKS control networks and IzoT networks
with a user-friendly Microsoft Visio interface. The result is a software tool that’s
robust enough to work with all your devices, yet economical enough to leave behind
as an operations and maintenance tool. The IzoT Commissioning Tool complies with
the OpenLNS plug-in standard, and it is compatible with the LNS plug-in standard,
making it compatible with the wide variety of plug-ins available from Echelon and
many other vendors.
IzoT Commissioning Tool User’s Guide xi
Page 12
OpenLNS CT XML Programmer’s
Describes how to create and modify an OpenLNS network using
OpenLNS Programmer’s Guide (078-
Describes how to use the OpenLNS Object Server ActiveX
OpenLNS Programmer’s Reference
Provides reference information for writing OpenLNS tools,
LNSPlug-in Framework Develop er’s
Describes how to write system and device plug-ins using .NE T
Purpose
This guide outlines the the IzoT Commissioning Tool, and it describes ho w to use the IzoT
Commissioning Tool to design, commission, monitor and control, maint ai n, a nd ma nage a network.
The IzoT C ommissioning Tool includes online help that provides context-sensitive documentation that
supplements the information in this guide.
Audience
This guide is intended for system designers a nd integrators with an understand ing of control networks.
System Requirements
System requirements for computers runnin g t he the IzoT Commissioning tool are as follows:
•Microsoft
XP 32-bit.Echelon recommends that you install the latest service pack available from Microsoft
for your version of Windows.
• 500 MHz processor or faster. 2 GHz processor recommended.
• 2 GB or more of free disk space.
• 512 MB RAM. 2 GB RAM recommended.
®
Windows. Windows 8 64-bit and 32-bit or Windows 7 54-bit and 32-bit or Windows
• 1,024 x 768 or higher-resolution display with at least 256 colors.
• Mouse or compatible pointing device
• DVD-ROM drive.
• IP-852 network interface.
IzoT Commissioning Tool Documentation
The docume ntation for the IzoT Commissioning tool is provided as Adobe Acrobat PDF files and
online help files. The PDF file for this do c ument is installed in the EchelonOpenLNS CT program
folder when you install the IzoT Commissioning Tool software. You can also download the latest
OpenLNS documentation, including the late s t version of this guide, by going to the Echelon OpenLNS
Web site atwww.echelon.com/openlns.
Guide
0437-01A)
(078-0437-01A)
the OpenLNS XML Plug-in.
Control to develop OpenLNS apps.
applications, and plug-ins. Describes the objects in the
OpenLNS Object hierarchy, and details their properties,
methods, a nd events.
Guide (078-0393-01A)
The following docume nt s supplement the material provided in this guide. Y ou can download these
documents from Echelon’s Web site at www.echelon.com/docs.
xii Preface
programming languages such as C# and Visual Basic .NET.
Page 13
i.LON 600 Lon Works/IP Server U ser's
Describes how to install, configure, use, and manage the i.LON
Introduction to the LONW
Provides a high-level introduction to LONW
networks a nd
IP-852 Channel User’s Guide (078-
Describes how to configure an IP-852 channel with the Echelon
LONM
SNVT and SCPT Guide
Documents the standard network variable types (SNVTs) and
LONW
USB Network Interface
Describes how to install and use the U10 and U20 USB Network
IzoT NodeBuilder FX User’s Guide
Describes how to use the IzoT NodeBuilder tool to develop
PCC/PCLTA Network Interface User's
Describes how to install, configure, a nd te st the PCC-10,
SmartServer 2.0 User’s Guide (078-
Describes how to configure the SmartServer and use its
Guide (078-0272-01A)
ORKS
Platform (078-0183-01B)
0312-01A)
ARK
ORKS
User’s Guide (078-0296-01B )
(078-0516-01)
Guide (078-0450-01A)
600 IP-852 routers, and how to use the Echelon I P-852
Configurati on Server.
ORKS
the tools and component s that are used for deve loping, installing,
operating, and maintaining them.
IP-852 Configuration Server. You will need this information if
you plan on a ttaching your OpenLNS CT computer to an IP-852
channel.
standard configuration property types (SCPTs) used by
ONWORKS device applications. For more information, go the
L
ONMARK International Web site at
L
www.lonmark.org/technical_resources/resource_files.
Interfaces to connect an OpenLNS or OpenLDV application to a
ONWORKS network.
L
LONWORKS device applications and build and test prototype and
production L
ONWORKS devices
PCLTA-20, and PCLTA-21 network interface cards that you can
use to connect an OpenLNS or OpenLDV application to a
ONWORKS network.
L
0345-01F)
applications to manage control networks.
For More Information and Technical Support
The Echelon OpenL N S CT ReadMe document provides descriptions of known problems, if any, and
their workarounds. To vi ew the Echelon OpenLNS CT ReadMe document, click Start, point to
Programs, point to Echelon OpenLNS CT, and the n s elect Echelon Ope nLNS CT ReadMe.
If you have technical questions that are not answered by this document, the OpenLNS CT o nl ine he lp
files, or the Echelon OpenLNS CT ReadMe document, you can contact Echelon technical support.
There is no charge for software installation-related questions during the first 30 days after you receive
the OpenLNS CT DVD or purchase an OpenLNS CT activation key. To receive technical support
from Echelon, you must purchase support services from Echelon or an Echelon support partner. See
www.echelon.com/support for more information on Echelon support. Your OpenLNS CT distributor
may also provide customer support.
You can also enroll in training classes at Echelon or an Echelon training center to learn more about
using OpenLNS CT. You can find additional information about device development training at
www.echelon.com/training.
You can obtain technical support via phone, fax, or e-mail from your closest Echelon support center.
The contact information is as fo llows:
IzoT Commissioning Tool User’s Guide xiii
Page 14
The Americas
English
Echelon Corporation
Europe
English
Echelon Europe Ltd.
Japan
Japanese
Echelon Japan
China
Chinese
Echelon Greater China
Other Regio ns
English
Phone: +1.408-938-5200
Region Languages Supported Contact Information
Japanese
German
French
Italian
Attn. Customer Support
550 Meri dian Avenue
San Jose, CA 95126
Phone (tol l-free):
Suite 12
Building 6
Croxley Green Busine s s Park
Hatters Lane
Watford
Hertfordshire WD18 8YH
United Kingdom
Phone: +44 (0)1923 430200
Fax: +44 (0)1923 430300
lonsupport@echelon.co.uk
Holland Hills Mori Tower, 18F
5-11.2 Toranomon, Minato-ku
Tokyo 105-0001
Japan
Phone: +81.3-5733-3320
Fax: +81.3-5733-3321
lonsupport@echelon.co.jp
Content
This guide includes the following c ontent:
•Introduction: Provides an introduction to the IzoT Commissioning tool, new features; a nd the
basics of IzoT commissioning tool network designs, L
•Installing and Activating the IzoT Commissioning Tool – describes how to order and install the
IzoT Commissioning Tool and Microsoft Vision 2010, and then how to activate the IzoT
Commissioning Tool.
English
Japanese
ONWORKS,and Visio.
Rm. 1007-1008, IBM Tower
Pacific Century Place
2A Gong Ti Bei Lu
Chaoyang District
Beijing 100027, China
Phone: +86-10-6539-3750
Fax: +86-10-6539-3754
lonsupport@echelon.com.cn
Fax: +1.408-328-3801
lonsupport@echelon.com
xiv Preface
Page 15
•Getting Started: Provides information on the planning an IzoT Commissioning Tool network
design; using the OpenLNS CT Design Manager; setting up a network interface; creating and
opening an OpenLNS CT network design; OpenLNS CT client types; using OpenLNS CT
remotely; and creating and using user profiles.
•Designing Networks: Describes how to design a network using the IzoT Commissioning Tool.
Covers how to create the following objects in an OpenLNS CT drawing: application devices,
functional blocks, network variables, rout ers, channels, and sub systems. Explains how to connect
network variables. Explains working with OpenLNS CT SmartShapes
and layers , customizing
the OpenLNS CT user interface, and using OpenLNS CT with AutoCAD drawings.
•Installing Networks: Describes how to install devices using t he IzoT Commissioning Tool,
including how to load applications into them, set the initial state of their ap plications, set the
source of their configuration properties, and select how they manage device-specific configuration
properties. It also explains the diffe rent metho ds for acquiring device Neuron IDs and how to
alternatively use the device discovery method to install a network.
•Monitoring and Controlling Networks: Describes how you can monitor and control the devices in
your network with the Iz oT Commissi oning To ol. Describes the three methods you can use to
read and/or write network variables and configuration properties: using monitored connections,
browsing with the OpenLNS CT Browser, and using Data Po int SmartShapes. Covers how to
bind network variables to the host in order to receive event-driven updates. Describes how to
change the types and formats of network variables and configuration properties. Explains how to
create simple HMIs in your OpenLNS CT drawing with D ata Point and Visio SmartShapes.
•Maintaining Networks: Provides an overview of network maintenance tasks that you can perfor m
with the IzoT Commissioning Tool. Describes loading, replacing, and decommissioning devices.
Explains how to resynchronize and propagate configuration properties values. Explains how to
back up and restore an OpenLNS CT network; create an OpenLNS CT network by recovering
information from the physical network; and resynchronize the network database, OpenLNS CT
drawing, and physical devices. Explains how to merge two Op e nLN S CT net wor k s.
•Managing Networks: Explain s how to test and verify applicatio n d e vices, functional blocks, and
routers; describes the IzoT Commissioning Tool styles; and details how to generate device status
summary reports, network resource reports, and OpenLNS network reports.
•Managing OpenLNS CT Licenses: Provides an overview of IzoT Commissioning Tool licensing.
Describes how to upgrade the IzoT Commissioning Tool, upgrade an IzoT Commissioning Tool
Standard Edition to the Professional Edition, renew your IzoT Commissioning Tool annual
maintenance contract, and transfer an IzoT Commissioning Tool license.
•Exporting and Importing a Network Using XML: Describes how to export a L
ONWORKS network
to an IzoT Commissioning Tool network XML file; view a LONWORKS network XML file in a
Web browser; edit an IzoT Commissioning tool network XML file; and import a LONWORKS
network XML file to update a network.
•Using Plug-ins: Provides an overview of plug-ins and then describes how to start a plug-in, get
plug-in information, and re-re gister, e nable, and disable plug-ins.
•Creating and Using IzoT Commissiong Tool SmartShapes and Stencils: Describes how to create
an IzoT Commissioning Tool stencil and create and use custom master SmartShapes for devices,
functional blocks, subsystems, and connections. Explains how to modify a master SmartShape by
changing it s user-defined cells.
•Appendices: Includes the IzoT Commissioning Tool default options, a glossary, the OpenLNS C T
Software License Agreement, and the OpenLNS CT License Transfer Agreement.
IzoT Commissioning Tool User’s Guide xv
Page 16
Page 17
1
Introduction
This chapter provides an introduction to the IzoT Commissioning Tool, describes new
features, and explains the basics of IzoT Commissioning Tool Network Designs,
LONWORKS,and Visio.
IzoT Commissioning Tool User’s Guide 1
Page 18
Introduction to the IzoT Commissioning Tool
The IzoT Commissioning Tool (OpenLNS CT and LonMaker) is a LONWORKS® network tool that runs
on the OpenLNS network operating system and uses Microso ft Visio
(Professional or Standard editions) as a graphical user interface. The OpenLNS network operating
system implements a client/server architecture with directory, installatio n, mana gement, monitor i ng,
and control services provided by an OpenLNS Server that is included with the IzoT Commissioning
Tool. The OpenLNS Server all o ws mult ip le user s r un ni ng IzoT Commissioning Tool and other
OpenLNS tools, applications, and plug-ins on separate computers to access the OpenLNS Server
simultaneously. This means that ma nagers, syst em integr ators, installers, and maintenance perso nnel
can all work on the same L
compatible with Windows 7 (64-bit and 32-bit), Windows Server 2008 R2 (64-bit), Windows Vista
with SP1 (32-bit), and Windows XP with SP3 (32-bit). The OpenLNS Server and IzoT
Commissioning Tool are backwards compatible with all existing LNS Turbo Edition databases and
LonMaker T urbo Edition drawings providing simple migration for existing LNS and LonMaker
networks.
The IzoT C ommissioning Tool can be used to manage all phases of a network’s life cycle—from the
initial des ign and commissioning t o the ongoing operation. It provides the functionality of several
network tools in one single solution:
•Network Design Tool. You can design a network offsite (without actually being connected to the
network) and/or onsite, and modify it anytime.
•Network Installation Tool. You can rapidly install a network designed offsite once it is brought
onsite. The device definitions can be quickly and easily associated with their corresponding
physical devices to reduce on-site commissioning time. The OpenLNS CT Browser provides
complete access to all network variables and configuration properties.
ONWORKS network at the same time. The IzoT Commissioning Tool is
®
2010 or Visio 2003
•Network Documentation Tool. You can create an OpenLNS CT drawing during the ne twork
design and installation process. This OpenLNS CT drawing is an accurate, logical representation
of the installed physical network. The OpenLNS CT drawing is therefore an essential component
of as-built reports.
•Network Operation Tool. You can operate the network using the operator interface pages
contained wit hi n the OpenLNS CT drawing.
•Network Maintenance Tool. You can easily add, test, remove, modify, or replace devices, routers,
channels, subsystems, and connections to maintain the network.
New Features
This section describes the major features included with the OpenLNS Server and the IzoT
Commissioning Tool.
You can install devices without commissioning fees (known as “credits” in LNS Turbo and LonMaker
Turbo software). The IzoT Commissioning Tool features no-cost installation for all L
2 Introduction
ONWORKS
Page 19
devices that comply with the ISO/IEC 14908-1 Control Network Protocol. This includes devices
based on the FT 6000 Smart Transceiver, FT 5000 Smart Transceiver, Neuron
®
Neuron
Transceiver, and also includes devices based on third-party ISO/IEC 14908-1 protocol processors.
This reduces network installation costs, makes installation and maintenance costs more predictable,
and simplifies the installation process.
5000 Processor, FT 3150/3120 Smart Transceiver, or PL 3170/3150/3120 Smart
®
6000 Processor,
Automated Product Activation
You can quickly install and activate the IzoT Commissioning Tool software. When you install the
IzoT Commissioning Tool software on an Internet-connected computer, the installer automatically
connects to the Echelon License Server, the License Server issues activation licenses for OpenLNS
Server and IzoT Commissioning Tool, and the licenses are installed on your computer. If your
computer does not have access to the Internet, you can manually activate your software via e-mail or
phone using the Echelon License Wizard, which provides easy-to-follow instructions for activating
Echelon software products. See Chapter 2, Installing and Activating IzoT Commissioning Tool, for
more information on installing a nd a c tivating IzoT Commissioning Tool.
Annual Product Maintenance
The IzoT Commissioning Tool software products each include one-year maintenance during which
you can download and install IzoT Commissioning Tool software updates and upgrades for free. You
can renew your annual maintenance anytime before it expires. Renewing your maintenance enables
you to continue installing software updates. If you do not renew the product's mai nt enance, you can
still use the product; however, you will not be able to install any updates or upgrades released after the
expiration of your maintenance period.
Increased Device Compatibility
OpenLNS supports network variables with up to 225 bytes. This expands OpenLNS compatibility to
include devices with network variables longer than 31 bytes.
Longer Database Directory Path s
IzoT Commissioning Tool supports network database paths up to 230 characters (the previous limit in
the LNS Turbo Server was 23 characters). This means that OpenLNS data can now be stored in any
user data directory on your computer.
Improved Windows Compatibility
The OpenLNS Server and IzoT Commissioning Tool are now installed in the C:\Program
Files\LonWorks dire c tory by default, which is a more compatible location with Windows conventions
for program file installation. Windows has become increasingly more restrictive about default access
permissio ns on the computer’s root directory. These restrictions caused compatibility issues with LNS
Turbo and LonMaker Turbo Editions, which were installed in the C:\LonWorks directory by default.
If you have previously installed the LonMaker tool or other LNS application on your computer and
you already have a L
directory.
ONWORKS directory, IzoT Commissioning Tool will continue to use your existing
Additional OpenLNS Events
To improve synchronization between IzoT Commissioning Tool and other OpenLNS apps, the
OpenLNS Server includes new events for when device templates and extensions are updated.
New IzoT Commissioning Tool Menus
If you are using IzoT Commissioning Tool with Visio 2010, you now click Add-ins to access the
options previously available in the LonMaker menu (for example, network options, network
IzoT Commissioning Tool User’s Guide 3
Page 20
properties, synchronization, and documents [backup/restore, XML export/import]). This manual
assumes you are using Visio 2010—if you are using Visio 2003, open the LonMaker menu when this
document instructs you to clic k Add-ins and then select the desired option.
IzoT Commissioning Tool Versions
There are five versions of IzoT Commissioning Tool: IzoT Commissioning Tool Professional, IzoT
Commissioning Tool Professional Without Visio, IzoT Commissioning Tool Standard, IzoT
Commissioning Tool Standard Without Visio, and IzoT Commissioning Tool Trial. IzoT
Commissioning Tool Professional Without Visio and IzoT Commissioning Tool Standard Without
Visio require a separate purchase of Visio 2010 or 2003.
The advantage of IzoT Commissioning Tool Professional is that you can have an unlimited number of
OpenLNS ne tworks—IzoT Commissioning Tool Standard is limited to five networks. In addition,
IzoT Commissioning Tool Professional includes Visio 2010 Professional, which contains all of the
business diagramming tools of the Visio 2010 Standard edition, as well as additional comprehensive
technical and drawing solutio ns. You can purchase IzoT Commissioning Tool Standard and then
upgrade it later to IzoT Commissioning Tool Professional by purchasi ng the IzoT Commissioning Tool
Standard to Professional Upgrade Key (Echelon model number 38070-400). The upgrade key does not
include and upgrade to Visio 2010 Professional—it only upgrades the number of networks that you can
access with IzoT Commissioning Tool. See Upgrading IzoT Commissioning Tool Standard Edition to IzoT Commissioning Tool Professional Ed ition in Chapter 10 for more information.
IzoT Commissioning Tool Professional and IzoT Commissioning Tool Standard each include one-year
maintenance during which you can d ownload and install IzoT Commissioning Tool software updates
and upgrades for free. You can renew your annual maintenance anytime before it expires by
purchasin g an IzoT Commissioning Tool Professional One-Year Maintenance Renewal (Echelon
model number 93800) or an IzoT Commissioning Tool Standard One-Year Maintenance Renewal
(Echelon model number 93810). Renewing your license enables you to continue installing software
updates and upgrad es. If you do not renew the p roduct's maintenance, you can still use the product;
however, you will not be able to install updates or upgrades released after your annual maintenance
expired.
You can download a free trial edition of the IzoT Commi s sioning Tool from the Echelon Web site at
www.echelon.com/openlns. The trial edition is limited to 2 five-device networks, runs for a maximum
of 60 minutes at a time, and expires after 60 days. Visio 2010 is required to use the trial edition, but it
is not included with the trial edition. The DVD version of the trial edition does incl ud e a trial version
of Visio 2010. You can convert the trial edition to IzoT Commissioning Tool Professional or IzoT
Commissioning Tool Standard by purchasing the OpenLNS Commissioning Tool Professional Edition
Without Visio Activation Key (Echelon model number 38060-400), OpenLNS Commissioning Tool
Professional Activation Key (E c helon model number 38050-400), OpenLNS Commissioning Tool
Standard Edition Without Visio Activation Key (Echelon model number 38160-400), or the OpenLNS
Commissioning Tool Standard Activation Key (Echelon model number 38150-400).
4 Introduction
Page 21
IzoT Commissioning Tool Network Designs
An IzoT Commissioning Tool Network Design consists of an OpenLNS network database and an
OpenLNS CT drawing.
OpenLNS Network Database
An OpenLNS network database contains definitions of the devices contained within a LONWORKS
network and an OpenLNS CT drawing, including information such as the name, address, application
configuration, and ne twork connections for each device. Whenever you change an OpenLNS CT
drawing, IzoT Commissioning Tool automatically uses OpenLNS services to update the information in
the OpenLNS network database associated with the OpenLNS CT drawing.
Every OpenLNS CT drawing is associated with an OpenLNS network database, and the OpenLNS
network database is always located on the computer with the OpenLNS Server. The OpenLNS Server
may be located on the same computer as IzoT Commissioning Tool, or it may be located on a different
computer. You can maintain backup copies of the Izot Commisioning Tool network database, and you
can move the OpenLNS Server and OpenLNS network database to a backup computer. See Backing Up an OpenLNS CT Network Design in Chap t er 7, Maintaining Networks, for more information.
OpenLNS CT Drawing
An OpenLNS CT drawing contains the graphical representation of theLONWORKS network. An
OpenLNS CT drawing consists of one or more drawing files, and the drawing files consist of one or
more pages that each represent a subsystem. One drawing file is designated as the top-level drawing file; this drawing file is the one created when you create a new OpenLNS CT network design. A
subsystem within the top-level drawing file is designated as the top-level subsystem; this subsystem is
represented by the first page of the drawing that you create when you create a new OpenLNS CT
network design.
An OpenLNS CT drawing is always located on the computer running OpenLNS CT or on a remote file
share. When multiple OpenLNS CT users are accessing the same OpenLNS CT drawing, OpenLNS
CT automatically keeps the drawing synchronized. Multiple-user operation is described in Automatic OpenLNS CT Drawing Synchronization in Chapter 7.
LONWORKS Basics
This sectio n provides an overview of LONWORKS networks and defines related terms. The Glossary in
Appendix B provides a quick reference for specific terms.
Networks
A LONWORKS network consists o f intelligent devices (such as sensors, actuators, and controllers) that
communicate with each other usi ng a common protocol over one or more channels. Network devices
are sometimes called nodes.
Devices
Each device includes one or more processors and a transceiver. The processor(s) provide the device’s
intelligence and implement the ISO/IEC
serves as the device’s electrical interface to the communications channel.
14908-1Control Network Protocol (CNP). The transceiver
Protocol
A device publishes and consumes information as instructed by the application that it is running. The
applications on different devices are not synchronized, and it is possible that multiple devices may all
IzoT Commissioning Tool User’s Guide 5
Page 22
try to talk at the same time. Meaningful transfer of information between devices on a network,
therefore, requires organization in the form of a set of rules and procedures. These rules and
procedures are the communication protocol, which may be referred to simply as the protocol. The
protocol defines the format of the messages being transmitted between devices and defines the actions
expected when one device sends a message to another. The protocol normally takes the form of
embedded software or firmware code in each device on the network. The CNP
defined by the ISO/IEC 14908-1 standard (de fi ned nationally in the U nited State s , Europe, and China
by the ANSI/EIA 709.1, EN 14908, and GB/Z 20177 standards, respectively).
is an open protocol
Device Templates
A device template contains all the attributes of a given device type, such as its functiona l blocks,
network variables, and configuration properties.
Channels
A channel is the physical media between devices upon which the devices communicate. The Control
Network Protocol is media independent; therefore, numerous types of media can be used for channels
such as twisted pair, power line, fiber optics, IP, and radio frequency (RF). Channels are categorized
into channel types, and the channel types are characterized by the device transceiver. Common
channel types include TP/FT-10 (ISO/IEC 14908-2 twisted pair free topology channel), TP/XF-1250
(high-speed twisted pair channel), PL-20 (ISO/IEC 14908-3 power line channel), FO-20
(ANSI/CEA-709.4 fiber optics channel), and IP-852 (ISO/IEC 14908-4 IP-communication).
Different transceivers may be able to interoperate on the same channel; therefore, each transceiver type
specifies the channel type or types that it supports. The choice of channel type affects transmission
speed and distance as well as the network topology.
Routers
Multiple channels can be connected using routers. Routers are us ed to manage network message
traffic, extend the physical size of a channel (both length and number of devices attached), and connect
channels that use diffe rent media (channel types) together. Unlike other devices, routers are always
attached to at least two channels.
Applications
Every LONWORKS device contains an application that defines the device’s behavior. The application
defines the inputs and o utputs of the device. The inputs to a d evice can inc l ude information sent on
ONWORKS channels from other devices, as well as information from the device hardware (for
L
example, the temperature from a temperature sensing device). The outputs from a device can include
information sent on L
hardware (for example, a fan, light, heater, or actuator).
The appl ication may be i n the devic e when you purchase it, or you may load it into the device from
application files (.nld, .apb, and .nxe extensions) using the IzoT Commissioning Tool.
Applications in devices are divided into one or more functional blocks. A functional block is a
collection of network variables and configuration properties that are used together to perform one task.
For example, a four-port digital input module may have fo ur digital input functional blocks that
contain the configuration properties and output network variable for each of the four hard ware digital
inputs on the device.
ONWORKS channels to other devices, as well as commands sent to the device
Network Variables
Applications exchange information with other LONWORKS devices using network variables. Every
network variable has a direction, type, and length. The network variable direction can be either input
or output, depending on whether the network variable is used to receive or send data. The network
variable type determines the format of the data.
6 Introduction
Page 23
Network variables of identical type and length but opposite directions can be connected to allow the
devices to share information. For example, an application on a lighting device could have an input
network variable based on the SNVT_switch type, while an application on a dimmer-switch device
could have an output network variable of the same SNVT_switch type. A network management tool
such as the IzoT Commissioning Tool could be used to connect these two devices, allowing the switch
to control the lighting device, as shown in the following figure:
A single network variable may be connected to multiple network variables of the same type but
opposite direction. The following example shows the same s witch being used to control three lights:
The application program in a device does not need to know where input network variable values come
from or where output network variable values go. When the applic ation program has a cha nge d val ue
for an output network va riable, i t simply assi gns the ne w va lue to the out put network variabl e.
Through a process called binding that takes place during network design and installation, the device is
configured to know the logical address of the other device or group of devices in the network
expecting that network variable’s values. The device’s embedded firmware assembles and sends the
appropriate packet(s) to these destinations. Similarly, when the device receives an updated value for
an input network variable required by its application program, its firmware passes the data to the
application program. The binding process thus creates logical connections between an output network
variable in one device and an input network variable in another device or group of devices.
Connections may be thought of as virtual wires. For example, the dimmer-switch device in the
dimmer-switch-light example could be replaced with an occ upancy sensor, without making any
changes to the lightin g device.
Configuration Properties
Configuration properties define how an application device behaves by determining the manner in
which data is manipulated and when it is transmitted. Configuration properties determine the functions
IzoT Commissioning Tool User’s Guide 7
Page 24
Lamp Actuator
Mandatory network variables
Configuration properties
Optional network variables
nviLampValue
SNVT_switch
nv1
SFPTLampActuator
nvoLampValueFb
SNVT_switch
nv2
nvoEnergyCnt
SNVT_elec_kwh
nv4
nvoRunHours
SNVT_elapsed_tm
nv3
Mandatory
Optional
SCPT_location
SCPTinFbDly
SCPT_def_output
SCPTrunHrInit
SCPTrunHrAlarm
SCPTenrgyCntInit
to be performed on the values stored in the network var i ables. For example, a configuration property
may specify a minimum change that must occur on a physical input to a device before the
corresponding output network variable is updated. Like network variables, configuration properties
have types that determine the type and format of the data they contain.
Functional Blocks
Applications in devices are divided into one or more functional blocks. A functional block is a
collection of network variables and configuration properties that work together to perform a single
task. These network variables and configuration properties are called the functional block members.
For example, a digital input device could have four digital input functional blocks that contain the
configuration properties and output network variable members for each of the four hardware digital
inputs on the device. A functi onal block is an implementation of a f unct ional profile.
Functional Profiles
A functional profile defines mandatory and optional network variable and configuration property
members for a type of functional block. For example, the standard functional profile for a light
actuator has mandatory SNVT_switch input and output network variabl es, optiona l SNVT_elapsed_tm and SNVT_elec_kwh output network variables, and a number of optional
configuration properties. The following diagram illustrates the components of the standard light
actuator functional profile:
When a functional block is created from a functional profile, the application designer can determine
which of the optional configuration properties and network variables to implement.
Standard Network Variable and Configurati on P rope r ty Types
Every network variable and configuration pr operty has a type, which determines the content and
structure of the data. To enable devices from different manufacturers to interoperate, the following
standard types are defined:
•Standard Network Variable Types (SNVTs, pronounced snivits). SNVTs cont ain many common
operational data types. For example, SNVT_temp_p is a network variable type for network
variables containing temperature as a fixed-point number.
8 Introduction
Page 25
•Standard Configuration Property Types (SCPTs, pronounced skipits). SCPTs contain many
common configuration data types. For example, SCPT_location is a configuration property type for
configuration properties containing the device location as a text string.
See types.lonmark.org for a list and description of all SNVTs and SCPTs.
User-defined Standard Network Variable and Configuration Property Types
Applications may use manufacturer-defined non-standard types—user network variable types
(UNVTs) and user configuration property types (UCPTs)—which are defined in user resource files.
Device manufacturers may provide additional resource files that define these types. See the
NodeBuilder Resource Editor User’s Guide for additional information on creating or using these files.
Subsystems
Devices, routers, and functional blocks are contained in subsystems. With the IzoT Commissioning
Tool, each subsystem corresponds to one page within an OpenLNS CT drawing. S ub systems allow
you to place devices, routers, and functional blocks onto separate pages for organizational purposes.
You may also nest subsys tems in ot her subsystems, allo wing you to create a subsystem hierarchy for
large networks. For example, a network may consist of HVAC, lighting, security, and operator
subsystems. These may be further divided into subsystems for each floor, and each floor divided into
subsystems for each room.
Supernodes
Using the IzoT Commissioning Tool, you can also use subsystems to create supernodes. A supernode
is a subsystem with its own net work varia ble interface. You can use supernodes to organize groups of
devices into logical units a nd to hide complex subsystem details, expo sing only the most import ant
network variables. This structure reduces errors and decreases the time required for network
engineeri ng and commissioning. A network variable interface for a supernode may contain any
network variable on any device fu nctional bl ock found within the supernode or in any of its nested
subsystems.
Visio Basics
The IzoT C ommissioning Tool is built on the Visio drawing tool to provide a r ob ust technical drawing
environment for network design. An OpenLNS CT drawing consists of one or more drawing files, and
each drawing file contains multiple subsystems that are each displayed on individual Visio pages. The
Visio documentation provides detailed descriptions of Visio commands and capabilities.
Two key Visio concepts are shapes and stencils. Shapes are reusable drawing objects. A shape may
represent a simple drawing object such as a line, arc, circle, or square, or it may represent a complex
drawing object with special behavior such as OpenLNS CT SmartShapes
SmartShapes for subsys tems, application devices, functional blocks, network variables, message tags,
connections, routers, and channel s .
To simplify finding and reusing shapes, Visio defines a special type of drawing called a stencil. A
shape contained on a stencil is called a master shape. When you drag a maste r shape fro m a stencil to
one of your drawing pages, Visio automatically makes a copy of the master shape on your drawing a nd
leaves the master shape unchanged on the stencil.
You can create custom master shapes and stencils for any set of OpenLNS CT SmartShapes. For
example, the IzoT Commissioning Tool includes custom master SmartShapes and a custom stencil for
SmartServer devices and functional blocks. Yo u may wish to create your own custom master
SmartShapes and stencils to speed up network design. See Chapter 12, Creating and Using Custom OpenLNS CT Master SmartShapes, for more information.
. OpenLNS includes
To simplify access to your most commonly used stencils and drawing options, Visio defines another
type of drawing called a template. Templates are drawings that may be used as the starting point when
IzoT Commissioning Tool User’s Guide 9
Page 26
you create a new drawing. The IzoT Commissioning Tool includes a L
ONWORKS template that is used
automatically when you create an OpenLNS CT drawing. If you wish, you can create your own
custom OpenLNS CT template and select it as the default template in the OpenLNS CT Design Manager. See New Network Options in C hapter 3 for more information on selecting the default
drawing template.
10 Introduction
Page 27
IzoT Commissioning Tool User’s Guide 11
Page 28
2
Installing and Activating
the IzoT Commissioning Tool
This chapter describes how to order the IzoT Commissioning Tool, install the various
software and components included in your copy of the IzoT Commissioning Tool, and
how to activate the IzoT Commissioning Tool.
12 Installing and Activating the IzoT Commissioning Tool
Page 29
Echelon
IzoT Commissioning Tool Product
38000-400
OpenLNS Commissioning Tool Professional Edition (DVD)
38010-400
OpenLNS Commissioning Tool P rofessional Edition Without Visio (DVD)
38050-400
OpenLNS Commissioning Tool P rofessional Edition Activation Key
38060-400
OpenLNS Commissioning Tool Profe ssi ona l Edition Without Visio Activation Key
38100-400
OpenLNS Commissioning Tool Sta ndard Edition (DVD)
38150-400
OpenLNS Commissioning Tool Standard Edition Activation Key
38160-400
OpenLNS Commissioning Tool Standard Edition Without Visio Activation Key
38300-400
OpenLNS Commissioning T ool Trial Edition Without Visio Activation Key
Ordering the IzoT Commissioning Tool
You can order the IzoT Commissioning Tool directly from Echelon, from an Echelon distributor, or
from the Echelon store at store.echelon.com. If you order from the Echelon store, make sure you
provide a valid e-mail address when you order the IzoT Commissioning Tool products. Once you
complete your order, Echelon will send you an e-mail message to the provide d e-mail address with the
activation key for your IzoT Commissioning Tool products. You can order the following p roducts
from the Echelon store:
Part No.
You can download your IzoT Commissioning Tool products from the Echelon Web site at
www.echelon.com/openlns, and then install and activate them as described in the next section.
Installing and Activating the IzoT Commissioning Tool
You can install a licensed copy of the IzoT Commissioning Tool on up to two computers, a primary
and a secondary computer, provided that the following requirements are met: only the IzoT
Commissioning Tool user on the primary computer can use the copy of the IzoT Commissioning Tool
on the secondary computer and the IzoT Commissioning Tool soft wa re may only be used on one
computer at a time. See the OpenLNS CT Software License Agreement in Appendix C for more
information. To begin your installation, follow these steps:
1. If you are installing a version of the IzoT Commissioning Tool that does not include Visio, you
must separately purchase and install the 32-bit version of Visio 2010 or Visio 2003 before
installing the IzoT Commissioning Tool software.
2. If you do not have an Echelon download account, create one on the Echelon Web site at
www.echelon.com/support/downloads/accounts. Your account will enable you to d ownload
OpenLNS software from the Echelon Web site; make activating and managing li censes for
multiple Echelon products easier; enable you to return, transfer, and recover licenses; and help you
receive technical support from Echelon faster.
3. Download the IzoT Commissioning Tool from the Echelon Web site and run the
OpenLNSCTSetup.exe file, or insert the OpenLNS CT DVD into your DVD-ROM drive.
If you are installing the IzoT Commissioning Tool from a DVD and the IzoT Commissioning Tool
setup application does not launch immediately, click Start on the taskbar and then and click Run.
Browse to the OpenLNSCTSetup application on the OpenLNS CT DVD and click Open. The Select Components dialog box opens.
IzoT Commissioning Tool User’s Guide 13
Page 30
4.Select the components that you wish to install by selecting the appropriate check boxes on the
Select Components dialog box.
•Microsoft Visio: Installs the 32-bit version of the Visio 2010 drawing tool. To install the
32-bit version of Visio 2010, your computer cannot have the 64-bit version of any Office
2010 application installed on it.
The IzoT C ommissioning Tool is not co mpatible with the 64-bit version of Visio 2010 (even
if your co mputer is usin g a 64-bit operating s ystem), and it is not compatible with any version
of Visio prior to Visio 2003. If you already have a 64-bit version of any Office 2010
application, you must uninstall it before installing the 32-bit version of Visio. You can
reinstall the 32-bit version of any 64-bit Office software that you have installed.
•Echelon OpenLNS Commissioning Tool: Installs the required components of the IzoT
Commissioning Tool. Installing the IzoT Commissioning Tool automatically installs the IzoT
Network Services Server, the OpenLNS CT XML Utility
, and the dr ivers for the following
OpenLDV 4.0-compatible network interfaces:
o Remote Network Interfaces (RNIs): SmartServer , i.LON 100 Internet Server, i.LON 600
IP-852 Router, and i.LON 10 Ethernet Adapter
o Local USB network interfaces: U10/U20 USB network interfaces.
o Local PC card network interfaces: PCC-10 and PCLTA-10, 20, and 21 PCI network
interfaces. The PCC/PCLTA a nd SLTA-10 network drivers are compatible with 32-bit
versions of Windows only and are not installed on 64-bit versions of Windows.
If you are using the IzoT Commissioning Tool on an IP-852 channel, yo u will ne ed an IP
network interface card (such as Ether net or WiFi) or modem with PPP software. An IP
network interface is also required if you are using an IP-852 interface such as a SmartServer
(with IP-852 routing option), i.LON 100 Internet Server (with IP-852 routing option), or
i.LON 600 IP-852 Router. If you are using another OpenLNS interface, install the network
interface hardware and dr i ver following the instructions provided with the hardwar e.
Most network interfaces include an application that handles network interface co nfiguration.
You must perform this configuration before you can use the IzoT Commissioning Tool while
attached to a network. The application may handle host details such as IRQ assignment, and
it may also manage network parameters such as buffer counts and transceiver types.
14 Installing and Activating the IzoT Commissioning Tool
Page 31
You can use the L
ONWORKS Interfaces application in the Control P anel to define, co n figure,
and test RNIs, IP-852 network interfaces, USB 10/20 network interfaces, and PCC/PCLTA
network interfaces.
•SLTA-10 Driver (Serial): Installs the network driver for the SLTA-10 serial network
interface. Click this check box if yo u are using an SLTA-10 serial adapter as your network
interface. This option is not available on 64-bit versions of Windows.
•Adobe Reader: Installs Adobe Reader 9.2, which is a free program that allows you to read
Adobe Acrobat portable document files (.pdf extension). Many of the L
ONMARK reference
documents are exclusively in PDF format. You can clear this check box if you already have a
PDF reader application.
5. Click Install. If you are upgra ding from the LonMaker I ntegration Tool, a message opens
informing you that installing OpenLNSwill remove any version of the LonMaker tool on your
computer.
6. Click Yes to continue installingIzoT Commissioning Tool.The installation program installs the
selected components sequentially, prompting you for required reboots.
7. During the installation, the following dialog opens, displaying the curre nt progress of the
OpenLNS CT setup:
IzoT Commissioning Tool User’s Guide 15
Page 32
If you selected the Visio component in the Select Components window, the Microsoft Visio setup
wizard opens. Follow the instructions in the installation pr ogram to complete the Visio setup .
8. Install IzoT Commissioning Toolfo llowing these steps:
a. The IzoT C ommissioning Toolsetup program begins automatically with the Welcome
window opening.
b. Click Next. The License Agreement window opens.
16 Installing and Activating the IzoT Commissioning Tool
Page 33
c. Read the license agreement and click Yes if you agree wit h the terms. The Customer
Informatio n wi ndow opens.
d. Enter your name, organization, and the IzoT Commissioning Toolactivation key in the
appropriate fields. The name and organization may be entered automatically based on the
user curre ntly logged o n and whethe r other Echelon products are installed on your compute r.
If you renewed your annual ma i ntenance and you are ins t alling yo ur upgrade on the same
computer as your original OpenLNS CTsoftware, your ac tivation key is automatically
displayed. If you are installing an up gra d e on a different computer, you must find the
activatio n key that you saved from your original version of OpenLNS CT
Under Echelon Account, enter the user name (e-mail address) and password you created for
your Echelon download account (see step 2 if you do not have an Echelon download account).
Click Next.
IzoT Commissioning Tool User’s Guide 17
Page 34
e. If your computer is connected to the Internet, the IzoT Commissioning Toolinstaller c onnects
to the Echelon License Server, the License Server issues activation licenses for OpenLNS
Server and IzoT Commissioning Tool, and the installer stores the licenses on your computer.
If your computer is not attached to the Internet, you can use the Echelon License Wizard to
manually activate IzoT Commissioning Toolvia e-mail or phone after installin g the software
(e-mail is recommended). See the next section, Manually Activating IzoT Commissioning Tool, for more information.
f. If the Destination Locatio n window opens, choose a L
ONWORKS folder in which you want the
IzoT Commissioning Tool software installed, and then click Next. The IzoT Commiss ioning
Tool software will be installed in an IzoT Commissioning Tool folder below the L
ONWORKS
folder that you specify. If you previously installed other Echelon software on this computer,
use the same L
The default L
ONWORKS folder.
ONWORKS folder is C:\Program Files\LonWorks (on a 32-bit version of
Windows) or C:\Program Files (x86)\LonWorks (on a 64-bit version of Windows). If you
previously installed other Ech e lon software on this computer, the last L
ONWORKS folder that
you selected will be displayed as the de fault, and you cannot change this value.
g. The Ready to Install window opens. Click Install to begin the IzoT Commissioning Tool
installation.
h. If you need to reboot your computer, a window will appear prompting you to select to reboot
your computer now or later. After IzoT Commissioning Tool installation and any required
reboots have been completed, a window will appear, stating that IzoT Commissioning Tool
has been installed successfully and providing you with the option to view the Re adMe file.
The ReadMe file contains information that is not included in this user’s guide.
18 Installing and Activating the IzoT Commissioning Tool
Page 35
i. Click Finish. The ReadMe file opens if the Show the R e adme File check box was selected.
When you finish reading the ReadMe file, close the window.
j. A confirmation dialog opens stating that the selected components have been installed . Click
OK.
Note: Do not uninstall any of the following applications and components that are used by
OpenLNS CT: OpenLNS Server, OpenLNS XML Utility, OpenLDV, Visio, LonMark Resource
Files, Multi-Port Router 50, and the IP-852 Configuration Server. Uninstalling any of these
applications and components will cause IzoT Commissioning Tool to stop running.
9. If your computer was not attached to the Internet when you were installing OpenLNS CT, proceed
to the next section to manually activate your software. IzoT Commissioning ToolIzoT
Commissioning Tool will not run until it is activated.
IzoT Commissioning Tool User’s Guide 19
Page 36
Manually Activating IzoT Commissioning Tool
If your computer was not attached to the Internet when you installed Iz oT Commissioning Tool,
you can use the Echelon License Wizard to activate OpenLNS Server and IzoT Commissioning
Tool after you complete the software installation. You can activate your software via the Internet
if your computer is now online, or you can activate your software via e-mail or phone if your
computer is still offline. To use the License Wizard to activate your IzoT Commissioning Tool
software, follow t he se ste ps:
1. Open the Echelon License Wizard. Click Start, click Programs, point to Echelon License Wizard, and then cli ck License Wizard. The Echelon License Wizard opens. Click Next.
2. The Step 1: What would you like to do? dialog opens.
20 Installing and Activating the IzoT Commissioning Tool
Page 37
3. To activate your IzoT Commissioning Tool software using the over the Internet or via e-mail,
click Activate Product Licenses and then cli ck Next.
To activate over the phone, click Show Advanced Tasks, Upgrade a Product License over the Phone, and then follow the instructions in the License Wizard. If your computer is offline,
activate via e-mail if you have e-mail access because activating over the phone requires manually
entering ma ny lengthy a lpha-numeric strings.
4. If your computer is online, the Step 2: Wh at is Your Account Information dialog opens.
Complete the following steps to activate your software (if your computer is still offline, proceed to
step 5):
a. Enter your account information and/or your IzoT Commissioning Tool activation key, and
then click Next.
b. The Step 3: Which License Would You Like to A ctivate? dialog opens.
c. Select Activate from the Action list for both OpenLNS Server and IzoT Commissioning
Tool, and then click Next.
d. The Step 4: Status dialog opens, and the License Wizard activates your licenses.
e. Click Exit to close the License W izard.
5. If your computer is still offline, the Step 2: Which Product Would You Like to Get a License For dialog opens.
6. Enter your IzoT Commissioning Tool activation key in the Enter Your Activation Key box and
then click List Products. The License Wizard lists your OpenLNS Server and IzoT
Commissioning Tool products. Select Activate from the Action list for both OpenLNS Server
and IzoT Commissioning Tool, and then click Next.
IzoT Commissioning Tool User’s Guide 21
Page 38
7. The Step 3: Where Would You Like to Save Your License Requests? dialog opens.
8. In the Request File Name property, enter a full path where a license request file (.elwrq
extension) is to be saved, or click Browse, specify the directory where the license request file is to
be saved, and then enter a name for the file.
Under Authentication Details, ent er the Echel on ID (e-mail address) and Password you created
for your Eche l on downlo ad account (see step 2 if you do not have an Echelon download account).
The Activation Key box displays the 25-character alphanumeric string for the Echelon product to
be activated. Do not modify this property.
Click Next.
9. The Status dialog opens. The License Wizard confirms the creation of the license request file.
22 Installing and Activating the IzoT Commissioning Tool
Page 39
10.Click Send Request to Echelon to e-mail the license request file to Echelon at
activation@echelon.com. Eche l on will send you an e-mail message with a license response
(.elwrs extension) file. Fo r faster activation, copy the lic ense request file to an Internet-connected
computer with the License Wizard installed on it and importing it into the License Wizard. The
License Wizard creates the license response file, which you can then copy to the original
computer.
11. Import the license response (.elwrs extension) file into the License Wizard and activate your
OpenLNS Server and IzoT Commissioning Tool licenses follo wing these steps:
a. Start the Echelon License Wizard.
b. In the Task Selection dialog, click the Show Advanced Topics link, and then click the
Process a License Response File Obtained from Echelon option.
IzoT Commissioning Tool User’s Guide 23
Page 40
c. The Import License Request or Response File dialog opens. In the File Name property,
enter the full path of the license response file (.elwrs extension), or click Browse and then
select the file. Click Next.
d. The Check License Response File dialog opens. Confirm that the Echelon product licenses
in the license response file are the ones you want to activate. Click Next. The License Server
installs and activates the licenses in the license response file.
e. The Status dialog opens and confirms that the OpenLNS Server and IzoT Commissioning
Tool licenses have been successfully activated.
24 Installing and Activating the IzoT Commissioning Tool
Page 41
12.Click Exit to close the License W izard .
IzoT Commissioning Tool User’s Guide 25
Page 42
3
Getting Started
This chapter describes how to plan and create IzoT Commissioning Tool network
designs. It describes how to use the IzoT Commissioning Tool Design Manager to
create, open, and manage IzoT Commissioning Tool network designs, and it explains
how to set up a network interface that enables the IzoT Commissioning Tool to
communicate with the network. It summarizes the different IzoT Commissioning
Tool client types, and it explains how to use IzoT Commissioning Tool remotely, and
how to create and use user profiles.
26 Installing and Activating the IzoT Commissioning Tool
Page 43
Design Overview
To prepare to design an IzoT Commissioning Tool network, fo llow these st eps:
1. Define network requir ements and organization.
2. Select a network installation scenario.
3. Determine user permissions for viewing and changing the network.
4. Optimize network performance.
Defining Network Requirements and Organization
You can define your network’s requirements by evaluati ng which devices (sensors, actuators, and
controllers) are needed to achieve the desired network functions and how the devices will be integrated
into the network. For example, your network may need a simple fan coil unit, which could require a
fan start/stop relay, a cooling coil valve, and a supply air temperature sensor. You could use digital
output, analog output, and analog input devices, respectively, to integrate these devices (the analog
output module could also includes a PID controller you can use to control the fan co il unit).
Once you de fine the net work requirements, yo u can figure out how to organize the network in IzoT
Commissioning Tool. You can help organize the network by answering the following questions:
• How will devices and functional blocks be grouped within subsystems?
• Which functional blocks are needed for the devices to accomplish desired tasks?
• How do functional blocks need to be configured and connected to correctly interpret values from
sensors, perform any necessary calculations, and drive actuators?
Selecting a Network Installat ion Sc en ar io
You can design your entire network without commissioni ng any devices until after your design is
complete, or you can design your network and commission devices at the same time. These two
approaches are called installation scenarios. The first network installation scenario is called the engineered system and the seco nd is the ad-hoc system. You can use both scenarios wit hin a single
system, or you can use either exclusively. The best scenario for a given network de pends on many
factors including the skill level o f the i nstaller, desired flexibility for the ne twork, and the end-user
requirements.
Engineered System Scenario
The engineered system scenario allows you to desi gn the network without having acces s t o the
physical devices
First, you de s i gn the network offsite using IzoT Commissioning Tool. You drag IzoT Commissioning
Tool SmartShapes representing devices, routers, IP-852 routers, functional blocks, and connections
from an IzoT C ommissioning Tool stencil to an OpenLNS CT drawing a nd arrange t hem on the
drawing, and into multiple subsystems if desired.
Once you are onsite and have attached an IzoT Commissioning Tool compute r to the network, you
then commission the physical devices. IzoT Commissioning Tool commissions a device by
configuring the physic al device t o match the configuration that yo u s pecified i n the OpenLNS CT
drawing.
Engineered systems must often be modified during on-site installation due to differences between
as-drawn plans and the physical network. IzoT Commissioning Tool supports on-site changes to the
engineered system to a llow for these changes during commissioning.
The advantage of the engineered system scenario is that it makes network installation quick, easy, and
error-free because most of the time-consuming data entry and processing is done offsite during the
design phase. This scenario is often used for building and industrial automation systems, in which the
original design closely matche s the actual installation.
IzoT Commissioning Tool User’s Guide 27
Page 44
Ad-Hoc System Scenario
The ad-hoc system scenario allows you to design a nd install the network onsite. In this scenari o, IzoT
Commissioning Tool loads the network configuration information into each device as you define
devices, configurations, and connections. This is different from the engineered system sce nario in that
information is incrementally loaded to the physical devices.
The advantage of the ad-hoc system scenario is its flexibility, a s the in stalle r can make decisions
onsite. It is most appropriate for simpler systems in which the details of the system to be installed are
not known prior to commissioning.
The disadvantages of the ad-hoc system scenario are that it’s slower for large systems and requires the
same person to do both the network design and installation.
Determining User Permiss ions
When you create an IzoT Commissioning Tool network design, IzoT Commissioning Tool does not
assign any security to the network drawing. It defaults to one user—the administrator of the IzoT
Commissioning Tool drawing. While this default is permissible if one person is performing the
network inst allation in a secure e nvi ronment, it may not be suitable for multi-user or insecure
environments. In these environments, you need to create and manage user profiles to control access to
your IzoT Commissioning Tool network design. This will prevent any unauthorized changes to your
IzoT Commissioning Tool network design and enable you to better manage the installation or repair of
a system.
User profiles allow you to create access controls for a network drawing and its subsystems and set
privileges for actions that can be performed on IzoT Commissioning Tool objects. For example, you
could have a scenario in which a system integrator has access to the entire networ k and can add o r
change application devices and routers, while the installers can also access the entire network, but only
can commission the application devices and routers.
You might use a different scenario if you are working with multiple s ystem integrators who are all
supplying devices for your network. In this case, you can give each integrator access to their
subsystem o nly but allow them to freely change the subsystem drawin g and commiss i on devices. This
prevents one integrator from accidentally modifying a drawing created by another integrator.
By default, user profiles are not enabled for new networks. To enable user profiles, you must first
assign an Administrator password and create new user profiles as described in User Profiles. The
Administrator can create, modify, and delete user profiles.
Once you logon as a user other than the Administrator, you can still create new user profiles, as
described in Creating a New User Profile, and you can change your password as des cribed in
Changing Passwords.
For information on using user profiles with IzoT Commissioning Tool remotely, see Using IzoT Commissioning Tool Remotely with User Profiles.
Many factors affect the performance of an IzoT Commissioning Tool network design. The following
are guidelines for several aspects of your IzoT Commissioning Tool network design t hat can help
optimize network performance— especially for large networks.
Drawing Files
A single drawing file should not be larger than 3MB, or consist of more than 20 typical pages or 10
complex pages. If you are creating a network exceeding these guidelines, desig n the subsystems in
multiple drawing files. For optimum performance, devices and their associated functional blocks
should be contained within the same drawing file, as should all members of the same connection.
28 Getting Started
Page 45
When designing multiple drawing files, organize the individual drawing files as subsystems withi n the
top-level drawing file, and limit the top-level drawing to con tain only those subsystems. This
minimizes the number of drawing files that must be opened as you descend the subsystem hierarchy.
Avoid deep sub s yste m hier a rchies with long sub s ys tem names that re sults in long subsystem paths.
Subsystem paths may be stored in devices to help the network recovery process if you lose the network
database, but devices have limited memory available to store the network path. Furthermore,
visualization tools such as Wond erware’s InTouch
exceeded with long sub system pa ths.
®
have limits to item name lengths that can be
Network Changes
To improve network per formance when making n umerous network changes at one time, set IzoT
Commissioning Tool to OffNet. This will allow you to make the changes quickly, as the changes will
be saved in the OpenLNS network database instead of being sent to the physical devices. Whe n yo u
finish making the chan ges, set IzoT Commissioning Tool to OnNet and the changes are propagated to
the physical devices.
Connections
If you will be making changes to a subsystem, limit the number of connections monitored by IzoT
Commissioning Tool to less than five per subsystem. Having more than five monitored connec tions in
a subsystem will increase the time required to perform certain network management operations.
Alternatively, you can turn off a ll monitoring while making changes by right-clicking a clear space in
the subsystem page and clicking Enable Monitoring if it is curr e ntly set. You can turn monitoring on
again after making the changes.
If you are using an OpenLNS application that does not support monitor sets (groups of data points that
IzoT Commissioning Tool uses to monitor and control ne twork variables) and you are maki ng many
bound connections to the OpenLNS application, make the bound connections persistent. This will
improve network performance. Conversely, non-persistent bound connections, which can be created in
an IzoT Commissioning Tool net wo rk with OpenLNS applications other than IzoT Commissioning
Tool, can significantly increase the time required to open and close an OpenLNS CT drawing.
OpenLNS tools that support monitor sets, such as IzoT Commissioning Tool, enable monitoring of
monitor points to be setup quickly once an IzoT Commissioning Tool network is opened. This is
because points in monitor sets are always persistent. IzoT Commissioning Tool automatically creates
monitor sets for connection monitoring when monitoring is enabled on an IzoT Commissioning Tool
network. To enable monitoring, right-click a clear space in the subsystem page and clicking Enable
Monitoring if it is not currently set. For more information on monitor sets, see the OpenLNS
Programmer’s Guide.
Sharing the OpenLNS Interface with the LNS DDE Server
If the LNS DDE Server and IzoT Commissioning Tool are running concurrently and sharing the same
OpenLNS network interface, limit the polling rate of the LNS DDE server to 10 polls per second on a
ONWORKS channel. Ha ving the LNS DDE Server polling above this rate will degrade network
L
performance. By default, the LNS DDE server polls active network variables every 1 second, so more
than 10 active network variables running at the default poll interval can impact network performance.
You will see similar performance degradation if you have any other OpenLNS monitoring application
sharing the OpenLNS network interface with IzoT Commissioning Tool, or if you are using c onnection
monitoring in IzoT Commissioning Tool.
If you will be making numerous network changes, either disable the LNS DDE Server and any other
OpenLNS monitoring applications, or reduce the polling rate to a maximum of 10 polls per second
while you ar e making changes.
IzoT Commissioning Tool User’s Guide 29
Page 46
Functional Blocks
If you have a large network with many unconnected network variables on the functional blocks, delete
the unused network variable SmartShapes. Network variable SmartShapes add performance overhead,
yet they are not required if they are not connected. You can re-add network variable SmartShapes to a
functional block if you need to connect them later. To simplify following this g uideline, you can
create functional block master SmartShapes with your most commo nl y used ne t wor k var ia b le s. See
Creating a Functional Block Master SmartShape in Chapte r 4, Designing Networks for more
information.
Subsystems
Subsystems allow you to divide a large network into more manageable parts. For example, in a
building control network, one subsystem cou l d contain li ghting cont rols and another temperature
controls. Each subsystem is represented by a page of an OpenLNS CT drawing and by a subsyste m
SmartShape on the drawing page of its parent subsystem. You can nest subsystems li ke directories on
your computer, so the temperature control subsystem could contain other subsystems rep resenting, for
example, each floor of the building. You can also create subsystems in separate OpenLNS CT
drawings. Using this feature, you can create large networks while maximizing Visio’s performance by
limiting the number of p ages in a single drawi ng. Yo u ca n also create a separate OpenLNS CT
drawing for each user for large networks with multiple installers.
If you are creating a network that needs more subsystems than 20 typical pages or 10 complex pages,
you should divide it into two or more drawing files. For optimum performance, devices and their
associated functional blocks should be contained within the same drawing file, as should all members
of the same connection.
A supernode is a special type of subsystem SmartShape that has one or more network variable
interfaces on it. Any network variable or message tag on an y functional block in the subsystem may
be exported to the subsystem SmartShape. This does not create new network variables or message
tags, but exports the ne twork variable or message tag’s connection point one or more levels up the
subsystem hie ra rc h y. Using a supernode allows you to provide a simple interface to an arbitrarily
complex subsystem. For example, a supernode that contains lighting controls may have a network
variable interface that allows the devices contained within it to be put into emergency o verride. This
allows the integrator to easil y ide ntify the critical interfaces into the subsystem, while i gnoring those
that are typically only used internally by the subsystem.
IzoT Commissioning Tool Design Manager Overview
The IzoT Commissioning Tool Design Manager is an esse ntial tool for managing your IzoT
Commissioning Tool networks. With the IzoT Commissioning Tool Design Manager, you can create,
open, and delete networks; back up and restore networks to prevent against loss; and configure default
settings for new networks to speed up the network creation process.
To open the IzoT Commissioning Tool Design Manager, click Start on the taskbar, point to
Programs, point to the Echelon IzoT Commissioning Tool folder, and then click IzoT
Commissioning Tool. The IzoT Commissioning Tool Design Manager opens.
30 Getting Started
Page 47
The IzoT Commissioning Tool Design Manager consists of five tabs that let you perform the following
functions:
•General. Create, open, copy, delete, and backup/restore IzoT Commissioning Tool network
designs; start the OpenLNS Server application; and import and defragment OpenLNS network
databases.
• Options. Set a prioritized list of languages for L
• New Network Options. Configure default properties for the pages in the Network Wizard and
options to s kip the page s , and set the network components.
•IzoT Commissioning Tool Stencils. Add, remove, or modify the properties of IzoT
Commissioning Tool stencils.
•IzoT Commissioning Tool Default Options. Configure the default properties and behavior for
IzoT Commissioning Tool objects (for example, adding devices, adding functional blocks, and
backing up and synchronizing the OpenLNS database).
ONMARK resour ce files.
General
You can use the General tab in the IzoT Commissioning Tool Design Manager to create, open, copy,
delete, backup, restore IzoT Commissioning Tool network designs; start the OpenLNS Server
application so remote clients can access the OpenLNS netwo r k database; import a database and then
create a new OpenLNS CT drawing from it; and defragment OpenLNS net work databases. To us e the
General tab, enter the followi ng data in the boxes and click the following buttons:
New Network
IzoT Commissioning Tool User’s Guide 31
Page 48
Network Name
Specifies the name of the new IzoT Commissioning Tool network
Create Network
Creates and opens a new IzoT Commissioni ng Tool network design
Show all options
Displays all the pages in the Network Wizard as the network is
Existing Network
Drawing Directory
Selects a file from the folder indicated in the Drawing Base Path
Drawing Name
Selects an OpenLNS CT drawing from all the Op enLNS CT
Database Name
Selects an OpenLNS network database from all the OpenLNS
Open Network
Opens the OpenLNS CT drawing and associated OpenLNS network
Open Copy
Opens a copy of the OpenLNS CT drawing specified in the Drawing
Delete
Deletes the OpenLNS CT drawing and OpenLNS network database
design to be created. The name must be unique to all the IzoT
Commissioning Tool networks on this computer. You can enter up
to 16 characters and include embedded spaces. The name is not case
sensitive; therefore, you cannot create two networks with names that
differ only in capitalization.
The initial default network name is “Network 1”. IzoT
Commissioning Tool automatically increments the index in the
default network name so that the network names are unique for
subsequent networks you create using the default name. After you
create a network with a different name than the initial default, the
default network name will beco me the last network created with an
incremented index. For example, if you create a new network
named “Test”, the default network name will be “Test 1”. If you
create the “Test 1” network, the default network name will become
“Test 2”, and so on.
consisting of a new OpenLNS network database and a new
OpenLNS CT drawing.
opened, regardless if the Skip this Prompt option is selected for a
page in the New Network Options tab.
To create networks with one-click, clear this check box and select
the options in the New Network Options tab to skip the pa ges in the
Network Wizard.
list. To open an e xi sting IzoT Commissioning Tool network design,
select the folder containing the OpenLNS CT drawing file.
drawings contained in the selected drawing folder. Select the
OpenLNS CT drawing you want to open, delete, or backup.
network databases on this computer. Select the database you want to
defragment, delete, or backup, or from which you want to start the
OpenLNS Server. This field is not used for the Open Network,
Open Copy, and Restore operations.
database specified in the Drawing Name list. The Database Name
list is ignored by this operation.
Name list, making a copy of the OpenLNS CT drawings and the
associated OpenLNS network database. This copy is created like a
new networ k. (You will be prompted to choose a new top-level
drawing name and database path. The Database Name list is
ignored by this operation.)
specified in the Drawing Name and Database Name lists,
respectively. To delete only a drawing or a database, select <none>
32 Getting Started
in the appropriate list.
Page 49
Defragment Database
Defragments and recreates the index for the IzoT Commissioning
Start OpenLNS Server
Starts the OpenLNS Server applicatio n so that r emote client
Backup
Opens the IzoT Commissioning Tool Backup dialog, in whi c h yo u
Show all options
If this check box is selected, all of the network option windows will
Restore
Restores an OpenLNS CT drawing and OpenLNS network database
Import
Imports an OpenLNS network database (objects.dat file) into
Settings
Drawing Base Path
Determines the directory that will be used by the Drawing
Add
Lets you select a drawing folder to add to the Drawing Base Path
Exit
Closes the IzoT Commissioning Tool Design Manager. This does
Tool database specified in the Database Name list. This can reduce
the size of and decrease the access time to a network database that
has grown i n s ize because of many changes. Backup the database
before de fragmenting it in the event an error occurs during the
defragmentation process.
computers can access the OpenLNS network database.
can back up the network database specified in the Database Name
lists and all of associated drawing files.
See Manually Backing Up an IzoT Commissioning Tool Network in
Chapter 7, Maintaining Networks, for more information on how to
use the IzoT Commissioning Tool Backup dialog. See Backup/Restore Options in Appendix A for the default backup
options you can set.
be presented as the network is opened regardless if the Skip this Prompt option had been previously selected.
from an IzoT C ommissioning Tool backup file. See Restoring an
IzoT Commissioning Tool Network in Chapter 7, Maintaining
Networks, for more information. See Backup/Restore Options in
Appendix A for the default restore options you can set.
OpenLNS so that it opens in the Database Name box. The imported
database may have an OpenLNS CT drawing associated with it.
Select the folder containing the OpenLNS network database you
want to import. If the database does not have an OpenLNS CT
drawing associated with it, you can then click Create Drawing to
create an OpenLNS CT drawing based on the imported database.
Directory list. All of the folders in this directory will be listed in the
Drawing Directory list. You can browse through the folders to find
the desired path or enter the pathname.
list.
not close Visio or any open networks.
To automatically exit the Design Manager after opening an
OpenLNS CT drawing, c lick the Options tab in the IzoT
Commissioning Tool Design Manager and select the Exit Design Manager After Launching Visio check box.
Options
The IzoT Commissioning Tool Design Manager’s Options tab allows you to set a prior itiz e d list of
languages for L
IzoT Commissioning Tool User’s Guide 33
ONMARK resource files. This list i s then applied to all new networks you cr e a te .
Page 50
Languages
Lists the languages in the order they will be searched for device
Move Up
Moves the selected language up one position in the list.
Move Down
Moves the selected language down one position in the list.
When IzoT Commissioning Tool displays documentation for selected devices, functional blocks, and
network variables, it uses the definitions contained in L
ONMARK resourc e file information in different languages by specifying a prioritiz e d list of languages
L
ONMARK resource files in IzoT Commissioning Tool.
for L
ONMARK resource files. You can display the
You can set the resource file language for a specific network while in IzoT Commissioning Tool by
clicking Add-ins, clicking IzoT Commissioning Tool, clicking LonWorks Network, clicking Network Properties, and then click ing the Resource File Language tab.
The IzoT Commissioning Tool Design Manager’s Options tab contains the following options:
ONMARK
Set L
Resource Files
Languages
Allows available language-specific L
added, removed, or reordered in the languages list. When searching
for a resource definition such as an NV field name, IzoT
ONMARK resource files to be
Commissioning Tool searches the first language file in the list for the
device info rmation, then the sec ond language file in the list, and so on
until it finds the information for the sp ecified device. If no match is
found and the device information is found in the corresponding U.S.
English file, the English text will be used to display the information.
U.S. English is t he default language and cannot be removed from the
list. The language-specific L
ONMARK resource files add e d to the list
must be installed and availabl e to IzoT Commissioning Tool. Usually
they will have been installed if availab le a nd you click Add to add
them to the list.
information.
34 Getting Started
Page 51
Remove
Removes the selected language from the list.
Add
Adds a language to the end of the list.
Exit Design Manager
Selecting this option automati c a lly closes the IzoT Commissioning
Network Interface
Network Attached
Select this check box to specify that the IzoT Commissioning Tool
Network Interface
Select the OpenLNS network interface to be used for communication
after Launching Visio
Tool Design Manager a ft er launching Visio.
New Network Options
You can use the New Network Options tab to set the default net work interface, automatically register
plug-ins, set the default network management mode, and set the default drawing template. The
properties you set are then applied to each new network you create.
You can also select options to have IzoT Commissioning Tool skip the pages in the Network Wiz ard
when opening a network. If you additionally clear the Show all Options c hec k bo x unde r the New Network box in the General tab, you can create new networks with one-click, skipping all the pages
in the Network Wizard .
The IzoT Commissioning Tool Design Manager’s New Network Options tab contain s the following
options:
computer will be attached to the physical network so that IzoT
Commissioning Tool can communicate with the physical devices.
Clear this check box if you the IzoT Commissioning Tool computer
will not be attached to the network. This check box is cleared by
default.
Name
IzoT Commissioning Tool User’s Guide 35
between the IzoT Commissioning Tool computer and the physical
Page 52
network. This option is only available if you selected the Network
Skip Network Interface
Skips the ne twork interface page i n the Network Wizard when you
Plug-Ins
Register Plug-Ins
Select this check box to register all enabled plug-ins when you create
Skip Plug-ins Options
Skips the plug-in registration page in the Network Wizard when you
User Logon
Skip Logon Options
Skips the user logon page in the Network Wizard when you open an
Management Mode
Select when changes made in your OpenLNS CT drawing are
OnNet
Changes to the OpenLNS CT drawing are sent immediately to the
OffNet
Changes to the OpenLNS CT drawing are saved in t he OpenLNS
Skip Mode Options
Skips the ma nagement mode page in the Network Wizard when you
Network Components
Drawing Template
Lists the templates available fo r new IzoT Commissio nin g T oo l
Attached check box.
Options Page
Page
Page
create a new IzoT Commissioning Tool network.
a new IzoT Commissioning Tool network.
create a new IzoT Commissioning Tool network.
IzoT Commissioning Tool network.
transmitted to the physical device s on the network.
physical devices on the network. Select OnNet if you are
commissio ning an engineered system or if you are working on any
phase of an ad-hoc system.
network database, but are not propagated to physical devices until
IzoT Commissioning Tool is placed OnNet. Select OffNet if you are
designing an engineered system.
Once you have commissioned devices with IzoT Commissioning
Tool OnNet, you can make real-time changes to network variables
when IzoT Commissioning Tool is OffNet.
You can read and make changes to configuration properties while
IzoT Commissioning Tool is OffNet, but changes will not be
propagated until you set IzoT Commissioning Tool OnNet or you
manually propagate them (by right-clickin g a device, pointing to
Commissioning, and selec ting Propagate CP Values to Device on
the shortcut men u) .
Page
create a new IzoT Commissioning Tool network.
networks. The template is an empty Ope nLNS CT d ra wing tha t
specifies a default drawing background, styles, stencils, and other
IzoT Commissioning Tool settings. You can select from the
following three default IzoT Commissioning Tool templates that are
listed:
•LONWORKS is the initial default template used for new
networks. It uses U.S. measurement units.
ONDEMO is the template used to cr e a te a demonstration
•L
network. In a demo network, you can only create a maximum
of five application devices .
ONWORKSMetric is a template that uses SI measurement
• L
units for d rawing pages .
36 Getting Started
Page 53
Custom IzoT Commissio ning Tool templates installed in the
Root Subsystem Name
Specifies the top-level subsystem name, which opens on the title
Initial Channel Name
Specifies the name of the initial channel that is attached to the
Edit
Click the name of an IzoT Commissioning Tool stencil you wish to
Commissioning Tool stencil file. Conversely, you can change the
template directory are also liste d.
block on the top-center of the first page of each new OpenLNS CT
drawing. Subsystem names may be up to 85 characters, may include
embedded spaces, but may not include the period, backslash, colon,
forward slash, or double quote characters. Subsystem names are case
sensitive. The default top-level subsystem name i s “Subsystem 1”.
OpenLNS Network Interface in each new network drawing.
Channel na mes may be up to 85 characters, may include embedded
spaces, but may not include the period, backslash, colon, forward
slash, or double quote characters. Channel names are case sensitive.
The default root channel name is “Channel 1”.
IzoT Commissioning Tool Stencils
The IzoT Commissioning Tool Design Manager’s IzoT Commissioning Tool Stencils tab lists the
IzoT Commissioning Tool stencils that are initia lly available in the L
or creating a net work drawi ng. It allows you to add, remove, or modify the properties of IzoT
Commissioning Tool stencils.
ONWORKS template upon opening
The IzoT Commissioning Tool Stencils tab contains the following options:
modify and then click Edit. The Edit Stencil Properties dialog
opens. You can change the name of the IzoT Commissioning Tool
version or modify the description associated with an IzoT
IzoT Commissioning Tool User’s Guide 37
Page 54
stencil file associated with the IzoT Commissioning Tool ver sion or
Add
Click Add to open the Add New Stencil dialog. Click Browse, select
Delete
Click the name of an IzoT Commissioning Tool stencil you want to
description of a stencil file.
a Visio stencils (.vss) file from C:\Program
Files\LonWorks\LonMaker\Visio (32-bit system), C:\Program
Files (x86)\LonWorks\LonMaker\Visio (64-bit system), or from
another folder in your computer, and then click Open. You can then
enter the IzoT Commissioning Tool version and a description of the
selected Visio stencil. There is no limit on the number of characters,
and you can include embedded spaces , per iods , backsl ashe s , colons,
forward slashes, and double quotes . When you are done, click OK.
remove from the list and then click Delete (the stencil file is not
deleted).
IzoT Commissioning Tool Default Options
You can use the IzoT Commissioning Tool Default Options tab to set the IzoT Commissioning Tool
default properties for the new networks you create. This tab contains a list of IzoT Commissioning
Tool options categories such as options for configuration properties, devices, func t ional blo cks and for
backing up and synchronizing the IzoT Commissioning Tool network database. The default options
you set will be applied to each new IzoT Commissioning Tool network you create. Once you create a
new networ k, you can change any o f t he default options in the OpenLNS CT dra wing by clicking
Add-ins, clicking IzoT Commissioning Tool, and then clicking IzoT Commissioning Tool Options.
Click Restore Defaults to reset the options and values in the currently displayed options category to
their defaults.
You can set the default options for new networks in the followi ng options categories:
38 Getting Started
Page 55
• Backup/Restore
• Configuration Propertie s
• Device
• Functional Blocks
• General
• Naming Optio ns
• Network Explorer
• NV Browser/Monitoring
• OpenLNS Events
• IzoT Commissioning Tool Font
• Recovery
• Service Pin
• SmartShape ToolTips
• Synchronization
• Warnings
Appendix A details the defaults you can set under each network properties options category.
Setting Up a Network Interface
To attach your IzoT Commissioning Tool computer to a LONWORKS network, you must define and
configure an OpenLDV 4.0-compatible network interface or an IP-852 network interface before
starting IzoT Commissioning Tool. Networ k interfaces include the following:
•RNIs: SmartServer, i.LON 100 Internet Server, i.LON 600 IP-852 Router, and i.LON 10 Ethernet
Adapter.
•IP-852 network interfaces: SmartServer (with IP-852 routing option), i.LON 100 Internet Server
(with IP-852 routing option), and i.LON 600 IP-852 Router.
• Local USB network interfaces: U10/U20 USB network interfaces.
• Local PC card network interfaces: PCC-10 and PCLTA-10, 20, and 21 PCI network interfaces
(32-bit versions of Windows only).
•Serial network interface: SLTA-10 serial interface (32-bit versions of Windows only).
You can use the L
these OpenLDV 4.0 network interfaces.
ONWORKS Interfaces application in the Control Panel to define, configure, and test
Optimizing Network Interface Performance
To optimize the performance of IzoT Commissioning Tool when your IzoT Commissioning To ol
computer is attached to a L
(RNI, U10/U20 USB network interface, IP-852 network interface, or other network interface with a
Layer 2 MIP), if available . If you are using a PL-20 power line cha nnel or anot her slow channel, you
can use a legacy interface to limit network overhead (a high p er fo rma nce ne t wor k inte r fac e may
saturate the channel).
ONWORKS network, us e an OpenLNS high performance network interface
Using an IP-852 Network Interface
You can use an IP-852 channel to implement a LONWORKS co ntrol network over an IP network and
integrate multiple native L
channel as a backbone. If you are attaching your IzoT Commissioning Tool computer to an IP-852
channel, you can set up an IP-852 interface and create the IP-852 channel following these steps:
ONWORKS networks int o one large ne twork that uses a high-speed IP-852
1. Ensure that all of your IP-852 devices (for example, the OpenLNS Server computer, on e or more
IzoT Commissioning Tool computers, and one or more IP-852 routers) all have static IP addresses
IzoT Commissioning Tool User’s Guide 39
Page 56
or have dynamic IP addresses that do not change. A static IP address is an address that is not
dynamically assigned by a DHCP server.
2. Create an IP-852 interface on each computer that is to be connected to the IP-852 channel. This
may include the OpenLNS Server computer and one or more IzoT Commissioning Tool
computers. To create an IP-852 interface, follow these steps on each of the computers:
a. Open the L
ONWORKS Interfaces application in the Control P a nel.
b. Click the IP-852 tab.
c. Click Interface, point to Add, and t hen either clic k IP-852 Interface or click New Interface
and then click IP-852 in the Select Interface Type dialog.
d. The Add Network Interface Wizard dialog opens.
e. Specify the name of the new IP-852 network interface; the IP address, port, and channel
timing parameters; and authentication para meters. Click OK.
For more information on creating IP-852 network interfaces, see the LONWORKS Interfaces
online help file.
3. Define the IP-852 channel and devices in the IP-852 Configuration Server. To do this, follow
these steps:
a. Click Start on the taskbar, point to Programs, point to Echelon IP-852 Configuration
Server, and then click Echelon I P-852 Configuration Server.
b. Click Channel, and t hen click New C hannel. Enter a na me for the ne w IP-852 channel.
c. Right-click the new IP-852 channel you just created and then click New Dev ice. Enter a
name for the new device.
d. Right-click the new device and then click Device Properties. Enter the IP address for the
device.
e. Repeat steps c and d for each OpenLNS Server co mputer, IzoT Commissioning Tool
computer, and IP-852 router on the IP-852 channel.
40 Getting Started
Page 57
The devices on the IP-852 channel will not be fully commissioned until you run OpenLNS
applications such as the OpenLNS Server or IzoT Commissioning Tool on each of the
OpenLNS Server or IzoT Commi ssioning Tool computers. For more information, see the
IP-852 Channel User’s Guide.
Creating and Opening IzoT Commissioning Tool
Networks
An IzoT C ommissioning Tool network consists of an OpenLNS CT drawing and an OpenLNS network
database. IzoT Commis s ioning Tool provides several ways to create an IzoT Commissioning Tool
network, i ncluding the following methods:
•Create a new IzoT Commissioning Tool network design. Use this method if you are engineering a
new networ k, or if you want to redo the logical design of an existing network.
•Use an existing OpenLNS database to create an OpenLNS CT drawing. Use this method to use
IzoT Commissioning Tool with a network that was previously installed with a n OpenLNS
application other than IzoT Commissioning Tool.
•Create an IzoT Commissioning Tool ne twork design from an exis t ing physical network, which
creates a new OpenLNS network database and an OpenLNS CT drawing. This method is called
network recovery. Use this method if the network is operational and was origi nally installed with
an application not based on OpenLNS or was self-installed. You can also use this method with a
network tha t was previously installed with an OpenLNS applica tion, but does not have its original
network database. IzoT Commissioning Tool can recover a network without changing the device
applications or network configuration. See Recovering an IzoT Commissioning Tool Network in
Chapter 7, Maintaining Networks, for more information on how to use network recovery and for a
summary of the limitations of network recovery.
•Copy an exist ing IzoT Commissioning Tool network design. Use this method to create a new
network tha t is similar t o an existi ng network.
Creating an IzoT Commissioning Tool Network Design
You can create a new IzoT Commissioning Tool network design to en gineer a new ne twork or to redo
the logical design of an existing network. To create a new network design, you must use IzoT
IzoT Commissioning Tool User’s Guide 41
Page 58
Commissioning Tool as a local client (IzoT Commissioning Tool is running on the same computer as
the OpenLNS server).
To create a new IzoT Commissioning Tool network, follow these steps:
1. Click Start on the taskbar, point to Programs, point to Echelon IzoT Commissioning To ol, and
then select IzoT Commissioning Tool. The IzoT Commissioning Tool Design Manager opens.
2. Under New Network, enter the name of the network in the New Network box, or accept the
default netwo rk name.
3. Click Create Network to create the new network. Visio starts.
•When you initially start Visio 2010, a message opens informing you t hat Visio must activated.
Click OK and follow the activation instructions.
•When you initially attempt to create a network, a message opens informing you that Visio
must be launched and initialized so that it can work with IzoT Commissioning Tool.
•In addition, a warning opens as ki n g you if yo u wa nt to enab l e macr o s, which are required for
IzoT Commissioning Tool to function. Click Enable Macros. See Working with D igital Signatures for more information.
4. If you s e lected the Show all Options check box under t he New Network box in the IzoT Commissioning Tool Design Manager, or you cleared the check boxes for skipping the network
interface, management mode, and plug-i n options pages of the Ne twork Wizard in the New Network Options tab, the Naming dialog in the Network Wizard opens. Otherwise, you can s kip
to step 6.
42 Getting Started
Page 59
Network Name
Displays the net wo rk name. By defaul t, this is the current name in
Recover Database
Opens the OpenLNS Datab ase Recovery Wizard after completing
new OpenLNS CT drawing and network database from an existing
Tips:
•You can click Finish at any point in the Network Wizard. Doing s o will skip the subsequent
series of pages, and your new IzoT Commissioning Tool network design will be created using
the current s ettings in t he New Network Options tab of the IzoT Commissioning Tool
Design Manager.
•By default, the subsequent pages in the Network Wizard will appear each time you re-open
the OpenLNS CT drawing. Select the Skip This Promptwhen Re-opening this Drawing
check box on any of the pages you want to skip when re-opening the drawing.
•You can change any opti ons you set i n the Network Wizard in the Ope nLNS CT drawing.
Open the IzoT Commissioning Tool menu, click Netw o rk Properties, and then click the tab
containing the options you want to modify.
5. Edit the following information a s r e quired:
the Network Name box under New Network in the General tab of
the IzoT Commissioning Tool Design Manager. The default
network name is incremented if a na ming conflict exists.
You can change the name of the network. The name must be unique
to the network database, and it can have a maximum of 16
characters. The network name in the Network Database Path and
Network Drawing Path fields will automatically be update d to
match the name you specify.
from Network
IzoT Commissioning Tool User’s Guide 43
the Network Wizard. You can use the recovery wizard to create a
Page 60
operational network.
Network Database
Specifies the folder that will contain t he network database. By
Network Drawing
Specifies the folder that will contain the OpenLNS CT drawing. By
Network Descrip t i on
Contains an optional description of the network being created. This
See Recovering an IzoT Commissioning Tool Network in Chapter 7,
Maintaining Networks, for more information.
Path
Path
6. Click Next. The Network Interface dialog opens.
You can specify a different to place the OpenLNS CT drawing;
however, the network name in the drawing path must match t he one
in the Net work Name box.
field has no effect on network operation, but it can provide
additional documentation for as-built reports.
7. If your IzoT Commissioning Tool computer is attached to the physical network and you want IzoT
Commissioning Tool to communicate with the physical devices, select Network Attached. If yo u
select this option and you have more than one network interfaces in your computer, select the
name of the OpenLDV 4.0 or IP-852 network interface under Network Interface Name.
44 Getting Started
Page 61
Notes:
•The network interface you select must already have been defined and configured, as described
in Setting up a Network Interface.
•For IzoT Commissioning Tool to communicate on an IP-852 channel, the IzoT
Commissioning Tool computer must be configured as an IP-852 device on the target channel
using the IP-852 Configuration Server. If an IP-852 device name has not been defined, create
one in the
IP-852 Confi guration Ser ver as described in Using an IP-852 Network Interface
earlier in this chapter.
8. Click Next. If you specified that IzoT Commissioning Tool computer is attached to the physical
network, t he OnNet/OffNet dialog opens. If it is not atta ched, the Plug-In Registration dialog
opens and you can skip to step 11.
9. Select when changes made in your OpenLNS CT drawing are sent to the physical devices on the
network. You have two choices:
•OnNet. Changes to the OpenLNS CT drawing are sent immediately to the physical devices
as you make the changes. Select OnNet if you are commissioning an engineered system or if
you are wor king on any p hase of an ad-hoc system.
•OffNet. Changes to the OpenLNS CT drawing are saved in the network database and then
sent to the physical devices once IzoT Commissioning Tool is set OnNet. Select OffNet if
you are designing an engineered system. You can make real-time changes to network
variables whe n IzoT Commissioning Tool is OffNet once you have commissioned devices
with IzoT Commissioning Tool OnNet. You can read and make changes to configuration
properties while IzoT Commissioning Tool is OffNet, but changes will not be propagated
until you set IzoT Commissioning Tool OnNet or you manually propagate them (by
right-clicking a device, pointing t o Commissioning, and selecting Propagate CP Values to Device on the short cut menu).
Select this Skip the Prompt check box if you want the Network Wi zard to skip the
Management Mode page each time you open the IzoT Commissioning Tool network. If the
IzoT Commissioning Tool User’s Guide 45
Page 62
Register
Adds a plug-in to the Pending list, indicating that the plug-in is to be
in listed under any category or a
Deregister
Adds a plug-in to the Pending list, indicating that the plug-in is to be
Enable
Adds a plug-in listed under Disabled to the Pending category,
Disable
Adds a plug-in listed under Already Registered or Not Registered to
the Pending category, indicating that the plug-in is to be disable d.
Show all Options check box unde r Existing Networks in the IzoT Commissioning Tool
Design Manager General tab is selected, the prompt will appear regardless if this check box
is selected.
10. Click Next. The Plug-In Registration dialog opens.
11. Use the following commands to register, deregister, enable, and disable plug-ins in your IzoT
Commissioning Tool network.
registered. A plug-in must b e r e gister e d for it to be available within
IzoT Commissioning Tool.
This button is available when a plug category label (except Pending) is selected. If a category label is
selected, all the plug-ins under it will be registered.
deregistered. Once a plug-in is deregistered, it is no longer available
within IzoT Commissioning Tool.
This button is available when a plug -i n listed under Already
Registered is selected, can be deregistered, and supports being
deregistered.
indicating that the plug-in is to be enabled. You can enable a plug-in
that you previously disabled.
This button is available when a plug-in listed under Disabled or the
Disabled category label is selected. If the Disabled category label is
selected, all the plug-ins under it will be enabled.
46 Getting Started
Page 63
You can disable a plug-in to prevent IzoT Commissioning Tool from
Remove
Removes a plug -in from the Pending list. This button is available
Skip this Prompt when
Select this check box if you want the Network Wiza rd to skip the
ted, the prompt will appear regardless if
Register all Ne w
Select this check box if you want new plug-ins in the plug-in
If you are
Continue with
Opens and lets you set options in the authentic ation, domain
prompting you to regist er the plug -in.
This button is available when a plug -i n listed under Already
Registered or Not Registered or either of the category labels is
selected. If the Already Registered or Not Registered category label
is selected, all the plug-ins under the selected category label will be
disabled.
when a plug-in listed under Pendin g or the Pend i ng category label is
selected. If the Pending category label is selected, all the plug-ins
under it will be removed.
Re-opening Drawing
Plug-ins when
Re-opening this
Drawing
Advanced Options
12. Click Finish to open your new OpenLNS CT drawing.
13. If you are creating or opening an IzoT Commissioning Tool network for the first time, a message
opens informing you that the drawing being opened contains macros from the Echelon
Corporation, and asking you if you would like to enable macros for this drawing. Verify th a t the
macros wer e signed by Echelon Corporation, and then enable macros, which is required for using
IzoT Commissioning Tool. Set Always Trust Macros from this Source to automatically enable
macros for all OpenLNS CT drawings that are signed by Echelon
Plug-In Registration page each time you open the IzoT
Commissioning Tool network. If the Show all Options check box
under Existing Networks in the IzoT Commissioning Tool Design
Manager General tab is selec
this option is selected.
directory to be automatically registered each time you open the
OpenLNS CT drawing.
New plug-ins mu s t be registe red with W indows. The install a tion
program for the plug-ins typically does this automatically.
designing your own plug-ins see the OpenLNS Plug-in Framework User’s Guide for more information on how to create plug-ins and
register them with Windows.
definition, timing, a nd resource fi l e language pages in the Network
Wizard. See
Chapter 7, Maintaining Networks, for setting the options in these
pages.
Recovering an IzoT Commissioning Tool Network in
Creating an IzoT Commissioning Tool Network from an Existing
OpenLNS Database
You can create a new IzoT Commissioning Tool networ k design by opening an OpenLNS network
database that is not already associated with a drawing. IzoT Commissioning Tool will then create a
drawing for the database. You can us e this procedure to import an exis t ing networ k into IzoT
Commissioning Tool when the network was created with an OpenLNS a pplication other than IzoT
Commissioning Tool. To create a new IzoT Commissioning Tool network from an exi s ting OpenLNS
network database, you must use IzoT Commissioning Tool on a local client.
To create a new IzoT Commissioning Tool net work design from an exist ing OpenLNS database,
follow these steps:
IzoT Commissioning Tool User’s Guide 47
Page 64
1. Click Start on the taskbar, point to Programs, point to Echelon IzoT Commissioning To ol, and
then select IzoT Commissioning Tool. The IzoT Commissioning Tool Design Manager opens.
2. Under Existing Network, select which database you want to open in the Database Name list and
then select <none> in the Drawing Directory list. A Create Drawing command will appear in
place of the Open Network command.
3. Click Create Drawing. Visio starts and the Naming dialog of the Network Wizard opens.
4. Specify the folder that will contain the OpenLNS CT drawing in the Network Drawing Path box.
The folder must have the same name that opens in the Network Name box, but it may be
contained within another folde r. The Network Name and Network Database Path boxes are
read-only, as these settings are determined by the OpenLNS network database. Click Next. The
Network Interface dialog opens.
48 Getting Started
Page 65
5. Following steps 7 through 9 of Creating a New IzoT Commissioning Tool Network Design, select
whether IzoT Commis s i oning Tool is attached to the network, and if it is attached, select the
management mode (OnNet or OffNet). Click Finish. The Synchronizatio n Options dialog box
opens.
IzoT Commissioning Tool User’s Guide 49
Page 66
Create Shapes for all
Adds SmartShapes to functional blocks for all connected
Use Reference Shapes for
Represents all network variable connections created by the
Automatically Drop
Automatically adds SmartShapes to the drawing for all devices,
Minimize Drawings
Minimizes all the drawings in the IzoT Commissioning Tool
Check for Connections
Enables IzoT Commissioning Tool to check for connections to
Subsystem to Visio
Select in which Visio dra wing file to p la c e the subsystems in
6. Select the desired synchronization options and subsystem assignmen ts.
Connected NVs/MTs
all Connections
Device, FB, and
Subsystem Shapes
during Resync
network variables or message tags created by the
resynchronization.
If this chec k box is cleared, IzoT Commissioning Tool will use
generic connections when possible. It will still create network
variable or message tag SmartShapes for connections to
supernodes and for those functional blocks that already contain
network variable or message tag SmartShapes.
resynchronization with reference connection SmartShapes.
If this check box is cleared, IzoT Commissioning Tool will use
standard connection SmartShapes for connections for network
variable hubs and targets located in the same subsystem.
Reference connection SmartShapes are always used for
connections that span s ubsystems.
functional blocks, and subsystems created by the
resynchronization.
If this check box is cleared, IzoT Commissioning Tool will
prompt the user to select whether a SmartShape should be added
for a device, functional block, or subsystem created by the
resynchronization.
network during the resynchroniz ation. This sp eeds up the
resynchronization as it reduces the time Visio spends updating
the drawin gs.
for Missing FB Shapes
Document Assignment
7. Click Next. If you selected the Automatically Drop Device, FB, and Subsystem Shapes check
box, the Select Stencil dialog box opens. If you cleared this check box, skip to step 9.
functional blocks that are in the OpenLNS database but not
represented by a SmartShape in the OpenLNS CT drawing.
your network. You have four choices:
•Single Visio Document f or all Subsystems. Places all
subsystems in a single Visio do c ument.
•Prompt for Subsystem Document Ass ignme nt. Prompts
you to specify the Visio document for each subsystem.
•Separate Document for each Subsystem Hierarchy
below Root. Places each subsystem hierarchy below the
top-level subsystem in a separate, new Visio document.
•Custom. Opens the Subsystem Document Assignment
dialog. In this dialog, you specify the Visio document for
each subsys tem.
50 Getting Started
Page 67
8.Select the stencils that you want to be scanned for master SmartShapes.
•To add a stencil, click Add Stencil, select the desired Visio stencil file (.vss), and then click
Open or double-click the stencil.
•To remove a stencil, select the desired stencil and then click Remove. You can also re-order
the stencil positions by selecting a ste ncil and clicking Move Up or Move Down. Click
Finish.
IzoT Commissioning Tool will then search, in order, all the listed stencils. When objects are
found within the database that are not already represented in the drawing, IzoT
Commissioning Tool scans the listed stencils and automatically adds the appropriate
SmartShape to the drawing. If the particular master SmartShape for an object is not found, an
appropriate generic SmartShape (a L
ONWORKS Device SmartShape, for example) will be
used. After IzoT Commissioning Tool is done scanning stencils, the Synchr onization Status
dialog box opens.
9. You can monit or the progress of the resynchronization. When the resynchronization is complete,
click OK to open your IzoT Commissioning Tool network.
Working with Digital Signatures
Visio drawings can have VBA code associated with them through the use of macros and ActiveX
objects. Visio drawings that use this capability use Microsoft VBA signatures to p rovide security from
VBA viruses. Each time you create an IzoT Commissioning Tool network design, the te mplate that
you selected in the IzoT Commissioning Tool Design Manager (L
create the network drawing. This template uses VBA macros to implement the network drawing’s
ONWORKS functionality. This template and all Visio drawing s created from it are signed by the
L
Echelon Corporation.
ONWORKS.vst by default) is used to
Network drawings created with LonMaker releases before 3.1 will not have a digital signature.
Network drawings created with LonMaker Turbo Editions and LonMaker 3.1 or later may have
expired digital signatures. In addition, you can cause an OpenLNS CT drawing to lose its Echelon
signature by adding VBA code to it. This can happen if you add an ActiveX object or VBA code to
the OpenLNS CT drawing. Once a network drawing has lost its signature , it c annot get it back
IzoT Commissioning Tool User’s Guide 51
Page 68
automatically. If you have lost Echelon’s signatur e on a network drawing, you have three options: (1)
ignore the macro warnings as described in the next paragraph; (2) disable macro warnings as described
in the next p aragraph; o r (3) sign the drawing with your company’s di gital signature as described at
If an OpenLNS CT drawing does not have a digita l signature, you will see the macro warning dialog
and will have to enable macros every time the network drawing is opened, provided Visio’s macro
security is set to medium (the de fault). In ord er to change Visio’s macro security, open the Tools
menu, point to Macro and then select Security. A dialog opens allowing you to select Low, Medium,
or High security.
• If you select Low security, you will never see the macro warning.
• If you select Medium security, you will be prompted to enable macros for unsigned network
drawings or network drawings signed by companies that have not been added to the trusted
signatures list.
•If you select High security, macros will automatically be disable d (and IzoT Commissioning Tool
will not func tion) for unsigned network drawings, and you will be prompted to enable macros for
network drawings signed by companies that have not bee n added to the trusted signatures list.
Visio’s security level is persistent. When you change Visio ’s security level, it will be the security level
for Visio every time it is started until you change it again.
Tip: If your drawing cont ains Active X control s, change the security se tting to Low. Otherwise, Visio
will prompt you each time the drawing is opened as to whether to activate the co ntrols.
Copying an IzoT Commissioning Tool Network Design
You can create a new IzoT Commissioning Tool network design by copying an existing one. You can
use this procedure to reuse the drawings, options, plug-ins, master SmartShapes, and device templates
of an existing network design. You can also use this procedure to reduce the time required to create a
new networ k. To do this, create an empty net work d e sig n with all your desired plug-ins already
registered, and then copy the empty network design for each new network that you create. To copy an
existing IzoT Commissioning Tool network desig n, you must use IzoT Commissioning Tool on a local
client
To create a new IzoT Commissioning Tool network design by c opying an existing one, follow t hese
steps:
1. Click Start on the taskbar, point to Programs, point to Echelon IzoT Commissioning To ol, and
then select IzoT Commissioning Tool. The IzoT Commissioning Tool Design Manager opens.
2. Choose an IzoT Commissioning Tool network to copy. Under Existing Network, select a
drawing directory from the Draw ing Directory li s t, and then se l ect the network you wa nt to copy
from the Dr a wing Name list. Click Open Copy. A message opens prompting you to confirm
that you want to open a copy of the selected network, which will create copies of the OpenLNS
network database and all the drawings in the network.
52 Getting Started
Page 69
3. Click Yes. The Network Wizard ope ns and the Naming page opens
4. Follow steps 5–11 in Creating an IzoT Commissioning Tool Network Design . By default, t he
options selected in the existing network will be used in your new net work; however, you can
change any option. When you have completed the Plug-In Registratio n p a ge, c lick Next. The
Network Properties: Domain dialog box opens.
IzoT Commissioning Tool User’s Guide 53
Page 70
5.A new random domain ID is generated. To use a specific domain ID, clear the Use Randomly
Generated Domain ID check box and enter your ID in hexadecimal format in the Domai n ID
box. Click Finish.
6. If you are copying a network created with IzoT Commissioning Tool, your new IzoT
Commissioning Tool network will open and you can skip the remaining steps.
7. If the existing IzoT Commissioning Tool network design you are copying was created in a
previous version of LonMaker Turbo Editions (or earl ier versions of the LonMaker tool), the
Synchronize IzoT Commissioning Tool for Windows Drawing dialog box opens. This is
because the IzoT Commissioning Tool SmartShapes in the dra wing need to be updated to reflect
the current IzoT Commissioning Tool.
8. In the Synchronize IzoT Commissioning Tool for Windows Drawing dialog box, the Update Shapes to Current IzoT Commissioning Tool Version check box will be selected by default.
Select any other desired synch ronization options and click Next. The Choose Synchronization Scope dialog box opens.
9. Accept the defaults and click Next. The Choose Shapes and Ite ms to U pdate dialog box will
appear.
10. Accept the defaults and click Finish. The Synchronization Status dialog box opens as the
synchronization process begins .
11. The Synchroniza tion Status dialog box displays the progress of the synchronization. Once
“Synchronization Complete” opens, click OK to open your IzoT Commissioning Tool network
design.
For more information about the synchronization options in the preceding dialog boxes, see Manual Network Resynchronization in Chapter 7, Maintaining Networks.
Notes: If you open the copy of the IzoT Commissioning Tool network wit h IzoT Commissioning Tool
set OnNet, a message opens reminding you tha t the copy of the IzoT Commissioning Tool network
should not be attached to the physical network associated with the original. This is because the devices
54 Getting Started
Page 71
and routers will be updated to match the new network database. Verify that IzoT Commissioning Tool
is not attached to the original network and then click Yes to proceed with your IzoT Commissioning
Tool set OnNet. Click No to return to the Management Mode page and set IzoT Commissioning Tool
OffNet.
Any devices you created and commissioned in your original network will have the same Neuron IDs in
the copied version. To avoid conflicts, make sure the domain IDs of the original and copied IzoT
Commissioning Tool network designs are unique, or make sure that the copied IzoT Commissioning
Tool network design is not att ached to the physical network asso ciated with the origina l version when
you are usin g it.
Monitoring will be disabled in the copy of the IzoT Commissioning Tool network. To enable
monitoring, right-click a clear space in the drawing page and click Enable Monitoring. See Chapter
6, Monitoring and Controlling Networks, for more information on how to monitor and control
application devices.
Opening an IzoT Commissioning Tool Network Design
To open an e xisting IzoT Commissioning Tool network, follow these steps:
1. Click Start on the taskbar, point to Programs, point to Echelon IzoT Commissioning To ol, and
then select IzoT Commissioning Tool. The IzoT Commissioning Tool Design Manager opens.
2. Choose the IzoT Commissioning Tool network you want to open. Under Existing Network,
select the desired drawing directory from the Drawing Directory list, and then select the network
you want to open from the Drawing Name list. For networks with multiple drawings files, you
can select any of the drawing files associated with the network.
3. To skip any or all of the pages in the Network Wizard when opening the existing network, clear
the Show all Options check box under the Existing Network box. The pages in the Net work
Wizard will be skipped when you re-open the network provided that you previously selected the
check box at the bottom of the page (the Automatically Determine Server Location check box
for the Server Location page and the Skip This Prompt check box for all o ther pages). You can
also select the options to skip the pages in the Network Wizard in the OpenLNS CT drawing (to
do this, click Add-ins, click LonWorks Network, and click Network Properties). You cannot
skip the User Logon page if you have defined user profiles for the network (see User Pro f iles in
this chapter for more information).
4. Click Open Network.
IzoT Commissioning Tool User’s Guide 55
Page 72
5. If you are opening an IzoT Commissioning Tool network after starting IzoT Commissioning Tool
for the first time, a message may appear asking you if you want to enable macros. Yo u mu s t
enable macros for IzoT Commissioning Tool to function. See Working with Digital Signatures for
more information.
6. Visio starts, yo ur OpenLNS CT drawing opens, and the Server Location page of the Network
Wizard opens (unless you selected the Automatically Determine Server Location check box at
the bottom of this page when you previously opened the network).
By default, each subsequent page in the Network Wizard will appear every time you open the
OpenLNS CT drawing unless you previously se lected the Skip This Prompt check box on t he
page from the Network Wizard or from the Network Properties dialog in the drawing.
Tip: You can click Finish at any point in the Network Wizard to skip the subsequent series of
pages and open your IzoT Commissioning Tool network. Your IzoT Commissioning Tool
network will be opened using the se ttings in the Network Properties dialog in the drawing at the
time it was last saved.
7. Under Server Location, select the client type of the computer on which IzoT Commissioning
Tool is running. See IzoT Commissioning Tool Client Types for more information on each of
these client types.
•Select Local if IzoT Commissioning Tool is running on the same computer as the OpenLNS
Server.
•Select Remote Full Client if IzoT Commissioning Tool is running on a computer different
than the OpenLNS Server and the IzoT Commissioning Tool computer is attached to a
ONWORKS channel through an IP-852 channel.
L
•Select Remote Lightweight Client if IzoT Commissioning Tool is running on a computer
different than the OpenLNS Server and the IzoT Commissioning Tool computer
communicates with the OpenLNS Server over TCP/IP.
56 Getting Started
Page 73
Select the Automatically Determine Server Location check box to have IzoT
Commissioning Tool automatically determine the location of the OpenLNS Server whe n y o u
re-open your IzoT Commissioning Tool network. If this check box is cleared, IzoT
Commissioning Tool will prompt you to select the server location each time you open the
drawing.
8. Click Next. The Network Interface page opens, unless the Skip this Prompt check box w as
previously selected. Follow steps 7–12 in Creating an IzoT Commissioning Tool Network Design.
By default, the options previously selected for the network will be used; however, you can change
any option.
Note: You may open multiple IzoT Commissioning Tool network desig ns by repeating the
preceding steps. Each IzoT Commissioning Tool network design tha t you open will have its own
instance of Visio.
IzoT Commissioning Tool Client Types
The IzoT Commissioning Tool clien t ty pe determines the location of IzoT Commissioning Tool in
relation to the OpenLNS server. IzoT Commissioning Tool supports three client types: loc al client,
remotefull client, and remote lightweight client.
Local Client
A local client is an IzoT Commissioning Tool computer that is also running OpenLNS Ser ver. In this
configuration, a local network interface is attached to the OpenLNS Server computer, and IzoT
Commissioning Tool uses the local network interface to communicate directly with the physical
network. The following figure d e monstrates how IzoT Commissioning Tool connects to the physical
network when it is running as local c lie nt.
IzoT Commissioning Tool User’s Guide 57
Page 74
OpenLNS
Server
Device
1
Device
2
Device
3
Device
4
Device
5
Device
6
LonWorks Channel
OpenLNS
Server
OpenLNS CT
(Local Client)
Device
1
Device
2
Device
3
Device
4
Device
5
Device
6
LonWorks Channel
OpenLNS
Server
OpenLNS
Server
OpenLNS CT
(Local Client)
IP-852 Router
(SmartServer)
IP-852 Configuration Server
TCP/IP
IP-852 Channel
A local client can also be configured as a local IP client. In this configuration, the IzoT
Commissioning Tool computer is attached to an IP-852 channel and communicates remotely with the
network through an IP-852 router (SmartServer [with IP-852 routing option], i.LON 100 Internet
Server [wit h IP-852 routing option], or i.LON 600 IP-852 Router). IzoT Commissioning Tool is still
considered a local client because is it running on the same computer as the OpenLNS Server.
58 Getting Started
Page 75
LonWorks Channel
Device
1
Device
2
Device
3
Device
4
Device
5
Device
6
OpenLNS CT
(Remote Full Client)
OpenLNS
Server
IP-852 Router
(SmartServer)
IP-852 Configuration Server
IP-852 Channel
TCP/IP
OpenLNS CT
(Remote Full Client)
OpenLNS CT
(Remote Full Client)
OpenLNS
Server
Device
1
Device
2
Device
3
Device
4
Device
5
Device
6
LonWorks Channel
Remote Full Client
A remote full client is an IzoT Commissioning Tool computer that communicates with the OpenLNS
Server (running on a separate computer) over a L
Commissioning Tool computer uses a network interface to communicate with the network (for
example, a U10/U20 USB network interface or PCC-10, PCLTA-20, or PCLTA-21 networ k interface
card). As a remote full client, ne twork management tasks performed by IzoT Commissioning Tool are
routed through the OpenLNS Server, but monitoring and controlling tasks are sent directly to the
network.
ONWORKS channel. In this configuration, the IzoT
One or more IzoT Commissioning Tool computers and the OpenLNS Ser ver may also be connected to
the networ k.
The following example demonstrat es a scenari o in which the IzoT Commissioning Tool computers
communicate with the OpenLNS Server and the network over an IP-852 channel. The OpenLNS
computers d irectly route management tasks to the network via an IP-852 router.
The IP-852 Configuration Server creates virtual channels that direct packet traffic and enable the
IP-852 devices (IzoT Commissioning Tool computers, the OpenLNS Server, the IP-852 router, and
other IP-852 devices) to communicate with each other over the TCP/IP network. To create the IP-852
channel, you must use the IP-852 Configuration Server to add and configure all the IP-852 devices to
the networ k. For more information on using the IP-852 Configuration Server to create IP-852
channels, see Using an IP-852 Network Interface earlier in this chapter.
IzoT Commissioning Tool User’s Guide 59
Page 76
To use IzoT Commissioning Tool on a remote full client follow these steps:
1. Prepare for remote operations.
a. Co py any custom stencils that you will need to the OpenLNS CT drawing folder on the
OpenLNS Server computer.
b. Back up the OpenLNS CT drawing for the network you will be usi ng and all other files in the
drawing directory. See Backing Up an IzoT Commissioning Tool Network Design in Cha pter
7, Maintaining Networks, for instruction s.
c. Save the IzoT Commissioning Tool backup file to a shared network folder. If you do not
have a shared network folder, save the backup file to a CD, DVD, USB drive, floppy disk, or
other storage media.
2. Start the OpenLNS Server.
a. Click Start on the taskbar, point to Programs, point to Echelon IzoT Commi ssi oning Too l ,
and then select IzoT C ommissioning Tool. The IzoT Commissioning Tool Design Manager
opens.
b. Choose the OpenLNS network database you want to open from the Database Name list and
click Start OpenLNS Serv e r.
c. The Echelon OpenLNS R emote Server applica tion opens with the Network Interfaces
dialog.
60 Getting Started
Page 77
d. Select the OpenLNS network interface or IP-852 network interface to be used to connect to
ONWORKS channel. An OpenLNS Server or remote client can be attached to an IP-852
the L
channel using an IP network inte rface, such as an Ethernet network interface card (NIC),
WiFi interface, or a modem channel with PPP software. The network interface to the
ONWORKS channel must be defined and configured before opening an existing IzoT
L
Commissioning Tool network on a remote full client. Click OK. The OpenLNS Se rver
dialog opens.
e. The OpenLNS Server dialog displays the status for the open network. For more information
on using the OpenLNS Server, open the Help menu and click OpenLNS Server Help to view
the OpenLNS Utilities Onlin e Help System file.
IzoT Commissioning Tool User’s Guide 61
Page 78
f. To open an additional network, click Start OpenLNS Server on the IzoT Commissioning
Tool Design Manager. The OpenLNS Se rver window opens. Highlight the next net work to
open. Click Open Network. The Network Interface page opens. Select the network
interface. Click OK. Repeat this process for each additional network you want to open.
3. Copy the IzoT Commissioning Tool backup file that you created in step 1 to the remote client.
4. Start IzoT Commissioning Tool on the remote full client. Click Start on the taskbar, point to
Programs, point to Echelon IzoT Commissioning Tool, and then select IzoT Commissioning
Tool. The IzoT Commissioning Tool Design Manager opens.
5.Restore the OpenLNS CT drawings from the backup you created in step 1. See Restoring an IzoT
Commissioning Tool Network in Chapter 7, Maintaining Networks, for instructions. After
restoring the drawing files, a prompt opens a ski n g whether you want to open t he network drawing.
Click Yes to open the network drawing. The Network Wizard opens with the Server Location
dialog.
6. Select Remote Full Client to ac cess the net work and then click Next. The Network Interface
page opens.
7. Follow steps 7–12 in Creating an IzoT Commissioning Tool Network Desi gn.
Remote Lightweight Client
A remote lightweight client is an IzoT Commissioning Tool computer that communicates with the
OpenLNS Server (running on a separate computer) via TCP/IP. As a remote lightweight clie nt, the
network management, monitori ng, and controlling tasks performed by IzoT Commissioning Tool are
all routed through the O penLNS Ser ver. This means that all network variable reads and writes are
routed through the OpenLNS Server, which can create bottlenecks in the OpenLNS Server if multiple
remote lightweight clients are monitor ing and control multiple data points simultaneously. A remote
lightweight client can connect to the network without an IP-852 router.
62 Getting Started
Page 79
LonWorks Channel
OpenLNS
Server
Device1Device2Device3Device4Device5Device
6
OpenLNS CT
(Remote Lightweight Client)
TCP/IP
To use IzoT Commissioning Tool on a remote lightweight client follow these steps:
1. Prepare for Remote Operations.
2. Start the OpenLNS Server application.
3. Copy the IzoT Commissioning Tool backup file that you created in step 1 to the remote
a. Co py any custom stencils that you will need to the OpenLNS CT drawing folder on the
OpenLNS Server computer.
b. Back up the OpenLNS CT drawing for the network you will be usi ng and all other files in the
drawing directory. See Backing Up an IzoT Commissioning Tool Network Design in Cha pter
7, Maintaining Networks, for instructions.
c. Save the IzoT Commissioning Tool backup file to a shared network folder. If you do not
have a shared network folder, save the backup file to a CD, DVD, floppy disk, or other
storage media.
a. Ensure that the OpenLNS Server computer is not set up to go into standby mode. Standby
mode will prevent communication with remote clients.
b. Click Start on the taskbar, point to Programs, point to Echelon IzoT Com mi ss i oning Tool,
and then select IzoT Commissioning Tool. The IzoT Commissioning Tool Design Manager
opens.
c. Choose the OpenLNS network database you want to open from the Database Name list and
click Start OpenLNS Serv e r. The Network Interfaces dialog box opens.
d. Select the OpenLNS Network Interface or an IP-852 Network Interface you want to use to
connect to the L
ONWORKS channel. Click OK. The OpenLNS Server dialog opens.
lightweight client.
4. Start IzoT Commissioning Tool on the remote lightweight client. Click Start on the taskbar, point
to Programs, point to Echelon IzoT Commissioning Tool, and then select IzoT Commissioning Tool. The IzoT Commissioning Tool Design Manager opens.
5. Restore the OpenLNS CT drawings from the backup you created in step 1. See Restoring an IzoT Commissioning Tool Network in Chapter 7, Maintaining Networks, for instructions. After
restoring the drawing files, a prompt opens asking whet her you want to open the network d rawing.
IzoT Commissioning Tool User’s Guide 63
Page 80
Click Yes to open the network drawing. The Network Wizard opens with the Server Location
dialog.
6. Select Remote Lightweight Client to access the network and then click Next.
7. If the server address is configured correctly, you can skip to step 10, in which the User Logon
window opens. If there is a problem with the server address, or you are opening a drawing cr eated
using LonMaker, the Selecting a Remote Network Name dialog opens.
64 Getting Started
Page 81
8. Select an IzoT Commissioning Tool network to open. If a connection to this network has already
been established, click Next, and skip to step 10. If you are accessing the selected network over
an OpenLNS/IP interface for the first time, clic k Add/Remove. The Remote Networks Collection dialog box opens.
9. Under Remote Network Properties, the Address box displays the address of the OpenLNS
Server, and the Port box displays the port used for the OpenLNS/IP connection (the default is
2540, which is the default port for the OpenLNS Server). Both boxes are read-only. Click Add or
Edit to create a new remote network or modify an existing one . Click OK, select the newly
created remote network, and then click Next.
10. Follow steps 9–12 in Creating an IzoT Commissioning Tool Network Design.
IzoT Commissioning Tool User’s Guide 65
Page 82
Using Network Service Device SmartShapes
A network service device (NSD) is a local or remote client capable of monitoring and controlling the
network. Every OpenLNS Server and I zoT Commissioning T ool remote full client in a network may
be represented in an OpenLNS CT drawing with an NSD SmartShape. When an IzoT Commissioning
Tool network is created, it initially contains an NSD SmartShape for the OpenLNS Network Interface
that represents the OpenLNS Server.
If a remote full client is connected to a network, you can add an NS D SmartShape that represents the
remote full client to the OpenLNS CT drawing. Creating an NSD SmartShape makes that remote full
client permanent in the drawing; otherwise, OpenLNS automatically creates and deletes it each time
you open and close the network.
After you have added a network service device, you can add a virtual functional block to that NSD,
add network variables to the virtual functional block, and then connect the network variables. This
enables the NSD to monitor devices directly as described in Binding Network Variables to the Host in
Chapter 6, Monitoring and Controlling Devices. Additionally, this lets you perform the network
management tasks described in Chapter 8, Managing Networks.
To add a NSD SmartShape to an OpenLNS CT drawing, follow these steps:
1. Drag the Network Service Device SmartShape (
Shapes stencil to your OpenLNS CT drawing.
2. A dialog opens that allows you to select whether the network service device being added
represents the local NSD (only available if you are a remote client and yo u are using a NSD that
does not have a SmartShape associated with it) or a remote NSD.
) from the IzoT Commissioning Tool Basic
3. If you selected Remote Device in step 2, a dialog opens which allows you to select the local or
remote network service device to be associated with this network service device SmartShape. If
there is only one network ser vice device with no corresponding SmartShape, it will be
automatically selected.
66 Getting Started
Page 83
NSD Name
Specifies the name of the NSD, which is assigned by the OpenLNS
Type
Specifies the NSD type. This can either be NSS (the OpenLNS
Device Name
Specifies the NSD name in the format of <subsystem
Channel
Specifies the channel on which the NSD is attached.
Monitor Sets?
Indicates whether monitor sets are defined on the NSD.
User Name
Specifies the user name associated with the NSD. See User Profiles
Application
Specifies the name of the application currently active on the NSD.
Note: If you need t o remove a NSD from the physical network, first remove the network service
device SmartShape from the drawing by right-clicking it and selecting Delete from the shortc ut men u.
Listing Network Service Devices
If you are using IzoT Commissioning Tool with remote clients, you can view a list of all OpenLNS
clients connected to the network. Each client is represented by a network service device. To obtain a
list of all NSDs in a network, click Add-ins, point to LonWorks Network, and then select Network
Service Devices. The L
ONWORKS Network Service Devices dialog box opens.
This dialog box lists all NSDs in this network, regardless of whether a SmartShape has been created
for each NSD. For each NSD, the following information is listed:
Server.
Server) or NSI (a remote full client).
name>.<network service device name>.
for more informatio n on user name s .
If there is no application, or the application does not provide its name,
“Unknown” is displayed.
If the network service device is not responding, “No Response” is
displayed.
Click Remove to delete the selected network service device from the network. This option is generally
used to remove remote network service devices that are no longer in use, which improves the
performance of IzoT Commissioning Tool.
Click Monitor Sets to open the Monitor Sets dialog box, in whic h you can view and remove monitor
sets in the IzoT Commissioning Tool network. To delete a monitor set, locate the monitor set to delete
from the list, right-cli ck the monitor set, and then click Remove on the shortcut menu.
IzoT Commissioning Tool User’s Guide 67
Page 84
Upgrading Network Service Devices
When you upgrade IzoT Commissioning Tool or switch between an OpenLNS high performance
network interface (LonTalk la yer 2) and an OpenLNS network interface (LonTalk layer 5), you must
upgrade your ne t wor k ser vi ce device. Whe n you open the network and either of these conditions is
detected, IzoT Commissioning Tool will as k whether you want to upgrade. You should typically
perform the upgrade. However, if you are only using a different network interface temporaril y, you
may choose not to upgrade. In this case, communication with physical devices is limited until the
network is reopened with the origi nal network interface. If initially you choose not to upgrad e the
network service device and decide later to upgrade, select the NSD SmartShape, right-click it, and then
click Upgrade NSD on the s ho r tc ut me nu.
When moving from an OpenLNS high performance network interface (LonTalk layer 2) to an
OpenLNS network interface (LonTalk layer 5), all connections and monitor sets may not be created on
the new network interface. If this happens, a dialog displays the items that will be lost a nd give s you
an opportunity to cancel the upgrade.
Replacing a Local Network Service Device
When working as a remote full client, you can configure your local NSD to assume the configuration
(monitor sets, connections, and so on) of another, previously defined network service device. You can
do this by replacing a local NSD with the desired NSD SmartShape. The following conditions must be
met:
•Your current local NSD cannot have an NSD SmartShape associated with it. If it does, you must
first delete the NSD SmartShape from the drawing along with any associated functional block
SmartShapes and connections.
•The desired NSD must have a SmartShape in the drawing. If necessary, select one from the
template and drag it to the drawing.
When these conditions are met, select the desired NSD SmartShape, right-click it, and then click Make
Local NSD on the shortcut menu. Yo u have full access to the configuration of the selected NSD.
Note: The selected NSD must not currently be in use by another remote client. If it is, performing this
operation will disconnect the other user from the network.
User Profiles
With user profiles, you can set which parts of an OpenLNS CT drawing users can access and the
actions they can perform. For example, you could have a scenario i n which a sys t em integrator has
access to the entire network and can add, delete, or change channels, routers, devices, functional blocks
and all other objects. Operators, though, would only be able to access the subsystem they are installing
and be restricted to commissioning devices and routers in that subsyste m.
To enable user profiles on an OpenLNS CT drawing, you must first assign an administra t or password.
To set the administrator pass wor d, click Add-ins, point to IzoT Commissioning Tool, select User Profiles, enter the administrator password in the Password and Retype Password boxes, and then
click Apply. Passwords are case sensitive.
68 Getting Started
Page 85
Creating a New User Profile
To create a new user profile, follow these steps:
1. In the OpenLNS CT drawing, click Add-ins, point to IzoT Commissioning Tool, and then select
User Profiles. The User Profiles dialog box opens.
2. Enter the name of the new user name in the Name box, and the password in the Password and
Retype Password boxes. Both the user name and password are case sensitive.
IzoT Commissioning Tool User’s Guide 69
Page 86
UI Setting
If you are using Visio 2003, you can select the set of IzoT
Access Control
Select the type of access the user has in the OpenLNS CT drawing.
3. Set the user interface, access, and privileges of the new user.
Commissioning Tool and Visio menus that will be available to the
user. This option is not available if you are using Visio 2010. If yo u
are using Visio 2003, you have two choices:
•Maximum. This setting provides the user a full set of toolba rs,
menus, and menu items for advanced use of IzoT
Commissioning Tool.
•Minimum. Thi s s etting provides the user only the basic menus,
menu items, and toolbars necessary to use IzoT Commissioning
Tool.
You have two choices:
•All Subsystems. The user has unrestricted access to all of the
subsystems in the net work.
•Selection. The user’s access is restricted to the selected
subsystem. This option can only be applied to the root
subsystem o r any one of the subsystems one level below it. If
you select the root subsystem, the user cannot access any of the
subsystems below it.
70 Getting Started
Page 87
Privileges
Select which actions the user can perform on objects in the
OpenLNS CT drawing.
You can set privileges for reading, modifying, changing the name,
adding, deleting, commissioning, and replacing objects, as well as
the use of plug-ins for the objects. The objects for which you can s et
privileges consist of the network, subsystems, channels , applicat ion
devices, routers, functional blocks, connections, network variables,
and configuration properties.
While All Objects is selected, the privileges you set apply to all
objects. For example, to prevent this user from modifying any
object, click All Objects and then clear the Modify check box.
While Selection is selected, the privileges you set apply only to the
object specified in the Selection list. For example, to enable this
user to be able to modify functional blocks but not devices, click
Selection, select Functional Blocks, and then select the Modify
check box. Then select Application Devices from t he Selection list
and clear the Modify check bo x.
4. Click Create if you are logged on as the Administrator; otherwise, click OK.
Note: Once the new user profile has been created, that user can open the network drawing and then
change their password or create new user profiles. A user can grant a new user onl y those privileges
that they have themselves.
Changing Passwords
All users can change their passwords. To change a password, follow these steps:
1. In the OpenLNS CT drawing, click Add-ins, point to IzoT Commissioning Tool , and t hen select
User Profiles. The User Profiles dialog box opens.
2. Click the Change Password tab.
IzoT Commissioning Tool User’s Guide 71
Page 88
3. Type the old password in the Old Password box, ente r the new password in the New Password
and Retype Password boxes, and then click OK. The password will be changed.
Modifying and Deleting User Profiles
Only the Administrator can mo dify or delete a user profile. To modify or delete a user profile, follow
these steps:
1. In the OpenLNS CT drawing, click Add-ins, point to IzoT Commissioning Tool, and t hen select
User Profiles. The User Profiles dialog box opens.
2. Select a user profile to modify from the Name list.
3. To configure the user profile, change the options for the user interface, access and/or privileges,
and then click Apply. IzoT Commissioning Tool saves the changes for the selected user. If the
user is curr ently logged onto the ne twork drawing from another computer, they must close and
re-open IzoT Commissi oning Too l for the changes to take effect.
To delete the user profile, click Delete. A confirmation prompt opens. Click Yes to delete the
selected user.
Changing User Profiles in an OpenLNS CT Drawing
You can swit ch user pro fi les in an Op enLNS CT drawing. To change users, fol l ow these steps:
1. In the OpenLNS CT drawing, click Add-ins, point to LonWorks Network, and then select
Network Properties. The Network Properties dialog box opens.
2. Click the Logon tab.
3. Click Change User. The Enter User Name and Password dialog box opens.
72 Getting Started
Page 89
4. Enter the use r name and password of the user you want to lo gon as.
5. Click OK. You will be logged on as the selected user.
Using IzoT Commissioning Tool Remotely with User Profiles
When you open an IzoT Commissioning Tool network on a remote client, you will be prompted for
your user name and password (provided that the administrator password has been set for the network).
After logging on to the network, you will have the same privileges as you do when working on a local
client.
IzoT Commissioning Tool User’s Guide 73
Page 90
74 Getting Started
Page 91
Designing Networks
This chapter describes how to design a network using IzoT Commissioning Tool. It
covers how to create the following objects in an OpenLNS CT drawing: application
devices, functional blocks, network variables, routers, channels, and subsystems. It
explains how to connect network variables. It explains working with IzoT
Commissioning Tool SmartShapes and layers, customizing the IzoT Commissioning
Tool user interface, and using IzoT Commissioning Tool with AutoCAD drawings.
4
IzoT Commissioning Tool User’s Guide 75
Page 92
Creating a LONWORKS Network
You can design a LONWORKS network and then install it using IzoT Commissioning Tool. To design a
ONWORKS network wit h IzoT Commissioning Tool, you create an OpenLNS CT drawing. This
L
entails adding IzoT Commissioning Tool SmartShapes for channels, routers, devices, and functional
blocks; making logical connections between devices so they can send and receive data to and from
each other; and organizing the network into subsystems. You can add IzoT Commissioning Tool
SmartShapes at any time under any installation scenar io—you can add IzoT Commissioning Tool
SmartShapes while you are offsite designing t he network, or you can add them when you are onsite
commissio ning device s and perfo rming network maintenance.
To install t he network, you commis s ion the application devices and routers in it. Commissioning
associates the device SmartShapes created in the OpenLNS CT drawing with the physical d evices on
the networ k.
This chapter describes how to create an OpenLNS CT drawing. Commissioning devices is covered in
Chapter 5, Installing Networks.
Creating an OpenLNS CT Drawing
To create an OpenLNS CT drawing, you add application devices, routers, functional blocks, and other
IzoT Commissioning Tool objects to the drawing page. To add an IzoT Commissioning Tool object,
you drag its IzoT Commissioning Tool SmartShape from a stencil o nt o the drawing page. If required,
the appropriate wizard will then open and guide you through the process of creating that SmartShape.
The following sections describe how to create the objects in the IzoT Commissioni n g Tool Basic
Shapes stencil.
Notes:
•Several of the SmartShapes in the IzoT Commissioning Tool Basic Shapes stencil are discussed
elsewhere in this user’s guide. For creating Network Service Device SmartShapes, see Using Network Service Device SmartShapes in Chapter 3, Getting Started; for creating Data Point
SmartShapes, see Using Data Point SmartShapes in Chapter 6, Monitoring and Controlling
Networks; andfor using the Network Merge SmartShape, see Merging IzoT Commissioning Tool
Networks in Chapter 7, Maintaining Networks.
76 Designing Networks
Page 93
•If you have licensed IzoT Commissioning Tool as part of the NodeBuilder tool, the IzoT
Commissioning Tool Basic Shapes stencil is replaced with a NodeBuilder Basic Sha pes stencil
that includes Release Target Device and Development Target Device shapes.
Creating Application Devices
An application device consists of hardware and software that runs an application and communicates
with other devices usi ng the ISO/IEC 14908-1 Control Network Protocol. An application device in an
OpenLNS CT drawing corresponds to a physical device on the network.
To add an application device to t he network, you choose the device SmartShape and name, as well as
the template, location, channel, and optional description for the d e vice. You can add a device to
without IzoT Commissioning Tool being attached to the network.
When you add a device to your OpenLNS CT drawing, you must define it, but you do not have to
commission the device until yo u ar e ready to install it. This is how you design an engineered system.
You define and configure devices offsite; bring the network database onsite; and then com mission the
devices. Under the ad-hoc installation scenario, you define and commission the devices in one step
while onsite.
You can create an application device in one step. To do this, you enable automatic channe l selectio n
and then drag a custom device master SmartShape to your OpenLNS CT drawing, near the channel on
which the device will be attached. Otherwise, the New Device Wizard opens when you add a device
SmartShape to your OpenLNS CT drawing. See Using Automatic Channel Selection for Devices in
this section for how to enable this feature . See Chapter 12, Creating and Using IzoT Commissioning Tool SmartShapes and Stenci ls, for how to create and use custom device master SmartShapes.
The first page of the New Device Wizard includes a Commission Device c heck box for
commissio ning the device. Commissioning a device associates the physical device on the network
with the device SmartShape that you added to the OpenLNS CT drawing. To commission the device
immediately after defining it, select this check box.
To add a device to an OpenLNS C T drawing, follow these step s:
1. Drag a Device SmartShape (
other stencil to the drawing page. The Ne w Device Wizard opens unless you enabled automatic
channel selection and dropped a custom device master SmartShape near a channel SmartShape.
) from the IzoT Commissioning Tool Basic Shapes stencil or
IzoT Commissioning Tool User’s Guide 77
Page 94
Device Name
Enter the name of the device. This name must be unique within the
Number of Devices to
Select the number of devices to be created. If you create more than
Commission Device
Select this check box to commission the device after defining it.
2. Enter the following informatio n for the device.
currently displayed s ubsystem. The device name may be up to 85
characters and it may include embedded spaces; however, the name
may no t include period, backslash, colon, forward slash, or double
quote characters.
The default device name is the abbreviated device SmartShape
name followed by a dash, a space, and the instance number “1”.
The instance number in the default device name is incremented one
for each subsequent device of that type you create. For example,
the default device name of the first analog input device you create
is “AI- 1”, the second is “AI- 2”, and so on.
You can change this default naming convention by clicking
Add-ins, clicki ng IzoT Commissioning Tool, clicking IzoT
Commissioning Tool Options, and then selecting Naming from
the Options Category list. See Naming Options in Appendix A for
information on how to use the options on this page to change the
default na ming convent ion.
Create
one device, IzoT Commissioning Tool will automatically increment
the instance number in t he default names of the additional devices
and place them on the drawing adjacent to the first SmartShape. If
the device name does not contain an instance number at the end,
IzoT Commissioning Tool will append the instance number 1 to the
second device (for example, “Device” for the first device becomes
“Device 1” for the second device), and it will increment the
instance number for additional devices.
78 Designing Networks
This option is disabled if you are creating more than one device.
Page 95
Device Template
Create a New Device
Select this check box to create a new device template for the
Name
Displays the OpenLNS device template that defines the device’s
Channel
Auto-detect Channel
Select this check box to automatically detect the channel on which
Type
Select the channel type for the device. By default, this box displays
Name
Select the channel that you will attach to the device. You can
Template
device. If you select this check box, the Specify Device Template
window opens after you click Next. In this window, you can define
a new template by uploading the device interface definition from
the device or importing an existing device interface (XIF) file from
your computer.
This check box is unavailable for device SmartShapes with
pre-defined device templates such as the LonPoint device
SmartShapes.
interface. If the device SmartShape has a pre-defined device
template (such as the LonPoint d e vice SmartShapes), that template
will appear in the box. Otherwise, this b ox will be blank.
If you are creating a new device template, enter a name for the new
device template. If you are using an existing device template,
select one from the list.
the device is attached. For this option to function, IzoT
Commissioning Tool must be attached to the network, and all
routers between the OpenLNS CT drawing network interface and
the device must be installed, commissioned, and online. Otherwise,
an error will be returned during commissioning.
Selecting this check box disables the Type and Name boxes below.
Do not select this check box if you are using routers that are
configured as repeaters or bridges.
If this check box is cleared, you must explicitly select which
channel the device is on from the Name box.
the channel type of the channel currently displayed in the Name
list. You can use it to filter the existin g channels in the Name list
to those with a specific channel type.
You can limit the channel types displayed by specifying the
channel type in a custom device SmartShape.
create a new channel SmartShape by entering a new channel name.
The channel name must be unique within the network and be no
more than 85 characters long. If you are creating a new channel,
specify the channel type in the Type box.
3. Click Next. If you are creating a NodeBuilder device, a window opens allowing you to select the
NodeBuilder device template; otherwise skip to step 4. After you have created and/or selected the
NodeBuilder device template, click Next (see the NodeBuilder FX User’s Guide for more
information). The Device Properties window opens.
IzoT Commissioning Tool User’s Guide 79
Page 96
Location
Specifies a 6-byte location string that documents the device’s
Ping Interval
Enables the OpenLNS Server to ping the device periodically.
Pinging verifies that a device is still op e rating and communicating
4. Enter the following informatio n:
location within the network.
To store the device’s subsystem ID in this field, follow these steps:
1. Click Add-ins, point to IzoT Commissioning Tool, and then
2. Resynchronize the network. When yo u resynchronize the
If the Set Location Property to Subsystem ID check box is
cleared, you can enter an optional location description for the device.
You can enter up to 6 ASCII text characters, or up to 12 hex digits.
click OpenLNS Options. Select Recovery from the options
category list and then select the Set Location Property to
Subsystem ID check box under Subsystem Recovery Options.
network, select the Update Location Path and ID in Devices
check box in the Synchronize OpenLNS CT Drawing dialog.
The device’s current subsystem ID will be stored in this field.
The IzoT Commissioning Tool tool can then use this
information to place devices in their correct subsystems in the
event you need to use the OpenLNS database Recovery Wizard
to recover a lost network database.
See Recovering an IzoT Commissioning Tool Network in
Chapter 7, Maintaining Networks, for more information on the
network recovery process.
If you do not specify a value and the Set Location Property to Subsystem ID check box in the Network Properties:Recovery
options category is cleared, the current value in the device will be
uploaded into this field and store d in the OpenLNS database when
the device is commissioned.
80 Designing Networks
Page 97
with the network.
Description
Provides an optional description of the device. This de scr iption has
Set the ping interval based on the expected movement of the device.
Select Never to disable pinging. To enable pingi ng, change the ping
interval to 15 minutes if you expect the device will seldom move or
if the device is on a power line channel, 2 minutes if you e xpect it
will move somewhat frequently, a nd 1 minute if you expect it will
move frequently.
You must set a ping value for IzoT Commissioning Tool to display
device and functional block errors on their respective SmartShapes.
See Using IzoT Commissioning Tool Styles for more information.
no effect on network operation, but you can use it to provide
additional documentation for as-built reports.
5. If you selected the Co mmi ssion Device check box on the first page of the wizard, the first window
for commissioning the device opens. See Commissioning a Device in Chapter 5, Installing Networks, for i nstructio ns on commissioning your device.
If you did not select the Commission Device chec k box, click Finish to complete the device
definition process and add the device SmartShape to your OpenLNS CT drawing.
Using Automatic Channel Selection for Devices
You can use automatic channel selection to enable IzoT Commissioning Tool to automatically select
the appropriate channel for a new application device, skipping the New Device Wizard. This feature
lets you create a new device with a single click and drag. To enable automatic channel selection in
your OpenLNS CT drawing, follow these steps:
1. In the OpenLNS CT drawing, click Add-ins, point to IzoT Commissioning Tool , and then select
IzoT Commissioning Tool Options. The Network Properties dialog box opens.
2. Select Device from the Options Category list.
3. Select the Enable Automatic Channe l Se l e c tion check box.
4. Click OK.
IzoT Commissioning Tool User’s Guide 81
Page 98
You can also have automatic channel selection enabled by default in each OpenLNS CT d ra win g you
create or open. In the IzoT Commissioning Tool Design Manager, click the IzoT Commissioning Tool
Default Options tab, select Device from the Options Category list, and then select the Enable
Automatic Channel Selection check box.
The order of the criteria used by IzoT Commissioning Tool to select the appropriate channel is as
follows: (1) closest qualified channel to the device SmartShape, in which the channel SmartShape is
within 1 ½ times the width of the devi ce SmartShape; (2) most recently used or created channel; and
(3) other available defined channels. If no channel can be selected using the preceding criteria, the
New Device Wizard will appear.
Automatic channel selection only applies to those device SmartShapes that include a device template
definition and channel type information such as master device SmartShapes and copies of existing
device SmartShapes. The New Device Wizard will therefore always appear when you dr ag the generic
Device SmartShape from the IzoT Commissioning Tool Basic Shapes stencil to your OpenLNS CT
drawing.
Changing the Channel of an Application Device
You can move an application device to a different channel, preserving the device’s configuration and
all of its connections. You can do this to assign a device to a channel different than the one that was
automatically selected by IzoT Commissioning Tool, or to physically move a device to a different
compatible channel. To move a device to a different channel, you can either right-click the device and
then click M ove Device on the shortcut menu, or you can use the Connector too l on the Visio
Standard toolbar to gra phically move the device.
To use the Mo v e Dev ice command, right-click the device SmartShape and click Move Device on the
shortcut menu. See Moving IzoT Commissioning Tool SmartShapes in this chapter for how to move a
device using the Move Device command.
To use the Vi s io Connector too l to move the device, follow these steps:
1. Select the Connector tool (
2. Position the Connector tool over the “x” connection point of the device so that a red box opens
over the “x”.
82 Designing Networks
) on the Visio Standard toolbar.
Page 99
3. Click and hold the mouse button.
4. Drag the Connector too l to the center of the SmartShape of the desired channel so that a red box
opens around the channel SmartShape.
5. Release the mouse button.
6. Select a different tool on the Visio too lbar if you will not be making additional connections or
reassignment s (if you cont inue to use the Connector tool to add new devices, routers, or
functional blocks SmartShapes to your drawing, Visio will attempt to connect the SmartShapes,
which may not be desired or could generate errors.)
Creating Functional Blocks
A functional block encapsulates a set of network variables and configuration properties that perform a
specific device function. For example, a four-port digital input device could have functional blocks for
each of its four digital inputs. Each functional block would contain an output network varia ble
representing the state or setting of a digital input. In addition, each functional block co uld contain
configuration properties that control how frequently the digita l input data is transmitted to other
functional blocks. Ultimately, the task that the functional block pe rforms in this example is
transmitting the digital input data to other functional blocks (another f unctional block receiving the
digital input data could then use it to turn a lamp on or off).
You can create a functional block in one step. To do this, you enable automatic device selection and
then drag a custom funct i onal block master SmartShape to yo ur OpenLNS CT d r awing near the device
to which you want to assign the functional b lock. Otherwise, the New Functional Block Wizard opens
when you add a functional block SmartShape to your OpenLNS CT drawing. See UsingAutomatic
Device Selection in this section for how to enable this feature. See Chapter 12, Creating and Using
IzoT Commissioning Tool SmartShapes and Stencil, for how to create and use custom functional block
master SmartShapes.
To add a functiona l block to an OpenLNS CT drawing, follow these steps:
1. Drag a Functional Block SmartShape (
stencil to your OpenLNS CT drawing. The Functional Block Wizard opens unless you enabled
automatic device selection and dropped a custom functional block master SmartShape near a
device SmartShape.
) from the IzoT Commissioning Tool Basic Shapes
IzoT Commissioning Tool User’s Guide 83
Page 100
Source Functional
Name
Displays the name of the source functional block (a master
Type
Displays the functional profile represented by the source functional
Subsystem
Name
Specify the subsystem containing the functional block’s device.
Browse
Click to browse the subsystem hie rarchy and assign the functional
Device
Name
Select a device from a list of all the devices in the selected
you are creating a generic functional block SmartShape, all devices
2. Enter the following informatio n:
Block
SmartShape or an existing functio nal block) from which t he new
functional block was created.
This box will be empty if the functional block was created by
dragging the generic functiona l block master SmartShape to the
OpenLNS CT drawing.
block (open loop sensor object, for example).
This box will be empty if the functional block was created by
dragging the generic functiona l block master SmartShape to the
OpenLNS CT drawing.
The default is the subsystem containing the functional block.
block to a device in a different subsystem.
subsystem that supports the functi onal block you are creating. If
84 Designing Networks
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.