消费机 水控机 售饭机 电梯门禁 门禁机
快速寻找产品(请输入产品型号或名称的关键词):
首页> 技术文档

技术文档

T5557发卡器动态库函数使用说明一

发布者:广州荣士电子有限公司         发布时间: 2022-5-25 

OUR_IDR.dll动态库T5557卡使用说明

一、动态库简介

动态库OUR_IDR.dllVC6.0++开发,编译成Release实体,适用于WIN98NT2000XP2003Win7Win8Win10Win11环境。本文档下面的源代码例子是C++builder 的调用格式。

本动态库是本公司USB接口T5557系列卡发卡器的配套文件,必须和发卡器一起使用,此动态库除了支持T5557系列卡的读卡、写卡、配置初始化卡操作,还支持兼容EM4100ID卡、HID卡的卡号读取功能,同时支持将T5557卡制做成ID卡、HID卡等功能。

OUR_ IDR.dll支持在软件运行中可以随时更换USB接口。本公司免驱型和有驱型读写器使用的OUR_ IDR.dll不同,但函数的调用一样,如果客户程序开发好了,免驱型和有驱型互换时,只需更换对应的OUR_ IDR.dll

推荐使用动态调用的方法使用本动态库。


一、让读卡器发出声音

函数名:idr_beep

功能

让读写器发出声响。(暂不开放对指示灯的控制,如果有特殊要求请致电本公司) 

C#声明

public static extern byte idr_beep(UInt32 xms);

输入

xms为响声的时间长度,单位为2毫秒

返回

返回unsigned char值。

0

操作成功。

22

动态库或驱动程序异常,解决方法是退出程序,拔出发卡器,重装驱动程序再插上发卡器重试,或者重新拷贝动态库OUR_IDR.dll到正确的位置。

23

机器没连上,或驱动程序未安装。

27

USB传输不稳定导致传输的字符不全。不需理会这个错误,因为基本上是不会出现这个错误的。

28

USB传输不稳定导致CRC校验错。不需理会这个错误,因为基本上是不会出现这个错误的。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。

二、读出读卡器各自编码唯一的设备号

函数名:pcdgetdevicenumber

功能

读出读卡器各自编码唯一的设备号,此设备号可用于软件的产权保护,功能跟软件加密码类似。

C#声明

public static extern byte pcdgetdevicenumber(byte[] devicenumber);

输入

形参* devicenumber只需指向一个至少已分配了4byte空间的可写数组,devicenumber的下标由0开始。devicenumber数组的内容无需赋值,因为此数组仅用于返回值。

返回

返回unsigned char值,并将发卡器的序列号传值到* devicenumber数组。

0

操作成功,* devicenumber数组中的数据有效。

22

动态库或驱动程序异常,解决方法是退出程序,拔出发卡器,重装驱动程序再插上发卡器重试,或者重新拷贝动态库OUR_IDR.dll到正确的位置。

23

机器没连上,或驱动程序未安装。

28

USB传输不稳定导致CRC校验错。不需理会这个错误,因为基本上是不会出现这个错误的。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。

三、读EM4100卡并返回卡的全部五个字节信息(ID卡厂商信息和卡序列号)

函数名:idr_read

功能

寻卡并返回EM4100及兼容ID卡的序列号,如果卡在感应区,每次执行均返回卡号

C#声明

public static extern byte idr_read(byte[] serial);

输入

形参*serial只需指向一个至少已分配了5byte的可写数组, serial的下标由0开始。Serial数组的内容无需赋值,因为此数组仅用于返回值。

返回

返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。

0

操作成功,*serial数组中的数据有效。

8

寻卡错误,根本就没有卡在感应区,*serial无效。

22

动态库或驱动程序异常,解决方法是退出程序,拔出发卡器,重装驱动程序再插上发卡器重试,或者重新拷贝动态库OUR_IDR.dll到正确的位置。

23

机器没连上,或驱动程序未安装。

28

USB传输不稳定导致CRC校验错。不需理会这个错误,因为基本上是不会出现这个错误的。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。


四、读HID卡并返回卡的全部七个字节信息

函数名:hid_read

功能

寻卡并返回HID卡的序列号,如果卡在感应区,每次执行均返回卡号

C#声明

public static extern byte hid_read(byte[] serial);

输入

形参*serial只需指向一个至少已分配了7byte空间的可写数组, serial的下标由0开始。Serial数组的内容无需赋值,因为此数组仅用于返回值。

返回

返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。

0

操作成功,*serial数组中的数据有效。

8

寻卡错误,根本就没有卡在感应区,*serial无效。

22

动态库或驱动程序异常,解决方法是退出程序,拔出发卡器,重装驱动程序再插上发卡器重试,或者重新拷贝动态库OUR_IDR.dll到正确的位置。

23

机器没连上,或驱动程序未安装。

28

USB传输不稳定导致CRC校验错。不需理会这个错误,因为基本上是不会出现这个错误的。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。


五、读取T5557系列卡块内信息

函数名:t5557_read

功能

读取t5557卡指定块的数据

C#声明

public static extern byte t5557_read(byte ctrlword,byte[] seria,byte[] key,byte[] blockflag,byte[] readdata);

输入

1、  ctrlword读写卡操作控制字,长度一个字节,取值范围是以下数值的组合:

byte NEEDSERIAL = 0x01; //需要只对指定系列号的卡操作

    byte NEEDKEY = 0x02; //需要用密码认证

    byte LOCKBIT = 0x04; //锁定配置块或数据块,仅对 t5557_initt5557_write t5557_changekey函数有效

    byte KEYENABLE = 0x08; //启用本卡的密码功能

byte RESETCARD = 0x10; //操作成功后重启卡片

例如:卡片已开启密码功能、只读指定t5557卡的 控制字取值如下

myctrlword =  NEEDKEY+ NEEDSERIAL;

2、   serial指向一个分配6byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。

3、  key指向存放卡密码的字节数组,4byte。如果在控制字中没有指定NEEDKEY,数组可不赋值。

4、  blockflag指向本次要读哪几个块的字节数组,2byte,相应bit1表示对应的块要写,为0表示不写。具体取值请参看示例。

5、  readdata指向存放读卡信息的字节数组,长度50byte。如果读卡操作成功,第0字节返回‘卡无线转输分频比’,第1字节返回本次读取的有效数据长度。

返回

返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。

0

操作成功,*serial数组中的数据有效。

8

寻卡错误,根本就没有卡在感应区,*serial无效。

2

本卡尚未开启密码功能,函数myctrlword中无需加入NEEDKEY

3

需要密码才能读卡,函数myctrlword要加入NEEDKEY

5

密码错误。

23

机器没连上,或驱动程序未安装

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。


六、写数据到T5557系列卡的块内

函数名:t5557_write

功能

写数据到t5557卡的指定块内

C#声明

public static extern byte t5557_write(byte ctrlword,byte[] seria,byte[] key,byte[] blockflag,byte[] writedata);

输入

6、  ctrlword读写卡操作控制字,长度一个字节,取值范围是以下数值的组合:

byte NEEDSERIAL = 0x01; //需要只对指定系列号的卡操作

    byte NEEDKEY = 0x02; //需要用密码认证

    byte LOCKBIT = 0x04; //锁定配置块或数据块,仅对 t5557_initt5557_write t5557_changekey函数有效

    byte KEYENABLE = 0x08; //启用本卡的密码功能

byte RESETCARD = 0x10; //操作成功后重启卡片

例如:卡片已开启密码功能、只写指定t5557卡的 控制字取值如下

myctrlword =  NEEDKEY+ NEEDSERIAL;

7、   serial指向一个分配6byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。

8、  key指向存放卡密码的字节数组,4byte。如果在控制字中没有指定NEEDKEY,数组可不赋值。

9、  blockflag指向本次要写哪几个块的字节数组,2byte,相应bit1表示对应的块要写,为0表示不写。具体取值请参看示例。

10、              writedata指向存放写卡信息的字节数组,最长48byte

返回

返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。

0

操作成功,*serial数组中的数据有效。

8

寻卡错误,根本就没有卡在感应区,*serial无效。

2

本卡尚未开启密码功能,函数myctrlword中无需加入NEEDKEY

3

需要密码才能写卡,函数myctrlword要加入NEEDKEY

5

密码错误。

23

机器没连上,或驱动程序未安装。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。


七、写T5557系列卡配置块信息

函数名:t5557_init

功能

t5557初始化、如是否开启密码功能等

C#声明

public static extern byte t5557_init(byte ctrlword,byte[] seria,byte[]oldkey,byte[] configdata,byte[] newkey);

输入

1、  ctrlword读写卡操作控制字,长度一个字节,取值范围是以下数值的组合:

byte NEEDSERIAL = 0x01; //需要只对指定系列号的卡操作

    byte NEEDKEY = 0x02; //需要用密码认证

    byte LOCKBIT = 0x04; //锁定配置块或数据块,仅对 t5557_initt5557_write t5557_changekey函数有效

    byte KEYENABLE = 0x08; //启用本卡的密码功能

byte RESETCARD = 0x10; //操作成功后重启卡片

例如:卡片已经开启了密码功能、只写指定t5557卡、写卡后重启卡片的 控制字取值如下

myctrlword =  NEEDKEY+ NEEDSERIAL+ RESETCARD;

2、   serial指向一个分配6byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。

3、  oldkey指向存放旧认证密码的字节数组,4byte。如果在控制字中没有指定NEEDKEY,数组可不赋值。

4、  configdata指向存放配置信息的字节数组,4byte。具体取值请参看示例,一般初始取值为十六进制的:00088028

5、  newkey指向存放新ID卡信息的字节数组,4byte。如果在控制字中没有指定KEYENABLE(不开启密码功能),数组可不赋值。

返回

返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。

0

操作成功,*serial数组中的数据有效。

8

卡不在感应区或密码不正确。

1

写入配置的值不正确,请重新写入。

2

本卡尚未开启密码功能,函数myctrlword中无需加入NEEDKEY

3

需要密码才能重新设定,函数myctrlword要加入NEEDKEY

5

密码错误。

23

机器没连上,或驱动程序未安装。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。


八、修改T5557系列卡密码

函数名:t5557_changekey

功能

修改已开启密码功能的卡片密码。

C#声明

public static extern byte t5557_changekey(byte ctrlword,byte[] seria,byte[] oldkey,byte[] newkey);

输入

1、  ctrlword读写卡操作控制字,长度一个字节,取值范围是以下数值的组合:

byte NEEDSERIAL = 0x01; //需要只对指定系列号的卡操作

    byte NEEDKEY = 0x02; //需要用密码认证

    byte LOCKBIT = 0x04; //锁定配置块或数据块,仅对 t5557_initt5557_write t5557_changekey函数有效

    byte KEYENABLE = 0x08; //启用本卡的密码功能

byte RESETCARD = 0x10; //操作成功后重启卡片

例如:需带密码、只写指定t5557卡、写卡后重启卡片、同时修改新密码的 控制字取值如下

myctrlword =  NEEDKEY+ NEEDSERIAL+ RESETCARD+ KEYENABLE;

2、   serial指向一个分配6byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。

3、   oldkey指向存放旧认证密码的字节数组,4byte

4 newkey指向存放新密码的字节数组,4byte

返回

返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。

0

操作成功,*serial数组中的数据有效。

8

卡不在感应区。

2

本卡尚未开启密码功能,函数myctrlword中无需加入NEEDKEY

3

需要指定旧密码才能改密码,函数myctrlword要加入NEEDKEY

5

密码错误

23

机器没连上,或驱动程序未安装。

其他

请参看附表

例子及注释

请到本公司官网下载各种开发工具的最新Demo示例。




 
上一篇:T5557发卡器动态库函数使用说明二 下一篇:ISO15693、ISO14443A、ISO14443B协议常用芯片
     
Guangzhou Rong Shi Electronics Co., Ltd., China 广州荣士电子有限公司 备案/许可证编号:粤ICP备11063836号
TEL  020-22307058    020-82301718
消费机
隐私政策

消费机 水控机 售饭机 电梯门禁 门禁机

网站地图 xml