Echelon OpenLNS - Manual (Page 825)

OpenLNS Programmer's Reference 788
InitialAuthenticationKey
Summary Contains the initial authentication key to be used when
commissioning a router.
This property must be set prior to commissioning a router that
has network management authentication enabled, and has
been previously commissioned outside of OpenLNS, or
commissioned on a different OpenLNS network. In these
circumstances, OpenLNS will not be able to communicate with
the router without knowing its authentication key because the
router has authentication enabled. If the
InitialAuthenticationKey is set prior to commissioning the
router or router, OpenLNS will use this key to authenticate
messages sent to the router during the commissioning process.
This property does not affect the key stored in the router after
a successful commission. Once the router has been
commissioned, its authentication key will either be set to
FFFFFFFFFFFF or the OpenLNS system authentication key,
as determined by the router’s AuthenticationEnabled property.
Availability Local, full, and lightweight clients.
Syntax authenticationKey = object. InitialAuthenticationKey
Element Description
authenticationKey The authentication key to be used
when commissioning the router.
object The Router object being acted upon.
Data Type String.
Read/Write Read/write.
Added to API LNS Release 3.20.
Location
Summary Contains the value of the specified Router’s six byte location
as a hex string. This property must contain a 12 digit hex
string that is a valid hexadecimal value. The only valid
characters are 0-9 and A-F. For example, "0000AC43F1B6"
is a valid value.
The
Location property allows you to read the Router’s
location from the OpenLNS database.
Availability Local, full, and lightweight clients.
Syntax locationValue = object.Location
object.Location = locationValue
Element Description
locationValue The location as read from the router
as a hex string.
object The Router object to be acted on.