终端设备接口协议(V4.x)标准.doc

清华茂物IC卡终端设备接口规范(V4.x) （首次发布：2004-9-5） 清华茂物IC卡终端设备接口完成对终端设备参数的设置、黑名单下载、记录下载等信息的操作，适用于条码机、门禁机、餐饮机、通道机等终端设备。 定义文件包括：MWPublicAPI.h(公用类)、MWAccessAPI.h(门禁考勤类)、MWCanteenAPI.h(消费类)、MWGetDataAPI.h(数据采集器类)。 通讯参数为：RS485/RS232，9600bps。 公用类终端设备类接口定义如下： 打开端口函数 函数原形：extern C BOOL FAR PASCAL EXPORT MWOpenCOM(const char *nPort); 参数：nPort为串口号-----COM1、COM2、COM3、COM4 函数返回：打开串口成功，返回TRUE，否则，返回FALSE 注意：配置文件Mwiccard.cfg必须在同一目录下。 关闭端口函数 函数原形：extern C BOOL FAR PASCAL EXPORT MWCloseCOM(); 参数：无 函数返回：关闭串口成功，返回TRUE，否则，返回FALSE 注意：CloseCOM与OpenCOM成对使用 设置POS时间接口函数 函数原形：extern C int FAR PASCAL EXPORT MWSetTime(unsigned int pPOS,const char *pTime); 参数： pPOS----POS机号（0-255） pTime---时间（年月日时分秒）例如：2000年5月1日14时20分00秒，则pTime=000501142000 函数返回：设置成功，返回0，否则，返回负数 读POS时间接口函数 函数原形：extern C int FAR PASCAL EXPORT MWGetTime(unsigned int pPOS,char pTime[]); 参数： pPOS----POS机号（0-255） pTime---POS返回时间（年月日时分秒）例如：2000年5月1日14时20分00秒，则pTime=000501142000 函数返回：成功，返回0，否则，返回负数 设置POS机号接口函数（建议用户不要使用该函数） 函数原形：extern C int FAR PASCAL EXPORT MWSetPOSNum(unsigned int pPOS, unsigned int pNewPOS); 参数： pPOS----POS机号（0-255 pNewPOS----新POS机号（0-255） 函数返回：成功，返回0，否则，返回负数 设置POS名单类型接口函数 函数原形：extern C int FAR PASCAL EXPORT MWSetListType(unsigned int pPOS,BOOL pType); 参数： pPOS----POS机号（0-255） pType---名单类型（ pType=TRUE 白名单，pType=FALSE 黑名单） 函数返回：成功，返回0，否则，返回负数 POS加名单操作接口函数 函数原形：extern C int FAR PASCAL EXPORT MWAddList(unsigned int pPOS,int pIndex,const char * pList); 参数： pPOS----POS机号（0-255） pIndex--名单区号（0~3）（注意：对门禁机白名单管理时，名单区号与读头号有关） pList---名单卡号（6/10个字符（0..9）） 函数返回：成功，返回0，否则，返回负数---错误代码（-12表示加失败，-100表示名单区满） POS减名单操作接口函数 函数原形：extern C int FAR PASCAL EXPORT MWDelList(unsigned int pPOS,int pIndex,const char * pList); 参数： pPOS----POS机号（0-255） pIndex--名单区号（0~3）（注意：对门禁机白名单管理时，名单区号与读头号有关） pList---名单卡号（6/10个字符（0..9）） 函数返回：成功，返回0，否则，返回负数---错误代码（-12表示加失败，减失败可能是名单不在名单表中） POS删除名单操作接口函数 函数原形：extern C int FAR PASCAL EXPORT MWDelListFile(unsigned int pPOS,int pIndex); 参数： pPOS----POS机号（0-255） pIndex--名单区号（0~3）（注意：对门禁机白名单管理时，名单区号与读头号有关） 函数返回：成功，返回0，否则，返回负数