lonworks-LocalNv

This component is a single network variable in a Local Lon Device. The external interface of the local device represents it to other devices on the Lonworks trunk.

A network variable (nv) may configure input (nvi), output (nvo).

Figure 25. Local Nv properties

To access these views, double-click the Local Lon Device component in the Nav tree, and right-click nvoStatus > Views > AX Property Sheet.

Property	Value	Description
Nv Props	additional properties	Reports and configures NV (Network Variable) input properties. For property descriptions, refer to lonworks-LocalNv. Refer to Nv Props.
Nv Config Data	additional properties	Maps directly to a device’s network variable and reports NV (Network Variable) output configuration data. For property descriptions, refer to lonworks-LocalNv. Refer to Nv Config Data.
objectid	number from 0–65535 (defaults to zero (0) )	Identifies the LonMark object for the LonObject. It must be unique in the device among all objects.
objectrequest	drop-down list (defaults to `rqNormal`)	Selects an action to perform on the selected object.
zero	number
span	number to four decimal places—from 0.0000 to 32.7675
Self Doc	string of text (defaults to: &3.0@;Niagara Server Node) This property requires `External Config` to be set to `true`	Defines a text string for the host node’s self documentation up to 1024 bytes. A single asterisk () omits self documentation. NOTE:* When using self documentation, always retain the leading header portion (&3.0@) along with an additional zero (0), plus other characters.
Tuning Policy Name	drop-down list (defaults to Default Policy)	Selects the appropriate tuning policy by name.
objectRequest	drop-down list	Selects the type of request. The explanation of each request is beyond the scope of this document.
invalidId	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
invalidRequest	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
disabled	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
outOfLimits	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
openCircuit	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
outOfService	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
mechanicalFault	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
FeedbackFailure	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
overRange	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
underRange	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
electricalFault	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
UnableToMeasure	`true` or `false` (default)	Enables and disables this feature in nvoStatus.
commFailure	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
failSelfTest	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
selfTestInProgress	`true` or `false` (default)	Enables and disables this feature in nvoStatus.
lockedOut	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
manualControl	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
inAlarm	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
inOverride	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
reportMask	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
programmingMode	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
programmingFail	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
alarmNotifyDisabled	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
resetComplete	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.
reserved2	`true` or `false` (default)	Enables (`true`) and disables (`false`) this feature in nvoStatus.

Actions

By default, Lon components have two available actions, with right-click menu access from the Lon device’s Property Sheet, Nc Manager and Nv Manager views.

Figure 26. Lon nvirequest actions

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

Action	Description
Force Read	Causes a read of the request’s Lon data from the device.
Force Write	Sends the Lon request’s data values to the device again. This does not apply to nvos.

Nv Props

Figure 27. Nv Props properties (under nviRequest)

To access these properties, right-click the Local Lon Device component in the Nav tree, click Views > AX Property Sheet, expand nviRequest or nviStatus and expand Nv Props.

Property	Value	Description
Nv Index	read-only	Reports the number associated with this request’s standard network variable type.
Snvt Type	read-only	Reports a number for the Standard Network Variable Type (Snvt).
Object Index	read-only	Reports the object number.
Member Index	read only	Reports the member number.
Poll Enable	`true` (default) or `false`	Turns polling on (`true`) and off (`false`).
Polled	read-only	Reports if this device was polled (`true`) or not (`false`).
Auth Conf	read-only	Reports if authentication is enabled.
Service Conf	read-only	Reports additional information.
Priority Conf	read-only	Reports if request priority has been set.
Sync	read only	Reports if the system is configured to synchronize device data.
Changeable Type	read-only	Reports if the system is configured to change the type.
Bound To Local	read-only	Reports if the point is bound locally. The system sets this property when an output nv with a proxy is bound. An output nv is not polled when it is bound locally. Instead, nv updates are received from the device.

Nv Config Data

Figure 28. NV Config Data properties (under nviRequest)

To access these properties, right-click the Local Lon Device component in the Nav tree, click Views > AX Property Sheet, expand nviRequest or nviStatus and expand Nv Config Data.

Property	Value	Description
Priority	`true` or `false` (default)	Enables (`true`) and disables (`false`) the priority.
Direction	drop-down list (defaults to Input)	Configures or indicates the direction of travel of the message: to the station (`Input`) or from the station `Output`.
Selector	number between 0 and 16383 or read-only	Configures or reports the selector to exclude. The Lon Link Manager uses decimal notation for selector numbers, but a Lon device’s Nv Manager lists selectors for nvs using hexadecimal numbers. For example: Selector = 16.
Turn Around	read-only	An amount of time in µsec.
Service Type	read-only	Identifies the type of connection, Unacked (unacknowledged) or Acked (acknowledged).
Authenticated	read-only	Reports the state of the request.
Addr Index	read-only	Reports a number associated with a request.