If you know the Lon device types you will have under your LonNetwork, you may wish to engineer the LonNetwork offline, or
even manually add them when online. When adding a new device, you can select a device component from a specific lon<Vendor> palette.
Each lon<vendor> module contains a palette with a device for each Lon Xml (.lnml) file in that module. As needed, you can simply drag and drop devices from an open palette into the LonNetwork. See To drag and drop devices from a lon<Vendor> palette.
Alternatively, you can select a DynamicDevice from the lonworks palette and specify an lnml (Lon Xml) file that identifies the particular device type. A device is associated with a particular lnml file by its Lonworks program ID.
Later, when online with the Lon network, you can use the Discover and Match feature in the Device Manager to map each device object with a particular discovered Lon node. A match is possible only if the program IDs are the same. The match synchronizes the Lonworks neuron Id and applies appropriate subnet-node addressing.
For general information about matching, see the “Match (Device)” section in the Drivers Guide. Note that the Lonworks match offers an address source toggle, which you select depending on whether the network is already managed or unmanaged. See Lon Device Manager key points.
The following procedures explain how:
To drag and drop devices from a lon<Vendor> palette
As noted above, you can simply drag and drop devices from the opened palette of any lon<Vendor> module, as described below.
In Workbench, open the side bar, if not already open.
Open any of the lon<Vendor> palettes with devices of interest, for example, lonHoneywell.
Available devices are listed by default names matching the source .lnml file name.
Open the target view of the target LonNetwork, or of the target Lon Device Folder (under the LonNetwork). This may be the device manager view or the wire sheet view, for example.
Drag a device from the palette into the target view (or if desired, from the palette onto the LonNetwork node in the Nav tree).
A popup Name dialog appears, in which you can enter a meaningful name.
Click .
The device is added to the station database.
At the time of this document, you should also perform additional steps below if programming a station in a remote JACE, and
it does not have the same lon<Vendor> module already installed (as the local module palette that you are copying from). At some future time, these additional steps
may not be needed.
Right-click the newly-copied device, and on its popup menu select the ImportXml command.
The ImportXml dialog appears, showing “module://lon<Vendor>/<device>.lnml”, corresponding with the device you just dragged from the palette.
Click .
Data is read from the local .lnml file into the device component in the remote station. The device is now ready for offline programming, or if online with
the JACE (and LON network), ready for matching with an actual device.
See To match a Lon device to a previously managed device or To match a Lon device to a discovered unmanaged device.
To add a DynamicDevice
You can add a DynamicDevice using the button in the Lon Device Manager, as described here.
You can also simply drag and drop a DynamicDevice from the lonworks palette, naming it as you wish. In either case, after adding it, an extra task is required to make it useful. See To import Lon Xml into DynamicDevice.
To add a DynamicDevice using the New device wizard:
In the Lon Device Manager, click the button.
This brings up the New device wizard dialog.
In “Type to Add,” select Dynamic Device.
Enter the number of devices to add (default value is 1).
Click .
When the next New dialog appears, edit the name of the component as you wish to see it in the Niagara station.
For purposes here, leave all values at defaults and click .
The component is added to the station, listed in the Database pane as type “DynamicDevice.”
In the New device wizard, alternate “Types to add” may appear beside “Dynamic Device,” for example, “Q7300,” “Xl10 Chc1” and
“Xl10 Hyd2.” These are special subclasses of a LonDevice. If you select one of these, its Lon Xml (lnml) file association
is already made.
To import Lon Xml into DynamicDevice
Right-click the DynamicDevice, and on the popup menu select the ImportXml command.
The ImportXml dialog appears, showing “null” for the Xml File (if not previously specified).
(Alternatively, you can also click the folder icon beside the Lon Xml File entry in any device’s Add or Edit dialog, for the File Chooser, and continue with step 3 below.)
Click the folder icon
for the File Chooser dialog. The File Chooser opens.
In the File Chooser, click to navigate to the location of the lnml file needed, for example a “jar’ed” lnml file in a lon<vendor> module jar: (example: My Modules, lonSiebe). Or, another lnml file previously made using the Lon Xml Tool.
If selecting a “jar’ed” lnml in the File Chooser, double-click that lon<vendor> jar.
Its available lnml files are listed by name, for example: Mnlrh2.lnml, Mnlrh3.lnml, and so on. (Each lnml file name corresponds to the known .xif file name for any device.)
Click an lnml file, then click .
The File Chooser closes, and the Import Xml dialog shows the selected lnml file.
Click to import the lnml file into the DynamicDevice component.
Now, the component lists showing a type other than DynamicDevice, for example, “Mnlrh3.”
After you do this, you can use the Lon Point Manager under that device to add (offline) proxy points, because data items are now known. See Create Lon proxy points.
To match a Lon device to a previously managed device
If online with the Lon network, you can match a manually added Lon device to a discovered node using the Device Manager’s button. This copies address data (learned in the discovered device) into the selected Lon device component. See Lon Device Manager key points.
To match an existing DynamicDevice to a discovered (previously managed) node:
If the Discovered node table is empty, perform a Discover. See To discover Lon nodes.
Click to select (highlight):
One device in the Discovered table.
One device in the Database table.
Click the drop-down control on the button to select the following:
Use Net Subnet/Node — This specifies to upload address data from the node.
Click .
This brings up the Match dialog. As needed, edit any property required. For specific details, see About Lon devices.
Click to match the discovered device to the DynamicDevice component.
The device is removed from the Discovered table, and remains selected in the Database table.
Right-click the device, and select .
In the popup Upload dialog, check all (recursive, transient, persistent).This retrieves current configuration data from that device.
Repeat this process (steps 2 through 6) for each previously-managed device.
When all devices are matched, click the Learn Mode tool
to toggle out of learn mode.
Click to select (highlight) all the devices just matched.
With the matched devices selected, click the
button.
A popup Learn (links) dialog appears. Click .
A learn links job is launched, where Lon bindings are learned.
When the learn links job completes, all devices should appear listed with a “Config Online” state, and with unique subnet/node addresses.
To match a Lon device to a discovered unmanaged device
If online with the Lon network, you can match a manually added Lon device to a discovered, unmanaged node using the Device Manager’s button. This copies address data assigned by Workbench into the selected Lon device component. See Lon Device Manager key points.
To match an existing DynamicDevice to a discovered (previously unmanaged) node:
If the Discovered node table is empty, perform a Discover. See To discover Lon nodes.
Click to select (highlight):
One device in the Discovered table.
One device in the Database table.
Click the drop-down control on the button to select the following:
Use Db Subnet/Node — This specifies automatic assignment of subnet/node address.
Click .
This brings up the Match dialog. As needed, edit any property required. For specific details, see “DynamicDevice properties.”
Click to match the discovered device to the DynamicDevice component.
The device is removed from the Discovered table, and remains selected in the Database table.
Right-click the device, and select .
In the popup Upload dialog, check all (recursive, transient, persistent). This retrieves current configuration data from that device.
Repeat this process (steps 2 through 6) for each previously-unmanaged device.
Click to select all Unconfigured devices, and click the
button.
A progress bar appears at the top of the view, and updates as the Lon Commission occurs. See Commission for more details.
When the commission job completes, all devices should appear listed with a “Config Online” state, and with unique subnet/node addresses.
Copyright © 2000-2014 Tridium Inc. All rights reserved.