Package com.metratec.lib.rfidreader.uhf
Class UHFReaderGen2
- java.lang.Object
-
- com.metratec.lib.rfidreader.MetratecReader<T>
-
- com.metratec.lib.rfidreader.MetratecReaderGen2<UhfTag>
-
- com.metratec.lib.rfidreader.uhf.UHFReaderGen2
-
- Direct Known Subclasses:
PulsarLR
public class UHFReaderGen2 extends MetratecReaderGen2<UhfTag>
Uhf reader gen2 class
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
UHFReaderGen2.MEMBANK
Enum for the UHF Tag membankstatic class
UHFReaderGen2.REGION
the available uhf regions
-
Field Summary
-
Fields inherited from class com.metratec.lib.rfidreader.MetratecReader
STATE_CONFIGURING, STATE_CONNECTING, STATE_RUNNING, STATE_STOPPED, STATE_WAITING_FOR_RECONNECT
-
-
Constructor Summary
Constructors Constructor Description UHFReaderGen2(java.lang.String identifier, ICommConnection connection)
Create a new instance
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.util.List<UhfTagAuth>
callImpinjAuthenticationService()
This command tags to an Impinj M775 tag using the proprietary authentication command.java.util.List<UhfTag>
changeKillPassword(java.lang.String oldPassword, java.lang.String newPassword)
Change/Set the kill passwordjava.util.List<UhfTag>
changeKillPassword(java.lang.String oldPassword, java.lang.String newPassword, java.lang.String epcMask)
Change/Set the kill passwordjava.util.List<UhfTag>
changeLockPassword(java.lang.String oldPassword, java.lang.String newPassword)
Change/Set the lock passwordjava.util.List<UhfTag>
changeLockPassword(java.lang.String oldPassword, java.lang.String newPassword, java.lang.String epcMask)
Change/Set the lock passwordjava.lang.String
executeCommand(java.lang.String command, java.lang.Object... parameters)
Send a custom commandCustomImpinjSettings
getCustomImpinjSettings()
Returns the current custom impinj settingsjava.util.List<UhfTag>
getInventoryReport(java.lang.Integer duration)
UHFInventorySetting
getInventorySettings()
UHFReaderGen2.REGION
getRegion()
java.lang.String
getRfMode()
Returns the current rf mode.java.lang.String
getSession()
Returns the current selected session.java.util.List<UhfTag>
getTagData(int startAddress, int length)
Reads the data from the tags.java.util.List<UhfTag>
getTagData(int startAddress, int length, java.lang.String epcMask)
Reads the data from the tags.java.util.List<UhfTag>
getTagData(UHFReaderGen2.MEMBANK membank, int startAddress, int length, java.lang.String epcMask)
Reads a memory from the tags.UHFTagSizeSetting
getTagSize()
java.util.List<UhfTag>
getTagTIDs()
Reads the TID from the tag.java.util.List<UhfTag>
getTagTIDs(int length, java.lang.String epcMask)
Reads the TID from the tag with a predefined length.java.util.List<UhfTag>
killTag(java.lang.String password)
Kill tagsjava.util.List<UhfTag>
killTag(java.lang.String password, java.lang.String epcMask)
Kill tagsjava.util.List<UhfTag>
lockTag(UHFReaderGen2.MEMBANK membank, java.lang.String password, java.lang.String epcMask)
Lock a tag memoryjava.util.List<UhfTag>
lockTagData(java.lang.String password)
Lock a tag datajava.util.List<UhfTag>
lockTagData(java.lang.String password, java.lang.String epcMask)
Lock a tag datajava.util.List<UhfTag>
lockTagEpc(java.lang.String password)
Lock a tag epcjava.util.List<UhfTag>
lockTagEpc(java.lang.String password, java.lang.String epcMask)
Lock a tag epcjava.util.List<UhfTag>
lockTagEpcPermament(java.lang.String password)
Lock a tag epc permamentjava.util.List<UhfTag>
lockTagEpcPermament(java.lang.String password, java.lang.String epcMask)
Lock a tag epc permamentjava.util.List<UhfTag>
lockTagMemoryPermament(java.lang.String password)
Lock a tag user data permamentjava.util.List<UhfTag>
lockTagMemoryPermament(java.lang.String password, java.lang.String epcMask)
Lock a tag user data permamentjava.util.List<UhfTag>
lockTagPermament(UHFReaderGen2.MEMBANK membank, java.lang.String password)
Lock a tag memory permamentjava.util.List<UhfTag>
lockTagPermament(UHFReaderGen2.MEMBANK membank, java.lang.String password, java.lang.String epcMask)
Lock a tag memory permamentvoid
resetBitmask()
Resets the reader bitmaskvoid
resetMask()
Resets the reader maskvoid
setBitmask(UHFReaderGen2.MEMBANK membank, int startAddress, java.lang.String mask)
Set a reader maskvoid
setCustomImpinjSettings(CustomImpinjSettings settings)
The RFID tag IC manufacturer Impinj has added two custom features to its tag ICs that are not compatible with tag ICs from other manufacturers.void
setEpcMask(java.lang.String mask)
Set a reader epc maskvoid
setInventorySettings(UHFInventorySetting settings)
Set the uhf inventory settingsvoid
setMask(UHFReaderGen2.MEMBANK membank, int startAddress, java.lang.String mask)
Set a reader maskvoid
setRegion(UHFReaderGen2.REGION region)
Sets the uhf regionvoid
setRfMode(java.lang.String modeId)
Configure the internal RF communication settings between tag and reader.void
setSession(java.lang.String sessionId)
Manually select the session according to the EPC Gen 2 Protocol to use during inventory scan.java.util.List<UhfTag>
setTagData(int startAddress, java.lang.String data)
Set the tag datajava.util.List<UhfTag>
setTagData(int startAddress, java.lang.String data, java.lang.String epcMask)
Set the tag datajava.util.List<UhfTag>
setTagData(UHFReaderGen2.MEMBANK membank, int startAddress, java.lang.String data, java.lang.String epcMask)
Write a memory from the tags.java.util.List<UhfTag>
setTagEpc(int startAddress, java.lang.String epc)
Set the tag epcjava.util.List<UhfTag>
setTagEpc(java.lang.String tid, int startAddress, java.lang.String epc)
Set the tag epcvoid
setTagSize(UHFTagSizeSetting setting)
Set the tag sizejava.util.List<UhfTag>
unlockTag(UHFReaderGen2.MEMBANK membank, java.lang.String password)
Unlock a tag memoryjava.util.List<UhfTag>
unlockTag(UHFReaderGen2.MEMBANK membank, java.lang.String password, java.lang.String epcMask)
Unlock a tag memoryjava.util.List<UhfTag>
unlockTagData(java.lang.String password)
Unlock a tag datajava.util.List<UhfTag>
unlockTagData(java.lang.String password, java.lang.String epcMask)
Unlock a tag datajava.util.List<UhfTag>
unlockTagEpc(java.lang.String password)
Unlock a tag epcjava.util.List<UhfTag>
unlockTagEpc(java.lang.String password, java.lang.String epcMask)
Unlock a tag epc-
Methods inherited from class com.metratec.lib.rfidreader.MetratecReaderGen2
checkAntennas, enableInputEvents, getAntennaPort, getFirmwareRevision, getHardwareRevision, getInput, getInventory, getInventoryMultiplex, getInventoryMultiplex, getMultiplexAntennas, getOutput, getReaderType, getRevision, getSerialNumber, ping, reset, setAntennaPort, setMultiplexAntennas, setMultiplexAntennas, setOutput, standby, startInventory, startInventoryReport, stop, stopInventory, stopInventoryReport, wakeUp
-
Methods inherited from class com.metratec.lib.rfidreader.MetratecReader
connect, connect, disconnect, getIdentifier, getInputDebounceTime, getReceiveTimeout, isConnected, setIdentifier, setInputDebounceTime, setMaxReconnectWaitTime, setMinReconnectWaitTime, setReaderEventListener, setReceiveTimeout, setTagEventListener, start, start, startAndWait, startAndWait, startInventory
-
-
-
-
Constructor Detail
-
UHFReaderGen2
public UHFReaderGen2(java.lang.String identifier, ICommConnection connection)
Create a new instance- Parameters:
identifier
- the reader identifierconnection
- the connection
-
-
Method Detail
-
getInventoryReport
public java.util.List<UhfTag> getInventoryReport(java.lang.Integer duration) throws CommConnectionException, RFIDReaderException
- Parameters:
duration
- the report execution duration- Returns:
- the founded tags as list
- Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
getInventorySettings
public UHFInventorySetting getInventorySettings() throws CommConnectionException, RFIDReaderException
- Returns:
- the current ufh inventory settings
UHFInventorySetting
} - Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
setInventorySettings
public void setInventorySettings(UHFInventorySetting settings) throws CommConnectionException, RFIDReaderException
Set the uhf inventory settings- Parameters:
settings
-UHFInventorySetting
- Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
setRegion
public void setRegion(UHFReaderGen2.REGION region) throws CommConnectionException, RFIDReaderException
Sets the uhf region- Parameters:
region
-UHFReaderGen2.REGION
- Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
getRegion
public UHFReaderGen2.REGION getRegion() throws CommConnectionException, RFIDReaderException
- Returns:
- the current ufh region
- Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
getTagSize
public UHFTagSizeSetting getTagSize() throws CommConnectionException, RFIDReaderException
- Returns:
- the current tag size settings
UHFTagSizeSetting
} - Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
setTagSize
public void setTagSize(UHFTagSizeSetting setting) throws CommConnectionException, RFIDReaderException
Set the tag size- Parameters:
setting
-UHFTagSizeSetting
- Throws:
CommConnectionException
- if an communication error occursRFIDReaderException
- if an reader error occurs
-
getTagTIDs
public java.util.List<UhfTag> getTagTIDs() throws CommConnectionException, RFIDReaderException
Reads the TID from the tag.- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
getTagTIDs
public java.util.List<UhfTag> getTagTIDs(int length, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Reads the TID from the tag with a predefined length.- Parameters:
length
- length of TID wordsepcMask
- the epc mask- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
getTagData
public java.util.List<UhfTag> getTagData(int startAddress, int length) throws CommConnectionException, RFIDReaderException
Reads the data from the tags.- Parameters:
startAddress
- start addresslength
- number of words to read (0 for all) - word == 4 byte- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
getTagData
public java.util.List<UhfTag> getTagData(int startAddress, int length, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Reads the data from the tags.- Parameters:
startAddress
- start addresslength
- number of words to read (0 for all) - word == 4 byteepcMask
- the epc mask- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
getTagData
public java.util.List<UhfTag> getTagData(UHFReaderGen2.MEMBANK membank, int startAddress, int length, java.lang.String epcMask) throws RFIDReaderException, CommConnectionException
Reads a memory from the tags.- Parameters:
membank
- MEMBANK (EPC,USR,TID,RES)startAddress
- start addresslength
- number of words to read (0 for all) - word == 4 byteepcMask
- epc mask, ascii encode n*4 length- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setTagEpc
public java.util.List<UhfTag> setTagEpc(java.lang.String tid, int startAddress, java.lang.String epc) throws RFIDReaderException, CommConnectionException
Set the tag epc- Parameters:
tid
- tag idstartAddress
- start addressepc
- new epc, length must by multiple of 4- Returns:
- List with processed transponders - contains the old EPCs
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setTagEpc
public java.util.List<UhfTag> setTagEpc(int startAddress, java.lang.String epc) throws RFIDReaderException, CommConnectionException
Set the tag epc- Parameters:
startAddress
- start addressepc
- new epc, length must by multiple of 4- Returns:
- List with processed transponders - contains the old EPCs
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setTagData
public java.util.List<UhfTag> setTagData(int startAddress, java.lang.String data, java.lang.String epcMask) throws RFIDReaderException, CommConnectionException
Set the tag data- Parameters:
startAddress
- start addressdata
- hex data to write, length must by multiple of 4epcMask
- Optional, the epc mask to use- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setTagData
public java.util.List<UhfTag> setTagData(int startAddress, java.lang.String data) throws RFIDReaderException, CommConnectionException
Set the tag data- Parameters:
startAddress
- start addressdata
- hex data to write, length must by multiple of 4- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setTagData
public java.util.List<UhfTag> setTagData(UHFReaderGen2.MEMBANK membank, int startAddress, java.lang.String data, java.lang.String epcMask) throws RFIDReaderException, CommConnectionException
Write a memory from the tags.- Parameters:
membank
- MEMBANK (EPC,USR,TID,RES)startAddress
- start addressdata
- hex data to write, length must by multiple of 4epcMask
- Optional, the epc mask to use- Returns:
- List with processed transponders
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setMask
public void setMask(UHFReaderGen2.MEMBANK membank, int startAddress, java.lang.String mask) throws CommConnectionException, RFIDReaderException
Set a reader mask- Parameters:
membank
- the memory to checkstartAddress
- the start addressmask
- the mask- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setEpcMask
public void setEpcMask(java.lang.String mask) throws CommConnectionException, RFIDReaderException
Set a reader epc mask- Parameters:
mask
- the epc mask- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
resetMask
public void resetMask() throws CommConnectionException, RFIDReaderException
Resets the reader mask- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
setBitmask
public void setBitmask(UHFReaderGen2.MEMBANK membank, int startAddress, java.lang.String mask) throws CommConnectionException, RFIDReaderException
Set a reader mask- Parameters:
membank
- the memory to checkstartAddress
- the start addressmask
- the binary mask, e.g. '0110'- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
resetBitmask
public void resetBitmask() throws CommConnectionException, RFIDReaderException
Resets the reader bitmask- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
killTag
public java.util.List<UhfTag> killTag(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Kill tags- Parameters:
password
- the kill passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the kill was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
killTag
public java.util.List<UhfTag> killTag(java.lang.String password) throws CommConnectionException, RFIDReaderException
Kill tags- Parameters:
password
- the kill password- Returns:
List
with handledUhfTag
s. If the tag has error, the kill was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTag
public java.util.List<UhfTag> lockTag(UHFReaderGen2.MEMBANK membank, java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Lock a tag memory- Parameters:
membank
- the memory to lockpassword
- the memory passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagData
public java.util.List<UhfTag> lockTagData(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Lock a tag data- Parameters:
password
- the data passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagData
public java.util.List<UhfTag> lockTagData(java.lang.String password) throws CommConnectionException, RFIDReaderException
Lock a tag data- Parameters:
password
- the data password- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagEpc
public java.util.List<UhfTag> lockTagEpc(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Lock a tag epc- Parameters:
password
- the passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagEpc
public java.util.List<UhfTag> lockTagEpc(java.lang.String password) throws CommConnectionException, RFIDReaderException
Lock a tag epc- Parameters:
password
- the password- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagPermament
public java.util.List<UhfTag> lockTagPermament(UHFReaderGen2.MEMBANK membank, java.lang.String password) throws CommConnectionException, RFIDReaderException
Lock a tag memory permament- Parameters:
membank
- the memory to lockpassword
- the memory password- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagPermament
public java.util.List<UhfTag> lockTagPermament(UHFReaderGen2.MEMBANK membank, java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Lock a tag memory permament- Parameters:
membank
- the memory to lockpassword
- the memory passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagMemoryPermament
public java.util.List<UhfTag> lockTagMemoryPermament(java.lang.String password) throws CommConnectionException, RFIDReaderException
Lock a tag user data permament- Parameters:
password
- the memory password- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagMemoryPermament
public java.util.List<UhfTag> lockTagMemoryPermament(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Lock a tag user data permament- Parameters:
password
- the memory passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagEpcPermament
public java.util.List<UhfTag> lockTagEpcPermament(java.lang.String password) throws CommConnectionException, RFIDReaderException
Lock a tag epc permament- Parameters:
password
- the memory password- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
lockTagEpcPermament
public java.util.List<UhfTag> lockTagEpcPermament(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Lock a tag epc permament- Parameters:
password
- the memory passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the lock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
unlockTag
public java.util.List<UhfTag> unlockTag(UHFReaderGen2.MEMBANK membank, java.lang.String password) throws CommConnectionException, RFIDReaderException
Unlock a tag memory- Parameters:
membank
- the memory to unlockpassword
- the memory password- Returns:
List
with handledUhfTag
s. If the tag has error, the unlock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
unlockTag
public java.util.List<UhfTag> unlockTag(UHFReaderGen2.MEMBANK membank, java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Unlock a tag memory- Parameters:
membank
- the memory to unlockpassword
- the memory passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the unlock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
unlockTagData
public java.util.List<UhfTag> unlockTagData(java.lang.String password) throws CommConnectionException, RFIDReaderException
Unlock a tag data- Parameters:
password
- the data password- Returns:
List
with handledUhfTag
s. If the tag has error, the unlock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
unlockTagData
public java.util.List<UhfTag> unlockTagData(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Unlock a tag data- Parameters:
password
- the data passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the unlock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
unlockTagEpc
public java.util.List<UhfTag> unlockTagEpc(java.lang.String password) throws CommConnectionException, RFIDReaderException
Unlock a tag epc- Parameters:
password
- the memory password- Returns:
List
with handledUhfTag
s. If the tag has error, the unlock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
unlockTagEpc
public java.util.List<UhfTag> unlockTagEpc(java.lang.String password, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Unlock a tag epc- Parameters:
password
- the memory passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the unlock was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
changeKillPassword
public java.util.List<UhfTag> changeKillPassword(java.lang.String oldPassword, java.lang.String newPassword) throws CommConnectionException, RFIDReaderException
Change/Set the kill password- Parameters:
oldPassword
- the old passwordnewPassword
- the new password- Returns:
List
with handledUhfTag
s. If the tag has error, the password change was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
changeKillPassword
public java.util.List<UhfTag> changeKillPassword(java.lang.String oldPassword, java.lang.String newPassword, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Change/Set the kill password- Parameters:
oldPassword
- the old passwordnewPassword
- the new passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the password change was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
changeLockPassword
public java.util.List<UhfTag> changeLockPassword(java.lang.String oldPassword, java.lang.String newPassword) throws CommConnectionException, RFIDReaderException
Change/Set the lock password- Parameters:
oldPassword
- the old passwordnewPassword
- the new password- Returns:
List
with handledUhfTag
s. If the tag has error, the password change was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
changeLockPassword
public java.util.List<UhfTag> changeLockPassword(java.lang.String oldPassword, java.lang.String newPassword, java.lang.String epcMask) throws CommConnectionException, RFIDReaderException
Change/Set the lock password- Parameters:
oldPassword
- the old passwordnewPassword
- the new passwordepcMask
- optional, the epc mask to use- Returns:
List
with handledUhfTag
s. If the tag has error, the password change was not successful- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
executeCommand
public java.lang.String executeCommand(java.lang.String command, java.lang.Object... parameters) throws CommConnectionException, RFIDReaderException
Send a custom command- Parameters:
command
- the reader commandparameters
- the command parameters- Returns:
- the reader response
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an protocol exception occurs (e.g. CRC error, value out of range, ..)
-
callImpinjAuthenticationService
public java.util.List<UhfTagAuth> callImpinjAuthenticationService() throws CommConnectionException, RFIDReaderException
This command tags to an Impinj M775 tag using the proprietary authentication command. It sends a random challenge to the transponder and gets the authentication payload in return. You can use this to check the authenticity of the transponder with Impinj Authentication Service. For further details, please contact Impinj directly.- Returns:
- the transponder responses
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
setSession
public void setSession(java.lang.String sessionId) throws CommConnectionException, RFIDReaderException
Manually select the session according to the EPC Gen 2 Protocol to use during inventory scan. Default value is "auto" and in most cases this should stay auto. Only change this if you absolutely know what you are doing and if you can control the types of tags you scan. Otherwise, unexpected results during inventory scans with "only new tags" active might happen.- Parameters:
sessionId
- session to set ["0", "1", "2", "3", "AUTO"]- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
getSession
public java.lang.String getSession() throws CommConnectionException, RFIDReaderException
Returns the current selected session. See SetSession for more details.- Returns:
- the current selected session
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
setRfMode
public void setRfMode(java.lang.String modeId) throws CommConnectionException, RFIDReaderException
Configure the internal RF communication settings between tag and reader. Each mode ID corresponds to a set of RF parameters that fit together. Not all devices support all modes and not all modes can be access in all regions. See reader description for more detail.- Parameters:
modeId
- mode id- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
getRfMode
public java.lang.String getRfMode() throws CommConnectionException, RFIDReaderException
Returns the current rf mode. See SetRfMode for more details.- Returns:
- the current selected session
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
setCustomImpinjSettings
public void setCustomImpinjSettings(CustomImpinjSettings settings) throws CommConnectionException, RFIDReaderException
The RFID tag IC manufacturer Impinj has added two custom features to its tag ICs that are not compatible with tag ICs from other manufacturers. Activate these features with this command. But make sure that you only use tags with Impinj ICs like Monza6 or M7xx or M8xx series. Tags from other manufacturers will most likely not answer at all when those options are active!- Parameters:
settings
- the custom impinj settings- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
getCustomImpinjSettings
public CustomImpinjSettings getCustomImpinjSettings() throws CommConnectionException, RFIDReaderException
Returns the current custom impinj settings- Returns:
- the current custom impinj settings
- Throws:
CommConnectionException
- if an communication exception occursRFIDReaderException
- if an reader exception occurs
-
-