LonWorks Network Integration with Network Engines and LCS Technical Bulletin

Building Technologies & Solutions LIT-1201668 www.johnsoncontrols.com 2021-02-03 Release 11.0 2 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Contents Contents Introduction...... 7 Summary of changes...... 7 Related documentation...... 7 Key concepts...... 8 Archive database...... 8 Network Engine database...... 9 Network Engine database generation...... 9 Network configuration and device limits...... 9 NAE...... 9 LCS...... 9 SNE...... 10 SNC...... 10 LonWorks configuration tool...... 11 LNS device configuration plug-in...... 11 Integration overview...... 11 LonWorks network integration...... 11 Integrated LonWorks objects...... 11 Object hierarchy...... 11 LonWorks integration object...... 12 Views...... 12 Resource files...... 14 Items in the Navigation Tree in the Metasys SMP UI...... 15 LonWorks device object...... 16 Device naming conventions during Auto Discovery...... 16 LonWorks Point Objects...... 16 Mapping of field values...... 16 LonWorks Field Point object support...... 16 Mapping internal points of LN Series controllers...... 16 LonWorks device extensions...... 30 Detailed procedures...... 34 Adding a LonWorks integration object...... 34 Inserting resource files...... 38 Defining a network engine on the LonWorks trunk...... 41 Using Auto Discovery...... 42 Mapping LonWorks devices using Auto Discovery...... 43 Mapping Field Points in LonWorks devices using Auto Discovery...... 47 Manually mapping a series of LonWorks enabled devices...... 50 Manually mapping Field Points in LonWorks enabled devices...... 55 Using relearn in the Engineering view...... 57 Using the Engineering view to view device and point data...... 58

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 3 Using the Engineering view to command network variable inputs and edit NexSys point data...... 60 Viewing routers...... 60 Viewing detailed router information...... 63 Trending LonWorks device data...... 64 Troubleshooting...... 68 Appendix: Using a Flat LonWorks System with LCS...... 70 Basic system overview...... 70 Physical components...... 71 TCP/IP network...... 71 LCS85 control server...... 71 LNS computer...... 71 LonWorks IP routers...... 71 Logical components...... 71 CEA-852 standard...... 71 CEA-852 channels...... 72 CEA-852 configuration server...... 72 Basic system setup...... 72 Choose the 852 configuration server...... 73 Configure the 852 configuration server...... 73 Configure the LonWorks IP routers...... 73 Configure LNS computer...... 73 Complex system setup...... 74 Network partitioning...... 75 Guidelines for network partitioning...... 76 Basic partitioned system setup...... 77 Choose the 852 configuration server...... 77 Configure the 852 configuration servers...... 77 Configure the channels...... 77 Configure the LNS computer...... 78 Complex partitioned system setup...... 78 Appendix: LCS85 Gesytec 852 Configuration Settings...... 79 Introduction...... 79 Easylon IP interface configuration settings...... 79 Configuring the LCS85 for use with the Loytec configuration server...... 81 Configuration Servers...... 82 Configuring the Loytec configuration server...... 82 Configuring the Echelon configuration server...... 87 Configuring the LCS85 for use with the Echelon configuration server...... 89 Configuring LonWorks interfaces...... 90 Troubleshooting communication between the configuration server and devices...... 93 Product warranty...... 93

4 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Software terms...... 93 Patents...... 94 Single point of contact...... 94 Contact information...... 94

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 5 6 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Introduction

This document describes how to perform the tasks required to configure the network engine as a LonWorks network integrator, including how to: • add a LonWorks Integration object • insert resource files • define a network engine on the LonWorks trunk • map LonWorks enabled devices using Auto Discovery • map field points in LonWorks devices using Auto Discovery • map a series of LonWorks enabled devices manually • map field points in LonWorks enabled field devices manually • use the Engineering view to view device and point data • use the Engineering view to command Network Variable Input (NVIs) and NexSys® points • view detailed router information • trend LonWorks device data The Network Automation Engine (NAE) models, SNE series network engines, SNC series network control engines, and LonWorks® Control Server (LCS) with a LonWorks network interface serve as LonWorks network integrators within the Metasys system. Note: The LCS is a server; however, in this document, network engine refers to the NAE, SNE, SNC, and LCS unless otherwise noted. As a LonWorks network integrator, the network engine monitors and supervises LonWorks enabled devices on multiple network segments (or trunks) and is configured as a device on the LonWorks network. Data is presented on a web browser that is logged in to the web-enabled user interface of the engine, or to any other NAE, SNE, SNC, LCS, Application and Data Server (ADS), Open Application Server (OAS), or Open Data Server (ODS) requesting data over the IP network. Note: The NCE25, NAE35, and NAE45, referred to as small-capacity engines, do not support LonWorks integrations at Release 9.0.7. All small-capacity engines that feature the LonWorks integration must remain at Release 9.0 or earlier. Summary of changes The following information is new or revised:

• Updated SNE and SNC with 11.0 model numbers and device limits.

Related documentation

The documents in Table 1 contain information related to the installation, operation, and troubleshooting of the network engine in a Metasys system environment, and information on the software tools used to configure and update the network engine and the Metasys system. Once you are connected to an ADS, Extended Application and Data Server (ADX), OAS, ODS, NAE, SNE, SNC, or LCS, you can access important user information in the Metasys Site Management Portal Help (LIT-1201793) and Metasys SCT Help (LIT-12011964).

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 7 Table 1: LonWorks network integration – related documentation For information on See document NAE55/NIE55 Installation Instructions (Part No. Installing the NAE55 or NIE55 24-10051-43) NAE35/NAE45 Installation Instructions (Part No. Installing the NAE35 or NAE45 24-10050-6) NCE25 Installation Instructions (Part No. Installing the NCE25 24-10143-63) LCS85 Installation and Upgrade Instructions Installing and upgrading the LCS85 (LIT-12011623) Installing an SNC SNC Installation Guide (Part No. 24-10143-01892) Installing an SNE SNE Installation Guide (Part No. 24-10143-01647) Creating, editing, and loading archive databases Metasys SCT Help (LIT-12011964) with the System Configuration Tool (SCT) Metasys system supported LonWorks objects, Metasys Site Management Portal Help using the command status mapping tool (LIT-1201793) Commissioning the NAE NAE Commissioning Guide (LIT-1201519) LonWorks® Control Server (LCS) 85 Commissioning Commissioning the LCS85 Guide (LIT-12011568) Configuring and commissioning devices on the LN-Builder 3.5 Technical Bulletin (LIT-12011250) LonWorks trunk Echelon Corporation website: https:// www.echelon.com/ General LonWorks network information LonMark® Interoperability Association website: http://www.lonmark.org/ Creating and configuring a KNX third party Network Engine Commissioning for KNX Vendor integration Integration Application Note (LIT-12013148) Creating and configuring an M-Bus third party Network Engine Commissioning for M-Bus Vendor integration Integration Application Note (LIT-12013149) Network Engine Commissioning for Creating and configuring a Modbus third party Vendor Integration Application Note integration (LIT-12013150) Creating and configuring a C•CURE-victor third Network Engine Commissioning for C•CURE-victor party integration integration (LIT-12013151)

Key concepts Archive database The archive database is the Metasys system site database stored, archived by the System Configuration Tool (SCT). The archive database includes the network engine databases for one or more network engines on the site.

8 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Network Engine database The network engine database contains configuration information about the field controllers supervised by that network engine, and the points within those controllers mapped into the Metasys system. The network engine database resides in flash memory for the NAE and hard disk for the LCS. Any online changes to the database are not automatically saved to the flash memory or hard disk; you must perform an Archive command to save your changes. The SCT uploads and archives the NAE or LCS database from the flash memory to hard disk or other long-term storage media. The uploaded database or a database created offline in the SCT can also be downloaded from the SCT. Network Engine database generation To generate a network engine database of LonWorks enabled field devices, you must first set up a site database, define the network engine, and then populate the network engine with LonWorks enabled field devices and point objects. You can do this online by accessing the network engine in the Site Management Portal (SMP) UI from a separate computer or offline with the SCT; then the database can be downloaded later to the network engine. Note: We strongly advise that you do not browse to the SMP UI from a computer running a server-class operating system (OS). By default, Windows® Internet Explorer® Enhanced Security Configuration is enabled on server-class operating systems, and may prevent the SMP UI from launching or loading properly. Access the SMP UI from a computer that is not running a server-class OS. In online generation mode, the network engine database can be created using the Auto Discovery feature for LonWorks enabled devices and points within a network that are already configured and in operation. For other options, see the LonWorks network integration section. Network configuration and device limits Configuration and commissioning of the LonWorks trunk is performed using the LonWorks network configuration tool LN Builder. You may also use a third-party LonWorks network configuration tool, such as the Echelon® LonMaker® tool to configure and commission the LonWorks trunk. See the LonWorks network integration section. NAE Each NAE monitors and controls LonWorks field devices connected to its single LonWorks trunk. The LonWorks FT-10 trunk from the NAE is a single network segment, supporting up to 64 nodes without a repeater. Adding a physical repeater to the trunk allows the NAE to support 127 nodes on a single segment. Depending on the hardware model, the NAE can support up to 255 nodes if LonWorks routers are used on the trunks. Optimum performance is achieved using a maximum of 100 nodes or 1,000 Network Variables (NVs). The NAE supports up to 5,000 total objects, depending on the hardware model. Table 2: NAE limits Features NCE25/NIE29 NAE35/NIE39 NAE45/NIE49 NAE55/NIE59 NAE85 LON maximum 32 64 127 255 N/A devices

LCS The LCS connects to a CEA-852 channel, which runs on a TCP/IP-based network. It supports up to 20 LonWorks IP routers, up to 1,000 total LonWorks devices under those routers, and 10,000 objects total.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 9 Note: The implementation of up to 20 LonWorks IP routers has been tested in a lab environment. However, there are sites that successfully run with more LonWorks IP routers. Run more than 20 LonWorks IP routers at your own risk. You can increase the number of objects supported to 25,000 with an LCS license upgrade; however, permanent status item limitations apply after this upgrade. See the LCS permanent status item limitation section. Refer to Software Manager Help (LIT-12012389) for information about how to license software. LCS permanent status item limitation When you upgrade your LCS to 25,000 objects, Permanent Status Item support is limited to 11,000 items. If you exceed the 11,000 Permanent Status Item limitation, point values for Permanent Status Items no longer continuously update on each polling cycle. See Point object polling. In most cases, increasing the number of continuously polled items (Permanent Status Items) degrades the performance to an unacceptable level before reaching the 11,000 Permanent Status Item limit. For example, if your system has 10,000 Permanent Status Items with a 50 point-per-second scan rate, then the total scan time to complete one polling cycle is approximately 200 seconds, assuming optimal field conditions and router performance. User interaction, such as displaying LonWorks point objects, does not exceed the limit. The majority of Permanent Status Items stem from extensions and feature objects. For more information on Permanent Status Items, see the Permanent Status item count section. SNE All network engine models can integrate to the LonWorks network with the addition of a separate USB-to-LON interface adapter (ACC-USBLON-0). Refer to the SNE/SNC Product Bulletin (LIT-12013296). This required adapter connects the network engine to the LonWorks TP/FT-10 network. The LonWorks network connects to the 3-wire removable, keyed terminal block on the adapter. The SHD connection on the LonWorks network terminal block is an isolated terminal and is not connected in the network engine. Table 3: SNE limits SNE22000 SNE11000 SNE10500 SNE110L0 Features SNE22001 SNE11001 SNE10501 SNE110L1 LON network 2000 1500 1500 N/A variables LON maximum 255 127 60 N/A devices

SNC All network engine models can integrate to the LonWorks network with the addition of a separate USB-to-LON interface adapter (ACC-USBLON-0). Refer to the SNE/SNC Product Bulletin (LIT-12013296). This required adapter connects the SNC to the LonWorks TP/FT-10 network. The LonWorks network connects to the 3-wire removable, keyed terminal block on the adapter. Table 4: SNC limits SNC25150-0 SNC25150-04 SNC16120-0 SNC16120-04 Features SNC25151-0 SNC25151-04 SNC16121-0 SNC16121-04 SNC25151-0H SNC25151-04H SNC16121-0H SNC16121-04H LON network 1500 1500 1500 1500 variables LON maximum 64 4 64 4 devices

10 LonWorks Network Integration with Network Engines and LCS Technical Bulletin LonWorks configuration tool Any LNS based configuration tool, including LN Builder and LonMaker, can configure LN Series controllers. LNS device configuration plug-in LonWorks devices are configured using LN Builder. For ease of programming, all LN Series and Flexible System Controller (FSC) devices have plug-ins that allow the user to change device parameters. In addition to changing parameters, the FSC Plug-in allows the user to create an import file that preserves the custom point names that can be imported into the NAE, SNE, or SNC. You can also use the Point Schedule to make changes to points. Integration overview In the Metasys system, information coming from devices within an integrated network (LonWorks trunk, N2 Bus, BACnet IP network, or MS/TP network) appears in the same user interface framework as data native to the network engine. The following standard network engine functions are available for field points that are mapped into the network engine from devices in the integrated networks: • basic monitoring and commanding • alarm and event management • control system sequences and interlocking • scheduling • energy optimization • historical data management (trending) • audit trails (transaction data management) • system diagnostics LonWorks network integration LonWorks network integration enables the integration of LonWorks devices into the Metasys system. The LonWorks Integration object runs in a network engine. The network engine serves as a LonWorks compatible workstation, from which you can monitor and command LonWorks objects using network variables in LonWorks devices. The network engine maps the LonWorks network variables, NexSys® points, and LN Series free-programmable internal objects to integrated objects that you can use in Metasys system applications, and provides features such as alarming. Integrated LonWorks objects Integrated LonWorks objects represent LonWorks devices and network variables and appear in the Navigation tree. When you select an integrated LonWorks object, the Focus view displays LonWorks parameters in an available panel on the user interface. Object hierarchy The following figure shows the LonWorks object hierarchy found in the Navigation Tree.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 11 Figure 1: Object hierarchy

LonWorks integration object Use the LonWorks Integration object to configure the parameters for LonWorks network integration and its individual LonWorks trunk. Each LonWorks Integration object supports a single LonWorks domain, and only one LonWorks Integration object is allowed per network engine. Refer to the Metasys Site Management Portal Help (LIT-1201793) for further details on supported objects. Views The LonWorks Integration object offers five views:

• Focus view • Hardware view • Diagnostics view • Engineering view • Summary view

Note: Only the Focus view is available during offline configuration with the SCT. Focus view The Focus view contains basic user data including the object name and the device name of the host network engine for the LonWorks Integration object. Hardware view The Hardware view displays the selected object’s hardware related attributes/parameters and their defined values.

12 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Diagnostics view The Diagnostics view displays LonWorks diagnostic attributes, such as Statistics and Metrics, for troubleshooting purposes. You must send a Latch Statistics command to the LonWorks Integration Object to update these values. Users with high privileges can have access to this view.

Figure 2: Diagnostics view and Permanent Status item count

Permanent Status item count Found under the Metrics section of the Diagnostic view, the Permanent Status Item Count displays the number for Change of Value (COV) signups for LonWorks Point Objects (Figure 2). This attribute is especially important when observing the 11,000 Permanent Status Item limitation associated with an LCS85 license upgrade. Objects associated with the Permanent Status Item Count include the following:

• Alarm Extensions (including Intrinsic Alarming) • Trend Extensions (COV only) • Totalization Extensions (including Event and Runtime) • Load Extension • LCT Object (Input Reference Attribute) • Auto Shutdown (Control Attribute) • DLLR Object (EOI Attribute) • Data Broadcast Object (Input Reference Attribute) • Event Enrollment Object • Generator Load Control (JCI Control Start Reference and JCI Current Consumed WH Reference Attributes) • Global Data Share Object (Master and Alternate Master attributes) • Interlock Object (Interlock Definition Attribute)

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 13 • Loop Object (Reference Attribute) • Optimal Start Object (Control Attribute) • Signal Select Object (Input List and Average Output Attributes) When active, the following panels place the objects in the Temporary Status Item list and then move the objects immediately to the Permanent Status Item list until the panel is closed. Once you close the panel, the object moves back to the Temporary Status Item list if the Temporary Status Item Expiration Time has not expired. If the Temporary Status Item Expiration Time has expired, the object is removed from the Permanent Status Item list. • Graphic Object (each instance of a LonWorks Point Object when the graphic is active) • Global Search Query • Group Object (only when the Group Object is active) • Point Summary Display Panel • Device Point Summary Display Panel • User View Engineering view The Engineering view allows you to view data in LonWorks devices that are connected to the network engine or LCS LonWorks trunk. This view is typically used by advanced users with the appropriate access authority to directly view and change data in LonWorks devices. LN Series free- programmable internal points cannot be viewed or modified. The devices and network variables may or may not be integrated (mapped) to network engine objects in the Navigation Tree. Routers are shown in this view, but cannot be mapped as devices. Any devices or network variables that are mapped to network engine objects are displayed in a Mapped Devices folder. The Engineering view contains the Integration Tree and Integration view panels. The Integration Tree panel contains a list of known LonWorks devices connected to the network engine along with their network variables. The Integration view panel displays the details about the LonWorks device or network variable selected in the Integration Tree. Note: You must issue a device discovery command to view any routers in the Engineering view. After you create a LonWorks Integration object, the Integration Tree is empty until you add LonWorks enabled devices, either manually or by using Auto Discovery. See Detailed Procedures for instructions on adding LonWorks devices. The Engineering view Integration Tree is the only place you can view routers, as they are not shown in the Navigation Tree. Detailed information about each router is available in the Summary view. Mapped Devices folder A Mapped Devices folder is located under the LonWorks Integration object in the Engineering view. This folder only contains mapped devices and does not show routers because they cannot be mapped. Summary view In the Integration view section, you can use the Summary view to display a list of devices and the values of their network variables, or the Detail view to see the parameters of a selected item. The content in the Summary view is dependent on the device selected in the Integration Tree. Resource files The LonWorks network integration requires resource files to support integrating LonWorks enabled devices. Device resource files have file extensions of .XIF (External Interface File), .TYP (Type File), and .FPT (Functional Profile Template), and provide device type and configuration data.

14 LonWorks Network Integration with Network Engines and LCS Technical Bulletin For example, an LN-VAVLF-1 controller has the following three device specific resource files: LN- VAVLF-1 110.XIF, LNVAVL1.TYP, and LNVAVL1.FTP. Note: .TYP and .FPT resource files may not be provided. In this case, only the .XIF file is needed. Network Engine In addition to the device specific resource files, the LonWorks Integration object requires the STANDARD.TYP and STANDARD.FPT resource files, and a NVConfig.dat file. This NVConfig.dat file is created automatically, but you need to update it with the correct configuration data using a network configuration tool, such as LN Builder. See Defining a network engine on the LonWorks trunk. Note: Once you have created and updated the LonWorks Integration object, add all the resource files for the LonWorks enabled device types you intend to add to the LonWorks trunk. Adding, importing device data, or mapping a LonWorks enabled device before loading the resource files can produce undesired results that may require a reboot. Field device The network engine indicates whether the required XIF resource file is present with an attribute called XIF Present. This attribute is located under the Focus and Hardware tabs of the field controller. A value of True indicates that the required XIF resource file is present, and False indicates that the file is missing. If the file is missing, Critical Resource Missing is shown for the status of the device. An alarm message appears when an object without the required XIF file is added to the integration. If any other resource file type is missing, the point object may display Data Conversion Error.

Figure 3: Resource file indication

Items in the Navigation Tree in the Metasys SMP UI You can use LonWorks enabled devices, folders, and NVs that appear as integrated (mapped) objects in the Navigation Tree as object references, allowing the integrated object to be referenced as any other Metasys system object.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 15 The following rules apply when adding integrated LonWorks enabled objects to the Navigation Tree: • You must add integrated LonWorks device objects under the LonWorks Integration object. Note: You may add devices under a folder as long as the folder resides under the LonWorks Integration object. • You must add LonWorks point objects under a LonWorks device object. • To group LonWorks point objects within a LonWorks device, add folder (container) objects under the LonWorks device object and add the LonWorks point objects under a folder object. Note: See the Object hierarchy section for an illustration of objects in the Navigation Tree. LonWorks device object LonWorks Device Objects are a representation of a single LonWorks Field device. Each field device, identified through the DSN address, can be mapped only once. Device naming conventions during Auto Discovery Device names for auto-discovered devices consist of the device type (extracted from the device's Program ID) and its DNS address, providing a unique identifier for each device (for example, Plant Controller 42 0D 04). The DSN number is used as a unique identifier for each device. Since the DSN number is not a required part of the name, it can be removed if necessary. LonWorks Point Objects LonWorks Point Objects represent point data from a particular LonWorks Device Object. The data is represented as an analog input (AI), analog output (AO), binary input (BI), binary output (BO), multiple input (MI), and multiple output (MO). Generic integration objects (GIOs) can be added via import file only. Mapping of field values Each LonWorks Point Object can be mapped from an LN Series Internal, Network Variable, or NexSys Point object. In the case of Network Variable or NexSys Point, the mapping can be of the whole or a portion of the entity. LonWorks Field Point object support The Metasys system supports network variables of all LonMark SVNTs, all point types in NexSys controllers, and all LN Series Free Programmable Controller internal point types. Mapping internal points of LN Series controllers You can map the internal points of LN Series Free Programmable Controllers. Once you expose these points, you can monitor and control them from the network engine. The points include internal variables, constants, inputs, outputs, controllers, timers, and optimal start objects. Keep in mind that each mapped object contributes to the maximum object count allowed for the network engine. Table 5 shows a list of available mapping points. Note: The target reference is the type and number of the mapped field point or network variable, which must correspond to the point or NV index in the host LonWorks enabled device. When defining the object, replace the x by the index of the object being referenced. For valid network engine object types, AI stands for analog input, AO stands for analog output, BI stands for binary input, BO stands for binary output, MI stands for multiple input, and MO stands for multiple output.

16 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Table 5: Mapping of LN Points to Network Engine Objects Valid Network Engine Controller Type Object Type Target Reference Object Types Supported Variable LNV.x AI/AO/BI/BO/MI/MO LN-Basic Constant LNC.x AI/AO/BI/BO/MI/MO LN-Basic Input LNI.x AI/AO/BI/BO LN-Basic Output LNO.x AI/AO/BI/BO LN-Basic Controller LNCO.x AI/AO LN-Basic Optimum Start LNOS.x BI LN-Basic Timer LNT.x AI/AO LN-Basic Numeric Variable LNVN.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Enumeration Variable LNVE.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Numeric Constant LNCN.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Enumeration Constant LNCE.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Hardware Input LNHI.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Hardware Output LNHO.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Smart Sensor Inputs LNSI.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) Sensor Inputs LNWI.x AI/AO/BI/BO/MI/MO LN-GPI (all versions) LN-GPI-600 (all LN-GPI Boolean Variable LNVB.x BI/BO v12 model controllers) LN-GPI-600 (all LN-GPI Boolean Constant LNCB.x BI/BO v12 model controllers) Setpoint Constant LNCS.x AI/AO LN-GPI-600v2 only Wireless Output LNWO.x AI/AO/BI/BO/MI/MO LN-GPI (all versions)

Mapping Internal Points of LN Series -12 Model Controllers The LN Series -12 model controllers require the Communication (referred to as Comm) Sensors and Wireless Sensors to be manually mapped. The Auto Discovery process does not correctly identify the configuration for these NVs. Each LN Series -12 model controller supports up to 12 dynamic User Network Variable Types (UNVTs) that are configured by the LNS GPI Plug-in. Figure 4 shows configured Comm and Wireless Sensors. The Network Variable names and Format Names are updated to reflect defined configuration. The configuration must be known before mapping the LON points into the NAE, SNE, or SNC.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 17 Figure 4: Configured Comm and Wireless Sensors

Table 6 shows a list of available mapping points of the LN Series -12 Controllers for Comm and Wireless Sensors.

18 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Table 6: Mapping of LN Points to Network Engine Objects for LN Series -12 Models Valid Network Controller Type Object Type Target Reference Engine Object Types Supported LNSI.XXYYZZ

Note: LNSI.XXYYZZ, where XX is 1-12 (leading zero omitted), YY is the Comm Sensor from 01-12 (leading zero required), and Comm Sensors AI/AO/BI/BO/MI/MO LN-GPI v12 ZZ is the point number from 1-4. For example, LNSI.20503 = Uses nvoStatus02 (renamed to nvoComSensr05_08) and represents the fifth Comm Sensor for point 3. LNWI.XXZZ

Note: LNWI.XXZZ, where XX is 1-12 (leading zero omitted) and ZZ is the point number from 01-28 (leading zero required). Wireless Inputs AI/AO/BI/BO/MI/MO LN-GPI v12 For example, LNWI.728 = Uses nvoStatus07 (renamed to nvoWrIn22_28) and represents wireless point 28. A single wireless sensor can have up to 4 points defined. LNWO.XXZZ

Note: LNWO.XXZZ, where XX is 1-12 (leading zero omitted) and ZZ is the point number from Wireless 01-28 (leading zero required). AI/AO/BI/BO/MI/MO LN-GPI v12 Outputs For example, LNWO.612 = Uses nvoStatus06 (renamed to nvoWrOut08_14) and represents wireless point 12. For future use.

NAE, SNE, SNC LON integration SNVT override The Standard Network Variable Type (SNVT) Override is implemented to support LON devices that do not support updating the SNVT Table in the LON device to identify changeable SNVTs. Target Reference The Target Reference attribute is a string the LON Integration uses to resolve which item on the Point Object's controller to use for this object. See Figure 5. The basic format is:

• tt.ii.ff(ss) where tt is the type of item (for example, NV) • ii is the index of the item (using one or more digits) • ff is the (optional) field within the item (using one or more digits to identify a single part of the Network Variable)

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 19 For example, if you have an NV type SNVT_hvac_status, and you want to map another field to this object, such as heat_output_primary, use a field of 2, since it is the second field of the NV. • ss, which is not shown in Figure 5, is the (optional) SNVT ID for NVs (manually defines the SNVT the NAE uses based on the SNVT Master List). For example, NV.53(105), as shown in Figure 6, specifies that NV 53 is treated as SNVT_temp_p (105).

Notes:

• Do not confuse SNVT override with standard Override command functions. When you use SNVT override, it ignores the SNVT table information in the LON device for that point object. It uses what is defined in the Target Reference. • As a general rule, the SNVT defined in the NAE, SNE, or SNC (when using SNVT Override) should match the SNVT defined in the device. Failure to make a match may result in NAE, SNE, or SNC points reading an Unreliable status or the Present Value may not display the same value as what is displayed in LNS. When the NAE, SNE, or SNC LON Integration reads the XIF file at startup, it identifies any NVs with changeable SNVTs. This instructs the NAE, SNE, or SNC to interrogate the LON device for the SNVT table information related to the mapped point object. When the SNVT override function is used, it ignores this procedure and automatically uses the defined SNVT as identified in the Target Reference field of the mapped point object. Note: You can change the LON Point Object Target Reference attribute ONLINE and OFFLINE. If you change the attribute when ONLINE, you must reboot the network engine before the change takes effect.

Figure 5: Target Reference NV.7.3

20 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 6: Target Reference NV.53

Figure 7: Identifying a changeable SNVT from the XIF file

SNVT_str_ascii functionality SNVT_str_ascii is supported using either a BI or BO LON Point Object Type and is read-only regardless of how it is mapped. Only a single LON point object is required to display the full 31- character ASCII text. The point object can be mapped using either the point Auto Discovery process or the manual mapping process. When mapped manually, make sure to use the structured Target Reference and not an individual field. The full ASCII text is displayed under the Hardware tab (Figure 8) of the point object in the Text attribute. The Text attribute can be placed on a graphic to easily display the ASCII text.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 21 Figure 8: Hardware tab – SNVT_str_ascii

Figure 9 shows how LN Builder displays the ASCII data.

22 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 9: SNVT_str_ascii displayed in LN-Builder

Commands Integrated LonWorks objects support only those commands that can be executed by a standard LonWorks (LonTalk®) service and network variables. Most Integrated LonWorks objects support commands by writing a value to the network variable. Refer to the Metasys Site Management Portal Help (LIT-1201793) for specific objects and the commands supported in the system. Command and Status Mapping Tool The Command and Status Mapping Tool provides the ability to perform command and status mapping conversions for digital point objects. Custom scale/offset LonWorks network communications are broadcast in metric units. The LonWorks Integration can automatically convert those units for most cases. In those situations where automatic conversion is insufficient, Custom Scale/Offset provides the ability to scale analog values through the Custom Scale/Offset field on the Hardware tab of analog objects. For the normal case, a temperature value polled from an NV on a LonWorks device using a SNVT_temp_p has a metric value in Deg C. By setting the Hardware tab (field) units to Deg C and the Focus tab (display) units to Deg F, the conversion between the two is performed automatically. This conversion may be insufficient when mapping network variables using SNVT_count_inc because it has no units and often contains encoded values. In this case, consider disabling the automatic unit conversion, depending on the encoding of the value. To disable the automatic unit conversion, set the units for both the field and display units to the same selection. Any Custom Scale/Offset calculation is still performed, but the unit’s conversion is ignored.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 23 For example, to add a multiplier of 0.1 to a mapped network variable that normally shows 831 to represent 83.1 Deg F, add a Custom Scale/Offset formula of x*0.1 and set both the Field Units and the Units to Deg F. Note: By default, the math performed by the Custom Scale/Offset is applied after the unit conversion. To apply the conversion first, place a B in the field before the formula. In the Focus tab, if a conversion sends a value that is outside the Min/Max range, the point displays ??? and Unreliable in the header. The Reliability attribute located under Status indicates if the value is above or below the range. In Figure 10, the Reliability attribute indicates Out of range high, or a value above the maximum.

Figure 10: Focus tab

Figure 11 shows the Hardware tab with Custom/Scale Offset formula (X*.1). Using this formula changes the original value from 1418 to 141.8. The Out of Range and Unreliable errors no longer appear, since the point is now in range. Note: The point status in the header only changes when a COV occurs. The units and reliability change shortly after the units change or the point goes into range.

24 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 11: Hardware tab

Unreliable may appear if the point is out of range (high or low) or the Hardware and Display units are not valid (gallons per minute [GPM] to Deg F and other invalid unit conversions). Unit conversions The Display Units and Field Units attributes define the conversion required to display the Present Value correctly. Table 7 and Table 8 show examples of some valid and invalid configurations. For SNVTs that are mapped using the Auto Discovery process, the Display Units and Field Units attributes are automatically set to the correct units. When manually mapping LON Point Objects, take care to correctly set the Display Units and Field Units attributes to prevent an incorrectly displayed Present Value. Table 7: SNVT_temp_p conversions

Field Units Display Units Custom Scale/ Valid Unit Conversion (Hardware Tab) (Focus Tab) Offset Deg C Deg F Yes Automatic Optional Deg C Deg C Yes No Optional Blank Blank Yes No Optional Data Conversion Error Deg F Gpm No – (temperature to flow)

You can select display units for hardware temperature points on the LN-PRG controllers through the point’s Hardware tab. If Deg F is selected and the network engine is polling a SNVT_count_inc or a UNVT field, the value represents a raw Deg F value; otherwise, the controller displays a raw Deg C value.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 25 Table 8: SNVT_count_inc conversions Field Units Display Units Unit Custom Scale/ (Hardware Valid Field Data (Focus Tab) Conversion Offset Tab) Lps Lps Yes 200=100 LPS Disabled x/2 Lps Gpm Yes 200=100 LPS Yes x/2 Deg F Deg F Yes 831=83.1 Deg F Disabled x*0.1 Deg C Deg F Yes 252=25.2 Deg C Enabled B x*0.1 No Units No Units Yes 1000=1000 Disabled None Data Conversion Deg F Gpm No 831=83.1 Deg F Error – (temperature to flow)

Update Interval (Command Heartbeat) The Update Interval attribute (Figure 12) is provided for every LonWorks output point object. This attribute enables a recurring heartbeat message from the network engine to controllers that require periodic contact. If a heartbeat message is not present, some LonWorks devices revert to local control. Update Interval takes an integer value in seconds. The default is 0 seconds, which disables the heartbeat. The network engine can issue one heartbeat per second (maximum). Note: To prevent excessive traffic over the network, we recommend that you use an interval between 2 and 5 minutes (120 to 300 seconds), and enable the interval for no more than two objects per LonWorks device. Use this capability sparingly. You may configure an update interval of 1 minute, but if you do so, decrease the number of points on the network that use this attribute. For example, if you configure over 60 objects at 1-minute update intervals each, the network engine cannot issue updates to all of them within that minute, which causes delayed updates. Once you enable the Update Interval, you must activate it by commanding the point to a different value or state, restarting the network engine, or taking the LonWorks device offline temporarily. You should also make sure the point is set for Auto Restore by assigning a value of True. Auto Restore restores the last command on the field device when the point returns from an offline condition, or when it is first starting up.

26 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 12: Update interval attribute

Indication of Hand-Off-Auto switch The Focus and Summary screens (Figure 13) show the current condition of a Hand-Off-Auto (HOA) switch for all hardware outputs (analog and digital) supported by the FSC and LN-PRG410/510 controller. The condition is indicated on the Focus and Summary screens for these point types on these device types. If you place the switch in the Hand or Off position, the condition shown for its point is HW Override. The actual value for an analog output (AO) in the Hand position is unknown to both the FSC and the network engine. A binary output (BO) placed in the Hand position correctly reports the value to the FSC and the network engine. For LN-PRG410/510 controllers using basic programming, the network engine automatically reads the actual output for any point in Hand or Off mode, regardless of whether the point is binary or analog, as defined by the output potentiometer when you enable HOA. The LN-PRG410/510/610 controllers that use the graphical programming interface (GPI) do not support the HOA indication status feedback.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 27 Figure 13: HOA switch indication

Point object polling Point object polling provides on-demand point status updates. Point objects can be polled on either a permanent or temporary basis, depending on the configuration of the system. Permanent status items Permanent point object polling occurs for point objects having an alarm extension, a change of value/change of state (COV/COS) extension, or a trend COV extension. (Sample trends are not considered permanent status objects.) Temporary status items Temporary point object polling polls the point as long as Present Value reads continue. This scenario prevents unnecessary polling of points. Whenever Present Value requests for that point are received, the Temporary Status Item Expiration Time period begins. When the Temporary Status Item Expiration Time period expires, all polling for that point stops. Temporary point object polling is typically used for interval trends. Temporary Status Item Expiration time The Temporary Status Item Expiration Time is the global, user-defined time period for temporary point object polling, applied per individual object. Each time a point object receives a Read Attribute of the Present Value, the Temporary Status Item Expiration Time begins. Polling for the point stops when the Temporary Status Item Expiration Time expires.

28 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Notes:

• The Temporary Status Item Expiration Time is configured in the Detail view Hardware tab of the LonWorks Integration Object, and defaults to 60 seconds. • Changing the Temporary Status Item Expiration Time to a value greater than the trend interval results in nonstop data trending. Priority levels All point objects are assigned a priority level. Priorities are assigned on a point-by-point basis, using a three-level priority scheme. The most critical points are assigned Priority 1, less critical points are assigned Priority 2, and non-critical points are assigned Priority 3. Priority 3 is the default value for all objects. Note: The three-level priority scheme is not maintained if the number of point objects assigned Priority 1 is greater than the number of point objects assigned Priority 2 or Priority 3. Every time a polling cycle takes place, a preset number of objects have their status updated, based on their priority setting. Table 9 shows the number of objects updated per polling cycle for each priority level. Table 9: Priority Object Status Updates Total Objects Updated per Priority Level Critical Designation Polling Cycle Priority 1 Most Critical 3 Priority 2 Critical 2 Priority 3 Least Critical 1

Priority polling example The priority polling process follows a specific pattern where each priority value is selected individually in a sequential manner. The following example moves through two complete cycles, using the priority values in Table 10, Table 11, and Table 12. Each polling cycle consists of a pattern of six polls that result in the ratios shown in Table 9. The complete polling sequence for the first two cycles is as follows: 1. First Priority 1 value (A). 2. Priority 2 value (B). 3. Priority 1 value (C). 4. Priority 2 value (D) 5. Priority 1 value (E). 6. Priority 3 value (F).

(Second Cycle) 7. Priority 1 value (G). 8. Priority 2 value (H). 9. Priority 1 value (I). 10. Priority 2 value (J). 11. Priority 1 value (K). 12. Priority 3 value (L).

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 29 The two priority polling cycles described in this document assume that all three priority levels exist. If no objects exist for a particular priority level, then the priority level is skipped, and the cycle continues until the sequence starts again. For a single priority polling cycle, if only one object exists for Priority 1, then that object would be polled three times per priority polling cycle. The same execution occurs for Priority 2 and Priority 3 polled objects, with the exception of the number of times the objects are polled per priority polling cycle. See Table 10, Table 11, and Table 12. Note: In these tables, numeric value indicates the priority of the objects polled. The sequence of polling is from left to right. Table 10: Priority Polling Example, Priority 1, Priority 2, and Priority 3 Items Priority Polling Sequence using Priority 1, Priority 2, and Priority 3 Items (2 cycles) 1 2 1 2 1 3 1 2 1 2 1 3 A B C D E F G H I J K L

Table 11: Priority Polling Example, Priority 1 and Priority 2 Items Priority Polling Sequence using Priority 1 and Priority 2 Items (2 cycles) 1 2 1 2 1 3 1 2 1 2 1 3 A B C D E - G H I J K -

Table 12: Priority Polling Example, Priority 2 and Priority 3 Items Priority Polling Sequence using Priority 2 and Priority 3 Items (2 cycles) 1 2 1 2 1 3 1 2 1 2 1 3 - B - D - F - H - J - L

Note: Adding any Priority 1 or 2 polling to points increases your overall scan time. LonWorks device extensions Alarming Alarm extensions may be generated for any integrated LonWorks object. All alarm processing is handled by the network engine from point data received from the LonWorks enabled devices on the LonWorks trunk. Node State events The Alarm Event State attribute defines how Node State events are handled. Node State events are separate from device ONLINE or OFFLINE events. The Node State is in a Configured Online, Configured Soft Offline, or Configured Bypass state.

30 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 14: Alarm Event State

When the Alarm Event State attribute is set to TRUE, any off-normal state (Soft Offline or Bypass) causes a Node State is not normal event, and is logged. In addition, the status of the LON device transitions to an Unreliable state. The Diagnostics Tab of the LON device logs the unreliable condition in the Node State attribute. When the LON device returns to a normal Node State, the event is logged in addition to setting the status of the LON device to Normal.

Figure 15: Alarm Event Logged in Event Viewer

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 31 Figure 16: Node State in Diagnostic Tab

When the Alarm Event State attribute is set to FALSE, all off-normal conditions are suppressed including events. The status of the LON device remains Normal, but the Diagnostics Tab of the device logs the unreliable condition in the Node State attribute. Trending LonWorks point data The Trend extension is used to trend LonWorks point data. It monitors and records the changes in behavior of an individual attribute and displays the results in both graphical and tabular formats. When trending LonWorks network device objects using samples taken at fixed predetermined intervals, the initial trend period results may differ from the expected trend start time. LonWorks network status reporting for trend objects reports trend data correctly but always remains one interval cycle behind the actual field value. For example, in a 60-minute cycle where the value always increments by 2, if the current Present Value of the object is 0, then 0 is logged in the trend even through the field has a value of 72. The LonWorks object is then polled, and the Present Value updates to 72. After 60 minutes, the field value changes to 74, but the trend sample logs the current Present Value, which is 72. The only exception to this pattern is if the LonWorks object is polled by some other means. See Trend process in this section for more information. Trend buffer The trend buffer resides on the network engine and provides buffer space for each individual trend. The number of trend samples stored in each individual trend buffer is user configurable. When an individual trend buffer is full, you can configure the trending process to either stop trending or overwrite the older data with the newer data. You can configure an alarm to report whenever the buffer is full and you can also configure the trend buffer to transfer samples to a configured ADS or ODS. Trend process The following example shows a step-by-step trend process. Figure 17 shows this same process graphically. The following trending example assumes:

• field value is a linear, increasing value • trend interval is 60 minutes (3,600 seconds)

32 LonWorks Network Integration with Network Engines and LCS Technical Bulletin • Temporary Status Item Expiration Time is 60 seconds • initial field value is 71.8 • Present Value is not updated by any other means Trend process example:

1. Trending begins when the network engine receives a trend request for the trend point’s Point Value (PV). Trending reads the initial PV at 9:00 A.M., which is 0. 2. Polling begins and the Temporary Status Item Expiration Timer starts. 3. Polling acquires the point’s current value and stores it as the update value of 71.8. At this point, the trend has a value of 0 with a timestamp of 9:00 A.M., even though the actual field value is 71.8. 4. Sixty seconds later at 9:01 A.M., the Temporary Status Item Expiration Timer expires and polling stops (PV is now 72.0). 5. Fifty-nine minutes later at 10:00 A.M., the hourly trend request restarts the trending process and reads the last stored PV (72.0). 6. Polling begins and the Temporary Expiration Timer starts. 7. Polling acquires the point’s current value and stores it as the update value of 74.1. At this point, the trend has a value of 72.0 with a timestamp of 10:00 A.M., even though the actual field value is 74.1. 8. Sixty seconds later at 10:01 A.M., the Temporary Status Item Expiration Time expires and polling stops (PV is now 74.3). 9. Fifty-nine minutes later at 11:00 A.M., the hourly trend request restarts the trending process and reads the last stored PV (74.3). 10. Polling begins and the Temporary Status Item Expiration Timer starts. 11. Polling acquires the point’s current value and stores it as the update value of 76.5. At this point, the trend has a value of 74.3 with a timestamp of 11:00 A.M., even though the actual field value is 76.5. 12. Sixty seconds later at 11:01 A.M., the Temporary Status Item Expiration Timer expires and polling stops (PV is now 76.7).

The process continues for the duration the trend settings dictate. Trend process graph Figure 17 is a graphic representation of the trend process.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 33 Figure 17: Trending Process

Detailed procedures Adding a LonWorks integration object About this task: The following process is generally applicable to online configuration in the SMP or offline configuration in the SCT. Note: There are no Engineering or Diagnostics views when using the SCT, as these are online features. To use Auto Discovery, you must be online with a network engine and its LonWorks network of devices. To add a LonWorks Integration object:

1. On the Insert menu, select Integration. The Insert Integration Wizard Select Object Type screen appears. Figure 18: Insert Integration Wizard (Select Object Type Screen)

2. Select LON Trunk and click Next. The Insert Integration Wizard Destination screen appears.

34 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 19: Insert Integration Wizard (Destination screen)

3. Select the network engine to which you want the LonWorks Integration object added and click Next. The Insert Integration Wizard Identifier screen appears. Figure 20: Insert Integration Wizard (Identifier screen)

4. Enter a unique name for the LonWorks network of devices that you are integrating and click Next. The Insert Integration Wizard Configure screen appears. Note: It is best to keep this name as short as possible.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 35 Figure 21: Insert Integration Wizard (Configure screen)

Notes:

- You can view the Driver Name value by clicking the Hardware tab. The Driver Name value differs for the NAE and LCS. For all NAEs, the Driver Name value displays lpcdrv (Figure 22). For the LCS85, the Driver Name value displays 852drv. - In SCT, the LonWorks Integration has the driver name lpcdrv when LonWorks Integration is added to the LCS85. When the database is downloaded to the LCS85, the driver name is automatically changed. Once the database is uploaded to SCT, the name changes to 852drv.

Figure 22: Insert Integration Wizard (Configure screen, Hardware tab)

5. Click Next to accept the defaults. The Insert Integration Wizard Summary screen appears.

36 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Note: In most cases, you can accept the default Configuration parameters.

Figure 23: Insert Integration Wizard (Summary screen)

Note: If you need to change anything, click Back. 6. Click Finish to create the LonWorks Integration object and display the Extension Wizard. Figure 24: Extension Wizard

Notes:

- At this time, you can add resource files, trend, totalization, or alarm extensions to the new LonWorks Integration object.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 37 - The NV Configuration Data file shown in Figure 24 is created automatically, but you must update it with the correct configuration data using a network configuration tool, such as LN Builder. See Defining a network engine on the LonWorks trunk.

7. Add all required resource files. See the Inserting resource files section for details. 8. Add any desired alarm extensions and click Done when finished. The Insert Integration Wizard closes. Inserting resource files About this task: Note: If you insert a resource file under a device that has already been mapped, you must reboot the network engine. A reboot is not required if the resource file is added before the device is mapped. See Resource files for more information about resource files. To insert resource files:

1. Click the LON Trunk in the Navigation Tree – All Items. 2. On the Action menu, select Show Extensions. The Extension Wizard main screen appears. Note: The NV Configuration Data file shown in Figure 25 was created automatically when you completed the steps in Adding a LonWorks integration object.

Figure 25: Extension Wizard (main screen)

3. Click the New button on the right of the Resource area. The Insert Resource File Wizard Select File screen appears.

38 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 26: Insert Resource File Wizard (Select file)

4. Click Browse. The Open screen appears. Figure 27: Insert Resource File Wizard (Open)

5. Browse to the folder with the resource files, and click a required resource file in the list for its name to appear in the File name field of the Open screen. Note: The STANDARD.TYP and STANDARD.FPT resource files are required and must be added to the LonWorks Integration object. 6. Click Open 7. Click Next, and the Configure screen appears.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 39 Figure 28: Insert Resource File Wizard (Configure)

Note: Use the original file name for future traceability. However, you can enter a different name if desired, and the Select File screen reappears with the selected name displayed. 8. Click Next, and the Select File screen reappears with, and the Summary screen appears. Figure 29: Insert Resource File Wizard (Summary)

9. Review the information in the Summary screen. If any changes are needed, click Back. If no changes are needed, click Finish. The Extension Wizard screen appears with the newly added resource file. Repeat this process until all required resource files have been added. Note: Once you have added all required resource files, use the network engine Archive command to save the changes.

40 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 30: Extension Wizard (Add Extensions)

10. Click Done to exit the Extension Wizard. 11. Use the SCT Upload command to archive the network engine database to the SCT. This command saves a copy of the database that includes all inserted resource files. Defining a network engine on the LonWorks trunk About this task: You must define the network engine on the LonWorks trunk network to complete the integration process. This defining process creates critical internal bindings and produces a network image of the network engine. Notes:

• The LCS85 must be defined in the Configuration Server before it can be commissioned in LNS. See Appendix: Using a Flat LonWorks System with LCS and Appendix: LCS85 Gesytec 852 Configuration Settings for details. • You must use LN Builder, LonMaker, or LNS Object browser to add a network engine to the system. To define the network engine on the LonWorks network:

1. Connect LN Builder or a third-party LonWorks network tool to the LonWorks network. 2. Using LN Builder, add the Engine Device Template to the LNS database by entering the key sequence Ctrl + K and browsing to the XIF file on the hard disk.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 41 3. Using LN Builder, add the network engine to either an existing Subsystem or create a new Subsystem for the network engine. The network engine can be commissioned during this process provided the Neuron® ID is known and the network engine is online. Note: The Neuron ID of the LCS can be found on a label on top of the server. The Neuron ID of the NAE can be found on a label on the front of the NAE. 4. Continue advancing through each section making sure to select the correct Channel, the correct Device Template, and manually entering the correct Neuron ID. 5. Click Finish to complete the process. Note: Refer to the third-party LonWorks network tool documentation for the equivalent commands in Steps 2, 3, and 4. 6. Archive the changes in the SMP UI. 7. Upload the network engine database to the SCT archive database. Using Auto Discovery LON Point Auto Discovery only allows a defined number of points to be discovered for a single instance. If the total number of discovered points exceeds the limit, then the returned discovery indicates Page 1 of X, where X is the total number of pages. A restart increments the page and displays the next set of discovered points. Each completion of the point mapping process also increments the page. After the last page, the point mapping process begins again at Page 1.

Figure 31: Wizard Auto Detect Utility

42 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 32: Wizard Auto Detect Utility – page increments

Mapping LonWorks devices using Auto Discovery About this task: After you add the LonWorks Integration object and the required resource files, you need to map the devices on the LonWorks network to the network engine. Auto Discovery is an alternative to the manual process. To map the devices using Auto Discovery:

1. On the Insert menu, select Field Device. The Insert Field Device Wizard Destination screen appears. Figure 33: Insert Field Device Wizard (Destination)

2. Select the LonWorks Integration object within the network engine and click Next. The Insert Field Device Wizard Select Definition Mode screen appears. Note: If you do not see a LonWorks Integration object, follow the procedures in Adding a LonWorks integration object.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 43 Figure 34: Insert Field Device Wizard (Select Definition Mode)

3. Select Assisted Device Definition and click Invoke Auto Discovery. The Wizard Auto Detect Utility starts. When Auto Discovery is complete, a list of discovered devices appears. Note: The network engine must have been commissioned on the LonWorks network. It must also be online with the LonWorks network of devices to use Auto Discovery. At this point, you may also select Manual Device Definition and proceed with manual item creation.

Figure 35: Insert Field Device Wizard (Auto Detect Utility)

Note: If the desired device does not appear, verify that the device's resource files have been added to the integration. 4. Select a device from the list. This starts the Insert Field Device Wizard Identifier screen.

44 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 36: Insert Field Device Wizard (Identifier)

5. Enter an identifier for the device that is unique on this LonWorks trunk. Note: Always replace the existing default identifier found in the identifier box because this is the generic device-type name and may not be unique on the trunk. Identifier names are limited to 32 characters. The identifier you enter is displayed in the device’s Advanced Focus view under the Engineering Values - Item Reference listing. The DSN number in the identifier is used to identify which subnet a device is on when routers are present. The DSN number is removable. 6. Click Next and the Insert Field Device Wizard Configure screen appears.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 45 Figure 37: Insert Field Device Wizard (Configure)

7. Enter a name unique to the site into the Object Name box, enter a description into the Object Description box (optional), and click Next. The Insert Field Device Wizard Summary screen appears. Note: The Object Name and Description you enter appears in the device’s Focus view – Object section.

Figure 38: Insert Field Device Wizard (Summary)

8. Review the configuration information. Click Back to make any changes. Click Finish and the Extension Wizard appears.

46 LonWorks Network Integration with Network Engines and LCS Technical Bulletin 9. Add any extensions and click Done. This saves the field device’s configuration, and the Field Device Extension - Field Points screen appears. See Mapping Field Points in LonWorks devices using Auto Discovery. Mapping Field Points in LonWorks devices using Auto Discovery About this task: Once one or more integrated LonWorks device objects have been configured, you can add LonWorks Field Points, which map to network variables in the LonWorks device. To map field points in LonWorks devices using Auto Discovery:

Note: The network engine must be online with the LonWorks network of devices in order to use Auto Discovery. If you are mapping points offline, see Manually mapping Field Points in LonWorks enabled devices.

1. On the Insert Menu, select Field Point. The Insert Point Wizard Destination screen appears. Note: The Insert Point Wizard starts automatically after inserting a Field Device. Since it selects the newly added device as the destination, the wizard opens to the Select Definition Mode screen, bypassing the Destination screen.

Figure 39: Insert Point Wizard (Destination)

2. Select the LonWorks device from which you want to map the points and click Next. The Insert Point Wizard Select Definition Mode screen appears. Note: If you do not see a device to select, click the plus sign next to the LonWorks Integration object to open the list of mapped LonWorks devices.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 47 Figure 40: Insert Point Wizard (Select Definition Mode)

3. Select Assisted Point Definition and click Invoke Auto Discovery. The Wizard Auto Detect Utility starts. Figure 41: Insert Point Wizard (Auto Detect Utility)

Notes:

- When Auto Discovery is complete, a list of discovered LonWorks network variables appears. The fields are automatically filled with the auto-discovered data from the LonWorks device and its resource files. - Each network engine has a limited number of objects it can discover at one time. If you have more than the limit, you need to perform subsequent discoveries until all objects are accounted for. The SMP UI keeps track of multiple Auto Discoveries by incrementing the pages displayed.

4. Close the window by clicking the x in the upper-right corner of the screen. 5. Click Next. The Point Mapping Utility screen appears. Use this screen to select which point objects/fields you want to map as points from your LonWorks device.

48 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 42: Insert Point Wizard (Point Mapping Utility)

6. Select Map All to map all discovered LonWorks network variables as integrated LonWorks point objects (1,000 child object limit). You may also select network variables individually for mapping by clicking them. A green check mark is placed next to the selected network variable, and the right side of the screen displays the newly selected network variable ready for mapping. At this point, you have the option to change the point object name and object type on the right side of the screen. Note: Previously mapped network variables are noted by a blue check mark.

Figure 43: Insert Point Wizard (Point Mapping Utility – Map All)

7. Select all the network variables you want to map, and then click Next. The Insert Point Wizard Summary screen appears.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 49 Figure 44: Insert Point Wizard (Summary)

8. Review the Summary screen and click Finish. Manually mapping a series of LonWorks enabled devices About this task: Note: The following steps assume that LN Builder and the SCT are on the same computer. Using the same computer allows you to toggle between LN Builder and the SCT to expedite the mapping process. Manually mapping a series of LonWorks devices is typically used for many field devices of the exact same device type (for example, VAV Modular Assembly [VMA] or Heat Pump) that all require the exact same point and NV configuration. These devices often do not require all their points to be mapped, with the only difference being their name, Neuron ID, and DSN number. The SCT Copy/Paste command is the key to this timesaving process. Note: The Neuron ID is only stored as a reference and can be removed. The DSN Number is used to communicate to the LonWorks device. If LN Builder and the SCT are on different computers, create a list that includes the device name, Neuron ID, and DSN number of each device in the series of devices on the LN Builder Physical Tree. To map a series of LonWorks field devices manually:

1. Use LN Builder to add and configure all LonWorks field devices in the series. 2. See the manual procedures included in Mapping LonWorks devices using Auto Discovery and the section Manually mapping Field Points in LonWorks enabled devices to manually add the devices and points. You must upload the changes to SCT before continuing. Note: The Neuron ID cannot be duplicated from within a single LonWorks Integration. The Neuron ID must contain all zeros before a paste is allowed. Use Steps 8 and 9 in this section to modify the Neuron ID of the device that is being copied. Only the DSN number needs to be modified to match the pasted device. 3. Select the new device and on the Edit menu, click Copy.

50 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 45: Copy selected device

4. On the Edit menu, click Paste to paste a copy of the first device, as the second device, into the Integration Tree. A message prompts you to enter a new name for the second device in the series. Duplicate names are not permitted. Figure 46: Paste item name in use message

5. Enter a new name for the second device. Click Paste in the Paste Item Wizard window to add the second device to the Integration Tree. Note: Name devices consistently to avoid confusion when you enter the corresponding DSN number for each device in the series.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 51 Figure 47: Second device added to the Integration tree

6. Repeat the paste and renaming process for every device in the series. Note: Once all devices in the series have been added to the Integration Tree, you must enter the correct DSN number for each device in the series, with the exception of the first device, which is already correct. 7. Use the SCT to select the second device in the series to begin the editing process. 8. On the View menu, click Selected Item to open the Focus window. 9. Select the Hardware tab to display the DSN number field, then click Edit. Figure 48: Edit Hardware screen (Neuron ID and DSN Number)

52 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Note: The DSN numbers, initially displayed for the second device and for all remaining devices in the series on the Integration Tree, are the same numbers as the first device in the series on the Integration Tree. The second device and all remaining devices in the series on the Integration Tree must be edited to match the DSN number of the corresponding device as shown on LN Builder from the list view. 10. Toggle to LN Builder and select the second device of the series. Right-click and select Properties, then select the Identifier tab. You can copy and paste the Subnet/Node ID into the corresponding attributes of the network engine. Notes:

- The Domain can be identified in LN Builder by highlighting the database, right-clicking, and selecting Properties. - When mapping a series of LonWorks field devices manually using LN-Builder, make sure you record the hexadecimal format (Base 16) and not the decimal format (Base1 h10) when entering the data into the network engine. Both are available. - Devices imported into the Integration Tree using an .IMP file have the decimal DSN number automatically converted to hexadecimal. - Manual device discovery requires you to enter the DSN number in hexadecimal.

Figure 49: LN Builder Device Properties screen

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 53 Figure 50: Device Summary view of Hardware tab

11. Toggle to the SCT. 12. Use the SCT to select the DSN box and replace the existing Subnet and Node number with the new hexadecimal number. Note: The Domain does not need to be changed if the device is being copied from within the same LonWorks Integration.

Figure 51: Replacing the subnet node number

13. Click Save to save all changes. 14. Repeat Step Step 7 through Step Step 13 until all devices in the series have the correct DSN number. 15. Use the SCT Database Create Backup command to save all changes.

54 LonWorks Network Integration with Network Engines and LCS Technical Bulletin 16. Use the SCT Load Archive command to download the changes to the network engine. Manually mapping Field Points in LonWorks enabled devices Manually mapping LonWorks Field Points or Network Variables (NVs) is considered an advanced procedure and requires an experienced operator. To map LonWorks Field Points manually: 1. On the Insert Menu, select Field Point. The Insert Point Wizard Destination screen appears. Note: The Insert Field Points Wizard starts automatically after inserting a Field Device. Since it selects the newly added device as the destination, the wizard opens to the Select Definition Mode screen, bypassing the Destination screen. Manual point insertion that does not follow automatic device insertion displays the Insert Point Wizard Destination screen first.

Figure 52: Manual Insert Point Wizard (Destination screen)

2. Select the LonWorks device from which you want to map the points and click Next. The Insert Point Wizard Select Definition Mode screen appears.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 55 Figure 53: Manual Insert Point Wizard (Select Definition)

3. Click Manual; the screen changes to the manual mode with a list of point object types that you can add. Note: Manual Point Definition can be distinguished from the Assisted Point Definition by the list of steps on the left side of the screen. In Manual Point Definition, a Data Source step is added and the Identify and Configure steps are separate. LonWorks devices are added during the Mapping LonWorks devices using Auto Discovery procedure. If you do not see a selectable device, click the plus sign next to the LonWorks Integration object to open the list of mapped LonWorks devices.

Figure 54: Manual Insert Point Wizard (Select Definition Mode)

4. Select the type of point you wish to create and click Next. The remaining steps of the Insert Point Wizard manual mode are listed in Table 13.

56 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Table 13: Insert Point Wizard - manual mode screens Screen Purpose Enter the index of the field point or NV you are mapping. This index must be Point.x or NV.x.x, where x = the Target Reference Number. See Table 5 in the Mapping internal points of LN Series controllers section for additional Target Reference structures. The Target Reference Number must correspond to the point or Data Source NV index in the host LonWorks enabled device. You can find the Target Reference Number in the LN Builder Nv Attributes tab of the properties box for that NV. For structured SNVTs, use LN Browser in addition to the Attributes tab to identify the SNVT part that is needed (such as NV.12.3). For more information on Target References, see Target Reference. Enter a unique name (within the device) for the field point or NV Identifier you are mapping. Enter the field point or NV. The Hardware tab of the Configure Configuration Screen displays the Target Reference Number. View a summary of the information that you have entered. If Summary anything looks wrong, press the Back key and make corrections. 5. When finished with the Wizard, click Finish. Using relearn in the Engineering view About this task: The Engineering View allows a detailed examination of the integration items. Although mapped devices and points are shown, the Engineering View also provides details for objects that are not mapped into the Integration. Note: Only viewing and commanding are applicable in the Engineering View; there is no option for mapping. Relearn uses Auto Discovery and requires that the network engine be online with the LonWorks network of devices being discovered. To add Integrated LonWorks objects to the Integration Tree using Relearn:

1. Select the LonWorks Integration object in the Navigation tree. 2. Click the Engineering tab, and then click the Relearn button that appears underneath the Summary tab.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 57 Figure 55: Engineering view with Relearn button

3. The discovery begins automatically and finds all new LonWorks devices on the network. The Relearn screen appears. The Restart button repeats the discovery process. Note: Discovery by Relearn removes from the Integration Tree devices that are unmapped and not communicating with the network engine. After discovery, the newly found devices appear in the Integration Tree in the Engineering view.

Figure 56: Engineering view (Relearn screen)

4. When discovery is complete, close the Relearn screen. Using the Engineering view to view device and point data About this task:

58 LonWorks Network Integration with Network Engines and LCS Technical Bulletin When online with a LonWorks device, you can use the Engineering view of the LonWorks Integration object to view the data of LonWorks devices and points that the network engine has discovered. The Mapped Devices folder contains a list of all mapped devices. The devices and points do not have to be mapped to the Navigation Tree to be acted on. Note: LN Series internal points are not visible in Engineering View. To use the Engineering view to view devices and points:

1. Right-click the LonWorks Integration object in the Navigation tree and select View. The LonWorks Integration object appears. Figure 57: LonWorks Integration Object (LON Trunk)

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 59 2. Click the Engineering tab and navigate to either a field device or a field point in the Integration Tree. 3. Double-click the selected field device or field point; the Details screen appears. 4. Click the x in the upper-right box to close the menu. Using the Engineering view to command network variable inputs and edit NexSys point data About this task: When online with a LonWorks device, you can use the Engineering view of the LonWorks Integration object to command NVI values for any LonWorks device and to edit NexSys point data. The Mapped Devices folder contains a list of all mapped devices. The NVIs and NexSys points do not have to be mapped to the Navigation Tree to be acted on. To use the Engineering view to view and edit NVIs and NexSys points:

1. Right-click the LonWorks Integration object in the Navigation tree and select View. The LonWorks Integration object appears. 2. Click the Engineering tab and navigate to either a field point or NVI in the Integration Tree. 3. Double-click the selected field point or NVI. The Details screen for the selected field point object or NVI appears. Figure 58: Engineering View (Details screen)

4. Click Edit. The fields that are editable from this screen are shown in a box with a line border. 5. Make the desired changes, click Save, and close the screen. Viewing routers

60 LonWorks Network Integration with Network Engines and LCS Technical Bulletin About this task: The Device Auto Discovery is used to recognize the routers as being on the LonWorks routers are discovered as part of the Device Auto Discovery process. The routers are visible in the Engineering View's Integration tree (only if the Device Auto Discovery process has been run), but are not visible in the Navigation tree, since the routers cannot be mapped. Routers are not visible on the Navigation tree and are only visible on the Integration tree in the Engineering view after using the Relearn or Auto Discovery command to expose them. Devices added below a router on the LN Builder Physical tree must be physically connected to the LonWorks network somewhere on the far side of the router. Device order is not important. Subnet addresses are hexadecimal, are automatically assigned, and are not always sequential by subnet level.

Figure 59: Router subnet levels

To view routers in the Integration Tree:

1. Add and commission the routers using LN Builder. 2. On the network engine, drag the LonWorks Integration object to the Display frame. 3. Click the Engineering tab to display the current devices on the Integration Tree.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 61 Figure 60: Integration Tree before Discovery

4. Click the LON Trunk, then click Relearn to start the Auto Discovery process. 5. Click Restart to complete the discovery. Figure 61: Discovery Screen

Note: Routers are not shown in the Relearn screen until after discovery is finished. 6. When the discovery is finished, click Close; the newly discovered router now appears as a folder in the Integration Tree.

62 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 62: Integration Tree After Discovery

Note: Even though the router, with its mapped devices, appears in the Integration Tree, the Mapped Devices folder only displays the mapped devices under the router. Routers cannot be mapped. Viewing detailed router information

1. Click the Engineering tab of the LonWorks Integration to display the Integration Tree. 2. Double-click the router to display the summary information. If the router is not visible, follow the steps Viewing routers.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 63 Figure 63: Router Summary screen

Trending LonWorks device data

1. Right-click the point you want to trend. Select Show Extensions to open the Extension Wizard. Figure 64: Extension Wizard

64 LonWorks Network Integration with Network Engines and LCS Technical Bulletin 2. Click New to open the Insert Trend Wizard Select Attribute screen (Figure 65). Present Value is the default attribute. Attributes vary, depending on the point or device selected. To select a different attribute, click Other and select the attribute; otherwise, click Next to display the Insert Trend Wizard Configure screen. Figure 65: Insert Trend Wizard (Select Attribute Screen)

3. Make any changes to the configuration settings (Figure 66), and click Next to display the Summary screen. Figure 66: Insert Trend Wizard (Configure Screen)

4. Click Finish to complete the Trend configuration, display the newly created trend in the Trend Extension Wizard, and begin trending the point.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 65 Figure 67: Insert Trend Wizard (Summary Screen)

Figure 68 shows a trend chart example, and Figure 69 shows an example trend table.

66 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 68: Trend Chart Screen

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 67 Figure 69: Trend Table Screen

Troubleshooting

Use the information in Table 14 to assist in diagnosing and solving possible LonWorks network system integration problems.

68 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Table 14: LonWorks Network System Integration Troubleshooting Guide Symptom Cause Solutions Auto Discovery fails to find Check for device specific The Relearn button calls the all devices after clicking the resource files and then click the last saved relearn data from a Relearn button. Restart button to rediscover the queue. Devices added after the devices. This causes a poll of last relearn request are not in current devices and creates a that data. new list. Auto Discovery fails to find all Connect LN Builder, the devices, and clicking the Restart COM.PRO Tool, or a third- button does not display all party LonWorks network devices. configuration tool to the LonWorks network and verify that it is possible to communicate with the devices on the network including the network engine. If communication is good, verify that the network engine database has been generated correctly and that Communication failure the LonWorks enabled device data corresponds to the devices installed. If the network engine does not respond, verify that the network engine has been correctly installed in the LonWorks network database and that the network configuration image has been sent to the network engine from LN Builder. If the network engine cannot be installed, replace the network engine. LonWorks network wires at Check the entire LonWorks missing devices not connected network. Refer to the LonMark properly. Guidelines – for details (www.lonmark.org). Critical Resource Missing is Insert the required XIF resource A required XIF resource file is shown for the status of the file under the LonWorks Trunk, missing from the integration of device. and then reboot the network the controller to the network engine. See Inserting resource engine. files for details.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 69 Table 14: LonWorks Network System Integration Troubleshooting Guide Symptom Cause Solutions Data Conversion Error is A required resource file is Insert the required resource indicated as a point's reliability missing from the integration of files under the LonWorks Trunk. status. the controller to the network See Inserting resource files engine. for details. If the resource file is present, try rebooting the network engine to see if that resolves your issue. Routers are not displayed on Routers are only visible in the the Navigation Tree after Auto Engineering view Integration From the Engineering view of Discovery. Tree. the LonWorks trunk, select the LonWorks Integration object This issue may also occur if and click Relearn. Routers are the Field Units and Units are shown in the Integration Tree. mismatched. Adding a device under a Router The wrong channel was Change the channel in LN Builder results in the selected in LN Builder during assignment for the device in following Error Message: Node/ the insert device process, LN Builder, rewire the device router on the wrong channel. the device is physically wired in the field, or change the incorrectly, or the network channel assignment for the interface defined in the LNS network interface as defined database does not match the in LN Builder to match the physical connection to the LON physical connection to the LON Network. Network. After defining a LON Windows 7 and server-class Disable UAC settings. Integration, adding a resource Windows operating systems file extension, and creating an may require changing the object, the resource file does User Access Control (UAC) not download to the NxE. The settings to allow resource files object created cannot be found (LON and Vendor Integrations) or used during Auto Discovery. to be added to the network engines. The Metasys SMP does not inform the user when a resource files fails to download.

Appendix: Using a Flat LonWorks System with LCS Basic system overview A flat LonWorks System differs from a typical LonWorks network because of its open architecture. This appendix describes the components, setup, and the role of the 852 Configuration Server in a flat LonWorks system organization.

70 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Physical components

TCP/IP network The TCP/IP network provides the transport medium for LonWorks packets according to the CEA-852 standard. This standard provides management and encapsulation for the LonWorks packets on the TCP/IP network. A site may have a single TCP/IP network, but multiple CEA-852 channels may be configured within that TCP/IP network. LCS85 control server The LCS85 Control Server is a server-based machine that supervises many LonWorks field controllers through a CEA-852 Configuration Server. LNS computer The LNS computer runs a LonWorks network management tool such as LN Builder or LonMaker. LonWorks Network Services (LNS) is the underlying software that performs the actual LonWorks network management tasks, such as assigning LonWorks addresses, binding, running data queries, and so on. These tools provide a user-friendly interface that directs commands down to the LNS computer to perform actual network operations. The LNS computer can either be a laptop, which is only connected to the network temporarily (when changes to the system are made), or it can be a dedicated computer always attached to the network. LonWorks IP routers LonWorks IP routers allow EIA-709 (LonWorks) packets to travel to and from the TCP/IP network. They are also true LonWorks routers because they must be configured by a LonWorks network management tool to function on the LonWorks network. Note: If you use an IP852 router that is not manufactured by Echelon Corporation, Loytec, or Adept Systems, it might not be compatible with the LCS85. Refer to the LonWorks Control Server (LCS) 85 Product Bulletin (LIT-12011549) for a complete list of supported CEA-852 routers. Loytec™ L-IP router The L-IP router is a combination device. It is a LonWorks IP router that can also serve as the CEA-852 Configuration Server. Echelon® i.LON® 600 router The Echelon Ii.LON 600 is a LonWorks IP router for purposes of an LCS85-based system. The previously released I.LON 1000 is a LonWorks IP router, but it uses an Echelon proprietary protocol that is neither compatible with nor upgradeable to the CEA-852 standard. Note: The Echelon i.LON 100e3 and i.LON SmartServer are fully compatible. Logical components

CEA-852 standard The CEA-852 standard specifies a method for transporting LonWorks (EIA-709) packets over a TCP/ IP network and managing the devices that exchange LonWorks packets. The CEA-852 packets travel across the network as User Datagram Protocol (UDP) or TCP packets using unicast or multicast addressing. Note: Not all devices support multicast addressing.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 71 CEA-852 channels CEA-852 channels form logical groups of nodes that interact on an IP network. The CEA-852 channels are managed by a Configuration Server. Each LCS85 can only connect to a single CEA-852 channel. CEA-852 configuration server The Configuration Server is a critical part of any CEA-852 channel. It tracks all of the devices belonging to a channel and ensures that each device communicates with all other devices on that channel. If all devices are in communication, they can route traffic to each other. In an LCS85 flat LonWorks system, you can use either the Loytec L-IP router or the Echelon Configuration Server. Unlike the Echelon Configuration Server, each L-IP router can only manage a single CEA-852 channel. Notes:

• Echelon and Adept Systems routers are compatible with both the Loytec Configuration Server and the Echelon Configuration Server. • For full functionality, settings must be adjusted in the Gesytec Easylon IP Interface Configuration Utility, depending on the Configuration Server you are using. See Appendix: LCS85 Gesytec 852 Configuration Settings for details. Basic system setup Figure 70 shows a basic system setup using LonWorks IP routers. The system contains a single LCS85, a single LonWorks Network Services (LNS) based network management tool, and several LonWorks IP routers, including one Loytec L-IP router designated as the 852 Configuration Server. In a basic system, a single LCS85 Server maps all LonWorks devices in a single LNS database containing many LonWorks IP routers on a single /IP 852 backbone. The basic system is the easiest to set up because you enter all Ethernet TCP/IP addresses as shown in Figure 70 into the 852 Configuration Server. The Ethernet TCP/IP addresses include the LNS computer, LCS85, and all LonWorks IP routers. Notes:

• If you are using the Echelon Configuration Server instead of the Loytec Configuration Server, the setup is identical to Figure 70, except that the embedded Configuration Server is disabled on the Loytec L-IP router and the Echelon Configuration Server resides on the LNS Tool (LN Builder). • Computers occupying other addresses on the network are not shown in this system. The routers have been assigned generic Ethernet addresses to show how individual components are organized into the final system.

72 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 70: Basic Flat LonWorks System

Choose the 852 configuration server To set up a channel, you must first designate an 852 Configuration Server. You may use either the Echelon Configuration Server or the Loytec L-IP router as a Configuration Server. Consider easy access or the nearest location if you are using a Loytec L-IP router. You can choose any L-IP router to set up as the 852 Configuration Server, but you cannot choose more than one L-IP router. Configure the 852 configuration server After you designate a 852 Configuration Server, configure it with the Ethernet TCP/IP addresses of all system devices. See Appendix: LCS85 Gesytec 852 Configuration Settings for details. Configure the LonWorks IP routers You need to configure LonWorks IP routers only if you are setting up a new system. If you are working with an existing system, the port number is the only changeable value in the Configuration Server’s related routers. If this is a new system, the routers need IP addresses. The IP addresses must be static IP addresses, and assigned in cooperation with the IT department to ensure that no current or future conflicts exist. Configure LNS computer The LNS computer resides on the Ethernet backbone. The LNS computer must be enabled with a standard CEA-852 communications capability because of its location. The LNS revision determines the type of driver that can be used. LNS 1.x and 2.x LNS versions prior to 3.0 have not been tested and are possibly incompatible with the CEA-852 standard. We strongly advise upgrading to LNS Version 3.0.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 73 LNS 3.x prior to LNS TURBO Edition There are two options if the site is using LNS 3.x: • Loytec NIC-852 The Loytec NIC-852 driver consists of software and a dongle (required for licensing). In the setup utility for the driver, you must enter the address and port for the Configuration Server. • Upgrade to LNS TURBO Edition The other option is to upgrade the site to LNS TURBO Edition network operating system, with its integral 852 driver. Once a database is opened with LNS TURBO Edition, it is converted to the new format. However, consider this option carefully because no utilities are yet developed to revert a database back to the previous format. LNS TURBO Edition LNS TURBO Edition has an integral 852 communications driver, and can communicate directly over IP. Driver configuration consists of entering the Ethernet IP and port address of the Configuration Server. Important: Removing LNS TURBO after installation to revert to a previous version of LNS is a manual process that could result in data loss. Carefully consider this issue if you choose to install LNS TURBO Edition on your computer. Complex system setup Figure 71 shows a complex system setup with multiple LCS85s operating within the same LNS database (same domain). This setup differs from a basic system because of the additional LCS85 servers. Note: If you are using the Echelon Configuration Server instead of the Loytec Configuration Server, the setup is identical to Figure 71, except that the embedded Configuration Server is disabled on the Loytec L-IP router and the Echelon Configuration Server resides on the LNS Tool (LN Builder).

74 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 71: Flat LonWorks Complex System

Network partitioning Figure 72 shows a complex system partitioned into two separate LNS databases (2 domains). In this example, devices to the left of center are on Channel 1 (Domain 1), and devices to the right of center are on Channel 2 (Domain 2). Note: If you are using the Echelon Configuration Server instead of the Loytec Configuration Server, the setup is identical to Figure 72, except that the embedded Configuration Server is disabled on the Loytec L-IP router and the Echelon Configuration Server resides on the LNS Tool (LN Builder).

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 75 Figure 72: Complex System with Partitioned Network

Guidelines for network partitioning Consider the following when you partition a network:

• The LNS computer must sit on both networks. • Only one Loytec L-IP router can be designated as the Configuration Server for each CEA-852 channel. • The Loytec L-IP router can be mounted in the server enclosure. As an example, Channel 2 shows a Loytec L-IP router near the LCS85 server at address 10.100.5.1. This router has no nodes attached. • The Loytec L-IP router designated Configuration Server may or may not have nodes attached. The device functions primarily as a LonWorks IP router, but has configuration server capabilities. Using it in the field as a router and as the Configuration Server utilizes the full capability of the device. • Systems are based on network addresses. Therefore, the logical organization (such as the example in Figure 71) may not match the physical location of the network.

76 LonWorks Network Integration with Network Engines and LCS Technical Bulletin • The communication in a partitioned system is divided. In the Figure 71 example, the left LCS85 (at address 10.100.5.88) communicates only with Ethernet routers 10.100.5.2, 10.100.5.3, 10.100.5.4, 10.100.5.5, and 10.100.5.6. The right LCS85 communicates only with Ethernet routers 10.100.5.1, 10.100.5.7, 10.100.5.8, 10.100.5.9, and 10.100.5.10. Binding and other data sharing cannot occur between these two systems. Any data sharing between the two groups can only be done with the Metasys system through an Application and Data Server (ADS), Extended Application and Data Server (ADX), or Open Data Server (ODS). Basic partitioned system setup

Choose the 852 configuration server On each system, you may use either the Echelon Configuration Server or designate one of the Loytec L-IP routers as the Configuration Server. For Channel 1, consider easy access or the nearest location if you are using a Loytec L-IP router. Configure the 852 configuration servers After the Configuration Servers have been designated, each must be configured with the Ethernet addresses of the devices belonging to its own 852 channel. See Appendix: LCS85 Gesytec 852 Configuration Settings for details. Configure the channels This partitioned system example includes two channels. Table 15 provides the IP addresses of all devices on Optional: Channel 1. Table 16 provides the IP addresses of all devices on Channel 2. Note: If you are using the Echelon Configuration Server instead of the Loytec Configuration Server, the channel configuration is identical to what is shown in Table 15 and Table 16, except that the embedded Configuration Server is disabled on the Loytec L-IP router. Additionally, the Echelon Configuration Server resides on the LNS Tool (LN Builder) and is configured to handle two separate LNS networks. The defined Configuration Server uses the same IP address with a unique port number in each instance to segregate the separate LNS networks. Table 15: Channel 1 IP Addresses IP Address Device 10.100.5.2 Loytec L-IP Router Configuration Server 10.100.5.3 Loytec L-IP Router 10.100.5.4 LonWorks Ethernet Router 10.100.5.5 Loytec L-IP Router 10.100.5.6 Loytec L-IP Router 10.100.5.88 LCS85 Server 10.100.5.200 LNS Computer

Table 16: Channel 2 IP Addresses IP Address Device 10.100.5.1 Loytec L-IP Router Configuration Server 10.100.5.7 LonWorks Ethernet Router 10.100.5.8 LonWorks Ethernet Router 10.100.5.9 LonWorks Ethernet Router

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 77 Table 16: Channel 2 IP Addresses IP Address Device 10.100.5.10 LonWorks Ethernet Router 10.100.5.99 LCS Server 10.100.5.200 LNS Computer

Configure the LNS computer The LNS computer has particular requirements for configuration during setup. Setup must be carefully considered, as each configuration option has its own effects on the system. See the Basic system overview section for information on CEA-852 driver issues. Setting up two LNS Computers is the equivalent to having two basic systems. Each LonWorks system is independent and set up separately. Both systems are simple, but the complete setup requires more hardware and software. Complex partitioned system setup About this task: This system comprises a single large LNS database containing all nodes in the system with multiple LCS85 servers. The LCS85 servers are segregated to communicate to different devices within the same network. Segregation is based on designating complete FTT-10 channels to each LCS85. You manually partition the system ensuring only specific LonWorks IP routers (or specific nodes) are mapped to the LCS85. No device can be mapped to both systems. This system closely meets flat LonWorks system specifications and is still considered flat because any node can be bound to any other node in the system. The purpose of LCS85 server segregation is to break up the network into manageable pieces for incorporation into a Metasys system. Partitioning a network is a way to manage large systems, but does require some caution. Consider the following issues when you partition a large system:

1. Partition the system carefully. Cleanly divide the system to provide easily understood system organization. Clustering all devices under a single router is one method to clearly partition the system. Keeping each part of the system isolated prevents numerous smaller problems. 2. Consider command interference. Commands can interfere or clash with each other if two different LCS85 servers are commanding the same point in the field or if the same point is mapped to multiple objects. When commands clash with one another, the device carries out the last issued command. Systems that have this problem behave erratically. 3. Isolate devices to one router and one server. When two LCS85 servers are communicating, each one checks message error rates (messages unsuccessfully communicated). The error rate rapidly increases if multiple units start communicating down to a single router because the router can only handle a certain amount of traffic on the FTT-10 channel. As traffic increases, error rates increase and may overload the server. In response, all LCS85 servers reduce their communication rate to reduce the error rates. In a situation where error rates are high, both LCS85 servers reduce their communication at the same time and in the same manner because all machines use the same algorithm. When the error rates decrease, they increase communication at the same time and same manner. If multiple units are competing for bandwidth on the same router, this rise and fall in traffic continues indefinitely. You can avoid this problem by keeping all devices under one router isolated to one LCS85 server.

78 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Appendix: LCS85 Gesytec 852 Configuration Settings Introduction

The LonWorks® Control Server (LCS) 85 is certified for use with either the Echelon® Configuration Server or the Loytec Configuration Server. The Gesytec Easylon IP Interface router resides on the LCS85 and requires different settings depending on which configuration server the LCS85 uses. Other configuration servers may work with the LCS85, but are not supported by Johnson Controls. Follow the instructions in this appendix to ensure successful operation of your LCS85. To review complete configuration procedures for each configuration server:

• Click Help > Contents in the Echelon LonWorks/IP Configuration Serverwindow. • Go to www.loytec.com and download the L-IP User Manual.

Easylon IP interface configuration settings Table 17 defines the Easylon IP Interface Configuration window settings. Go to Configuring the LCS85 for use with the Loytec configuration server or Configuring the LCS85 for use with the Echelon configuration server, depending on the configuration server you are using, and follow all directions in that section. See Table 17 as necessary as you configure the LCS85. Table 17: IP Interface Field Definitions Option Definition User-defined name that identifies the device. Device Name Note: The Loytec L-IP embedded configuration server updates the members list using this name. Config Server Address Address of the Configuration Server. Must be user configured. Port used by the Configuration Server. Must match what is defined in Config Server Port the IP-852 Configuration Server. The default value is 1629 but may be changed. IP Address of the LCS which must be selected from the pulldown 852 Interface Address menu. The same address must be entered in the IP-852 Configuration Server members list. Port used by the 852 Interface. Must match what is defined in the 852 Interface Port IP-852 Configuration Server members list. The default is 1628 but may be changed. Port used by the installed Remote Network Interface. The default is RNI Interface Port 49852 and should not be changed. Enables Multicast support to deliver one packet to a group of IP Multicast hosts. The default is unchecked. If the Multicast option is selected, this IP address is used for the Multicast Address multicast group. If the Multicast option is selected, this port is used for the multicast Multicast Port group. Enable Soft License This option must be checked to use a software license.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 79 Table 17: IP Interface Field Definitions Option Definition A unique 12-digit hexadecimal Neuron Identifier used by LNS to commission and set the Domain Subnet Node address of the LCS. Node-Id The default value is 000000000000 (12 zeros), but it may be pre- configured. MAC Address of the Network Interface that is defined by the 852 MAC-Address Interface setting in the IP Configuration setting. The license key that is generated by Gesytec licensing and is tied to the Node-Id and MAC Address. If the Node-Id or MAC Address Key changes, then the licensing is not valid and the 852 driver does not function. Debug Output Used for troubleshooting purposes only. The default is unchecked. Debug Mask When Debug Output is selected, this is a user-defined value (in hex). Groups multiple CEA-709 packets into a single IP packet. When checked, a value must be entered in ms to define how long the driver waits before sending the IP packet. The default is unchecked. Aggregation Note: Although aggregation can improve throughput, care must be taken when configuring this setting. A long delay can cause LCS devices to go offline intermittently. Multicast Time-To-Live specifies the number of router hops that Multicast -TTL multicast traffic is permitted to pass through before expiring on the network. The default is 64. How often, in seconds, the driver checks to see if the Configuration Config Server Pollinterval Server is online. Enable Channelrouting When selected, IP packets are routed to the correct destination. Wants all packets When selected, the 852 driver receives all packets. Defines whether or not the 852 driver loads the saved channel Load saved channel config configuration settings. This setting varies depending on the configuration server being used. MD5 Authentication When selected, enables encryption. The default is unchecked. When MD5 Authentication is selected, this user-defined value Shared Secret encrypts packets over the LonWorks IP Network and all IP 852 members must be configured with the same setting. Hide Console Hides the console from Desktop view. The default is checked. Automatic Start Must be enabled for proper LCS operation. The default is checked. Must be enabled for proper LCS operation. The 852 driver starts as a as Service service, removing the need for a user to be logged in to the LCS. The default is checked. Apply button Saves the settings and starts the 852 driver. Cancel button Reverts any unsaved settings back to the previous value. Stop App. Stops the 852 driver. Log Displays the executed commands.

80 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Configuring the LCS85 for use with the Loytec configuration server

1. Go to Start > All Programs > Easylon > 852, then right-click Config 852 Interface and select Run as administrator. The Easylon IP Interface Config Settings window appears. 2. In the window, configure the settings to match Figure 73. See Table 18 for the options to select. Note: The IP Configuration and Soft License Configuration sections contain information that is unique to the site configuration and the hardware installed. Do not change these settings.

Figure 73: Easylon IP Interface Config Settings for the Loytec Configuration Server

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 81 Table 18: Easylon IP Interface Config Settings for Use with the Loytec Configuration Server Field Selection or Entry Must be selected with a setting of 8 ms.

Aggregation Note: This selection and its setting may be modified on a per-site basis if you wish to match the aggregation of the LCS85 with the aggregation of the Loytec router. Config Server Pollinterval Must not be selected. May be selected if you wish to reduce traffic, but it is not Enable Channelrouting required. Must not be selected, otherwise the LCS85 does not communicate on the LonWorks network. Because the channel information Load saved channel config is not saved, the configuration server must be online and communicating when the LCS85 starts up. Automatic Start Must be selected. as Service Must be selected.

3. Click Apply. Configuration Servers

Configuring the Loytec configuration server About this task: The Loytec Configuration Server is embedded in the Loytec L-IP router and can be enabled or disabled. Only one router may have the configuration server enabled.

1. Open the Windows Internet Explorer web browser. 2. Enter your assigned IP address in the URL. The Loytec Device Info screen appears. 3. Select Config from the vertical menu on the left. 4. Log in with the administrator password to access the Loytec Config Server. If you are using firmware prior to Release 4.0, the default administrator password is admin. If you are using firmware at Release 4.0 or later, the default administrator password is loytec4u. 5. Select IP from the vertical menu on the left. The Config IP screen appears.

82 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 74: Config IP

6. Configure the settings shown in Figure 74. See Table 19 for the options to select. Some settings vary on a per-site basis and must be modified accordingly. The IP settings are unique to your computer. Table 19: Config IP Settings Field Selection or Entry DHCP/BOOTP Disabled IP Address Modify accordingly. IP Netmask Modify accordingly. IP Gateway Modify accordingly. Hostname Modify accordingly. Domainname Modify accordingly. DNS Server 1 Modify accordingly. DNS Server 2 Modify accordingly. DNS Server 3 Leave empty. NAT Address Leave empty. MAC Address Select Use Factory Default check box. Link Speed & Duplex Auto Detect Multicast Address Leave empty. Connection Keep Alive Disable 7. Click Save Settings. 8. Click EIA-852 Device in the menu on the left. The Config EIA-852 Device screen appears (Figure 75).

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 83 Figure 75: Config EIA-852 Device

9. Configure the settings shown in Figure 75. See Table 20 for the options to select. Some settings vary on a per-site basis and must be modified accordingly. The Config server address and Config server port settings are unique and cannot be used by any of the devices defined in the members list. The Config client port setting must match all devices defined in the members list. Note: An encryption warning message may appear when you are configuring the settings. You can ignore this message. This behavior is typical for LonWorks protocol. Most sites do not require encryption. Table 20: Config EIA-852 Device Settings Field Selection or Entry Config server address Modify accordingly. Config server port Default is 1629. Modify accordingly. Config client port Default is 1628. Modify accordingly. Device name Modify accordingly. Escrow timeout [ms] Modify accordingly. 8 (Must match the Aggregation setting in the Aggregation timeout [ms] Easylon IP Interface.) MD5 authentication Default is off. Enable for authentication. MD5 secret Leave empty unless MD5 authentication is on. Location string Modify accordingly. 10. Click Save Settings. 11. Click EIA-852 Server in the menu on the left. The Config EIA-852 Server screen appears (Figure 76).

84 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 76: Config EIA-852 Server

12. Configure the settings shown in Figure 76. See Table 21 for the options to select. Some settings vary on a per-site basis and must be modified accordingly. The server is enabled on only one device. All others are disabled. Table 21: Config EIA-852 Server Settings Field Selection or Entry Config server status enabled Config server port Default is 1629. Modify accordingly. Channel name Modify accordingly. Pri.SNTP server Leave empty. Sec.SNTP server Leave empty. Channel timeout [ms] Leave empty. Auto members off Roaming members off MD5 authentication Default is off. Enable for authentication. MD5 secret Leave empty unless MD5 authentication is on. 13. Click Save Settings. 14. Click EIA-852 Ch. List in the menu on the left. The Config Channel List screen appears (Figure 77). Note: This screen is only available on the device that is enabled to be the configuration server.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 85 Figure 77: Config Channel List

15. Click Add Device. 16. Enter the device name, IP address, and port in the open fields. 17. Click Save. 18. Repeat Steps 15 through 17 for each device. Each device name in the list updates after the IP address and port are entered and saved. A successfully configured system has a green check mark in the Stat column. 19. See Table 22 to determine the status of your devices. Systems that do not have a green check mark do not function correctly. If necessary, see Troubleshooting communication between the configuration server and devices. Table 22: Device Status on Loytec Config Server Icon Status Description The CEA-852 device is not registered with the Unregistered IP-852 channel. The CEA-852 device has not been contacted Not Contacted since the configuration server has started. The CEA-852 device is successfully registered Registered with the IP-852 channel and is fully functional.

86 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Table 22: Device Status on Loytec Config Server Icon Status Description The CEA-852 device is registered, but it is not Not Responding responding at the moment. The CEA-852 device does not support the No Extended NAT extended NAT mode. This device is disabled. The CEA-852 device is disabled, or rejected, on Disabled the channel. 20. When the configuration is complete, go to Configuring LonWorks interfaces and complete all steps in that section. Configuring the Echelon configuration server About this task: Note: Most installations that use the Echelon Config Server also use an LNS network management tool on the same computer.

1. Go to Start > All Programs > Echelon IP-852 Configuration Server > IP-852 Configuration Server. The Echelon LonWorks/IP Configuration Server window opens. 2. Select Channel > New Channel to create a new channel named Configuration Server. Note: You can rename the channel by clicking the channel, then selecting Channel > Rename Channel in the menu. 3. Right-click Configuration Server and select Channel Properties. Ensure the channel properties match those in Figure 81. The Configuration Server port is unique and is not used by any of the devices in the list. The default port is 1629. 4. Select Channel > New Device. Notes:

- You can rename the device by clicking New Device, then selecting Device > Rename Device in the menu. (All the devices in Figure 78 have been renamed.) - If the config server resides on the same computer as the device, all device statuses update immediately. If the config server and the device reside on different computers, the status of the added device may not update until you select Update Members.

5. Right-click the new device and select Device Properties. Ensure the IP address is the same and that the port is not the same as that in the Configuration Server. The default port is 1628 for the device. 6. Repeat Steps 4 and 5 for each router that exists. The IP address and port must match what is defined in the router. 7. Once all devices have been added, select Channel > Update Members. The configuration server establishes communication with and updates the configuration of all the devices (Figure 78). If the update is successful, the device icon turns green, indicating normal operation. Systems that are not green do not function correctly.

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 87 Figure 78: Echelon LonWorks/IP Configuration Server

8. See Table 23 to determine the status of your devices. If necessary, see Troubleshooting communication between the configuration server and devices. Table 23: Device Status on Echelon Config Server Status Color Description Blue There is no communication with the device in this session. Green Normal. Communication has occurred with the device during this session. Communication with the device has failed after you select Update Members. Usually, this status indicates that no response is received from a device to Red which a request was made. Make sure that all security and IP settings are configured properly. Yellow Normal communication, but the Time Check has failed. The i.Lon® 600 router configuration is out of date, incorrect, or incomplete. This status normally indicates work in progress. When the Configuration Server updates the i.Lon 600, the icon turns green. For a large channel (more than 40 devices), this update can take several minutes. If you change Orange a bind in LonMaker®, this can require that the routing tables in every i.Lon router be updated. In this case, you may see many icons turn orange, and then one-by-one turn green again when their routing tables have been updated. Red/White Device is disabled. 9. When the configuration is complete, go to Configuring LonWorks interfaces and complete all steps in that section.

88 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Configuring the LCS85 for use with the Echelon configuration server

1. Go to Start > All Programs > Easylon > 852, then right-click Config 852 Interface and select Run as administrator. The Easylon IP Interface Config Settings window appears. 2. In the window, configure the settings to match Figure 79. See Table 24 for the options to select. Note: The IP Configuration and Soft License Configuration sections contain information that is unique to the site configuration and the hardware installed. Do not change these settings.

Figure 79: Easylon IP Interface Config Settings for the Echelon Configuration Server

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 89 Table 24: Easylon IP Interface Config Settings for Use with the Echelon Configuration Server Field Selection or Entry Aggregation Must be selected with a setting of 8 ms. Config Server Pollinterval Must be selected with a setting of 60. May be selected to if you wish to reduce traffic, Enable Channelrouting but is not required. Must be selected, otherwise the LCS85 does not communicate on the Lon network at startup if the configuration server is not running. The Load saved channel config LCS85 must initially communicate on the Lon network before the channel configuration can be saved. Automatic Start Must be selected. as Service Must be selected. 3. Click Apply. Configuring LonWorks interfaces About this task: The LonWorks Interfaces (also referred to as the Open LDV Network Driver by Echelon) must be installed on a computer that is running LNBuilder using an IP-852 connection. Important: Skip this section if LN Builder (or another LNS Network Management Tool) is not using an IP-852 connection. You must have a functioning configuration server set up before you configure LonWorks Interfaces. Follow all directions in Configuring the Loytec configuration server or Configuring the Echelon configuration server, depending on the configuration server you are using, before completing the steps in this section. 1. Go to Control Panel > LonWorks Interfaces. The LonWorks Interfaces window opens. 2. Select Interface > Add to see the interfaces you may add. Note: Though not shown in Figure 80, the USB Interface automatically appears in the list when it is connected.

90 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 80: LonWorks Interfaces

3. Select IP-852 Interface from the menu. The IP-852 properties appear in the right pane of the window (Figure 81).

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 91 Figure 81: Adding an IP-852 Interface

4. Ensure that the IP address and port are correct. The IP Address field defaults to the IP address defined for the computer and the port defaults to 1628. This port must match the port defined in the routers. Any changes are saved automatically. 5. Click View and enable the Diagnostics pane if it is not already enabled. The Diagnostics pane displays the results of the connection when you test the communication between the configuration server and the device. 6. Select the device in the left pane and click Test. The IP-852 Configuration Server Properties dialog box appears. 7. Select the check box and enter the IP address and port of your configuration server.

92 LonWorks Network Integration with Network Engines and LCS Technical Bulletin Figure 82: IP-852 Configuration Server Properties Window

8. Click OK. The dialog box disappears and the diagnostics pane displays the message The test has started. Waiting for reply from IP-852 Configuration Server. If the configuration server and the device are communicating properly, the message IP-852 Test completed successfully displays. If you do not receive this message, issue the Update Members command if you are using the Echelon Configuration Server, or issue the Recontact command if you are using the Loytec Configuration Server, and then run the test again. The LonWorks Interfaces are properly configured when the test completes successfully.

Troubleshooting communication between the configuration server and devices

• Reset the router so the router table gets updated correctly. The router does not pass data across channels if the router tables are not correct. • Check the configuration settings of the router if communication cannot be established by the configuration server. Make sure the settings match those specified in this appendix. • Establish the connection between a device and the configuration server by selecting the device in the LonWorks Interfaces list and clicking Test. • Use the Update Members command for the Echelon Configuration Server, or use the Recontact command for the Loytec Configuration Server if any devices are not communicating. • Check your firewall and antivirus settings if communication cannot be established with any of the defined devices. Disable the firewall and antivirus software if necessary for testing.

Product warranty

This product is covered by a limited warranty, details of which can be found at www.johnsoncontrols.com/buildingswarranty. Software terms

Use of the software that is in (or constitutes) this product, or access to the cloud, or hosted services applicable to this product, if any, is subject to applicable end-user license, open-

LonWorks Network Integration with Network Engines and LCS Technical Bulletin 93 source software information, and other terms set forth at www.johnsoncontrols.com/ techterms. Your use of this product constitutes an agreement to such terms. Patents

Patents: https://jcipat.com Single point of contact

APAC Europe NA/SA JOHNSON CONTROLS JOHNSON CONTROLS JOHNSON CONTROLS

C/O CONTROLS PRODUCT MANAGEMENT WESTENDHOF 3 507 E MICHIGAN ST

NO. 32 CHANGJIJANG RD NEW DISTRICT 45143 ESSEN MILWAUKEE WI 53202

WUXI JIANGSU PROVINCE 214028 GERMANY USA

CHINA

Contact information

Contact your local branch office: www.johnsoncontrols.com/locations Contact Johnson Controls: www.johnsoncontrols.com/contact-us

© 2021 Johnson Controls. All rights reserved. All specifications and other information shown were current as of document revision and are subject to change without notice.