If you choose to commission a device with the service pin method, the LonMaker tool prompts you to press the service pin of the physical device after going through the other windows of the Commissioning Wizard. This option is only available if the LonMaker tool is attached to the
network, although not necessarily OnNet. The Service Pin Method provides two windows, one for single devices and one for multiple devices.
Single Device or Router
If you identify a single device and you select the Service Pin identification method, the following window appears:
To identify a single Neuron ID, select from the following options and press the service pin indicated:
Options
Display data from service pin Displays a dialog that contains the information returned in the service pin message.
Filter on program ID Ignores service pin messages that do not include the same program ID as the device being commissioned. Default is selected. This option is cleared if the application image will be loaded during commissioning.
Filter on channel Ignores service pin messages that do not originate on the same channel as the device being installed. On networks that use repeaters, the LonMaker tool cannot always determine the source channel of the service pin message. For these networks, it may be necessary to clear this checkbox in order to commission the device. The default value is set under the Service Pin category on the LonMaker Options tab in Network Properties.
Total Received Displays the total number of service pin messages received from any physical device.
Cancel Cancels the commission process.
When you press the service pin, the LonMaker tool commissions the device and places it in the state you specified.
Multiple Devices or Routers
If you are identifying more than one device and you select the Service Pin identification method, the following window appears:
This window displays the devices to be commissioned in a list. The list contains each device name, type, and channel as well as a blank field for the device’s Neuron ID. The Neuron ID of the device will be provided by the service pin message from the device.
To enter a device or router Neuron ID, complete the following steps: 1. Click the name of the device whose service pin will be pressed
2. Press the service pin. If you set the Display Data checkbox, the LonMaker tool displays a dialog containing the information returned in the service pin message.
If you do not first select a device, the LonMaker tool attempts to automatically match the service pin message with the appropriate device. If multiple devices qualify, the LonMaker tool chooses the first one that does not already have an assigned Neuron ID. To force the LonMaker tool to use a specific device, select that device in the list. If a service pin message is filtered, or the LonMaker tool is unable to identify the device, the Total Received value will increment, but no new Neuron ID will appear in the device list.
3. Click Continue to proceed without entering all Neuron IDs (not pressing all service pins for the devices listed, for example). The LonMaker tool proceeds automatically when all Neuron IDs are entered.
You will return to the LonMaker drawing when the process is complete.
Discovering Devices
You can automatically discover and commission devices using the Discover Devices command. This command allows the LonMaker tool to search for devices on the network and match them to uncommissioned device shapes in the LonMaker drawing. This allows you to rapidly commission networks that have been designed off-site as described in engineered system scenario.
You can match discovered devices with your LonMaker device shapes based on their program ID, channel, and location ID. If there is no unique match, you can select the appropriate device by winking or by pressing a service pin. To discover devices, follow these steps:
1. Manually commission all routers as described in Commissioning a Router.
2. Select Discover Devices from the LonMaker menu. The following window appears.
3. Make the following selections:
Device Selection Scope Selects which subsystems will be searched for uncommissioned device shapes.
Options
Wink Interval Specifies number of seconds to wait between winking devices when more than one is selected.
Match using location string Uses location string, as well as channel and program ID, to match discovered devices with their device shapes through the automatic match feature (see the final Device Discovery window). This option is useful for networks that have a unique location string for each device or if you have a handheld tool that assigns a unique location string to each device.
Display location as text Interprets location string as ASCII text. Default is to display location string as hex digits.
Enable service pin matching Matches a device to a defined device by selecting the defined device and pressing the device service pin. The device whose service pin is pressed need not be in the discovered list; therefore, this method can be used to
commission devices that are in a configured state. However, it may not already be assigned to a different device. You can only select one device in the Defined Devices list when you press the service pin.
Include devices with unknown programs
Includes in the discovered device list discovered devices that have an unrecognized application or are without applications. When not selected, they will not be included. A discovered device can be matched to any device that is on the same channel, but must have an application image specified to be loaded (using the Details button).
Discover configured devices Discovers devices that have previously been configured. If you select this option, a dialog appears and you must indicate the domain of the configured devices to be discovered.
Allow channel override Disregards channel matching during the device matching procedure. If routers configured as repeaters are used, a device may be discovered on the wrong channel. This option allows you to force a match in this situation. If you select this option, you must manually ensure that the device shape and physical device lie on the same channel. Filters Limits which devices are discovered based on their
Channel or Device Template through a window that appears. This filter also limits devices displayed in Defined Devices (see Step 6). Additional dialogs are displayed so you can specify which channels and/or templates are used.
4. Click Next. If you select channel or device template filtering, windows appear allowing you to select one or more channels or device templates. Only devices with matching channels or device templates are discovered.
5. Click Next. If you set Discover Configured Devices, a window appears where you can select the domain on which configured devices will be discovered.
Note: If you wish to discover configured devices on multiple domains, select the first domain and click Next, then click Back in the next window to return to this window and select another domain. If there is a router between the LNS Server and the configured device or devices to be discovered, this router must be configured with the same domain as the device or devices to be discovered, unless it is configured as a repeater. If there are configured routers, you can temporarily change them to repeaters, complete the discovery, and then change them back.
This window allows you to match the discovered devices on the network with the device shapes in the LonMaker drawing. To select a device from any of the device lists, click the entry in the leftmost column of the device listing (i.e. the # column in the Discovered Devices list and the Subsystem column in the Defined Devices and Devices to be Commissioned lists)
If you set Include Devices with Unknown Programs, devices may be discovered with no device template. If this happens, discovered devices without applications are shown as Applicationless in the Template column. If a device has a program loaded and there is no corresponding device template, the devices program ID is displayed in hex digits. This window contains the following buttons:
Discover Searches for devices. If one or more devices on the network were not discovered, you can force their discovery by pressing their service pin while this dialog is open and then pressing the Discover button. This will not cause devices that were removed from the Discovered Devices list using the Exclude button to be rediscovered.
Wink Sends a Wink command to the device or devices selected in the Discovered Deviceslist. The action performed by the device is application dependent. Some devices may blink their power LED. This button is only available if one or more devices are selected in the Discovered Devices list.
Exclude Excludes the device or devices selected in the Discovered Devices or Defined Devices list. The only way to cause a device that has been excluded to reappear on the list is to restart the device discovery process. These buttons are only available if a device is selected in the appropriate device list.
Match Specifies the device selected in the Defined Devices list is to be matched with the device selected in the Discovered Devices list. This action removes the device from these lists and adds the
matched device to the Devices to be Commissionedlist. This button will only be available if one device is selected from each list and the selected devices are compatible.
To be compatible, devices must normally have the same device template and channel. If you set Allow Channel Override, the channel need not match. If you set Include Devices with
Unknown Programs, discovered devices without an application or which have an unknown program may be matched to any defined device, but they must have an application selected using the Details button before you click the Finish button.
If you set Enable Service Pin Matching, you may also match devices by selecting a device from the Defined Devices list and pressing the service pin of the device to which it should be matched. The defined device must still be compatible with the device whose service pin is pressed.
Auto Match Matches all discovered devices and defined devices that can be uniquely matched. The LonMaker tool removes them from the Discovered Devices and Defined Devices lists and places them on the Devices to be Commissioned list. In the previous graphic, the AO-10, DI-10, and DO-10 devices would be matched; but the AI-10 devices would not be matched because there is no way to determine which of the two discovered AI-10 devices should be matched to which defined AI-10 device shape.
Remove Removes the device(s) selected in the Devices to be Commissioned list. The device or devices are added to the Discovered Devices and Defined Devices lists. This button is only available if one or more devices are selected in the Devices to be Commissioned list.
This dialog allows you to set the same options available when commissioning devices one at a time. See Loading an Application Image and Setting the Device's State for more information. If you set Include Devices with Unknown Programs and a device without an application or that has an unknown program was matched, you must load an application compatible with the defined device using the Load Application Image option.
Click OK to close the Device Options dialog.
7. Click Finish to commission all the devices in the Devices to be Commissioned list. Devices will not be commissioned until you select an application image for all devices without applications and devices with unknown applications using the Details dialog.