1 Introduction ....................14 What is L-VIS? ....................14 Available Models ....................16 2 What’s New in L-Vis .................. 18 New in L-Vis 6.2.0 ....................18 2.1.1 Localized date and number controls ............18 2.1.2 Extended date control ................18 2.1.3 Improved trend control ................
Page 4
3.3.5 Create Menu Structure and Pages ............30 3.3.6 Add Controls to the Page ................. 31 3.3.7 Connect the Data-Points ................32 3.3.8 Write the Project to the L-VIS device ............33 3.3.9 Test the Project ..................33 Quick Start Tutorial BACnet ................34 3.4.1 Add the device to the network..............
Page 5
Control Network Interfaces ................46 6 Interface Configuration ................47 Selecting the Interface ..................47 Configuring the IP-852 interface ..............49 7 Operating L-VIS ..................50 Touch Screen...................... 50 7.1.1 Operation ....................50 7.1.2 Calibration ....................51 Data Input ......................52 7.2.1 Knob Control....................
Page 6
L-VIS User Manual LOYTEC 8.3.11 Vector drawing ..................72 Main Menus ....................... 72 8.4.1 Undo / Redo ..................... 72 8.4.2 Find Objects ..................... 72 8.4.3 Find Next ....................73 8.4.4 Find by UID ..................... 74 8.4.5 Device Model and Firmware ..............74 Context Menus ....................
Page 7
L-VIS User Manual LOYTEC 8.10.4 Solving Complex Tasks ................88 8.10.5 Improved Structure................... 89 8.11 Workflow ......................89 8.12 Common Property Pages .................. 90 8.12.1 General ..................... 90 8.12.2 Common Properties .................. 91 8.12.3 Color ......................94 9 Object Description ..................96 Introduction .......................
LOYTEC 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...
Page 15
L-VIS User Manual LOYTEC Display of data as numeric value, user-defined text or graphic elements, horizontal and vertical bars, trend logs, or analog meters. A special element is available to display date and time in form of digital or analog clocks.
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.
Page 17
Universal 256k color ARGB capacitive Table 1: Available L-Vis devices * These models are still supported and will receive software updates, but can no longer be ordered. The direct replacement for the 12” models (CEA-709 and BACnet) is the LVIS- 3ME12-A1, replacement for the 15”...
2 What’s New in L-Vis 2.1 New in L-Vis 6.2.0 This section describes major changes and new features in L-Vis 6.2.0 2.1.1 Localized date and number controls Release 6.2.0 adds support for localized display of date, time, and numbers. A desired...
2.2 New in L-Vis 6.1.0 This section describes major changes and new features in L-Vis 6.1.0 2.2.1 Support for complex writing systems Release 6.1.0 adds support for complex writing systems such as Arabic, Devanagari, Bengali, Thai, Hebrew and many others belonging to the family of Abjad or Abugida scripts.
LVIS-3E112/ME212 and LVIS-3E115/ME215 respectively. 2.3.2 Math objects as input data points L-Vis math objects can now be used in all places where input data points can be used, including cascaded math objects. This saves on internal registers for calculation results and keeps the project simple, because the formula is located at the exact place where its result is being used.
L-VIS User Manual LOYTEC 2.3.3 New pre-installed fonts The setup package contains a number of new true-type fonts for use in L-Vis and L-WEB projects. Have a look at the new choices in fonts\loytec and fonts\truetype. 2.3.4 More operations supporting undo...
Please review Section 9.5.11.1 for an update. 2.4.2 Modbus Support All L-Vis devices are now supporting Modbus. Both Master and Slave mode is supported. In addition to Modbus/TCP, which is supported on all devices and in parallel to all other communication interfaces, BACnet devices can also be configured to support Modbus/RTU instead of BACnet MS/TP on the RS485 interface.
L-Vis project. The button to navigate to one of the referencing objects can be used to move the selection in the object tree and the LCD preview to the corresponding object in the L-Vis project.
3.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.
L-VIS User Manual LOYTEC HTTP: This method uses web services to communicate with the device over a single port (usually port 80). The device must be running firmware 4.6.0 or newer. Since the same port and protocol is also used by the Web-UI, no additional setup in the firewalls of PCs or routers is necessary.
Page 26
3.2.2.2 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.
Page 27
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.
3.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 template.
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.
L-VIS User Manual LOYTEC 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.
L-VIS User Manual LOYTEC 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.
L-VIS User Manual LOYTEC 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.
3.3.8 Write the Project to the L-VIS device We are now ready to write the project to the L-VIS device, but first the project should be saved in a file on the PC. Although it is possible to read the project back from the device, it...
Reboot the device for the changes to take effect. 3.4.2 Start the L-VIS Configuration Software Run the installed L-VIS configuration software from the start menu of your desktop. Connect to the device by pressing the Connect button from the tool bar, or select the menu item Connect to the Device…...
BACnet Network Scan and select the item Scan BACnet Network…. Discover the devices on the network, select the L-VIS device, and scan it for objects. Close the scan dialog and use the two server objects found by the scanner to create corresponding client mappings.
L-VIS User Manual LOYTEC 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 9.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’...
3.4.7 Write the Project to the L-VIS device We are now ready to write the project to the L-VIS device, but first the project should be saved in a file on the PC. Although it is possible to read the project back from the device, it...
L-VIS User Manual LOYTEC Once the project file is written to the device, the L-VIS reboots and shows the tutorial project on the display. 3.4.8 Test the Project You should now be able to use the device to set the state and the value of the two server objects and immediately see the results on the client mapping input points, since they refer to the local server objects.
4.1 Dimensions and Mounting For information about unit installation, please refer to the installation sheet that came with your unit. This document is also available for download from the LOYTEC website. 4.2 Theft Protection To protect devices of type LVIS-3E100 and LVIS-ME200, they can be fixed to the wall mount frame with the supplied chain as shown in Figure 1.
5.1 Connection diagram For information about unit installation, please refer to the installation sheet that came with your unit. This document is also available for download from the LOYTEC website. 5.2 Electrical Characteristics LVIS-3E100/ME200 The electrical characteristics of the LVIS-3E100 and LVIS-ME200 devices are shown in Table 2.
L-VIS User Manual LOYTEC Characteristics Value Operating voltage 24 VDC ± 10%, or 90-265 VAC Power consumption 12 inch: 14W, 15 inch: 17W, idle: 3.5W In-rush current Up to 3.7A @ 24 VAC, max. 40ms Operating temperature (ambient) 10°C to +40°C Storage temperature -10°C to +50°C...
Page 42
L-VIS User Manual LOYTEC Characteristics Value 24 VDC ± 10%, or 90-265 VAC (except 7” models) Operating voltage Power consumption See Table 5 Operating temperature (ambient) 10°C to +40°C Storage temperature -10°C to +50°C Humidity (non-condensing) operating 10 to 90 % RH @ 50°C Humidity (non-condensing) storage 10 to 90 % RH @ 50°C...
L-VIS User Manual LOYTEC 5.5 Touch Panel Cleaning Instructions 5.5.1 Appropriate cleaning measures Normal dirt can be removed using a clean and soft cloth or chamois leather. When using water, only neutral wetting agents that do not contain any abrasive additives should be added to the water, for example: ...
Up to four external temperature sensors can be connected to the terminal labeled TEMP. Compatible temperature sensors are available from LOYTEC under the part number L-TEMP1. The temperature range of this electronic sensor specified as -55 to +125°C and the accuracy is +/-0.5°Celsius within the range from -10 to +85°C.
Page 45
L-VIS User Manual LOYTEC Status button Pressing the Status button sends out a service pin message on the IP- 852 or the FT-10/LPT-10 channel (CEA-709 models) or send out an ‘I Am’ message (BACnet models). To reset the device to factory defaults, hold the status button pressed while the unit boots and release the button within a few seconds when all interface LEDs light up orange.
5.8 Control Network Interfaces For details regarding the various supported control network interfaces, as well as special topics like redundant Ethernet cabling or WLAN setup, please refer to the Chapter Network Media in the LOYTEC Device User Manual. Version 6.2 LOYTEC electronics GmbH...
6 Interface Configuration 6.1 Selecting the Interface All L-Vis devices provide at least two different physical network interfaces. Depending on the model, number and type of the available interfaces may vary. There are two basic types of communication on these interfaces, which should be clearly distinguished: ...
Page 48
L-VIS User Manual LOYTEC Model Interface Task Protocol Setting Configuration FTP/HTTP Via Web-UI OPC XML-DA Via Web-UI 10/100Base-T Operation Modbus TCP Via Web-UI LVIS-3E100 CEA-852 Jumper SET Configuration CEA-709 Jumper OFF FT-10 Operation CEA-709 Jumper OFF Configuration FTP/HTTP Via Web-UI...
LOYTEC 6.2 Configuring the IP-852 interface Before the L-VIS device can be used on an IP-852 channel, the following things have to be configured in the setup menu of the device (see also section 7.3): CEA-709 Settings: If not controlled by the IP jumper, select the IP852 interface mode on the CEA-709 settings page.
L-VIS devices use a resistive touch screen. This type of screen can only detect one touch position at a time, that is, you cannot press two buttons at once. The screen delivers raw data which must be converted to LCD pixel positions before it can be used;...
L-VIS User Manual LOYTEC The simple and intuitive touch operation is used to select menus, select controls and enter data on the input keypad. This is straight forward. A short touch on a control will also trigger touch, release, short press, and selection actions connected to it.
LOYTEC 7.2 Data Input As shown in the tutorial, L-VIS uses configurable control elements to display and input data. Whether a control is selectable for data input depends on the data points connected to it as well as on the current access level of the user: ...
L-VIS User Manual LOYTEC Alarm Acknowledge: The alarm list control may draw a push button next to an alarm entry if the alarm is to be acknowledged. Pressing the button will send the acknowledgement to the alarm server and change the color of the button. Once the server received the acknowledgment, the button or the entire alarm entry may disappear from the list.
L-VIS User Manual LOYTEC touch position and stay aligned with it, or remain at its current angle and move only relative to the movement of the touch position, to avoid sudden value changes. This happens when the option Input by knob rotation only is set.
Page 55
L-VIS User Manual LOYTEC NOTE: The update mode used by schedule controls is fixed to Focus Loss, meaning that the new schedule configuration will be written to the scheduler only at the time the control leaves edit mode. This avoids intermediate updates while the user is still modifying the schedule, which could result in temporarily inconsistent configurations.
Page 56
L-VIS User Manual LOYTEC current values of the preset. If the value preset consists of multiple individual values, each value is shown on a separate line with the value name to the left and the current value to the right. Touch the value to open the keypad and enter a new value. When done, close the window by touching the close symbol in the top right corner of the window.
L-VIS User Manual LOYTEC 7.2.2.12 Edit Exception Days To change the days on which a certain exception schedule is active, select the exception day in the left column and touch the headline of the time table to open a dropdown menu.
Page 58
L-VIS User Manual LOYTEC following information: The time at which the preset becomes active, the time until this preset stays active, and the name of the scheduled preset. Event List: This page shows a list of all events applicable to a selected day. Note that this list does not exactly represent the presets that will be in effect on that day.
L-VIS User Manual LOYTEC arrow). The pen button opens the event list for the selected day, the button with the arrow pointing to the top left goes back to the weekly overview. The information shown on this page represents the sequence of preset values which will be scheduled on that day as a result of individual events that are applicable.
Page 60
L-VIS User Manual LOYTEC event and to navigate back to the previous page are available. The page can be reached directly from the weekly overview by pressing the edit button. 7.2.3.5 Event Editor To modify existing events and add new events, a separate editor window is opened in front of the scheduler.
Page 61
L-VIS User Manual LOYTEC NOTE: If applicable, a default button will be shown. This button can be used to easily set the correct definitions for a default background event, which is scheduled at the lowest priority on every day. It is normally used to control the outputs of the scheduler whenever no other event applies.
L-VIS User Manual LOYTEC NOTE: To make sure that the capacity for events in local CEA709 schedules is high enough, set the maximum number of daily schedules in the network settings dialog to a high value when using the extended UI mode. This number defines the maximum number of events which can be stored in the CEA709 LonMark scheduler unit, since each event will consume one entry in the table of daily schedules.
Storage: This page is available on devices which support external data storage like USB and SD card memory. The buttons on this page can be used to save and restore device backups, L-Vis project files, and to write current trend log data to the external memory. See section 15.8 for details.
L-VIS User Manual LOYTEC NOTE: The key is displayed as 8 groups of 4-digit hex values, which is a common representation of MD5 key values. The order to read the key is from left to right and top to bottom.
The following sections describe the object tree and the LCD preview in more detail. 8.2 Object Tree The object tree shows all objects which are part of the L-Vis project. The top level contains three nodes. A root menu, a folder for objects which are not visible and not related to any of the menu items or pages below the root menu, and a folder to organize template pages which are then instantiated on pages below the root menu.
L-VIS User Manual LOYTEC Left click an object: The object is selected. All previously selected objects are deselected. If the selected object is a child object of a control, the page on which the control is located will be shown and the control will be marked in the LCD preview.
L-VIS User Manual LOYTEC In many cases, there will be a number of different selectable objects at the same position, so one of them has to be picked as the primary selection candidate. This is done by the following rules: ...
L-VIS User Manual LOYTEC Click and hold the mouse button a short distance away from the objects you want to select. This will start a new selection box if there are no selectable objects at this location. In case there is a possible selection candidate at the desired starting point of the box, hold down the key s to disable normal selection and instead force a selection box to be started.
L-VIS User Manual LOYTEC NOTE: While it is possible to lock objects via the context menu in the LCD preview, it will be necessary to unlock them in the tree view, since they will no longer be selectable in the LCD view once they are locked.
L-VIS User Manual LOYTEC 8.3.6.1 Adaptive Snap Strength The snap effect will be stronger at positions where many already aligned edges are located, or where there are long edges, compared to areas with fewer edges. All edges of the moving object are evaluated individually for their best position.
L-VIS User Manual LOYTEC Ctrl + Left Button: Pan in all directions (move the mouse). Ctrl + Mouse Wheel: Zoom in and out, centered on the current position of the mouse cursor. Place the cursor at the location of interest, then zoom in.
L-VIS User Manual LOYTEC Right button inside active area: Open the context menu for more operations regarding the selected object. NOTE: Keep the cursor key pressed to make larger changes to the object. For each press and release of the cursor key, an undo step will be recorded. Pressing and holding the cursor key for a while will assign the entire movement to one undo step, which is easier to undo.
L-VIS User Manual LOYTEC Include Path: If this option is checked, the search pattern is not only applied to the object name but the entire object path (the location within the project) is searched. Match Case: This option causes the search pattern to be case sensitive.
It is therefore suggested to first upgrade the configuration software and then upgrade the devices. The firmware of the L-VIS device can be upgraded as newer firmware versions become available. To find the current firmware version of your device, use the Device Info… menu item in the View menu, which will be enabled when the software is connected to a device or go to the About Page on your device.
Context menus are an important part of the workflow, since most operations related to the objects of the L-VIS project are accessible from the context menu of the object in question. The context menu is usually opened using a right mouse button click on the desired object in the tree view, but for objects visible in the LCD preview, the same context menu may also be opened by a right mouse button click on the preview of the desired object.
L-VIS User Manual LOYTEC If the copy is pasted into a different project, the referenced data sources may not be available at all. In this case, the required data sources are automatically created in the destination project, so that the references may be resolved. For example, it is possible to copy a page which operates on register data only, into a completely different project and the page will function the same way it did in the original project.
L-VIS User Manual LOYTEC NOTE: The XML export and import functions are intended to be used for custom tools which may be able to build a complete project (in XML format) out of basic building blocks, which were prepared and exported to XML fragments. Based on information in a network...
Page 78
L-VIS User Manual LOYTEC 8.5.5.2 Rename Data Source This operation allows batch renaming of data sources (the actual register, NV, or server object name). All data sources which are mentioned in the selected entries will be considered for renaming. If a particular source is actually renamed depends on the given naming rules, as described in the previous section.
L-VIS User Manual LOYTEC 8.5.5.7 Remove Data Point This operation removes the selected data point objects from the project. It is useful to remove a number of data point objects in one step, instead of going through the object tree in the tree view and removing each data point individually.
L-VIS User Manual LOYTEC 8.5.11 Add Pages from Data Points Similar to the above command, but available for menu items. In this mode, the selected data point folder will be scanned for data points and pages will be created to visualize them. If there are sub folders present, a new sub menu will be created to hold the menu items for the data point sub folders, similar to the operation above (add items from data points).
L-VIS User Manual LOYTEC NOTE: It is important which of the controls you select first. The control which was selected first will act as the reference for the layout functions, as explained below. Once the controls were selected, execute the desired layout functions by pressing the buttons in the tool bar or using the commands from the Layout menu of the main window.
L-VIS User Manual LOYTEC Below the image tiles is a group of buttons to manipulate the selected images or load new images. The following functions are available: Add: Opens a file dialog to select and load a new image. Another option to add new images is to just drop the file anywhere inside the image manager window.
L-VIS User Manual LOYTEC line-art graphics, which contain large areas of uniform color. In such areas, dithering to the exact color would not look as good as just picking one color from the VGA palette which is closest to the intended color. If this is required, it is best to design the graphics using the VGA palette and saving them in 256-color indexed format, like for example 8-bit BMP or GIF.
Unsupported files are hidden, for example Visio, Corel-Draw, or Auto-CAD proprietary vector drawing files, which cannot be imported directly. Use the programs export function to save the image in SVG or PNG format for use in the L-Vis project. 8.8 Fonts Every device has a set of three basic fonts which cover the ISO-8859-1 (Latin-1) code set in three different sizes.
Page 85
(only containing the characters currently in use). This is useful for the small L-Vis devices, which use prebuilt and optimized versions of the fonts. Large devices usually read the original font source file, so the reduced size has no meaning in this case.
Big5, IBM, or Microsoft code pages (for example MS-CP1250). If such a font is loaded, it is automatically recoded to UCS-2 before it is used, since the L-VIS device itself does not recognize encodings other than UCS-2. The font recoding is done using the coding tables found in the directory Encodings, located in the program directory.
L-VIS User Manual LOYTEC projects with recurring graphical elements, like room automation, the effort for creating the project is considerably reduced. References to data points used by the template can be variable, such that each instance can automatically work on a different set of data without any extra work to re-route the data point references manually.
L-VIS User Manual LOYTEC 8.10.5 Improved Structure As shown in the above section, the use of templates can greatly enhance the structure and therefore maintainability of a project. It guarantees that the project follows certain standards, no matter who is building the top level project based on the templates from a ready-made library.
L-VIS User Manual LOYTEC bar wider, so that the user may easily grab and drag it with the index finger. The default width of the scroll bar is designed to look good for menus which do not need a scroll bar.
L-VIS User Manual LOYTEC works, and so on. This can be used to store the projects documentation together with the project, improving reusability and maintainability, in case the project is taken over by another person later on. The object description is shown in a tool tip when hovering over the item in the object tree.
Page 92
L-VIS User Manual LOYTEC Object Type Usage of the Text field Menu Directly used for the menu title. Menu Item Directly used for the menu item text. Format string which may contain one %s placeholder, which will be replaced by a string taken from a mapping table or a connected string data point.
Page 93
L-VIS User Manual LOYTEC according to the elements in the mapping table. The checkbox may be turned off for some controls to prevent automatic resizing and set the desired size manually. Resizing a control manually in the LCD preview or by changing the width and height properties automatically turns off the Auto-Resize option.
L-VIS User Manual LOYTEC specified here, otherwise the user will see the control but will not be able to select it and input new data. Simple controls like text, numbers, bitmaps, and vector controls can also be rotated and flipped in X and Y direction using the options on this page. Note that this will affect the entire control.
Page 95
L-VIS User Manual LOYTEC NOTE: If the device firmware is older than 4.2.0, all color settings done on this page will be limited to the 256 color VGA palette, even for RGB capable devices. Starting with firmware 4.2.0 on RGB devices, colors can be selected from a new RGB color selection dialog which also includes an input field to set the transparency of the color.
9 Object Description 9.1 Introduction Every L-VIS project is built using a number of different objects. Each of the objects has a relatively simple function. To build a complex project, the simple objects are put together and organized in an object tree, which is shown in the tree view of the configuration software.
L-VIS User Manual LOYTEC 9.2 Menu A menu object is used to manage a collection of menu item objects. On the device, a menu is a window which opens on the left side of the display and shows the items which are contained in the menu.
L-VIS User Manual LOYTEC Each item object can hold zero or more page objects and zero or one menu object, as shown in the object hierarchy diagram. It depends on the connected objects, what will happen when the user selects the menu item.
L-VIS User Manual LOYTEC 9.4 Page Page objects are simple objects to organize the control elements which are visible on the device. When a page object is connected to a menu item and the item is selected from the menu, the page and all the controls on it will be shown on the display. Previously visible controls will be hidden, but will continue to exist on the device (so that a trend control may continue to record data, for example).
L-VIS User Manual LOYTEC 9.5 Controls All objects which can be displayed on a page are called controls. This is because they are usually used to provide to user with an interface to control a data point value or trigger actions.
L-VIS User Manual LOYTEC URL: If the contents have the form of a URL, like http://www.host.com, the specified URL will be followed and displayed in a browser window of the size and position given by the text control. ...
L-VIS User Manual LOYTEC controls. Push button mode is activated on the Text / Bitmap / Drawing property page using the Enable Push Button Mode check box. Once enabled, the mode of operation is selected on the right via three radio buttons. The options are: ...
Page 103
L-VIS User Manual LOYTEC Value Range: The values entered in these two fields (min –max) define the limits for input of new values. The user cannot input any value below min or above max. Values received from input data points are always displayed, even if they are outside the allowed input value range.
Page 104
L-VIS User Manual LOYTEC Percent: The given value is interpreted as a factor and shown in percent. The value itself will normally be between 0 (0%) and 1 (100%), but other values are of course possible and displayed accordingly (1.5 = 150%, -0.3 = -30%).
Page 105
L-VIS User Manual LOYTEC Specify significant digits: This option toggles between definition of integer and fractional digits, and definition of the range of significant digits. Defining a minimum number of desired integer digits and a fixed number of fractional digits leads to an output where the decimal point is always at the same location.
L-VIS User Manual LOYTEC Left Justified: This option causes padding characters to be inserted to the right of the converted number, so that the number appears left justified within the specified field width. The option has no effect if the field width is equal to or smaller than the space occupied by the converted value.
Page 107
L-VIS User Manual LOYTEC Frame: The actual bar which displays the current value has a one pixel wide frame around it. Bar: Inside the frame is the bar which actually shows the current value. With increasing values, the bar moves up or to the right.
Page 108
L-VIS User Manual LOYTEC NOTE: Set the desired value range, before you determine size and position of the bar, especially if tick marks and/or a scale will be drawn. This is important since the scale which best fits the current size will be determined and drawn as you resize the control. Depending on the value range, the space requirement of the scale and the optimum size of the bar will vary.
L-VIS User Manual LOYTEC going up and down. If you switch color assignments, you can use the moving bar to selectively uncover parts of the background. Example 2: In front of the above window showing the moving sunblind, a completely transparent bar control may be placed (both bar color and container color are set to the transparent background and drawing of the bar can be disabled using the ‘Invisible Bar’...
Page 110
L-VIS User Manual LOYTEC 9.5.6.1 Internal Trends Whenever a normal data point is connected to the trend control, the control itself will record the data received from the data point and store it in the file system when the option Preserve Data is set.
Page 111
L-VIS User Manual LOYTEC Color Name Element to which the color applies Labels Numbers of the value scale and the time scale. Horizontal Grid Horizontal grid lines (if the grid is enabled). Vertical Grid Vertical primary grid lines (if the grid is enabled).
Page 112
L-VIS User Manual LOYTEC Scale Labels: Enables drawing of scale labels. Note that scale labels should always be enabled for controls which have the Y-Scaling option set. On the right side, the Time Axis is configured. Note that some of these options only apply for data points trended locally by the control while other options apply also for display of external trend data.
Page 113
L-VIS User Manual LOYTEC At the bottom left of the property page, it is possible to set options regarding the individual data points connected to the control. Select the desired data point first to activate these options. For the Mode setting, the following options are possible: ...
Page 114
L-VIS User Manual LOYTEC the tick mark spacing is compatible to the spacing on the primary axis and matches the position of the horizontal grid lines. NOTE: Even if the preserve data flag is set, a trend control may still discard the stored data when it reboots.
Page 115
L-VIS User Manual LOYTEC NOTE: Assign good names to your trend control objects, to make it easy to identify the data files and relate them to the trends which are visible on the device. Consider to add the name of each trend to the page where the trend is shown, so that the user is able to clearly identify each control and its data file.
L-VIS User Manual LOYTEC NOTE: The values shown in the cursor box are always the most recent known values at the cursor position as recorded in the trend log. Changing the interpolation mode changes the way the trend curve is drawn, based on the available data records, but it does not change the values displayed in the cursor box.
Page 117
L-VIS User Manual LOYTEC A font for text mode can be selected on the Common Properties page. All other settings can be done on the Date/Time Control property page. The basic configuration is done in the Options section. The first option is a style selector, offering the following styles: ...
Page 118
L-VIS User Manual LOYTEC data point updates are only used to synchronize the time displayed on the control with the time received from the data point and do not have any direct influence on the controls update rate. The last option is actually related to the selected date pattern in a locale aware control and is discussed in the appropriate section below.
Page 119
L-VIS User Manual LOYTEC 9.5.7.2 Available Pattern Fields On the left side of the property page is the list of available date pattern fields to choose from. Since some of these fields are only available for the auto formatter and others only for raw date patterns, set the desired mode first before adding fields to the pattern.
Page 120
L-VIS User Manual LOYTEC Day of Week in Month: Day of week in month (numeric), indicates the n occurrence of the current weekday in the current month, as in 2 Wednesday in July, or 3 Monday in December. Pattern symbol F.
Page 121
L-VIS User Manual LOYTEC When used in conjunction with a year number, make sure to use Year in “Week of Year” instead of the standard calendar year. Pattern symbol w. Cyclic Year Name: Calendars such as the Chinese lunar calendar (and related calendars) and the Hindu calendars use 60-year cycles of year names.
L-VIS User Manual LOYTEC Use the buttons next to the field with selector to add and remove fields and move the selected field to a different position in the list. Note that the field position is not relevant when the auto-formatter is used, as the list only specifies which date components the formatted output should contain.
Please see section 7.2.1 for details about operating a schedule control in standard mode on the running L-VIS device. 9.5.9.2 Extended Mode In extended mode, the control provides a calendar and event based view of the schedule data.
Page 124
In this mode, it is therefore possible to use the smallest built-in font to save space on the screen and enable the user to see as much information as possible, especially on the smaller L-Vis devices. 9.5.9.4 Schedule Control Properties The properties to set on the Schedule Control property page define the basic appearance of the control and control access to various operations which modify configuration data.
Page 125
L-VIS User Manual LOYTEC be enough space and the effective period must either be disabled or shown on a separate line. Enable extended user interface: This option is available if the device firmware is 4.2.0 or newer and there is only one data point connected to the control.
Page 126
L-VIS User Manual LOYTEC from (weekly/low/normal/high). The mapping is optimized to work together with schedules generated by LWEB-900, which also uses distinct priority levels for the entered events. Even in a standalone system, it may make sense to use this option to make the UI easier to read for users which are not familiar with the numerical priority scheme of the underlying network technology.
Page 127
L-VIS User Manual LOYTEC When the option ‘Use event colors for value’ is enabled, the three available event colors are assigned to the available value presets in a round robin fashion. The first value will use event color 1, the second value will use event color 2, and the third value is drawn in event color 3.
L-VIS User Manual LOYTEC Change effective period: This operation allows the user to change the effective period of the schedule, thereby enabling and disabling not only single days but the entire scheduler unit. Edit day patterns of exception days: This operation allows write access to the contents of the calendar which is connected to the scheduler unit.
Page 129
L-VIS User Manual LOYTEC US date format: This option selects the US date format, which uses the order month, day, and year, separated by slashes (MM/DD/YYYY). Read only (no ACK buttons): This option, when checked, instructs the control never to show ACK buttons.
L-VIS User Manual LOYTEC NOTE: If an action object is connected to the alarm list control and the action trigger is set to ‘value update’, the action will be executed whenever a new entry is added to the alarm list.
Page 131
L-VIS User Manual LOYTEC Filled: Available for rectangles, circles, and polygon drawings, defines that the object should be filled with the color specified as the container color, rather than the background color. To draw a frame only, leave this option unchecked and make sure the transparent background option on the Color property page is checked.
L-VIS User Manual LOYTEC While in drawing mode, the control occupies the entire screen. New lines or points may therefore be drawn anywhere on the page. Start and end points of lines or line segments are indicated by small squares, to make it easier to find and operate on these control points.
Page 133
L-VIS User Manual LOYTEC On the Common Properties page, a font may be selected to be used for the scale labels. Similar to other controls, color configuration is done on the Color property page. The following colors are supported by analog meter controls:...
L-VIS User Manual LOYTEC Needle Cover Size: Diameter of the small round cap covering the needle base. Can be set to 0 to disable the needle cover. Tick Length: Length of the tick marks in pixel. Can be set to 0 to disable tick marks (same as disabling the tick mark option in the basic setup).
L-VIS User Manual LOYTEC and labels is transparent. This way, the backlight can illuminate ticks, labels, as well as any other cut-outs. Rotating Knob: On top of the faceplate, the rotating knob is drawn. There are various ways to draw the knob, ranging from none at all (already part of the faceplate image), a knob image, or a predefined knob available in different styles like brushed metal or a plastic-like knob with selectable color.
Page 136
L-VIS User Manual LOYTEC A control with a fully opaque knob, with no LED cut-outs inside the knob may have the knob background color unset, as it will never be visible. In conjunction with the indented style, choosing a half transparent mid-grey as the indicator fill color creates an overlay effect, where the software drawn indicator blends nicely with the underlying knob image.
Page 137
L-VIS User Manual LOYTEC Show Labels: Draw labels onto the faceplate. Turn off when using a faceplate image which already contains labels or when no labels are desired. Note that if the label area of a faceplate image should be usable for input, a font of similar size than the one used on the faceplate image must be selected, such that the control can determine the outer boundary of the labels on the faceplate image.
Page 138
L-VIS User Manual LOYTEC Static: A fixed band ranging from range start to range end. Band Left: Backlight from range start, up to the current knob position. Band Middle: Backlight from Midpoint to the current knob position.
Page 139
L-VIS User Manual LOYTEC 9.5.13.6 LEDs This line defines cut-outs for the backlight which can be added to the faceplate, such that the backlight can shine through them. This option can be used with the software drawn faceplate as well as image faceplates, in case they do not provide the necessary cut-outs.
L-VIS User Manual LOYTEC 9.5.13.8 Input There is currently one option affecting the way the knob behaves during data input: Input by knob rotation only: This option prevents the knob from aligning its position with the touch point when input mode is entered (see also Section 7.2.1 about knob control data input).
Page 141
URL. Even though the LWEB client can usually detect the media type automatically, playback will start faster if the media type is already known. For L-Vis devices, this option has no effect. Media type is always detected automatically without any additional delay.
Page 142
L-VIS User Manual LOYTEC [user:password] : Credentials used for authentication. If specified, a character separates the credentials from the camera address. <address>: IP address or DNS name of the camera. [/path] : Additional path component, used to specify the type of video stream to access.
L-VIS User Manual LOYTEC playback started, or the connection attempt resulted in an error which is shown in the control. This will ensure that the output data points will accurately reflect what the user currently sees on the display. NOTE: Using run time control is optional.
It is important to understand this concept to understand what can be configured on the Data Point property page of L-Vis data point objects. The key is that there can and usually will be multiple data point objects in the L-Vis object tree, referencing the same data point in the data point configuration.
Page 145
L-VIS User Manual LOYTEC NOTE: The value translation of a data point can be very useful to modify a value on its way between a data processing object and a register or network value. Using this facility, simple data manipulation like the inversion of a state or the addition or subtraction of a fixed offset can be archived without using a separate math object.
Page 146
L-VIS User Manual LOYTEC Reverse Direction: This option inverts the data direction of the data point object to be the opposite of the referenced data point, for example, the value of an output NV may be used as input for a math object or a trigger or may be trended by a trend log control.
L-VIS User Manual LOYTEC MinSend: At least the specified amount of time has to pass between two successive update messages on the network. If the device delivers mode updates than this, intermediate values will not be sent out, until the minimum send time has passed, at which time the current (most recent) value is sent out.
L-VIS User Manual LOYTEC NOTE: The system startup update flag can be controlled separately for input and output direction, but it cannot be enabled or disabled individually for each data point reference in the project. Also note that making a data point persistent may cause an initial value update with the stored value after system boot up, regardless of the system startup update flag.
L-VIS User Manual LOYTEC A mapping table can include text, bitmaps and colors at the same time. If connected to a text control, the text part will be shown together with the color settings. When the same mapping object is connected to a bitmap control, the bitmap will be shown. Number and bar controls use the color setting only.
L-VIS User Manual LOYTEC Entry button to calculate a color gradient from the color of the first entry in the selected range up to the color of the last entry in the selected range. NOTE: The gradient function will operate on the alpha channel in the same way as for the normal color value, so that on devices which support ARGB color mode, this function can be used to generate gradients from opaque to transparent.
L-VIS User Manual LOYTEC 9.9 Action Objects Action objects are used to execute various actions on special occasions. As such, they are often connected to controls, to trigger an action when the user touches, releases, or selects a control. In some cases, they are connected to data point connector objects, to watch incoming data point values and trigger an action when a certain value is received.
Page 152
L-VIS User Manual LOYTEC Sound buzzer: Output a tone on the internal buzzer. The frequency and duration of the tone can be adjusted in the Options section. Useful to create audible alarms when a data point or register reaches a certain value.
Page 153
L-VIS User Manual LOYTEC NOTE: The action update data points can also be used to increment or decrement the value of a register or of a network output / feedback input pair, which is required to implement up/down buttons to dim light or modify a temperature set point. To do this, connect the register read point (or the network feedback point) as well as the register write point (or network output point) to the action.
Page 154
L-VIS User Manual LOYTEC NOTE: The trigger of touch and release actions while moving the touch position around between controls (without releasing the touch screen) is consistent with the display of the selection frame. Moving from one control to another without releasing the touch screen will cause the selection frame to follow the movement, always marking the control which is currently touched.
Page 155
L-VIS User Manual LOYTEC While touched: The action is executed as long as the parent object is being touched. As above, observe that this condition must be satisfied at the time the action trigger fires, or the action will not be executed. In practice, this means that the condition ‘while touched’...
L-VIS User Manual LOYTEC Autoplace: The popup is placed near the button which triggered the action, but not overlapping the button if possible. Auto-Close: To use with any of the placement options, causes the popup to be closed automatically after the user did not touch the screen for the amount of time after which popups should be closed automatically (including popup menus).
L-VIS User Manual LOYTEC o $D Similar to $U but moves down to the next sibling. o $M1 Moves to the sub-menu of the current menu item. This token is currently only meaningful on menu items, since only they can have a sub-menu.
L-VIS User Manual LOYTEC to function together on the same page. This way, the page continues to work when it is copied or moved to another project, because the required invisible objects are copied together with the page. The base collection outside of the main menu should only hold objects which are related to the device, rather than specific page functionality.
Boolean value may be translated into any two values, one to signal ‘alarm clear’ and one for ‘alarm set’. This is most useful if the generated alarm is to be processed further or displayed on the L-VIS device, for example to trigger actions or display warning messages.
L-VIS User Manual LOYTEC 9.11.1 Alarm Generator Properties Once all inputs and the output are connected, the alarm generator may be configured on the Alarm Generator property page. For each of the connected inputs, an independent set of parameters is required. The available input points are listed in the top left area of the property page.
Page 161
L-VIS User Manual LOYTEC turn it back on until the device significantly cooled down, to avoid constant ON/OFF cycles. Such an application can be done by connecting the temperature data point two times. To distinguish between them, append SET to the name of the first data point and CLEAR to the name of the second data point (on the General property page).
L-VIS User Manual LOYTEC 0.5 would be a good value. For the Action, select Set on Alarm Enter and select the desired output value for a cleared alarm from the dropdown list named Value for Alarm Set Action. This is because we actually define an alarm condition when the button is pressed. As a result of this alarm condition, we then reset the ‘real’...
L-VIS User Manual LOYTEC NOTE: Math objects are often used as standalone objects, reading from the connected inputs and writing the result back to a connected output. Such math objects are organized in folders, either below the global object folder or within a folder located on a page. However, math objects can also be used in place of input data points.
L-VIS User Manual LOYTEC on the stack and be the only value on the stack, since all other values were used as input to the function. This behavior causes some limits in how these functions may be used. You are on the safe...
Page 165
L-VIS User Manual LOYTEC Function Return Value add(v1,v2) v1 + v2 sub(v1,v2) v1 - v2 mul(v1,v2) v1 * v2 div(v,d) v / d Returns the remainder of dividing v by m, where v and m should be integer mod(v,m) values. Fractional values will be rounded to the nearest integer automatically max(v1,...)
L-VIS User Manual LOYTEC Function Return Value Returns the inverse hyperbolic sine of v1; that is the value whose hyperbolic asinh(v1) sine is v1 Returns the inverse hyperbolic cosine of v1; that is the value whose acosh(v1) hyperbolic cosine is v1 Returns the inverse hyperbolic tangent of v1;...
Page 167
L-VIS User Manual LOYTEC Show on Top: Makes the control visible and places it in front of any other controls on the screen, overruling the Z-order defined in the project. Start blinking: Turns on an automatic blink function. Depending on the Options on the right side, the control starts to blink at a slow or fast speed.
L-VIS User Manual LOYTEC Updates resulting in a condition CHANGE: This mode fires the trigger every time the result of the trigger condition changes, from TRUE to FALSE or vice versa. Subsequent updates which lead to the same result do not repeatedly fire the trigger, as opposed to the above modes.
L-VIS User Manual LOYTEC data points. The way to make this possible is to distinguish between fixed data points which will be the same for every instance of the template, and variable data points which will be replaced by different data points for every instance.
L-VIS User Manual LOYTEC instance object. This can also be used to switch a template instance from one template to another. To create instances of multiple templates in one step, place the related templates in a template folder, drag the entire folder, and drop it on the page where the instances should be created.
L-VIS User Manual LOYTEC Starting with version 6.1 of the configuration software, these situations are handled automatically to avoid broken templates and instances. Renaming a data point folder will automatically adjust all affected base paths to use the new name, such that the change has no negative effect on existing templates and instances.
L-VIS User Manual LOYTEC A $ sign, followed by the number of the base path of the parent template which was chosen as the basis for the relative path ($1 to $4), followed by the actual path (in parenthesis) which is currently set at this location. Since a template may have up to four different base paths, it is necessary to know to which one of them the sub template path is relative.
L-VIS User Manual LOYTEC there are a few other things which may need to be modified, for example colors or text for headlines. While many aspects of the instance will be controlled by the referenced data points and the actually used data points will vary from instance to instance, it is not always feasible to control everything just via data points.
L-VIS User Manual LOYTEC Now the text color is changed to blue in the instance of A. This change is stored together with the instance of A, so the pen symbol now also appears on the tree icon of instance A.
Page 175
L-VIS User Manual LOYTEC tags are not supported in mapping table entries. The placeholder must appear directly in the text field of the text control. Show Page Action: The show page action, when used with a relative path to the target page, accepts placeholder tags in the path string.
Working with data points is the same for the entire line of LOYTEC products. This chapter explains the use of the data point system on which L-Vis projects are built. 10.1 Data Points 10.1.1 Overview Data points are part of the fundamental device concept to model process data.
L-VIS User Manual LOYTEC Binary: A binary data point contains a Boolean value. Meta-data for binary data points includes human-readable labels for the Boolean states (i.e., active and inactive texts). Multi-state: A multi-state data point represents a discrete set of states. The associated data type is a signed integer machine variable.
L-VIS User Manual LOYTEC 10.1.4 Persistency Data point values are by default not persistent. This means that their value is lost after a power-on reset. There exist different strategies for initializing data points with an appropriate value after the device has started.
LOYTEC NOTE: A notification received by the L-Vis application from a data point may trigger execution of actions or commands like visibility or color changes, or it may result in a recalculation of a formula and cause a new notification about the changed result to be sent.
L-VIS User Manual LOYTEC choose to generate one data point of direction value instead of two separate data points. This data point can be read and written, so the desired direction will have to be specified at each place the data point is used, whereas it is implicitly known with separate data points.
Page 181
L-VIS User Manual LOYTEC The following properties are available as property relations: feedbackValue: This property relation is used for feedback alarm conditions. The data point value is compared against the feedback value. An alarm is generated, if these values differ (by a certain amount). It exists only, if an alarm condition has been created.
L-VIS User Manual LOYTEC 10.1.11 Engineering Units Analog data points have an engineering unit property that defines the physical unit of the underlying scalar value. The engineering unit is displayed to the user as a human-readable text which can be selected from a drop down list of available units. Once a valid engineering unit was selected, a green checkmark appears .
L-VIS User Manual LOYTEC Binary/Multi-state to Analog: The Boolean or state value is directly converted to an analog value (e.g. state ID ‘4’ is written as ‘4.0’) as a default. The user should specify an adapter to map the Boolean or state value to designated analog values.
L-VIS User Manual LOYTEC has a slot for each input and output, which can be connected to the respective data points as depicted in Figure 5 (b). For this multi-slot connection the math block adapter defines a fixed layout of the slots; no more slots can be added to this connection.
L-VIS User Manual LOYTEC How a global connection is created and configured is described in Section 10.8.5. Note that the number of configurable global connections on a device is limited (see Section 15.10). 10.3 AST Features 10.3.1 Alarming The alarming architecture comprises a number of entities. Objects that monitor values of data points and generate alarms depending on an alarm condition are called alarm sources.
L-VIS User Manual LOYTEC Alarmed data points also possess other property relations. The ‘enableAlarm’ property relation can be used to disable or enable alarm conditions when linked to a data point. The property relations ‘highLimit’, ‘lowLimit’, ‘deadband’ can be used to modify analog alarm conditions.
Page 187
L-VIS User Manual LOYTEC Daily: This event occurs every day, starting at a given date and ending at a given date. Weekly: This event occurs every week on the specified weekday. Monthly: This event occurs every month following a date range or a defined rule (e.g.
L-VIS User Manual LOYTEC A date range: This defines a range. Starting with a start date and ending with the end date. No wildcards should be used. A Week-and-Day definition: This defines dates based on a week, such as every 1st Friday in a month, every Monday, every last Wednesday of a month.
L-VIS User Manual LOYTEC 10.3.4 E-mail The e-mail function can be combined with the other AST features. The format of an e-mail is defined through e-mail templates. An e-mail template defines the recipients, the e-mail text, value parameters inserted into the text and triggers, which invoke the transmission of an e-mail.
L-VIS User Manual LOYTEC Figure 8: Example historic filters for daily consumption. For calculating the difference between the current value and any historic value, the filter definition can be configured to delta mode. This is a shortcut to creating a math object processing the historic filter data point and the underlying data point.
L-VIS User Manual LOYTEC Based on the NV the data point is derived from, the following kinds of data points are created: Simple NVs that hold only one scalar value, e.g., SNVT_amp: Those kinds on NVs are represented as analog data points. The data points holds the current value, NV scaling factors are applied.
L-VIS User Manual LOYTEC 10.4.5 Dynamic Polling in CEA-709 External input NVs in CEA-709 rely on polling. Static polling can be configured by setting the poll cycle (see Section 10.1.2). In addition, this technology also supports dynamic polling. When dynamic polling is enabled, polling is only active for those NVs for which an external OPC client, the current page displayed on the LCD screen, or the current page displayed on the web interface requires a refresh.
L-VIS User Manual LOYTEC The direction of BACnet server objects deserves a closer look. The direction specified for data points in the configuration software always refers to the network view of the communication. The definition of input and output objects in BACnet, however, refers to the process view, which is opposite to the network.
L-VIS User Manual LOYTEC underlying BACnet objects are enabled. Alarm conditions can be specified for analog input, output, value objects (AI, AO, AV), for binary input, value objects (BI, BV), and for multi- state input, value objects (MSI, MSV). Alarm servers in the BACnet technology are mapped to BACnet Notification Class (NC) objects.
Data points in the import folder are not stored on the L-VIS device when the project is downloaded. They represent data points which are available on remote devices and are shown here as templates to create suitable data points for use on the L-VIS device (see section 10.16.4 for details).
Page 196
Alarm: This folder contains generic alarm servers. These provide technology- independent alarms. Any data point can be alarmed using a generic alarm server but the alarms are only accessible to the local L-Vis or to remote devices via OPC. ...
ID by which this data point may be referenced. Also shown is the number of times this object is currently referenced from the main object tree (the L-VIS project). Only data points which are currently unused (the Use column shows 0) may be removed from the list.
Some of the colors are only used in selection mode, when the data point window was opened to select a data point to connect to an L-Vis object. The complete color coding is described in Table 29.
Page 199
Use Linear Scaling: If this property is enabled, the analog values are pre-scaled from the technology to the data point. This scaling is in addition to any technology-specific scaling factors and any scaling done by the L-Vis data point objects referencing this data point. If enabled, the properties Custom Scaling Factor and Custom Scaling Offset accept the scaling factors.
L-VIS User Manual LOYTEC Direction: This is the data point direction. Use input, output or value as directions. Unit: For analog data points, this property contains the definition of an engineering unit of the scalar value. A human-readable text for the engineering unit is displayed and can be selected from a list of known units.
L-VIS User Manual LOYTEC CEA-709 Mapping Information: This information is derived from the SNVT. It defines how the NV contents are mapped to the data point. NV Scaling A, B, C: These are the scaling factors known from the SNVT table.
L-VIS User Manual LOYTEC analog data point, the server object type analog input, analog output, or analog value can be chosen. Commandable: This property defines if the underlying BACnet server object is commandable. For BACnet value objects (AV, BV, MV) this property can be edited to create commandable or non-commandable BACnet value objects.
L-VIS User Manual LOYTEC Modbus Device Address: This property defines the address of the Modbus slave device which contains the Modbus data point. Modbus IP Address: This property is available for Modbus/TCP master only. It specifies the IP address of the Modbus slave device, which contains the Modus data point.
L-VIS User Manual LOYTEC 10.6.8 Multistate Maps Multistate data points have a descriptive set of state texts for their state IDs. To manage those state IDs and state texts among many multistate data points, they refer to multistate maps. Some technologies have a fixed set of such multistate maps others have freely configurable multistate maps (e.g, user registers).
L-VIS User Manual LOYTEC Manage Relations tab in the property view area of the data point manager provides a fast solution. The data point tree is replicated in that tab as shown in Figure 13. Select a folder and optionally click on the button to include property relations of data points in sub- folders.
Like Selected to get a list of all similar data point references. 10.7 OPC Device Manager L-Vis devices support the OPC XML-DA standard for communication with compatible OPC server implementations, for example LINX devices or an LWEB-900 server running on a PC.
Note that once the data points have been deleted, there is no easy way to restore them in a way that references from L-Vis objects to these data points will work again. Even after adding the same device again, the new data points will have different UIDs and all references to the old data points will be broken.
Config Status: Shows the current status of the server configuration. The configuration is either shown as up to date, meaning that the L-Vis project is still in sync with the server configuration, or the status indicates that the server configuration was changed or removed since it was last imported.
Page 209
L-VIS User Manual LOYTEC NOTE: By default, only compatible data points are displayed. Sometimes compatible data points are available as member points (e.g., a SNVT structure member). Expand the data point and select the desired member point if required. Now the connection tab contains the new connection and below the list of data points in that connection as shown in Figure 15.
L-VIS User Manual LOYTEC Figure 17: Edit an analog to multi-state conversion. 9. Click Save and then choose the newly created conversion by clicking Select. 10. The items with an assigned value conversion appears with a green check mark To Create a Connection via Drag-and-Drop Using the data point folder tree on the left and the list of data points on the top right, navigate to the data point that shall be added to the new connection.
Page 211
L-VIS User Manual LOYTEC To Edit a Connection Change to the Local Connections tab. Select the connection to edit and follow the same steps as when creating a connection. To detach a data point from the selected connection, select the data point and click on the button Detach selected data points over the connection member list.
L-VIS User Manual LOYTEC To Delete a Connection Change to the Local Connections tab. Select the connection for removal. Use multi-select to select more than one connection. Click on the button Delete Connection above the connections list. 10.8.3 Create a Multi-Slot Connection A multi-slot connection can be used to connect a number of different data points together under one umbrella.
L-VIS User Manual LOYTEC Add more slots by dropping data points onto the top-level multi-slot connection. Connect other data points to existing slots by dropping them onto the respective slot. For example, connect the register ‘regRotation’ by dropping it onto ‘setting1.rotation’...
Page 214
L-VIS User Manual LOYTEC Click on the Create math adapter from connection button. The dialog Edit Multi-Slot Math Adapter opens as shown in Figure 23. Figure 23: Edit a math block adapter. Enter a name and description for the adapter.
L-VIS User Manual LOYTEC In the type menu choose Connection with Math Adapter. In the dialog Select Multi-Slot Math Adapter select an existing adapter and click Select. A new multi-slot connection is added to the connection list with empty slots as depicted in Figure 24.
L-VIS User Manual LOYTEC A new connection is added to the connection list. Define a name for the global connection. This name is required to be unique on the network. Data will be published or subscribed to under this name.
If nothing is configured here, the mail may still be sent using an action object in the L-VIS project (please refer to section 9.8 for a description of action objects). To send the mail based on the value or state of a data point, follow these steps: ...
L-VIS User Manual LOYTEC Repeat for additional data points, if the mail should be triggered by more than one source. In case of multiple mail triggers, the mail is sent if any of the conditions is met (as opposed to all conditions).
L-VIS User Manual LOYTEC Right-click in the data point list view and select New local Calendar …. In the Create New Calendar dialog box (as shown in Figure 25) enter Name and Description of the calendar. Note, that a BACnet calendar does not have the Effective Period settings.
L-VIS User Manual LOYTEC To Create a Local Scheduler Under the port folder, select the Scheduler sub-folder to create a scheduler. Right-click in the data point list view and select New Local Scheduler …. Enter a name for the schedule and a description. Note that the schedule automatically detects a corresponding calendar, if it has been created already.
L-VIS User Manual LOYTEC Add new value presets by entering a name and pressing the Create button next to the input field. NOTE: To generate presets automatically for multi-state data points, click the Auto-Create button. This button is available, if no other presets have been defined yet.
Page 222
L-VIS User Manual LOYTEC In the calendar view select the day for which to configure the scheduled event. Then select the event duration by clicking into the daily planner and dragging the mouse to the desired duration. Then click on the button Create new scheduled event and enter a Name for the scheduled event (note, in BACnet there is no name to be specified).
L-VIS User Manual LOYTEC To Use Exception Days from a Calendar For letting a scheduled event occur on exception days from a calendar, create a new scheduled event. Select the event type Calendar and choose one of the defined calendar date entries.
L-VIS User Manual LOYTEC Figure 26: Configure Calendar Pattern Dialog. Click Save Changes when all exception days have been entered. NOTE: If unsure how a date configuration affects the calendar days, click on a pattern in the Pattern Entries list and the affected days will be highlighted in the Preview.
To remove an undesired control data point, click on the Remove button. 10.10.8 Using the SNVT_tod_event On LOYTEC devices supporting CEA-709 networks, the SNVT_tod_event can be used in a schedule for implementing the next-state feature. The parts of this network variable are: ...
L-VIS User Manual LOYTEC NOTE: The scheduler and calendar configuration entered in the configuration dialogs is stored together with the project. It can also be exported to XML format or imported from XML format. Once the project itself was downloaded to the device for the first time, the scheduler configuration should usually be downloaded as well to initialize the created objects with some data.
L-VIS User Manual LOYTEC scheduler always needs to provide one schedule for each day of the week (default weekly schedule). For each special day defined by the calendar, an additional daily schedule is required to support it. NOTE: If the scheduler units are used with LWEB-900 or are displayed on a schedule control in extended UI mode, this value must be set to a high number, because one daily schedule will be required for each event that is entered.
L-VIS User Manual LOYTEC and Object in the point list. These are the functional block index and name of the assigned scheduler. Deleting a scheduler data point will detach the data point from the respective scheduler object and make this object available for other scheduler points which may still be unassigned due to missing resources or which may be created in the future.
L-VIS User Manual LOYTEC Figure 27: Create New Alarm Server dialog box. For alarm transitions, you may define which ones require acknowledgement, and at which priority they are reported. You may attach data points for storing alarm counters. These will be linked using the respective property relations (see Section 10.1.10).
Page 230
L-VIS User Manual LOYTEC For the alarm condition, edit the following definitions which apply to all condition types as shown in Figure 28. Select the Alarm Server which the alarm shall be reported to. Typically, you will choose a generic alarm server.
L-VIS User Manual LOYTEC Figure 29: Condition for an Analog Feedback Alarm. 11. For an analog value condition, fill in the alarm condition as shown in Figure 30. Select Low Limit and High Limit and put check marks, if they shall be employed. Enter a Deadband to account for hysteresis.
L-VIS User Manual LOYTEC trigger. The e-mail template can be configured to contain certain alarm information in the text or subject field. To Create an E-mail Template for Alarms Create or configure an e-mail template as described in section 10.9.
L-VIS User Manual LOYTEC with a spreadsheet view appears as shown in Figure 33. Edit the messages directly in the spreadsheet. Alternatively, click on the export button to export the spreadsheet as a CSV file for editing in Excel. NOTE: Use the feature to include data points from sub-folders and filter expressions to expand the ability to perform multi-select.
L-VIS User Manual LOYTEC Figure 34: Basic Trend Object Configuration. Select the desired Trend Mode. On devices with SD cards, select External trend storage, if this trend log shall be backed up to an SD card. If doing so, also set the Fill Level Notification, which triggers when a backup is written to the external storage.
L-VIS User Manual LOYTEC To Attach Data Points for Trending Select the trend object in the Trend sub-folder. Right-click and select Configure Trend from the context menu. The same dialog which appears when a new trend object is created is shown and allows configuring the trend object.
L-VIS User Manual LOYTEC can be defined. Depending on the trigger data point type, the trigger conditions can be refined. Note, that the behavior of the trigger data point is influenced by the COV properties of the data point. If the Only notify on COV property is checked, the data point triggers only if its value changes to the value of the trigger condition.
A trend control can record up to 8 different scalar data points at the same time, even on BACnet L-Vis devices. No Server object is required and there is no limit of one point per recording. This makes it easy to record for example the CPU load, which is a system register.
In case of BACnet L-Vis devices, data recorded by a trend object is accessible to remote devices on the network. However, this places some restrictions on the functionality of the trend object. Only one data source may be trended and it must be a BACnet server object located on the local device.
L-VIS User Manual LOYTEC Enter a name for the calendar point, a name for the input NV which will be used to connect the calendar from another device to this data point, and select the desired functional block in which the NV should be located.
The remote trend log can load trend data from that device and supply it to the L-Vis application or a CSV file. Please note that remote trend logs are currently only supported by BACnet and OPC technology.
L-VIS User Manual LOYTEC To Create Historic Filters Select one or more data points that shall serve as the base data points. Right-click and select the Configure Historic Filters … item in the context menu. As an alternative, click on of the Historic Filter data point property.
(to input new data) or not. NOTE: The direction is defined from the point of view of the L-VIS device in question, referring to the network side, not the application side. Therefore, an input data point will receive new data from the network and deliver this data to the L-Vis application, whereas an output data point will write new data from the L-VIS application to the network.
L-VIS User Manual LOYTEC The optional check box to create the register as a parameter can be used to avoid the need to set this option in a separate step later on, if this requirement is already known. Note that this option can be changed later at any time.
Page 245
BACnet defines the direction of data flow from the point of view of the application running on the L-VIS device. An analog input object therefore accepts input from the user and transmits this data out to other devices on the network. An analog output object receives data from the network and outputs it to the application (show data on the display).
Page 246
L-VIS User Manual LOYTEC Right-click on the data point and select Add/Remove BACnet properties … from the context menu. The dialog appears as shown below. Figure 35: Dialog for adding/removing BACnet properties. Check the additional properties. Checking the Read box will add an input data point, checking the R/W box will add a value data point.
BACnet network. To execute the scan, a connection to a BACnet device must be established first. BACnet, connected to a device: The network can be scanned by the L-VIS device, which reports the results back to the configuration software. To start the Version 6.2...
Page 248
L-VIS device running the scan. To start the scan, use the context menu of the scan folder and select Scan LNS Database.
Page 249
Once the point is used to create a remote network data point on the L-VIS device, the direction will change, since an output network variable will be required to send data to the remote devices input network variable.
L-VIS User Manual LOYTEC 11 Project Settings Using the command Project Settings from the File menu, a number of advanced options can be controlled which apply to the entire project. The dialog is organized in a number of property pages, which are explained below.
L-VIS User Manual LOYTEC Hide popup after: The amount of idle time after which an open navigation menu or other popup is closed automatically, without changing to a different page. Hide selection after: The amount of idle time after which the selection frame of the last used control is removed.
L-VIS User Manual LOYTEC Hide setup menu: This option instructs the device not to add a link to the built- in setup menu, so that the built-in setup is not accessible. The user may provide customized setup pages instead, matching the local language and the design of the other pages.
L-VIS User Manual LOYTEC Create data points during paste: Set the behavior of the configuration software when objects are pasted from a different project and not all of the referenced data points can be found in the destination project. Missing data points can either be...
L-VIS User Manual LOYTEC Region: In case the selected language is spoken in different regions of the world, refine the selection by picking the appropriate region. This will change details like the used decimal separator, grouping character, or currency of the locale to match the selected region.
L-VIS User Manual LOYTEC Unknown keywords are ignored. The following keywords may be useful to override the default settings of the selected locale: calendar: A calendar specifier such as gregorian, islamic, chinese, hebrew, japanese, or buddhist. See Section 11.3.2 below for a list of valid calendar names.
11.4.2 Display Properties For L-VIS devices, which have fixed display hardware, this area shows the properties of the display for the selected device model. Devices which can support configurable resolution and/or color depth allow the user to change these settings here.
(one byte per pixel). If the VNC client supports this mode (color map mode), the VNC server on the L-VIS device will tell the client that this is the preferred display mode to optimize speed and bandwidth usage while keeping a fully accurate rendering of the project colors.
L-Vis project. It can optionally be downloaded to the device together with the L-Vis project, where it can be used by LWEB-800/802 clients to display the same project (as currently running on the L-Vis device) also on the PC. The following settings are available: ...
L-VIS are correct. At least one DNS server address must be set on the L-VIS device if the SMTP server is given as a DNS name (which is usually the case). ...
L-VIS User Manual LOYTEC NOTE: While communication between mail servers usually happens on port 25, mail clients generally don’t use this port anymore, since most ISPs are now blocking outgoing connections on port 25 from end customers as an anti-spam measurement. Instead, the submission port 587 (as defined by RFC 6409), is used to submit new mails for delivery.
The followings steps will be required to integrate a new device. Create a new device in your database using the provided device template for the L-VIS device you are using (FT-10 or IP-10L). Create all dynamic network variables on the device which are required for your project.
Page 263
The procedure when run as a plug-in is fairly automatic: Create a new device in your database using the provided device template for the L-VIS device you are using (FT-10 or IP-10L). Commission the device, so that the configuration software can communicate with ...
In some cases, it may be necessary to integrate an already programmed device into a network. This can only be done with static NV projects, since dynamic NVs are stored in the network database and not the L-VIS project and are therefore not transportable from one network to another.
NOTE: The following procedures assume that the L-VIS project file is available to the PC which runs the configuration software. If this is not the case, the project must first be uploaded from the old device and saved to a file.
Create a new database or network project in your network management tool, adding the PCs network interface and a new L-VIS device and connect them using a suitable channel. Connect the new device physically to the network interface of your PC, or otherwise make sure that the PC can communicate with the device in the new network project.
L-VIS User Manual LOYTEC dynamic NVs created and then the project needs to be loaded again, so that the dynamic NVs which were not available the first time can be used. The recommended procedure is a combination of the above two procedures.
L-VIS User Manual LOYTEC Execute all required changes to the dynamic NV interface using your network management software. This includes adding new NVs and removing old NVs as required. Once the required changes were made, start the configuration software or, if it is already running, use the Update Data Points button from the tool bar to read the new set of available dynamic NVs from the device.
L-VIS User Manual LOYTEC static interface of the already integrated device and take over the existing bindings. The recommended procedure is as follows: Run the configuration software in standalone mode and connect to the device, preferably using a TCP/IP connection.
Instead, check the following things upfront, before starting the download: Run the configuration software standalone, without connection to any L-VIS device and load the project which is considered to match the current device in the network.
Page 271
L-VIS User Manual LOYTEC 12.4.3.1 Failure before Database Update If the procedure failed before the database update, that is, the device template in the database is still the old version, the device must be rolled back to the last project as well, so that the database and the device match again.
Page 272
L-VIS User Manual LOYTEC NOTE: Reverting back to the last working setup is much easier if a backup of the database is available. In this case, first restore the database from the backup and then simply follow the appropriate procedure for device replacement, using the last working project file. In this case, the configuration software may also be used in plug-in mode during the replace procedure, since the recover functions are not required.
L-VIS User Manual LOYTEC 13 Special Functions (CEA-709) 13.1 Binding Management When the configuration software is run in plug-in mode, additional functions to export, import, and remove the network bindings of the device are available from the Tools menu. The Export Bindings… function scans the database and outputs all current bindings into a text file in CSV format.
The CEA-709 models normally support the CEA-709.1-B standard, which means that the device accepts the extended network management commands used to configure the extra resources available on such devices (for example up to 512 address table entries on L-VIS). However, since the standard requires devices which were once configured using extended network management commands to no longer accept any of the older commands.
L-VIS User Manual LOYTEC device would no longer be usable together with older management software, which does not provide support for the extended command set. To guarantee that the device will be usable together with older tools, the Network Settings dialog, which is accessible from the File menu, has a checkbox to enable a so called CEA-709.1-A restricted mode.
Page 276
L-VIS User Manual LOYTEC management tool. It is recommended to synchronize the CPs from the device into the LNS database before editing and writing them back. To Synchronize CPs in NL220 Double-click on the device object in the device tree Press the Upload button on the Configuration tab of the device properties (see Figure 36).
Click Create Static NV to create the UNVT on the device. 13.8 Dynamic Network Variables Some of the installation scenarios for CEA-709 L-VIS devices make use of dynamic network variables. This section gives a short description of how dynamic network variables are created in different network management tools.
Page 278
L-VIS User Manual LOYTEC Figure 38: Create a function block Drag an input or output network variable shape from the LonMaker® network management tool shape sheet and drop it on the function block. The dialog in Figure 39 is shown.
Page 279
L-VIS User Manual LOYTEC Figure 40: Create network variable dialog In the dialog (Figure 41), select the network variable on the node to which the new dynamic network variable will be connected afterwards. The dynamic network variable will get some attributes of the selected variable, like the SNVT type, assigned. Click on OK to confirm your choice.
This completes the creation of the new dynamic network variable (Figure 43). The dynamic network variable can now be bound to other network variables like a normal network variable and can also be used as a data point source or data point sink in the L-VIS configuration software.
(Figure 45). Figure 45: Network variable connection window 13.8.3 Alex To create dynamic network variables in Alex, add the L-VIS device to your project. Select Virtuelle Funktionseinheiten and click on Neue Virtuelle Funktionseinheit (Figure 46). Version 6.2 LOYTEC electronics GmbH...
Page 282
L-VIS User Manual LOYTEC Figure 46: Alex main window Enter a name in the dialog (Figure 47) and press OK. Figure 47: Virtuelle Funktionseinheit dialog Open the Netzwerkvariablen collection in the tree view and select Neue Netzwerkvariable (Figure 48). Version 6.2...
Page 283
L-VIS User Manual LOYTEC Figure 48: Create new network variable In the Netzwerk Variable dialog (Figure 49), select the device template (Gerätevorlage) and the network variable to which the new dynamic network variable will be connected. Figure 49: New network variable dialog The dynamic network variable will get attributes like the SNVT type from this network variable.
Figure 50: Finished creation of new network variable ® 13.9 Built-in L Objects The CEA-709 models of L-VIS provide a number of static function blocks which are available for use, even when no project is loaded. These blocks are described in the following sections. 13.9.1 Timer Object ®...
LCD backlight. To overrule the value which is adjusted in the L-VIS Plugin Software, the state part of the nviSwitch network variable has to be set to 1. In that case, the value part of the network variable controls the brightness of the display from 0 to 100%.
The configuration properties are described in detail in the L Functional Profile specification. On the L-VIS device, the temperature sensor object reads the current temperature value from an external temperature sensor connected to the input terminals labeled 'TEMP' on the device.
The current BACnet server object configuration of BACnet L-VIS models (LVIS-ME200) is accessible as a set of CSV files following the EDE format convention. They can be downloaded via FTP from the directory /data/ede on the L-VIS device. The files are: ...
Page 288
NOTE: Since all strings in an L-VIS project are Unicode strings (ISO-10646), the default setting is to use UTF-8 encoding for BACnet string properties. When using UCS-2, be aware that there are many tool vendors which do not support UCS-2 strings, and are completely unable to display such strings in their tools, even if the string itself contains only ASCII characters.
(for example using an RFID card). The access controller can communicate the successful authentication over the network to the L-VIS device, where a suitable access level can be set directly, without using a PIN code.
L-VIS User Manual LOYTEC levels 1 through 15. The new PIN codes will be stored on the device and remain in effect until a new project is loaded with a special option set, telling the device to reset its PIN codes to the values stored in the project.
Page 291
L-VIS User Manual LOYTEC Page margins: Any of the automatically created content on a page will be limited to the area defined here. Set the margin to zero to allow the generator to use the entire page. In case you use a page template to add additional content to each of the auto generated pages, set the page margins to restrict the generated content to the area reserved for it.
L-VIS User Manual LOYTEC 15.3.2 Page Design Any new object created by the project builder will be created with the currently defined defaults for the respective object. In most cases, it will be required to change these defaults from the built-in ones before content is created. To do this, an object of the desired type must be selected and configured to match the requirements (fonts, colors, format strings and so on).
L-VIS User Manual LOYTEC Prev Page to navigate to the page before the current page (flip through the data points of one folder, spread out on multiple pages). Next Page to navigate to the next page with data points of the same folder.
This may cause the actuator to send out an update on the feedback output, which will be received by L-VIS on the input SI, which in turn will be copied by the data point connector to the output SO and so on. The result can have adverse effects on the network performance and the performance of the devices in the loop, so special care should be taken to avoid such setups.
The format string used in text controls and non-localized numeric controls is equivalent to the format strings used by the ANSI-C printf function. L-VIS will always use the given format string to format exactly one argument, which will be a string, an integer, or a double precision floating point number, depending on the type of control and its configuration.
Page 296
L-VIS User Manual LOYTEC example, it will not work to use a %d specifier for a text control or a %s specifier for a numeric control. The format string is composed of zero or more directives: ordinary characters (not %), which are copied unchanged to the output stream;...
15.7.1.4 Length Modifier The conversion specifier may normally be preceded by a length modifier, defining the physical size of the arguments data type. In the L-VIS implementation, this modifier is not necessary and may be omitted in all cases. 15.7.1.5 Conversion Specifier This is the character that specifies the type of conversion to be applied.
Page 298
L-VIS User Manual LOYTEC The abbreviated month name. The full month name. The date and time in American writing. The century number (year/100) as a 2-digit integer. (SU) The century number (the year divided by 100 and truncated to an integer).
L-VIS User Manual LOYTEC The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. The second as a decimal number (range 00 to 61). A tab character. The time in 24-hour notation (%H:%M:%S). The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w.
Page 300
L-VIS User Manual LOYTEC A bracket expression is a list of characters enclosed by [ and ]. It matches any single character in that list; if the first character of the list is the caret ^ then it matches any character not in the list.
15.8 External Storage Some L-Vis devices are equipped with a micro SD card slot and/or USB host ports to connect external storage media. Once the memory device is connected, it can be managed via the web page of the device. The section Config->Removable Media contains all options to mount and eject memory devices, allocate swap space, or write a backup of the internal trend data to the external memory.
L-VIS User Manual LOYTEC NOTE: A maximum of 64 MB of swap space may be allocated on an external storage media to extend the available memory of the device and allow larger projects to be loaded. Note that the first boot after a new swap space was activated will take some time to set up the memory.
L-VIS User Manual LOYTEC configuration server to form the IP-852 channel list. The port can be changed and disabled. This port is disabled by default (as long as the IP-852 configuration server is not enabled). 1630 udp/tcp: Only LVIS-3E1xx models running on the FT-10 interface (IP852 disabled).
L-VIS User Manual LOYTEC Time when the device configuration has been cleared or the device was reset to factory defaults. Commission of the CEA-709 node. Static errors in the device and data point configuration. System overload situations as one-time log messages since last power-on.
Page 305
L-VIS User Manual LOYTEC Model Resource 3E100 ME200 3E11x ME21x 3MEx ~5,000 ~5,000 ~10,000 ~10,000 ~20,000 Total number of data points ~2,000 ~2,000 ~10,000 ~10,000 ~10,000 OPC Tags User Registers ~2,000 ~2,000 ~5,000 ~5,000 ~10,000 NVs (static, dynamic) 1,000 1,000...
L-VIS User Manual LOYTEC 15.11 Technical Support LOYTEC offers free telephone and e-mail support for the L-Vis product series. Please contact us at the following address: LOYTEC electronics GmbH Blumengasse 35 A-1170 Vienna Austria / Europe e-mail : support@loytec.com Web : http://www.loytec.com...
L-VIS User Manual LOYTEC 16 List of Figures Figure 1: Connecting L-VIS to the wall mount frame...................39 Figure 2: Main window of the L-VIS configuration software ................65 Figure 3: Example of a structured data point.......................180 Figure 4: Example of property relations......................180 Figure 5: Multi-slot connection (a) and multi-slot with math block adapter (b).
Page 308
Figure 48: Create new network variable ......................283 Figure 49: New network variable dialog ......................283 Figure 50: Finished creation of new network variable ..................284 Table 1: Available L-Vis devices ...........................17 Table 2: Electrical characteristics 3E100/ME200 ....................40 Table 3: Electrical characteristics 3E11x/ME21x ....................41 Table 4: Electrical characteristics 3E11x/ME21x ....................42...
5.1.0 Updated for Release 5.1.0 2017-01-05 6.1.0 Updated for Release 6.1.0 Removed chapters which are now covered by the LOYTEC device manual. Removed outdated example chapters. 2017-08-29 6.2.0 Updated for Release 6.2.0 Moved chapter Project Settings forward to position 11. Added new section to introduce the template system.
Need help?
Do you have a question about the L-VIS and is the answer not in the manual?
Questions and answers