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

LOYTEC L-Proxy User Manual

Cea-709 gateway
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
L-Proxy
CEA-709 Gateway
User Manual
LOYTEC electronics GmbH

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for LOYTEC L-Proxy

Summary of Contents for LOYTEC L-Proxy

  • Page 1 L-Proxy CEA-709 Gateway User Manual LOYTEC electronics GmbH...
  • Page 2 No part of this publication may be reproduced, stored in a retrieval system, or transmitted, any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of LOYTEC. LC3020™, L-Chip™, L-Core™, L-Dali™, L-Gate™, L-INX™, L-IP™, LPA™, L-Proxy™, L-Switch™, L-Term™, L-Vis™ and L-Web™ are trademarks of LOYTEC electronics GmbH.

  • Page 3: Table Of Contents

    Wiring ........................21 4 Console Interface ..................22 Console Connection...................22 Self Test......................22 L-Proxy Device Main Menu ................23 4.3.1 Option 1 – Show device information ............23 4.3.2 Option 2 – Serial firmware upgrade............24 4.3.3 Option 3 – System configuration .............24 4.3.4 Option 4 – CEA-709 configuration ............24 4.3.5 Option 5 –...
  • Page 4 L-Proxy User Manual LOYTEC 4.3.8 Option 9 – Device statistics..............24 4.3.9 Option 0 – Reset Device................25 4.3.10 Option a – Data Points ................25 System Configuration Menu................25 4.4.1 Option 1 – Configure Date/Time............. 25 4.4.2 Option 2 – Configure Earth Position............26 4.4.3 Option 7 –...
  • Page 5 6.1.3 Update-Poll Use Case ................53 6.1.4 Poll-Update Use Case (Active Poll) ............53 6.1.5 Use Case Combinations ................54 6.1.6 Poll Cache ....................55 6.1.7 SNVT Conversion ...................56 Network Interfaces on the L-Proxy ..............57 Data Points......................58 6.3.1 Overview....................58 6.3.2 Timing Parameters ...................59 6.3.3 Default Values ..................59 6.3.4 Persistency ....................59...
  • Page 6 Dynamic Network Variables................88 7.7.1 Creating a Dynamic Network Variable ........... 89 Replace an L-Proxy ..................94 Using the L-Proxy Configurator ..............100 7.9.1 Starting as an LNS Plug-In..............100 7.9.2 Starting Stand-Alone ................100 7.9.3 Uploading the Configuration..............101 7.9.4 Scanning for Network Variables ............
  • Page 7 9.1.2 Node Object ...................135 9.1.3 Gateway Objects ..................136 10 Network Media ..................137 10.1 FT ........................137 11 L-Proxy Firmware Update ..............138 11.1 Firmware Update via the L-Proxy Configurator .........138 11.2 Firmware Update via the Console ..............140 Version 3.1 LOYTEC electronics GmbH...
  • Page 8 LonMaker Warning appears during installation ........142 12.3 NL220 Warning appears during installation ..........143 12.4 Move L-Proxy into a new LNS project ............143 12.5 Node does not respond to poll request ............144 12.6 L-Proxy doesn’t forward packets after commissioning ......144 12.7...
  • Page 9 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 NAT ........Network Address Translation, see Internet RFC 1631 NV........Network Variable...

  • Page 11: Introduction

    The basic operation of L-Proxy is to take an input network variable (NV) or configuration property (CP) on one side, interpret the data in the variable and transmit a corresponding output network variable on the other side.

  • Page 12: Scope

    Configurator 3.1 and higher. See Section 14 for differences between the different L-Proxy firmware versions. For L-Proxy devices with firmware versions before 3.0 please refer to L-Proxy User Manual version 2.2 [2]. Also note, that firmware and configuration files of L-Proxy 3.0 and higher are not compatible with 2.2.

  • Page 13: Quick-Start Guide

    L-Proxy User Manual LOYTEC 2 Quick-Start Guide This Chapter shows step-by-step instructions on how to configure the L-Proxy for a simple network architecture, mapping CEA-709 network variables from different ports of the L-Proxy. 2.1 Hardware Installation Connect power (12-35 VDC or 12-24 VAC), the CEA-709 network, and the Ethernet cable as shown in Figure 1.
  • Page 14 Open another LNS database and add an L-Proxy device for Port 2 (FT) using the device template, which has been created for the L-Proxy (e.g., L-Proxy_V3_0_FT-10.xif). Then create dynamic NVs on that L-Proxy port, which are opposite to the NVs on port 1, e.g., “nvoTemp” and “nviSwitch”.
  • Page 15 L-Proxy User Manual LOYTEC Figure 3: Example result of synced dynamic NVs. 6. Click the magic wand button Auto-create connections for auto-connecting the NVs. This creates internal connections for the NVs with the same base name. The prefix “nvi” and “nvo” are ignored. Therefore, two connections are created in our example, one named “nviTemp”, and one named “nviSwitch”.
  • Page 16 10. Click OK when the download is finished and close the download dialog. It is recommended to save the L-Proxy project to a disk file. 11. Select File Save As … and enter a suitable file name in the file requestor. The project file is stored as an ‘.lprxy’...

  • Page 17: Hardware Installation

    LOYTEC 3 Hardware Installation 3.1 Enclosure 3.1.1 LP-33E100 The L-Proxy enclosure is 6 TE (1 TE = 17.5 mm) wide for DIN rail mounting, following DIN 43 880 (see Figure 6). Ethernet DIP Switch 1 2 3 4 5 6 7...

  • Page 18: Product Label

    The L-Proxy power LED lights up green when power is supplied to terminals 16 and 17. 3.4.2 Status LED The L-Proxy is equipped with a red status LED (see Figure 6). This LED is normally off. During boot-up the status LED is used to signal error conditions (red). If the fall-back image is executed the status LED flashes red once every second.

  • Page 19: Ft Activity Led

    L-Proxy User Manual LOYTEC 3.4.3 FT Activity LED The FT port on the L-Proxy has a three-color LED (green, red, and orange, see Figure 6). Table 1 shows different LED patterns of the port and their meaning. Behavior Description Comment...

  • Page 20: Config Led

    This LED is green, if the L-Proxy is running with a valid proxy configuration. 3.4.8 Wink Action If the L-Proxy 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 21: Wiring

    (see Section 10.1). Important: When using shielded network cables, only one side of the cable should be connected to earth ground. Thus, the shield must be connected to earth ground either at the L-Proxy terminals or somewhere else in the network. Important:...

  • Page 22: Console Interface

    To use the serial interface, the console connector (see Figure 6) of the L-Proxy can be connected to the RS-232 port of a PC. The PC can communicate with the L-Proxy using a standard terminal program with communication settings of 38,400 bps / 8 data bits / no parity / 1 stop bit.

  • Page 23: L-Proxy Device Main Menu

    Fri Jan 23 17:18:47 2009 - V3.1.0 Figure 9: Console messages during the boot phase. 4.3 L-Proxy Device Main Menu After booting has completed, the L-Proxy displays the console menu as shown in Figure Device Main Menu ================ Show device information...

  • Page 24: Option 2 - Serial Firmware Upgrade

    4.3.7 Option 8 – Reset configuration (factory defaults) This menu item resets the L-Proxy to factory defaults. See Section 3.5 for details on how to load factory defaults by pressing the status button and Section 4.8 on how to load factory defaults through the console menu.

  • Page 25: Option 0 - Reset Device

    4.3.10 Option a – Data Points This menu option takes the user to the data point menu. In this menu, the configured data points in the L-Proxy can be viewed and set. See Section 4.10 for details. 4.4 System Configuration Menu The system configuration menu holds various system configuration settings.

  • Page 26: Option 2 - Configure Earth Position

    These menu items allow enabling and disabling the Web server and configuring the Web server port on the L-Proxy. You can disable the Web server if you do not want to provide access to the L-Proxy configuration via the Web interface. Press ‘9’ to toggle between enabled and disabled.

  • Page 27: Ip Configuration Menu

    L-Proxy User Manual LOYTEC 4.6 IP Configuration Menu The IP configuration menu holds relevant IP settings. Here are some general guidelines for setting IP addresses, port numbers, and time values: • Enter ‘0.0.0.0’ to clear an IP address. • Enter ‘0’ to select the default port number.

  • Page 28: Option 2 - Ip Address, 3 - Ip Netmask, 4 - Ip Gateway

    DHCP to acquire an IP address. 4.6.3 Option 7 – DNS Servers You can configure up to 3 Domain Name Servers. On the L-Proxy these settings are not required and purely optional.

  • Page 29: Device Configuration Menu

    4.7.2 Option 4 – Config client port If only one L-Proxy is used in an IP-852 channel behind a NAT router, this field should be left at the default setting (1628). If changed, it must not be the same as the configuration server port.

  • Page 30: Channel Mode

    4.7.11 Option a – NAT Address If the CEA-852 device on the L-Proxy is used behind a NAT router, the public IP address of the NAT router or firewall must be known. This address can either be entered manually or can be determined automatically.

  • Page 31: Option B - Multicast Address

    4.7.12 Option b – Multicast Address This menu option allows the user to add the CEA-852 device of the L-Proxy into a multi- cast group for the CEA-852 IP channel. Enter the channel’s IP multi-cast address here. Please contact your system administrator on how to obtain a valid multi-cast address. Refer to the L-IP User Manual [1] to learn when it is beneficial to use multi-cast addresses in your channel.

  • Page 32: Device Statistics Menu

    LOYTEC 4.9 Device Statistics Menu This menu holds relevant information regarding the device statistics of the L-Proxy. The device statistics menu is shown in Figure 21. Use this menu only for debugging purposes. There is no need to access this menu if the network is running smoothly.

  • Page 33: Option 2 - Cea-709 Application Statistics

    L-Proxy User Manual LOYTEC Extended CEA-852 Device Statistics ================================== Session ID : 0x4dce9e98 SNTP synchronized : no Number of CR member infos Current channel routing mode : CR Message alloc count Dropped failed authentication Dropped invalid frame Dropped out-of-sequence Dropped duplicates...

  • Page 34: Option 4 - Ip Statistics

    L-Proxy User Manual LOYTEC CEA-709 application statistics ============================== Device : CEA-709 (FT) Node state : unconfigured (0x02) Transmission errors Transmit TX failures Receive TX full Lost messages Missed messages Layer 2 received Layer 3 received Layer 3 transmitted Transmit TX retries...
  • Page 35 Figure 25: IP Statistics The IP statistics menu has the additional feature of displaying any IP address conflicts. If the L-Proxy’s IP address conflicts with another host on the network, the banner shown in Figure 26 is displayed. WARNING: Conflicting IP address detected! IP address 10.125.123.95 also used by device with MAC address...

  • Page 36: Option 6 - Enhanced Communications Test

    4.10 Data Point Menu The L-Proxy data point menu as shown in Figure 28 allows the user to list data points, get, and set values of the data points. Note that the Console data point UI is kept very simple.

  • Page 37: Option 1 - List Data Points

    Figure 28: L-Proxy Data Point Menu. 4.10.1 Option 1 – List Data Points Select this option to list all data points on the L-Proxy. The list is flat and displays the values and status of each data point. An example is shown in Figure 29.

  • Page 38: Web Interface

    L-Proxy User Manual LOYTEC 5 Web Interface The L-Proxy comes with a built-in Web server and a Web interface to configure the L- Proxy and extract statistics information. The Web interface allows configuring the IP settings, CEA-852 and CEA-709 settings.
  • Page 39 It includes the unique node IDs (“Neuron IDs”) of the CEA-709 network interfaces. This page can also be used to send the CEA-709 service pin messages. This is a useful feature when commissioning the L-Proxy, since it is not necessary to be on-site to press the device’s status button.

  • Page 40: Device Configuration

    L-Proxy User Manual LOYTEC information such as calendar data. (3) admin has full access to the L-Proxy 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 41: Ip Configuration

    LOYTEC Figure 33: System Configuration Page, e.g., for Vienna, Austria The next section on the page allows configuring the L-Proxy’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. The altitude is entered in meters height above sea level.
  • Page 42 Figure 34: IP Configuration Page with DHCP disabled Figure 35: IP Configuration Page with DHCP enabled The L-Proxy comes configured with a unique MAC address. This address can be changed in order to clone the MAC address of another device. Please contact your system administrator to avoid MAC address conflicts.

  • Page 43: Backup And Restore

    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-Proxy will use NTP as a time source if the time sync source in the system configuration page is set to NTP (see Section 5.2.1).

  • Page 44: Device Configuration

    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-Proxy, which will appear in the IP channel to identify this device. You can enter a device name with up to 15 characters.

  • Page 45: Data Points

    This is optional and for informational purposes only. If the CEA-852 device on the L-Proxy 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 46 L-Proxy User Manual LOYTEC Figure 39: Data point page 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 47: Device Statistics

    • 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. 5.3 Device Statistics The device statistics pages provide advanced statistics information about the CEA-709 device, the CEA-852 device, the System Log, and the Ethernet interface.

  • Page 48: Statistics

    L-Proxy User Manual LOYTEC Figure 41: IP Statistics Page 5.3.2 CEA-852 Statistics The CEA-852 statistics page displays the statistics data of the CEA-852 device on the L- Proxy. It is only displayed if the CEA-852 interface is enabled. The contents are the same as available through the console UI (see Section 4.9.1).

  • Page 49: Enhanced Communications Test

    5.3.3 Enhanced Communications Test The Enhanced Communications Test allows testing the CEA-852 communication path between the CEA-852 device on the L-Proxy 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 50: Statistics

    The Round Trip Time (RTT) is measured as the time a packet sent to the peer device needs to be routed back to the L-Proxy. 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 51: Reset, Contact, Logout

    L-Proxy User Manual LOYTEC log entries for reboots and abnormal operating conditions. When contacting LOYTEC support, have a copy of this log ready. Figure 45: System Log Page 5.4 Reset, Contact, Logout The menu item Reset allows two essential operations: •...

  • Page 52: Concepts

    3. A writing by which one person authorizes another to vote in his stead, as in a corporation meeting. The L-Proxy follows this definition. It acts on behalf of somebody else. For L-Proxy the “somebody else” is another node in the network. As shown in Figure 46 the L-Proxy hardware offers 3 physical network ports, two FT and one IP-852, which represent 5 individual nodes, one on each FT port and three on the IP-852 port.

  • Page 53: Update-Update Use Case

    Figure 47 shows an Update-Update use case. In this use case the input network variable of the L-Proxy is bound to an output network variable of Node 1. This output network variable is periodically updated. On the output side of L-Proxy the corresponding output network variable is also bound to an input network variable on Node 2, which is waiting for updates.

  • Page 54: Use Case Combinations

    L-Proxy an output NV is bound to the input NV of L-Proxy. Updates are received periodically. On the output side of L-Proxy an input network variable on Node 2 is bound to the output NV on L-Proxy (Update-Update use case). Further, an OPC server polls the same output NV periodically (Update-Poll use case).

  • Page 55: Poll Cache

    (no polls) from Node 1. Only after power-up of L-Proxy, when the cache entry is not valid, L-Proxy will try to poll Node 1 until a valid value is received and stored in the cache. This behavior can be achieved by setting “maximum cache age” to ‘-1’ and setting the “poll on startup”...

  • Page 56: Snvt Conversion

    Forward polls: The poll request from Node 2 is interleaved with the active polls from L-Proxy in order to update the cache value right away. The poll response is sent to Node 2 after the poll response has been received from Node 1. This mode is configured by setting the “maximum cache age”...

  • Page 57: Network Interfaces On The L-Proxy

    6.2 Network Interfaces on the L-Proxy The L-Proxy as a physical device has 5 network ports. Port 1 and port 2 are FT-10 ports, port 3 through 5 are IP-852 ports. The FT-10 ports are physically available on terminals 1 through 6 (see Section 3.7) and can be connected to two separate FT-10 channels.

  • Page 58: Data Points

    L-Proxy User Manual LOYTEC Figure 56: Connecting the IP-852 ports to other channels using L-IPs. 6.3 Data Points 6.3.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 59: Timing Parameters

    L-Proxy User Manual LOYTEC • Multi-state: A multi-state data point represents a discrete set of states. The associated data type is a signed integer machine variable. Each state is identified by an integer value, the state ID. State IDs need not be consecutive. Meta-data of a multi-state data point includes human-readable descriptions for the individual states (state texts) and the number of available states.

  • Page 60: Behavior On Value Changes

    L-Proxy User Manual LOYTEC For input data points, the value can be actively polled from the network when starting up. Use the Poll-on-Startup feature for this behavior. Polling the network values has the advantage that intermediate changes on the network are reflected. An input data point can be made persistent, if the last received value shall be available after a power-on reset before a poll-on-startup completes.

  • Page 61: Connections

    (SCPTs) and user-defined CP types (UCPTs) are supported. The typical procedure in configuring the L-Proxy consists of the following steps: 1. Select the data points of the network to be used on the L-Proxy (e.g., select the NVs in the CEA-709 network nodes) 2.

  • Page 62: Static Interface Changes

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

  • Page 63: Connections

    With regard to the CEA-709 networking technology, it shall be noted that a connection is an internal mapping in the L-Proxy between input and output network variables. A connection always consists of one hub network variable and one or multiple target network variables.

  • Page 64: The L-Proxy Configurator

    We show the configuration steps using LonMaker TE but other LNS-based network management tools can be used as well to install and configure the L-Proxy. We also show how to configure the L-Proxy without LNS.
  • Page 65 Figure 57: 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-Proxy are added automatically and XIF files are copied into the LNS import directory.

  • Page 66: Operating Modes

    L-Proxy User Manual LOYTEC 7.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 67: Folder List

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

  • Page 68: Data Point List

    L-Proxy User Manual LOYTEC 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. Note, that the folder structure described above cannot be changed by adding or deleting folders at that level.
  • Page 69 L-Proxy User Manual LOYTEC • Only notify on COV: This property assists for binary and multi-state input data points. It defines, if a data point shall trigger an update only when the value changes or on every write. If this is enabled, consecutive writes with the same value do not trigger an update.

  • Page 70: Properties

    L-Proxy User Manual LOYTEC 7.2.4 CEA-709 Properties Apart from the common data point properties discussed in Section 7.2.3 the data points of the CEA-709 technology have additional properties. Depending on if a NV is local or external (remote), the properties may vary, •...

  • Page 71: Project Settings

    L-Proxy User Manual LOYTEC 7.3 Project Settings The project settings allow defining certain default behavior and default settings used throughout the project. To access the project settings go to the menu Settings Project Settings…. This opens the project settings dialog, which provides several tabs as described in the following sections.

  • Page 72: Settings

    • L-Proxy Operating Mode: The L-Proxy Configurator can be operated in one of two modes: Simple and advanced mode. In simple mode, the user can only use dynamic NVs created manually in LNS and create connections. The LNS database is never modified in this mode.

  • Page 73: Workflows For The L-Proxy

    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-Proxy on- line. There exists a standard XIF file for the FT port (L-Proxy_V3_0_FT-10.xif) and one for the IP-852 port (L-Proxy_V3_0_IP-10L.xif).
  • Page 74 L-Proxy User Manual LOYTEC First, a device of an L-Proxy port must be added to the LNS database (see Section 7.5). Then one or more functional blocks must be created (see Section 7.6). In those functional blocks the input and output network variables must be created dynamically (see Section 7.7).

  • Page 75: Configure With Lns And Static Nvs

    Figure 63: Basic design-flow with LNS and dynamic NVs. 7.4.3 Configure with LNS and Static NVs Configuration of the L-Proxy with static NVs in LNS can be beneficial if a basic configuration shall be pre-configured as a static interface. Later additions to the network variables can be done with dynamic NVs at run-time.
  • Page 76 L-Proxy port must be exported as a XIF file (see Section 7.9.13). Now an L-Proxy device can be added from this XIF file in the LNS database (see Section 7.5). Then one or more functional blocks must be created, which contain the static NVs (see Section 7.6).

  • Page 77: Configure Without Lns Using Static Nvs

    Then also export the static NV interface as a XIF file (see Section 7.9.13). The XIF file has to be used in the non-LNS tool to create a device for the L-Proxy. Using that device, the integrator can create the bindings in that tool. Please refer to the documentation of the network management tool on how to create devices from a XIF file and bind network variables.

  • Page 78: Change An Existing Configuration With Lns

    Tool supports ECS ? Enable Legacy NM Mode Section 7.9.14 Export the port interface as XIF Section 7.9.13 Add L-Proxy Port x from XIF in non-LNS tool and create bindings L-Proxy Ports left to configure? Upload/import port definitions Section 7.9.12 Make L-Proxy internal connections Section 7.11...

  • Page 79: Change An Existing Configuration Without Lns

    At the end of all changes one engineer is designated to modify the internal connections in the L-Proxy to adapt to the updated NV interface. This engineer starts the Configurator as a plug-in on his designated download port (see Section 7.9.1) and uploads the current configuration (see Section 7.9.3).

  • Page 80: Replace An L-Proxy

    (see Section 7.9.11). 7.4.7 Replace an L-Proxy An L-Proxy can be replaced in the network by another unit. This might be necessary, if a hardware defect occurs. First of all, the replacement L-Proxy needs to be configured with the appropriate IP settings, including all relevant CEA-852 device settings. The remainder of this section focuses on the L-Proxy port interface configuration and internal connection configuration.

  • Page 81: Adding L-Proxy

    L-Proxy (see Section 5.4). 7.5 Adding L-Proxy This Section shows the basic steps that need to be followed in order to add the L-Proxy in a network management tool. Before you continue please make sure that you have installed the LOYTEC L-Proxy Configurator software as explained in Section 7.1.
  • Page 82 4. Check the option Create node from a device template. 5. Select the proper device template for the L-Proxy Port. An FT port (Port 1, 2) uses the “L-Proxy_V3_0_FT-10” template and the IP-852 port (Port 3, 4, 5) the “L- Proxy_V3_0_IP-10L”...
  • Page 83 Figure 71: Create a new device in the drawing. 2. Select Commission Device if the L-Proxy is already connected to the network. 3. In the Device Template group box select the existing device template of the L-Proxy. Select “L-Proxy_V3_0_FT-10”, if the L-Proxy is configured to use the FT-10 interface, or “L-Proxy_V3_0_IP-10L”, if the L-Proxy is configured to be on the IP...
  • Page 84 L-Proxy User Manual LOYTEC Figure 72: Leave defaults for Location. 6. Check Service Pin as the device identification method as shown in Figure 73 and click Next. Figure 73: Use Service Pin. 7. Click Next in the following screens until you get to the final dialog shown in Figure 8.
  • Page 85 Figure 75: The L-Proxy has been added to the drawing. To Add a Device in Alex 1. In the tree view, go to the subsystem to which the L-Proxy port should be added. 2. Select Geräte and choose Neues Gerät. The Dialog in Figure 69 is shown.

  • Page 86: Creating Functional Blocks/Virtual Interfaces

    NVs are going to be used. This section describes how to create the functional blocks in NL220, LonMaker TE, and Alex. It is assumed that the steps are executed after adding the L-Proxy has been added to the LNS database.
  • Page 87 Figure 77: Interfaces of the L-Proxy device in tree. 6. You can repeat the above steps to create up to 8 virtual interfaces on every L-Proxy port. The different virtual interfaces for one L-Proxy port are only for logical grouping of the NVs.

  • Page 88: Dynamic Network Variables

    Figure 79: Empty functional block for L-Proxy Port 2. 7. You can repeat the above steps to create up to 8 functional blocks on every L-Proxy port. The different functional blocks for one L-Proxy port are only for logical grouping in the LonMaker drawing.

  • Page 89: Creating A Dynamic Network Variable

    Figure 81: Simple network comprising 3 nodes and one L-Proxy Port. Let’s assume we want to connect network variable “nvoSwitch0” on Node 6 to L-Proxy. This means we need to create an input network variable in the gateway object with the same type as “nvoSwitch0”.
  • Page 90 8. As shown in Figure 84 the connection window in the work view (right view) includes now the nvoSwitch0 of Node 6 and the nviSwitch0 of the L-Proxy device. You can create or cancel the connection. Figure 84: Connection window with the newly created L-Proxy variable and the Node 6 output variable.
  • Page 91 L-Proxy User Manual LOYTEC To Create Dynamic NVs in LonMaker TE 1. Drag the Input Network Variable shape onto the gateway functional block. A new window appears (see Figure 85). Figure 85: Add an input network variable to the Proxy functional block.
  • Page 92 L-Proxy User Manual LOYTEC Figure 87: Select the counterpart NV on Node 6. 6. Click OK. 7. A new name is already suggested for this newly created network variable. In our case we keep the New NV Name of “nviSwitch0” as shown Figure 88.
  • Page 93 L-Proxy User Manual LOYTEC Figure 89: We have created a new input network variable in the Proxy functional block. 10. Click OK. 11. After the network drawing updates, it shows the newly created input network variable in the Proxy functional block.

  • Page 94: Replace An L-Proxy

    5. Repeat this for all network variables which will be used on the L-Proxy. 7.8 Replace an L-Proxy In the case of failure an L-Proxy might have to be replaced by another unit. Even if the configuration of the replacement unit is identical to the original one, the Node ID (NID) of the new unit is different.
  • Page 95 Figure 92: L-Proxy device in NL-220. 2. This opens the device replacement dialog box (see Figure 93). Figure 93: NL-220 node replacement dialog. 3. Press the service pin of the L-Proxy port to replace and press Continue to replace the device. Version 3.1...
  • Page 96 NVs again (if any) and installs the bindings. To Replace a Device in LonMaker TE 1. Select the device and right-click on the device shape as shown in Figure 94. Figure 94: LonMaker drawing with one L-Proxy. 2. Select Commissioning Replace…. This opens the LonMaker Replace Device Wizard as shown in Figure 95.
  • Page 97 L-Proxy User Manual LOYTEC Figure 96: Click Next without loading an application image. 5. Then select Online as shown in Figure 97 and click Next. Figure 97: Select online state. 6. Select the Service pin method and click on Finish as shown in Figure 98.
  • Page 98 LOYTEC Figure 98: Select Service Pin and click Finish. 7. Then the service pin requestor opens. Press the service pin on the replacement L-Proxy on the correct port. You can also send the service pin using the Web interface (see Section 5.1).
  • Page 99 Figure 99: L-Proxy device in Alex. 2. This opens the device replacement dialog box (see Figure 100). Figure 100: Device replacement dialog in Alex. 3. Press the service pin of the L-Proxy port to replace. 4. Click OK to replace the device. Version 3.1...

  • Page 100: Using The L-Proxy Configurator

    L-Proxy. This starts the L-Proxy Configurator and the main connections screen is displayed. If the L-Proxy is not yet connected to the network, go to the Firmware menu and select the firmware version of the L-Proxy to be configured. If the L-Proxy is already connected to the network it is recommended to connect the configuration software to the L-Proxy.

  • Page 101: Uploading The Configuration

    5. Click on Connect. This establishes the connection to the device. 7.9.3 Uploading the Configuration To get the current network variable configuration of the L-Proxy, the port interface needs to be uploaded. This will upload the entire configuration from the L-Proxy, including data points, dynamic NVs, and schedules.

  • Page 102: Scanning For Network Variables

    5. If dynamic NVs were synchronized, click on Finish. 7.9.4 Scanning for Network Variables When the L-Proxy Configurator is connected to an LNS database, network variables can be scanned from that data base. To scan network variables from the LNS database 1.

  • Page 103: 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 L-Proxy 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 9.1.1.

  • Page 104: Scanning Nvs Online From The Network

    All items can be selected by pressing <Ctrl-A>. 7.9.6 Scanning NVs Online From the Network L-Proxy 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 105 L-Proxy User Manual LOYTEC Figure 106: CEA-709 network scan dialog. 4. Click on the button Discover Devices. This starts a network scan. The results are put in the device list box. 5. Alternatively, click the button Discover on Service Pin. Then press the service pin of a particular device on the network.

  • Page 106: 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-Proxy/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-Proxy. Version 3.1...

  • Page 107: Create Static Nvs

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

  • Page 108: Create External Nvs

    NVs. Since external NVs do not affect the static NV interface of the L-Proxy, they can be used to extend an L- Proxy’s interface configuration at run-time, where no LNS with dynamic NVs is available.
  • Page 109 NV name, the NV type (SNVT) and direction. Note, that the direction is the direction of the external NV on the L-Proxy. Therefore, the remote output NV nvo00_switch becomes an input on the L-Proxy. Also enter the NV selector in hexadecimal and the NV index in decimal notation.

  • Page 110: Configuration Download

    After the data points have been configured, the configuration needs to be downloaded to the L-Proxy. For doing so, the L-Proxy must be online. If the L-Proxy is not yet connected to the network, the configuration can be saved to a project file on the local hard drive.
  • Page 111 L-Proxy User Manual LOYTEC 3. When connected via LNS, the connected port is indicated by the icon. On this port, the Configurator chooses an automatic model number to fit the LNS database and also upgrades the underlying device template. No further action is needed on that port.

  • Page 112: Exchange The Port Interface Definition

    Proxy (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-Proxy Configurator (e.g., use the menu “LonMaker|Refresh” in LonMaker or hit F5 in NL-220).

  • Page 113: Build Xif For Port Interface

    LOYTEC 7.9.13 Build XIF for Port Interface When using static NVs on the L-Proxy, the L-Proxy Configurator can export a new XIF file for the changed static interface. Before exporting the XIF for the interfaces it is recommended to download the configuration into the device. In this case, the Configurator can verify that the model number of the port is correct.

  • Page 114: Upload Dynamic Nvs From Device

    To Repair the LNS Database from the Device 1. Start the L-Proxy Configurator as LNS plug-in on the device to repair (see Section 7.9.1). 2. The Configurator will detect that the current static interface of the device’s port is out- of-sync with the database and ask to repair.

  • Page 115: Deleting Connected Data Points

    L-Proxy User Manual LOYTEC 3. Click Yes. 4. To force the procedure you can alternatively click on the Upload Configuration and Update LNS button. 5. This uploads the current configuration from the device and opens the download dialog. 6. Click Start and follow the project download, which also upgrades the device in the LNS database according to the new static interface.

  • Page 116: 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-Proxy results in a file transfer. The L-Proxy supports both, the L file transfer and the simpler direct memory read/write method.

  • Page 117: Upload The System Log

    (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 5.3.5). The file can also be uploaded from the device with the L-Proxy Configurator. To Upload the System Log 1.

  • Page 118: Connections

    L-Proxy User Manual LOYTEC Figure 119: System log window. 4. Click on Save to store the system log into a file on your local hard drive. 7.11 Connections 7.11.1 Create a New Connection After having configured the device’s network ports with data points, internal connections between those data points can be created.

  • Page 119: Auto-Create Connections For Nvs

    3 a connection called nviTemp0 is created containing those three data points. Note, that NVs are not required to be on different L-Proxy ports in order to be added to connections. This means if an “nviHumid9” and an “nvoHumid9” are both on port 1, a connection for those two NVs will be created.
  • Page 120 L-Proxy User Manual LOYTEC To Generate and Connect from NVs 1. Click on the Datapoints tab. 2. If the NVs shall be generated on another port than the currently connected one, select a different port in the drop-down list of the data point manager, e.g., Port 2.

  • Page 121: Create Connections From A Csv File

    L-Proxy User Manual LOYTEC If the static interface of another port has been changed, notify the engineer responsible for that port. Refer to Section 7.9.16 on how to repair such an interface in the LNS database. 7.11.4 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.

  • Page 122: Connection Overview

    L-Proxy User Manual LOYTEC To Delete a Connection 1. Change to the Connections tab of the main window. 2. Select the connection for removal. Use multi-select to select more than one connection. 3. Click Remove. 7.11.6 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 123: Application Scenarios

    8.1 Address Table Extension L-Proxy can be used to expand the number of address table entries available in a standard node that uses a Neuron Chip. If more than 15 destination addresses are required by the application one can use L-Proxy to overcome this limitation.
  • Page 124 L-Proxy Port 2.Proxy Figure 125: Node 6 only sends packet to L-Proxy Port 2 instead of sending message to nodes 7 and 8 directly. L-Proxy forwards the packet to the final destination nodes 7 and 8. Figure 126: Protocol analyzer log file for the 2 subnet/node bindings shown in Figure 125. Node 6 first sends an update for nviSwitch0 to L-Proxy, which sends an update to node 7.

  • Page 125: Saving A Group Address

    Figure 129: Protocol analyzer log file for the group binding shown in Figure 128. Node 6 uses acknowledged group binding to communicate with nodes 7 and 8. L-Proxy can be used to break up the group into individual subnet/node addressed bindings, which saves valuable group addresses for group bindings with a higher member count.
  • Page 126 Figure 130: Acknowledged subnet/node addressed messages save a group address entry. Figure 131: Protocol analyzer log file for the L-Proxy bindings shown in Figure 130. Node 6 uses acknowledged subnet/node binding to communicate with L-Proxy port 2. L-Proxy relays the information to nodes 7 and 8 using acknowledged subnet/node addressed messages.

  • Page 127: Binding Across Domains

    Node 6 in Domain 4C4F59544543. This would require a binding across domains, which is not supported in state-of-the-art network installations tools. One can use L-Proxy to make the connections between the 3 domains as explained below. Let’s add L-Proxy1 Port 2 to the network with DomainID 4C4F59544543 as shown in Figure 133.
  • Page 128 Figure 133: We bind the input and output NVs of Node 6 in domain 4C4F59544543 to the corresponding dynamically created NVs on L-Proxy Port 2. Let’s do similar bindings for the NVs on Node 7 and Node 8 as shown in Figure 134 and Figure 135 for L-Proxy Ports 3 and 4.
  • Page 129 Figure 136: These 2 connections implement the desired functionality as specified: Node 6 in Domain 4C4F59544543 (“LOYTEC”) must turn on the lamp connected to Node 7 in Domain 03 and the lamp connected to Node 8 in Domain 505889 (“PXY”). Furthermore the switch connected to Node 8 must turn on the lamp connected to Node 6 in Domain 4C4F59544543.

  • Page 130: Poll-Update Proxy

    Figure 138: Turning on the switch on Node 8 creates the following packet stream in order to turn on the lamp on Node 6. Note, in this example the 3 L-Proxy ports can either be connected to the same network cable (as shown in the log file in Figure 137) or they can be connected to individual network cables.
  • Page 131 Forward poll means that if poll requests are received from the destination node (node1) on the output side of L-Proxy, they are forwarded to the source node (node2) in addition to the periodic polls generated by the L-Proxy. To configure a forward poll set the Max Cache Age property to ‘0’...

  • Page 132: Poll-On-Startup Proxy

    SNVT_amp_mil and nviTemperature_f of SNVT_temp_f. Since the network variables are of different type on node 1 and on node2 these NVs cannot be bound directly. The L-Proxy can act as a translator between the different network variable types as shown in Figure 143.
  • Page 133 LOYTEC Figure 143: Example for scalar SNVT translation. Create a manual connection for nviAmpere and nvoAmpere_mil on L-Proxy port 2 (see Section 7.11.1). An example connection dialog for this is shown in Figure 144. Figure 144: Manual Connection Setup for SNVT Translation.

  • Page 134: Operating Interfaces

    9.1 CEA-709 Interface 9.1.1 NV Import File Network variables can be imported to the L-Proxy Configurator in a CSV file. The format of this file is described in this section. The first line of the file must contain a comment, starting with a hash character ‘#’...

  • Page 135: Node Object

    (default) / static=2 / file=3 Table 8: CSV Columns of the NV Import File 9.1.2 Node Object The L-Proxy provides a node object conforming to the L guidelines. • The Node Object accepts the following commands via nviRequest and updating...

  • Page 136: Gateway Objects

    (SNVT_alarm_2). This allows devices supporting the L alarm notifier profile to receive alarms generated by the L-Proxy 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 137: Network Media

    The L-Proxy 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-Proxy does not provide the power supply for Link Power channels.

  • Page 138: Proxy Firmware Update

    LOYTEC 11 L-Proxy Firmware Update The L-Proxy firmware supports remote upgrade over the network and the serial console. To guarantee that the L-Proxy is not destroyed due to a failed firmware update, the L-Proxy firmware consists of two images: •...
  • Page 139 LOYTEC Figure 148: FTP connection dialog. 3. In the FTP connection dialog, enter the IP address of the L-Proxy as well as the FTP user name and password. The default user name and password are ‘admin’ and ‘admin’. This can be changed via the Web interface (see Section 5.1) and reset via the console UI (see Section 4.8.2).

  • Page 140: Firmware Update Via The Console

    Figure 151: LSU Serial Upgrade Tool in Idle Mode 2. If the L-Proxy 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 141: Firmware Update Via The Cea-709 Network

    Basically, firmware downloads can be performed on every L-Proxy port. However, since the L-Proxy is not based on a Neuron Chip, a new firmware image cannot be downloaded with a standard tool. Rather, a designated tool, the LSD Tool (see Section 13.1), must be used.

  • Page 142: Troubleshooting

    12 Troubleshooting 12.1 All port LEDs are flashing red Problem All port LEDs are flashing red at a rate of approximately once per second and the L-Proxy does not relay messages. Explanation Somehow the primary image was destroyed and the fall-back image was booted (see Section 9.1).

  • Page 143: Nl220 Warning Appears During Installation

    Solution Click on Yes and Continue. In most cases this will be enough to use L-Proxy. If L-Proxy is behaving strange one should reset the L-Proxy to its default configuration via the console interface (see Section 4.8).

  • Page 144: Node Does Not Respond To Poll Request

    Delete/Remove from the context menue. Make sure that the device can be reached by LonMaker/NL220/Alex during the deletion process. Therefore LonMaker/NL220/Alex must be On-Net. This process must be followed for all L-Proxy ports that have been used. As a second alternative the L-Proxy can be set into its factory default state through the console interface, see Section 4.8.

  • Page 145: Technical Support

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

  • Page 146: Application Notes

    13.1 The LSD Tool Please refer to application note “AN002E LSD Tool” for further information about the LOYTEC system diagnostics tool for the L-Proxy. 13.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 147: Firmware Versions

    L-Proxy User Manual LOYTEC 14 Firmware Versions Table 9 shows the most important features available only in certain firmware versions. Firmware Version/ Features Console Menu √ √ √ √ √ (configuration & firmware update) Binding across domains √ √ √...

  • Page 148: Specifications

    L-Proxy User Manual LOYTEC 15 Specifications 15.1 L-Proxy 15.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...

  • Page 149: References

    L-Proxy User Manual LOYTEC 16 References Application Layer Interoperability Guidelines, Version 3.3, October 2002. L-Proxy User Manual, Version 2.2, December 2004. L-IP User Manual, LOYTEC electronics GmbH, Document № 88065909, June 2006. Version 3.1 LOYTEC electronics GmbH...

  • Page 150: Revision History

    Added support for NL220 network management tool 2003-02-18 Release Version 2.0 of the user manual 2003-08-14 Updated solutions section. 2004-01-14 Add description how to use L-Proxy in Alex. 2007-01-07 Changed for L-Proxy firmware 3.0 and LP-33E100. 2009-03-06 Updated for firmware 3.1.0. Version 3.1...

Table of Contents