T5557卡读、写及EM4100 ID、HID卡复制函数说明

T5557读写器函数使用说明

读写器介绍：https://item.taobao.com/item.htm?spm=a1z10.5-c.w4002-17663462238.13.6f036f89o6lNt1&id=675212889085https://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文件与发卡器版本不一致。

vb.net示例源码：https://download.csdn.net/download/zhangjin7422/85597830
delphi示例源码：https://download.csdn.net/download/zhangjin7422/85467226
c#示例源码：https://download.csdn.net/download/zhangjin7422/85467158