beautypg.com

State – Echelon OpenLNS User Manual

Page 301

background image

OpenLNS Programmer's Reference

264

State

Summary

Describes the state of a device, router side, router, or system.

This data is available for application devices and router

sides.

Setting the Device State
You cannot set the state of a device in the same transaction

as an Add, Commission, or Replace method.
The state change may fail if the device has not been

completely updated due to a previous communication

problem or if the device has not been commissioned. If a

failure occurs, use the Commission method to force an update

of the device.
You cannot set the state of a device during the definition

phase of the predefined components installation scenario.
Offline Devices
Offline devices cannot receive network events related to

monitor and control. For example, if the State property of an

application device installed on the network is set to offline,

then that device will not be able to receive incoming network

variable events.
Additionally, devices are set offline while they are being

configured or commissioned. For example, if you add or

remove a connection between an application device and the

Network Service Device, both the application device and

Network Service Device will be set offline while the change is

being made. During that time, the Network Service Device

will not process network variable updates, nor will it poll

network variables because the configuration of the

application device and the configuration of the Network

Service Device are in a state of fluctuation. However, you can

use the OnSessionChangeEvent event to track when the

Network Service Device goes online or offline.

Availability

Local, full, and lightweight clients.

Syntax

stateValue = object.State

Element

Description

stateValue

The state of the device. The enumerated

values for this element, which are

contained in the

ConstDeviceStates

constant, are as follows:
2 lcaStateUncnfg

The application is loaded but the

configuration is either not loaded, being

reloaded, or deemed corrupted due to a

configuration checksum error.
A Neuron Chip also can make itself

unconfigured by calling the Neuron C