尚吉考勤机文档格式.docx

尚吉考勤机文档格式.docx

《尚吉考勤机文档格式.docx》由会员分享，可在线阅读，更多相关《尚吉考勤机文档格式.docx（8页珍藏版）》请在冰点文库上搜索。

20XX年year=04

month为月份

day为日期

hour为小时

minute为分钟

second为秒

返回值:

1成功0失败

2.functionintegersio_sfwRiTEHmd（integerport,integernum,dwoRdKH,integerll_lb）

该函数为增加,删除401d售饭机脱机使用时红名单.参数说明:

KH为卡号

ll_lb为操作类别为1时增加此张卡为红名单,为2时在红名单中删除此张卡,

为3时删除全部红名单.

3.

functionintegersio_sfREaddaTa（integerport,integernum,char*buff,integerli_lb）

该函数为读取401d售饭机卡号,消费记录,撤销消费记录.此函数要不停的调用.

参数说明:

buff为返回的数据注:

此参数为地址传递

li_lb为读取401d售饭机类别1为消费机2为充值机

1表示有卡buff中数据为卡号格式:

0000010001十位

2表示401d售饭机有应答（通讯正常）但无卡无数据

3表示401d售饭机有消费记录buff数据格式为30位:

000001000120XX0831151610995566表示10001号卡20XX年8月31日15点16

分10秒消费9955.66元钱.

4.表示401d售饭机有撤销消费记录buff数据格式为30位同消费记录

0表示通讯不成功.

4.

functionintegersio_sfwRiTEdaTa（dwoRdkh,woRdm1,woRdm2,woRd

m3,dwoRdpsw,woRdx2,woRdx3,integerll_zt）

该函数为写入401d售饭机卡号,余额,密码,限额,状态（是否为非法卡）此函数要配合sio_sfREaddaTa函数使用.

kh为要下发的卡号

m1m2m3为余额,余额为6位数字m1表示（千位和百位）m2表示50px”width=“450px”alt=“尚吉考勤机”title=“尚吉考勤机”/>

（十位和个位）m3表

示（角和分）.

Psw为密码如果消费金额大于限制金额则需输入此密码.（密码为固定6位数字）

x2x3消费限额如果消费金额大于此金额则需输入密码（最大限额为99.99）x2表示

限额的十位和个位x3表示角和分当x2,x3都为0时则无限额.

ll_zt表示是否为非法卡,为1则正常下发余额.为0则下发报警信号.

1成功0失败一般不用判断此函数返回值

因售饭系统为实时的,对开发做一下说明:

开发说明:

开户:

首先不断调用sio_sfREaddaTa（）函数并判断持返回值,如果返回值为1则拿出此

函数buff中的卡号,然后调用sio_sfwRiTEdaTa（）下发报警提示用户已经读卡完成.如果返回2则表示此机器在线但没读卡

联机消费:

.首先不断调用sio_sfREaddaTa（）函数轮询每个机器并判断返回值

如果返回值为1则拿出此函数buff中的卡号,然后在数据库中寻找此卡是否存在如是则判断是否超额如是则调用sio_sfwRiTEdaTa（）函数下发卡片信息.如果限额已经超过则可以下发00.01的限额提示消费时输入密码.

如果返回值为2则表示此机器在线.此返回值在机器消费过程中可能为0,所以要有一个次数来判断此机器是否在线.如:

连续轮询一个机器40遍都返回0,则表示此机器通讯中断.

如果返回值为3则表示此机器上传了一条消费记录,拿出buff中的消费数据写入数据库.

如果返回值为4则表示此机器上传了一条撤销消费记录,拿出buff中的消费数据写入数据库.

当返回值为3或4时注意以下情况.

在轮询过程中可能会有一条消费记录多次上传的情况,所以在轮询过程中要保存每台机器最后一条数据,然后当有消费记录上传时和此机器最后消费记录比较如一样则丢弃.

pb函数声明

FUncTionulongsio_sfREaddaTa（intport,intnum,refstringbuff,intli_lb）LiBRaRY”Seriio.dll”

FUncTionulongsio_sfwRiTEdaTa（ulongkh,ulongm1,ulongm2,ulongm3,ulongpass,ulongx1,ulongx2,intll_zt）LiBRaRY”Seriio.dll”

FUncTionulongsio_sfSETcLocK（intport,intnum,intyear,intmonth,intday,inthour,intminute,intsecond）LiBRaRY”Seriio.dll”

FUncTionulongsio_sfwRiTEHmd（intport,intnum,ulongkh,intll_lb）LiBRaRY”Seriio.dll”

FUncTionulongsio_GetVersion（）LiBRaRY”Seriio.dll”

3400考勤机硬件接口方法

本公司提供与3400考勤机接口的动态链接库，文件名为：

所有函数的入口参数中，num表示选择哪台考勤机的机号（机号可在产品配套说明和机器上找到）。

functionintegersio_kqSETTimE（integerport,integernum,integeryear,integermonth,integerday,integerhour,integerminute,integersecond）;

该函数为设置考勤机时钟.参数说明:

year为年份

如:

sio_kqSETTimE（1,4369,20XX,8,31,13,15,24）;

表示:

用com1口设置4369号考勤机时间为:

20XX年8月31日13时15分24秒注:

如果考勤机已经有数据时间只能往后设不能往前设（即使成功时间也不会变更）.如:

考勤机时间为20XX-02-0115:

23:

30并且有数据则时间只能设:

20XX-02-0116:

00:

00…….返回值:

2.

functionintegersio_kqdELETEdaTE（integerport,integernum）

该函数为清除考勤机数据.

3.functionintegersio_kqdownLoad（integerport,integernum,integeryear1,integermonth1,integerday1,integeryear2,integermonth2,integerday2）该函数为读取考勤机数据.

year1为读取数据起始日期的年份

month1为读取数据起始日期的月份

day1为读取数据起始日期的日

year2为读取数据结束日期的年份

month2为读取数据结束日期的月份

day2为读取数据结束日期的日

注:

最大读数据间隔不能超过三个月.

0失败成功:

返回读取的条数.

说明:

当读取数据成功后会在当前目录形成KQ.TXT文件，注意，每次下载后，都覆盖以

前旧文件，所以下载后，必须及时将文本文件转换成数据库。

数据格式如下:

000000001020XX09020XX301

000000001020XX0903001301

十位的卡号（或编号,0000000010）8位日期（20XX0902）4位的时间（0013）2位的班次（01）

functionintegersio_kqREadKHBH（intport,intnum）;

该函数为读取考勤机卡号编号对照表.

返回读取的条数

当读取卡好编号成功后会在当前目录形成KHBH.TXT文件，注意，每次下载后，都覆盖以前旧文件，所以下载后必须及时将文本文件转换成数据库。

39999960000000000100

39999960000000000101

十位的卡号（39999960000）十位的编号（0000000100）

5.

functionintegersio_kqwRiTEKHBH（integerport,integernum）;

该函数为写入考勤机卡号编号对照表.

返回写入的条数

调用此函数时此函数会自己查找但前目录下的KHBH.TXT文件并写入到考勤机.如果文件不存在或格式不对则会不成功.格式如下:

文件中不能存在任何的字符,空格或其他隐含符号.

每次写入之前考勤机内的卡号编号对照表会自动清除.所以在写入前请注意文件的完整性.

版本查看函数:

functionsio_GetVersion（）

PB函数声明:

FUncTionulongsio_kqSETTimE（intport,intnum,intyear,intmonth,intday,inthour,intminute,intsecond）LiBRaRY”Seriio.dll”

FUncTionulongsio_kqdELETEdaTE（intport,intnum）LiBRaRY”Seriio.dll”

FUncTionulongsio_kqdownLoad（intport,intnum,ulongyear1,intmonth1,intday1,intyear2,intmonth2,intday2）LiBRaRY”Seriio.dll”

FUncTionulongsio_kqREadKHBH（intport,intnum）LiBRaRY”Seriio.dll”

FUncTionulongsio_kqwRiTEKHBH（intport,intnum）LiBRaRY”Seriio.dll”

篇二：

尚吉通用接口程序使用说明

通用接口程序使用说明

本程序用于：

2.主要分以下功能：

a.设置考勤机时间.b.读取考勤机数据.c.清除考勤机数据.d.读取卡号编号表e.写入卡号编号表f.SJ3400dT（v3.0以上版本）实时通讯功能。

（另介绍）

一、以下是考勤机型号和通用操作说明

＊注明以上表格中SJ3000dT的产品在使用监控为V2.8dT、V2.82dT监控版不能使用实时通讯功能。

1、启动考勤接口程序

2、设置考勤机档案。

＊注明：

在考勤机档案中只设置：

出厂机号、自编代号、放置地点、串口，设置成功后保

存退出。

（１）SJ3000dT设置考勤机档案如下：

*注明：

出厂机号、自编代号、放置地点、ＩＰ地址、子网掩码、端口）

参数查询/设置方法及步骤接通考勤机电源。

按“F1”键，输入密码（缺省密码为“0000”）

依次按“1”、“9”，考勤机显示“TcP/iPSETUPLoadinG?

?

.”，等待考勤机显示“Serialno:

xxxxxxxx”时即可查看或修改参数。

按“↑”、“↓”键选择需要查看或修改的参数选项，然后按“EnT”键进入修改状态，闪烁的数字表示当前光标位置。

通过“←”、“→”键移动光标，通过“0”~“9”数字键修改参数。

修改完成后，按“EnT”键退出修改状态，数字停止闪烁。

此时可以按“F2”保存设置，或者继续修改其他选项。