DR-U-USB/DR-E-USB RLMXX0CLASS  GT20171121-1
Functions
"RLMXXX Access Commands"

Class members used manipulate a Tag. More...

Functions

quint8 RLMXXXCRC::ReadData (const QByteArray &AccessPwd, quint8 Bank, const QByteArray &Ptr, quint8 Cnt, QByteArray &Tid, QByteArray &ReadData, quint8 &ec)
 Function to read the Tag memory. More...
 
quint8 RLMXXXCRC::ReadBatch (const QByteArray &AccessPwd, const quint8 Option, const quint8 initQ, const QList< QByteArray > &BatchList)
 Function to read multible areas of a TAG memory with a single command. More...
 
quint8 RLMXXXCRC::RetriveBatchData (QList< QByteArray > &Results)
 Function to retrive the Tag identifiers and additional bank reads from an inventory round. More...
 
quint8 RLMXXXCRC::FastAuth (const QList< QByteArray > AccessPwdList, const QByteArray &Tid, quint8 &ec)
 Function Fast authentication. More...
 
quint8 RLMXXXCRC::WriteWord (const QByteArray &AccessPwd, quint8 Bank, const QByteArray &Ptr, const QByteArray &WriteData, const QByteArray Tid, quint8 &ec)
 Function writes a single word to Tag memory. More...
 
quint8 RLMXXXCRC::WriteData (const QByteArray &AccessPwd, quint8 Bank, QByteArray &Ptr, quint8 Cnt, const QByteArray &WriteData, QByteArray &Tid, quint8 &ec)
 Function writes multiple words to Tag memory. More...
 
quint8 RLMXXXCRC::WriteEPC (const QByteArray &AccessPwd, const QByteArray &Tid, const QByteArray &Epc, quint8 &ec)
 Function to write EPC to Tag memory. More...
 
quint8 RLMXXXCRC::EraseData (const QByteArray &AccessPwd, quint8 Bank, const QByteArray &Ptr, quint8 Cnt, QByteArray &Tid, quint8 &ec)
 Function to erase data from Tag memory. More...
 
quint8 RLMXXXCRC::LockMem (const QByteArray &AccessPwd, const QByteArray &LockData, const QByteArray &Tid, quint8 &ec)
 Function to lock memory regions of a Tag. More...
 
quint8 RLMXXXCRC::KillTag (const QByteArray &KillPwd, const QByteArray &Tid, quint8 &ec)
 Function to kill a Tag. More...
 

Detailed Description

Class members used manipulate a Tag.

The function of this group used to access the Tags memory banks. Functions for block read/write and custom commands destined for access bank 0,1,3 of the tags memory.

Function Documentation

◆ EraseData()

quint8 RLMXXXCRC::EraseData ( const QByteArray &  AccessPwd,
quint8  Bank,
const QByteArray &  Ptr,
quint8  Cnt,
QByteArray &  Tid,
quint8 &  ec 
)

Function to erase data from Tag memory.

Its called by application. This function must called with 4 byte access password, memory bank selector, start position within the bank, words to erase, and the Tag identifier (PC+EPC). If the Tag identifier is not given, the function erase the Tag first find in the field, and returns on success, this identifier. If the call failed an error code will be provided from module.

Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]BankTag memory bank selector [1-3]
[in]PtrByteArray with EVB-8 encoded position
[in]CntWords to write (currently 1 only)
[in]TidByteArray with Tag identifier
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ FastAuth()

quint8 RLMXXXCRC::FastAuth ( const QList< QByteArray >  AccessPwdList,
const QByteArray &  Tid,
quint8 &  ec 
)

Function Fast authentication.

Its called by application. This function called with a list of max 4 access password, and the Tag identifier (PC+EPC). If the call failed an error code will be provided from module. The first password match the TAGs password let the function return success, otherwise fault, no password match.

Parameters
[in]AccessPwdListList with ByteArray of 4 byte Tag access passwords
[in]TidByteArray with Tag identifier
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ KillTag()

quint8 RLMXXXCRC::KillTag ( const QByteArray &  KillPwd,
const QByteArray &  Tid,
quint8 &  ec 
)

Function to kill a Tag.

Its called by application. This function must called with 4 byte kill password, and the Tag identifier (PC+EPC). If the call failed an error code will be provided from module.

Parameters
[in]KillPwdByteArray of 4 byte with the Tag access password
[in]TidByteArray with Tag identifier
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ LockMem()

quint8 RLMXXXCRC::LockMem ( const QByteArray &  AccessPwd,
const QByteArray &  LockData,
const QByteArray &  Tid,
quint8 &  ec 
)

Function to lock memory regions of a Tag.

Its called by application. This function must called with 4 byte access password, ByteArray with the mask and action field, and the Tag identifier (PC+EPC). If the call failed an error code will be returned.

Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]LockDataByteArray with action/mask information ( 3 byte )
[in]TidByteArray with Tag identifier
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ ReadBatch()

quint8 RLMXXXCRC::ReadBatch ( const QByteArray &  AccessPwd,
const quint8  Option,
const quint8  initQ,
const QList< QByteArray > &  BatchList 
)

Function to read multible areas of a TAG memory with a single command.

Its called by application. This function must called with 4 byte access password, bank selector option, initQ value and bank specific data. On success module send continously Tag information of the environment use the command RetriveBatchData() to retrive.

See also
RetriveBatchData()
Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]OptionSelector to read one or two memory banks
[in]initQAnti collision parameter
[in]BListList of QByteArray with Bank,pointer and lenth of memory
[out]ResultsList of QByteArray with TID, and memory read from Tag
Returns
1 on success, 0 if failed

◆ ReadData()

quint8 RLMXXXCRC::ReadData ( const QByteArray &  AccessPwd,
quint8  Bank,
const QByteArray &  Ptr,
quint8  Cnt,
QByteArray &  Tid,
QByteArray &  ReadData,
quint8 &  ec 
)

Function to read the Tag memory.

Its called by application. This function must called with 4 byte access password, memory bank selector, start position within the bank, words to read, and the Tag identifier (PC+EPC). If the parameter Cnt is set to 0 the function returns all data available. If the Tag identifier is omitted (empty), on success the function return the Tag id which had been read.

If the call failed an error code will be provided from the module

Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]BankTag memory bank selector 0-3
[in]PtrByteArray with EVB-8 encoded position
[in]CntWords to read
[in,out]TidByteArray with Tag identifier
[out]ReadDataByteArray with the data returned from the module
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ RetriveBatchData()

quint8 RLMXXXCRC::RetriveBatchData ( QList< QByteArray > &  ResultList)

Function to retrive the Tag identifiers and additional bank reads from an inventory round.

Its called by application and polls the information from the module. This function is called after the inventory round had been started using ReadBatch() function.

See also
ReadBatch()
StopCurrentCmd()
Parameters
[out]ResultListList of ByteArrays with a tag identifier and additional bank information
Returns
1 on success, 0 if failed

◆ WriteData()

quint8 RLMXXXCRC::WriteData ( const QByteArray &  AccessPwd,
quint8  Bank,
QByteArray &  Ptr,
quint8  Cnt,
const QByteArray &  WriteData,
QByteArray &  Tid,
quint8 &  ec 
)

Function writes multiple words to Tag memory.

Its called by application. This function must called with 4 byte access password, memory bank selector, start position within the bank, words to write (maximal 128), and the Tag identifier (PC+EPC). If the call failed an error code will be provided from module.

Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]BankTag memory bank selector [1-3]
[in]PtrByteArray with EVB-8 encoded position
[in]CntWord count [1-128]
[in]WriteDataByteArray with the data to write on the Tag
[in]TidByteArray with Tag identifier
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ WriteEPC()

quint8 RLMXXXCRC::WriteEPC ( const QByteArray &  AccessPwd,
const QByteArray &  Tid,
const QByteArray &  Epc,
quint8 &  ec 
)

Function to write EPC to Tag memory.

Its called by application. This function must called with 4 byte access password, the Tag identifier (PC+EPC) and the new EPC to write. If the call failed an error code will be provided from module.

Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]TidByteArray with Tag identifier
[in]EpcTags new EPC
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed

◆ WriteWord()

quint8 RLMXXXCRC::WriteWord ( const QByteArray &  AccessPwd,
quint8  Bank,
const QByteArray &  Ptr,
const QByteArray &  WriteData,
const QByteArray  Tid,
quint8 &  ec 
)

Function writes a single word to Tag memory.

Its called by application. This function must called with 4 byte access password, memory bank selector, start position within the bank, words to write, and the Tag identifier (PC+EPC). If the call failed an error code will be provided from module.

Parameters
[in]AccessPwdByteArray of 4 byte with the Tag access password
[in]BankTag memory bank selector [1-3]
[in]PtrByteArray with EVB-8 encoded position
[in]WriteDataByteArray with the data to write on the Tag
[in]TidByteArray with Tag identifier
[out]ecError Code returned from the module if command failed
Returns
1 on success, 0 if failed