Page Comparison

cost

Number

An optional cost specified as 0...1, where 0 is best (lowest cost) and 1 is worst.  Cost is an abstraction for resources and effort necessary to communicate with the discovered device. The IAP server for a protocol is not required to provide a cost value.  For IAP servers that support a cost value, the value may be computed based on the number of networking hops or transmit power required, for example. The value can be used by IAP clients to select the best segment, if more than one segment discovers the same device, by selecting the segment that reports the smallest cost. 

Example: 0.32

handle

string

A handle for the discovered device. The handle must be unique in the segment.

Example: "z3"

hops

List

An optional list of LQI (line quality indicator) values for each hop. Values range from 0 to 1, where 1 is best.  Can be null. 

This provides additional information to the "cost" number calculation. The IAP server for a protocol is not required to provide a hops value.  For IAP servers that support a hops value, an intelligent algorithm may prefer a higher cost if the LQI across the trip is more leveled, as opposed to one with 2 superb and one poor hop. 

Example: [ 0.8, 0.7 ]

loc

object

An optional location object, if geographical location is known. Can be null. 

See Location Object for a description.

Example:

protocol

string

The device’s Edge Protocol Identifier. See Edge_Protocol_ID in IAP/MQ Topic Syntax.

state

string

The device state, as describeddescribed in state in the Device Status Object properties table.

Example: "unprovisioned"

type

string

Device type, as described in type in the Device Status Object properties table.

Example: "8000112345604"

unid

string

Unique ID, as described in unid in the Device Status Object properties table.

Example: "0503C0123451"