依时利IC卡考勤门禁机接口C#实现

依时利IC卡考勤门禁机接口C#实现

1.依时利这个坑爹的货,竟然不提供C#方面的Demo支持!哎俺自己写一个，存

一下怕以后忘记哈哈！！

2.首先创建一个winfrom项目名称为：edaxKQ （仅供参考,俺乱命名的不准笑

话小弟哈哈！）如图：

由于依时利提供的接口是delphi编写的，所以嘛不能直接引用，需要借助: [DllImport("EastRiver.dll")] 方式引入：将依时利提供的EastRiver.dll文件拷贝到项目的

bin\Debug目录下（当然也可以放别的目录只要你能让dllImport找到是吧哈哈）。

3.好了到这里前期准备做好了，现在我们开始编写连接卡机和端口连接的接口；

（其实接口可以通过依时利提供的API找到，但是实在有点坑爹）

4.连接接口实现

打开依时利API我们可以找到连接接口，在C#中进行重写，(名字能错哦，好吧我废话了，重写当然不能错)

///

///联机卡机：

///其他值成功返回端口句柄 /

/// -1 端口无效或真正使用 /

/// 0 无法联机

///

///COM端口号

///端口波特率

///卡机序号

///

[DllImport("EastRiver.dll")]

public static extern IntPtr ConnectClock(int port, int BaudRate, int clock_id);

重写了接口后，我们打开Form1窗体，在里面创建对应参数的输入和测试按钮，如图：

(对应参数这里就不解释了哦！做考勤机开发的应该都知道了吧哈哈！啊对了卡机序列号解释下，开启依时利卡机后，在屏幕上可以看到一个序列号便是卡机序列号了，一般都是1)，双击测试联机按钮，进入代码体，调用联机接口：

_port = Convert.ToInt32(this.txtCom.Text.ToString());

_BaudRate =Convert.ToInt32(this.txtBaudRate.Text.ToString());

_clock_id = Convert.ToInt16(this.txtClock.Text.ToString(),16);

_hPort = ICheck.ConnectClock(_port,_BaudRate,_clock_id);

if (_hPort.ToInt32() != 0)

{

MessageBox.Show("联机成功！");

}

else

{

MessageBox.Show("联机失败！");

}

看到这里有些童鞋可能不知道上面那些参数是干嘛的，别的不解释了都是定义的变量，这里介绍下_hPort变量，这个变量是在接口联通的时候，存储由接口返回的COM口句柄，在后面的使用需要联机操作的接口中，都需要使用到该变量中存储的Com口句柄；（说白了就等于是一个已经打开的SQL连接,这个貌似好理解点）到这里我们就联机成功了。

5.端口端口连接

当然有连接就会有端口么，当操作卡机完毕后就需要关闭端口和断开端口和卡机连接，实现API接口如下：

///

///断开联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///

[DllImport("EastRiver.dll")]

public static extern Boolean DisConnectClock(IntPtr hPort);

好吧我承认这个简单，记得上面我们说过_hPort这个变量是存储什么的吧。

对就是一个连接，这里要断开这个连接，就把他传进去就行了。调用代码如

下：

private void关闭端口_Click(object sender, EventArgs e)

{

if (ICheck.DisConnectClock(_hPort))

{

MessageBox.Show("端口已关闭！");

}

}

现在实现了联通和关闭卡机，我们试着去读取一下卡机信息

6.读取卡机时间

我们先在窗体上画一个存放时间的文本框先：

然后找到API中读取时间的函数，(貌似没提供,我是打开他们delphi的接口包才找到的)实现如下：

///

///获取卡机时间--需要联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///时间变量存放返回时间

///

[DllImport("EastRiver.dll")]

public static extern Boolean ReadClockTime(IntPtr hPort, ref DateTime curTime);

由于需要返回值，所以我们这里的curTime参数使用的ref关键字(不懂意思的问百度哦)，返回值是DateTime类型，（在原接口里面不是这样，重写了改变了一下，不影响功能，后面很多也是需要修改的，应该不同语言的数据类型不同吗呵呵）

双击读卡机时间按钮，实现代码如下：

///

///卡机时间

///

DateTime _dTime;

private void读卡机时间_Click(object sender, EventArgs e)

{

if (ICheck.ReadClockTime(_hPort, ref _dTime))

{

this.txtTime.Text = _dTime.ToString();

}

else

{

MessageBox.Show("读取时间失败！");

}

}

先定义一个存储时间的变量，然后调用读取卡机时间的函数，传入之前说过的_hport句柄是吧（打开后不要关闭哦因为这些接口都是需要在联机状态下进行的），传入接收参数ref _dTime ，来完成接收返回值。完成后显示到窗体搞定。你成功了么？

7.写卡和读卡

好吧现在我们干点实际的；写卡，IC卡当然是要存储个人信息的是吧，既然要存储就要写入,我们先找到API中的写入卡机的接口，重写后如下：

///

///写入卡机--需要联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///写入卡号

///写入名称

///写入金额

///写入充值次数

///IC卡格式：固定为830

///

[DllImport("EastRiver.dll")]

public static extern Boolean WriteICCard(IntPtr hPort, string CardNo, string CardName, int Money, int Times, int Ver);

参数不解释了，说下ver这个参数，我使用的是981c这款IC卡机，他的IC 卡格式是830，别的格式根据API上提供的值进行修改(上面有写注意看哦)。

创建窗体如下图：

双击发卡按钮，实现发卡：

#region发卡

private void发卡_Click(object sender, EventArgs e)

{

_CardNo = this.txtCardNo.Text.ToString();

_CardName = this.txtCardName.Text.ToString();

_money = Convert.ToInt32(this.txtMoney.Text.ToString());

_times = 0;

if (ICheck.WriteICCard(_hPort, _CardNo, _CardName, _money, _times, Convert.ToInt32(this.txtVer.Text)))

{

MessageBox.Show("写卡成功！");

}

else

{

MessageBox.Show("写卡失败！");

}

}

#endregion

发卡成功后，可以试着在卡机上刷一下，会发现能看到刚刚写进去的卡的名字了吧，但是显示的是非法门禁，咱先不管他，晚点再给他开门，先读卡试试；找到读卡API接口，实现如下：

///

///读卡机--需要联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///卡号变量存储返回卡号

///名称变量存储返回名称

///金额变量存储返回金额

///充值次数变量返回充值次数

///IC卡格式：默认为830

///

[DllImport("EastRiver.dll")]

public static extern Boolean ReadICCard(IntPtr hPort, StringBuilder CardNo, StringBuilder CardName, ref int Money, ref int Times, ref int Ver);

实现读卡接口的时候我们要注意，这里有几个StringBuilder的参数，为什么用这个呢，原因是这个接口在Delphi中实现是使用的Pchar类型参数，这个类型的参数只能和StringBuilder类型的参数匹配，不然奶奶的就报错。点击读卡按钮进行读卡：

private void读卡_Click(object sender, EventArgs e)

{

StringBuilder _Card = new StringBuilder(1024);

StringBuilder _Name = new StringBuilder(1024);

int _Var = Convert.ToInt32(this.txtVer.Text);

if (ICheck.ReadICCard(_hPort, _Card, _Name, ref_money, ref_times, ref_Var)) {

this.txtCardNo.Text = _Card.ToString();

this.txtCardName.Text = _Name.ToString();

}

else

{

MessageBox.Show("读卡信息失败！");

}

}

这里我只定义了两个变量显示到窗体，卡号和名称，其实金额啊充值次数啊也是可以显示的，因为我们也传递了ref修身的变量了是吧。需要就自己整个文本框显示一下；

8.白名单黑名单

完成了读写卡，现在需要设置一下白名单和黑名单，这个连个接口比较简单，我就不做解释了直接贴代码：

///

///设置白名单--需要联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///卡号

///工号-IC卡不使用设置为Null

///姓名

///

[DllImport("EastRiver.dll")]

public static extern Boolean SetAllowedCard(IntPtr hPort, string card, string empId, string EmpName);

实现加入白名单：

private void加入白名单_Click(object sender, EventArgs e)

{

_CardNo = this.txtCardNo.Text;

if (ICheck.SetAllowedCard(_hPort, _CardNo, null, ""))

{

MessageBox.Show("加入白名单成功！");

}

else

{

MessageBox.Show("加入白名单失败！");

}

}

实现加入黑名单接口

///

///设置黑名单--需要联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///卡号

///

[DllImport("EastRiver.dll")]

public static extern Boolean SetBlackCard(IntPtr hPort, string card);

实现加入黑名单

private void加入黑名单_Click(object sender, EventArgs e)

{

_CardNo = this.txtCardNo.Text;

if (ICheck.SetBlackCard(_hPort, _CardNo))

{

MessageBox.Show("加入黑名单成功！");

}

else

{

MessageBox.Show("加入黑名单失败！");

}

}

9.门禁

之前我们说了写卡了可以刷卡了，但是不能开门是吧，现在我们就写一下加入门禁的接口；(这个门禁的比较烦，这里只做一个通行门禁，就是啥时候来刷一下都开门的)，找到API实现门禁接口如下：

///

///设置门禁--需要联机：

/// False失败/True成功

///

///端口句柄-通过[ConnectClock]获取

///卡号格式：IC默认为830

///卡号

///四字节密码：可默认为"0000"

///开门权限电锁控制：可默认为1

///通行开始时间：可默认为"0000"

///通行结束时间:可默认为"0000"

///工号：可默认为"9999"

///

[DllImport("EastRiver.dll")]

public static extern Boolean SetDoorPassCardDE(IntPtr hPort, int style, string Card, string Code, int Right, string BeginPass, string EndPass, string EmpId);

看到一堆参数恼火吧，其实都是给默认值就可以了，依时利的那份API里面写的参数注释让我百思不得其解，所以毅然抛弃了哈哈。实现如下：

private void门禁_Click(object sender, EventArgs e)

{

_CardNo = this.txtCardNo.Text;

if (ICheck.SetDoorPassCardDE(_hPort, Convert.ToInt32(this.txtVer.Text),

_CardNo, "0000", 1, "0000", "0000", "9999"))

{

MessageBox.Show("打开门禁成功！");

}

else

{

MessageBox.Show("打开门禁失败！");

}

}

是吧其实也蛮简单的。只需要传递一个_hPort 打开的端口句柄，和一个读取出来的卡号，和一个IC卡的类型，记得吧830。别的都给默认值就行了。

完成后，你再刷卡试试，是不是显示欢迎来搞了啊！(好吧我邪恶了一下)

10.数据采集

考勤机吗当然需要采集数据啦，这里掩饰一下一次性读取本机所有记录的方式。找到API实现接口如下：

///

///一次性读取所有记录到指定文件--需要联机： /

/// 0 :机具内记录以空

/// >0 :成功读取记录数

/// -1,-2 :串行通信错误

/// -3 :命令字异常或效验错误

/// -4 :用户终止或未完成接收

/// -5 :机具不支持该命令

/// -8,-9 :资源分配错误

///

///端口句柄-通过[ConnectClock]获取

///卡机号

///指定文件名和路径，如未指定路径将创建在当前目录

///进程对话框的父窗体句柄：默认为0

///是否显示接收进程对话框

///进程回调，不用可设置为NULL

///

[DllImport("EastRiver.dll")]

public static extern int ReadAllRecordAsFile(IntPtr hPort, int click_id, string FileName, int hWndParent, bool bShowProg, int Progress);

实现接口后，完成数据采集功能：

private void数据采集_Click(object sender, EventArgs e)

{

string filePath = "D:\\123456.txt";

int ss = ReadAllRecordAsFile(_hPort, _clock_id,filePath,0,true,0);

if (ss > 0)

{

MessageBox.Show("成功采集！");

}

else

{

MessageBox.Show(ss.ToString());

}

}

你采集成功了么呵呵！就写这么多吧，上面的接口搞定了，别的接口基本上没啥问题了都差不多！主要是开始不熟悉所以老出错！各位大侠看了不要笑话小弟啊，小弟目的主要还是为了怕自己忘记，写一下记录记录呵呵！也顺便方便下初次搞这个考勤机的童鞋。