ThingMagic Mercury API v1.23.0 - Manual (Page 36)

Advanced Reading
36 Level 2 API
Advanced Reading
ReadPlan
An object of class ReadPlan specifies the antennas, protocol and filters to use for a
search ( Read Methods ). The ReadPlan used by a search is specified by setting /reader/
read/plan in Reader Configuration Parameters . The three current subclasses are:

SimpleReadPlan

StopTriggerReadPlan

MultiReadPlan
Each ReadPlan object contains a numeric weight parameter that controls the fraction
of the search used by that plan when combined in a MultiReadPlan .
SimpleReadPlan
A SimpleReadPlan constructor accepts the following parameters:

Tag Protocol - defines the protocol to search on. The default is Gen2. To search on
multiple protocols a MultiReadPlan should be used.
 int[] of antennas - defines which antennas (or virtual antenna numbers) to use in
the search. The default value is a zero-length list.
– When the list of antennas is zero-length the reader will run antenna detection on
each port in /reader/antenna/portList and use all detected antennas.
– When the list of antennas is not zero-length, all the specified antennas will be
used, unless /reader/antenna/checkPort is enabled in which case the list can only
include detectable antennas.
See Antenna Usage for more information on antenna configuration and usage.
Note
Not all antennas are detectable by the readers. The antenna needs to have
some DC resistance if it is to be discovered by our antenna detection circuit.
If, when using the zero-length array method requiring antenna detect, reads
are not occurring it is possible the antennas are not detectable and require
explicit setting.

TagFilter Interface - defines a subset of tags to search for.

TagOp Invocation - defines a tag operation (ReadData, WriteData, Lock, Kill, etc.) to be
performed on each tag found, as its found. When read operations are performed the