Echelon LNS User Manual

Page 354

Advertising
background image

LNS Programmer's Guide

340

In addition, the Network Name drop-down box will list all networks

accessible by your application as soon as you select a client type. For
source code information, see
CDlgInitializeGeneral::SelectClientType in the
dlginitializegeneral.cpp file. The client type is passed into
m_iClientType. The description of the monitor and control example

later in this appendix provides more details on each of the client types
you can select.

2. From

the

Interface Name drop-down box, select a network interface.

This drop-down box lists all configured L

ON

W

ORKS

network interfaces

available on your system (i.e. all the network interfaces included in the
NetworkInterfaces collection). For initialization source code information,
see CDlgInitializeGeneral::InitNetworkInterfaceName() in the
dlginitializegeneral.cpp file.

3. From

the

Network Name drop-down box, select an already existing

network from the drop-down list or create a new network by typing in the

name of the new network. Although this lists all networks known to the
LNS Object Server (i.e. the Network collection), you should note that the

network management example can only manage networks created with

the example application. For source code information, see
LcaHelper::GetNetworks(void). For selection and initialization

steps see CDlgInitializationGeneral::InitDatabaseName() from

the dlginitializegeneral.cpp file.

4. Once you have selected a client type, a network interface and a network,

you need to specify the licensing mode, as described in Chapter 4 of this

document. To select the licensing mode, select the License tab on the

dialog shown in Figure C.1. You will then be able to select either
Standard Mode or Demonstration Mode. If you select Standard Mode, you

will need to enter the customer ID and customer key.

5. Click

Set Now to save your changes. This will reinitialize the LNS Object

Server, if necessary. For source code information on this, see
OpenObjectServer in the LcaHelper.cpp file.

6. Now, select the General tab to return to the dialog shown in Figure C.1.

If you selected a new network in step 3, click the Create button (or the

Add button if you are running as a Lightweight client). This creates an
example network if you are running as a LNS Full client using the
Networks collection, or adds an entry to the global database if you are

running as a Lightweight client.

For Local clients, or Full clients using the RemoteNetworks collection, a

"template network" is created called __LNS320TEMPLATE that will be

used as a basis for all future networks. This network is created in the
<LNSDIR>\lm\db\lns32 folder, where <LNSDIR> represents the target

directory you have chosen to install LNS to. The template network

contains device and connection description templates. To generate an

example network, a backup of this "template network" is created and
then imported with the network name you had specified. The network is

first opened with the system management mode set to
lcaMgmtModeDeferConfigUpdates to prevent the propagation of

Advertising