Isiprocessresponse(), Isiprotocolversion(), Isireturntofactorydefaults() – Echelon ISI User Manual

Page 139

Advertising
background image

137

ISI Programmer’s Guide

IsiProcessResponse()

boolean IsiProcessResponse(void);

Processes a response to a request message sent in the domain acquisition process.
Only needs to be called on a DAS device.

DAS devices must call this function, or the fetch requests will fail.

E

XAMPLE

when (resp_arrives) {

if

(IsiProcessResponse()) {

// TODO: process non-ISI responses

}
}

IsiProtocolVersion()

unsigned IsiProtocolVersion(void);

Returns the version of the ISI protocol supported by the ISI engine, which is
always one for the Release 3 ISI Library. The number indicates the maximum

protocol version supported. The ISI engine also supports protocol versions less
than the number returned unless explicitly indicated.

No forwarder is provided for the IsiProtocolVersion() function. The function
operates in either state of the ISI engine.

IsiReturnToFactoryDefaults()

void IsiReturnToFactoryDefaults(void);

Restores the device’s self-installation data to factory defaults, causing the
immediate and unrecoverable loss of all connection information. This function

has the same functionality regardless of whether the ISI engine is running or not.
This function calls the IsiUpdateUserInterface() callback with the isiRun event,

stops the ISI engine, and then resets the device to complete the process.

Due to the reset, this function never returns to the caller. Any changes related to

returning to factory defaults, such as resetting of device-specific configuration
properties to their initial values, must occur prior to calling this function.

No forwarder is provided for this function.

E

XAMPLE

The following example returns to factory defaults if the device is returned to
self-installation mode after being installed in a managed network:

network input SCPTnwrkCnfg cp cp_info(reset_required) nciNetConfig
= CFG_EXTERNAL;
eeprom SCPTnwrkCnfg OldNetConfig = CFG_NUL;

when (reset) {
SCPTnwrkCnfg

cpNwrkConfig;

Advertising