Echelon LNS DDE Server Manual de usuario Pagina 1

LNS DDE Server User’s Guide Version 2.11 @ eCHELON C o r p o r a t i o n 078-0170-01D

New Features in Release 2.11 Release 2.l1 (release 2.1 with Service Pack 1 applied) of the LNS DDE Server includes adds date stamping to the log pane.

-r nn Specifies the retry count to be used for acknowledged and request/response service or the repeat count to be used for repeated service, where nn

bcast_d.msg_out[.msg_code][parameters] Where each component has the following meaning: bcast_d Required. bcast_d is a keyword, not a user-defined

-t format_name Specifies a format name to use for formatting the data in the outgoing message. For response messages, the LNS DDE Server does not aut

Example 1: Application LNSDDE Topic AppMsg Test.subsystem 1.MT Item msg_in –t SNVT_count Example 2: Application LNSDDE Topic AppMsg Test.subsystem 1.

Example 1: Application LNSDDE Topic AppMsg Test.subsystem 1.MT Item msg_in –t SNVT_count Example 2: Application LNSDDE Topic AppMsg Test.subsystem

8 Using Properties This chapter describes the properties available for the different topic types. LNS DDE Server User's Guide 8-1

Properties The LNS DDE Server provides access to additional properties besides the network variable, configuration property, and message values descri

Point.InError R Number of points that cannot be read in the network. Point.WriteCount R Number of write requests issued for this point. The number

device with the same name exists in the same subsystem, the value of the property for the application device will be returned. Change the name of eit

the device has not yet been commissioned. 11 Program ID mismatch. The ID of the program in the device does not match the program ID in the network i

single network interface, or through multiple network interfaces. To open multiple remote networks, you must configure the LNS DDE Server as a lightw

Properties Available only in Application Devices Wink W Winks the device, if supported by the device's application. SelfDocumentation R The sel

DetailInfo.ModelNumber R The type of protocol processor in the device. If the protocol processor is a Neuron Chip, this will be one of the following

Request.Enable R/W Set to 1 to Enable object. Set to 0 to Disable it. Request.RemoveOverride R/W Set to 1 to remove the Override condition of an ob

Appendix A Resource Files This chapter discusses LONMARK resource files and how to use the Resource File Catalog Utility to add new resource files to

LONMARK Resource Files The LNS DDE Server supports LONMARK resource files that define standard and user-defined network variable types, configuration

For each network variable and configuration property type, the type file supplies the following information: • The name of the type and the names for

2. US = United States measurement system format. These formats will be automatically selected if the operating system is configured to use United Sta

LNS DDE Server User’s Guide A-5

Appendix B Installing the PCLTA-10/20 and PCC-10 Drivers This appendix explains how to install the PCLTA-10, PCLTA-20, and PCC-10 cards to function as

Monitoring and Controlling a LONWORKS Network Due to their high reliability, low cost, and flexibility, LONWORKS networks are used in many ways. For

PCLTA-10, PCLTA-20, and PCC-10 Adapter Installation The PCLTA-10, PCLTA-20, and PCC-10 installation software installs the files required by the Window

3. Select the language you want to install and click Next. 4. A welcome window appears. Read the information on the welcome window and click Next.

6. Choose the destination folder where you want to install the PCLTA-10, PCLTA-20, and PCC-10 drivers. You must choose the same folder you selected f

5. Reinsert the power cord and then restart the PC. A New Hardware Found window will be displayed briefly when the operating system recognizes the P

If the computer was rebooted after installation of the software, insert the PCC-10 card into an open PC Card slot. Otherwise, reboot the computer bef

PCC10L7 is selected in the NI Application list. Click Apply whether or not you change the value. 5. Click the Diagnostics button. If the PCLTA-10/20

9. Click the OK button. The control panel enters a receive-ready state and displays the following message while waiting for a service pin message fro

Appendix C Wonderware InTouch Client Example Wonderware's InTouch HMI development tool is an one of the HMI development tools that supports t

Introduction The InTouch example provides an overview of how to use the InTouch software with the LNS DDE Server. See Using the InTouch Example in Ch

InTouch tags fall into three main category types. Memory tags are primarily data variables local to the PC running the InTouch WindowViewer applicati

Configuration parameters are stored in files on the device, and may be accessed using the LONWORKS file transfer protocol, or by direct memory read/wr

3. The following dialog opens: This dialog is associated with setting up NetDDE which is not used in this example. 4. Click the Done button withou

5. Select the Monitoring NVs window. Click OK. InTouch starts the WindowMaker application with the Monitor NVs window open for modification. The fo

7. Select the String option to animate the label with a string value. 8. Click the String button of the Animation Link Dialog to see the expressio

9. Double-click the tag name in the Expression: edit box to see how this tag is defined. The following Tagname Dictionary dialog opens: Click the

handle for the Subsystem containing the targeted function block or device, and <Topic Type> is the topic type supported by the LNS DDE server.

1. From the WindowMaker tool, double-click the LED to the right of SW- 1. The following dialog opens: This object is an InTouch Light Wizard. Wiza

Changing the Default Format Two views of the mode output of the mode simulator value are shown under LonPoint Index Type in the main window of the exa

4. Modify the item to add the -tSNVT_temp_f#US option as shown in the following figure: Substitute #SI for #US to force SI units. 5. Save changes

To open the I/O Message Display wizard, select the Text Displays category on the left. 3. Double-click the I/O Analog Display or I/O Message Display

4. Click the LNS DDE Server button on the Windows taskbar to open the LNS DDE Server Window LNS DDE Server User’s Guide C-13

That is, the application can observe the values of network variables, configuration properties, and application and foreign frame messages, and can ch

5. Navigate to the OA Temp device Analog output value, right-click the Analog output, and select Copy Link from the shortcut menu as shown in the fol

is contained in Action animation links attached to buttons placed in the window. Descriptions of other windows in the example HMI application. Appli

C-16 WonderWare InTouch Example

Appendix D License Order Form This appendix provides a printed copy of the order form for LNS DDE Server credits. See Chapter 3 for information on us

TO: Echelon License Administrator Email: [email protected] Fax: +1-408-328-3802 (please use email if available)

The following serial number and PC key values are filled in automatically by the LNS DDE Server when you generate an application key order as describe

Description of how the original application key was lost: [ ] No charge backup key. By submitting an order for a

Appendix E LNS DDE Server Software License Agreement This appendix provides a printed copy of the LNS DDE Server Software License Agreement. LNS DDE S

Notice This is a legal agreement between you and Echelon Corporation ("Echelon"). YOU MUST READ AND AGREE TO THE TERMS OF THIS SOFTWARE LIC

Application Key for the Licensed Software for the server computer and every remote client computer, (d) physically transfer an Application Key from on

Once a conversation is established, the client can send and receive data from the server on the DDE channel. For example, an Excel spreadsheet (the c

LIMITED WARRANTY AND DISCLAIMER Echelon warrants that, for a period of ninety (90) days from the date of delivery or transmission and installation of

APPROVALS, AS APPLICABLE. THE NEURON CHIP, LONTALK PROTOCOL, NEURON CHIP FIRMWARE, LONWORKS NETWORK INTERFACES, AND THE LICENSED SOFTWARE ARE NOT DES

E-6 Software License Agreement

Appendix F LNS DDE Server Software License Transfer Agreement This appendix provides a printed copy of the Software License Transfer Agreement. LNS DD

Software License Transfer Agreement THIS SOFTWARE LICENSE TRANSFER AGREEMENT is entered into as of [insert date], by and between [insert co

Glossary This glossary defines LONWORKS terms that you may encounter when using the LNS DDE Server. LNS DDE Server User’s Guide Gl-1

Application Device The individual sensor, actuator, and controller devices that make up a network. Application devices contain an application progr

Manual changes; the server only sends the item's value when requested by the client. DDE Client The originator of a DDE conversation. A DDE cl

international organization that develops guidelines and certification procedures for LONWORKS products. Devices that carry the LONMARK logo are able

LonTalk Adapter play compatible interface card that connects to a LONWORKS network. It has an on-board twisted-pair transceiver of one of the follow

[Pause] Temporarily stops the LNS DDE Server from sending updates to devices on the LONWORKS network, both updates to network variables and network

Gl-6 Glossary

2 Getting Started This chapter explains how to install the LNS DDE Server, and how to start it with an existing network. LNS DDE Server User's G

Requirements The LNS DDE Server requires a PC that meets the following requirements: • Microsoft Windows XP, Windows 2000, Windows Me, Windows 98, o

In the lower part of all the dialogs you will find navigation buttons. Use these buttons to go forward to the next dialog, go back to the previous d

Echelon, LON, LONWORKS, LNS, LonTalk, Neuron, LONMARK, 3120, 3150, the LonUsers logo, the Echelon logo, and the LONMARK logo are registered trademarks

6 Select the LNS DDE Server components to be installed. The installation program automatically preselects some of the components based in part on w

Select the components to be installed and click Next. The Select Destination Directory window appears. 7 Choose a LONWORKS folder where you want the

download the latest LNS 3 service pack from www.echelon.com/lns. Follow the instructions provided with the LNS service pack to install it. 17 If you

Using the LNS DDE Server When you start the LNS DDE Server, a main window similar to the following figure appears (you may see a different set of netw

associated with the selected network will be listed in the detail pane on the right side of the window. You can simultaneously open any number of the

Menu Bar The menu bar contains six menus. These are described in the following table: File Save Log File Saves the contents of the log file. Exit

Log Display/ Errors Toggles displaying of error events. Log Display/ Trace Activates the tracing option. Log Display/ Freeze Stops automatic scrolling

Bottom of Log Scrolls to the bottom of the log. Top of Log Scrolls to the top of the log. Freeze Stops automatic scrolling of the log. Clear Me

The LNS DDE Test example includes 5 application devices and a router, which matches the hardware in a LonPoint Demo Kit. If you do not have LonPoi

variables are connected as shown on the LonMaker drawing. The following list summarizes the Sequence of Operations for the LNS DDE Test example. Sequ

Contents 1 LNS DDE Server Overview 1-1 New Feature in Release 2.11 1-2 New Features in Release 2.1 1-2 Overview of LONWORKS® Networks 1-3 In

4. Click the Browse button. The Select Backup File dialog opens. 5. Browse to the LNS DDE Test V2.zip or LNS DDE Test V3.zip file in the LONWORKS

5. Click Yes to start the LNS DDE Server. 6. If a blank spreadsheet opens over the Excel example spreadsheet, close the blank speadsheet. 7. Excel

2-16 Installing the LNS DDE Software

3 Configuring the LNS DDE Server This chapter discusses how to configure the LNS DDE Server. LNS DDE Server User's Guide 3-1

Configuration Overview When the LNS DDE Server starts up the first time, it will run using its initial default configuration settings. The LNS Server

DDE Server Settings Application Name This setting specifies the DDE Application Name of the LNS DDE Server. This is not the filename on disk of the se

Network Server Response Timeout (sec) This setting controls how long a time the LNS DDE Server will wait for a response from the LNS Network Server ap

applications, for example Microsoft Excel, this means prepending the computer name to the application name as in the example, =\\MYCOMPUTER\LNSDDE|&ap

Message Logging Settings Display Information Messages This setting controls filtering of information messages for the log. Click this setting to disp

Max Log File Size The log file size is user configurable, in kilobytes. The default log behavior is to stop logging messages when the maximum log siz

Service 3-4 Run as a Windows NT Service 3-4 Write Messages to the Event Log 3-5 Message Logging Settings 3-6 Display Information Mess

To select another folder, either enter it manually or use the Browse button to search for one. The server validates the path entered when you press t

hosts the LNS Server. When running as a remote full client, network variable values are not read from or written to the LNS Server, instead, they are

Network Interface This property can only be set if the Remote Operation option is set. If the Remote Operation option is set, this field contains a l

DDE Toolkit This section of the trace options concerns the interaction between the LNS DDE Server and the Wonderware I/O Server Toolkit (formerly the

when a point is created. This option will generate a message for each point that is accessed. The server will not start reading the point until it h

Format Files This option generates a message each time a format file is opened. The full path of the format file is included in the message. The serv

One instance of the LNS Network Server runs for each network that is open. One additional instance is used by the server to list the available networ

If this option is disabled, a summary message will be generated when a service pin message is received. The message contains only the device path (sub

The LNS DDE Server has three licensing modes. The first is Temporary Mode. If there is no license installed on a PC, a Temporary Mode license is ge

Temporary Mode, this field will show the restriction placed on the license. The restrictions that can be placed on a license include duration and num

Serial Number 3-16 Generate PC Key 3-16 Creating an Unlimited Mode License 3-16 Transferring Licenses 3-18 Network Settings 3-18 Network

LONWORKS/IP, LNS/IP, NetDDE or other networking protocol. You may transfer an application key to a new PC as described in the next section. If you l

Edition), or if this is a replacement for a lost key, fill in the appropriate fields, and enter 0 as the price. 8. Email the form to the license adm

select the tab corresponding to the network to be configured. In either case, the following dialog appears with one tab for each LNS Network Database

Authentication Key This field allows you to enter the authentication key for the LNS network. This is required if you are accessing the network as a r

If you are communicating as a Lightweight client over an LNS/IP Channel (see Remote Settings, earlier in this Chapter), this option will not be availa

The network topology, type of network interface, and LNS DDE Server host PC performance will all affect the maximum number of points that can be polle

acknowledgements are not an indicator of reliable delivery should the LNS DDE Server and attached client applications not be running. • If a networ

• Control the update rate of bound network variables. Network variables should generally only be bound if they will change infrequently. If there is

Exclusive Mode (Lightweight Clients) This option is disabled for version 2.1 of the LNS DDE Server. Host Message Owner This option is disabled for ver

Bound Update Persistent Once the DDE Server shuts down, all temporary network variables and connections created when using bound updates are removed a

5 Reading and Writing Network Variables 5-1 Specifying a Network Variable 5-2 Specifying a Network Variable Topic 5-2 Specifying a Network Var

To create a custom topic, open the Configure menu, point to Topics, then select Create New. Alternatively, you can right-click a subsystem in the fol

Click Apply to save the specified topic and specify additional topics. Click OK to save the specified topic and close the dialog. LNS DDE Server Us

3-30 Using the LNS DDE Server

4 Addressing DDE Messages This chapter describes how a DDE client specifies an address for a DDE message. LNS DDE Server User's Guide 4-1

Address Components When a DDE client sends out a request to begin a DDE conversation, all DDE servers running on the PC see the message. In order to

Standard Topic Format The standard topic format specifies a network, subsystem, and topic type. Ose this format except when you are using custom topi

Custom Topic Format The custom topic format specifies a custom topic name and a topic type. Use this format with custom topics that you define. To u

Category Topic Type Description Network Variable LMNV Network variables belonging to a LONMARK object. Use this type to access network variables bel

Device Dev Devices. Used to access a device’s or router’s properties. See Chapter 8 for more information. System System System properties. For th

Items The Item is the last component of a DDE address. The topic type as described in the previous section determines the format of the item. The it

Point Properties 8-8 Appendix A Resource Files A-1 LONMARK Resource Files A-2 Type File A-2 Format File A-3 Alternate Formats A-3 Language Fi

4-8 Topics and Items Examples Below are a few examples of correctly formatted items: Type Item Netvar AI-1.nviTemp –i 100 DevNVCP AI-1.AS_Analog_1.

5 Reading and Writing Network Variables This chapter describes how to read and write network variables. LNS DDE Server User's Guide 5-1

Specifying a Network Variable Monitoring and control applications will typically monitor input or output network variable values and allow an operator

Each component of the Item format has the following meaning: device_name Required. The name of a device, as defined in the LNS database. lm_name R

-p bool For a variable monitored by polling, this option specifies whether the poll messages should be sent with priority service. May be set to True

Format command. Once the extended form is assigned to the network variable, the DDE client application does not need to specify the format type in the

The Al- 1.Node Object 0.Node_Directory item would be reformatted as a UNVT_u_long, by using the -t option as follows: Al- 1. Node Object 0.Node_Dire

Channel = DDEInitiate(Application, Topic) Value = DDERequest(Channel, Item) DDETerminate (Channel) Following is a description of the parameters: Ap

3. On the target window, drag the control to the size you want. 4. To set the properties for the button, double-click the button. 5. To add an a

by exception strategy; a new value is reported only upon changes in the variable's value. If the LNS DDE Server is bound to an output network v

viii Table of Contents

variable that is driven by multiple output network variables (network variable fan-in) is a typical example of how bound monitoring is not applicable.

1 In the LNS DDE Server folder pane, navigate from the top level down through the hierarchy to the network variable level. 2 Right-click the netwo

timer expires, this property remains at 0 until explicitly reset to another value. Setting this property prevents a separate network variable update b

Value The value to be written to the network variable, as a worksheet cell reference. 8. To return to Excel from the VBA editor, select Close and R

StatusTag A tag containing the return value from the WWRequest function. The value is 1 for a successful update, 0 if the application is busy, and –

LNS DDE Server User's Guide 5-15

6 Reading and Writing Configuration Properties This chapter describes how to work with configuration properties. LNS DDE Server User's Guide 6

Specifying a Configuration Property Configuration properties may be associated with a device, LONMARK object, or network variable. For example, a con

Where each component has the following meaning: device_name Required. The name of a device, as defined in the LNS database. lm_name Required if th

1 LNS DDE Server Overview This chapter defines the main concepts for a LONWORKS® network, the role of a network management tool in setting up a networ

-t type_name Specifies a format name to use for formatting the configuration property as described in the next section. If this option is not specifi

Selector Index Selector 1 DEVICE_CLASS 2 DEVICE_CLASS and SUB_CLASS 3 MANUFACTURER 4 MANUFACTURER and DEVICE_CLASS 5 MANUFACTURER and DEVICE_CLASS an

Receiving Ongoing Configuration Property Updates Receiving ongoing configuration property updates is similar to receiving network variables as describ

7 Receiving and Sending Application and Foreign Frame Messages This chapter describes how to send and receive application and foreign frame messages.

Specifying an Incoming Message Item Application and foreign frame messages are typically used for proprietary, non-interoperable interfaces to LONWORK

-t type_name Specifies a format name to use for formatting the message data as described in the next section. If this option is not specified, a forma

Msg_code Optional. Specifies monitoring of responses with the given message code, in decimal. If a message code is specified, then the data returned

Note: To receive a response, you must establish an automatic link on resp_in in the DDE Client before sending the request on msg_out (i.e. the respo

The parameter options are: as follows -n bool Specifies whether the client will receive message response items from the LNS DDE Server even if the da

response message must be automatically forwarded to the client). Otherwise, the completion will be discarded. See Example 3 in Requesting a One-Time