LOYTEC L-VIS User manual

L-VIS
LOYTEC Visualization
User Manual
LOYTEC electronics GmbH

Contact
LOYTEC
Blumengasse 35
A-1170 Vienna
AUSTRIA/EUROPE
[email protected]
http://www.loytec.com
Version 4.2
Document No. 88068514
LOYTEC MAKES AND YOU RECEIVE NO WARRANTIES OR CONDITIONS,
EXPRESS, IMPLIED, STATUTORY OR IN ANY COMMUNICATION WITH YOU, AND
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 INTENDED FOR SURGICAL IMPLANT
INTO THE BODY OR OTHER APPLICATIONS INTENDED TO SUPPORT OR SUSTAIN LIFE, FOR
USE IN FLIGHT CONTROL OR ENGINE CONTROL EQUIPMENT WITHIN AN AIRCRAFT, OR
FOR ANY OTHER APPLICATION IN WHICH IN THE FAILURE OF SUCH PRODUCT COULD
CREATE A SITUATION IN WHICH PERSONAL INJURY OR DEATH MAY OCCUR.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in
any form or by any means, electronic, mechanical, photocopying, recording, or otherwise,
without the prior written permission of LOYTEC.
AST, LC3020, L-Chip, L-Core, L-DALI, L-GATE, L-INX, L-IOB, LIOB Connect, L-IP,
L-MBUS, L-OPC, LPA, L-POW, L-ROC, L-STUDIO, L-Switch, L-Term, L-VIS,
L-WEB, ORIONstack, buildings under controlare trademarks of LOYTEC electronics GmbH.
LonTalk®, LONWORKS®, Neuron®, LONMARK®, LonMaker®, i.LON®, and LNS®are trademarks of Echelon
Corporation registered in the United States and other countries.

L-VIS User Manual 3 LOYTEC
Version 4.2 LOYTEC electronics GmbH
Table of Contents
1Introduction ................................................................................................10
1.1 What is L-VIS?..................................................................................................10
1.2 Scope...................................................................................................................12
2Getting Started............................................................................................13
2.1 Installing the L-VIS Configuration Application.............................................13
2.2 Connecting to the Device ..................................................................................13
2.2.1 CEA-709 Devices ....................................................................................13
2.2.2 BACnet Devices ......................................................................................16
2.3 Quick Start Tutorial CEA-709.........................................................................16
2.3.1 Add the device to the network .................................................................16
2.3.2 Create Dynamic NVs (LNS only)............................................................17
2.3.3 Start the L-VIS Configuration Software ..................................................17
2.3.4 Create Static NVs (if no dynamic NVs available) ...................................18
2.3.5 Create Menu Structure and Pages ............................................................19
2.3.6 Add Controls to the Page .........................................................................19
2.3.7 Connect the Data-Points ..........................................................................20
2.3.8 Write the Project to the L-VIS device......................................................21
2.3.9 Test the Project ........................................................................................21
2.4 Quick Start Tutorial BACnet...........................................................................22
2.4.1 Add the device to the network .................................................................22
2.4.2 Start the L-VIS Configuration Software ..................................................22
2.4.3 Create Data Points ...................................................................................23
2.4.4 Create Menu Structure and Pages ............................................................23
2.4.5 Add Controls to the Page .........................................................................24
2.4.6 Connect the Data-Points ..........................................................................24
2.4.7 Write the Project to the L-VIS device......................................................25
2.4.8 Test the Project ........................................................................................26
3Mechanical Installation..............................................................................27
3.1 Dimensions and Mounting................................................................................27
3.2 Theft Protection.................................................................................................27
4Electrical Installation.................................................................................28
4.1 Connection diagram..........................................................................................28
4.2 Electrical Characteristics LVIS-3E100/ME200..............................................28
4.3 Electrical Characteristics LVIS-3E11x/ME21x..............................................28
4.4 Touch Panel Cleaning Instructions..................................................................29
4.5 Terminals and Jumpers....................................................................................29

L-VIS User Manual 4 LOYTEC
Version 4.2 LOYTEC electronics GmbH
4.6 LEDs and Buttons............................................................................................. 30
5Interface Configuration.............................................................................32
5.1 Selecting the Interface...................................................................................... 32
5.2 Configuring the IP-852 interface..................................................................... 33
6Operating L-VIS.........................................................................................34
6.1 Touch Screen..................................................................................................... 34
6.1.1 Operation................................................................................................. 34
6.1.2 Calibration............................................................................................... 35
6.2 Data Input ......................................................................................................... 36
6.2.1 Simple Schedule Control......................................................................... 37
6.2.2 Extended Schedule Control..................................................................... 40
6.3 Setup Menu ....................................................................................................... 44
6.3.1 Custom Setup Menu................................................................................ 46
7Configuration Software .............................................................................47
7.1 Main Window.................................................................................................... 47
7.2 Context Menus.................................................................................................. 47
7.2.1 Add Objects............................................................................................. 48
7.2.2 Enable/Disable Access Control ............................................................... 48
7.2.3 Cut / Copy / Paste.................................................................................... 48
7.2.4 XML Export / Import .............................................................................. 49
7.2.5 Manage Data Points................................................................................. 49
7.2.6 Expand / Fold Tree.................................................................................. 51
7.2.7 Lock / Unlock Position............................................................................ 51
7.2.8 Hide / Show............................................................................................. 51
7.3 Main Menus....................................................................................................... 52
7.4 Tool Bar............................................................................................................. 52
7.5 Workflow........................................................................................................... 52
7.6 Common Property Pages ................................................................................. 53
7.6.1 General .................................................................................................... 53
7.6.2 Common Properties................................................................................. 54
7.6.3 Color........................................................................................................ 56
8Object Description......................................................................................58
8.1 Introduction ...................................................................................................... 58
8.2 Menu.................................................................................................................. 59
8.2.1 Menu Properties ...................................................................................... 59
8.3 Menu Item......................................................................................................... 59
8.3.1 Menu Item Properties.............................................................................. 60
8.4 Page.................................................................................................................... 61
8.4.1 Page Properties........................................................................................ 61

L-VIS User Manual 5 LOYTEC
Version 4.2 LOYTEC electronics GmbH
8.5 Controls..............................................................................................................62
8.5.1 Text Control.............................................................................................62
8.5.2 Bitmap Control ........................................................................................63
8.5.3 Push Button..............................................................................................64
8.5.4 Numeric Control ......................................................................................64
8.5.5 Bar Control ..............................................................................................66
8.5.6 Trend Control...........................................................................................69
8.5.7 Date Control.............................................................................................73
8.5.8 Data Log Control .....................................................................................74
8.5.9 Schedule Control......................................................................................75
8.5.10 Alarm-List Control ..................................................................................80
8.5.11 Vector Drawing Control ..........................................................................83
8.6 Data Point ..........................................................................................................85
8.6.1 Data Point Properties ...............................................................................87
8.7 Mapping Table ..................................................................................................89
8.7.1 Mapping Table Properties........................................................................89
8.8 Action Objects ...................................................................................................90
8.8.1 Action Properties .....................................................................................91
8.9 Collections..........................................................................................................95
8.9.1 Collection Properties................................................................................95
8.9.2 Collection Handling.................................................................................96
8.10 Alarm Generators .............................................................................................96
8.10.1 Alarm Generator Properties.....................................................................97
8.10.2 Application Hints.....................................................................................98
8.11 Data Point Connectors......................................................................................99
8.12 Mathematic Objects........................................................................................100
8.12.1 Math Object Properties..........................................................................100
8.12.2 Application Hints...................................................................................101
8.12.3 Function List..........................................................................................102
8.13 Trigger Objects................................................................................................103
8.13.1 Trigger Object Properties.......................................................................103
8.14 Templates.........................................................................................................105
8.14.1 Template Properties...............................................................................105
8.14.2 Creating a Template...............................................................................106
8.14.3 Instantiating a Template.........................................................................107
8.14.4 Nested Templates...................................................................................107
8.14.5 Local Changes........................................................................................108
9Data Point Management ..........................................................................110
9.1 Concept ............................................................................................................110
9.2 User Interface ..................................................................................................111

L-VIS User Manual 6 LOYTEC
Version 4.2 LOYTEC electronics GmbH
9.2.1 Folder List ............................................................................................. 111
9.2.2 Data Object List .................................................................................... 112
9.2.3 Property View ....................................................................................... 113
9.2.4 Buttons .................................................................................................. 113
9.3 Object Creation............................................................................................... 113
9.3.1 User Register......................................................................................... 113
9.3.2 Local Network Variable (CEA-709) ..................................................... 113
9.3.3 Local Server-Object (BACnet).............................................................. 114
9.3.4 Remote Network Object........................................................................ 115
9.4 Local Scheduler and Calendar ...................................................................... 117
9.4.1 Point Creation........................................................................................ 117
9.4.2 Calendar Point Configuration................................................................ 117
9.4.3 Scheduler Point Configuration .............................................................. 118
9.4.4 Schedule Configuration Data ................................................................ 118
9.4.5 System Resources.................................................................................. 119
9.4.6 Resource allocation ............................................................................... 121
9.4.7 Using the Scheduler............................................................................... 121
9.5 Local Alarm Server ........................................................................................ 121
9.5.1 Intrinsic Reporting................................................................................. 121
9.5.2 Algorithmic Reporting .......................................................................... 122
9.5.3 System Resources.................................................................................. 122
9.5.4 Using Alarm Servers ............................................................................. 122
9.6 Remote Scheduler and Calendar................................................................... 122
9.7 Alarm Clients.................................................................................................. 124
9.8 E-Mail Templates ........................................................................................... 124
9.8.1 Common E-Mail Properties................................................................... 125
9.8.2 E-Mail Trigger....................................................................................... 125
9.8.3 Attachments........................................................................................... 126
10Standard Procedures (CEA-709)............................................................127
10.1 Device Integration........................................................................................... 127
10.1.1 New Device........................................................................................... 127
10.1.2 Pre-Programmed Device ....................................................................... 129
10.2 Device Replacement........................................................................................ 130
10.2.1 Dynamic NV Projects............................................................................ 130
10.2.2 Static NV Projects................................................................................. 130
10.2.3 Mixed Projects (static and dynamic) ..................................................... 131
10.3 Configuration Change.................................................................................... 132
10.3.1 Same NV Configuration........................................................................ 132
10.3.2 Dynamic NV Change ............................................................................ 132
10.3.3 Static NV Change.................................................................................. 133

L-VIS User Manual 7 LOYTEC
Version 4.2 LOYTEC electronics GmbH
10.4 Configuration Recovery..................................................................................134
10.4.1 Change Device Configuration................................................................134
10.4.2 Change Network Configuration.............................................................135
10.4.3 Recover from a failed Update................................................................135
11Special Functions (CEA-709)...................................................................138
11.1 Binding Management......................................................................................138
11.2 XIF Export.......................................................................................................138
11.2.1 Offline....................................................................................................139
11.2.2 Online ....................................................................................................139
11.3 CEA-709.1-A Operation .................................................................................139
11.4 Dynamic Network Variables ..........................................................................139
11.4.1 LonMaker® Network Management Tool ..............................................139
11.4.2 NL220....................................................................................................142
11.4.3 Alex........................................................................................................143
11.5 Built-in LONMARK®Objects .......................................................................146
11.5.1 Timer Object..........................................................................................146
11.5.2 Switch Object.........................................................................................146
11.5.3 Relay / LCD Backlight control ..............................................................147
11.5.4 HVAC Temperature Sensor...................................................................148
12Special Functions (BACnet).....................................................................149
12.1 EDE Export of BACnet Objects.....................................................................149
12.2 BACnet Network Settings...............................................................................149
13Project Settings.........................................................................................150
13.1 Basic Settings...................................................................................................150
13.1.1 Page Protection......................................................................................150
13.1.2 Timeout Values......................................................................................150
13.1.3 Sound.....................................................................................................151
13.1.4 OEM Bitmaps ........................................................................................151
13.1.5 System Strings .......................................................................................151
13.2 Extended Settings............................................................................................151
13.2.1 System Flags..........................................................................................151
13.2.2 System Settings......................................................................................152
13.2.3 System Colors........................................................................................152
13.2.4 Time Zone and DST...............................................................................152
13.3 Display..............................................................................................................153
13.3.1 LCD Backlight.......................................................................................153
13.3.2 Display Properties..................................................................................153
13.4 Connectivity.....................................................................................................153
13.4.1 Remote Display Access .........................................................................153

L-VIS User Manual 8 LOYTEC
Version 4.2 LOYTEC electronics GmbH
13.4.2 Remote Data Access (FTP)................................................................... 154
13.4.3 Default OPC Access.............................................................................. 154
13.5 Mail Account................................................................................................... 154
13.6 Info................................................................................................................... 155
14Advanced Topics.......................................................................................156
14.1 Access Control................................................................................................. 156
14.2 Undo / Redo..................................................................................................... 157
14.3 Layout Tools.................................................................................................... 157
14.3.1 Alignment Functions............................................................................. 157
14.3.2 Make Same Size.................................................................................... 157
14.3.3 Space Evenly......................................................................................... 157
14.4 Find Similar Objects....................................................................................... 158
14.5 Preview and Edit Mode.................................................................................. 158
14.6 Remote Network Interface............................................................................. 158
14.7 Local Data Point Capacity............................................................................. 159
14.8 Device Model and Firmware.......................................................................... 159
14.9 Avoiding Update Loops.................................................................................. 160
14.10 User defined Fonts.......................................................................................... 160
14.10.1 Font File Location............................................................................ 161
14.10.2 Font Recoding .................................................................................. 161
14.10.3 PCF File Format............................................................................... 162
14.11 XML Support.................................................................................................. 162
14.12 Using Color Bitmaps ...................................................................................... 163
14.13 Using Sounds................................................................................................... 164
14.14 Format strings................................................................................................. 165
14.14.1 Number format strings...................................................................... 165
14.14.2 Date format strings........................................................................... 167
14.14.3 Regular Expressions......................................................................... 169
15Appendix A: Examples ............................................................................171
15.1 Example 1: Working with Structured Network Variables ......................... 171
15.1.1 Text control........................................................................................... 171
15.1.2 Bitmap Control...................................................................................... 172
15.1.3 Numeric Control.................................................................................... 173
15.2 Example 2: Using Data Point conversion and Hiding of Pages .................. 174
15.3 Example 3: Freeze warning, Alarms and Registers..................................... 175
15.4 Example 4: Using text mapping and Date Control...................................... 177
16Appendix B: Solutions .............................................................................180
16.1 Implementing Menus...................................................................................... 180
16.1.1 Tab Menus............................................................................................. 180

L-VIS User Manual 9 LOYTEC
Version 4.2 LOYTEC electronics GmbH
16.1.2 Icon Menus ............................................................................................182
16.1.3 Taskbar Menu ........................................................................................183
16.1.4 Bitmap Menu .........................................................................................183
16.2 Light Control...................................................................................................184
16.3 Animated Bitmaps...........................................................................................185
16.4 Sunblind Demo................................................................................................185
16.5 Split Demo........................................................................................................186
16.6 Counter Demo..................................................................................................187
17Revision History........................................................................................189

L-VIS User Manual 10 LOYTEC
Version 4.2 LOYTEC electronics GmbH
1 Introduction
1.1 What is L-VIS?
L-VIS is a highly flexible and easy to configure device to display and control data in
BACnet and CEA-709 networks. The L-VIS configuration software can be run as a
standalone program as well as an LNS®plug-in and supports the use of both static and
dynamic network variables in a project to allow easy integration in any kind of CEA-709
network.
The key features of the L-VIS device family are:
Simple, graphical programming via the supplied configuration software.
Support for alarming, scheduling and trending.
Support for the UCS-2 character set of the Unicode standard (ISO-10646), to
allow for the design of projects in any language, including Chinese, Japanese,
and Korean (CJK).
Display of data as numeric value, user-defined text or graphic elements,
horizontal and vertical bars or trend logs. A special element is available to
display date and time in form of digital or analog clocks.
Input of data via a numeric keypad, direct drag of a bar or selection from a
dropdown list of texts or graphic elements.

L-VIS User Manual 11 LOYTEC
Version 4.2 LOYTEC electronics GmbH
Mapping of values to colors, to allow an element to change color depending on
the current value.
Supports layers and transparency for all display elements. Layering is simply
defined by the order of objects in the tree view, which may be changed easily by
moving the objects around as required.
Support for numeric operations on data points, including a simple if/else
statement.
Input voltage: 24V AC or DC
The LVIS-3E100 and LVIS-3E11x models (CEA-709) also provide:
Up to 1000 network variables and alias variables.
524 address table entries.
Up to 100 LonMark scheduler objects. Each scheduler object may control up to
64 data points in 107 daily schedules and manage up to 1000 entries in the
time/value table. Up to 256 value templates may be defined for each scheduler,
with a total data size of up to 1kB per value template.
An optional LonMark calendar object, defining exception days for the local
schedulers. The calendar object supports up to 100 date patterns with a total of up
to 1000 date entries.
Optional alarm server functionality provided by a SNVT_alarm_2 output NV
contained in the node object of the device.
FT-10/LPT-10 or Ethernet-IP852 operation selectable via a jumper on the device
or via a setting in the device configuration. When in FT-10 mode, the device can
still be reached via its Ethernet port for fast project download.
A lamp actuator object, to control the backlight from the network. This object
was used to control the internal relay on the older LVIS-3ECTB devices.
A switch object to provide a standard switch and dimmer function, as available
on other CEA-709 devices. The switch input for this object is the IN0 connector.
Both IN0 and IN1 inputs are also available as system registers, for internal use.
A temperature sensor object which outputs the current value of the external
temperature sensor (optional).
A real time keeper object, which outputs the current system time.
8 L-VIS functional blocks which can be used to place static or dynamic NVs
related to the data points used in the project.
Network scanning to find other device on the network and help in creating the
required network variables on L-VIS.
The LVIS-ME200 model (BACnet) provides:
Up to 512 server objects, accepting COV subscriptions. Available object types
are analog, binary and multi-state, each as input, output, or value object.

L-VIS User Manual 12 LOYTEC
Version 4.2 LOYTEC electronics GmbH
BACnet/IP or MSTP connectivity (selectable via jumper or device configuration
setting).
Network scanning to find other devices and their objects in the network and use
them on the L-VIS device without the need to manually enter device and object
instance numbers.
Supports COV subscription and polling of remote server objects with automatic
selection of the best method (COV if available).
1.2 Scope
This manual covers the L-VIS device family. Currently available are the following models:
Model
Network Type
Display
Colors
LVIS-3E100
CEA-709
5.7” 320x240
256 color VGA
LVIS-100-RE
CEA-709 *
5.7” 320x240
256 color VGA
LVIS-3E112
CEA-709
12” 800x600
65k color ARGB
LVIS-3E115
CEA-709
15” 1024x786
65k color ARGB
LVIS-ME200
BACnet
5.7” 320x240
256 color VGA
LVIS-ME212
BACnet
12” 800x600
65k color ARGB
LVIS-ME215
BACnet
15” 1024x786
65k color ARGB
*The LVIS-100-RE model is the same as the LVIS-3E100, but with a fixed static network
interface. Dynamic and external NVs are not supported. A ready-to-go project designed for
room automation is pre-installed on the device (the –RE suffix indicates that this device is
such a room edition device).
This manual also applies to the L-WEB product family, since this configuration software is
also used to design the user interface for L-WEB OPC clients, like the LWEB-800.

L-VIS User Manual 13 LOYTEC
Version 4.2 LOYTEC electronics GmbH
2 Getting Started
2.1 Installing the L-VIS Configuration Application
To install the L-VIS Configuration software, execute the setup program and follow the
instruction of the installation wizard. The setup program adds an entry for the L-VIS
Configuration software to the start menu. For the use with LNS®based network
management tools, it registers the configuration software as LNS®plug-in. Before the
LNS®plug-in can be used in a network management tool it has to be registered in the LNS®
project. Please refer to the documentation of your network management tool how to
register an LNS®plug-in in a network management project. During the registration process
of the L-VIS Configuration software plug-in, LNS®device templates are created for the
FT-10, and IP-10L (Ethernet) versions of the device.
2.2 Connecting to the Device
There are several ways in which the configuration software can be run and used to
configure a device. While this is straight forward for BACnet models, it is important to
know the advantages and limitations of each method for CEA-709 devices.
NOTE: All devices running firmware 4.0 or newer will require a user authentication to allow
connections. The default password for connecting to the device is admin if the device is
running a version 4.0 firmware and loytec4u for firmware 4.1 or newer.
2.2.1 CEA-709 Devices
CEA-709 devices may be configured in several different ways:
Through LNS®(software run as LNS®plug-in).
Via a TCP/IP connection (using FTP/Telnet or SSH).
Via a CEA-709 connection (FT-10 or IP-852).
Each of these methods has some advantages and some limitations in what they can do.
Please see the following detailed description of the individual connection methods.
2.2.1.1 LNS®Connections
This method connects to the device from within the LNS®based network management tool.
The software is run as a plug-in and all communication with the device is done through
LNS®, meaning that you can use any network interface which is supported by LNS®.

L-VIS User Manual 14 LOYTEC
Version 4.2 LOYTEC electronics GmbH
If your device is integrated into the network using an LNS®based tool (your device is
managed by LNS®) and you need to add or remove static network variables from your
project or otherwise change the static interface of the device, you must use this connection
method to download your project, since the configuration software needs to do several
adjustments to the LNS®database during this process.
If your changes to the project do not cause changes to the static network interface, for
example you are just working on the graphics, adding or modifying controls and so on, it is
more efficient to use one of the other connection methods. The configuration software will
detect any change in the static network interface beforehand and display a warning before
you commit to the project download.
Starting with version 4.0.2 of the configuration software, this operating mode can be
combined with a parallel TCP/IP connection to transfer project data efficiently while
maintaining a connection to the LNS database for database updates.
ADVANTAGES:
No need to set up TCP/IP connectivity (optional, to speed up project download).
Easy device selection from within your management software.
Automatically updates the LNS®database and re-commissions the device, if the
static interface of the device changes due to the downloaded project.
Functions are available to export and import current bindings to and from the
device into CSV files.
Any dynamic network variables created on the device will automatically show up
as usable data points in your project, including the name of the functional block
in which they are located.
Network scans can be done in the LNS®database. This scan method is fast and
provides the most complete information about other devices in the network,
compared to other scan methods (see also section 2.2.1.2).
LIMITS:
If no parallel IP connection is used, the transfer of large projects or a firmware
upgrade is slow due to the limits of the communication channel. This is
especially true for devices in FT-10 mode. Use a recent version (3.2.0 or newer)
of the configuration software and the device firmware, to allow the use of ZIP
compression for project files. This will considerably speed up the download
process. If possible (version 4.0.2 and newer), use a parallel IP connection for
project download.
2.2.1.2 TCP / IP (Ethernet) Connections
This method connects to the device through a standard TCP/IP channel. Because data is
transferred using the FTP and telnet protocols, the PC running the configuration software
must be able to establish an FTP and telnet connection to the device. The LVIS-3E11x and
LVIS-ME21x devices also support encrypted connections via SSH. In this case, only one
TCP port (port 22) is used for the entire communication between the PC and the device.
TCP/IP connections are possible even when the device operates in FT-10 mode, since the
IP port is always active. The IP address, network mask and gateway must be configured via
the setup menu on the device. The device must be restarted once for the new settings to take
effect.

L-VIS User Manual 15 LOYTEC
Version 4.2 LOYTEC electronics GmbH
In the configuration software, the IP address or DNS name of the device can be used to
establish a connection. Each connection can be named and saved in a connection list, which
is stored in the system so that the list is available when the software is run the next time.
When connecting to devices running firmware version 4.0.0 or newer, the correct admin
password must be entered in this dialog to establish a connection for project up- and
download.
ADVANTAGES:
Very fast data transfer, suitable for large projects.
Best way to update the firmware of a device fast and secure.
Communication is possible even when the device is not commissioned or
otherwise not reachable on the CEA-709 port.
No LNS®or special network interface hardware is required. The standard
Ethernet port which is available on every PC is enough.
LIMITS:
No connection to LNS (if present) and therefore no way to update the database in
case the new project changes the static interface of the device. Projects which add
or remove static network variables or otherwise change the static interface may
not be loaded via this method if the device is part of an LNS database, since the
database will be out of sync after the download and cannot be repaired by the
user (only the configuration software can apply the necessary changes). Use the
LNS connection method in this case (see section 2.2.1.1).
Any dynamic network variables which were created on the device using a
network management tool will show up as usable data points in the project, but
the available information is limited to the data stored in the device. For example,
the functional block in which the NVs were created will be unknown since this
information is only stored in the LNS database and is not available on the device.
Network scans are conducted by the device itself, using a built-in scanner engine.
This scan is slower than an LNS® scan and cannot provide as much information,
for example device names will have to be set manually.
2.2.1.3 CEA-709 (FT-10 / CEA-852) Connections
In this mode, the communication channel is CEA-709 via a LOYTEC NIC such as a NIC-
USB, NIC-PCI or NIC-852. The device must first be commissioned (assigned a network
address), either by using the same network management tool as used for the other nodes in
the network or by entering a suitable unused address in the CEA-709 setup menu. In the
connection dialog of the configuration software, a suitable unused subnet/node address
must be entered for the network interface card of the PC. The address of the device may
either be entered manually as well, or can be detected automatically by either entering the
unique node ID or by pressing the service pin button on the device. Once the address is
known, the connection can be given a name and saved just like the TCP/IP connections, so
that the procedure is only necessary when the address of the device changes.
Connecting via CEA-709 is most suitable when the device is not connected to the IP
network and a non-LNS network management tool is used for integration.
ADVANTAGES:
Works even when the device is not connected to an IP network, thus no need to
set up TCP/IP settings for the device.

L-VIS User Manual 16 LOYTEC
Version 4.2 LOYTEC electronics GmbH
Download is faster compared to LNS®connections, due to an optimized file
transfer protocol.
Works independent of the used network management tool.
LIMITS:
Only works when the device is commissioned. A download of a new project
which changes the static interface of the device will therefore break the
connection, since the device will have to reset its CEA-709 network
configuration in that case. The device must then be re-commissioned in the
network management tool and the connection must be re-established.
Especially in FT-10 mode, project downloads can still be slow. The same is true
for firmware downloads. If possible, the TCP/IP connection method should be
used for such tasks. Transfer speed is considerably improved when there are no
routers with limited buffer size between the PC and the device. Routers which are
able to handle large packets (254 byte) will have no real impact on the transfer
speed. Routers which allow a maximum packet size of 64 bytes only will degrade
the transfer speed.
Only network interface hardware from LOYTEC can be used for this type of
connection. Any LOYTEC NIC may be used to run the configuration software,
that is, the software is not registered to specific network interface hardware.
There is currently no way to conduct a network scan using this connection
method, since the built-in scanner engine on the device can only be controlled
using a TCP/IP connection.
2.2.2 BACnet Devices
To configure BACnet devices, the software is always run in standalone mode and a
connection to the device is made over TCP/IP. The PC must be able to establish an FTP and
Telnet connection or a single SSH connection to the device. If NAT routers or firewalls are
located between the PC and the device, the SSH protocol is preferred over the FTP/Telnet
connection. Check your firewall rules if necessary. Note that SSH connections are not
possible for the LVIS-3E100 and LVIS-ME200 devices.
2.3 Quick Start Tutorial CEA-709
This tutorial describes the steps to create a first demo project and load the project into a
CEA-709 device, like the LVIS-3E100. The tutorial assumes that the configuration
software is already installed and the LNS®plug-in is registered as described in the prior
section. For the LNS®specific part of this tutorial, the LonMaker®3.1 network
management tool is used. Other network management tools, which are based on LNS®3 or
above, which support dynamic network variables and the LNS®Plug-in Interface can be
used as well for this tutorial (e.g. Newron‟s NL220, SPEGA‟s Alex 3 Professional).
2.3.1 Add the device to the network
The first step is to integrate the device into an existing network. Depending on the device
type and the type of network used, this step is either done on the device or on the PC using
network management software. In any case, the device first needs to be physically
connected to the network and a suitable power supply.
2.3.1.1 CEA-709 with LNS: Create the L-VIS device in the LNS database
Add the L-VIS device to your LNS network project. Since the L-VIS configuration plug-in
already creates the device templates, the device configuration can be read from the device

L-VIS User Manual 17 LOYTEC
Version 4.2 LOYTEC electronics GmbH
template. Choose the device template which matches the network interface mode (FT-10 or
IP-10L) of your device. The Node ID of the device can be entered manually. Optionally, a
service pin message can be sent by pressing the status button located at the bottom of the
device, or by selecting the Send Service Pin Message command in the SetupCommands
menu of the L-VIS device (see 6.3).
Set the device configured online during the commission phase, so that the device will be
able to communicate with other nodes on the network and with the configuration software.
NOTE: Do not integrate the device into your project by uploading the device interface properties
from the device before you registered the plug-in. This is important because if you upload
the definitions from the device, you will create a template of your own and the
configuration software will then fail to create the real device template, once you register it.
In this case, you must remove the device and the template from the database and re-run the
plug-in registration.
2.3.1.2 CEA-709 without LNS: Assign a network address
Use your network management tool to add the device to the database and assign a network
address to it. Alternatively, go to the CEA-709 page of the setup menu and enter a suitable
network address manually, then press the button „SET ONLINE‟ to activate the address.
2.3.2 Create Dynamic NVs (LNS only)
In this example, we will create two dynamic network variables of type SNVT_switch on the
device, one input and one output, and bind them together (turnaround binding) to show how
to display and send out data.
NOTE: If your network management tool does not support dynamic NVs, just skip this step. The
required data points will then be created from within the configuration software in a later
step (as static NVs).
First, we need a functional block to place the new network variables in. Create one of the 8
available L-VIS functional blocks (for example L-VIS[0]) to hold the two variables. Next,
create the two switch variables. For the complementary NV required to create the dynamic
NV, browse to the Switch object of your L-VIS device and select one of the two switch
variables available there (the direction does not matter). More information about dynamic
network variables can be found in section 11.4.
NOTE: Make sure to set the poll attribute to CLEAR when you create the output variable,
otherwise you will not be able to send out any values through this NV. Also, the poll
attribute of the input NV should be SET, so that L-VIS is able to fetch an initial value when
it boots up.
Now bind the output NV to the input NV, so that we can send/receive values.
2.3.3 Start the L-VIS Configuration Software
If possible, run the configuration software in plug-in mode from within your network
management tool. Open the context menu of the L-VIS device block in your drawing and
select Configure to start the configuration software.
NOTE: For network management tools which do not support plug-ins, start the program in
standalone mode and connect to your device via TCP/IP or CEA-709 over a LOYTEC NIC.
When started in plug-in mode, a connection dialog will appear and ask for an optional IP
connection to the device. If the device can be reached via TCP/IP, enter the required data
here and press „Connect‟, otherwise just press „Cancel‟ to continue without IP connection.

L-VIS User Manual 18 LOYTEC
Version 4.2 LOYTEC electronics GmbH
The configuration software contacts the device, finds out what model and firmware version
it is, selects the correct settings and disables the corresponding menus, so that you may not
change them. The main window will show an empty L-VIS project.
The list of dynamic network variables available on the device is automatically read in and a
list of corresponding data points to access the NVs is generated. These data points will be
used in a later step. If no dynamic NVs were created in the previous step, the required NVs
and data points will be created in the configuration software later on.
NOTE: In case the device was not commissioned yet, or there are other communication problems,
the plug-in will display a warning message, saying that it could not communicate with the
device and therefore was not able to determine model or firmware version. In this case, you
have to commission the device or find out why it cannot be commissioned. Typical errors
are devices in the wrong mode (jumper set for CEA-852 but connected to FT-10 or vice
versa) or communication problems on the channel itself. Especially on a channel as
complex as CEA-852, there are a number of possible reasons why you may not be able to
communicate with the device.
The main window is divided in tree major sections:
Tree View: On the left side of the main window is a tree view showing all objects you
created so far and how they relate to each other, for example a menu object may have menu
item objects attached to it, a menu item object may have page objects and sub-menu objects
attached, and a page object contains the elements to display and enter data (these elements
are called controls in this manual). You may navigate through this tree and select an object
from it or drag and drop objects to move them around in the hierarchy, for example grab a
control from one page and drop it on another page. An empty project contains only a root
menu and a folder object where global objects can be placed, which are not directly related
to the user interface, for example alarm generators.
Property View: On the top right of the main window is a property view, which shows a
number of property pages, where you can adjust the properties of the currently selected
object. The number and kind of property pages changes according to the selected object,
but some of the more basic property pages are available all the time. Feel free to browse
through the available pages and see what you can adjust there.
LCD Preview: To the lower right of the main window is the preview of the project as seen
on the LCD when the project is downloaded. This is not a functional simulation of the L-
VIS device, but a layout guide and preview of individual menus and pages. The preview
changes according to the currently selected object. Since the configuration software comes
with a library of the layout code used in the various firmware versions of the device, the
preview is always accurate to the pixel. Should the layout or appearance of controls change
with firmware versions, the configuration software is able to track these changes and
display the page exactly as it will appear on the device you are currently connected to.
NOTE: You may select, move, and resize your controls directly inside the LCD preview. Also, there
are context menus available for each control, which you can open by a right click on the
control in the preview. The cursor keys can be used to move controls one pixel at a time
and to resize the control, when the shift key is held down.
2.3.4 Create Static NVs (if no dynamic NVs available)
In case the network management tool used for the tutorial does not support dynamic
creation of NVs on the device, the NVs required for this tutorial must now be created
manually using the data point manager window. This window is accessible either from the
tool bar (the icon left to the connect button), or from the main menu Edit -> Datapoints….
Please skip forward to section 9.3.2 for a description of how to create local network
variables. Following this description, create one input NV and one output NV, both of type
SNVT_switch.

L-VIS User Manual 19 LOYTEC
Version 4.2 LOYTEC electronics GmbH
2.3.5 Create Menu Structure and Pages
The next step is to design a simple test page for this tutorial and use the two data points.
The empty project shows the root menu with no entries (menu items). You may change the
name of the root menu as well as its colors and other properties, such as the width of the
menu or its scroll-bar, using the property pages to the right of the tree view (make sure the
root menu object is selected, which should be the case right after you started the software).
The menu object is described in detail in section 8.2.
First, add a menu item to the root menu. To do this, right click on the root menu object in
the tree view and select Add Item from the context menu. A new menu item is created and
connected to the menu object. The new menu item is automatically selected, so that you
may browse the property pages and see what you want to change. The name of the item
object can be changed in the Name box of the General property page. This changes the
name of the object in the object tree and has no effect on the appearance of the menu item
on the device. To change the text of the item itself, go to the Common Properties page
and change the contents of the Text box. The display in the preview window changes as you
type, so you can immediately see the results. You may want to change the font to the
12x16-ROM-Fixed-R font, so you get a larger item which is easier to select on the touch
screen. The menu item object is described in detail in section 8.3.
Repeat the steps above to add another menu item and call it „Setup‟. Again, change the Text
of the item to read something like „Setup‟ and change the font to make the item a
comfortable size. This item will be used to enter the devices setup menu.
NOTE: The device will check the last item of the root menu and see if it has any pages or sub-
menus attached to it. If the item has no further objects attached (this is called a return item)
and is located at the last position in the root menu, then the device will connect its setup
menu to this item. If the item is used, the device will create a default item to reach the setup
menu, but this will most likely not fit the design of your other menu items, so it is best to
always add a setup item yourself and configure it the way you want it to look.
Finally, add a page to the first of the two menu items. This page will be displayed when the
user selects the first menu item from the root menu. Open the context menu of the menu
item (right click on the item in the tree view) and select Add Page. In order to see this page
right after the device started, make this page the projects default page. Open the context
menu of the page in the tree view and select Set as Default. The page object is described in
detail in section 8.4.
2.3.6 Add Controls to the Page
The next step is to place some objects on the page to view and control the values of the two
network variables. These objects are called controls in this manual, since they allow the
user to control the data points and display their current value. A number of different control
styles are available to choose from. In this example, we want to display the current status of
the switch input using a text control for the state and a numeric control for the value. To
control the switch output, we use a bitmap control for the state and a bar control for the
value.
To create the required controls, either right-click on the page object in the tree view and
choose the control type you want from the context menu, or select the page in the tree view
and right click in the LCD preview area to reach the same context menu. Add one text
control, one bitmap control, one numeric and one bar control to your page.
Now place the controls on your page so that they do not overlap each other. Grab and drag
them with the mouse or enter position and size in the Screen Coordinates section of the
Common Properties page. To resize the controls with the mouse, move the pointer to the
lower right corner of the controls area in which the value is displayed, that is, disregard any
decorations around the value area, like the scale of a bar control. For most control types, the
value area fills the entire space of the control, except for the selection frame. For more
complex controls, like bars and trend logs, you can view the value area by changing the

L-VIS User Manual 20 LOYTEC
Version 4.2 LOYTEC electronics GmbH
Container color on the Color property page. Then grab the control at the lower right corner
of the container area.
NOTE: The position and size you set on the Common Properties page also refers to the value area
of the control, not to the selection frame around it. This is done so that for example the
width and height of a bar does not change when you enable or disable tick marks or scale.
These are just seen as decoration which can be turned on and off while the area of the
value display remains stable.
Adjust the properties of each control as you like or leave them at the defaults, which should
be fine for this demo. Bitmaps will be added to the bitmap control in a later step.
2.3.7 Connect the Data-Points
At this point, connect data points to the controls. Especially for text and bitmap controls, it
helps to connect the data points early, since the configuration of the controls property will
depend on the data point connected (you will see why this is the case in a minute).
To add a data point to a control, select Add Data Point… from the controls context menu. A
dialog will appear which is used to manage and select data points. This dialog is explained
in detail in chapter 8.13, for now we just use it to select our data points, which should have
been created for us already. Select the folder Local NVs from the tree view at the left of the
dialog. There should be two items, one for the input NV and one for the output NV we
created earlier.
NOTE: In case you created the dynamic NVs after you started the plug-in, the data points will not
be there yet. In this case, close the data point dialog and push the button two positions right
from the connect button. The tool-tip of this button reads ‘Update Data Points’. It will re-
scan the currently available dynamic NVs on the device and create the required data points
for you. If you added NVs while the plug-in was open, hit the update button to get the
required data points added to your project automatically.
From the two items available in the data point list, select the input data point and expand its
items by a left click on the small plus sign left of the data point. The expanded view will
show two sub-elements, one for the state component of the NV and one for the value
component. A data point is selected by a double click or by selecting one or more points
and clicking the OK button.
Use the above procedure to add the state part of the input NV to the text control, the value
of the input NV to the numeric control, the state of the output NV to the bitmap control and
the value of the output NV to the bar control.
NOTE: When you add the state of the input NV to the text control, another object called a mapping
table will be created automatically and will be initialized to map the three known states of
the switch state to standard state texts. You may select this mapping table and change the
texts as well as assign different colors to the individual texts in the mapping table. Mapping
tables are discussed in detail in section 8.7, for now you can leave the table alone.
All the controls should now have one data point connected, with the text control and the
bitmap control having a data point and a mapping table. The bitmap control needs some
more work, since we need to assign graphics to the individual values of the connected data
point.
To do this, select the mapping table object which was automatically created and attached to
the bitmap control. On the Mapping property page, select one of the entries in the list, for
example the entry for the value -1, which maps to the text SW_NUL. Click on the button
Select…and select a suitable graphic to show for this state. A library of icons in PNG
format is installed together with the configuration software. You may also draw your own
graphics as well. For best results, save them in PNG format for icons including
transparency or JPG format for full-page background images.