T5557卡读、写及EM4100 ID、HID卡复制函数说明
T5557读写器函数使用说明
读写器介绍：https://item.taobao.com/item.htm?spm=a1z10.5-c.w4002-17663462238.13.6f036f89o6lNt1&id=675212889085
https://item.taobao.com/item.htm?spm=a1z10.5-c.w4002-17663462238.13.6f036f89o6lNt1&id=675212889085
- 动态库简介
动态库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); |
|
|
输入 |
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、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示例。 |
|
九、将T5557卡制作成ID卡（也就是EM4100及兼容卡）并写入ID卡号
函数名：t5557_to4100
|
功能 |
将t5557卡配置成兼容EM4100的ID卡，并写入卡号 |
|
|
C#声明 |
public static extern byte t5557_to4100 (byte ctrlword, byte[] seria, byte[] oldkey, byte[] newkey, byte[] myuidbuf); |
|
|
输入 |
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。如果在控制字中没有指定NEEDKEY，数组可不赋值。
4、newkey指向存放新密码的字节数组，4个byte。如果在控制字中没有指定KEYENABLE，数组可不赋值。
5、myuidbuf指向存放新ID卡信息的字节数组，5个byte。 |
|
|
返回 |
返回unsigned char值。并将寻到的t5557卡的序列号传值到*serial数组。 |
|
|
返 回 值 说 明 |
0 |
操作成功。*serial数组中的数据有效。 |
|
8 |
卡不在感应区或密码不正确。 |
|
|
2 |
本卡尚未开启密码功能，函数myctrlword中无需加入NEEDKEY。*serial数组中的数据有效。 |
|
|
3 |
需要密码才能制卡，函数myctrlword要加入NEEDKEY。*serial数组中的数据有效。 |
|
|
5 |
密码错误。*serial数组中的数据有效。 |
|
|
23 |
机器没连上，或驱动程序未安装 |
|
|
其他 |
请参看附表 |
|
|
例子及注释 |
请到本公司官网下载各种开发工具的最新Demo示例。 |
|
十、将T5557卡制作成HID卡并写入HID卡号
函数名：t5557_tohid
|
功能 |
将t5557卡配置成HID卡并写入卡号 |
|
|
C#声明 |
public static extern byte t5557_tohid(byte ctrlword, byte[] seria, byte[] oldkey, byte[] newkey, byte[] myuidbuf); |
|
|
输入 |
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 = NEEDSERIAL+ RESETCARD+ KEYENABLE;
2、serial指向一个分配6个byte、下标由0开始的可写数组。如果在控制字中没有指定NEEDSERIAL ，则Serial数组的内容无需赋值，因为此数组仅用于返回值。如果指定了NEEDSERIAL，则必须为数组的内容赋值。
3、oldkey指向存放旧认证密码的字节数组，4个byte。如果在控制字中没有指定NEEDKEY，数组可不赋值。
4、newkey指向存放新密码的字节数组，4个byte。如果在控制字中没有指定KEYENABLE，数组可不赋值。
5、myuidbuf指向存放新HID卡信息的字节数组，7个byte。 |
|
|
返回 |
返回unsigned char值。并将寻到的t5557卡的序列号传值到*serial数组。 |
|
|
返 回 值 说 明 |
0 |
操作成功。*serial数组中的数据有效。 |
|
8 |
卡不在感应区或密码不正确。 |
|
|
2 |
本卡尚未开启密码功能，函数myctrlword中无需加入NEEDKEY。*serial数组中的数据有效。 |
|
|
3 |
需要密码才能制卡，函数myctrlword要加入NEEDKEY。*serial数组中的数据有效。 |
|
|
5 |
密码错误。*serial数组中的数据有效。 |
|
|
23 |
机器没连上，或驱动程序未安装 |
|
|
其他 |
请参看附表 |
|
|
例子及注释 |
请到本公司官网下载各种开发工具的最新Demo示例。 |
|
附表
|
返 回 值 说 明 |
0 |
操作成功。 |
|
1 |
写入配置的值不正确。 |
|
|
2 |
本卡尚未开启密码功能，函数myctrlword中无需加入NEEDKEY。 |
|
|
3 |
需要密码才能制卡，函数myctrlword要加入NEEDKEY。 |
|
|
5 |
密码错误。 |
|
|
8 |
卡不在感应区。 |
|
|
21 |
没有动态库。 |
|
|
22 |
动态库或驱动程序异常。 |
|
|
23 |
驱动程序错误或发卡器尚未安装。 |
|
|
24 |
操作超时，一般是动态库没有反应。 |
|
|
25 |
发送字数不够，一般不会出现。 |
|
|
26 |
发送数据的CRC校验位错，一般不会出现。 |
|
|
27 |
接收发卡器的返回信息数不够，一般不会出现，也可能是 DLL文件与发卡器版本不一致。
|
|
|
28 |
接收发卡器的返回信息的CRC校验位错，一般不会出现，也可能是 DLL文件与发卡器版本不一致。 |