Echelon ISI - Manual (Page 149)

147 ISI Programmer’s Guide
IsiGetPrimaryDid()
const unsigned* IsiGetPrimaryDid(unsigned* pLength );
Returns a pointer to the default primary domain ID for the device. The function
also provides the domain ID length in the location provided by the
pLength
parameter. Domain IDs may be 1, 3, or 6 bytes long—the 0-length domain ID
cannot be used for the primary domain. Only the number of bytes provided
through the pLength output parameter must be valid in the returned pointer.
You can override this function to override the ISI standard domain ID value.
This function is only used to create a non-ISI system.
Both length and value of the domain ID provided are considered constant once
the ISI engine is running. To change the primary domain ID at runtime using
the IsiGetPrimaryDid() callback, stop and re-start the ISI engine.
No forwarder is provided with this function.
Warning: Non ISI devices will not interoperate with ISI devices.
IsiGetPrimaryGroup()
unsigned IsiGetPrimaryGroup(unsigned Assembly );
Returns the group ID for the specified assembly. The default implementation
returns ISI_DEFAULT_GROUP (128). This function is only required if the
default implementation, or the forwardee, of IsiCreateCsmo() is in use.
No forwarder is provided with IsiGetPrimaryGroup().
The function operates whether the ISI engine is running or not.
IsiGetRepeatCount()
unsigned IsiGetRepeatCount(void);
Specifies the repeat count used with all network variable connections, where all
connections share the same repeat counter. The repeat counter value is
considered constant for the lifetime of the application, and will only be queried
when the device powers up the first time after a new application image has been
loaded and every time IsiReturnToFactoryDefaults() runs. Only repeat counts of
1, 2 or 3 are supported. To take full advantage of the secondary frequency on a
PL transceiver, only use a repeat count of 1 or 3. This function has no affect on
ISI messages.
The default implementation of this function always returns 3.
This function operates whether the ISI engine is running or not.