Isipl3170 – Echelon ISI User Manual

Page 100

Advertising
background image

ISI Programmer’s Guide

98

To identify the smallest possible ISI implementation that meets your application

needs, start with the leftmost column (IsiCompactManual.lib) and proceed
towards the right until you have found a library that supports all required

features. When in doubt and device resources allowing, prefer using IsiFull.lib.

IsiPl3170

The core ISI functions for an ISI-S or ISI-DA device are embedded in the read-
only memory (ROM) of a PL 3170 Smart Transceiver. The IsiPl3170.lib library

supports all of the core features of ISI, except the IsiUpdateDiagnostics() callback
function.

For a PL 3170 device, you must use the IsiPl3170.lib library; if you select a
different library, the ISI engine will not start. This library is not supported for

other device types.

You must use the Neuron Linker Version 4.04.08, or later, to link your
application with the IsiPl3170.lib library. Previous versions of the linker do not

support this library. Neuron Linker Version 4.04.08 is available with Service
Pack 4 or later for the NodeBuilder 3.1 Development Tool.

The ISI engine for a PL 3170 device is delivered in two parts (one part in device
ROM and the other in the IsiPl3170.lib library). Because the links between the

ISI engine in the PL 3170 ROM and the callbacks in the application are defined
when the device resets, you must call the IsiPreStart() function from the

when(reset) task before calling any other ISI functions. You must call this

function even if you do not plan to start the ISI engine.

The PL 3170 Smart Transceiver does not support the ISI-DAS functions.
Therefore, your PL 3170 ISI application should not use DAS-specific functions,

such as IsiProcessMsgDas() or IsiApproveMsgDas(). In addition, your PL 3170

ISI application should not use generic ISI functions, such as IsiStart() or

Is

iC

om

pa

ct

M

an

ua

l.li

b

Is

iC

om

pa

ct

Au

to.

lib

Is

iC

om

pa

ct

S.

lib

Is

iC

omp

ac

tS

Hb

.li

b

Is

iC

om

pa

ct

Da

.lib

Is

iC

om

pa

ct

DaH

b.

lib

Is

iF

ul

l.li

b

Core Func tions

X X X X X X X

M anual E nrollm ent

X

X X X X X

A utom atic E nrollm ent

X X X X X X

A lias es (ex tending enrollm ent)

X X X X X

Heartbeats

X

X X

Connec tion Rem oval

X

Turnaround Connec tions

X

Dom ain A c quis ition

X X X

Tim ing Guidanc e

X X X X X

Diagnos tic s

X

Advertising