beautypg.com

Reading tags - the basics, Read methods, Reader.read() – ThingMagic Mercury API v1.23.0 User Manual

Page 25: Reader.read() 25

background image

Reading Tags - The Basics

Level 1 API

25

Reading Tags - The Basics

Read Methods

Reader Object

provides multiple ways of reading/inventorying tags. The tag reading

methods:



Reader.read()



Reader.startReading()

issue one or more search commands to the device to satisfy the user’s request for
searches of a particular duration, duty cycle, antennas, and protocols.

The result of a read operation is a collection of

TagReadData

objects, which provides

access to the information about the tag and the metadata associated with each tag read.

The default read behavior is to search for all tags on all detected antennas using all
supported protocols.

Level 2 API

can be used for advanced control over read behavior,

such as setting antennas (see

Antenna Usage

for more details), protocols and filtering

criteria used for the search. These are controlled by the

ReadPlan

object assigned to the

/

reader/read/plan

parameter of the

Reader Configuration Parameters

.

Note

Not all antennas are detectable by the readers. The antenna needs to have
some DC resistance if it is to be discovered by the antenna detection circuit.
If, when using the Level 1 read functionality, reads are not occurring it is
possible the antennas are not detectable and require explicit setting in the

ReadPlan

.

Reader.read()

The

read() method takes a single parameter:

TagReadData[] Reader.read(long duration)