Local Nvs required by LNS

To permit compatibility with an LNS-based network management tool, use the Local Nv Manager to make two required nv entries in the Local Lon Device, as follows:

nviObjRequest (Direction = Input) (Snvt Type = Snvt Obj Request) [SelfDoc = @0│1;nviRequest]
nvoObjStatus (Direction = Output) (Snvt Type = Snvt Obj Status) [SelfDoc - @0│2;nvoStatus]

Figure 55 shows these two specific nvs being added.

Figure 55. LNS compatibility requires first two nvs as shown

See the next section LNS-compatible nv self documentation syntax for further details.

LNS-compatible nv self documentation syntax

All Local Nv or Local Ncis under the LocalLonDevice should have self documentation entered for LNS compatibility, using this syntax:

@fbIndex│memberNum;text

where, from left-to-right:

@ denotes the start of nv self-documentation.
fbIndex is the functional block index.
│ is the functional profile separator.
memberNum is the member number within the functional block.
text is optional text for describing the nv, by convention “nviSomething” or “nvoSomething”

Optionally, you can omit self documentation for a Local Nv or Local Nci by simply entering a single asterisk (*) instead. However, this does not apply to the two required nvs nviObjRequest and nvoObjStatus—for each of these local nvs, you must enter “Self Doc” property values using the syntax above.

Starting in AX-3.5, you can edit the self documentation (property “SelfDoc”) for any Local Nv or Local Nci from its New (or Edit) dialog, as launched from the Local Nv Manager, as shown in Figure 55.

Prior to AX-3.5, access the Self Doc property from the property sheet of the Local Nv or Local Nci, as shown in Figure 56.

Figure 56. Access Self Doc property of LocalNv from its property sheet

Example

below are two common “Self Doc” property values for the two required Node object nvs:

nviObjRequest, “Self Doc” = @0│1;nviRequest
nvoObjStatus, “Self Doc” = @0│2;nvoStatus

After creating the two required nvs, you can continue defining/adding other local nvs and ncis as needed. Optionally, you can also add “Self Doc” strings to other local nvs and ncis, and also edit the self doc string for the LocalLonDevice (see LocalLonDevice External Config).

If you choose to omit self-documentation (for any items except the two Node object 0 nvs described above), simply enter a single asterisk (*) in the “Self Doc” property. Refer to the appropriate LonWorks/LonTalk reference on the syntax required for nv self documentation.