LOYTEC L-INX User Manual

Automation server
Hide thumbs Also See for L-INX:
Table of Contents

Advertisement

L-INX
L-INX™ Automation Server
User Manual
LOYTEC electronics GmbH

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the L-INX and is the answer not in the manual?

Questions and answers

Summary of Contents for LOYTEC L-INX

  • Page 1 L-INX L-INX™ Automation Server User Manual LOYTEC electronics GmbH...
  • Page 2 Version 4.0 Document № 88073008 LOYTEC MAKES AND YOU RECEIVE NO WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY OR IN ANY COMMUNICATION WITH YOU, LOYTEC SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. THIS...
  • Page 3: Table Of Contents

    2.2.2 IP Configuration via the Web Interface ........... 25 2.2.3 IP Configuration via the LCD Display ............. 26 2.2.4 BACnet Configuration ................27 Getting Started with the L-INX Configurator ..........28 Configuration of the L-IOB I/O Modules ............29 Getting started with logiCAD ................31 Connect with an OPC XML-DA Client ............
  • Page 4 L-INX User Manual LOYTEC 3.4.3 OPC LED ....................43 3.4.4 PLC LED ....................43 3.4.5 FT Activity LED ..................43 3.4.6 MSTP Activity LED ................44 3.4.7 Ethernet Link LED .................. 44 3.4.8 Ethernet Activity LED ................44 3.4.9 CNIP LED ....................44 3.4.10 CS/RNI LED ...................
  • Page 5 L-INX User Manual LOYTEC 4.2.13 MS/TP Configuration ................66 4.2.14 BACnet BDT (Broadcast Distribution Table) .......... 66 4.2.15 E-mail Configuration ................67 4.2.16 Data Points ....................68 4.2.17 Trend ......................70 4.2.18 Scheduler ....................71 4.2.19 Calendar ....................73 4.2.20 Alarm ....................... 74 4.2.21 IEC61131 Configuration ................
  • Page 6 L-INX User Manual LOYTEC 5.3.5 E-mail ...................... 92 CEA-709 Technology ..................93 5.4.1 CEA-709 L-INX Device ................93 5.4.2 CEA-709 Data Points ................94 5.4.3 Static Interface Changes ................95 5.4.4 Limitations for Local CEA-709 Schedulers..........95 5.4.5 Limitations for CEA-709 Alarm Servers ..........95 5.4.6 Limitations for Local CEA-709 Trends ...........
  • Page 7 6.4.3 Configure without LNS ................117 6.4.4 Configure without LNS Using Bindings ..........118 6.4.5 Replace a L-INX ..................119 6.4.6 Adding the L-INX to LNS ..............120 6.4.7 Replace a L-INX in LNS................ 122 Workflows for BACnet ................... 125 6.5.1 Involved Configuration Files ..............
  • Page 8 L-INX User Manual LOYTEC 6.9.3 Use Imported BACnet Objects .............. 151 6.9.4 Edit a Client Mapping ................151 6.9.5 Create Server Object ................152 6.9.6 Export Server Objects to an EDE File ........... 153 6.9.7 Map other Properties than Present_Value ..........154 6.9.8 Enable International Character Support ..........
  • Page 9 L-INX User Manual LOYTEC 6.15.1 Remote Scheduler and Calendar ............178 6.15.2 Alarm Clients ..................179 6.16 Math Objects ....................180 6.16.1 Create a Math Object ................180 6.16.2 Editing a Math Object ................181 7 The CEA-709 Router ................182 CEA-709 Router ....................
  • Page 10 L-INX User Manual LOYTEC 9.1.3 AST Objects ..................201 Using L-WEB ....................203 9.2.1 Create a new L-WEB Project ..............204 9.2.2 Start a Graphical L-WEB Design ............205 9.2.3 Organize L-WEB Projects ..............205 Using the OPC Bridge ..................206 9.3.1 Software Installation ................
  • Page 11 L-INX User Manual LOYTEC 10.7.6 Creating Device Templates ..............228 10.7.7 Poll Groups .................... 230 10.7.8 Trending Synchronized Meter Data ............232 10.7.9 M-Bus Protocol Analyzer ..............233 11 Modbus ...................... 235 11.1 Introduction ..................... 235 11.2 Modbus Network ..................... 235 11.3...
  • Page 12 L-INX User Manual LOYTEC 12.5.3 Pre-compiled IEC61131 Program ............274 12.6 Additional features ..................274 12.6.1 Force Update Functionality ..............274 12.6.2 Using UNVT variables ................275 12.6.3 Create Your Own Data Type ..............275 12.6.4 Using Persistent Data Points and Markers ..........276 12.6.5 LINX-110 System Registers, System Time ...........
  • Page 13 L-INX User Manual LOYTEC 17 Application Notes..................301 17.1 The LSD Tool ....................301 17.2 Use of Static, Dynamic, and External NVs on a Device ....... 301 18 Specifications .................... 302 18.1 Physical Specifications ..................302 18.1.1 LINX-10X/11X/20X/21X ..............302 18.1.2 LINX-12X/15X/22X ................
  • Page 14 IP ........Internet Protocol IP-852 ......... logical IP channel that tunnels CEA-709 packets according CEA-852 LSD Tool ......LOYTEC System Diagnostics Tool MAC ........Media Access Control MD5 ........Message Digest 5, a secure hash function, see Internet RFC 1321 M-Bus .........
  • Page 15 L-INX User Manual LOYTEC UI ........User Interface UNVT ......... User-defined Network Variable Type UTC ........Universal Time Coordinated VIF, VIFE ......Value Information Field, Value Information Field Extension XML ........eXtensible Markup Language Version 4.0 LOYTEC electronics GmbH...
  • Page 17: Introduction

    L-INX to transmit E-mails on certain conditions. Generated alarms can be configured to send e-mails to predefined addresses. Alarms can also be stored in a historical alarm log. Trended data collected by the L-INX is available in CSV format and through a dedicated Web service.
  • Page 18: Cea-709.1

    L-INX User Manual LOYTEC via a jog dial. Also available on some L-INX models are ports for SD card memory, USB peripheral bus and a 2-port Ethernet Switch/Hub. The L-INX is used for:  Exposing data of control network devices from different technologies (CEA-709, BACnet, Modbus, M-Bus) to data points in the automation server, ...
  • Page 19: Bacnet

    BACnet models without the router can register as a foreign device (FD) with other BBMDs. The device is fully compliant with ANSI/ASHRAE 135-2008 (1.5) and ISO 16484-5. Please refer to Table 1 to learn, which L-INX models have BACnet and the router option.
  • Page 20: M-Bus

    LIP-ME200 from LOYTEC. The BACnet/IP interface can be used to connect the L-INX to an IP-based high-speed backbone. The L-INX also can act as a BBMD for a BACnet/IP network. For a detailed description of the BACnet router‘s usage refer to the LIP-ME201 User Manual [2].
  • Page 21: Liob

    Some L-INX automation server models allow connecting physical I/Os directly to the device via the LIOB I/O modules. Those modules can be stacked up to the L-INX using the LIOB Connect feature. The connected I/O modules are automatically identified and coupled as data points into the L-INX automation server.
  • Page 22: Scope

    (see note 3 in Table 1). 1.8 Scope This document covers L-INX devices with firmware version 4.0 and the L-INX Configurator version 4.0 and higher. The usage of logiCAD itself is beyond the scope of this manual. Please refer to the logiCAD online help in case of additional questions.
  • Page 23: Quick-Start Guide

    L-INX User Manual LOYTEC 2 Quick-Start Guide This chapter shows step-by-step instructions on how to configure the LINX-20X for a simple OPC server application. 2.1 Hardware Installation Connect power (12-35 VDC or 12-24 VAC), the MS/TP network, and the Ethernet cable as shown in Figure 1.
  • Page 24: Configuration Of The Linx

    LOYTEC 2.2 Configuration of the LINX The L-INX can be configured via a console interface, LCD display or via the Web interface. To configure the device, the following steps have to be performed: Setup IP configuration (see Sections 2.2.1 and 2.2.2).
  • Page 25: Ip Configuration Via The Web Interface

    L-INX User Manual LOYTEC You should now be able to connect to the LINX-20X with a Web browser. 2.2.2 IP Configuration via the Web Interface Optionally to using the console interface one can also use the Web interface to configure the client device.
  • Page 26: Ip Configuration Via The Lcd Display

    This changes the IP settings of the device. 2.2.3 IP Configuration via the LCD Display L-INX models with an LCD display can also be configured to their basic settings through jog dial navigation on the LCD UI. Turn the jog dial to navigate between menu items and press to enter a menu or go into selection mode.
  • Page 27: Bacnet Configuration

    L-INX User Manual LOYTEC To Set the IP Address on the LCD Display On the LCD main screen navigate to Device Settings »». Then navigate to Device Mgmt »», TCP/IP Setup »». There navigate to the needed input fields, press and change the value. Press again to set the value.
  • Page 28: Getting Started With The L-Inx Configurator

    Before setting up a working IEC61131 program or creating an L-Web visualization, the data points of the L-INX automation server need to be set up. These can be data points of L-IOB I/Os, network variables, BACnet objects, and other available technologies. Before executing the steps below, install the L-INX Configurator Software from the ‗setup.exe‘.
  • Page 29: Configuration Of The L-Iob I/O Modules

    LIOB-FT bus with standard TP/FT-10 wiring rules. Please visit the L-IOB User Manual [7] for detailed hardware installation and terminal configuration instructions. The L-INX Configurator uses a separate tab to configure the L-IOB devices. The L-IOB device configuration can be done off-line and is shown in the following steps.
  • Page 30 L-INX User Manual LOYTEC Figure 9: Add LIOB devices to the LIOB-Connect bus. Select a L-IOB device in the tree on the left-hand side and enter names for the terminals by double-clicking into the Name column as shown in Figure 10.
  • Page 31: Getting Started With Logicad

    After downloading the L-INX configuration into the L-INX device, the L-IOB input and output terminals can be tested with the L-INX Web UI. An example is shown in Figure 12. Figure 12: Test L-IOB inputs and outputs on the Web UI.
  • Page 32 L-INX User Manual LOYTEC Figure 13: logiCAD project wizard Select Create new project and press Next. Figure 14: Available project templates Select the project template for the L-INX device (e.g., LINX-11x or LINX-12x). Version 4.0 LOYTEC electronics GmbH...
  • Page 33 L-INX User Manual LOYTEC Figure 15: Project name and path Specify the name of the project and the path where to store the project files, see Figure Figure 16: Additional information After specifying additional information the new project is created by pressing the Finish button.
  • Page 34 In the new LogiCAD project there are no external variables yet. To expose data points from the L-INX to the logic program, activate the PLC check box of the corresponding data points in the Configurator, e.g., the L-IOB I/Os of the universal input or any other data point such as a network variable, user register or BACnet object.
  • Page 35 L-INX User Manual LOYTEC Figure 18: Exposed PLC data points appear in LogiCAD 11. Now the logic can be developed on the function plan. 12. For later debugging, it is good practice to add online test fields to the drawing, to display the current value of the signals during online test.
  • Page 36: Connect With An Opc Xml-Da Client

    In case the password of the device or the PIN code of the LCD UI has been forgotten you may need to reset the device back to factory defaults to gain access again. On the L-INX models 10X, 11X, 20X, 21X press the service button and power-cycle the device. On the L-INX models with the jog dial press the jog dial and power-cycle the device.
  • Page 37: Hardware Installation

    L-INX User Manual LOYTEC 3 Hardware Installation 3.1 Enclosure 3.1.1 LINX-10X/11X The LINX-10X/11X enclosure is 107 mm wide for DIN rail mounting, following DIN 43 880 (see Figure 22). Ethernet DIP Switch 1 2 3 4 5 6 7 OPC/PLC...
  • Page 38: Linx-12X/15X

    L-INX User Manual LOYTEC 3.1.2 LINX-12X/15X The LINX-12X/15X enclosure is 159 mm wide for DIN rail mounting, following DIN 43 880 (see Figure 23). Power Ethernet OPC, PLC Ethernet USB, Modbus M-Bus Dial LEDs LEDs SD Card LEDs Figure 23: LINX-12X/15X Enclosure (dimensions in mm).
  • Page 39: Linx-20X/21X

    L-INX User Manual LOYTEC 3.1.3 LINX-20X/21X The LINX-20X/21X enclosure is 107 mm wide for DIN rail mounting, following DIN 43 880 (see Figure 24). Ethernet DIP Switch 1 2 3 4 5 6 7 OPC/PLC MS/TP BACnet/IP, Ethernet Console Power...
  • Page 40: Linx-22X

    3.2.1 LINX-10X/11X The product label on the side of the LINX-10X/11X contains the following information (see Figure 26):  L-INX order number with bar-code (e.g., LINX-100, LINX-111),  serial number with bar-code (Ser#),  unique node ID and virtual ID of each port (NID1, VID1) with bar-code, ...
  • Page 41: Linx-12X/15X

    Figure 26: LINX-10X/11X product label. Unless stated otherwise, all bar codes are encoded using ―Code 128‖. An additional label is also supplied with the L-INX for documentation purposes. A virtual ID (VID) is a Node ID on the IP channel.
  • Page 42: Linx-22X

    Figure 28: LINX-20X/21X product label. Unless stated otherwise, all bar codes are encoded using ―Code 128‖. An additional label is also supplied with the L-INX for documentation purposes. 3.2.4 LINX-22X The product label on the side of the LINX-22X contains the following information (see Figure 29): ...
  • Page 43: Led Signals

    The power LED lights up green when power is supplied to the power terminals. 3.4.2 Status LED This LED is available on L-INX models 10X, 11X, 20X, 21X only. The device is equipped with a red status LED (see Figure 24). This LED is normally off. During boot-up the status LED is used to signal error conditions (red).
  • Page 44: Mstp Activity Led

    3.4.9 CNIP LED This LED is available on L-INX models 10X, 11X only. The CNIP LED is a three color LED that indicates different operating states of the device‘s CEA-852 device.
  • Page 45: Cs/Rni Led

    BBMD is enabled. Otherwise, it is off. 3.4.13 Wink Action If the CEA-709 L-INX receives a wink command on any of its network ports, it shows a blink pattern on the CNIP and the CEA-709 activity LEDs. The CEA-709 activity and the CNIP LED turn green/orange/red (each 0.15 s).
  • Page 46: Status Button

    All this is done when the button is released. Afterwards a reset is performed to let the changes take effect. Important: If the L-INX is moved from one location to another or if major changes to the configuration of the network are made, it is recommended to reset the configuration to factory defaults.
  • Page 47: Lcd Display And Jog Dial

    3.6 LCD Display and Jog Dial L-INX models with an LCD display can also be configured to their basic settings through jog dial navigation on the LCD UI. The main page of the LCD UI is shown in Figure 30. It displays the device‘s IP address, hostname, CPU load, system temperature and supply...
  • Page 48: Dip Switch Settings

    3.7 DIP Switch Settings The DIP switch assignment for the device is shown in Table 5. Please leave all switches at default state. Note, that the L-INX models 12X, 15X, 22X do not have DIP switches. DIP Switch # Function...
  • Page 49: Wiring

    L-INX User Manual LOYTEC Terminal Function BACnet MS/TP / Modbus RS-485 Ground BACnet MS/TP / Modbus RS-485 Non-Inverting Input BACnet MS/TP / Modbus RS-485 Inverting Input Ethernet 100Base-T Earth Ground Power Supply 12 – 35 VDC or 12 – 24 VAC ± 10 %...
  • Page 50: Linx-12X/15X

    L-INX User Manual LOYTEC Important: When using 2-wire MS/TP, earth ground must be connected to both terminal 15 and 16 (see Figure 33a). Never connect terminal 17 to earth ground! 2-wire Power Supply 3-wire Power Supply MS/TP MS/TP Ethernet Ethernet Figure 33: Connecting the LINX-20X/21X: (a) 2-wire MS/TP, (b) 3-wire MS/TP.
  • Page 51: Linx-22X

    L-INX User Manual LOYTEC Figure 34: Connecting the LINX-12X/15X. 3.9.4 LINX-22X The terminals and wiring information for the LINX-22X can be seen in Figure 35. If BACnet over MS/TP is enabled, the MS/TP network segment must be properly terminated with an LT-04 network terminator connected at each of the two ends of the segment media.
  • Page 52 L-INX User Manual LOYTEC Figure 35: Connecting the LINX-22X. Version 4.0 LOYTEC electronics GmbH...
  • Page 53: Web Interface

    L-INX User Manual LOYTEC 4 Web Interface The L-INX comes with a built-in Web server and a Web interface to configure the L-INX and extract statistics information. The Web interface allows configuring the IP settings, CEA-709, BACnet and other configuration settings.
  • Page 54 L-INX User Manual LOYTEC Figure 36: Device Information Page. The device information page shows information about the L-INX and the current firmware version. It also contains operational parameters, such as free memory, system temperature and supply voltage. Click through the menus on the left hand side to become familiar with the different screens.
  • Page 55: Device Configuration

    L-INX User Manual LOYTEC configuration. Note that the user accounts are also used to log on to the FTP and Telnet server. Figure 38: Password Configuration Screen. Please change the administrator password in order to protect yourself from unwanted configuration changes by anyone else. To do so, select the admin account in the drop-down box and enter the new password.
  • Page 56: Backup And Restore

    L-INX User Manual LOYTEC Figure 39: System Configuration Page, e.g., for Vienna, Austria. The next section on the page allows configuring the device‘s earth position. This setting defines the longitude, latitude and elevation of the device. The latitude and longitude are entered as degrees, minutes, and seconds.
  • Page 57: Port Configuration

    L-INX User Manual LOYTEC Figure 40: Backup/Restore page. 4.2.3 Port Configuration This menu allows configuring the device‘s communications ports. For each communication port, which is available on the device and shown on the label (e.g., Port 1, Port 2 Ethernet), a corresponding configuration tab is provided by the Web UI.
  • Page 58 L-INX User Manual LOYTEC Hostname and Domainname are optional entries and can be left empty. For some DHCP configurations it may be necessary to enter a hostname. Please contact your system administrator on how to configure DHCP to acquire an IP address. Further, you can configure up to 3 Domain Name Servers.
  • Page 59: Ethernet Sniffer

    Figure 43: FTP server configuration on the Ethernet port. 4.2.5 Ethernet Sniffer The L-INX models, which provide a built-in Ethernet switch/hub, can configure the switch to operate as a hub. This allows connecting a laptop computer to the second Ethernet port and running a packet sniffer on the device.
  • Page 60 The configuration server sets the SNTP server addresses and the Channel timeout. The filed Escrow timeout defines how long the CEA-852 device on the L-INX waits for out-of-sequence CEA-852 data packets before they are discarded. Please enter the time in ms or ‗0‘...
  • Page 61: Router Configuration

    This is optional and for informational purposes only. If the CEA-852 device on the L-INX is used behind a NAT router, the public IP address of the NAT router or firewall must be known. To automatically detect the NAT address leave the Auto-NAT checkmark enabled.
  • Page 62 Enter NTP timer server address and ports in the fields Primary SNTP and Secondary SNTP. The L-INX will synchronize to NTP time if primary or primary and secondary NTP servers are specified. A list of available timeservers can be found at www.ntp.org.
  • Page 63: Channel List

    It is best to use a cross-over Ethernet cable connected to the PC. 4.2.10 CEA-852 Channel List This page is only available on CEA-709 L-INX models with the router option (101, 111, 121, 151). If the configuration server is enabled on the LINX, the CEA-852 device list can be seen in the CEA-852 channel list menu.
  • Page 64: Bacnet Configuration

    L-INX User Manual LOYTEC Figure 49: CEA-852 channel membership list. The device status information is indicated with descriptive icons of different colors. The description for the different status indicators is shown in Table 8. The Flags column indicates with an A that the device is an auto member.
  • Page 65: Bacnet/Ip Configuration

    L-INX User Manual LOYTEC Figure 50: BACnet Device Configuration. Further, the description and location can be configured. These configuration items correspond to the properties Description, and Location respectively of the BACnet Device object. Depending on the selected BACnet/IP mode, applicable fields are enabled and others are grayed-out.
  • Page 66: Ms/Tp Configuration

    On a BACnet L-INX without a BACnet router BACnet MS/TP port is not enabled by default. On a BACnet L-INX with a BACnet router the MS/TP port is enabled by default.
  • Page 67: E-Mail Configuration

    L-INX User Manual LOYTEC BACnet/IP mode is set to Broadcast Management Device, see Section 4.2.11, the BDT (Broadcast Distribution Table) specifies all other BBMDs of the BACnet/IP network. The BDT is shown in Figure 53. Figure 53: BACnet Broadcast Distribution Table.
  • Page 68: Data Points

    L-INX User Manual LOYTEC Figure 54: E-mail Configuration Page. 4.2.16 Data Points The device‘s Web interface provides a data point page, which lists all configured data points on the device. An example is shown in Figure 55. The data point page contains a tree view.
  • Page 69 L-INX User Manual LOYTEC Data Point Status Description normal The data point is in normal operation state and possesses a value. invalid value The data point has no valid value. offline (config) The data point has a value but it is not reflected on the network due to a configuration error (not commissioned, no binding, no client mapping, etc.)
  • Page 70: Trend

     Could not set value (error code): The new value has not been set because of an internal error. Please contact LOYTEC with the error code. 4.2.17 Trend The Web interface provides a configuration page to re-configure trend logs at run-time. The changes made to the trend logs take effect immediately without the needs for a reboot of the device.
  • Page 71: Scheduler

    L-INX User Manual LOYTEC Figure 57: Trend log configuration page. The user can change the Trend Mode, the Fill Mode, the Log Interval and the Fill Level Notification. Furthermore, data points can be added to the trend log by clicking the Add…...
  • Page 72 L-INX User Manual LOYTEC Figure 58: Schedule Configuration Page. Figure 59: Scheduled Presets Configuration Page. You can switch back and forth between the two tabs. Once the configuration is complete, click on the Save button. This updates the schedule in the device. Any changes made become effective immediately.
  • Page 73: Calendar

    L-INX User Manual LOYTEC Figure 60: Re-configure scheduled data points on the Web UI. 4.2.19 Calendar The Web interface provides the calendar page to edit its calendars at run-time, i.e. change the exception days. The calendar main page displays all available calendars. Click on the calendar to be edited.
  • Page 74: Alarm

    Downloading a new IEC61131 may result in the need for a new data point configuration. Hence, take care about the requirements of the downloaded program and in case of a different set of IEC61131 variables use the L-INX configuration tool to adapt the data point configuration.
  • Page 75: Device Statistics

    The System Log page prints all messages stored in the system log of the device. An example is shown in Figure 64. This log data is important for trouble-shooting. It contains log entries for reboots and abnormal operating conditions. When contacting LOYTEC support, have a copy of this log ready.
  • Page 76: Ip Statistics

    L-INX User Manual LOYTEC Figure 64: System Log Page. 4.3.2 IP Statistics Figure 65 shows the IP statistics page. It allows finding possible problems related to the IP communication. Specifically, any detected IP address conflicts are displayed (if the device‘s IP address conflicts with a different host on the network).
  • Page 77: Statistics

    The CEA-852 statistics page displays the statistics data of the CEA-852 device on the device. It is only displayed if the CEA-852 interface is enabled and supported by the L-INX model. The upper part of the CEA-852 statistics page is depicted in Figure 66. To update the statistics data, press the button Update all CEA-852 statistics.
  • Page 78: Statistics

    L-INX User Manual LOYTEC Figure 67: Enhanced Communication Test Output. The Round Trip Time (RTT) is measured as the time a packet sent to the peer device needs to be routed back to the LINX-10X. It is a measure for general network delay. If the test to a specific member fails, a text is displayed to describe the possible source of the problem.
  • Page 79: Opc Server Statistics Page

    L-INX User Manual LOYTEC Figure 68: CEA-709 Statistics Page. 4.3.6 OPC Server Statistics Page The OPC server statistics page shows statistics data, which contains information on currently and previously connected clients. An example list of OPC clients is shown in Figure 69.
  • Page 80: Bacnet Ms/Tp Statistics

    The BACnet MS/TP statistics page is only available, when the MS/TP data link layer is enabled (see Section 4.2.13) and supported by the L-INX model. An example is shown in Figure 70. The separated part on the top of the table contains the most important statistics data.
  • Page 81: Scheduler Statistics Page

    L-INX User Manual LOYTEC 4.3.8 Scheduler Statistics Page The scheduler statistics page provides an overview of what is scheduled at which day and which time. In the Display Schedules list, select a single schedule to view its scheduled values and times. Use the multi-select feature to get the overview of more schedules. An example is shown in Figure 71.
  • Page 82: L-Web

    L-INX User Manual LOYTEC Figure 72: Alarm Log Page. The alarm log contents can be uploaded from the device in a CSV formatted file. Click on the button Upload Alarm Log to upload the current log. To clear the log, press the button Clear Alarm Log.
  • Page 83 L-INX User Manual LOYTEC  resetting the data point configuration from a remote location. This option clears all data points and the entire port configuration. It leaves the IP settings intact. The Contact item provides contact information and a link to the latest user manual and the latest firmware version.
  • Page 84: Concepts

    L-INX User Manual LOYTEC 5 Concepts 5.1 Data Points 5.1.1 Overview Data points are part of the fundamental device concept to model process data. A data point is the basic input/output element on the device. Each data point has a value, a data type, a direction, and a set of meta-data describing the value in a semantic context.
  • Page 85: Timing Parameters

    L-INX User Manual LOYTEC 5.1.2 Timing Parameters Apart from the meta-data, data points can be configured with a number of timing parameters. The following properties are available to input or output data points, respectively:  Pollcycle (input): The value is given in seconds, which specifies that this data point periodically polls data from the source.
  • Page 86: Parameters

    L-INX User Manual LOYTEC a master switch. Setting the top-level data point to be persistent enables persistency for all sub-data points. Clearing it disables persistency for all sub-data points. 5.1.5 Parameters A data point can be qualified as a parameter data point. This is accomplished in the Configurator software by setting a Parameter check box on the data point.
  • Page 87: User Registers

    L-INX User Manual LOYTEC exposed to the OPC server. By default, all system registers are checked for being exposed to OPC. To reduce the number of needed OPC tags, you may deselect certain system registers, which are not useful in a specific project.
  • Page 88: Ast Features

    L-INX User Manual LOYTEC  m inputs data points are connected to 1 output data point. The most common connection will be the 1:1 connection. This is the type of connection that is auto-generated by the Configurator software. Other types must be created manually in the Configurator.
  • Page 89: Historical Alarm Log

    L-INX User Manual LOYTEC 5.3.2 Historical Alarm Log The alarm summary of the alarm objects contains a live list of currently active and acknowledge-pending alarms. As soon as an alarm becomes inactive and has been acknowledged, it disappears from the alarm summary. To store a historical log of alarm transitions an alarm log is utilized.
  • Page 90 L-INX User Manual LOYTEC Figure 74: Example of a Daily Schedule. For some tasks the daily schedules on weekdays is sufficient. However, on some specific dates, there may be exceptions to the regular week. This can be implemented by defining daily schedules for exception days.
  • Page 91 L-INX User Manual LOYTEC priority exist, it is not defined, which one is in effect. Therefore, always use distinct priorities. Apart from the defined value presets, there exist special events that can be scheduled in a daily schedule. They affect how the scheduler behaves and which exception is active: ...
  • Page 92: Trending

    L-INX User Manual LOYTEC  A date range: This defines a range. Starting with a start date and ending with the end date. No wildcards should be used.  A Week-and-Day definition: This defines dates based on a week, such as every 1st Friday in a month, every Monday, every last Wednesday of a month.
  • Page 93: Technology

    CEA-709 configuration (see Section 4.2.6). The schematic is shown in Figure 77 (a). If configured for the FT channel, the L-INX provides an RNI for remote access to the FT channel. The RNI can be used to commission nodes and trouble-shoot communications on the FT channel.
  • Page 94: Data Points

    L-INX User Manual LOYTEC the CEA-709 router in the L-INX needs to be commissioned. See Chapter 7 for more information on the built-in router and configuration server. 5.4.2 CEA-709 Data Points Data points in the CEA-709 network are known as network variables (NVs). They have a direction, a name, and a type, known as the standard network variable type (SNVT) or user- defined network variable type (UNVT).
  • Page 95: Static Interface Changes

    L-INX device in the LNS database and restores the previous bindings and dynamic NVs. If the L-INX is not configured with an LNS-based tool, this support is not available. The new static interface is only available in a new XIF file or by uploading the new device template into the database.
  • Page 96: Limitations For Local Cea-709 Trends

    L-INX User Manual LOYTEC 5.4.6 Limitations for Local CEA-709 Trends Local CEA-709 trend objects support trending multiple data points in all trend modes, interval, COV, and trigger. The enable data point is also supported. All data points can be NVs, registers or of any other technology. There is no L object linked to the trend object.
  • Page 97: Bacnet Schedulers And Calendars

    L-INX User Manual LOYTEC Feedback_Value property available, alarm conditions cannot be defined for binary output (BO) and multi-state output (MSO) objects. Alarm servers in the BACnet technology are mapped to BACnet Notification Class (NC) objects. Each alarm server is mapped to one NC. The notification class number can be configured in the object instance number property of the alarm server object.
  • Page 98: Iec61131 Variables

    L-INX User Manual LOYTEC BACnet trend logs are limited to interval and COV logs. The trigger mode is not supported in BACnet. The setting linear and ring-buffer logging is mapped to the Stop_When_Full property of the underlying BACnet trend log object. This setting in the Configurator software is a default and can be overridden by writing to the Stop_When_Full property by the OWS.
  • Page 99: The L-Inx Configurator

    6.1 Installation 6.1.1 Software Installation The L-INX Configurator must be used to setup the data point configuration of the L-INX automation server. The Configurator is installed as a plug-in tool for all LNS-based network management tools as well as a stand-alone tool (for systems without LNS).
  • Page 100 If you are using multiple databases (projects) make sure you have registered the plug-in in each project. Under LonMaker  Network Properties  Plug-In Registration make sure that the LOYTEC LINX Configurator (Version X.Y) shows up under Already Registered. Figure 81: Check that the L-INX Configurator is properly registered. Version 4.0 LOYTEC electronics GmbH...
  • Page 101: Operating Modes

    L-INX User Manual LOYTEC 6.1.3 CEA-709 Operating Modes The Configurator can be used in on-line, off-line, and stand-alone mode. On-line and off- line mode refers to the 2 operating modes of your LNS network management software.  On-line Mode: This is the preferred method to use the Configurator. The network management tool is attached to the network and all network changes are directly propagated into the network.
  • Page 102 L-INX User Manual LOYTEC  Imported: This folder has a number of sub-folders for different import methods: CEA-709 CSV File: This folder is used to display data points imported from CSV files. CEA-709 LNS Scan: This folder is used to hold data retrieved from a network database scan.
  • Page 103: Network Port Folders

    L-INX User Manual LOYTEC Alarm Log Configuration: This folder contains the alarm log objects. Each alarm log object creates a historical log of alarm transitions of one or more alarm objects (alarm server or client). To create an alarm log, select the folder and use the context menu.
  • Page 104: Property View

    L-INX User Manual LOYTEC The OPC column provides check boxes for each data point. If checked, the respective data point is exposed to OPC on the device. Deselect the check box, if a data points shall not be exposed to OPC. Note, that deselected data points do not add to the OPC tag limit.
  • Page 105 L-INX User Manual LOYTEC  Poll on Startup: For input data points this property defines, whether the data point shall be polled once at start-up. Poll-on-startup can be enabled independently of the poll cycle. See Section 5.1.2.  Pollcycle: For input data points, this property defines the poll cycle in seconds. Set this property to 0 to disable polling.
  • Page 106: Managing Multistate Maps

    L-INX User Manual LOYTEC the COV increment. If any value change shall generate an update, delete the value, which results in Any.  Active Text: For binary data points this property defines a human-readable text for the active state (true).
  • Page 107: Organizing Favorites

    L-INX User Manual LOYTEC Edit the state texts as needed. Change back to the Assign tab. Select the newly created multistate map and click the Assign button. The assigned map is now displayed next to the data point. 6.2.6 Organizing Favorites There is a special Favorites top-level folder in the device data point folder hierarchy.
  • Page 108: Bacnet Properties

    L-INX User Manual LOYTEC  Data Type: This is the basic NV data type. This is usually filled in from the SNVT definition.  Local NV Member Index: This property specifies the NV member index within a given functional block. This must be a unique index in the functional block, which identifies the NV after other NVs have been added or removed from the interface.
  • Page 109: Project Settings

     Automatically add downloaded device to the OPC Bridge: This option is only available, if LOPC-BR800, the LOYTEC OPC bridge software, is installed on the same PC. If enabled, the LINX-20X device, a configuration is downloaded to, is automatically added to the OPC server list in the bridge. For more information on using LOPC-BR800 refer to Section 9.3.
  • Page 110: Data Point Naming Rules

    L-INX User Manual LOYTEC  Automatically structure imported data points for faster OPC browsing: This option enables the automatic generation of sub-folders when using data points on the device. A sub-folder is created for each scanned or imported device. This allows OPC clients to browse the OPC tags in a hierarchical way.
  • Page 111: Ast Settings

    L-INX User Manual LOYTEC necessary to operate the device with some network management tools that do not support the ECS.  Default Pollcycle for External NVs: When using external NVs, this poll cycle is set as a default for input data points. The poll cycle can be edited individually in the properties view of the data point manager.
  • Page 112 L-INX User Manual LOYTEC  Enable Scheduler Objects: This checkbox enables local L compliant scheduler objects on the device. Checking this box will automatically enable the calendar as well.  Enable Remote AST Objects: This checkbox enables the functional object for NVs, which are used to access remote AST objects.
  • Page 113: Bacnet Settings

    L-INX User Manual LOYTEC Figure 87: CEA-709 AST Project Settings. As can be seen from the above list, it is not easy to configure a L scheduler object. There are many technical parameters which need to be set and which require some knowledge of how these scheduler objects work internally.
  • Page 114: Device Configuration

    L-INX User Manual LOYTEC  Default Poll cycle, Default COV Expiry: This setting defines the default values that are used when creating new client mappings. Changing this option does not affect already existing client mappings. Figure 88: BACnet Project Settings.
  • Page 115: Logicad

    6.3.7 LogiCAD This tab is shown in Figure 90. It is available only with L-INX models that support the IEC61131 PLC kernel. On this tab, the default path to the LogiCAD project may be specified. This is used by the Configurator software to scan for device resources and compiled IEC61131 programs, which may be attached to the L-INX project on the Project Files tab in the main window.
  • Page 116: Workflows For Cea-709

    XIF file: This is the standard file format to exchange the static interface of a device. This file can be used to create a device in the database without having the L-INX on- line. There exists a standard XIF file for the FT port (e.g., LINX-10x_FT-10.xif) and one for the IP-852 port (e.g., LINX-10x_IP-10L.xif).
  • Page 117: Configure Without Lns

    DONE Figure 91: Basic design-flow with LNS. To add more NVs when all bindings are in place and the L-INX is already being used, simply repeat the steps described above. The Configurator software will back up the bindings, create or delete the dynamic NVs, and re-create the bindings again.
  • Page 118: Configure Without Lns Using Bindings

    L-INX User Manual LOYTEC START Start the Configurator stand-alone Section 6.6.1 Upload configuration Section 6.6.2 Import network variables from XIF Import network variables from file Scan online for network variables Section 6.8.1 Section 6.7.3 Section 6.7.4 Select NVs and use on device Section 6.7.5...
  • Page 119: Replace A L-Inx

    In this case the user would need to create all bindings again from scratch (see Section 5.4.3). 6.4.5 Replace a L-INX A device can be replaced in the network by another unit. This might be necessary if a hardware defect occurs.
  • Page 120: Adding The L-Inx To Lns

    6.4.6 Adding the L-INX to LNS To configure a L-INX in your LonMaker drawing, the device needs to be added to the LNS database and commissioned. This Section refers to LonMaker TE and describes how to add a L-INX to your database.
  • Page 121 In the Device Template group box select the existing device template of the LINX. Select ―LINX-xxx_FT-10‖, if the L-INX is configured to use the FT-10 interface, or ―LINX-xxx_IP-10L‖, if the L-INX is configured to be on the IP channel. For information on how to configure which port to use, refer to Section 4.2.6 for the Web...
  • Page 122: Replace A L-Inx In Lns

    Figure 99: The L-INX has been added to the drawing. 6.4.7 Replace a L-INX in LNS This Section describes how to replace a L-INX in your LNS database. The example discusses a LINX-10X but is general to all CEA-709 L-INX models. The description refers to LonMaker TE.
  • Page 123 L-INX User Manual LOYTEC nvi01temp nvo00temp nvi03lux nvo02lux nvi05lev_percent nvo04lev_percent nvi07temp_f nvo06temp_f nvi09switch nvo08switch nvi11motor_state nvo10motor_state nvi13amp nvo12amp nvi15fire_test nvo14fire_test nvi17state nvo16state nvi19temp nvo18temp Gateway[0] linx Channel FT-10 Figure 100: LonMaker drawing with one LINX. To Replace a Device in LonMaker TE Select the device and right-click on the device shape.
  • Page 124 L-INX User Manual LOYTEC Figure 102: Click Next without loading an application image. Then select Online as shown in Figure 103 and click Next. Figure 103: Select online state. Select the Service pin method and click on Finish as shown in Figure 104.
  • Page 125: Workflows For Bacnet

    Figure 104: Select Service Pin and click Finish. Then the service pin requestor opens as shown in Figure 105. Press the service pin on the replacement L-INX on the correct port. You can also send the service pin using the Web interface (see Section 4.1).
  • Page 126: Engineer On-Line

    L-INX User Manual LOYTEC 6.5.2 Engineer On-Line The flow diagram in Figure 106 shows the steps on how to configure the BACnet port when being on-line. In this case, the device must be present in the BACnet network and configured with an IP address. The user can connect to the device and scan for existing BACnet devices and objects on the network.
  • Page 127: Replace A L-Inx

    (see Section 6.6.4). 6.5.4 Replace a L-INX A L-INX can be replaced in the network by another unit. This might be necessary if a hardware defect occurs. First of all, the replacement device needs to be configured with the appropriate IP settings.
  • Page 128: Using The L-Inx Configurator

    LOYTEC LINX Configurator. This starts the Configurator and the main connections screen is displayed. If the L-INX is not yet connected to the network, go to the Firmware menu and select the firmware version and model of the L-INX to be configured. If the L-INX is already connected to the network it is recommended to connect the Configurator online to the LINX.
  • Page 129: Uploading The Configuration

    L-INX User Manual LOYTEC Click on Save to store that connection. Click on Connect. This establishes the connection to the device. 6.6.2 Uploading the Configuration To get the current data point configuration of the device, the configuration needs to be uploaded.
  • Page 130: Configuration Download

    L-INX User Manual LOYTEC Right-click in the data point list and select New Datapoint… in the context menu. This opens the register creation dialog as shown in Figure 111. Figure 111: Create a user register. Enter a Datapoint Name for the register. You may leave the Register Name blank to give the underlying register the same name as the data point.
  • Page 131: Upload The System Log

    L-INX User Manual LOYTEC If the project settings specify to ask (see Section 6.3.1), which specific parameters shall be downloaded, check all that apply and click Ok. Click Start to start the download. Each of the actions is displayed in the Task List section of the dialog.
  • Page 132: Backup And Restore

    L-INX User Manual LOYTEC To Upload the System Log Connect to the device (see Section 6.6.1). Click on the Upload system log button in the tool bar. The upload system log dialog as shown in Figure 114 opens showing the upload progress.
  • Page 133: Configuration

    In LonMaker the plug-in is started by right-clicking on the L-INX device shape or the Gateway/PLC functional block and selecting Configure… from the pop-up window. In NL-220, the Plug-in is started by right clicking on the L-INX node, then selecting the Option LOYTEC LINX Configurator in the PlugIns sub menu.
  • Page 134: Scanning For Network Variables

    L-INX User Manual LOYTEC 6.7.2 Scanning for Network Variables When the L-INX Configurator is connected to an LNS database, network variables can be scanned from that data base. To scan network variables from the LNS database Click on the Datapoints tab.
  • Page 135: Importing Network Variables

    L-INX User Manual LOYTEC 6.7.3 Importing Network Variables Without LNS, the tool cannot connect to an LNS database, where it scans for network variables (NVs). Therefore, the list of NVs to be used on the device has to be available in a CSV file.
  • Page 136: Scanning Nvs Online From The Network

    All items can be selected by pressing <Ctrl-A>. 6.7.4 Scanning NVs online from the Network LOYTEC devices also support an online network scan on the CEA-709 network. In this scan, the device searches for other devices on the CEA-709 network and pulls in NV information of these devices.
  • Page 137 L-INX User Manual LOYTEC If the device has not been installed with a network management tool (e.g. LNS-based tool), press the Configure CEA709 Port button. This opens the device install dialog as shown in Figure 120. Figure 120: Configure CEA-709 port dialog.
  • Page 138: Select And Use Network Variables

    L-INX User Manual LOYTEC Figure 121: CEA-709 network scan results. 10. Click Close when all devices needed have been scanned. 6.7.5 Select and Use Network Variables Data points in the CEA709 LNS Scan folder, the CEA709 Network Scan folder or in the CEA709 CSV File folder can be selected for use on the device.
  • Page 139: Create Static Nvs

    Figure 122: Change the NV allocation type. 6.7.7 Create Static NVs The LOYTEC device can be configured to change its static interface and boot with a new one. Apart from creating static NVs from scanned or imported data points, static NVs can also be created manually in the CEA709 port folder.
  • Page 140: Create External Nvs

    L-INX User Manual LOYTEC Figure 123: Create a static NV manually. Enter a data point name and a programmatic name. The programmatic name is the name of the static NV which is being created. Select a resource file. To create a SNVT, let the STANDARD resource file be selected.
  • Page 141 L-INX User Manual LOYTEC Right-click in the data point list and select New Datapoint… in the context menu. This opens the NV creation dialog. Click on the tab External as shown in Figure 124. Figure 124: Create a new external NV.
  • Page 142: Configuration Download Over Lns

    L-INX User Manual LOYTEC Figure 125: Manually created external NV in the port interface definition. 6.7.9 Configuration Download over LNS After the data points have been configured, the configuration needs to be downloaded to the device. For doing so, the device must be online. If the device is not yet connected to the network, the configuration can be saved to a project file on the local hard drive.
  • Page 143: Enable Legacy Nm Mode

    L-INX User Manual LOYTEC Figure 126: Configuration Download Dialog via LNS. Note, that after the download is complete, the interface changes become active on the device (i.e., the static NV interface has changed). Refresh the network management tool to synchronize the tool with the changes to the LNS database made by the Configurator (e.g., use the menu ―LonMaker|Refresh‖...
  • Page 144: Build Xif For Port Interface

    L-INX User Manual LOYTEC Click OK. Download the configuration to activate the change. 6.7.11 Build XIF for Port Interface When using static NVs on the device, the Configurator can export a new XIF file for the changed static interface. To Create a XIF File Select the CEA-709 Port folder Right-click on that folder and in the context menu select Build XIF ….
  • Page 145: Advanced Cea-709 Configuration

    L-INX User Manual LOYTEC Click on Finish. The new dynamic NVs now appear in the data point list and can be edited and used on the device. 6.8 Advanced CEA-709 Configuration 6.8.1 Import Devices from XIF Templates When working entirely without LNS, nodes on the network can be engineered via importing device templates from a XIF file.
  • Page 146: Using Feedback Data Points

    L-INX User Manual LOYTEC If devices have been imported via a XIF file, they do not have a node ID (all zero). To assign the physical node to the device, select the imported device. Click the Update NodeID button and press the service button on the network node.
  • Page 147: Working With Configuration Properties

    L-INX User Manual LOYTEC the original output NV for polling the target NV. Once the binding is changed the new target is polled. No additional input NV needs to be created for the feedback value, if the feedback data point feature is used.
  • Page 148: Working With Unvts, Ucpts

    L-INX User Manual LOYTEC Figure 129: Configuration Tab for Configuration Properties in NL220. To Synchronize CPs in LonMaker TE Right-click on a device object and select Commissioning  Resync CPs… from the context menu. This opens the dialog shown in Figure 130.
  • Page 149: Bacnet Configuration

    6.9 BACnet Configuration 6.9.1 Scan for BACnet Objects LOYTEC devices also support an online network scan on the BACnet network. In this scan the device searches for other devices on the BACnet network and pulls in the BACnet object information of these devices. These BACnet objects can then be used on the device as the basis for client mapping.
  • Page 150: Import From Ede File

    Which components are expected, please refer to Section 13.3.3. Example EDE files can be found in the ‗examples‘ directory of the LOYTEC Configurator software installation directory. To Import BACnet Objects from an EDE File Open the data point manager dialog.
  • Page 151: Use Imported Bacnet Objects

    L-INX User Manual LOYTEC Right-click and select Import File. In the following file selector dialog, choose the EDE import file and click OK. Now the BACnet EDE File folder is populated with the imported BACnet objects. 6.9.3 Use Imported BACnet Objects After BACnet objects have been imported (with a network scan or by importing from an EDE file) the user can select the BACnet objects that the device shall access.
  • Page 152: Create Server Object

    L-INX User Manual LOYTEC Figure 133: Modify Client Mapping Dialog. Edit the target device by selecting a different device in the list of known devices. Edit the target object instance number. For read client mappings edit the COV expiry or Pollcycle setting.
  • Page 153: Export Server Objects To An Ede File

    L-INX User Manual LOYTEC Figure 134: Create a Server Object manually. In the Mandatory Properties enter a Datapoint Name and an Object Type. Optionally, update the Instance No and select the Commandable check box for value objects, if the value object shall be commandable from the network.
  • Page 154: Map Other Properties Than Present_Value

    L-INX User Manual LOYTEC Figure 135: EDE Export Dialog. Click the button to select the EDE file export location. Specify the Device Name and Device Instance. The device instance will be used by other tools to configure their BACnet clients for accessing the exported device.
  • Page 155: Enable International Character Support

    L-INX User Manual LOYTEC Click Close. The selected data point can now be expanded with the plus icon and show its additional properties as sub-data points. To remove properties perform the same steps and uncheck the corresponding check- boxes. Alternatively, select the property (or more) and press the Delete key.
  • Page 156 L-INX User Manual LOYTEC To manually create a new connection  Click on the Connections tab in the tool bar of the main connections window and press Add Connection…. A new connection is added to the connection list. Rename the connection if you want to do Click on Select Hub…...
  • Page 157: Create Connections From A Csv File

    L-INX User Manual LOYTEC 6.10.2 Create Connections from a CSV File A quick way to perform batch edit on connections is to export and import connections from the connections CSV file. Each line in the connections CSV file identifies a connection. The first column is the connection name.
  • Page 158: Connection Overview

    L-INX User Manual LOYTEC To Delete a Connection Change to the Connections tab of the main window. Select the connection for removal. Use multi-select to select more than one connection. Click Remove. 6.10.4 Connection Overview Select the Connection Summary tab to get a graphical representation of all connections. It represents the two connected data points, their technology they are based on and the direction of the connection.
  • Page 159: Trigger E-Mails

    L-INX User Manual LOYTEC Figure 140: Configure E-Mail Template Dialog. Enter text in the E-mail Text multi-line field. If the e-mail text shall contain values of data points, add data points to the Data Sources list by clicking the Add… button.
  • Page 160: Attachments

    L-INX User Manual LOYTEC Note, that the behavior of the trigger data point is influenced by the COV properties of the data point. If the Only notify on COV property is checked, the data point triggers only if its value changes to the value of the trigger condition. If that property is not checked, the data point triggers on every write with a value that matches the trigger condition.
  • Page 161: Limit E-Mail Send Rate

    L-INX User Manual LOYTEC Change to the Attachments tab. Note: Of course, you can also change directly to the Attachments tab when creating an e-mail template. Select an available file from the Attach File drop-down box. Click the Add button. The file appears in the Attachments list.
  • Page 162: Create Calendar Pattern

    L-INX User Manual LOYTEC Figure 141: Create New Calendar dialog box. Click Create Calendar. The calendar appears now in the data point list view. 6.12.2 Create Calendar Pattern When a local calendar is used, it needs to be configured with calendar patterns. A calendar pattern represents a class of days such as ―Holidays‖.
  • Page 163: Configure Scheduled Data Points

    L-INX User Manual LOYTEC Enter a name for the schedule and a description. Note, that the schedule automatically detects a calendar, if it has previously been created. Click Create Schedule. The new schedule appears in the data point list of the Scheduler sub-folder.
  • Page 164: Configure Daily Schedules

    L-INX User Manual LOYTEC Add new value presets by entering a name and pressing the Create button next to the input field. Tip! To generate presets automatically for multi-state data points, click the Auto-Create button. This button is available, if no other presets have been defined yet.
  • Page 165 L-INX User Manual LOYTEC Select a value preset in the Available Data Presets box on the upper right-hand side. Drag and drop the preset from this list into the time table area to define the desired output values on the day schedule.
  • Page 166: Configure Exception Days

    L-INX User Manual LOYTEC If more than one calendar pattern is used, edit the priorities. For example, if a given calendar day falls in both categories, ―Holidays‖ and ―Maintenance‖, the exception day with the higher priority becomes effective on that day. The highest available priority is marked highest.
  • Page 167: Configure Embedded Exceptions

    L-INX User Manual LOYTEC Figure 142: Configure Calendar Pattern Dialog. Click Save Changes when all exception days have been entered. Tip! If not sure, how a date configuration affects the calendar days, click on a pattern in the Pattern Entries list and the affected days will be highlighted in the Preview.
  • Page 168: Configure Control Data Points

    To remove an undesired control data point, click on the Remove button. 6.12.9 Using the SNVT_tod_event On LOYTEC devices with the CEA-709 technology the SNVT_tod_event can be used in a schedule for implementing the next-state feature. The parts of this network variable contain: ...
  • Page 169: Using The Local Scheduler

    L-INX User Manual LOYTEC  Next state: This is the next, future occupancy state in the schedule.  Time to next state: This part reflects the time in minutes until the next state becomes active. To Use a SNVT_tod_event Create a SNVT_tod_event in the data point configuration.
  • Page 170: Create An Alarm Condition

    L-INX User Manual LOYTEC Click Create. The alarm server appears now in the data point list view. For a BACnet alarm server, select the created object and edit the properties for transition priorities (To-Normal, To-Fault, To-Offnormal) and the corresponding check boxes, which define whether acknowledgements are required.
  • Page 171 L-INX User Manual LOYTEC For enable, deadband, low limit and high limit data points can be attached by clicking button. Those data points are used by the device to determine the actual values at run-time. For a binary data point, the dialog as shown in Figure 145 appears. Select the Alarm Server.
  • Page 172: Deliver Alarms Via E-Mail

    L-INX User Manual LOYTEC Figure 146: Alarm Condition for a Multi-State Data Point. For enable, a data point can be attached by clicking the button. This data point is used by the device to determine the actual values at run-time.
  • Page 173: Create An Alarm Log

    L-INX User Manual LOYTEC Change to the Common E-Mail Properties tab. Add the alarm data point as a data source and insert the place holder into the e-mail text as described in Section 6.11.1. 6.13.4 Create an Alarm Log The alarm objects on the device contain an alarm summary (live list) of currently active and acknowledge-pending alarms.
  • Page 174: Local Trending

    L-INX User Manual LOYTEC Click on the button Add… on top of the Logged Alarm Objects list. A data point selector dialog opens. Select one or more alarm objects that shall be logged and click OK. The alarm objects appear in the list.
  • Page 175: Configure Trended Data Points

    L-INX User Manual LOYTEC Figure 147: Basic Trend Object Configuration. Select the desired Trend Mode. Select the Log Size. The display in the dialog will adapt the estimations for needed data logger file size in KB and duration of the trend log. Alternatively, for interval trends, the estimated log duration and log interval can be edited.
  • Page 176: Trend Triggers

    L-INX User Manual LOYTEC Add data points to be trended. Click on Add … which opens a data point selector window. Select the data points and click OK. For each of the attached data points, a line appears in the list below the add button. The trended data points will also appear with the trend icon in the data point manager.
  • Page 177: Download Trend Data In Csv Format

    L-INX User Manual LOYTEC Right-click and select Configure Trend from the context menu. Change to the Triggers tab. Note: Of course, you can also change directly to the Triggers tab when creating a trend object. Click the Add… button. A data point selection dialog opens.
  • Page 178: Remote Ast Objects

    L-INX User Manual LOYTEC For setting up e-mails, the account information has to be configured on the device, e.g., on the Web UI (see Section 4.2.15). Then an e-mail template can be created and the trend object attached as a trigger.
  • Page 179: Alarm Clients

    L-INX User Manual LOYTEC Adjust the basic settings for the newly created objects, such as the object name and description. The object name will be used as the name for the scheduler, as seen on the Web UI. In the CEA-709 technology a static NV is created to receive information from the remote device about changes to the scheduler configuration, so that the local device does not need to poll the remote device.
  • Page 180: Math Objects

    L-INX User Manual LOYTEC Note: Due to the static input NV which is required for a CEA-709 alarm client point, adding alarm clients will change the static interface of the device. The new static input NVs representing the alarm clients on the local device need to be bound to the alarm outputs of the remote device.
  • Page 181: Editing A Math Object

    L-INX User Manual LOYTEC Select a function to be applied on the variables and click the Add Function button. Te resulting formula is displayed at the bottom of the dialog. Alternatively, the formula can be entered there. 10. Add output data points by clicking the Add Output DP button.
  • Page 182: The Cea-709 Router

    135.23.2.52 IP Channel NV Binding Figure 149: The L-INX supports different methods to route packets between the CEA-709 and IP-852 channel. Depending on the CEA-709 router configuration (see Section 4.2.8) the CEA-709 router supports 4 different methods to route packets between the CEA-709 and the IP-852 channel.
  • Page 183: Configured Router Mode

    L-INX User Manual LOYTEC 7.1.1 Configured Router Mode In this operating mode, the router acts like a standard configured router, which can be configured with standard network management tools like LonMaker or NL-220. This operating mode is compatible with the i.LON 1000 and the i.LON 600.
  • Page 184: Store-And-Forward Repeater

    7.2 CEA-852 Device of the Router Every L-INX acts as a device on the IP channel. It either needs to contact a configuration server or a configuration server needs to contact the device in order to set up the proper routing tables.
  • Page 185: Configuration Server For Managing The Ip-852 Channel

    The L-INX contains an embedded configuration server and can therefore replace the PC. The configuration server can be enabled in the L-INX in the CEA-852 server configuration menu in Section 4.2.9. This configuration server can manage one IP-852 channel and up to 256 devices on this IP-852 channel.
  • Page 186: Configuration Server Contacts Ip-852 Device

    MD5 secret if authentication is required, see Section 4.2.7 If multiple CEA-852 devices behind one NAT router are added, the Auto-NAT setting in the L-INX is recommended to be used with the L-INX configuration server. 7.2.4 IP-852 Device Contacts Configuration Server In this scenario, the IP-852 device needs the following parameters set in order to contact the configuration server.
  • Page 187: Firewall And Nat Router Configuration

    600. See Section 7.2.5 on compatibility with the i.LON 600. 7.3.1 Automatic NAT Configuration In order to use the L-INX behind a firewall, the public NAT address and the local IP address must be set in the IP configuration menu (see Section 4.2.4). By default, the NAT address is determined automatically when adding the L-INX to the channel in the configuration server.
  • Page 188: Multiple Ip-852 Devices Behind A Nat: Extended Nat Mode

    Figure 153, the L-INX with private address 192.168.1.100 also acts as a configuration server. If the CS is activated on a L-INX behind a NAT router, the NAT router must have a fixed public IP address. The L-INX with the CS also cannot use automatic NAT discovery. In this case, enter the NAT address of the NAT router manually in the IP configuration menu (Auto-NAT can no longer be enabled on a L-INX with a CS).
  • Page 189 Auto-NAT (135.23.2.1) FT-10 Figure 153: Multiple L-INX devices behind a NAT: Extended NAT Mode. After the NAT router has been configured with the port-forwarding settings and the CS has been turned on, the channel members can be added. This can be done either on the console UI or through the Web interface of the CS.
  • Page 190: Multiple Ip-852 Devices Behind A Nat: Classic Method

    L-INX User Manual LOYTEC Figure 154: Adding a member with extended NAT Mode on the Web UI. 7.3.3 Multiple IP-852 devices behind a NAT: Classic Method If more than one CEA-852 device must be used behind the NAT router and there are devices which do not support the extended NAT mode, we propose the setup from Figure 155.
  • Page 191: Multi-Cast Configuration

    Figure 155: Application that uses multiple L-INX devices behind a NAT router firewall. The L-INX with IP address 192.168.1.100 is member of IP Channel 1 and can be accessed through the Internet. The L-INX devices with IP addresses 192.168.101 to 192.168.1.110...
  • Page 192: Remote Lpa Operation

    7.5 Remote LPA Operation The L-INX supports remote LPA access. This means that a CEA-709 protocol analyzer connected to the Ethernet network can connect to the L-INX and record all packets on the CEA-709 channel (FT-10). Our LPA-IP supports this sophisticated feature. The functionality is shown in Figure 156.
  • Page 193: Channel Timeout

    L-INX User Manual LOYTEC Table 12 summarizes the timing values that must be set when operating the device under WAN conditions. Timing Parameter Value Channel Timeout Average ping delay + Aggregation Timeout Escrowing (Packet The smaller value of: 0.25*Channel Timeout or 64ms...
  • Page 194: Sntp Time Server

    The Auto-NAT feature in the device permanently monitors the current NAT address. When the device detects a change in the NAT address it re-registers with the configuration server using this new address. This feature requires a LOYTEC configuration server (e.g., LINX-101, L-IP) and ―Roaming Members‖ enabled on that CS.
  • Page 195 L-INX User Manual LOYTEC NAT feature must be disabled and the NAT address configured manually. In this case, the Internet service provider needs to assign a fixed public IP address to the NAT router. Version 4.0 LOYTEC electronics GmbH...
  • Page 196: The Linx-100 Rni

    LOYTEC NIC-IP it is intended to be used together with the LOYTEC NIC software. The RNI can be utilized for remote access and configuration as well as trouble-shooting with the remote LPA.
  • Page 197: Opc Server

    9.1 XML-DA OPC Server 9.1.1 Access Methods LOYTEC devices with the built-in OPC server can expose data points over a Web service. The OPC tag namespace is built from the data point hierarchy, which has been configured by the Configurator software. The OPC server on the device implements the data access standard via the Web service interface XML-DA.
  • Page 198: Data Points

    L-INX User Manual LOYTEC accessed in your Web browser or other Internet appliances, such as PDAs. For more information on the L-WEB refer to Section 9.2. Standard OPC clients and SCADA packages, which shall visualize the device‘s data points, must conform to the OPC XML-DA standard. This means they must support the OPC Web service and not only the COM/DCOM protocol.
  • Page 199 L-INX User Manual LOYTEC Figure 159: Client browsing the OPC tag namespace on a LINX-101. 9.1.2.1 Analog Analog data points are exposed as a one-to-one mapping to OPC tags. For each analog data point, an OPC tag is created. The OPC tag contains a number of OPC properties, which are derived from the data point‘s properties:...
  • Page 200 L-INX User Manual LOYTEC  Contact Close Label (String): This property contains the active text of the binary data point.  Contact Close Label (String): This property contains the inactive text of the binary data point. 9.1.2.3 Multi-state Multi-state data points are exposed as a one-to-one mapping to OPC tags. For each multi- state data point an OPC tag is created.
  • Page 201: Ast Objects

    OPC name space. The content of the schedule XML document referred to in this section must be compliant to the scheduleCfg schema. This schema can be found at the LOYTEC Web site. The XML documents can refer to the target namespace ‗http://www.loytec.com/xsd/scheduleCfg/1.0/‘.
  • Page 202 L-INX User Manual LOYTEC  EmbeddedCal (node): This is an optional OPC node. If present, it contains the OPC tags for the embedded calendar. The embedded calendar structure is as defined for calendar objects in Section 9.1.3.2. 9.1.3.2 Calendar Object The device exposes the calendar objects to OPC XML-DA tags.
  • Page 203: Using L-Web

    XML-DA tag interface cannot be used. There are two options: retrieve the complete log as a CSV file, or use the LOYTEC proprietary Data Log Web service (XML-DL). That Web service uses the logHandle provided by a tag. The CSV file location can be obtained from a tag also.
  • Page 204: Create A New L-Web Project

    HTML, Java, etc. Dynamic information is shown in the form of numeric values, text, changing icons, bar graphs, trend logs, alarm and event lists, or schedule controls. The complete set of automation functions of the L-INX Automation Server is fully supported by L-WEB. The automation services are residing in the embedded devices and are distributed over the network to build up a dependable system with L-WEB only accessing these services.
  • Page 205: Start A Graphical L-Web Design

    9.2.3 Organize L-WEB Projects L-WEB projects can be organized within the L-INX configuration project. L-WEB projects can be part of the configuration project and/or stored on the device. For instance, the configuration project may contain a number of L-WEB projects, but for saving space on the device, only one of them is downloaded on the device.
  • Page 206: Using The Opc Bridge

    If you want to remove a project from the device, click Remove in the LINX Device box. If you want to remove the project from the current L-INX project file, click Remove in the L-WEB Projects on PC box. If you want to export the L-WEB project into a separate L-WEB project file, click Export…...
  • Page 207: Configure The Bridge Locally

    COM OPC server through the local bridge. 9.3.3 Export OPC Servers for another PC If the bridge software is not installed locally on the same PC where the L-INX configuration is created, it must be exported to make the OPC server information available. The exported file can then be transferred to the OPC bridge.
  • Page 208: Import Opc Servers Using The Configurator

    L-INX User Manual LOYTEC Connect to the device, which shall be available in the bridge. Select the menu File  Export to OPC Bridge Configuration..In the OPC Bridge Device Properties dialog as shown in Figure 162, add information which is not default, i.e., Min update rate, Wait time and Hold Time (see Section 9.3.6).
  • Page 209: Bridge Timing Parameters

    L-INX User Manual LOYTEC To Configure a Server in the Bridge Start the OPC bridge from the Windows Start menu under Programs  LOYTEC OPC Bridge  OPC Bridge manual Setup. In the system tray, right-click on the bridge icon In the context menu select Register new Server.
  • Page 210: Using Custom Web

    L-INX User Manual LOYTEC points, the group will not be updated faster. If the group specifies a slower update rate, however, the device will be polled less often. Lowering this parameter gives better responsiveness to data changes but also increases the XML-DA traffic and impacts overall performance.
  • Page 211: Bus

    For using the M-Bus with the device an external M-bus interface with an RS-232 connector is required. The external interface must be connected to the LOYTEC device either via the serial connector or the extension port EXT. The M-Bus functionality must be enabled on the device itself.
  • Page 212: Extension Port

    Figure 165. Those devices need to use the L-MBUS converter. On the L-MBUS set the jumper as indicated on the front label. Follow the cabling instructions of Figure 165 between the EXT port of the L-INX and the PORT1 on the L-MBUS.
  • Page 213: Web Interface

    L-INX User Manual LOYTEC currently not supported by the LOYTEC device. The M-Bus network also supports two kinds of broadcast messages. A broadcast to address 255 does not force the slaves to give a response. A broadcast to address 254 forces an answer from the slave. This broadcast message is mainly used for peer-to-peer connections.
  • Page 214: M-Bus Protocol Analyzer

    L-INX User Manual LOYTEC Figure 166: Statistics of the M-Bus port. The following information is available:  Rx bytes: number of bytes received  Tx bytes: number of bytes sent  Tx total: total number of transmissions  Tx errors: number of errors during a transmission ...
  • Page 215: Configurator

    L-INX User Manual LOYTEC Next to the button the status of the protocol analyzer is shown. If the analyzer is started, an automatic refresh is performed every 60 seconds. By pressing the button Start Protocol Analyzer / Stop Protocol Analyzer the protocol analyzer can be started / stopped.
  • Page 216: Folder List

    L-INX User Manual LOYTEC Figure 168: Data Point Manager Dialog with M-Bus folder list Figure 169: Datapoint Manager Dialog with M-Bus Data Point List. 10.5.3 Folder List At the left is a list of folders which is used to sort the available data objects by their category.
  • Page 217: Network Port Folders

    L-INX User Manual LOYTEC M-Bus Port: This folder contains the remote M-Bus data points, which are used on the device. 10.5.4 Network Port Folders The M-Bus network port folder on the device has the same structure of sub-folders as the other network port folders in Section 6.2.2.
  • Page 218: Offline Engineering

    L-INX User Manual LOYTEC 10.6.1 Offline Engineering This section describes how an M-Bus network can be set up without using the M-Bus network. Figure 170 shows the workflow. First, the M-Bus devices, address and Baud rates of the M-Bus devices must be configured for example by following the device manu- facturer‘s guidelines (see Section 10.7.3).
  • Page 219: Using The Configurator For M-Bus

    L-INX User Manual LOYTEC START M-Bus devices already configured in the network? Configure M-Bus devices (change baudrate, change address) Section 10.7.3 Manually Configure M-Bus devices and Scan M-Bus devices and data points Import M-Bus device templates data points Section 10.7.2 Section 10.7.5...
  • Page 220 L-INX User Manual LOYTEC Right click on the Folder M-Bus Network Scan and select Scan M-Bus Network. This opens the M-Bus Network Scan Dialog shown in Figure 172. Figure 172 M-Bus Network Scan dialog. In M-Bus Transmission Settings choose the address scanning mode. The default is secondary address scanning.
  • Page 221: Network Management Functions

    L-INX User Manual LOYTEC Either press on the Use on Device button or right-click and select Use on Device. The selected data points are now available in the Datapoints subfolder of the M-Bus Port folder. To Create Filter Templates from a Network Scan Go to the Datapoints folder of the device of the M-Bus scan.
  • Page 222 L-INX User Manual LOYTEC Figure 173: M-Bus network management dialog. To Add an M-Bus Device Manually Without Scanning Fill in the Device Address and select a Device Baudrate from the drop down box. A Device Name can be specified. If more devices with the same properties have to be created using subsequent addresses, the end address can be specified in the input field on the right hand side of the Device Address field.
  • Page 223 L-INX User Manual LOYTEC Click on the Create Device button. This creates the M-Bus device and adds it to the device list on the left hand side of the dialog. When a device is selected the device information is displayed in the appropriate fields on the right hand side of the dialog.
  • Page 224 L-INX User Manual LOYTEC Figure 174 Import M-Bus Device dialog. Press the button and select a template file from the Open dialog. After selecting the file, the device information is displayed. Press Import for importing the template or Cancel for closing the dialog without any changes.
  • Page 225: Manual Configuration Of Data Points

    L-INX User Manual LOYTEC To Scan Devices Using the M-Bus Network Management Dialog Select the Baud rate for the device scan. For more information on scanning the M-Bus network refer to Section 10.7.2. Start the scan by pressing the Scan for Devices button.
  • Page 226 L-INX User Manual LOYTEC Select the device which provides the M-Bus data point. The data point properties are entered in the presented section of the dialog. Enter a data point name. If no name is entered, the data point is named as described in section 10.7.1.
  • Page 227: Importing Via Device Templates

    L-INX User Manual LOYTEC 12. Usually data points are added to a default poll group. If the data point has to be member of another poll group than default, the poll group can be selected using the drop down box.
  • Page 228: Creating Device Templates

    L-INX User Manual LOYTEC Tip: Data points can be added to the data points of the template by right clicking in the data point list and selecting New Datapoint. Importing a device template from the folder list does not create a device instance. Device instances can only be created using the import in the Network Management Dialog.
  • Page 229 L-INX User Manual LOYTEC To Create an M-Bus Device Template Using Devices Select the M-Bus dialog by clicking on the M-Bus button in the tool bar of the Datapoints tab. This opens the Network Management dialog as displayed in Figure 178.
  • Page 230: Poll Groups

    L-INX User Manual LOYTEC Press the Export button. To Create an M-Bus Device Template File Using a Device Template Right-click on the folder of the device template that has to be exported or its data point folder and select Export Device Template… from the context menu.
  • Page 231 L-INX User Manual LOYTEC To Create a Time-Based M-Bus Poll Group Select the M-Bus dialog by clicking on the M-Bus button in the tool bar of the Datapoints tab. The M-Bus Management dialog opens. Open the Pollgroups tab. This shows the dialog displayed in Figure 179.
  • Page 232: Trending Synchronized Meter Data

    L-INX User Manual LOYTEC in the tool bar of the Datapoints tab. In the M-Bus Management dialog, open the Pollgroups tab. This displays the poll groups management tab displayed in Figure 179. Enter a new poll group name and select Trigger-based or Trigger-based with synchronization.
  • Page 233: M-Bus Protocol Analyzer

    L-INX User Manual LOYTEC 10.7.9 M-Bus Protocol Analyzer When connected to a device a protocol analyzer is available for the M-Bus port. The protocol analyzer can be found in the M-Bus Management dialog. Figure 180 shows the dialog for the M-bus protocol analyzer.
  • Page 234 L-INX User Manual LOYTEC Figure 181 Typical protocol analyzer output for M-Bus port. Version 4.0 LOYTEC electronics GmbH...
  • Page 235: Modbus

    1 to 255. The Baud rate of the RS485 can be configured to use 1200, 2400, 4800, 9600, 19200, and 38400 Baud. The parity is always none. The LOYTEC Modbus interface supports 8N1 only. Parity and stop bits are not configurable.
  • Page 236: Web Interface

    L-INX User Manual LOYTEC For optimizing the communication adjacent holding registers are usually read using a single read request. This behavior can be turned of for devices which do not support reading a random number of holding registers. Modbus data points are specified by the function code, the address and the length.
  • Page 237: Data Points

    L-INX User Manual LOYTEC Figure 183 Modbus TCP port configuration. On an Ethernet port, Modbus TCP can be enabled by selecting the check box. The Modbus TCP communication settings are displayed on the right-hand side as shown in Figure 183.
  • Page 238: Modbus Protocol Analyzer

    L-INX User Manual LOYTEC  Checksum errors: number of communication errors (wrong checksum) 11.3.4 Modbus Protocol Analyzer By activating the link Protocol Analyzer (available in all Modbus statistics tabs), the protocol analyzer page is shown as displayed in Figure 185.
  • Page 239: Data Point Manager For Modbus

    L-INX User Manual LOYTEC In the Device Config tab enable the Modbus check boxes on the desired ports as shown in Figure 186. Setting the check box enables Modbus on that port. Edit the Modbus communication settings. If slave mode is enabled, you may change the default Modbus register layout in the Modbus Slave Register Configuration box.
  • Page 240: Folder List

    L-INX User Manual LOYTEC Figure 187: Data Point Manager Dialog with Modbus folder list. Figure 188: Datapoint Manager Dialog with Modbus Data Point List. 11.4.3 Folder List At the left is a list of folders which is used to sort the available data objects by their category.
  • Page 241: Modbus Properties

     Modbus Multiplier, Exponent and Offset: This property defines scaling parameters for the data point. The value of the data point in the LOYTEC device is calculated as follows: Exponent Value = (ModbusValue + Offset) ∙ Multiplier ∙ 10 ...
  • Page 242: Using The Configurator For Modbus

    The Modbus Management dialog can also be used for the configuration of poll groups and for accessing the LOYTEC devices protocol analyzer. To Start the Modbus Network Management Dialog Connect to the device via FTP as described in section 6.6.1.
  • Page 243 L-INX User Manual LOYTEC Figure 190: Modbus management dialog. To Add a Modbus Device Manually Fill in the Device Address and select the Type (either RS485 or TCP) from the drop down box. A Device Name can be specified. If no device name is specified, the device name is created automatically.
  • Page 244 L-INX User Manual LOYTEC To Add a Modbus Device Manually Using a Template without Creating Data Points Enter a name for the Modbus device in the Device Name field. If no name is specified the name is created automatically from the name in the template file.
  • Page 245: Manual Configuration Of Data Points

    L-INX User Manual LOYTEC Click on the Create with DP button. This opens the Import Modbus Device Template dialog shown in Figure 191. Press the button and select a template file from the Open dialog. After selecting the file, the device information is displayed.
  • Page 246 L-INX User Manual LOYTEC This opens the Create New Modbus Datapoint dialog showing only the devices which are available on the appropriate port. This dialog is shown in Figure 192. Figure 192 Create Modbus Datapoint dialog. If the Modbus device which provides the data point is not in the list, it has to be created.
  • Page 247: Importing Via Device Templates

    L-INX User Manual LOYTEC Swap 16 bit, Swap 32 bit and Swap 64 bit. When Swap 16 bit is activated, the 2 byte of a word are swapped, when Swap 32 bit is activated, the 2 words of a 32 bit value are swapped and if Swap 64 bit is activated, the two 32 bit words of a 64 bit value are swapped.
  • Page 248 L-INX User Manual LOYTEC To import a Modbus Device Template Right click on the Folder Modbus Device Templates and select Import device template from the context menu. This opens the Import Modbus Device Template dialog shown in Figure 193. Figure 193 Import Device Template dialog.
  • Page 249: Creating Device Templates

    L-INX User Manual LOYTEC Either press on the Use on Device button or right-click and select Use on Device. This opens the Choose Modbus Device Instance dialog. Figure 194: Choose Modbus Device Instance dialog. The device list displays all devices which have the same Manufacturer, and the same Model Name as the template.
  • Page 250: Poll Groups

    L-INX User Manual LOYTEC Press the Export Device Templ. button. This opens the Export Modbus Device Template dialog shown in Figure 195. The list on the left side of the dialog shows the names of the data points which are exported to the template.
  • Page 251 L-INX User Manual LOYTEC in the tool bar of the Datapoints tab. This opens the Modbus Management dialog. Open the Pollgroups tab. This shows the dialog displayed in Figure 196. Figure 196: Pollgroup Management dialog. The default poll group is selected and its properties are displayed. Enter the name of the new poll group and enter the poll cycle in seconds.
  • Page 252: Modbus Protocol Analyzer

    L-INX User Manual LOYTEC To Create a Trigger-Based Modbus Poll Group Select the Modbus dialog by clicking on the Modbus button in the tool bar of the Datapoints tab. This opens the Modbus Management dialog. In the Modbus Management dialog, open the Pollgroups tab. This displays the poll groups management tab displayed in Figure 196.
  • Page 253 L-INX User Manual LOYTEC running for an interesting time, the protocol data can be loaded from the device using the Load From Device button. The protocol data can be stored as CSV file using the Save button, with the Clear button, the shown protocol is deleted.
  • Page 254 L-INX User Manual LOYTEC  Timestamp: transmission time.  Frame Type: RTU, ASCII or Damaged when something happened with the frame.  Dir.: direction. Either SND (send) or RCV (receive)  Addr.: Slave address  CRC: CRC of the transmission ...
  • Page 255: Iec 61131

    LOYTEC 12 IEC 61131 To design the IEC61131 program which should run on the L-INX device, the graphical programming tool logiCAD is required. The tool allows creating IEC61131 programs using various IEC61131 programming languages. It offers additional features downloading and debugging of the created program.
  • Page 256: Iec61131 Project Files

    12.3 IEC61131 Project Files In the L-INX Configurator select the Project Files tab to attach an IEC61131 program and a logiCAD project to the L-INX project. The tab is shown in Figure 203.
  • Page 257: Working With Logicad

    L-INX Configurator asks, if the attached program should be downloaded as well. This way, no logiCAD is required to download a suitable IEC61131 program in a separate step. The project designed in the L-INX Configurator can hold all necessary information to set up a running device: ...
  • Page 258 L-INX User Manual LOYTEC To be able to use the L-INX with logiCAD, a predefined project template for the L-INX must be used. Hence, when creating a new project, select the project template ―Project for LINX-110‖, see Figure 14. For additional information how to create, delete and manage projects please refer to the logiCAD online help.
  • Page 259: Managing Variables

    L-INX User Manual LOYTEC For designing programs that support the force update functionality (see Section 12.6.1), or designing user-defined Technology Mapper (see Section 12.6.2) additional function blocks are required. These blocks are located within the Loytec_Support directory. All LINX-specific add-ons are provided using function blocks. Hence, in the following, all samples are based on designs using function blocks.
  • Page 260: Build And Download The Iec61131 Program

    L-INX User Manual LOYTEC When starting a new project, no global variables object is available; it must be created before compiling the IEC61131 application. The global variables object can be created automatically or manually, depending on the different workflows, please refer to Section 6.5.
  • Page 261: Usage Of Nvs, Technology Converters

    To be able to communicate with the LINX-110 device via CEA709 the LINX-110 must be commissioned. RS232: To connect via RS232 select LOYTEC RS232 as Driver and LOYTEC as transmission protocol. All other values are set correctly per default. 12.4.3 Usage of NVs, Technology Converters To used CEA-709 variables the content of the NVs must be converted to IEC61131 compliant data types.
  • Page 262: Iec61131 Program Cycle Time

    L-INX User Manual LOYTEC On structured NVs two tasks must be performed by the Technology Converters. First the structure of the NV is mapped to IEC61131 conform data types. Second, if necessary scaling factors are applied. Similar to the Enumeration Converters, the Technology Converters are split up into two subfolders.
  • Page 263: Cpu Overload

    L-INX User Manual LOYTEC 12.4.5 CPU Overload Several conditions affect the CPU utilization of the IEC61131 program. As a result it is not possible to predict the system load caused by the IEC61131 program. E.g. the following parameters are of particular importance when designing IEC61131 programs: ...
  • Page 264: Workflows For The Linx

    Download configuration to device Section 6.6.4 DONE Figure 211: Starting with logiCAD After creating a new project for the L-INX and opening the Functionplan Plan_1 an empty input area is shown, similar to Figure 212. Version 4.0 LOYTEC electronics GmbH...
  • Page 265 L-INX User Manual LOYTEC Figure 212: Start new function plan The dark grey areas on the left and right side are intended to place the input and output variables, the light grey area is used to place the functional blocks.
  • Page 266 L-INX User Manual LOYTEC by selecting the type from the pull-down menu or by drag&drop of a specific type from the project tree, see Figure 214. Finally, the new variable is added by pressing the Add button. Figure 214: External variable type declaration The created variable is added to the declaration area and placed to the drawing area by drag&drop.
  • Page 267 L-INX User Manual LOYTEC Figure 216: Use external variables The Functionplan Plan_1 represents now a simple program. It adds a defined value to the value of the input variable and sends the result to the output variable. Add all expected functionality to the Plan_1 or use different Functionplans to split up the expected functionality into smaller pieces.
  • Page 268 L-INX User Manual LOYTEC Figure 218: Created global variables object Now there is a global variables object called IEC61131 Variables available, containing all global representations of the external variables defined before. The error-state viewer reports all processed program instances and added variables, see Figure 218 for details.
  • Page 269 L-INX User Manual LOYTEC configuration and resource name. The export file is located in the base directory of the currently opened project. The result of the export process is displayed in the Error-state viewer and the generated file is added to the project view.
  • Page 270 L-INX User Manual LOYTEC The tool starts importing the CSV file and finally reports the results of the import process. For the import process the following rules are applied:  New variables are added  Variables with same name and type are ignored ...
  • Page 271: Based On Network Information

    L-INX User Manual LOYTEC 12.5.2 Based on Network Information START Start the Configurator Scan network variables Section 6.7.2 Select NVs and use on device Section 6.7.5 Select Generate and Connect NVs Download configuration to device Section 6.7.9 Export IEC61131 variables...
  • Page 272 L-INX User Manual LOYTEC Figure 224: Create IEC61131 variables In order to use the IEC61131 data points within logiCAD corresponding global variables must be created in logiCAD. Thus, see Figure 225, right click on the IEC61131 folder and select Export IEC61131 CSV …. Store the select name and location for the export file and press Save to start the export process.
  • Page 273 L-INX User Manual LOYTEC Figure 226: Import IEC61131 variables For the import process the following rules are applied:  The name of the global variables object is supplied by the import file. If there is no global variables object it is created. If there is already a suitable global variables object, the existing variables are saved.
  • Page 274: Pre-Compiled Iec61131 Program

    L-INX User Manual LOYTEC Figure 227: Adding global variables to Functionplans After adding function blocks that perform the expected work, the IEC61131 program is ready to compile and download, refer to section 12.4.2 for details. 12.5.3 Pre-compiled IEC61131 Program In opposite to the last two chapters it is assumed that there are already some components finished, hence starting up from scratch is not suitable.
  • Page 275: Using Unvt Variables

    UNVTs and enumerations based on resources files. Start the L-INX Configurator tool, select the menu Tools, and the command Export NV resource file. Select the resource file to export, structured text as format and export the file to a location of your choice.
  • Page 276: Using Persistent Data Points And Markers

    IEC61131 variable import, the data size of custom structures cannot be determined automatically at the moment, so the L-INX Configurator does not know how to create a suitable user data point. As a workaround, the type name must contain the desired size of the data point in bytes, for example: MyStructuredType(UT16) will tell the L-INX Configurator to create an IEC61131 register of type ‗user‘...
  • Page 277: Operating Interfaces

    The content of the XML file must be compliant to the scheduleCfg schema. This schema can be found at the LOYTEC Web site. The XML documents can refer to the target namespace http://www.loytec.com/xsd/scheduleCfg/1.0/...
  • Page 278: Alarm Log Csv File

    The data point name can be augmented by engineering units in square brackets. Log entries in the CSV refer to the item index to identify the data point, for which the entry was logged. #log_csv_ver,2 #log_device;LOYTEC;Product Code;Firmware Version;Device ID String;Serial No #log_info;Log-ID;Log Name #log_create;YYY-MM-DD;HH:MM:SS #log_capacity;filled;capacity #log_item;index;UID;data point name [units]...
  • Page 279: Interface

    L-INX User Manual LOYTEC /tmp/uid/allog/UID.csv /data/allog/Alarmlogname_UID.csv The UID is the unique ID of the alarm log object. The UID can be obtained from the ID column in the data point list of the alarm log folder, similar to obtaining the UID of trend log objects.
  • Page 280: Node Object

    Define, how this NV shall be allocated: external=1 (default) / static=2 / file=3 Table 14: CSV Columns of the NV Import File. 13.2.2 Node Object The L-INX provides a node object conforming to the L guidelines.  The Node Object accepts the following commands via nviRequest: RQ_NORMAL,...
  • Page 281: Real-Time Keeper Object

    L-INX User Manual LOYTEC  alarming is supported via nvoAlarm (SNVT_alarm) and nvoAlarm_2 (SNVT_alarm_2). This allows devices supporting the L alarm notifier profile to receive alarms generated by the device and react with a defined action (e.g., send an email). By supporting both alarm SNVTs, SNVT_alarm and SNVT_alarm_2, legacy and state-of-the-art alarm handling is supported.
  • Page 282 L-INX User Manual LOYTEC  nvoElapsedTime (SNVT_elapsed_tm): Time since device powered up or since the statistics for this port where reset. The statistics can be reset with the network variable nviClearStat in the node object (see Section 13.2.2) or if the node is reset with a network management command (e.g., while the device is commissioned).
  • Page 283: Calendar Object

    L-INX User Manual LOYTEC The CRC Error Rate during the last statistic interval (nvoIvalCrcErr) exceeded the limit defined by the SCPThighLimit1 (default 5 %) OR The Missed Packets Rate during the last statistic interval (nvoIvalMissed) was not zero OR The Missed Preamble Rate during the last statistic interval (nvoIvalMisPre) exceeded the limit defined by the SCPThighLimit1 (default switched off).
  • Page 284 L-INX User Manual LOYTEC Property Identifier Property Datatype Conformance Code Object_Identifier BACnetObjectIdentifier Object_Name CharacterString Object_Type BACnetObjectType Vendor_Name CharacterString Vendor_Identifier Unsigned16 Model_Name CharacterString Firmware_Revision CharacterString Application_Software_Version CharacterString Location CharacterString Description CharacterString Protocol_Version Unsigned Protocol_Revision Unsigned Protocol_Services_Supported BACnetServicesSupported Protocol_Object_Types_Supported BACnetObjectTypesSupported Object_List BACnetARRAY[N] of...
  • Page 285 Device Information A whole set of properties provides general purpose information about the device. Vendor_Name (Read-Only). The value of this property is ―LOYTEC electronics GmbH‖. Vendor_Identifier (Read-Only). A numerical value identifying the BACnet vendor. The value of this property is 178.
  • Page 286 L-INX User Manual LOYTEC 13.3.1.3 Object Database The following properties provide information about the BACnet objects contained in the device. Object_List (Read-Only). This property holds a BACnetARRAY of object IDs (object type, object instance pairs), one object ID for each object within the device that is accessible through BACnet services.
  • Page 287 L-INX User Manual LOYTEC BACnet addresses. This property tells a user which BACnet address the device will actually use when trying to communicate with another device known only by its device instance number. This information can be helpful when diagnosing network configuration problems.
  • Page 288 L-INX User Manual LOYTEC Time_Synchronization_Recipients (Read-Writable). This list of recipients will receive TimeSynchronization requests on time synchronization events. A recipients is either specified by its device ID (the object ID of its Device object), or its BACnet address. By default, this list is empty.
  • Page 289 L-INX User Manual LOYTEC 13.3.1.8 Backup & Restore The following properties are related to backup & restore procedures. Configuration_Files (Read-Only). The contents of this property is an array of object IDs of File objects that can backed-up or restored during a BACnet backup or restore procedure.
  • Page 290: Client Mapping Csv File

    L-INX User Manual LOYTEC The following clauses describe the Device object‘s properties in detail, subsuming related properties in a single section in order to provide a coherent overview. 13.3.2 Client Mapping CSV File Client functionality for the BACnet server objects can be defined by so-called client mappings.
  • Page 291: Network Media

    When using the Free Topology Segment feature of the FT, only one termination (Figure 229) is required and can be placed anywhere on the free topology segment. Instead of building the termination, one can order the L-Term module (LT-33) from LOYTEC, which can be used to properly terminate the bus.
  • Page 292: M-Bus

    L-INX User Manual LOYTEC 14.2 M-Bus The device uses the RS-232 console interface for the connection to an external M-Bus transceiver (repeater). The M-Bus specifies no special topology requirement, though it is not advised to use a ring topology. A maximum of 250 M-Bus slave devices can be connected to the bus, in fact, the external bus transceiver can have a lower limit of connected devices.
  • Page 293: Firmware Update

    LOYTEC 15 Firmware Update The L-INX firmware supports remote upgrade over the network and the serial console. To guarantee that the L-INX is not destroyed due to a failed firmware update, the firmware consists of two images: The fallback image, the primary image.
  • Page 294 L-INX User Manual LOYTEC Figure 232: FTP connection dialog. In the FTP connection dialog, enter the IP address of the device as well as the admin user‘s password. The default password is ‗loytec4u‘ (older firmware versions used ‗admin‘). This can be changed via the Web interface (see Section 4.1) and reset via the console UI (see Section 16.2.2).
  • Page 295: Firmware Update Via The Console

    11. The device‘s firmware has now been successfully upgraded. 15.2 Firmware Update via the Console On L-INX models with the console connector it is possible to upgrade the device over this interface. To download the firmware via the console interface, the device must be connected to the RS-232 port (EIA-232) of a PC via its console interface as described in Section 16.2.1.
  • Page 296 L-INX User Manual LOYTEC Figure 236: Progress Bar during Firmware Download. If the upgrade is successful, the following window appears (Figure 237). Figure 237: Successful Firmware Upgrade. Double check that the new firmware is executed by selecting ‗1‘ and pressing Enter in the console window.
  • Page 297: Troubleshooting

    L-INX User Manual LOYTEC 16 Troubleshooting 16.1 Technical Support LOYTEC offers free telephone and e-mail support for the L-INX product series. If none of the above descriptions solves your specific problem please contact us at the following address: LOYTEC electronics GmbH...
  • Page 298: Reset Configuration (Load Factory Defaults)

    L-INX User Manual LOYTEC Device Main Menu ================ Show device information Serial firmware upgrade System configuration CEA-709 configuration IP configuration CEA-852 device configuration CEA-852 server configuration Reset configuration (factory defaults) Device statistics Modbus cofiguration Data Points Reset device Please choose: Figure 238: Console Main Menu.
  • Page 299 L-INX User Manual LOYTEC 16.2.3.1 IP statistics A sample console output is shown in Figure 241. *********** INTERFACE STATISTICS ************ ***** lo0 ***** Address:127.0.0.1 Flags: Up Loopback Running Multicast Send queue limit:50 length:0 Dropped:0 ***** eth0 ***** Address:192.168.0.2 Broadcast Address:192.168.0.255...
  • Page 300 L-INX User Manual LOYTEC As useful information, the MAC address of the conflicting host is shown. If the information about this conflict shall be cleared, enter ‗y‘. If ‗n‘ is selected, the conflict will show up again the next time this menu is entered.
  • Page 301: Application Notes

    Please refer to application note ―AN009E Changing Device Interface in LNS‖ for more information on the static NV interface, XIF files, device templates and the use of static, dynamic, and external NVs on LOYTEC gateway products. Version 4.0 LOYTEC electronics GmbH...
  • Page 302: Specifications

    L-INX User Manual LOYTEC 18 Specifications 18.1 Physical Specifications 18.1.1 LINX-10X/11X/20X/21X 12 – 35 VDC or 12 – 24 VAC ±10 % Operating Voltage Power Consumption typ. 3 W In rush current up to 950 mA @ 24 VAC Operating Temperature (ambient) 0C to +50C...
  • Page 303: Resource Limits

    IP 40 (enclosure); IP 20 (screw terminals) Installation rail mounting (EN 50 022) wall mounting 18.2 Resource Limits Table 18 specifies the resource limits of the different L-INX models. L-INX Model Limits Total number of data points 10,000 10,000 30,000...
  • Page 304: References

    L-INX User Manual LOYTEC 19 References L-IP User Manual, LOYTEC electronics GmbH, Document № 88065909, June 2006. LIP-ME201 User Manual, LOYTEC electronics GmbH, Document № 88073501, October 2008. NIC User Manual, LOYTEC electronics GmbH, Document № 88067212, September 2008. LWEB-800 User Manual, LOYTEC electronics GmbH, Document №...
  • Page 305: Revision History

    L-INX User Manual LOYTEC 20 Revision History Date Version Author Description 2008-12-23 Initial revision V3.0 for LINX-20X 3.0 2009-02-20 Added Section 5.2 Connections, Chapter 10 M-Bus 2009-05-14 Updated for LINX-20X firmware release 3.3, added Chapter 11 Modbus, added Section 6.1.5. Behavior on Value Changes, added Section 6.1.6 Custom Scaling,...

Table of Contents