State – Echelon OpenLNS User Manual

Page 846

Advertising
background image

OpenLNS Programmer's Reference

809

the following format:

FM:MM:MM:CC:CC:UU:TT:NN
Note: You may not use colons when writing the program ID.

For a device with a program ID of

80:00:01:01:28:80:04:02,

you can write 8000010128800402 in this property.

See the Devices

Interfaces

section in the OpenLNS

Programmer’s Guide for a description of the format used to

display program IDs.

Availability

Local, full, and lightweight clients.

Syntax

programIdValue = object.ProgramId

Element

Description

programIdValue

The program ID value of the object.

object

The object to be acted on.

Data Type

String.

Read/Write

Read/write.

Added to API

Prior to LNS Release 3.0.

State

Summary

Describes the state of a router side.
You cannot set the state of a router side in the same

transaction as an

Add

,

Commission

, or

Replace

method. You

cannot set the state of a router side during the definition

phase of the predefined components installation scenario.
The state change may fail if the router side has not been

completely updated due to a previous communication

problem or if the router side has not been commissioned. If a

failure occurs, use the

Commission

method to force an update

of the router side.
Router sides

are placed offline while they are being

configured or commissioned.

Availability

Local, full, and lightweight clients.

Syntax

stateValue = object.

State

Element

Description

stateValue

The state of the router side (online or

offline). The enumerated values for

this property, which are stored in the

ConstDeviceStates

constant, are as

follows:
Note: The only two values that may

be written to this property are

lcaStateCnfgOnline(4) and

lcaStateSoftOffline(12). All other

Advertising