lonworks-LonNetmgmt

This component serves as the base component for all Lonworks network management functions. It is a frozen container slot of a LonNetwork.

This container is the base component for all Lonworks network management functions provided by the station. Leave the Lon Netmgmt properties at their defaults, except for perhaps Use Lon Objects.

Figure 12. Lon Netmgmt properties

To view these properties, right-click the LonNetwork node in the Nav tree, click Views > AX Property Sheet, click Lon Netmgmt and expand one of the Link Descriptors.

This Property Sheet includes one container, Link Descriptors with four descriptors.

Property	Value	Description
Domain Id	drop-down list (defaults to a zero-length field, that is to a field with nothing in it.)	Defines the default working domain ID for the network. Without further configuration, you can discover all Lon nodes that also belong to the zero-length domain. However, if you cannot discover nodes, they are likely configured on a different domain. Options include 0, 1, 3, 6.
Authenticate	`true` or `false` (default)	Turns authentication on (`true`) and off (`false`).
Authentication Key	text	Configures the key used to secure the request.
Link DescriptorsAuthenticate	additional properties	Refer to Link Descriptors.
Non Group Timer	number (defaults to 4)	Sets up a timer.
Channel Priorities	number (defaults to zero (0) )	Sets up the processing priority for the current channel.
Debug	`true` or `false` (default)	Enables (`true`) and disables (`false`) debugging.
Verify Nv Dir	`true` or `false` (default)	Enables (`true`) and disables (`false`) the network variable directory.
Service Pin Wait	seconds (defaults to 300 seconds)	Configures how long the system listens for a service pin message from the Lon Utilities Manager view. The framework does not require express listening for a service pin message. It handles an unsolicited service pin message by either adding the node to the station database or selecting the node in the Database pane.
Use Lon Objects	`true` or `false` (default)	Configures the driver to use LonObject containers in a LonMark-complient device. `false` places all learned components directly under the Lon device’s device object. `true` adds a Lon object container group for the device’s Lon components. Each LonMark container represents a LonMark object. This affects the default Nv Manager view on a Lon device.
Always in Zero Length Domain	`true` or `false` (default)	Determines which domain to use when commissioning or replacing a Lon device that has two domain entries (domain indexes 0 and 1). By default (`false`) the driver sets the second domain (domain index 1) to not-in-use. In the case where the `LonNetwork`‘s working domain is not the zero-length domain, the device will not be a zero-length domain member. `true` reverses the default and commissions all devices with two domain entries as members of the zero-length domain.

Link Descriptors

Descriptors specify timers and a retry count applied to the address table of nodes during the bind process. All implicit addressing uses them. Usually, you do not need to change link descriptor properties from their defaults.

Figure 13. Link Descriptors and properties

If Lon network devices respond slowly, you may need to adjust these Link Descriptor properties upwards, often in combination with adjusting Lon Comm Config properties.

There are four descriptors or types of binding service: Standard, Reliable, Critical and Authenticated.

Standard (unacknowledged) is the least reliable, yet often most widely used. This is the default service type for a binding. With this service, the message is sent one time and no response is expected. This service is typically used when the highest level of network performance is needed, network bandwidth is limited and the application is not sensitive to the loss of messages.
Reliable (unacknowledged/repeated) is recommended for messaging that has been classified as important—if there is a specific need to know that a status has changed. Reliable messaging sends a message three times. The srcDevice sends each message three times and, if the targetDevice receives the message, it discards subsequent messages.
Critical (acknowledged) means that the targetDevice must acknowledge the fact that it received a message. The srcDevice continues to send the message until the targetDevice acknowledges receipt of that message. You are limited to the number of bindings that can be defined as critical, because it taxes the system, and often causes communication issues (by loading down the network with message verification traffic).
Authenticated is a security service reserved for secure messaging. When using authentication, the srcDevice must identify itself to the targetDevice and vice-versa. This service is rarely used, and only in instances where messaging must be secure.

Each descriptor has the same set of properties.

Property	Value	Description
Service Type	read-only [used once]	Identifies the type of connection, Unacked (unacknowledged) or Acked (acknowledged).
Repeat Timer	drop-down list of millisecond values (defaults to 384 milliseconds)	Applies to all outgoing network management messages, all poll messages, and unbound nv update messages from the station.
Retries	number (defaults to 3)	Configures how many times to attempt the function.
Receive Timer	drop-down list of millisecond values (defaults to 96 milliseconds)	Applies to all outgoing network management messages, all poll messages, and unbound nv update messages from the station.
All Link Descriptors, Transmit Timer	drop-down list of millisecond values (defaults to 96 milliseconds)	Applies to all outgoing network management messages, all poll messages, and unbound nv update messages from the station.

Actions

Figure 14. Newmgmt actions

To access these actions, right-click the Lon Netmgmt and click Actions.

Action	Description
Temp Bridge On	Establishes a temporary connection to the server.
Temp Bridge Off	Disconnects a temporary connection from the server.
Update Router	Updates the router records.
Cancel Service Pin	Cancels a Lonworks service pin message for the host node. This action is unique to Local Lon Device, and is useful if installing the host using an external Lonworks network management tool (for a station as a Lon node only).