Echelon OpenLNS User Manual

Page 475

Advertising
background image

OpenLNS Programmer's Reference

438

To run a self-test on an object where the result may take

more than 20 seconds to complete, follow these steps:
1. Request a self-test of the LonMarkObject by writing the

lcaLonMarkObjectRequestSelfTest (3) value to the

object’s Request property.

2. After the exception is raised, poll the SelfTestInProgress

property of the ObjectStatus

object

until it returns False.

3. Check the FailSelfTest property of the ObjectStatus

object

to determine why the test failed.

Note: All devices that do not comply with version 3.0 or later

of the LonMark Application-Layer Interoperability Guidelines

do not support self-tests. Some devices that comply with

version 3.0 or later of the LonMark Application-Layer

Interoperability Guidelines may not support self-tests.
You can use the ReportMask property to determine if a device

supports self-tests. If you attempt to read this property and

perform a self-test on a device that does not support

self-tests, an exception will be thrown.

Availability

Local, full, and lightweight clients.

Syntax

statusObject = lmoObject.SelfTestResults

Element

Description

lmoObject

The

LonMarkObject

object to be acted on.

statusObject The

ObjectStatus

object to be returned.

Data Type

ObjectStatus

object.

Read/Write

Read only.

Added to API

Prior to LNS Release 3.0.

Advertising