Topology Update

IID: [1:{01000028}]

This interface is used to notify a provider about topology changes. Topology information is typically updated as data is delivered. However, there are cases where it is desirable to simply be notified of topology changes. This interface implies the requestor maintains state of the topology, thus knowning the previous state of the device in addition to the updated state.

Associated Interfaces

> Type Definitions

PositionType ID: 3

The logical position of the device relative to the parent. The parent defines the context/meaning of the positions for its children. A parent may have multiple children with the same position, which may indicate a grouping or relationship between those children. The position is meta-data associated with the device itself, and not related directly to data or an event.

MAX: 
MIN: 
Unit: 
Type: uint16
TimestampType ID: 2

The time at which the topology change occurred.

Type: datetime
Optional IDType ID: 1

An optional ID that is used in cases (for example, parent) where the ID may not exist. NULL indicates that there is no ID.

Type: nullable ( ID )
Optional PositionType ID: 4

An optional position is used in cases where the position may not exist. NULL indicates that there is no position.

Type: nullable ( Timestamp )
IDType ID: 0

An identifier for an actor in the data exchange (device, source, sink, parent).

Type: oid

> Methods

Parent ChangedItem ID: 1


Send notification that the parent of the device has changed.

Inputs:
 0 -  device - The device for which the parent has changed.
 2 -  timestamp - The time at which the parent changed.
 1 -  original - The original (old) parent of the device.
 1 -  update - The updated (new) parent of the device.
Position ChangedItem ID: 2


Send notification that the position of the device has changed.

Inputs:
 0 -  device - The device for which the position has changed.
 2 -  timestamp - The time at which the position changed.
 4 -  original - The original (old) position of the device.
 4 -  update - The updated (new) position of the device.