1. Manuals
  2. Brands
  3. LOYTEC Manuals
  4. Gateway
  5. L-Gate
  6. User manual

LOYTEC L-Gate User Manual

Cea-709/bacnet gateway
Hide thumbs Also See for L-Gate:
Table of Contents

Advertisement

Quick Links

Download this manual
™
L-Gate
CEA-709/BACnet Gateway
User Manual
LOYTEC electronics GmbH

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Related Manuals for LOYTEC L-Gate

Summary of Contents for LOYTEC L-Gate

  • Page 1 ™ L-Gate CEA-709/BACnet Gateway User Manual LOYTEC electronics GmbH...
  • Page 2 Version 3.2 Document 88072407 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 PRODUCT IS NOT DESIGNED OR INTENDED FOR USE IN EQUIPMENT...

  • Page 3: Table Of Contents

    1 Introduction ....................11 Overview ......................11 Scope........................12 2 Quick-Start Guide ..................13 Hardware installation ..................13 Configuration of the L-Gate................14 2.2.1 IP Configuration on the Console .............14 2.2.2 IP Configuration via the Web Interface ...........15 2.2.3 BACnet Configuration................16 Gateway Configuration with LNS-based Tools..........17 3 Hardware Installation ................18...
  • Page 4 L-Gate User Manual LOYTEC 4.2.3 Port Configuration................... 28 4.2.4 IP Configuration..................28 4.2.5 CEA-709 Configuration ................30 4.2.6 CEA-852 Device Configuration.............. 30 4.2.7 BACnet Configuration ................32 4.2.8 BACnet/IP Configuration................ 32 4.2.9 MS/TP Configuration ................33 4.2.10 BACnet BDT (Broadcast Distribution Table) ......... 34 4.2.11 E-Mail Configuration ................
  • Page 5 5.6.1 BACnet Data Points.................59 5.6.2 BACnet Alarming ..................59 5.6.3 BACnet Schedulers and Calendars ............60 5.6.4 BACnet Trend Logs.................60 Automatic Generation of Connections ............61 6 The L-Gate Configurator ................62 Installation ......................62 6.1.1 Software Installation ................62 6.1.2 Registration as a Plug-In................62 6.1.3 Operating Modes ..................64 Data Point Manager..................64...
  • Page 6 L-Gate User Manual LOYTEC 6.4.4 Configure without LNS Using Bindings ..........77 6.4.5 Replace an L-Gate ................... 79 6.4.6 Configure from BACnet................79 Adding L-Gate ....................80 Replace an L-Gate .................... 83 Using the L-Gate Configurator ............... 86 6.7.1 Starting as an LNS Plug-In..............86 6.7.2 Starting Stand-Alone ................
  • Page 7 L-Gate User Manual LOYTEC 6.10.6 Map other Properties than Present_Value..........110 6.10.7 Enable International Character Support..........111 6.11 E-Mail Templates....................112 6.11.1 Create an E-Mail Template ..............112 6.11.2 Trigger E-Mails..................113 6.11.3 Attachments ...................114 6.11.4 Limit E-Mail Send Rate .................115 6.12 Local Schedule and Calendar ................115 6.12.1 Create a Calendar...................115...
  • Page 8 7.3.1 Device Object..................144 7.3.2 Client Mapping CSV File..............147 7.3.3 EDE Export of BACnet Objects............148 8 Network Media ..................149 FT........................149 9 L-Gate Firmware Update ................150 Firmware Update via the Configurator............150 Firmware Update via the Console..............152 10 Troubleshooting..................154 10.1 Technical Support ..................
  • Page 9 L-Gate User Manual LOYTEC 14 Revision History ..................161 Version 3.2 LOYTEC electronics GmbH...
  • Page 10 DNS........Domain Name Server, RFC 1034 DST ........Daylight Saving Time GMT ........Greenwich Mean Time IP ........Internet Protocol LSD Tool......LOYTEC System Diagnostics Tool MAC........Media Access Control MD5 ........Message Digest 5, a secure hash function, see Internet RFC 1321 MS/TP ........

  • Page 11: Introduction

    ANSI/CEA-709 and ENV14908, ANSI/ASHRAE-135-2004 and ISO 16484. On the CEA-709 side of the L-Gate, there can be up to 1000 NVs. The NVs can be bound in the CEA-709 network or operated as “external NVs”. External NVs are polled or explicitly written to without allocating static or dynamic NVs on the L-Gate.

  • Page 12: Scope

    All of those new CEA-709 data points can be mapped automatically to BACnet objects. In firmware versions from 3.0 and up, the L-Gate also supports Trendlog, Schedule and Notification Class objects. These objects can be used to operate on any of the basic BACnet objects, which are mapped to CEA-709 NVs.

  • Page 13: Quick-Start Guide

    Ethernet Figure 1: Basic Hardware Installation If the L-Gate is connected to a BACnet MS/TP network, 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 14: Configuration Of The L-Gate

    LOYTEC 2.2 Configuration of the L-Gate The L-Gate can be configured via a console interface or via the Web interface. To configure the L-Gate, the following steps have to be performed: 1. Setup IP configuration (see Sections 2.2.1 and 2.2.2).

  • Page 15: Ip Configuration Via The Web Interface

    In a Web browser enter the default IP address 192.168.1.254 of the L-Gate. Note that if your PC has an IP address in a subnet other than 192.168.1.xxx please open a command tool and enter the following route command to add a route to the L-Gate.

  • Page 16: Bacnet Configuration

    L-Gate User Manual LOYTEC Figure 5: Enter admin as the default administrator password. 6. The Config menu opens. Click on Port Config and change to the tab Ethernet. The TCP/IP settings are selected as shown in Figure 6. Enter the IP address, the IP netmask, and IP gateway for this device.

  • Page 17: Gateway Configuration With Lns-Based Tools

    ID on the BACnet internetwork. Also the Device Name must be a unique name on the BACnet internetwork. By default the BACnet/IP data link layer is used. If the L-Gate shall be used with the BACnet MS/TP data link layer, please refer to Section 4.2.7 for further information.

  • Page 18: Hardware Installation

    L-Gate User Manual LOYTEC 3 Hardware Installation 3.1 Enclosure 3.1.1 LGATE-900 The L-Gate enclosure is 6 TE (1 TE = 17.5 mm) wide for DIN rail mounting, following DIN 43 880 (see Figure 8). Ethernet DIP Switch Serial Number 1 2 3 4 5 6 7...

  • Page 19: Product Label

    3.4 LED signals 3.4.1 Power LED The L-Gate power LED lights up green when power is supplied to terminals 15, 16, and 17. 3.4.2 Status LED The L-Gate is equipped with a red status LED (see Figure 8). This LED is normally off.

  • Page 20: Ethernet Link Led

    CNIP LED turns off for 50 ms. Only valid CEA-709 IP packets sent to the IP address of the L-Gate can be seen. Stale packets or packets not addressed to the L-Gate are not seen. Yellow: The CEA-852 device is functional but some configuration data is not up-to-date...

  • Page 21: Wink Action

    LOYTEC 3.4.9 Wink Action If the L-Gate 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). This pattern is repeated six times. After that, the...

  • Page 22: Terminal Layout And Power Supply

    Table 3: DIP Switch Settings for L-Gate 3.7 Terminal Layout and Power Supply The L-Gate provides screw terminals to connect to the network as well as to the power supply. The screw terminals can be used for wires of a maximum thickness of 1.5 /AWG12.
  • Page 23 L-Gate User Manual LOYTEC 2-wire 3-wire Power Supply Power Supply MS/TP MS/TP Ethernet Ethernet Figure 9: Connecting the L-Gate: (a) 2-wire MS/TP, (b) 3-wire MS/TP Version 3.2 LOYTEC electronics GmbH...

  • Page 24: Web Interface

    LOYTEC 4 Web Interface The L-Gate comes with a built-in Web server and a Web interface to configure the L-Gate and extract statistics information. The Web interface allows configuring the IP settings, CEA-852 and CEA-709 settings, and the BACnet settings. This interface is very simple to use and has an intuitive, self-explanatory user interface.
  • Page 25 (2) operator is able to read more sensible information such as calendar data. (3) admin has full access to the L-Gate and can make changes to its configuration. Note that the user accounts are also used to log on to the FTP and Telnet server.

  • Page 26: Device Configuration

    To do so, select the admin account in the drop- down box and enter the new password. If the administrator password is left empty, password protection is turned off and everyone can access the L-Gate without entering a password. Click on Change password to activate the change.

  • Page 27: Backup And Restore

    A configuration backup of the L-Gate device can be downloaded via the Web interface. Press the Backup/Restore link as shown in Figure 14 to start the download. The L-Gate device assembles a single file including all required files. A file requestor dialog allows specifying the location where the backup file shall be stored.

  • Page 28: Port Configuration

    L-Gate User Manual LOYTEC Figure 14: 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. An example is shown in Figure 15.
  • Page 29 The device can be configured to synchronize its clock with NTP time. Enter the IP address of a primary and, optionally, a secondary NTP server. The L-Gate will use NTP as a time source if the time sync source in the system configuration page is set to NTP (see Section 4.2.1).

  • Page 30: Configuration

    Please note that on device models without a router or a proxy, the CEA-709 protocol on other ports will be disabled (e.g., LINX-100, L-Gate). The CEA-852 protocol settings are displayed in the settings box on the right-hand side as shown in Figure 19.
  • Page 31 NAT router. Please refer to the L-IP User Manual [1] to learn more about NAT configuration. In the field Device name the user can enter a descriptive name for the L-Gate, which will appear in the IP channel to identify this device. You can enter a device name with up to 15 characters.

  • Page 32: Bacnet Configuration

    This is optional and for informational purposes only. If the CEA-852 device on the L-Gate 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 33: Ms/Tp Configuration

    These values should be left at default: 30000ms / 3 retries. • Broadcast Management Device (BBMD): This option is available on the L-Gate. It is the same as Device but the BBMD function is enabled (see Section 4.2.10). 4.2.9 MS/TP Configuration The BACnet MS/TP protocol can be enabled on the device’s port Port2 if available.

  • Page 34: Bacnet Bdt (Broadcast Distribution Table)

    MS/TP max master configuration options at their default settings. 4.2.10 BACnet BDT (Broadcast Distribution Table) The BBMD function is only available on the L-Gate. The BBMD function is needed when a BACnet/IP network spans over several IP subnets separated by IP routers. If the device is configured as a BBMD (see Section 4.2.7), the BDT (Broadcast Distribution Table)

  • Page 35: Data Points

    The device’s Web interface provides a data point page, which lists all configured data points on the L-Gate. An example is shown in Figure 25. The data point page contains a tree view. Clicking on a particular tree item fills the right part of the page with a data point list of that tree level and all levels below.
  • Page 36 L-Gate 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 37: 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.13 Trend The Web interface provides a configuration page to re-configure trend logs at run-time.
  • Page 38 L-Gate User Manual LOYTEC The effective period defines when this schedule shall be in effect. Leave From and To at ‘*.*.*’ to make this schedule always in-effect. Otherwise enter dates, such as ’30.1.2000’. To entirely disable a scheduler de-select the Enable Schedule check box.

  • Page 39: Calendar

    L-Gate User Manual LOYTEC Figure 29: Scheduled Data Point Value 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 40: Alarm

    L-Gate User Manual LOYTEC calendar to be edited. This opens the calendar configuration page. An example is shown in Figure 31. The effective period defines when this calendar shall be in effect. Leave From and To at ‘*.*.*’ to make this calendar always in-effect. Otherwise enter dates, such as ’30.1.2000’.

  • Page 41: Device Statistics

    The System Log page prints all messages stored in the system log of the device. An example is shown in Figure 38. 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 42: Ip Statistics

    Figure 34 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 L-Gate’s IP address conflicts with a different host on the network). Figure 34: IP Statistics Page Version 3.2...

  • Page 43: Statistics

    4.3.4 Enhanced Communications Test The Enhanced Communications Test allows testing the CEA-852 communication path between the CEA-852 device on the L-Gate and other CEA-852 devices as well as the configuration server. The test thoroughly diagnoses the paths between individual members of the IP channel and the configuration server in each direction.

  • Page 44: Statistics

    Table 6: Possible Communication Problems. 4.3.5 CEA-709 Statistics The CEA-709 statistics page displays statistics data of the CEA-709 port on the L-Gate as shown in Figure 37. This data can be used to troubleshoot networking problems. To update the data, click on the button Update CEA-709 statistics.

  • Page 45: Bacnet Ms/Tp Statistics

    L-Gate User Manual LOYTEC Figure 37: CEA-709 Statistics Page 4.3.6 BACnet MS/TP Statistics The BACnet MS/TP statistics page is only available, when the BACnet port is configured for the MS/TP data link layer (see Section 4.2.7). An example is shown in Figure 38. The separated part on the top of the table contains the most important statistics data.

  • Page 46: Scheduler Statistics Page

    L-Gate User Manual LOYTEC master on the network. If there are multiple masters on the network, this state is a hint to a broken cable. In state TOKEN LOST, the token is currently not circulating. The counter MS/TP lost tokens is an indicator for communication problems on the MST/TP network.

  • Page 47: Reset, Contact, Logout

    4.4 Reset, Contact, Logout The menu item Reset allows two essential operations: • Rebooting the L-Gate from a remote location, or • 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.

  • Page 48: Concepts

    5 Concepts 5.1 CEA-709/BACnet Gateway The operating principle of the L-Gate is to connect data points of one network technology to data points of another technology. Data points in the CEA-709 network are known as network variables (NVs). For more information on this technology refer to Section 5.5.

  • Page 49: Timing Parameters

    L-Gate User Manual LOYTEC The basic classes of data points are: • Analog: An analog data point typically represents a scalar value. The associated data type is a double precision machine variable. Meta-data for analog data points include information such as value range, engineering units, precision, and resolution.

  • Page 50: Persistency

    L-Gate User Manual LOYTEC 5.2.4 Persistency Data point values are by default not persistent. This means that their value is lost after a power-on reset. There exist different strategies for initializing data points with an appropriate value after the device has started.

  • Page 51: System Registers

    5.2.7 System Registers The L-Gate provides a number of built-in system registers. They are present without a data point configuration. The system registers, such as the System time or the CPU load, can be exposed to the OPC server.

  • Page 52: Ast Features

    L-Gate User Manual LOYTEC • 1 input data point is connected to n output data points, • 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.

  • Page 53: Historical Alarm Log

    L-Gate User Manual LOYTEC 5.4.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 54 L-Gate User Manual LOYTEC Figure 41: 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 55 L-Gate 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 56: Trending

    L-Gate 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 57: Technology

    Gate. This NV can be bound to the NV on the network. Note that adding static NVs to the L-Gate results in a change to the default XIF file. The L-Gate is assigned a new “model number” to reflect this change (see Section 5.5.2). Static NVs are the way to use NVs in non-LNS systems, where NVs shall be bound instead of using polling.

  • Page 58: Static Interface Changes

    When static NVs are used, the L-Gate changes its static interface and boots with a new one. Each time the static interface of the L-Gate changes (i.e., static NVs are added, deleted, or modified), the model number is changed. The model number is the last byte of the program ID.

  • Page 59: Limitations For Local Cea-709 Trends

    L-Gate User Manual LOYTEC network variable. Acknowledging alarms in the alarm server is adhering to the L specification and relies on the RQ_CLEAR_ALARM mechanism. 5.5.5 Limitations for Local CEA-709 Trends Local CEA-709 trend objects support trending multiple data points in all trend modes, interval, COV, and trigger.

  • Page 60: Bacnet Schedulers And Calendars

    L-Gate User Manual LOYTEC input, output, value objects (AI, AO, AV), for binary input, value objects (BI, BV), and for multi-state input, value objects (MSI, MSV). To define alarm conditions for binary output (BO) and multi-state output (MSO) objects map the Feedback_Value property of the respective server objects to a data point.

  • Page 61: Automatic Generation Of Connections

    L-Gate User Manual LOYTEC through a client mapping. Data points of other technologies and the min/max/avg algorithms cannot be trended in this firmware version. BACnet trend logs are limited to interval and COV logs. The trigger mode is not supported in BACnet.

  • Page 62: The L-Gate Configurator

    The L-Gateway Configuration software must be used to setup the data point configuration of the L-Gate. This configuration utility 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 63 Figure 46: Select the Plug-in to be registered. 3. Click Register. The Configurator now appears in the Pending list. 4. Click Finish to complete the registration. Device templates for the L-Gate are added automatically and XIF files are copied into the LNS import directory.

  • Page 64: Operating Modes

    L-Gate User Manual LOYTEC 6.1.3 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 configuration utility. The network management tool is attached to the network and all network changes are directly propagated into the network.

  • Page 65: Folder List

    709. • L-Gate: This is the device folder of the L-Gate. It contains all the necessary data points which constitute to the L-Gate’s port interface definition. These data points are created on the L-Gate when the configuration is downloaded. The three subfolders...

  • Page 66: Network Port Folders

    L-Gate User Manual LOYTEC alarm objects (alarm server or client). To create an alarm log, select the folder and use the context menu. Using the context menu on a folder, sub-folders may be created to organize the available objects. If new objects are created automatically, they are usually placed in the base folder and can then be moved by the user to any of his sub-folders.

  • Page 67: Property View

    L-Gate User Manual LOYTEC that the data point contains sub-points. These can be structure members for structured SNVTs. Clicking on the plus sign expands the view. For the alarming, scheduling, trending (AST) features, there are columns, which display icons for data points that are attached to an AST function. See Table 7 for details.

  • Page 68: Managing Multistate Maps

    L-Gate User Manual LOYTEC scaling factors. If enabled, the properties Custom Scaling Factor and Custom Scaling Offset accept the scaling factors. See Section 5.2.6. • Custom Scaling Factor, Custom Scaling Offset: These properties only exist, if linear scaling is enabled. They apply to analog data points only. See Section 5.2.6.

  • Page 69: Properties

    L-Gate User Manual LOYTEC To Edit a Multistate Map 1. Click on the button in the State Count property of a multistate data point. This opens the multistate map manager as shown in Figure 49. Figure 49: Assign multistate maps in the multistate map manager.

  • Page 70: Bacnet Properties

    L-Gate User Manual LOYTEC • Invalid Value: This property defines the “invalid value” for the NV. If set, this specific value will be interpreted as “invalid” in the data point. If known by the SNVT, the invalid value is filled in. Otherwise, the user can specify an invalid value.

  • Page 71: Project Settings

    L-Gate User Manual LOYTEC • Server Object Type: This property defines the BACnet object type of the underlying BACnet server object. It can be changed within the class, i.e., for an analog data point, the server object type analog input, analog output, or analog value can be chosen.

  • Page 72: Data Point Naming Rules

    L-Gate User Manual LOYTEC Figure 50: General Project Settings. 6.3.2 Data Point Naming Rules The data point naming rules tab (see Figure 51) allows specifying, how data point names are automatically derived from scanned network variables. The preview shows how names would look like, when the check marks are modified.

  • Page 73: Ast Settings

    L-Gate User Manual LOYTEC 709 domain and subnet/node information. If operated in self-configured mode, the CEA-709 network can be scanned using the network scan (see Section 6.7.6) and external NVs can be used on the device. Note, that the domain must match the nodes’...
  • Page 74 L-Gate User Manual LOYTEC point manager will connect to one of these scheduler objects. There may be more scheduler objects available on the device than are actually used at a certain time. It is a good idea to have some spare scheduler objects ready, in case another scheduler is needed.

  • Page 75: Bacnet Settings

    Figure 54: BACnet Project Settings. 6.4 Workflows for the L-Gate This section discusses a number of work flows for configuring the L-Gate in different use cases in addition to the simple use case in the quick-start scenario (see Section 2.3). The description is intended to be high-level and is depicted in a flow diagram.

  • Page 76: Involved Configuration Files

    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-Gate on- line. There exists a standard XIF file for the FT port (L-Gate-900 FT-10.xif) and one for the IP-852 port (L-Gate-900 10L.xif).

  • Page 77: Configure Without Lns

    L-Gate User Manual LOYTEC To add more NVs when all bindings are in place and the L-Gate is 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 78 (see Section 6.7.5) or scan a CEA-709 network online (see Section 6.7.6). Select the NVs that the L-Gate shall expose to BACnet (see Section 6.7.7). For the NVs used on the L-Gate select the “static NV” allocation type (see Section 6.7.8). Alternatively, you can create static NVs manually (see Section 6.7.9).

  • Page 79: Replace An L-Gate

    (see Section 5.5.2). 6.4.5 Replace an L-Gate An L-Gate can be replaced in the network by another unit. This might be necessary, if a hardware defect occurs. First of all, the replacement L-Gate needs to be configured with the appropriate IP settings, including all relevant BACnet device settings.

  • Page 80: Adding L-Gate

    EDE file (see Section 6.10.2). Select the remote BACnet objects, that the L-Gate shall access and use them on the device to create client mappings on the L-Gate (see Section 6.10.3). Alternatively, you can create BACnet server objects manually (see Section 6.10.5).
  • Page 81 2. Select Commission Device if the device is already connected to the network. 3. In the Device Template group box select the existing device template of the L-Gate. Select “L-Gate-900 FT-10”, if the L-Gate is configured to use the FT-10 interface, or “L-Gate-900 IP-10L”, if the L-Gate is configured to be on the IP channel.
  • Page 82 L-Gate User Manual LOYTEC Figure 62: Use Service Pin. 7. Click Next in the following screens until you get to the final dialog shown in Figure 8. If the device is already on-net, select Online. Figure 63: Final dialog. 9. Click Finish. A dialog will prompt to press the service pin.

  • Page 83: Replace An L-Gate

    Figure 64: The L-Gate has been added to the drawing. 6.6 Replace an L-Gate This Section describes how to replace an L-Gate in your LNS database. The description refers to LonMaker TE. Let’s assume there is a device ‘lgate’ in the LNS database as shown in Figure 65.
  • Page 84 L-Gate User Manual LOYTEC Figure 66: LonMaker replace device wizard. 3. Choose the existing device template and click Next. 4. In the following window shown in Figure 67 click Next. Figure 67: Click Next without loading an application image. 5. Then select Online as shown in Figure 68 and click Next.
  • Page 85 Figure 69: Select Service Pin and click Finish. 7. Then the service pin requestor opens as shown in Figure 70. Press the service pin on the replacement L-Gate on the correct port. You can also send the service pin using the Web interface (see Section 4.1).

  • Page 86: Using The L-Gate Configurator

    In LonMaker the plug-in is started by right-clicking on the L-Gate device shape or the Gateway functional block and selecting Configure… from the pop-up window. In NL-220 the Plug-in is started by right clicking on the L-Gate node, then selecting the Option LOYTEC L-Gate Configurator in the PlugIns sub menu.

  • Page 87: Uploading The Configuration

    L-Gate User Manual LOYTEC If the L-Gate is not yet connected to the network, go to the Firmware menu and select the firmware version of the L-Gate to be configured. If the L-Gate is already connected to the network it is recommended to connect the configuration software to the L-Gate.

  • Page 88: Scanning For Network Variables

    L-Gate User Manual LOYTEC 3. Click on the button Start to start the transfer. This will upload the configuration of all ports, if the software is connected stand-alone via FTP or the network variable interface, for which the LNS plug-in was started for.

  • Page 89: 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 L-Gate has to be available in a CSV file. This file can be produced by external software or created by hand. The CSV format for importing NVs is defined in 7.2.1.

  • Page 90: Scanning Nvs Online From The Network

    All items can be selected by pressing <Ctrl-A>. 6.7.6 Scanning NVs online from the Network L-Gate 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 91 L-Gate User Manual LOYTEC Figure 76: CEA-709 network scan dialog. 4. If the device has not been installed with a network management tool (e.g. LNS-based tool), select the Manually set domain check-box and click the Set button. This sets the device configured, online to start the scan.

  • Page 92: Select And Use Network Variables

    After selecting the Use on device action on scanned or imported NVs they are assigned a default NV allocation in the L-Gate/CEA709 port folder. This default allocation can be changed, e.g., for imported NVs when they shall be allocated as static NVs on the L-Gate. Version 3.2...

  • Page 93: Create Static Nvs

    L-Gate User Manual LOYTEC To Change the NV Allocation Type 1. In the data point view select the NVs in the L-Gate/CEA709 port folder, for which the NV allocation shall be changed. Tip! By using Ctrl-A all NVs can be selected.

  • Page 94: Create External Nvs

    7. Click Create Static NV. The static NV is created and appears in the data point list. 8. Note, that the static interface of the L-Gate will change as soon as static NVs are added or modified in the data point manager. This change is reflected in a new model number, which the L-Gate will have after the configuration download (see Section 5.5.2).
  • Page 95 NV name, the NV type (SNVT) and direction. Note, that the direction is the direction of the external NV on the L-Gate. Therefore, the remote output NV nvo00_switch becomes an input on the L-Gate. Also enter the NV selector in hexadecimal and the NV index in decimal.

  • Page 96: Generate Bacnet Objects

    Figure 81: Manually created external NV in the port interface definition. 6.7.11 Generate BACnet Objects To actually create BACnet mappings from the used NVs on the L-Gate, use the data point manager tab. This section describes how to automatically generate BACnet objects from NVs.

  • Page 97: Create User Registers

    LOYTEC Figure 82: Auto-created BACnet Points in the BACnet Folder Note, when auto-creating the BACnet objects, the L-Gate Configurator initializes the BACnet properties with default values derived from the properties of the CEA-709 NVs. In particular, the object name, description, minimum and maximum present value, and engineering units are generated.

  • Page 98: Configuration Download

    After the data points have been configured, the configuration needs to be downloaded to the L-Gate. For doing so, the L-Gate must be online. If the L-Gate is not yet connected to the network, the configuration can be saved to a project file on the local hard drive.

  • Page 99: Build Xif For Port Interface

    Note, that after the download is complete, the interface changes become active on the L-Gate (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 L-Gate Configurator (e.g., use the menu “LonMaker|Refresh”...

  • Page 100: Upload Dynamic Nvs From Device

    (e.g., last boot time, last shutdown reason) or errors at run- time. This file is important for trouble-shooting and is available on the Web UI (see Section 4.3.1). The file can also be uploaded from the device with the L-Gate Configurator. To Upload the System Log 1.

  • Page 101: Advanced Cea-709 Configuration

    They can be selected and used on the device in a similar way as NVs. There is a notable difference to NVs: CPs are part of files on the remote nodes. Reading and writing CPs on the L-Gate results in a file transfer. The L-Gate supports both, the L file transfer and the simpler direct memory read/write method.
  • Page 102 L-Gate User Manual LOYTEC 2. Press the Upload button on the Configuration tab of the device properties (see Figure 89). Figure 89: Configuration Tab for Configuration Properties in NL220. To Synchronize CPs in LonMaker TE 1. Right-click on a device object and select Commissioning Resync CPs…...

  • Page 103: Install Unconfigured Devices

    L-Gate User Manual LOYTEC 6.8.2 Install Unconfigured Devices CEA-709 devices must be installed by a network management tool (e.g., LNS-based tool) to be available for communication. To install a device, its domain information must be written and the device must be set configured, online. If no network management tool is available, the CEA-709 network scan can be used to install a small number of unconfigured devices.

  • Page 104: Working With Unvts, Ucpts

    L-Gate User Manual LOYTEC 2. Right-click and choose Create Feedback-Point from the context menu. 3. A new input data point is created, having ‘_fb’ appended to the original name, e.g., ‘nvoHumid101_fb’. Note, that the feedback data point maps to the same NV index as the original output data point.

  • Page 105: Create Connections From A Csv File

    L-Gate User Manual LOYTEC 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 so. 2. Click on Select Hub… to select the hub point. This opens a list of all available data points.

  • Page 106: Modify Connections

    L-Gate User Manual LOYTEC 4. Select the menu Tools Import Connections … 5. If connections that are not part of the connection CSV file shall be deleted, click Yes when prompted. Click No if the other connections shall be left as is.

  • Page 107: Bacnet Configuration

    6.10 BACnet Configuration 6.10.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 108: Import From Ede File

    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 L-Gate shall access. When executing the Use on device the configuration software allocates client mappings on the device.

  • Page 109: Edit A Client Mapping

    L-Gate User Manual LOYTEC 4. This creates data points in the BACnet Port/Datapoints folder. All data points in that folder will be created as client mappings. No server object is created automatically in this case. 5. To also create server objects select the data points in question using the multi-select feature.

  • Page 110: Map Other Properties Than Present_Value

    L-Gate User Manual LOYTEC To Create Server Objects Manually 1. Select the BACnet Port/Datapoints folder 2. Right-click in the data point list and select New Datapoint… in the context menu. This opens the Create New BACnet Point dialog as shown in Figure 98.

  • Page 111: Enable International Character Support

    L-Gate User Manual LOYTEC Figure 99: Dialog for adding/removing BACnet properties. 3. Check the additional properties. Checking the Read box will add an input data point, checking the Write box will add an output data point. 4. Click Close. The selected data point can now be expanded with the plus icon and show its additional properties as sub-data points.

  • Page 112: E-Mail Templates

    L-Gate User Manual LOYTEC Figure 100: BACnet Project settings dialog. 6.11 E-Mail Templates 6.11.1 Create an E-Mail Template E-Mail templates are used to assemble and transmit E-Mails when certain trigger conditions occur. The E-Mail template contains the destination E-Mail address, the subject, and text.

  • Page 113: Trigger E-Mails

    L-Gate User Manual LOYTEC Figure 101: Configure E-Mail Template Dialog. 4. Enter text in the E-Mail Text multi-line field. 5. 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 114: Attachments

    L-Gate 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 115: Limit E-Mail Send Rate

    L-Gate User Manual LOYTEC 3. Change to the Attachments tab. Note: Of course, you can also change directly to the Attachments tab when creating an E-Mail template. 4. Select an available file from the Attach File drop-down box. 5. Click the Add button. The file appears in the Attachments list.

  • Page 116: Create Calendar Pattern

    L-Gate User Manual LOYTEC Figure 102: Create New Calendar dialog box. 4. Click Ok. 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 cleandar pattern represents a class of days such as “Holidays”.

  • Page 117: Configure Scheduled Data Points

    L-Gate User Manual LOYTEC 4. Click Create Schedule. The new schedule appears in the data point list of the Scheduler sub-folder. 6.12.4 Configure Scheduled Data Points When a local scheduler has been created, it needs to be configured, which data points it shall schedule.

  • Page 118: Configure Daily Schedules

    L-Gate User Manual LOYTEC 7. 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 119 L-Gate User Manual LOYTEC 3. Select a value preset in the Available Data Presets box on the upper right-hand side. 4. Drag and drop the preset from this list into the time table area to define the desired output values on the day schedule.

  • Page 120: Configure Exception Days

    L-Gate User Manual LOYTEC 2. Edit the daily schedule. 3. 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 121: Configure Embedded Exceptions

    L-Gate User Manual LOYTEC Figure 103: Configure Calendar Pattern Dialog. 6. Click Save Changes when all exception days have been entered. Tip! When 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 122: Configure Control Data Points

    L-Gate User Manual LOYTEC 3. The Create Pattern dialog opens. You can enter exactly one pattern entry for the embedded exception. It is recommended to choose a descriptive name for the day, e.g. ‘24_12’xx’ for every 24 of December. 4. Click Create Pattern. The embedded exception is now available.

  • Page 123: Using The Local Scheduler

    L-Gate User Manual LOYTEC To Use a SNVT_tod_event 1. Create a SNVT_tod_event in the data point configuration. 2. Add the SNVT_tod_event to the scheduled data points of a scheduler as described in Section 6.12.4. 3. All three parts of the SNVT_tod_event are scheduled.

  • Page 124: Create An Alarm Condition

    L-Gate User Manual LOYTEC 5. 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. These are the standard BACnet settings in a Notification Class object.
  • Page 125 L-Gate User Manual LOYTEC data point is used. Enter a Time Delay, after which the condition is evaluated. Select the Alarm Value which triggers the alarm. Figure 106: Alarm Condition for a Binary Data Point. 5. For a multi-state data point the dialog as shown in Figure 107 appears. Select the Alarm Server.

  • Page 126: Deliver Alarms Via E-Mail

    L-Gate User Manual LOYTEC 6.13.3 Deliver Alarms via E-Mail Updates in the alarm summary of an alarm object can be used as a trigger to send e-mail. 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.11).

  • Page 127: Local Trending

    L-Gate User Manual LOYTEC 2. In the data point list right-click and select New Alarm Log … from the context menu. 3. In the Create New Alarm Log dialog enter a Name for the alarm log. Optionally enter a Description.

  • Page 128: Configure Trended Data Points

    L-Gate User Manual LOYTEC Figure 108: Basic Trend Object Configuration. 4. Select the desired Trend Mode. 5. 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 129: Trend Triggers

    L-Gate User Manual LOYTEC 3. Add data points to be trended. Click on Add … which opens a data point selector window. 4. Select the data points and click OK. For each of the attached data points, a line appears in the list below the add button.

  • Page 130: Download Trend Data In Csv Format

    0 Bytes. The decimal point and CSV column separator can be configured over in the system configuration of the Web UI (see Section 4.2.1) of the L-Gate. Note, that for a comma “,” as the separator, the decimal point is a point. This is useful for English/U.S.

  • Page 131: Remote Ast Objects

    L-Gate User Manual LOYTEC in the trend object can be used as a trigger to send an e-mail with the trend’s data logger CSV file as an attachment. 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.11).

  • Page 132: Alarm Clients

    L-Gate User Manual LOYTEC remote scheduler and the corresponding calendar objects in the Remote Devices folder. 3. 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.

  • Page 133: Math Objects

    L-Gate User Manual LOYTEC 2. From the points in the import folder, select the alarm server points you are interested in and click the Use on Device speed button. This creates the corresponding alarm client points in your project. 3. For CEA709, select the new alarm client point and adjust the name of the local NV (default name is nviAlarm_2).

  • Page 134: Editing A Math Object

    L-Gate User Manual LOYTEC 4. Attach input data points by clicking the Add Input DP button. 5. In the data point selector dialog, select the input data points and click OK. The data points appear as v1, v2, etc. 6. If the data point shall trigger the math calculation only after a certain change-of-value, enter a value into the COV delta column.

  • Page 135: Mapping Cea-709 And Bacnet Schedules

    L-Gate User Manual LOYTEC 2. Select the math object in the data point list. 3. Right-click and select Configure Math Object … from the context menu. 4. Edit the math object as described in Section 6.16.1. 5. To replace an input data point by another input data point without re-writing the entire formula, click the Replace Input DP …...

  • Page 136: Map From Cea-709 To Bacnet

    This section describes how to expose a CEA-709 scheduler and calendar to a BACnet operator workstation (OWS). It is assumed that the CEA-709 scheduler is either a local or a remote scheduler on the L-Gate and schedules only one value. That CEA-709 scheduler must be the hub.

  • Page 137: Map From Bacnet To Cea-709

    L-Gate User Manual LOYTEC 8. Create a second new connection. Give it a descriptive name, e.g., cal_conn. Important: If there already exists a calendar connection, don’t create a new connection and add the exposed calendar as a target to the existing connection! There can only be one calendar connection that contains all exposed calendars.

  • Page 138: Create One-Way Mappings

    L-Gate User Manual LOYTEC Important: If there already exists a calendar connection, don’t create a new connection and add the exposed calendar as a target to the existing connection! There can only be one calendar connection that contains all exposed calendars.

  • Page 139: 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 140 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 141: Alarm Log Csv File

    L-Gate User Manual LOYTEC 7.1.3 Alarm Log CSV File The historical alarm logs are also accessible as CSV-formatted files. The alarm log CSV files are accessible either via their UID only, or in combination with contents of the alarm log object name. The files are located in /tmp/uid/allog/UID.csv...

  • Page 142: Node Object

    Define, how this NV shall be allocated: external=1 (default) /static=2/file=3 Table 9: CSV Columns of the NV Import File 7.2.2 Node Object The L-Gate provides a node object conforming to the L guidelines. A diagram of the node object is depicted in Figure 112. Version 3.2...

  • Page 143: Extended Node Object Interface

    (SNVT_alarm_2). This allows devices supporting the L alarm notifier profile to receive alarms generated by the L-Gate 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 144: Real-Time Keeper Object

    (SNVT_earth_pos): This configuration property can be used to set the earth position of the L-Gate. It has been implemented as an NV to make other devices send that configuration to the L-Gate over the network (e.g., from a GPS device).
  • Page 145 “Instance” part is 17800. 7.3.1.2 Object_Name (Read-Only) The value of this property is configurable via the configuration UI (see Section 4.2.7). The default value is “L-Gate”. Note that this name must be unique in the BACnet internetwork. 7.3.1.3 Object_Type (Read-Only) The value of this property is DEVICE (8).
  • Page 146 LOYTEC 7.3.1.4 System_Status (Read-Only) The value of this property is always OPERATIONAL. 7.3.1.5 Vendor_Name (Read-Only) The value of this property is “LOYTEC electronics GmbH”. 7.3.1.6 Vendor_Identifier (Read-Only) The value of this property is 178. 7.3.1.7 Model_Name (Read-Only) The value of this property is equal to the product code of the device (“LGATE-900”).

  • Page 147: Client Mapping Csv File

    L-Gate User Manual LOYTEC 7.3.1.19 Max_Segments_Accepted (Read-Only) The value of this property is 16. 7.3.1.20 APDU_Segment_Timeout (Read-Only) The value of this property is 2000 milliseconds. 7.3.1.21 APDU_Timeout (Read-Only) The value of this property is 3000 milliseconds. 7.3.1.22 Number_Of_APDU_Retries (Read-Only) The value of this property is 3.

  • Page 148: Ede Export Of Bacnet Objects

    LOYTEC The CSV file must be named “bacclnt.csv” and stored in the directory “/var/lib/bacnet” on the L-Gate. The file is read when the device boots. If any errors occur they are reported in “/tmp/bacclnt.err”. The column format is shown in Table 11. Lines beginning with a hash (‘#’) sign are comment lines.

  • Page 149: Network Media

    The L-Gate FT port is fully compatible to the parameters specified by L for this channel. FT ports can also be used on Link Power (LP-10) channels. However, the L-Gate does not provide the power supply for Link Power channels.

  • Page 150: Gate Firmware Update

    LOYTEC 9 L-Gate Firmware Update The L-Gate firmware supports remote upgrade over the network and the serial console. To guarantee that the L-Gate is not destroyed due to a failed firmware update, the L-Gate firmware consists of two images: •...
  • Page 151 L-Gate User Manual LOYTEC Figure 115: FTP connection dialog. 3. In the FTP connection dialog enter the IP address of the device to upgrade and the FTP user name and password. The default user name and password are ‘admin’ and ‘admin’.

  • Page 152: Firmware Update Via The Console

    Figure 118: LSU Serial Upgrade Tool in Idle Mode 2. If the L-Gate is not connected to COM1 you can change the port to COM2, COM3, or COM4. Make sure that the product shown under “Product” matches the device you are upgrading.
  • Page 153 L-Gate User Manual LOYTEC Figure 120: Successful Firmware Upgrade 4. Double check that the new firmware is executed by selecting ‘1’ and pressing Enter in the console window. This will bring up the device information which shows the current firmware version.

  • Page 154: Troubleshooting

    L-Gate User Manual LOYTEC 10 Troubleshooting 10.1 Technical Support LOYTEC offers free telephone and e-mail support for our L-Gate product series. If none of the above descriptions solves your specific problem please contact us at the following address: LOYTEC electronics GmbH...

  • Page 155: Reset Configuration (Factory Defaults)

    L-Gate User Manual LOYTEC Device Main Menu ================ Show device information Serial firmware upgrade System configuration CEA-709 configuration IP configuration CEA-852 device configuration BACnet configuration Reset configuration (factory defaults) Device statistics Data Points Reset device Please choose: Figure 121: Console Main Menu.
  • Page 156 L-Gate User Manual LOYTEC *********** 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 Flags: Up Broadcast Running Simplex Multicast Send queue limit:50 length:0 Dropped:0 Network Driver Stats for CS8900 :...

  • Page 157: Application Notes

    11.1 The LSD Tool Please refer to application note “AN002E LSD Tool” for further information about the LOYTEC system diagnostics tool for the L-Gate. 11.2 Use of Static, Dynamic, and External NVs on a Device 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.

  • Page 158: Firmware Versions

    L-Gate User Manual LOYTEC 12 Firmware Versions Table 12 shows the most important features available only in certain firmware versions. Firmware Version/ Features CEA-709/BACnet gateway √ √ √ √ √ √ BACnet Network Scan √ √ √ √ √ CEA-709 Network Scan √...

  • Page 159: Specifications

    L-Gate User Manual LOYTEC 13 Specifications 13.1 LGATE-900 13.1.1 Physical Specifications Operating Voltage 12-35 VDC or 12-24 VAC ±10% Power Consumption typ. 3 W In rush current up to 950 mA @ 24 VAC Operating Temperature (ambient) 0°C to + 50°C Storage Temperature 10°C to +85°C...
  • Page 160 L-Gate User Manual LOYTEC BACnet objects (analog, binary, multi-state) BACnet client mappings BACnet calendar objects BACnet scheduler objects 100 (64 data points per object) BACnet notification class objects BACnet trend log objects 100 (total aggregated size of 130000 log records or roughly 2MB.
  • Page 161 Major revision to cover L-Gate and L-Gate Configurator version 3.1. 2010-10-11 Updated for L-Gate 3.2.0 release. Removed Section on Console UI and added console statistics as Section 10.2. Added Section 4.2.3 port configuration Web UI. Section 6.3 project settings: added new ASTv2 setting.

Table of Contents