必达门锁接口函数(btcard32dll)使用说明.docVIP

btcard32.dll动态库使用说明 动态库函数 int Card_Operate(unsigned char *ACommand, int CmdSize) 功能描述 通过传递操作命令来进行读卡或写卡操作，并在读卡成功之后返回功能卡信息。 参数说明 ACommand: 指向操作命令及返回信息的字符串指针。 CmdSize: ACommand变量所分配的内存空间的大小。写卡时，该值不能小于操作命令的长度；读卡时，由于返回信息比操作命令长，所以该值不能小于返回信息的长度。建议对ACommand变量分配256个字节的内存空间。 返回值 = 0 正确，如果是读卡操作，则通过ACommand参数返回相应的功能卡信息。 0 错误，如果操作命令包含错误的字段信息，则通过ACommand参数返回错误字段的标识。 举例 unsigned char Card_Command[256]; Rt = Card_Operate(Card_Command, 256); int SerialNo_FromNow 功能描述 通过本地电脑的时间换算出4个字节的整型流水号，可以用此作为字段GI的值。 返回值 0 当前电脑时间的整型流水号。 举例 SN = SerialNo_FromNow; int Bin_Hex(unsigned char *Dest, unsigned char *Source, int Len) 功能描述 二进制字符串转换为十六进制字符串，4位的二进制转换为1位的十六进制。 参数说明 Dest: 指向十六进制字符串的指针，分配空间为字符串的长度加1。 Source: 指向二进制字符串的指针，分配空间为字符串的长度加1。 Len: 二进制字符串的长度。 返回值 = 0 正确。 = -1 错误，参数Source指向的字符串不是二进制字符串。 举例 unsigned char Hex[5]; unsigned char Bin[17] Rt = Bin_Hex(Hex, Bin, 16); int Hex_Bin(unsigned char *Dest, unsigned char *Source, int Len) 功能描述 十六进制字符串转换为二进制字符串，1位的十六进制转换为4位的二进制。 参数说明 Dest: 指向二进制字符串的指针，分配空间为字符串的长度加1。 Source: 指向十六进制字符串的指针，分配空间为字符串的长度加1。 Len: 十六进制字符串的长度。 返回值 = 0 正确。 = -1 错误，参数Source指向的字符串不是十六进制字符串。 举例 unsigned char Hex[5]; unsigned char Bin[17] Rt = Hex_Bin(Bin, Hex, 4); 功能卡操作命令 命令格式 STXoperate_mode|field_idfield_value| …… |field_idfield_value|ETX 举例： \2CWR|DMMWIC232|DPCOM1|SIBE-TECH|SP123456|CVIC55|CMSLE4442|CTG|CN100|LC010101|GI165597813|BT20050331000000|ET20050401120000|\3 命令详解 STX 命令头，其值为ASCII字符(0x02)，作为每条操作命令的起始标志。 ETX 命令尾，其值为ASCII字符(0x03)，作为每条操作命令的结束标志。 OperateMode 操作模式，决定该命令是进行读卡还是写卡的操作，可选范围如下表： 可选值 描述 CRD 读卡 CWR 写卡 CV 功能卡版本，与门锁系统所选用的智能卡型相关，可选范围如下表： 可选值 描述 IC55 IC卡门锁系统ver 5.5 IB55 iB卡门锁系统ver 5.5 MF57 Mifare 卡门锁系统 ver5.7 DM（可选） 读卡器型号，可选范围取决于（CV），如下表： 可选值 功能卡版本 描述 MWIC232 IC55 明华IC读卡器 DS9097U IB55 达拉斯iButton读卡器 ZYMSR100 MF57 广州致远Mifare1读卡器 DP（可选） 连接端口，默认值为COM1，可选范围取决于（DM），如下表： 可选值 读卡器型号 通讯方式 COM1/COM2/COM3/COM4 MWIC232 RS232通讯方式 COM1/COM2/COM3/COM4 DS9097U RS232通讯方式 CM（可选） 智能卡型号，每一种功能卡类都对应一种或以上的智能卡型号，其可选范围取决于（CV）及（DM）。例如在IC55版本中，如果选用MWIC232读卡器，则宾客卡所使用的是SLE4442卡。对应关系如下