Echelon ISI User Manual

Page 47

ISI Programmer’s Guide

IsiEvent Value

Note

isiWarm

The ISI engine has warmed up (i.e. a

predetermined time with a random component

has passed since the last reset). From this
moment on, the application may call the

IsiInitiateAutoEnrollment() function.
This event occurs no sooner than the expiry of
the T

auto

ISI protocol timer, but may occur later.

isiPendingHost

The connection related to the assembly given

with the numerical parameter has entered the

pending state. This event occurs on a
connection host after it has issued a connection

invitation (CSMO) but not yet received any

enrollment acceptance messages (CSMEs).
This event only applies to a connection host.

For a connection member see isiPending.

isiApprovedHost

The connection indicated with the numerical

parameter changed from the pending state to
the approved state. This event occurs on a

connection host at the receipt of the first

connection enrollment acceptance message
(CSME). This event only applies to a

connection host. For a connection member see

isiApproved.

isiAborted

The device stopped domain or device

acquisition. The parameter is a member of the
IsiAbortReason enumeration and indicates the

reason for the abort.

isiRetry

The device is retrying the device acquisition

procedure. The parameter is the remaining
number of retries.

isiWink

The device should perform its wink function.
The specific function is application-dependent,

but should provide some visible feedback to the

user. For example, the application may blink
an LED on the device.

isiRegistered

This event indicates either acquisition start or
successful acquisition completion on either an

ISI-DA or ISI-DAS device. The parameter

indicates either a successful start (parameter =
0) or completion (parameter = 0xFF).

You can override the IsiUpdateUserInterface() callback function with an
application-specific function to provide application-specific user feedback. The

default implementation of this function does nothing, and is only useful for

devices that exclusively use automatic enrollment.