# 魔线操作文档 应用场景：不使用收银插件的情况下，可截取商家收银系统中的流水，通过魔线传输至蜻蜓iot小程序，完成收银，达到赚取商家分润以及设备奖励金的目的 优点： 1. 兼容市面上大部分的热门收银软件：银豹、部分思迅等； 2. .支持收银成功后的支付回传：即收银系统自动完成收银动作 3. 魔线价格为150元，是一根蓝色的可连接收银机与刷脸设备的接口线，有需要可向运营售后人员提前报备 4. 刷脸设备需提前推送IOT小程序，登录商家员工账号（商户进件及资料的提交详见商户进件操作） （不兼容的收银系统：不支持客显的收银软件；不能安装驱动的接口） 备注： 判断收银系统是否支持客显： 1、设备上是否有客显屏幕   2、收银系统设置中查看是否有客显设置、客显端口（COM1）、客显钱箱、数字客显等标识 * * * ### 准备工具 * 魔线 + 魔线驱动 * 支付宝小程序开发工具 * 蜻蜓f4 * 带有客显设置、客显端口、客显钱箱、数字客显的**收银软件** * * * ## 操作流程 ### 一、翼飞魔线设备安装流程 #### 1、魔线各端子作用如下图  PC设备有物理串口（见图）情况如下将232串口端子插入PC端物理串口 （设备上只有一个物理串口端口默认为 COM1，多个物理端口请况下有标识端口号） USB1端插入5V电源适配器PC端任意USB口供电 #### 2、PC端设备连接 PC端的接口目前主要有两种，一种是物理串口，一种是USB接口，我们依据具体情况来进行连接，二选一即可 商家收银机是物理串口的就连接物理串口，商家收银机有USB接口的，就连接USB接口  #### 3、蜻蜓端连连接 将魔线蜻蜓端USB插入蜻蜓端USB口（见下图）  ### 二、魔线驱动安装及调试 #### 1、驱动安装 若商家收银机是window 10系统，则系统自带驱动，自动安装，无需操作，可直接进入调试步骤 若商家收银机是window xp / windows 7系统 安装流程： 安装方法一： (1)解压 “魔线虚拟串口驱动.zip” (2) x86系统：拷贝文件x86\\usbser.sys 到 c:\\windows\\system32\\driver   X64系统：拷贝文件x64\\usbser.sys 到 c:\\windows\\syswow64\\driver  插上USB1自动安装 安装方法二： （1）将魔线连接好刷脸设备和收银机，解压 “魔线虚拟串口驱动.zip” （2）右击计算机，打开设备管理器，找到设备S31点击右键更新驱动程序软件  （3）选择浏览计算机以查找驱动程序软件  （4）选择浏览（R）， 选择驱动文件路径，然后点击下一步  （5）弹出窗口选择始终安装此驱动程序软件  （6）等待系统安装程序  （7）提示WINDOWS 已经成功地更新驱动程序文件  安装完成以后，再次打开设备管理器，查看端口数据是COM几，记下来等待调试使用 #### 2、调试 （1） 打开设备管理器插看魔线端口 （2） 打开收银软件将客显端口设置为魔线端口一致（魔线波特率默认2400） （3） 在开发工具将小程序推送至蜻蜓f4 （4） 在蜻蜓f4上打开小程序登录，进入设置 --> 魔线 （5） 选择您所用的收银软件  （6）将所获取的软件的参数，通过点击`发送`按钮 ，将参数发送给魔线，发送成功，魔线则返回succes  （7）点击`接收指令`接收来自魔线发送的金额，接收到金额，点击`保存`即可  以银豹 零售 安卓收银为列： （1）查看是否有 客显设置、客显端口、客显钱箱、数字客显， （2）查看是否有 客显设置、客显端口、客显钱箱、数字客显;  （3）设置完成，和pc版调式一样，在蜻蜓f4上查看是否接收到金额 （4）设置 安卓版 支付回调 （每款收银软件不同，支付按键以您软件为准）  以上两个步骤设置完成以后，开始刷脸设备调试是否能正常收款 此时在商家收银系统发起收款，检查刷脸设备是否会自动识别出收银系统显示的金额，若可自动识别，则继续发起收款，刷脸或者扫码支付，支付成功即可。 ### 其他收银软件 （1）如果您的收银软件在**软件列表**中没有，而且存在带有客显设置、客显端口、客显钱箱、数字客显 （2）您可以和上述一样调试设置，查看是否可以使用 （3）如果可以使用，您可以设置支付成功的按键序列  ### 问题 1. 回调可以执行，获取不到金额（有的银豹版本获取不到金额） * 查看串口是否安装收银插件，串口占用，波特率是否一致 2. 插拔usb，获取不到金额 * 在进行usb插拔的过程中（银豹为例），银豹是否显示客显会自动关闭，需要在此开启客显