m1大锁接口函数使用说明

1、AVA(MF308V3)门锁接口开发包使用说明M1 卡门锁工作原理卡内主要有楼栋、楼层、客房、起始时间，结束时间等参数。1.楼栋，楼层和客房由用户在第一次配置的时候录入，请从的以下房间定义窗口中获取对应值：2.作业流水号是由“起始时间”和“一分钟内序号”组成。其中起始时间是指发卡时的系统时钟的年月日时分（在多客户端系统中，请注意各个系统之间的时钟需要同步），而一分钟内序号是指在每分钟内每发一张新卡，该参数必须递增（取值范围为 030）。当需要设置新的挂失号时，卡中的作业流水号必须大于门锁电路板中的作业流水号，否则将导致无法开门。另外，每张卡的作业流水号必须保持其唯一性并存档，它是查询开门的数据

2、依据。3.是否挂失标志主要用来挂失丢失的卡片，如果接口程序不需要进行挂失处理，请填 0。如需要处理，则请参照此规则: 对于同住卡，是否挂失必须置为 0，并且作业流水号必须大于上一次挂失进门锁的作业流水号。如果要挂失之前的所有卡片，则把是否挂失标志置为 1，并且作业流水号大于上一次挂失进门锁的作业流水号即可。4.的“帮商识别号是用于保护用户的卡片数据不被未修改，该参数可由管理助”菜单中的“关于门锁管理系统”框取得，如下图所示：接口函数说明提供Windows下的 32 位动态连接库libInvokeerfaceMF308V3.dll常用参数定义typedef struct _CardInfonCa

3、rdType;BeginYear;Begonth;BeginDay;BeginHour;Beginute;BeginNum;nBuildingID; nFloorID; nRoomID;isReportLost;EndYear; EndMonth; EndDay; EndHour;EndMinute;1;2;3;CardInfo, * LPCardInfo;常用函数说明函数：CreateGpInfo);ard(const char * PortName, constsector, constagentId, CardInfo *该函数用于用生成或挂失宾客卡，其中的“PortName”为与相连接

4、的计算机串口名称（如，“COM1”），“sector”为M1 卡的目标扇区，“agentId”为传入的商识别号，“pInfo”为传入的卡片信息。该函数返回 0 表示操作成功，返回-1 表示操作失败，失败原因可使用“GetLastErrno()”获得。函数：ReadCardInfo(const char * PortName, constsector, CardInfo * pInfo);该函数用于宾客卡的卡片信息， 其中的“PortName”为与相连接的计算机串口名称（如，“COM1”），“sector”为M1 卡的目标扇区，“pInfo”传出的宾客卡卡片信息。 该函数返回 0 表示操作成功，

5、返回-1 表示操作失败，失败原因可使用“GetLastErrno()”获得。函数：DestroyGard(const char * PortName, constsector, constagentId);该函数用于清除宾客卡的卡片信息， 其中的“PortName”为与相连接的计算机串口名称（如，“COM1”），“sector”为M1 卡的目标扇区，“pInfo”传出的宾客卡卡片信息。 该函数返回 0 表示操作成功，返回-1 表示操作失败，失败原因可使用“GetLastErrno()”获得。函数：GetLastErrno();该函数用于取得最后一次接口函数调用的错误代码。返回值定义请查阅“函数

6、错误代码”。函数：void StrErrno(nErrno, char * Str,lenOfStr);该函数为辅助函数，用于将错误代码转换成可阅读的字符形式。函数：GetMifareCardPhyID(const char * PortName);该函数用于M1 卡的物理ID。其中的“PortName”为与相连接的计算机串口名称（如：“COM1”）。该函数返回-1 表示操作失败，其它值为对应M1 卡的物理ID号。函数：WriteCard(const char * PortName, const const char * Buffer, const);Sector, constBlockID,

7、 const char * Password,BufferCount该函数用于使用指定向 M1 卡的指定扇区指定块写入指定数据。其中的“PortName”为与相连接的计算机串口名称（如：“COM1”）。“Sector”为 M1 卡的指定目标扇区。“BlockID”为M1 卡的指定扇区内的目标块，取值范围为 02。“Password”为 M1 卡指定扇区的操作，该值必须为 6 个字节的字符数组。“Buffer”为写卡数据的缓冲区，必须在调用前先分配好空间。“BufferCount”为写卡数据缓冲区(Buffer)的字节数，取值范围可从 116。该函数返回 0 表示操作成功，返回-1 表示操作失败

8、。函数：ReadCard(const char * PortName, constSector, constBlockID, const char * Password,char * Buffer, const);该函数用于使用指定BufferCount向 M1 卡的指定扇区数据。其中的“PortName”为与相连接的计算机串口名称（如：“COM1”）。“Sector”为 M1 卡的指定目标扇区。 “BlockID”为M1 卡的指定扇区内的目标块，取值范围为 02。“Password”为 M1 卡指定扇区的操作，该值必须为 6 个字节的字符数组。“Buffer”为读卡数据的缓冲区，必须在调用前

9、先分配好空间。“BufferCount”为读卡数据缓冲区(Buffer)的字节数，取值范围可从 116。该函数返回 0 表示操作成功，返回-1 表示操作失败。用户接口开发使用步骤1.2.3.使用厂家的门锁管理对每个门锁制成宾客卡调用接口函数或使用演示程序读出卡片数据，并用自己的数据库相应的客房。在自己的数据库中定义作业流水号，用于管理识别每张卡与数据库中的对应发卡记录，该参数将写入卡中。4.使用接口函数将已准备好的参数数据写入卡中。函数错误代码代码描述原因解决方法1无效参数使用无效的参数调用接口函数请检查调用的传入参数是否为空2打开串口错误串口名称错误或计算机硬件损坏请检查调用 传入的串口名称是否有效，或计算机串口是否损坏注意1.2.所有宾客卡都必须在厂家的管理中写一次宾客卡。发卡原则，宾客卡按用户自己的酒店综合管理系统，其它卡均需在厂家的管理中。3.4.5.多个门锁、酒店综合管理系统在不同卡片之间互相混用。正式开通使用前，建议将所有卡片全部回收，然后再进行发卡操作。特别注意计算机的时间不能出现，保持时间正确，否则会导致开门失败。示例代码当前已包括Visual C+、Delphi 7 源代码，以便用户参考，对于其它开发使用。，可直接导入3写卡超时底层无法向读卡器写入数据请检查计算机串口是否损坏，或者计算机是否与正常连接4读卡超时底层无法向读卡