UHFReader18.DLL动态连接库使用手册

该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回一个零值。

否则,返回非零值请查看其他返回值定义,返回的错误代码请查看错误代码定义

3.1.18) GetFhssMode ():获取读写器跳频模式。

功能描述:

该命令用于获取读写器的跳频模式。 应用:

long WINAPI GetFhssMode(unsigned char * ComAdr, unsigned char *FhssMode, long FrmHandle); 参数:

ComAdr : 输入变量,读写器地址.

FhssMode:输出变量,Bit0=0时为随机跳频模式,Bit0=1时为自适应跳频模式。

FrmHandle:输入变量,返回与读写器连接端口对应的句柄,应用程序通过该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回一个零值。

否则,返回非零值请查看其他返回值定义,返回的错误代码请查看错误代码定义.

3.1.19) SetTriggerTime():触发延时设置。

功能描述:

该命令用于设置或获取读写器触发模式下的触发有效时间。 应用:

long WINAPI SetTriggerTime(unsigned char * ComAdr, unsigned char *TriggerTime, long FrmHandle); 参数:

ComAdr : 输入变量,读写器地址.

TriggerTime:输入/输出变量,触发有效时间(0~254)*1s,默认值为0,当触发有效时间设置为255时,为获取当前的触发有效时间。

FrmHandle:输入变量,返回与读写器连接端口对应的句柄,应用程序通过该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回一个零值。

否则,返回非零值请查看其他返回值定义,返回的错误代码请查看错误代码定义

14

3.2) EPCC1-G2 协议函数:

3.2.1) Inventory_G2 ():G2询查命令

功能描述:

询查命令的作用是检查有效范围内是否有符合协议的电子标签存在。 应用:

long WINAPI Inventory_G2 (unsigned char *ComAdr, unsigned char AdrTID, unsigned char LenTID,unsigned char TIDFlag,unsigned char *EPClenandEPC, long * Totallen, long *CardNum,long FrmHandle); 参数:

ComAdr:输入变量,读写器地址。

AdrTID:输入变量,询查TID区的起始字地址。

LenTID:输入变量,询查TID区的数据字数。LenTID取值为0~15。 TIDFlag:输入变量,

TIDFlag=1:表示询查TID区; TIDFlag=1:表示询查EPC; EPClenandEPC:指向输出数组变量(输出的是每字节都转化为字符的数据)。是读到的电子标签的EPC数据,是一张标签的EPC长度+一张标签的EPC号,依此累加。每个电子标签EPC号高字在前,每一个字的最高位在前。 Totallen:输出变量,EPClenandEPC的字节数。 CardNum:输出变量,电子标签的张数。

FrmHandle:输入变量,返回与读写器连接端口对应的句柄,应用程序通过该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回值: 0x01 询查时间结束前返回

0x02 询查时间结束使得询查退出

0x03 如果读到的标签数量无法在一条消息内传送完,将分多次发送。如果Status为0x0D,则表示这条数据结束后,还有数据。

0x04 还有电子标签未读取,电子标签数量太多,MCU存储不了 返回其他值,请查看其他返回值定义,返回的错误代码请查看错误代码定义。

3.2.2) ReadCard_G2 ():G2读取数据命令

功能描述:

这个命令读取标签的整个或部分保留区、EPC存储器、TID存储器或用户存储器中的数据。从指定的地址开始读,以字为单位。 应用:

long WINAPI ReadCard_G2 (unsigned char *ComAdr, unsigned char * EPC, unsigned char Mem, unsigned char WordPtr, unsigned char Num, unsigned char * Password , unsigned char maskadr, unsigned char maskLen, unsigned char maskFlag, unsigned char * Data , unsigned char EPClength, unsigned char * errorcode,long FrmHandle); 参数:

ComAdr:输入变量,读写器地址。

15

EPC:指向输入数组变量(输入的是每字节都转化为字符的数据)。是电子标签的EPC号

Mem:输入变量,一个字节。选择要读取的存储区。

0x00: 保留区;

0x01:EPC存储器; 0x02:TID存储器; 0x03:用户存储器。

其他值保留。若命令中出现了其它值,将返回参数出错的消息。

WordPtr:输入变量,一个字节。指定要读取的字起始地址。0x00 表示从第一个字(第一个16位存储体)开始读,0x01表示从第2个字开始读,依次类推。

Num:输入变量,一个字节。要读取的字的个数。不能设置为0x00,将返回参数错误信息。Num不能超过120,即最多读取120个字。若Num设置为0或者超过了120,将返回参数出错的消息。

Password:指向输入数组变量(输入的是每字节都转化为字符的数据),四个字节,这四个字节是访问密码。32位的访问密码的最高位在PassWord的第一字节(从左往右)的最高位,访问密码最低位在PassWord第四字节的最低位,PassWord的前两个字节放置访问密码的高字。

Data:指向输出数组变量(输出的是每字节都转化为字符的数据),是从标签中读取的数据。

EPClength:输入变量,一个字节。EPC号的字节长度。

Errorcode:输出变量,一个字节,读写器返回响应状态为0xFC时,返回错误代码。

maskadr:输入变量,EPC掩模起始字节地址。 maskLen:输入变量,掩模字节数。 maskFlag:输入变量,掩模使能标记。

maskFlag =1:掩模使能; maskFlag =0:掩模禁止;

FrmHandle:输入变量,返回与读写器连接端口对应的句柄,应用程序通过该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回一个零值,读到的数据在Data中。

否则,返回非零值请查看其他返回值定义,返回的错误代码请查看错误代码定义。

3.2.3) WriteCard_G2 ():G2写命令

功能描述:

这个命令可以一次性往保留内存、EPC存储器、TID存储器或用户存储器中写入若干个字。 应用:

long WINAPI WriteCard_G2 (unsigned char *ComAdr, unsigned char * EPC, unsigned char Mem, unsigned char WordPtr, unsigned char Writedatalen, unsigned char * Writedata, unsigned char * Password, unsigned char maskadr, unsigned char maskLen, unsigned char maskFlag, long *WrittenDataNum,

16

unsigned char EPClength, unsigned char * errorcode,long FrmHandle); 参数:

ComAdr:输入变量,读写器地址。

EPC:指向输入数组变量(输入的是每字节都转化为字符的数据)。是电子标签的EPC号。

Mem:输入变量,一个字节。选择要读取的存储区。

0x00: 保留区;

0x01:EPC存储器; 0x02:TID存储器; 0x03:用户存储器。

其他值保留。若命令中出现了其它值,将返回参数出错的消息。

WordPtr:输入变量,一个字节。指定要写入的字起始地址。指定要写入数据的起始地址。如果写的是EPC区,则会忽略这个起始地址。EPC区总是规定从EPC区0x02地址(EPC号的第一个字节)开始写。

Writedatalen:输入变量,一个字节。待写入的字节数(长度必须为偶数字节数)。Writedatalen必须大于0,这里字节数必须和实际待写入的数据个数相等。否则将会返回参数错误的消息。

Writedata:指向输入数组变量(输入的是每字节都转化为字符的数据)。待写入的字。这是要写入到存储区的数据。比如,WordPtr等于0x02,则输出变量Data中第一个字(从左边起)写在Mem指定的存储区的地址0x02中,第二个字写在0x03中,依次类推。

Password:指向输入数组变量(输入的是每字节都转化为字符的数据),四个字节,这四个字节是访问密码。32位的访问密码的最高位在PassWord的第一字节(从左往右)的最高位,访问密码最低位在PassWord第四字节的最低位,PassWord的前两个字节放置访问密码的高字。 WrittenDataNum:输出变量,已经写入的字的个数。(以字为单位) EPClength:输入变量,一个字节。EPC号的字节长度。

Errorcode:输出变量,一个字节,读写器返回响应状态为0xFC时,返回错误代码。

maskadr:输入变量,EPC掩模起始字节地址。 maskLen:输入变量,掩模字节数。 maskFlag:输入变量,掩模使能标记。

maskFlag =1:掩模使能; maskFlag =0:掩模禁止;

FrmHandle:输入变量,返回与读写器连接端口对应的句柄,应用程序通过该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回一个零值,完全写入。

否则,返回非零值请查看其他返回值定义,返回的错误代码请查看错误代码定义。

17

3.2.4) EraseCard_G2 ():G2块擦除命令

功能描述:

此命令可以擦除标签的保留内存、EPC存储器、TID存储器或用户存储器的若干字。 应用:

long WINAPI EraseCard_G2 (unsigned char *ComAdr, unsigned char * EPC, unsigned char Mem, unsigned char WordPtr, unsigned char Num, unsigned char * Password, unsigned char maskadr, unsigned char maskLen, unsigned char maskFlag, unsigned char EPClength, unsigned char * errorcode,long FrmHandle); 参数:

ComAdr:输入变量,读写器地址。

EPC:指向输入数组变量(输入的是每字节都转化为字符的数据)。是电子标签的EPC号。

Mem:输入变量,一个字节。选择要读取的存储区。

0x00: 保留区;

0x01:EPC存储器; 0x02:TID存储器; 0x03:用户存储器。

其他值保留。若命令中出现了其它值,将返回参数出错的消息。

WordPtr:输入变量,一个字节。指定要擦除的字起始地址0x00 表示从第一个字(第一个16位存储体)开始擦除,0x01表示从第2个字开始擦除,依次类推。当擦除EPC区时,WordPtr必须大于等于0x02,若小于0x02,则返回参数错误消息。

Num:输入变量,一个字节。指定要擦除的字的个数。从WordPtr指定的地址开始擦除,擦除Num指定个数的字。若Num为0x00,则返回参数错误信息。

Password:指向输入数组变量(输入的是每字节都转化为字符的数据),四个字节,这四个字节是访问密码。32位的访问密码的最高位在PassWord的第一字节(从左往右)的最高位,访问密码最低位在PassWord第四字节的最低位,PassWord的前两个字节放置访问密码的高字。 EPClength:输入变量,一个字节。EPC号的字节长度。

Errorcode:输出变量,一个字节,读写器返回响应状态为0xFC时,返回错误代码。

maskadr:输入变量,EPC掩模起始字节地址。 maskLen:输入变量,掩模字节数。 maskFlag:输入变量,掩模使能标记。

maskFlag =1:掩模使能; maskFlag =0:掩模禁止;

FrmHandle:输入变量,返回与读写器连接端口对应的句柄,应用程序通过该句柄可以操作连接在相应端口的读写器。如果打开不成功,返回的句柄值为-1。 返回:

如果该函数调用成功,返回一个零值,擦除成功。

否则,返回非零值请查看其他返回值定义,返回的错误代码请查看错误代码

18

联系客服:779662525#qq.com(#替换为@) 苏ICP备20003344号-4