门锁对接操作文档

门锁对接文档
或许对于很多新合作伙伴来说，门锁对接是一个很大的难题，自己不会，找公司对接要花钱，但是现在的酒店基本上又都会要求做门锁对接，所以很多合作伙伴想学习但是又云里雾里不知道该怎么去操作，其实这一块没大家想象中的那么难，首先做门锁对接大家要理解清楚这个对接的概念，既然是对接，那么肯定至少是要有两个东西才能叫对接是不是？所以很多时候有的合作伙伴找我对接的时候，我一远程有点哭笑不得，电脑上面要么什么都没有，要么就只装了一个门锁软件或者我们金天鹅软件，或者就只有一个接口函数就要我们来对接，我们如何做对接呢？所以，做门锁对接的话需要满足以下几个前提条件1：门锁软件酒店所有房间能正常发卡开门，2，提供了接口函数，3安装好了金天鹅软件，4门锁软件与金天鹅软件必须安装在一台电脑上面，如果酒店有多台电脑需要对接的话那么每台电脑上都需要安装门锁软件和配置刷卡器，满足了以上前提条件以后，我们就可以测试对接了，其实门锁对接的话总共就归为三大步，1 在门锁软件里面发一张房卡，去测试是否能开门 2 在门锁厂家提供的接口函数里面测试是否能读取在门锁软件制的那及重新张卡的信息以输入写卡信息再制卡是否能开门3找到我们开发好的，放到我们软件目录里面，配置好文件，再去我们软件里面测试是否能制卡，制的卡是否能开门，如果能开门就表示没有问题了！接下来，我们再详细讲解下这三
个大的步骤要怎么操作
第一步：门锁软件制卡测试
这一步的话非常简单，就是去门锁软件里面制卡测试是否能开门，这一步也非常重要，因为如果你不能保证门锁软件制的卡能开门的话，那么当我们对接完成后如果在我们金天鹅软件制卡不能开门，你就没办法判断到底是我们的问题还是门锁软件本身的问题。

所以这一步尽量不要直接跳过去，每个门锁软件的界面都是不一样的，但是制卡的这个操作应该都非常简单，人家前台都会，如果自己不知道怎么在门锁软件制卡，可以请教下酒店前台，制卡后去测试，如果可以则表示第一步没有问题
第二步：原始接口函数测试
在进行这一步之前，我希望大家养成一个好习惯，先去看看原始函数里面的对接文档，会对大家有帮助，不要说看不懂，只要认真看了，我觉得没有什么看不懂的，不懂那个英语字符你可以百度查！说明文档一般都是文档
接口测试这一步对很多人来说是最复杂的，因为这是一个中间环节，因为你必须保证门锁那边提供的接口函数是可用没问题的，才能进行下一步我们软件的测试，很多人会说不知道怎么测试这个接口函数，不知道怎么设置参数，如果是第一次做门锁对接的我可以理解，因为以前没接触过嘛。

首先，要测试接口函数，你要知道接口函数是一个什么东西，它通俗点说就相当于是一座桥，把门锁软件和我们的软件连接在了一起，所以，大家可以不用懂原始函数的原理，但是大家要知道，对接必须要有接口函数，因为每个门锁软件的界面，版本都是不一样的，从而也就会导致原始接口函数是不一样的！不同的原始函数我们会开发好对应的，这个是不能用错的！在有了接口函数以后，我们开始测试门锁厂家提供的接口函数，首先在接口函数里面找到接口函数应用程序，一般
只有两种图标：，，分别表示两种开发语言，这个我们可以不需要知道很详细，了解就可以，我们做过的接口函数我一般都会把它集中保存到一个地方，以便不时之需，所以人家发给你的接口函数一般都是下面这样的
我这里举几个我们比较常做的门锁举个例子，第一个是温卡，也就是我们通常说的0918，这个门锁市面上非常常见，可能接口函数你不一定能分别出来，但是当你打开应用测试界面的时候，你就要知道这是我们所说的0918
如果说这个应用程序你说找都找不到的话，我也就没话说了，任何接口函数都会有对应的应用测试程序，如果没有这个程序的，那就只能是门锁厂家提供的接口函数有问题，打开这个接口函数应用程序以后，把前面我们在门锁软件里面制的那张房卡放在刷卡器上边，点击第一步，打开端口，程序会提示打开端口成功，如果提示失败，那就只能是接口函数版本不对或者刷卡器有问题或者没插好，打开端口成功后，点击读取酒店标识
这个酒店标识非常重要，是这个门锁接口我们必须知道的东西，如果没有它那么就无法完成对接，如果能读出来酒店标识，也就表示这个接口基本上没问题了。

我们把酒店标识保存下，然后再读取下客人卡锁号，
这个锁号后边有解释，01 02 03 99，01表示楼栋，02表示楼层，03表示房间号，99相当于带的一个参数不用管，锁号在门锁软件里面也可以查询到的，我们读取完锁号以后可以和门锁软件里面的对比一下，如果是一样的，就表示没有问题了，然后我们再把这个程序里面的锁号改成某一间房的锁号，修改下退房时间，再点击制宾客卡，如果提示成功，拿卡去开下门，看看是否能开，如果能开，就表示门锁那边提供的接口函数是没有任何问题的
第三步：配置测试我们软件
在接口函数测试完成后，就需要测试我们金天鹅软件了，这一块的话其实有很多需要注意的地方，怎么判断这个接口函数对应的，这是最重要的，同一个门锁都会有很多个不同的版本，你用错了大小都会造成在我们软件制卡开不了门，所以大家在这一块花的时间也是最长的，很多时候我们自己也需要花时间找对应的，我们一般是通过门锁软件界面，接口函数测试界面，接口函数大小来判断对应的，介于大家对着一块不是很理解，这一块我不多说，在大家测试完接口函数以后，如果不会找，把接口函数发给我们，我们来帮您找，找到对应的再给你们发过去，因为发公司是免费的，所以我下面说的是在收到我们发的以后大家需要怎么做
我们会给大家发送一个名称的文件，在收到以后，我们需要把里面的文件放到我们软件的根目录目录里面
把里面的文件放到我们目录里面以后，我们需要配置下我们的文件，
这个酒店标识前面我跟大家说过，让大家记住保存下，那么现在可以把前面我们在接口函数里面读取到的酒店标识填写到这里面，第一栏口=1这个不需要改，因为现在这款门锁都是的，然后在前面说过，我们在接口函数里面读取过锁号，那么在下边我们需要把酒店每一间房都需要按照顺序一间一间的往下配置
每一间房都在这个里面配置好，然后保存文件就了，然后就可以去我们软件里面设置最后一步，就可以制卡开门测试了
在里面第一个选择门锁接口配置，勾选入住立即发卡，接口
类型选通用2，选通用1，如果你实在不知道怎么选，那其实有个很简单的办法，通用1，通用2你都可以试试，总共就两个，你测试两次不就能测试完了？在选择完以后，关闭我们前台软件，重新登录就可以开房测试了
完成了这三步，就表示这个酒店的门锁对接完成了，我这里只是举了其中一个例子，市面上还有很多很多其他的门锁软件，每个门锁软件的界面和接口函数测试界面都是不一样的，但是总的流程就是这三步，当你知道这三个流程以后，不管是什么门锁，你都可以按照这三个流程去测试，一步一步的来，在制卡开不了门的时候，你一定要分清楚是哪一步的问题，是一开始门锁软件制卡就开不了门？还是厂家提供的接口函数制卡不能开门？还是前面都可以，但是最后到我们金天鹅软件就开不了了？所有的门锁我们也没办法保证都能对接的，我们也只能一个个去测试，去摸索，去排除，不要在一有问题的时候就蒙了，不知道该如何下手，再发生问题的时候，仔细思考下，什么情况下会和这个问题有关系？比如当你制卡会提示串口打开失败，那么我们可以想想，什么和串口有关系呢？门锁软件是和串口有关系的，刷卡器是和串口有关系的，我们软件的配置是和串口有关系的，所以我们就可以试着把门锁软件关闭了，然后再看看电脑设备管理器里面的端口号和我们软件里面配置的是否一样，也就是有问题的时候自己多想想。