User Manual

80 Location Software Library PLUS System Manual
Proprietary Information: Do not disclose unless authorized under a Nondisclosure Agreement and the Partner Agreement.
4.5.2.5.2 GetGroupEntry Function
public virtual int GetGroupEntry( int readerIdLow ,
int readerIdHigh ,
int groupId,
double out x ,
double out y ,
double out z ,
int out readerState,
double out calibrationValue,
int out calibrationValid, )
This function retrieves a Reader entry from a group. The Reader entry must already exist or an error is returned.
readerIdLow is the lower four bytes of the Reader MAC address of the requested Reader entry.
readerIdHigh is the upper two bytes of the Reader MAC address of the requested Reader entry.
groupId is the ID for the group of the requested Reader entry.
x,y,z is the location of the Reader, units are meters.
readerState indicates whether the Reader is enabled for this group. A Reader can be enabled in one group and
disabled in another group.
calibrationValue is the TOA correction factor that is added to each TOA received for this Reader in this group. The
same Reader in another group can have a different Calibration value.
calibrationValid is a flag indicating that calibrationValue is valid. If a Reader has been calibrated, the calibration
constant should be passed in calibrationValue and calibrationValid should be set to TRUE. If a Reader has not been
calibrated, then calibrationValid should be set to FALSE and the Location Software will ignore calibrationValue .
Returns
0 - Success
less than zero – Reader entry does not exist.
4.5.2.5.3 GetNextGroupEntry Function
public virtual int GetNextGroupEntry( int groupId ,
int currentReaderIdLow ,
int currentReaderIdHigh ,
int nextReaderIdLow ,
int nextReaderIdHigh )
Retrieves the next Reader in a group given a Reader MAC address. The next Reader MAC address is the next
higher value. To get the first Reader in the group, pass 0 in the currentReaderIdLow and currentReaderIdHigh
parameters.
groupId is the ID of the group containing the Readers.
currentReaderIdLow is the lower four bytes of the current Reader MAC address.
currentReaderIdHi is the upper two bytes of the current Reader MAC address.
nextReaderIdLow is the lower four bytes of the next Reader MAC address.