readme开发包教.doc

TimeRecorder 用户使用手册 此动态库是以都德利考勤机FIRE－2000(包括带姓名显示和不带姓名显示两种卡机)射频卡为对象， 实现PC机与考勤机之间的通信，以及资料传送的驱动程序。 它必须使用PC机上的一个串行通讯口， 通讯的baudrate 为19200bps。 几个术语的约定：1，物理卡号：是指ID卡中固有的卡号，它是在ID卡出厂时产生。一般是不能变动的。2，逻辑卡号：是指用户映射到某张ID卡的一个数字符号，它约定为6位，当它对应于物理卡号发到考勤机中后即发生作用。（注：一个物理卡号允许对应几个逻辑卡号。但只有第一个是有效的）3，发卡名单表：它是存放在考勤机中的某一片特定存储区中的物理卡号与逻辑卡号的映射表。4，考勤记录表：它是存放在考勤机中某一特定存储区中的员工考勤打卡的记录表。 OpenCommPort 函数 CloseCommPort 函数 ReadCardNo 函数 SetTimeDate 函数 SetTimeTime 函数 ClearCardFlag 函数 DeleteOneCard 函数 ClearCardData 函数 ClearRecordData 函数 SendValidCard 函数 SendValidCardName 函数 ChangeNewAddress 函数 SetAlarmClock 函数 ReadRecordData 函数 ReadValidCard 函数 ReadValidCardName 函数 SeachOlineMach 函数 附录1-1 动态库在DELPHI中的引用 附录1-2动态库在VB引用 DLL提供的接口函数及其说明： 1． Boolean OpenCommPort (PortNum： Integer) 功能： 用来打开一个串行端口， 在做所有的操作之前， 请调用此函数来设置并打开一个有效的串行端口，否则调用其他函数将无法返回正确结果。? 参数说明： PortNum 是一个正整数， 表示用户想打开的串行端口号， 一般为1 或2， 如果用户扩展了PC 机的串行端口，也可以使用其它， 但是一般小于10。 ? Return： 如果函数打开端口成功， 将返回true， 否则返回false。 ? Note：在调用此函数时，请选择一个有效的端口号， （ 没被其它设备占用且存在的端口）， 如果端口无效，则返回false。 打开端口成功， 则返回true， 2． Boolean CloseCommPort ( ). 功能： 用来关闭一个被应用程序打开的端口。 参数说明：无参数。 RETURN： 如果关闭端口成功， 将返回TRUE， 否则返回FALSE。 ３．Pchar ReadCardNo (Addr： integer) 功能：用来读取考勤机中最后一次打卡的物理卡号。 参数说明： Addr是一个正整数，表示考勤机的地址（使用者可以在打开考勤机电源时得知，它是个“１—９９”之间的数字。）如果地址不正确，将无法进行通讯。特别提示：在以下函数的说明中，如果没有特别说明，Addr表示意义均相同。 RETUEN：如果成功，将返回串16位的数据串，否则返回空串。 NOTE：在返回的16位数据串中：1-2位表示考勤机地址，应该等于ADDR，3-4位是“07”，5-6位是“04”或“09”（它代表清除读卡标志位，“04”表示正常的卡号的标志，“09”表示已被清除的标志。使用者可以根据它来处理该数据串）7-16位是读到的卡号。 4． Boolean SetTimeDate (Addr ,Iyear ,IMonth,Iday : integer) 功能：用来下传日期给考勤机 参数说明： Iyear表示下传的年份，Imonth表示下传的月份，Iday表示下传的日期 RETURN：如果下传日期成功，将返回TRUE， 否则返回FALSE。 5．Boolean SetTimeTime(Addr,IHour,IMinute,ISecend : integer) 功能：用来下传时间给考勤机 参数说明： Ihour 表示下传的小时，Iminute 表示下传的分钟，Isecend 表示下传的秒。 RETURN：如果下传时间成功，则返回TURE，否则返回 FLASE。 6．Boolean ClearCardFlag (Addr : Integer) 功能：用来清除读卡标志位，在使用它来清除标志位，再用ReadCardNo去读物理卡号时，其返回值的5-6位将是“09