OUR_IDR.dll动态库T5557卡使用说明
一、动态库简介
动态库OUR_IDR.dll用VC6.0++开发,编译成Release实体,适用于WIN98、NT、2000、XP、2003、Win7、Win8、Win10、Win11环境。本文档下面的源代码例子是C++builder 的调用格式。
本动态库是本公司USB接口T5557系列卡发卡器的配套文件,必须和发卡器一起使用,此动态库除了支持T5557系列卡的读卡、写卡、配置初始化卡操作,还支持兼容EM4100的ID卡、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只需指向一个至少已分配了4个byte空间的可写数组,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只需指向一个至少已分配了5个byte的可写数组, 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只需指向一个至少已分配了7个byte空间的可写数组, 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_init,t5557_write ,t5557_changekey函数有效
byte KEYENABLE = 0x08; //启用本卡的密码功能
byte RESETCARD = 0x10; //操作成功后重启卡片
例如:卡片已开启密码功能、只读指定t5557卡的 控制字取值如下
myctrlword = NEEDKEY+ NEEDSERIAL;
2、 serial指向一个分配6个byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。
3、 key指向存放卡密码的字节数组,4个byte。如果在控制字中没有指定NEEDKEY,数组可不赋值。
4、 blockflag指向本次要读哪几个块的字节数组,2个byte,相应bit为1表示对应的块要写,为0表示不写。具体取值请参看示例。
5、 readdata指向存放读卡信息的字节数组,长度50个byte。如果读卡操作成功,第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_init,t5557_write ,t5557_changekey函数有效
byte KEYENABLE = 0x08; //启用本卡的密码功能
byte RESETCARD = 0x10; //操作成功后重启卡片
例如:卡片已开启密码功能、只写指定t5557卡的 控制字取值如下
myctrlword = NEEDKEY+ NEEDSERIAL;
7、 serial指向一个分配6个byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。
8、 key指向存放卡密码的字节数组,4个byte。如果在控制字中没有指定NEEDKEY,数组可不赋值。
9、 blockflag指向本次要写哪几个块的字节数组,2个byte,相应bit为1表示对应的块要写,为0表示不写。具体取值请参看示例。
10、 writedata指向存放写卡信息的字节数组,最长48个byte。
|
返回
|
返回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_init,t5557_write ,t5557_changekey函数有效
byte KEYENABLE = 0x08; //启用本卡的密码功能
byte RESETCARD = 0x10; //操作成功后重启卡片
例如:卡片已经开启了密码功能、只写指定t5557卡、写卡后重启卡片的 控制字取值如下
myctrlword = NEEDKEY+ NEEDSERIAL+ RESETCARD;
2、 serial指向一个分配6个byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。
3、 oldkey指向存放旧认证密码的字节数组,4个byte。如果在控制字中没有指定NEEDKEY,数组可不赋值。
4、 configdata指向存放配置信息的字节数组,4个byte。具体取值请参看示例,一般初始取值为十六进制的:00088028。
5、 newkey指向存放新ID卡信息的字节数组,4个byte。如果在控制字中没有指定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_init,t5557_write ,t5557_changekey函数有效
byte KEYENABLE = 0x08; //启用本卡的密码功能
byte RESETCARD = 0x10; //操作成功后重启卡片
例如:需带密码、只写指定t5557卡、写卡后重启卡片、同时修改新密码的 控制字取值如下
myctrlword = NEEDKEY+ NEEDSERIAL+ RESETCARD+ KEYENABLE;
2、 serial指向一个分配6个byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL,则Serial数组的内容无需赋值,因为此数组仅用于返回值。如果指定了NEEDSERIAL,则必须为数组的内容赋值。
3、 oldkey指向存放旧认证密码的字节数组,4个byte。
4、 newkey指向存放新密码的字节数组,4个byte。
|
返回
|
返回unsigned char值,并将寻到的卡的序列号传值到*serial数组。
|
返
回
值
说
明
|
0
|
操作成功,*serial数组中的数据有效。
|
8
|
卡不在感应区。
|
2
|
本卡尚未开启密码功能,函数myctrlword中无需加入NEEDKEY。
|
3
|
需要指定旧密码才能改密码,函数myctrlword要加入NEEDKEY。
|
5
|
密码错误
|
23
|
机器没连上,或驱动程序未安装。
|
其他
|
请参看附表
|
例子及注释
|
请到本公司官网下载各种开发工具的最新Demo示例。
|
|