Section 6. csibrokermap control, 1 purpose of the csibrokermap control, 2 connecting to the loggernet server – Campbell Scientific LoggerNet Server SDK User Manual

Page 31

Advertising
background image

Section 6. CsiBrokerMap Control

6.1 Purpose of the CsiBrokerMap Control

The CsiBrokerMap control gives developers access to the broker map, which is
the list of brokers or dataloggers known by the LoggerNet server. This control
also keeps track of all tables on each of the brokers including the table
definitions or columns. This table information is derived from the collect
areas that are known by the LoggerNet server. Collect areas are known by the
LoggerNet server after a datalogger program has been associated or table
definitions have been retrieved. The user may also create collect areas
manually in the LoggerNet server.

The information given by the CsiBrokerMap control can be used as parameters
for other controls in the SDK. For example, the CsiDataLogger control can use
the name of a datalogger that was displayed to the user through the
CsiBrokerMap control. Similarly, the CsiBrokerMap control can display
specific brokers, tables, and columns that the CsiDataSource control can use to
create an advisor that monitors acquired data.

This control can also be used in combination with the CsiDatalogger control to
set a value within a datalogger table. With information about the names of a
broker, a table, and a column provided by the CsiBrokerMap control, the

variableSetStart

method of the CsiDatalogger control could be used to set

the value of that column.

The CsiBrokerMap can be a useful tool to display the dataloggers, tables and
columns that exist in the LoggerNet server datalogger network.

6.2 Connecting to the LoggerNet Server

There are two basic actions required to connect to the LoggerNet server:

1) Set server properties:

a)

serverName

- The name of the LoggerNet server or IP address. The

default value is

localhost

.

b)

serverPort

- The port on which the LoggerNet server is running. The

default value is

6789.

c)

serverLogonName

(Optional) - If security has been enabled on the

server, a valid logon name is required.

d)

serverLogonPassword

(Optional) - If security has been enabled on

the server, a valid password that corresponds with a valid logon name
is required.

2) Invoke the s

tart()

method.

6-1

Advertising