Specifications

ManualsBrandsShenzhen VanchIOT Technology ManualsElectronicsUHF RFID Integrated reader

Table Of Contents

VI-88TR

RFID Integrated Reader

Development Handbook

 VANCH has the right to modify the product’s hardware/software and manual freely

without any declaration. Any change without notice.

 The specification and power supply will be subject to country of origin. Make sure your

voltage conforms to standard, and understand more information on security

considerations, especially for outdoor installation.

Summary of content (98 pages)

PAGE 1
VI-88TR RFID Integrated Reader Development Handbook   VANCH has the right to modify the product’s hardware/software and manual freely without any declaration. Any change without notice. The specification and power supply will be subject to country of origin. Make sure your voltage conforms to standard, and understand more information on security considerations, especially for outdoor installation.
PAGE 2
Content | VI-88TR development handbook CONTENT 1 Applying development of unilateral communication........................ 5 1.1 Applying development of unilateral communication ...................... 5 1.2 Wiegand interface agreement ......................................................... 5 1.2.1 Wiegand26 format .................................................................. 6 1.2.2 Wiegand34 format .................................................................. 6 1.
PAGE 3
Content | VI-88TR development handbook 2.2.26 2.3 GetReaderID ......................................................................... 35 Command format of serial read-write tag ..................................... 35 2.3.1 Read-write ISO18000-6B command format ......................... 35 2.3.1.1 List Tag ID ............................................................................ 36 2.3.1.2 Get ID List ............................................................................ 37 2.3.1.
PAGE 4
Content | VI-88TR development handbook 3.2.2.11 Select antenna ..................................................................... 78 3.2.2.12 Set relay state in reader ...................................................... 79 3.2.2.13 Reboot reader ....................................................................... 80 3.2.2.14 Set time ................................................................................ 80 3.2.2.15 Get time .......................................................
PAGE 5
Applying development of unilateral communication | VI-88TR development handbook 1 Applying development of unilateral communication 1.1 Applying development of unilateral communication Apply in software development of continuous and trigger working mode, upper computer only need to receive tag ID numbers sent by reader, no need to send reader command. 1.
PAGE 6
Applying development of unilateral communication | VI-88TR development handbook Wiegand interface has 2 types of Wiegand26 and Wiegand34. 1.2.1 Wiegand26 format Wiegand26 transmits 26 bits data every time, 24 bits of them are valid. We stipulate these 24 bits correspondent for low 24 bits of electronic tag ID, or user defined number. Transmission format as follows: Even: verified data adds parity bit1 is even number. Odd: verified data adds parity bit1 is odd number. 1.2.
PAGE 7
Applying development of unilateral communication | VI-88TR development handbook BODY CHECK STX DATA ETX BCC 02 Antenna serial ID number or number(2byte User-defined number(N ASCII code) bytes ASCII code) 03 check code Introduction: A. Symbol of data start STX = 02H ，symbol of data end ETX = 03H； B. DATA is antenna serial number(2Byte)+tag ID number(NBytes)，length is N+2bytes ASCII code.
PAGE 8
Serial port intercommunication agreement | VI-88TR development handbook 2 Serial port intercommunication agreement 2 ways for application development: 1. Use control code of serial port communication agreement to operate reader directly. 2. User matched SDK software with reader to call API function to operate reader. 2.1 Summarize In RFID application system, reader is connected with controller (PC) via RS232 port, and receives commands from controller, then returns the result of command execution.
PAGE 9
Serial port intercommunication agreement | VI-88TR development handbook 2.1.2 BootCode Command packet format with address Length Command Address Command Param CheckSum See chart above , command packet is composed of 6 parts: Length(byte) Description BootCode 1 Fixed to be 40H Length 1 Effective length. The length is total bytes of lateral 4 parts Command 1 Address 1 Command Param uncertain CheckSum 1 2.1.
PAGE 10
Serial port intercommunication agreement | VI-88TR development handbook 2.1.4 BootCode Return packet format with address Length Command Address Return Data CheckSum See chart above , return packet is composed of 6 parts: Length(byte) Description BootCode 1 When execute command correctly, bootcode of return packet is F0H. When execute command fail, bootcode of return packet is F4H. Length 1 Effective length. The length is total bytes of lateral 4 parts.
PAGE 11
Serial port intercommunication agreement | VI-88TR development handbook 12(0CH) Illegal user password with unmatched 13(0dH) RF interference from external 14(0EH) Read protection on tag …… 2.1.
PAGE 12
Serial port intercommunication agreement | VI-88TR development handbook { unsigned char i,uSum=0; for(i=0;i
PAGE 13
Serial port intercommunication agreement | VI-88TR development handbook 04H 9600bps 05H 19200bps 06H 38400bps 07H 57600bps 08H 115200bps Command packet: 『40H 03H 01H BPS CheckSum』 Return data: if command execution correct, return data is null.
PAGE 14
Serial port intercommunication agreement | VI-88TR development handbook Function: to get version number of hardware and software from reader Command code: 02H Command parameter: none Command packet: 『40H 02H 02H BCH』 Return data: if command execution correct, return data is 4 bytes of version number: Byte0 Major version of hardware Byte1 Minor version of hardware(hardware version number is to show reader model number) Byte2 Major version of software Byte3 Minor version of software For example:
PAGE 15
Serial port intercommunication agreement | VI-88TR development handbook Return data: if command execution correct, return data is 4 bytes of version number: Byte0 Major version of hardware Byte1 Minor version of hardware(hardware version number is to show reader model number) Byte2 Major version of software Byte3 Minor version of software For example: if model number of reader is Reader1102, software version number is V1.5, then return packet is: 『F0H 2.2.
PAGE 16
Serial port intercommunication agreement | VI-88TR development handbook 『F0H 02H 03H 0BH』 Command format with reader address: Command code: 03H Parameter of reader address: address Command parameter: 1byte Bit0=1 No1 relay on Bit0=0 No1 relay off Bit1=1 No2 relay on Bit1=0 No2 relay off And so on. Command packet: 『40H 04H 03H address K CheckSum』 Return data: if success, return data is null. 『F0H 2.2.
PAGE 17
Serial port intercommunication agreement | VI-88TR development handbook Bit0=1 No1 relay on Bit0=0 No1 relay off Bit1=1 No2 relay on Bit1=0 No2 relay off Command format with reader address: Command code: 0BH Parameter of reader address: address Command packet: 04H 0BH 『40H address CheckSum』 Return data: if success, return data is K（1byte）『F0H 2.2.
PAGE 18
Serial port intercommunication agreement | VI-88TR development handbook 『F0H 02H 04H 0AH』 Command format with reader address: Command code: 04H Parameter of reader address: address Command parameter: 1 byte of P expresses power value 20~33. Command packet: 『40H 04H 04H address P CheckSum』 Return data: if command execution correct, return data is null. 『F0H 03H 2.2.6 04H address CheckSum』 Set Frequency Function: to set the frequency channel number for reader to transmit microwave signal.
PAGE 19
Serial port intercommunication agreement | VI-88TR development handbook 『F0H 02H 05H 09H』 Command format with reader address: Command code: 05H Parameter of reader address:address Command parameter: 2 bytes, byte1 expresses start frequency fmin, value 1~63; byte2 expresses end frequency fmax, value 1~63. If fmax>fmin, reader works by FHSS, range is fmin～fmax. If fmax=fmin, reader works in fixed frequency, frequency is fmax.
PAGE 20
Serial port intercommunication agreement | VI-88TR development handbook 14 909.00 34 919.00 15 909.50 35 919.50 16 910.00 36 920.00 17 910.50 37 920.50 18 911.00 38 921.00 19 911.50 39 921.50 20 912.00 40 922.00 2.2.7 Read Param Function: to read the operation parameter in reader written by last command. Command code: 06H Command parameter: none Command packet: 『40H 02H 06H B8H』 Return data: if command execution correct, return data is 32 bytes PAM from setting command.
PAGE 21
Serial port intercommunication agreement | VI-88TR development handbook Return data: if command execution correct, return data is 32 bytes PAM from setting command. 『F0H 2.2.8 23H 06H address PAM CheckSum』 Set Param Function: to set basic parameter of reader, baud rate of serial, transmit power, RF power output and so on. Command code: 09H Command parameter: 32 bytes PAM Command packet: 『40H 22H 09H PAM CheckSum』 Return data: if command execution correct, return data is null.
PAGE 22
Serial port intercommunication agreement | VI-88TR development handbook 『F0H 03H 09H address CheckSum』 32 bytes of parameter(1 parameter 1 byte): Byte number 1 Definition Baud rate of serial, value: 00H~08H， 2 Transmit power, value: 20～33dbm.
PAGE 23
Serial port intercommunication agreement | VI-88TR development handbook 2.2.9 Read Auto Param Function: to read the auto work parameter in reader written by last command. Command code: 14H Command parameter: none Command packet: 『40H 02H 14H 6DH』 Return data: if success, return data is 32 bytes PAM from setting command.
PAGE 24
Serial port intercommunication agreement | VI-88TR development handbook Command code: 13H Command parameter: 32 bytes PAM Command packet: 『40H 26H 13H PAM Check』 Return data: if command execution correct, return data is null. If success, return data of Read Auto Param is 32 bytes parameters with following sequence.
PAGE 25
Serial port intercommunication agreement | VI-88TR development handbook Byte number 6 7 Definition stored in reader memory. High. Tag storage quantity：default 1. The quantity of read tag ID stored in reader memory. Low. Data output format：0-terse，1-standard，2-XML format. Default0. 8 Output interface: 0-RS232, 1-RS485, 2-RJ45. Default 0. 3- Wiegand26, 4- Wiegand34. 9 Wiegand output pulse width, default40. 10 11 12 13 Wiegand output pulse interval, default200.
PAGE 26
Serial port intercommunication agreement | VI-88TR development handbook Function: to select from which antenna to transmit-receive signal. Command code: 0AH Command parameter: 1 byte of selected antenna No. 1 Select No.1 antenna 2 Select No.2 antenna 4 Select No.3 antenna 8 Select No.4 antenna Command packet: 『40H 03H 0AH No. CheckSum』 Return data: if command execution correct, return data is null.
PAGE 27
Serial port intercommunication agreement | VI-88TR development handbook Function: The parameters of the Reader device back to factory Command code: 0EH Command parameter: none Command packet: 『40H 02H 0DH Check』 Return data: if success, return data is null. 『F0H 02H 0DH Check』 2.2.13 Reboot Function: reboot reader, which equivalent to power on again after power off. Command code: 0EH Command parameter: none Command packet: 『40H 02H 0EH B0H』 Return data: if success, return data is null.
PAGE 28
Serial port intercommunication agreement | VI-88TR development handbook Return data: if success, return data is null. 『F0H 03H 0EH address CheckSum』 2.2.14 Start/ stop automode Function: Set the operation mode of the Reader. Command code: 0FH Command parameter: 1 byte, automode is the working mode of Reader. Command packet: 『40H 03H 0FH Automode Check』 Automode is 0, mean stop automode Automode is 1, mean start automode Return data: if success, return data is null. 『F0H 02H 0FH 00H』 2.2.
PAGE 29
Serial port intercommunication agreement | VI-88TR development handbook 2.2.16 Set Reader Time Function: to set time for reader. Command code: 11H Command parameter: 6bytes:yy/mm/dd/hour/minute/second Command packet: 08H 11H 『40H yy mm dd hh ff ss CheckSum』 Return data: if success, return data is null.
PAGE 30
Serial port intercommunication agreement | VI-88TR development handbook Command code: 12H Command parameter: none Command packet: 『40H 02H 12H ACH』 Return data: if success, return data is yy/mm/dd/hour/minute/second. 『F0H 08H 12H yy mm dd hh ff ss CheckSum』 Command format with reader address: Command code: 12H Parameter of reader address: address Command parameter: none Command packet: 『40H 03H 12H address CheckSum』 Return data: if success, return data is yy/mm/dd/hour/minute/second.
PAGE 31
Serial port intercommunication agreement | VI-88TR development handbook digit after. That’s bit length. Command parameter3: M bytes of data, high digit before, low digit after. If LEN/8 is integer, then M=LEN/8；if LEN/8 is not integer, then M=LEN/8＋1, lastbyte data in high-order-position, low-order filling zero. Command packet: 『40H 4+M 15H ADDR LEN M CheckSum』 ReturnData: if success, return data will be null. 『F0H 02H 15H F9H』 Note: 1. When LEN＝0, filter unavailable, without command parameter3.
PAGE 32
Serial port intercommunication agreement | VI-88TR development handbook Command packet:『40H 02H 16H A8H』 ReturnData: if success, return data will be (2 bytes of mask ADDR＋2 bytes of mask LEN＋M bytes of data). If LEN/8 is integer, then M=LEN/8；if LEN/8 is not integer, then M=LEN/8＋1, last byte data in high-order-position, low-order filling zero. 『F0H 4+M 16H ADDR LEN M CheckSum』 2.2.20 Set Reader Network Address Function: to set network address for reader.
PAGE 33
Serial port intercommunication agreement | VI-88TR development handbook Return data: if success, return data is (IP(4Bytes)+PORT(2Bytes)+MASK(4Bytes)+Gateway (4Bytes)). 『F0H 10H 31H IP PORT MASK Gateway CheckSum』 2.2.22 SetReader MAC Function: to set network MAC for reader. Command code: 32H Command parameter: 6bytes parameter MAC Command packet: 『40H 08H 32H MAC CheckSum』 Return data: if success, return data is null. 『F0H 02H 32H DBH』 2.2.
PAGE 34
Serial port intercommunication agreement | VI-88TR development handbook Function: to send all reserved tag information to PC when reader receive the command. Command code: 54H Command parameter: no Command packet: 『40H 02H 54H 6AH』 ReturnData: if success, return data will be null. 『F0H 02H 54H BAH』 Following is some data packets. Each data packet with 1 tag information and each tag information is fixed as 120 bytes. Format of Data packet in appendix A. 2.2.25 Get Tag Info.
PAGE 35
Serial port intercommunication agreement | VI-88TR development handbook 『F0H 4+N*(17+L) 57H N N *RECORD CheckSum』 N(<=5) is the record number reader return. Record formate is HEX: 6bytes ofstart time ＋ 6bytes of end time ＋ 2bytes of reading times ＋ 1byte of antenna No.＋1byte of tag type＋1byte of EPC Length＋L byte of EPC. Records range fromsmall to large according to EPC value. If record parameter appointed is not exist, return packet definition as following: 『F0H 04H 57H 00H 00H B5H』 2.2.
PAGE 36
Serial port intercommunication agreement | VI-88TR development handbook into 256bytes. An address is for each byte, corresponding to 0～255. Thereinto:  Address 0～7, 8 words(64bits): tag ID number. Fixed before product leaves factory, can’t be modified.  Address 8～223: user information storage area, can be distributed at discretion.  Address 224～255: write protection byte. 2.3.1.1 List Tag ID Function: to list readable tag ID in antenna radiation field.
PAGE 37
Serial port intercommunication agreement | VI-88TR development handbook Command packet: 『40H 03H FEH address CheckSum』 Return data: if success, byte count of return data = number of all listed tags M(1byte)+M* data of (tag Length sent out L(<=8，1byte)*8(ID)). 『F0H 4+M*（L+8） 2.3.1.2 FEH address M M*(L+8) CheckSum』 Get ID List Function: to get listed tag ID by rfs_ListID command from reader memory.
PAGE 38
Serial port intercommunication agreement | VI-88TR development handbook Return data: if success, byte count of return data=M+M*data of (tag length L*8(ID)). 『F0H 3+M*(L+8) 2.3.1.3 FDH address M M*( L+8) CheckSum』 List Selected ID Function: to list readable tag ID in antenna radiation field based on following parameter condition. Command code: FBH Command parameter1: 1byte is the condition of selected tag.
PAGE 39
Serial port intercommunication agreement | VI-88TR development handbook 『F0H 3+M*(L+8) FBH M M*（L+8）CheckSum』 Command format with reader address: Command code:FBH Parameter of reader address:address Command parameter1: 1byte is the condition of selected tag. 00 Equal to 01 Unequal to 02 Greater than 03 Less than Command paramter2: 1byte is start address of tag data ADDR, value 0～ 223. Command parameter3: 1byte is data MASK. Each bit in the byte is corresponding to a comparative byte.
PAGE 40
Serial port intercommunication agreement | VI-88TR development handbook Function: to read a block of data starting from appointed address of appointed tag. Memory capacity of ISO18000-6B tag is 2048bits(256bytes). Readable byte address for user is 0～223. Length of data block takes byte as unit. Stipulates 32bytes can be read at most each time.
PAGE 41
Serial port intercommunication agreement | VI-88TR development handbook Function: to write data into the appointed address unit of appointed tag. Data length to write takes byte as unit, and 4bytes can be written in at most once. Writable byte address for user is 8～223. Command code: F5H Command parameter: 8 bytes ID(subject to the sequence of tag ID number); 1byte start address(aa), value 8~223; 1byte length of block(nn), value 1~4; nn bytes written data.
PAGE 42
Serial port intercommunication agreement | VI-88TR development handbook 2.3.1.6 Set Write Protect Function: to set write protection for the appointed addess unit of appointed tag. Command code:F4H Command parameter: 8 bytes ID(subject to the sequence of tag ID number); 1byte start address(aa), value 8~223. Command packet: 『40H 0BH F4H ID aa CheckSum』 Return data: if success, boot code of return packet is F0H, data part is null.
PAGE 43
Serial port intercommunication agreement | VI-88TR development handbook protect or not. Command code: F3H Command parameter: 8 bytes ID(subject to the sequence of tag ID number); 1byte start address(aa), value 0~223. Command packet: 『40H 0BH F3H ID aa CheckSum』 Return data: if success, boot code of return packet is F0H, data part is 1 byte.
PAGE 44
Serial port intercommunication agreement | VI-88TR development handbook 2.3.1.8 Slow Write A Byte Function: to write data into the appointed address unit of appointed tag. Length of written data takes byte as unit, and 4bytes can be written in at most once. Writable byte address for user is 8～223. Command code: F2H Command parameter: 8 bytes ID(subject to the sequence of tag ID number); 1byte start address(aa), value 8~223; 1byte length of block(nn), value 1~4; nn bytes written data.
PAGE 45
Serial port intercommunication agreement | VI-88TR development handbook xx CheckSum』 Return data: if success, return data is null. 『F0H 03H F2H address CheckSum』 2.3.2 Read write ISO18000-6C command format Storage unit of ISO18000-6C is devided into 4 memory banks: A. EPC memory bank: to store EPC number. It can store 96bits EPC number at most presently. Readable and writable. B. TID memory bank: to store ID number set by tag manufacturer. There are 32bits and 64bits ID presently.
PAGE 46
Serial port intercommunication agreement | VI-88TR development handbook Command parameter2: 2bytes, start address of MASK (unit: bit). Command parameter3: 1byte, the length of MASK (unit: bit). Command parameter4: m bytes, Mask. If LEN％8=0, then m=LEN/8. If LEN％8≠0, then m=LEN/8+1. Command packet: 『40H m+6 EEH mem addr LEN Mask CheckSum』 Return data: if success, byte count of return data= number of all listed tags M(1byte)+ data of (tag number sent out L(<=8)*L(digit count of EPC+EPC)).
PAGE 47
Serial port intercommunication agreement | VI-88TR development handbook Command parameter3: 1byte LEN, the length of MASK (unit: bit). Command parameter4: m bytes, Mask. If LEN％8=0, then m=LEN/8. If LEN％8≠0, then m=LEN/8+1. Command packet:『40H m+7 EEH address mem addr LEN Mask CheckSum』 Return data: if success, byte count of return data= number of all listed tags M(1byte)+ data of (tag number sent out L(<=8)*L(digit count of EPC+EPC)).
PAGE 48
Serial port intercommunication agreement | VI-88TR development handbook Command format with reader address: Command code:EDH Parameter of reader address:address Command parameter:2bytes, the first byte is start number NO, the second byte is tag count L(<=8). Command packet: 『40H 05H EDH address no m CheckSum』 Return data: if success, byte count of return data=data of (1byte tag count M*L Bytes(digit count of EPC+EPC)). 『F0H 3+L*8 2.3.2.
PAGE 49
Serial port intercommunication agreement | VI-88TR development handbook 3 User Command parameter4: 1byte addr, start address(unit:Word). Command parameter5: 1byte len, length of data(unit:Word). Command parameter6: 4bytes, AccessPassword. Command packet: AccessPassword 『40H 10+L*2 ECH L EPC mem addr len CheckSum』 Return packet: if success, return data is len*2bytes data xx. 『F0H len*2+2 ECH xx …… xx CheckSum』 Note: AccessPassword is workable when password memory bank is locked.
PAGE 50
Serial port intercommunication agreement | VI-88TR development handbook 3 User Command parameter4: 1byte addr, start address(unit:Word). Command parameter5: 1byte len, length of data(unit:Word). Command parameter6: 4bytes, AccessPassword. Command packet: len 『40H 11+L*2 ECH address L EPC mem addr AccessPassword CheckSum』 Return packet: if success, return data is len*2bytes data xx. 『F0H len*2+3 2.3.2.
PAGE 51
Serial port intercommunication agreement | VI-88TR development handbook Command parameter4: 1byte addr, start address(unit:Word). Command parameter5: 1byte len, length of data(unit:Word). Command parameter6: len*2bytes written data. Command parameter7: 4bytes, AccessPassword. Command packet: len 『40H data AccessPassword 10+L*2+len*2 EBH L EPC mem addr CheckSum』 Return packet: if success, return data is null. 『F0H 02H EBH 23H』 Note: AccessPassword is workable only when memory bank is locked.
PAGE 52
Serial port intercommunication agreement | VI-88TR development handbook 2 TID 3 User Command parameter4: 1byte addr, start address(unit:Word). Command parameter5: 1byte len, length of data(unit:Word). Command parameter6: len*2bytes written data. Command parameter7: 4bytes, AccessPassword. Command packet: 『40H addr len data 11+L*2+len*2 AccessPassword EBH address L EPC mem CheckSum』 Return packet: if success, return data is null. 『F0H 03H 2.3.2.
PAGE 53
Serial port intercommunication agreement | VI-88TR development handbook EPC KillPassword Check』 Head Len Cmd 40H L*2+7/L*2+8 E8H Address Data Check L EPC KillPassword 1Byte Specific command package parameters definition to see the table below: L 1byte，digit count of EPC (Unit:Word) EPC L*2 bytes EPC KillPassword 4bytes ReturnData: if success, return data will be null. 『F0H 02H 2.3.2.
PAGE 54
Serial port intercommunication agreement | VI-88TR development handbook Command parameter4: 1byte Lock, control word. 0 Writable 1 Writable permanently 2 Writable in secured state 3 Never writable 4 Readable and writable 5 Readable and writable permanently 6 Readable and writable in secured state 7 Never readable and writable 0～3 only apply to EPC, TID and User memory bank; 4～7 only apply to Kill Password and Access Password. Command parameter5: 4bytes AccessPassword.
PAGE 55
Serial port intercommunication agreement | VI-88TR development handbook read-write protect. Command parameter3: 1byte mem, select memory bank. 0 Kill Password 1 Access Password 2 EPC number 3 ID number in TID 4 User Command parameter4: 1byte Lock, control word.
PAGE 56
Serial port intercommunication agreement | VI-88TR development handbook 2.3.2.7 Write EPC Function: to write EPC data into tag’s EPC bank. Word as unit of written data length. Command code: E7H Command parameter 1: 1 byte EPC digit L, indicate number of Word of EPC No.; Command parameter 2: L*2 bytes EPC number; Command parameter 3: 4 bytes AccessPassword; Command packet: 『40H 7+L*2 E7H L EPC AccessPassword CheckSum』 ReturnData: if success, return data will be null.
PAGE 57
Serial port intercommunication agreement | VI-88TR development handbook 1 EEH To identify readable tag ID in antenna radiation field based on mask condition 2 EDH To get listed tag ID by rfs_ListTagID command from reader memory 3 ECH To read a block of data starting from the appointed address in appointed memory bank of appointed tag 4 EBH To write data into the appointed address unit in appointed memory bank of appointed tag 5 EAH To set write protect for appointed memory bank of appointed t
PAGE 58
Serial port intercommunication agreement | VI-88TR development handbook 2 02H To get hardware and software version number of reader 3 03H To set relay state for reader 4 04H To set transmitting power coefficient for reader 5 05H To set frequency channel number of transmitting microwave signal for reader 6 06H To read operation parameter written by last command from reader 7 09H To set basic operation parameter: baud rate, transmitting frequency, RF power output and so on 8 0AH To select
PAGE 59
Serial port intercommunication agreement | VI-88TR development handbook writable.  Password memory bank: with 32Bits access password and 32Bits kill password. Readable and writable.
PAGE 60
Serial port intercommunication agreement | VI-88TR development handbook access password, and can be set to readable and writable from secured state or permanently readable and writable or never readable and writable later; Permanently Readable and Writable—can be read and written without access password, but can’t be set to readable and writable from secured state or never readable and writable later; Readable and Writable from secured state—can read and modify password with access password only, and can b
PAGE 61
SDK software development | VI-88R development handbook 3 SDK software development 3.1 SDK compose SDK is provided in the package of VF-447, mainly including: A. Reader1400dll.dll file —— dynamic link library B. Reader1400.lib file —— static link library C. Reader1400API.h file —— statement file of API function D. SDK catalogue —— including example program for learning API function application 3.2 3.2.1 Design introduction Basic constant and figure 3.2.1.
PAGE 62
SDK software development | VI-88R development handbook #define _comm_error 0x83 //communication data error #define _baudrate_error 0x84 //set baud rate error #define _no_antenna 0x01 //antenna connection fail #define _no_label 0x02 //detect no tag #define _invalid_label 0x03 //illegal tag #define _less_power 0x04 //read-write power not enough #define _write_prot_error 0x05 //the memory protection #define _check_sum_error 0x06 //checksum error #define _parameter_error 0x07 //parame
PAGE 63
SDK software development | VI-88R development handbook BYTE BaudRate; //(1)baud rate of serial, value： Power; //(2)RF power output, value： 00H~08H. BYTE 20~30dBm.(0-63) BYTE Min_Frequence; //(3)start point of transmitting microwave signal frequency, value： 1~63. BYTE Max_Frequence; //(4)end point of transmitting microwave signal frequency, value： 1~63. BYTE Reserve5; //(5)reserve, changed into modulation WorkMode; //(6)work mode of reader：0-Auto, depth later.
PAGE 64
SDK software development | VI-88R development handbook BYTE EnableBuzzer; //(12)1:enable buzzer 0:disable buzzer BYTE IP1; //(13)IP address of reader BYTE IP2; //(14) BYTE IP3; //(15) BYTE IP4; //(16) BYTE Port1; //(17)high-order of reader port BYTE Port2; //(18) BYTE Mask1; //(19)reader mask1 BYTE Mask2; //(20)reader mask2 BYTE Mask3; //(21)reader mask3 BYTE Mask4; //(22)reader mask4 BYTE Gateway1; //(23)reader address gateway BYTE Gateway2; //(24) BYTE Gateway3; /
PAGE 65
SDK software development | VI-88R development handbook BYTE MAC4; //(30) BYTE MAC5; //(31) BYTE MAC6; //(32) } ReaderBasicParam; //Auto parameter of reader typedef struct tagReaderAutoParam { BYTE AutoMode; //(1)tag reading mode：0-timing, TimeH; //(2)tag storage time: unit: second. BYTE TimeL; //(3) BYTE Interval; //(4)0-10ms，1-20ms，2-30ms，3-50ms， 1-trigger. BYTE Default 1. 4-100ms. Default 2. Auto reading tag once at intervals. BYTE NumH; //(5)tag storage quantity：default 1.
PAGE 66
SDK software development | VI-88R development handbook RS485，2－RJ45. Default 0. 3- Wiegand26 4- Wiegand34 BYTE WiegandWidth; //(9)value of Weigand pulse width. BYTE WiegandInterval; //(10)value of Weigand pulse interval. BYTE ID_Start; //(11)start address of output ID, value 0～4. BYTE BYTE IDPosition; Report_Interval; //(12)storage address for tag ID in tag. //(13) report interval：unit is second. Default 1. Automatically notify host pc once at intervals.
PAGE 67
SDK software development | VI-88R development handbook BYTE Port2; //(23) BYTE Reserve24; //(24)notified MAC,mofi by mqs 20121207 reserve BYTE ArgentinaSim; //(25)//emulation mode(argentina),0—non-emulation，1--emulation BYTE CardTime1; //(26)//reading time-out 1 BYTE CardTime2; //(27)//reading time-out 2 BYTE ArgentinaMode; //(28)//5 modes for argentina, 0---Only ATA ; 1---Only EPC; 2---Only EPC & TID; 3---ATA + EPC; 4---ATA + EPC & TID.
PAGE 68
SDK software development | VI-88R development handbook {"00---FCC(American)", 63, 400, 902600}, //(0),{"00---FCC(American)", 50, 500, 902750}, {"01---ETSI EN 300-220(Europe300-220)", 11, 200, 865500}, //(1),{"01---ETSI EN 300-220(Europe300-220)", -1, -1, -1}, {"02---ETSI EN 302-208(Europe302-208)", 4, 600, 865700}, //(2) {"03---HK920-925(Hong Kong)", 10, 500, 920250}, //(3) {"04---TaiWan 922-928(Taiwan)", 12, 500, 922250}, //(4) {"05---Japan 952-954(Japan)", 0, 0, 0}, //(5) {"06---Japan 952-955(Japan)", 14
PAGE 69
SDK software development | VI-88R development handbook {"11--Japan 952-956(Japan)", 4, 1200, 952400}, //(11) {"12--South Africa 915-919(Poncho)", 17, 200, 915600}, //(12) {"13--Brazil 902-907/915-928(Brazil)", 35, 500, 902750}, //(13) {"14--Thailand 920-925(Thailand)", -1, -1, -1}, //(14) {"15--Singapore 920-925(Singapore)", 10, 500, 920250}, //(15) {"16--Australia 920-926(Australia)", 12, 500, 920250}, //(16) {"17--India 865-867(India)", 4, 600, 865100}, //(17) {"18--Uruguay 916-928(Uruguay)", 23, 500, 91
PAGE 70
SDK software development | VI-88R development handbook {"22--Canada 902-928(Canada)", 42, 500, 902750}, //(22) {"23--Indonesia 923-925(Indonesia)", 4, 500, 923250}, //(23) {"24--New Zealand 921.5-928(New Zealand)", 11, 500, 922250}, //(24) }; 3.2.1.5 Function return code When command execution fail, function returns error code.
PAGE 71
SDK software development | VI-88R development handbook 3.2.2 Control command function 3.2.2.1 Connect reader Using serial port Connection: apiReturn ConnectScanner(HANDLE *hScanner, char *szPort, int nBaudRate); Function: to establish communication connection with reader, and set baud rate for reader. Input parameter: szPort : character pointer directing at communication port, eg. 『COM1』、『COM2』…… nBaudRate: baud rate of serial, effective value is: 9600，19200，38400， 57600，115200.
PAGE 72
SDK software development | VI-88R development handbook Input parameter: szPort : character pointer directing at communication port, eg.『COM1』、『COM2』…… nBaudRate: baud rate of serial, effective value is: 9600，19200，38400， 57600，115200. Address: reader address. Output parameter: to judge if connection success or failure reason according to apiReturn value returned by function.
PAGE 73
SDK software development | VI-88R development handbook hSocket : reader communication handle return: if return value of function is OK, it means connection success, otherwise, connection fail. Note: each reader shall execute the command to get corresponding reader communication handle hSocket. 3.2.2.2 Disconnection RS232,RS485 disconnection with reader apiReturn DisconnectScanner(HANDLE hScanner)； apiReturn Net_DisconnectScanner(); Function: to stop the connection with reader to release serial resource.
PAGE 74
SDK software development | VI-88R development handbook nBaudRate: vaule:9600，19200，38400，57600，115200 Address: RS485 networking address of reader，Address =0 no networking. return: if function return value is OK, setting success, otherwise failure reason. 3.2.2.
PAGE 75
SDK software development | VI-88R development handbook Address) apiReturn Net_SetOutputPower(SOCKET hSocket, int nPower,BYTE * IPaddress); Function: to set RF output power of reader. Input parameter: hSacnner/hSocket: reader communication handle nPower1/nPower: output power value Address: RS485 networking address of reader，Address =0 no networking. return: if function return value is OK，it means setting success, otherwise fail. 3.2.2.
PAGE 76
SDK software development | VI-88R development handbook Max_Frequency: end frequency of reader，value is 0-59. When Min_Frequency = Max_Frequency，reader works in fixed frequency. Address: RS485 networking address of reader，Address =0 no networking. function: if function return value is OK，it means setting success, otherwise fail. 3.2.2.
PAGE 77
SDK software development | VI-88R development handbook apiReturn _stdcall WriteBasicParam(HANDLE hScanner, ReaderBasicParam * pParam,int Address); apiReturn Net_ WriteBasicParam (SOCKET hSocket, ReaderBasicParam * pParam); Function: to reader operation parameter for reader. Input parameter: hSacnner/hSocket: reader communication handle pParam: operation parameter of reader, 32 bytes Address: RS485 networking address of reader，Address =0 no networking.
PAGE 78
SDK software development | VI-88R development handbook Output parameter: pParam: return operation parameter of reader, 32 bytes return: if function return value is OK，it mean read success, otherwise failure reason. 3.2.2.10 Set reader auto parameter apiReturn _stdcall WriteAutoParam (HANDLE hScanner, ReaderAutoParam* pParam,int Address); apiReturn Net_ WriteAutoParam (SOCKET hSocket, ReaderAutoParam* pParam); Function: to set auto operation parameter in reader.
PAGE 79
SDK software development | VI-88R development handbook Function: to select which antenna to receive and transmit signal. Input parameter: hSacnner/hSocket: reader handle Antenna: antenna number，1-No1 antenna，2-No2 antenna，4-No3 antenna， 8-No4 antenna Address: RS485 networking address of reader，RS485Address=0 no networking. Output parameter: return: if function return value is OK, it means set success, otherwise failure reason. 3.2.2.
PAGE 80
SDK software development | VI-88R development handbook return: if function return value is OK, it means set success, otherwise failure reason. 3.2.2.13 Reboot reader apiReturn Reboot(HANDLE hScanner,int Address); apiReturn Net_Reboot(SOCKET hSocket); Function: to reboot reader, power on again. Input parameter: hSacnner/hSocket: reader communication handle Address: RS485 networking address of reader，Address =0 no networking.
PAGE 81
SDK software development | VI-88R development handbook Address: RS485 networking address of reader, Address =0 no networking. return: if function return value is OK, it means set success, otherwise failure reason. 3.2.2.15 Get time apiReturn _stdcall GetReaderTime(HANDLE hScanner, ReaderDate *time ,int Address) ; apiReturn GetReaderTime(SOCKET hSocket, ReaderDate *time) Function: to read time of reader.
PAGE 82
SDK software development | VI-88R development handbook ReaderDate *etime, int startaddr, int listlen, int *relistlen, int *taglen, BYTE * data); Function: to read record of identified tags in reader.
PAGE 83
SDK software development | VI-88R development handbook Input parameter: hSacnner/hSocket: reader communication port handle return: if function return value is OK, it means set success, otherwise failure reason. 3.2.3 3.2.3.
PAGE 84
SDK software development | VI-88R development handbook failure reason. 3.2.3.2 Get IP address in reader apiReturn _stdcall GetReaderNetwork(HANDLE hScanner, BYTE *IP_Address, int *Port, BYTE *Mask, BYTE *Gateway,int Address) ; apiReturn _stdcall Net_GetReaderNetwork(SOCKET hSocket, BYTE *IP_Address, int *Port, BYTE *Mask, BYTE *Gateway); Funtion: to get network IP addess of reader.
PAGE 85
SDK software development | VI-88R development handbook Address) ; apiReturn _stdcall Net_SetReaderMAC(SOCKET hSocket, BYTE MAC[6]); Function: to set network MAC address for reader. Input parameter: hSacnner/hSocket: reader communication port handle MAC[6]: network MAC address of reader Address: RS485 networking address of reader，Address =0 no networking. return: if function return value is OK, it means set success, otherwise failure reason. 3.2.3.
PAGE 86
SDK software development | VI-88R development handbook return: if function return value is OK, it means set success, otherwise failure reason. 3.2.4 3.2.4.1 Read write ISO18000-6B function Identify tag ID number apiReturn _stdcall ISO6B_ReadLabelID(HANDLE hScanner, BYTE *IDBuffer, int *nCounter,int Address) ; apiReturn _stdcall Net_ISO6B_ReadLabelID(SOCKET hSocket, BYTE *IDBuffer, int *nCounter); Function: to read all ID number of all readable tags in antenna radiation field.
PAGE 87
SDK software development | VI-88R development handbook apiReturn _stdcall ISO6B_ListSelectedID(HANDLE hScanner, int Cmd, int ptr, BYTE Mask, BYTE *Data, BYTE *IDBuffer, int *nCounter,int Address) ; apiReturn _stdcall Net_ISO6B_ListSelectedID(SOCKET hSocket, int Cmd, int ptr, BYTE Mask, BYTE *Data, BYTE *IDBuffer, int *nCounter); Function: to read ID number of selected tags in antenna radiation field.
PAGE 88
SDK software development | VI-88R development handbook failure reason. 3.2.4.3 Read data block apiReturn ISO6B_ReadByteBlock(HANDLE hScanner, BYTE *IDBuffer, BYTE ptr, BYTE len,BYTE *Data,int Address) apiReturn _stdcall Net_ISO6B_ReadByteBlock(SOCKET hSocket, BYTE *IDBuffer, BYTE ptr, BYTE len,BYTE *Data); Function: to read data in a section of continous memory of tag.
PAGE 89
SDK software development | VI-88R development handbook apiReturn _stdcall ISO6B_WriteByteBlock(HANDLE hScanner, BYTE *IDBuffer, BYTE ptr, BYTE len, BYTE *Data,int Address) ; apiReturn _stdcall Net_ISO6B_WriteByteBlock(SOCKET hSocket, BYTE *IDBuffer, BYTE ptr, BYTE len, BYTE *Data); Function: to write data into appointed address unit of tag Input parameter: hSacnner/hSocket: reader communication port handle IDBuffer: ID number of tag to write ptr: start address of tag memory to write(8～223) len: length of d
PAGE 90
SDK software development | VI-88R development handbook *IDBuffer, BYTE ptr, BYTE len, BYTE *Data); Function: to write data into appointed address unit of tag byte by byte.
PAGE 91
SDK software development | VI-88R development handbook Function: to set write protect for appointed address unit of appointed tag. Input parameter: hSacnner/hSocket: reader communication port handle IDBuffer: ID number of tag to write ptr: memory address of tag to set write protect(8～223) Address: RS485 networking address of reader，Address =0 no networking. return: if function return value is OK, it means set success, otherwise failure reason. 3.2.4.
PAGE 92
SDK software development | VI-88R development handbook Address: RS485 networking address of reader，Address =0 no networking. Output parameter: Protected: protection state，0- no protect，1-protected return: if function return value is OK, it means read success, otherwise failure reason. 3.2.5 3.2.5.
PAGE 93
SDK software development | VI-88R development handbook len: length of mask(unit:Bit) mask: mask(unit:Byte)，if len/8 is integer，length of mask is len/8；if len/8 is not integer,length of mask is len/8+1. Last byte data of mask in high-order position, zero fill in low-order position. Address: RS485 networking address of reader，Address =0 no networking.
PAGE 94
SDK software development | VI-88R development handbook hSacnner/hSocket: reader communication port handle EPC_WORD: length of EPC, L(unit:Word)；such as length of 96BitsEPC L=6(Words)； IDBuffer: EPC number of selected tag mem: select memory bank；0-Password，1-EPC，2-TID，3-User. ptr: start address to read(unit:WORD) len: length to read(unit:WORD) AccessPassword: 4bytes AccessPassword Address: RS485 networking address of reader，Address =0 no networking.
PAGE 95
SDK software development | VI-88R development handbook EPC_WORD, BYTE *IDBuffer, BYTE mem, BYTE ptr, BYTE len, BYTE *Data, BYTE *AccessPassword); Function: to write data into appointed address unit of tag.
PAGE 96
SDK software development | VI-88R development handbook lock state. If memory bank unlocked, can be written without password. If memory bank locked permanently, password useless. 3.2.5.
PAGE 97
SDK software development | VI-88R development handbook 1 Permanently writable 2 Writable from secured state 3 Never writable 4 Readable and writable 5 Permanently writable 6 Readable and writable from secured state 7 Never readable and writable readable and Note:0～3 only apply to EPC、TID and User memory bank；4～7 only apply to Kill Password and Access Password. AccessPassword: 4bytes AccessPassword Address: RS485 networking address of reader，Address =0 no networking.
PAGE 98
FCC WARNING This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Any changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.