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

Level 3 API 89
Level 3 API
The Level 3 API provides per-command access to the individual elements of the
underlying device control protocol. Level 3 is not portable across hardware types.
Level 3 commands are not dependant on the state of the device or of the reader
configuration; the same command with the same parameters will always send the same
message to the reader.
Level 3 commands validate their inputs to the extent necessary for communication with
the reader device (for example, limiting values to the number of bits permitted in the
protocol) but otherwise leave error checking to the device. Unless otherwise specified,
errors returned by the device are reported via instances of
ReaderCodeException . All Level
3 methods begin with “ cmd”.
If any Level 3 methods seem to be required to achieve the desired functionality we
recommend you contact [email protected] to discuss before using.
C A U T I O N !
! !
Making use of any commands in Level 3 or below guarantees cross-prod-
uct compatibility will be broken. These methods should only be used
when equivalent functionality is not available in Level 1 or Level 2. Level
3 APIs are not guaranteed to be the same on different versions of the
MercuryAPI.
W A R N I N G !
Level 3 functionality does not support the asynchronous operations in
Level 1 and Level 2. Level 3 operations are strictly synchronous,
blocking method calls and cannot be performed in parallel with other
threads interacting with
SerialReader devices.