User Manual

PLUS System Manual Location Software Library 79
Proprietary Information: Do not disclose unless authorized under a Nondisclosure Agreement and the Partner Agreement.
Removes a group from the tracker's database. The group must exist or an error is returned. Group 0 cannot be
deleted. It is created at startup to handle old configuration files and Readers not in the current configuration.
groupId is the ID for the group.
Returns
0 - Success
Less than zero - Invalid group ID
4.5.2.5 Group Entry Configuration
The functions in this section are used to add, remove, and configure Reader entries within the Groups.
4.5.2.5.1 AddOrUpdateGroupEntry Function
public virtual int AddOrUpdateGroupEntry( int readerIdLow ,
int readerIdHigh ,
int groupId,
double x ,
double y ,
double z ,
int readerState,
double calibrationValue,
int calibrationValid, )
This function adds a Reader entry to a group in the tracker's database. If the Reader entry already exists, it
updates the configuration.
readerIdLow is the lower four bytes of the Reader MAC address.
readerIdHigh is the upper two bytes of the Reader MAC address.
groupId is the ID for the group
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 - Invalid group ID or invalid parameters.