ANDROID UHF API. Bright Alliance Technology Limited

Transcription

1 ANDROID UHF API Bright Alliance Technology Limited

2 1 Import Package and library to project UHF function is in the uhf.jar - com.android.hdhe.uhf.reader.uhfreader 2 Functions getinstance() Function: Get UhfReader instance, Call the UHF encapsulated command Return:UhfReader instance setoutputpower(int value) Functions: Adjust the scanning distance Parameter: int value, value range dBm~26dBm Return: boolean flag,true Adjust success, false - Adjust fail inventorymulti() Functions: Multi-Call inventory in the Chipset, Used in Multi-tag (Inventory times, Auto-Stop; If need again, Call again) Return: List<byte[]> list, when list is not null, Return inventory list; when list is null, No tag or tag is not in antenna area stopinventorymulti() Functions: Stop Multi-tag inventory

3 Return: No inventoryrealtime() Functions: Real time inventory, it is single command, Loop call in inventory. Return: List<byte[]> list, when list is not null, Return inventory list, when list is null, No tag or tag is not in antenna area selectepc(byte[] epc) Functions: Select tag, call it before R/W tag. Parameter: byte[] epc, the EPC data of tag Return: No unselectepc() Functions: Cancel select tag, call it when choosing a new tag or inventory. Return: int, When it is 0, Correct; when it is other value, Wrong Read the data of tag - readfrom6c(int membank, int startaddr, int length, byte[] accesspassword) Functions: Read data of the tag Parameter: int membank Storage Area: RESEVER 0, EPC 1, TID 2, USER 3 int startaddr Start Address (Cannot be too big, depends on the size of the Storage Area) int length Reading data length, word(1word = 2bytes) byte[] accesspassword 4 bytes Return: byte[] data; when data is not null, it is data in storage area, when data is null, data reading fail, return an error code in 1 byte.

4 2.0.9 writeto6c(byte[] password, int membank, int startaddr, int datalen, byte[] data) Functions: Write storage data in tag (TID area cannot write), data writing in word, if not enough,write 0 Parameter: byte[] Password 4 bytes. int membank Storage Area: RESEVER 0, EPC 1, TID 2, USER 3 int startaddr Start Address (Cannot be too big, depends on the size of the Storage Area) int datalen Reading data length, word(1word = 2bytes) byte[] data Return: boolean, if it is true, write successful; if it is false, write fail setfrequency(int startfrequency, int freqspace, int freqquality) Functions: Set the working frequency (Not recommanded) Parameter: int startfrequency - Start frequency i int freqspace - frequency spacing int freqquality frequency quality Return: int, if it is 0, set successful; then fail SetWorkArea(int area) Functions: Set the frequency of Area Parameter: int area; area = 1 China2 area = 2 Ameraca area = 3 Europe area = 4 China1 area = 5 Korea Return: int, if it is 0, Set successful, then fail. Error Code Type Code Description Command Error 0x17 Command code error in Command frame FHSS Fail 0x20 frequency hopping channel searching time out, all the channels are in using

5 Inventory Fail 0x15 Polled operation fail. No tag return or the return data CRC error Access Fail 0x16 Read tag fail, maybe it is the call password is wrong Read Fail 0x09 Read tag data fail. No tag return or the return data CRC error Read Error 0xA0 Error code Read tag data storage area fail. Return code is from 0xA0 or Error code Please check the table below. Write Fail 0x10 Write tag data storage area fail. No return or return data CRC error Write Error 0xB0 Error code Write tag data storage area Error. Return code is from 0xBA0 or Error code. Please check the table below. Lock Fail 0x13 Lock tag data storage area fail. No return or return data CRC error. Lock Error 0xC0 Error code Lock tag data storage area error. No return is from 0xC0 or Error code. Please check the table below. Kill Fail 0x12 Kill tag fail. No return or Return data CRC error. Kill Error 0xD0 Error code Kill tag error. Return code is from 0xC0 or Error Code. Please check the tablet below NXP G2X tag specific command error code: ReadProtect Fail 0x2A Reset ReadProtect Fail 0x2B Change EAS Fail 0x1B NXP specific command tag return error code 0xE0 Error code ReadProtect command fail, No return or return data CRC error Reset ReadProtect command fail, No return or return data CRC error Change EAS command fail, No return or return data CRC error NXP specific command return error code, error code is from 0xE0 or Error Code. EPC Gen2 protocol tag return error code: Tag error-code Error-code Support Error Code Error code Name Error Description Other error Other errors not in this table Error-specific Memory overrun The storage area of the specific tag is not available; or this tag doesn t support specific length EPC, for example: XPC Memory locked Specific data storage area is locked and/or locked forever, and it cannot read or write Insufficient power Tag has no enough power to write. Non-specific Non-specific error Tag doesn t support Error-code return.