beautypg.com

Status reporting, Statuslistener – ThingMagic Mercury API v1.23.0 User Manual

Page 32

background image

Status Reporting

32

Level 1 API

Status Reporting

Status information about the reader and the environment the reader is operating in is
available both while the reader is idle and during active background reading.

Note

Status reporting is currently only available for

SerialReader

type readers which

support

Continuous Reading

, only the M6e at this time

.

StatusListener

During

Continuous Reading

operations it is possible to get status reports at every

frequency hop by the reader. A StatusReport object is sent to each Status listener upon
receiving the status response. A status report can contain the following information:



Temperature - The current temperature of the reader as detected on the RF board.



Frequency - The frequency the reader just completed using. This is the frequency the

noise floor is reported on.



Tx and Rx port - The antenna port that the reader just completed an operation on,

which the status is associated with.



Protocol - The protocol that the reader is currently using.



RF On time - The cumulative time this port has been actively transmitting since the

reader was rebooted or this statistic was reset. (This information can be used with
total time to calculate the average transmit duty cycle since reset.)



Noise Floor- The noise floor at the current frequency with TX on. (This information

can be used to measure changes in the amount of reflected power in the RF
environment.)

The specific status report fields returned are defined by the

Reader Configuration

Parameters

under

/reader/status

.

The desired status report fields must be explicitly selected. All default to off (false) to
minimize communications overhead.