uEasyFileGUI海信盘点机软件

uEasyFileGUI是由新大陆自动识别官方推出的一款查看海信盘点机盘点数据的海信盘点机软件。它是一款图形界面的远程文件管理程序、及所需的 DLL，界面类似之前的 uService 设备管理器，可提供可编译的源码。用户能够在 PC 和新大陆采集器之间实现远程文件操作，包括读写，删除，复制文件等等最常用的文件操作。

而uEasyFile是在 uEasyCom 通讯协议基础上的文件传输协议，该协议用于替代之前的 NlsRPC 通信协议（两者不兼容），uEasyFile 协议采用大家熟知的客户和服务器结构，服务器端开启后，等待客户端发送的请求；客户端通过将请求发送到服务器端，实现远程文件操作。目前uEasyFile的客户端运行在 PC 端，服务端运行在使用 uBase 操作系统的设备上（目前仅限 PT85X 系列数据采集器）。

适用设备

uEasyFileGUI可适用于福建新大陆自动识别有限公司的 PT-800 系列数据采集器，包括： PT-850, PT-852, PT-810, PT-862, PT-853

PC 端要求 Windows 2000/XP/2003/Vista/7 。

远程设备为 PT85X 系列数据采集器、 PT80、或任何支持 uEasyFile 协议的通信设备。

常见问题

1、 一般问题

(BUG) 用 RequestReadFileExt 读取到文件尾部时注意：若要读取的字节数超过文件的实际大小，则会得到大于文件大小的虚假数据。换言之，你必须事先得知远程文件的大小，并且让 RequestReadFileExt 不要“越界”读取。

PT85X, 通过 USB 传输文件，数据正在传输时拔除 USB 电缆，很可能造成 PT85X 死机。（之前已存在）

拷贝文件过程，点击取消按钮，很可能导致 uEasyFileGUI 崩溃。（之前已存在）

2、PT80 特有问题

【使用 USB 虚拟串口，要事先设置 USB 工作模式】

若要使用 USB 虚拟串口运行 uEasyFile，请在启动 uEasyFile Server 前事先将 USB 工作模式调为 “虚拟串口” (串口模式)。否则，Start_uEasyFileServer_COM 将直接失败，或，即使报告成功客户端也无法连上。

本问题在 PT80 固件 2.1.3 中存在。

【虚拟串口使用中 断开 USB 线缆导致后续通信阻塞】

当 USB 虚拟串口通信的任何一方打开了本机的虚拟串口的情况下，断开 USB 线缆，将有可能导致 USB 线缆再次插入时无法恢复通信。

使用 uEasyFileGUI 的具体表现是：点击刷新按钮或重启 uEasyFileGUI 都无法再次和 PT80 建立连接。

为了避免此状况发生，拔除 USB 线缆前，应该如下操作（让双方关闭各自的虚拟串口）：

服务端，以 850Shell 为例，应退出 RPC 服务界面。

客户端，若用 uEasyFileGUI ，应退出 uEasyFileGUI；用 Demo2 ，应执行 DISCONNECT 操作。

万一提前拔除线缆导致虚拟串口通信无法恢复，补救方法是：拔除线缆，让双方关闭各自虚拟串口，等待 20 秒再插入 USB 线缆，双方启动 uEasyFile。此时通信应可恢复。

此案例可重现场景为 PT80 固件 2.1.3；Windows 7 或 XP，USB 驱动 Gadget Serial 版本为 5.1.2600.0 。

注意事项

对于非 uBase 服务端（比如 Linux 服务端），拷贝文件时不再有文件名长度最大 16 字节的限制，最长文件名可达 255 字节。客户端判断服务端是否为 uBase 的方法：客户端检查 RequestGetSystemInfo() 返回的 uEasyFileSystemInfo_st.szDeviceVerString 字符串，若其中含有 "uBase" 字串，则认为服务端为 uBase。

当服务端为 uBase 时，uEasyFileGUI 的窗口标题将指示 uBase 字样。