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示例。
|
|
