Echelon LNS - Manual (Page 130)

LNS Programmer's Guide 116
3. Assign the Neuron ID acquired in step 2 to the AppDevice object you created for the
device whose service pin was activated. You can do so by writing to the AppDevice
object’s NeuronId property.
MyAppDevice.NeuronId = AcquiredNeuronId
4. Invoke the EndServicePinEvent() method to cancel your application’s subscription to
service pin events.
MySystem.EndServicePinEvent()
Confirmed Service Pin Protocol
The confirmed service pin protocol includes additional steps you can take to ensure that
the service pin event your application receives is from the expected device on the
network. You should use the confirmed service pin protocol on systems using shared
media to ensure that you have not received a service pin message from a device that
belongs to another system. You should also consider using the confirmed service pin
protocol on systems using private media if multiple technicians are installing different
devices simultaneously. For more information on shared media, see Using Shared Media
on page 167.
To use the confirmed service pin protocol to determine a device’s neuron ID, follow these
steps:
1. Acquire the device’s Neuron ID using the OnSystemServicePin event, and assign the
Neuron ID to the NeuronId property of the AppDevice object you have created for the
device. Before you write to the NeuronId property, you should read the property and
preserve a copy of the previous value. These tasks are described in steps 1-3 of the
procedure in the previous section.
2. To confirm that you have found the correct device, wink the device by invoking the
Wink() method.
MyAppDevice.Wink()
NOTE: When using the confirmed service pin protocol on a router, you should use the
Reset() method for this step.
3. When a device receives a wink command, it responds in a way that can be easily detected
by someone at the device’s location. For example, lights can blink, alarms can ring, and
displays can flash. Once the device is winked, someone on-site should press the service
pin a second time, to acknowledge that the correct device was winked.
NOTE: When using the confirmed service pin protocol on a router, the router will reset
and indicate this via its reset LED.
4. The OnSystemServicePin event will be fired a second time. If the neuronId element
returned by the event matches the one acquired in step 1, then you can assume that you
have located the correct device. Otherwise, restore the AppDevice object’s NeuronId
property to the original value preserved in step 1.
5. Invoke the EndServicePinEvent() method to cancel your application’s subscription to
service pin events.
MySystem.EndServicePinEvent()