beautypg.com

Subnet – Echelon OpenLNS User Manual

Page 856

background image

OpenLNS Programmer's Reference

819

Summary

Contains the subnet ID of the

device that generated the

network variable or message monitor point update

.

A device's

SubnetId

property identifies the subnet on which

the device resides. This property can be used in conjunction

with the

NodeId

property to uniquely identify a device.

Availability

Local, full, and lightweight clients.

Syntax

returnValue = object.

SubnetId

Element

Description

returnValue

The subnet ID of the device.

object

The

SourceAddress

to be acted on.

Data Type

Integer.

Read/Write

Read only.

Added to API

Prior to LNS Release 3.0.

Subnet

The Subnet object represents a single instance of a subnet. Subnets are the second

component of the three-component LonTalk addressing hierarchy of domain/subnet/node ID.

The subnet address is the level at which routers decide whether to forward a packet;

therefore, the same subnet cannot appear on both sides of a configured or learning router.
Subnets are typically added automatically when routers or devices are added. In most cases

there is no reason for your application to manually allocate subnets. Subnets can be

explicitly added using the

Add

method of the

System

object's

Subnets

collection. This allows

an OpenLNS application to force a given set of devices onto the same subnet by specifying

that subnet when adding the device, or by subsequently moving the device to another subnet

with the

MoveEx

method. This will allow your application to take advantage of subnet

broadcast messaging.

The following table summarizes the

Subnet

object.

Description

Represents a single instance of a subnet.

Added to API

Prior to LNS Release 3.0.

Accessed Through

Subnets

collection object.

Default Property

Name.

Methods

None.

Properties

BitmapFilePath

ClassId

Description

DomainId

Extensions

IconFilePath

Name

Parent

SubnetId