视觉常见问题分析v1 0_W

1、 无锡信捷电气股份有限公司视觉常见问题分析 1 软件安装异常21.1 无法安装软件21.2 安装后无法打开软件22 固件更新错误22.1 无法打开固件更新工具22.2 无法连接固件更新工具33 相机状态异常33.1 搜索不到任何相机信息33.2 设置相机机型信息失败33.3 相机通讯异常，读取相机机型信息失败43.4 相机自动切换到停止模式43.4.1 固件更新/清除配置后自动停止43.4.2 运行一段时间后停止54 相机错误类型54.1 UART-CRC 校验错误54.2 VM 堆分配错误54.3 TCP 通信缓冲错误64.4 PROCESS 相机配置 CRC 错误65 I/O 端无信号输出

2、65.1 软件的 I/O 状态监控无输出65.2 相机至 PLC 输入端未接收到信号76 工程无法下载76.1 CRC 校验错误/序列化错误76.2 工具不一致错误86.3 预处理个数错误86.4 脚本编译错误87 上下位机数据不一致97.1 脚本的输出结果不一致97.1.1 执行次数不一致97.1.2 脚本全局变量在上位机被重新编辑97.2 通用工具的输出结果不一致98 常见的脚本编译/运行错误108.1 变量未定义108.2 数组越界108.3 排序错误108.4 脚本相互包含错误108.5 缺少符号错误118.6 类型错误118.7 区域修改错误128.8 工具使能错误128.9 重定义

3、错误12 X-Sight 常见问题12分析（第一版）1 软件安装异常 软件安装异常主要出现在用户在电脑上首次安装或使用 X-Sight 软件的过程中，主要表现为无法安装或安装软件后无法打开。 1.1 无法安装软件若安装 X-Sight 视觉软件的电脑之前未安装过类似的工业软件，则在安装 X-Sight 软件之前需要先安装 framework 2.0（或以上的版本）软件； 1.2 安装后无法打开软件若成功安装 X-Sight 软件后，无法运行该软件，则主要可能是如下几个原因: 未安装 VC 运行库，此时请联系本公司的技术人员，安装相应的 VC 运行库即可， 运行库名称如图 1 所示； 未关闭。阻

4、止本软件的运行，关闭系统的即可； 图 1(c)Windows XP 主题 系统主题被修改。Windows7 系统请选择默认的 Windows7 主题，如图 1(b)所示， Windows XP 系统下，请选择默认的 Windows XP 主题（非 Windows 经典主题），如图 1(c)所示。 图 1(a) VC 运行 图 1(b)Windows7 主题2 固件更新错误 图 1 软件无法运行的相关说明 2.1 无法打开固件更新工具2.2 无法连接固件更新工具弹出固件更新工具界面后，相机断电再上电，若固件更新工具一直显示“未连接智能相 机”，右上角显示红色 X，如图 2 所示，则说明无法连接固

5、件更新工具，可以从如下几个方面进行排查： 相机线路是否连接正常。检查相机电源、网线是否连接正常； 系统是否关闭； IP 地址是否设定为“192.168.8.253”； 检查系统的主题是否均为默认的主题（见错误 1.2 系统主题部分） 图 2 固件更新工具未连接状态 若以上检查无误，但仍无法连接固件更新工具，则可能是相机硬件已损坏，需要寄 到维修部进行检测维修。 3 相机状态异常 3.1 搜索不到任何相机信息如图 3(a)所示，多次点击搜索按钮后，仍未搜索到相应的相机，则可能出现的原因主要有如下几种： 线路不通。检查相机电源线和网线是否正确连接； IP 设置不正确。查看电脑 IP 是否设置在“1

6、92.168.8.2-192.168.0.255”内； 相机系统加载失败。需要将相机返回给本公司的技术人员，进行进一步检测； 3.2 设置相机机型信息失败如图 3(b)所示，若出现“设置相机机型信息失败”的错误，则说明此时相机的版本和上位机软件的版本不一致，上位机软件库中未添加当前相机的类型，需要更新相机的 固件版本（一般情况主要是上位机的版本高于相机的当前版本）。 图 3(a) 无法搜索到相机图 3(b) 设置相机机型失败图 3 连接相机异常示意图 3.3 相机通讯异常，读取相机机型信息失败如图 4 所示，搜索相机后出现“相机通讯异常，读取相机机型信息失败”错误，则主要有如下几个原因： 图

7、4 相机通讯异常 当前相机中的工具运行时间过长。此时需要清除配置，然后重新优化工具的相关参 数， 缩短运行时间，一般上位机运行总时间超过 500ms，则该工程不建议下载到相机中运行； 相机中的脚本工具或其他工具使用不合理，导致当前程序出现死循环等异常问题， 需要清除配置后，重新检查下载到相机中的程序； 由于电源干扰或其他空间干扰，导致相机内部程序加载失败，需要考虑相机的电源 以及其他可能出现强干扰的部分，尽量减少外部的干扰； 3.4 相机自动切换到停止模式相机在重新上电后，默认会切换到运行状态，当相机在运行过程中遇到相关的错误， 则会自动切换到停止模式，确保相机不再错误运行，此时可以点击“查看

8、”中的“错误信息”，根据弹出的错误信息，分析当前的运行错误，错误信息在点击一次之后，会自动清空。 3.4.1 固件更新/清除配置后自动停止 当相机进行固件更新或清除配置后，点击相机运行按钮，相机无法切换到运行模式， 此时查看错误提示，若提示“PROCESS-相机配置 CRC 错误”（如图 5），则是因为清除配置等操作后，未对相机写入相应信息。此时分别在相机配置界面点击“写入相机”， 并点击下载按钮，则可以切换到运行状态。 3.4.2 运行一段时间后停止 图 5 PROCESS-相机配置 CRC 错误 若相机运行一段时间后自动切换到停止模式，则主要有以下几个原因： 受到强干扰，相机数据被破坏，自

9、动切换到停止模式或断开连接。此时需要考 虑隔离相机的供电电源或者其他方式减少相机受到的干扰。 相机本次运行时间太长。由于相机当前视野中出现的图像导致相机中的工具运 行时间过长，此时需要重新优化相机中的运行工具后下载； 相机内存错误。由于本次运算过程中开辟了过大的内存或者出现了内存异常， 从而导致相机切换到停止模式，此时需要检查相机中的工程是否出现开辟过大的内存或者脚本对工具结果进行读写运算过程中，对非法地址进行操作（例如当前工具未找到目标，但脚本中对该工具的目标内容进行读写）； 4 相机错误类型 在相机出现异常，切换到停止模式时，可以点击“查看”-“错误信息”，一般常 见的错误信息主要包括：

10、4.1 UART-CRC 校验错误该错误主要是因为在外部设备（PLC、触摸屏等）在和相机通讯的过程中，出现干扰，导致相机出现校验错误。若查看该错误后，过段时间再查看，发现不再出现该错误， 则无需进行修改；若查看该错误后，短时间后查看中再次出现该错误，则说明干扰影响了正常通信， 需要加强抗干扰措施，防止在通讯中出现数据丢失等问题；另外当干扰破坏相机的数据，导致相机读取 flash 数据错误时，也可能产生 UART-CRC 错误。 4.2 VM 堆分配错误如图 6 所示，出现 VM 堆分配失败的错误，则主要包括如下几个原因： 图 6 VM 堆分配失败示意图 下载的工具中出现需要较大内存的工具。在工

11、具中图案定位工具、预处理工具、 条码读取工具等需要较大的内存，因此一般 120 万以上的相机不建议使用以上的工具，若一定要使用占用较大内存的工具，则应该尽量减小该工具的检测或学习区域。 工具中开辟了无效的内存大小，如脚本中动态开辟数组大小过程中，开辟的个 数为 0 等； 当前检测图像噪点过多，导致工具中开辟过多的内存节点。如斑点工具的检测 图像中有过多的噪点，导致工具的内存节点开辟过多，从而堆分配失败； 脚本或工具内部出现内存的非法使用。 4.3 TCP 通信缓冲错误该问题主要是因为网线或网线接口的问题，可以重新插拔网线后，再连接相机；另 外也有可能开启了另一个固件更新工具，占用了相关网络资源

12、。 4.4 PROCESS 相机配置 CRC 错误该错误见 3.4.1 固件更新/清除配置后自动停止 5 I/O 端无信号输出 当 PLC 或其他外部设备在读取相机端 信号时，未正常接收到相机的输出数据， 则需要先判断软件 I/O 状态，若软件无输出，则为相机的相关问题，如软件有输出，则需要检查相机到 PLC 输入部分。 5.1 软件的 I/O 状态监控无输出在 X-Sight 软件的菜单栏中，选择“窗口”-“IO 状态监控”，则会出现如图 7 所示的监控界面，输出端 Y4 为相机的完成信号，由于图像采集时间很短，因此 Y4 基本为常亮，Y0-Y3 为用户可用的端口。 将 IO 状态窗口开启后

13、，可以正常触发相机，每处理一次后，若对应的输出端口无变化，则说明软件 I/O 无输出，此时可能的原因如下： 程序中未添加写端 的函数：writeoutput(portID,val)，其中 portID 为端（0-3 分别对应 Y0-Y3），val 的值为（0 或 1），表示对 portID 清零或 置位，此时需要根据实际需求添加相应的写端口函数； 脚本中写端口信号的写法错误，如将某一输出端口写 0 后，又在本次将该端口写 1，此时该端口的输出始终未 1（由于两次写的间隔太短，后一次覆盖前一次的 0），此时需要重新修改端口输出部分程序； 工具运行时间太短。当工具运行的时间过短时（10ms 以内）

14、，IO 状态的输出速度也会相应加快，导致 PLC 等无法接收到相应的相机输出，此时可以在脚本中添加一个无效的循环遍历，增加处理时间，从而确保外部能及时接收到相 机的输出信号。 图 7 IO 状态监控界面 在查找 PLC 端无法接收相机信号的过程中，也可以单击 IO 状态监控界面中的指定输出口，从而让相机对应的端 强制输出信号，查看 PLC 端是否接收到信号，从而可以大致判断是相机未输出还是 PLC 未接收到信号； 5.2 相机至 PLC 输入端未接收到信号确保相机的 IO 监控输出正确的信号，但 PLC 端仍未接收任何信号后，此时的原因主要是： 线路断开。由于相机到 PLC 部分的信号线问题，

15、导致 PLC 输入端无法接收到相机的输出信号，此时只能更换该部分线缆； PLC 的滤波时间过长。PLC 的滤波时间大于相机的处理周期，从而相机输出信号被 PLC 过滤，导致无法接收到相应的信号，此时需要降低 PLC 的滤波时间，或者延长相机的处理时间； PLC 端子损坏。将相机的输出接到 PLC 的其他输入端子上，若能准确接收到信号，则说明端子问题，可以改接其他输入端子； 6 工程无法下载 在上位机软件上配置好相应的工具和数据后，将工程信息下载到相机过程中，若出 现无法下载的问题，则可以根据提示的错误进行相应处理。 6.1 CRC 校验错误/序列化错误下载过程中出现 CRC 校验错误或者序列化

16、错误，则主要是因为当前上位机软件和 相机硬件版本不一致。此时需要修改上位机版本或更新相机固件，确保上下位机版本一 致。 6.2 工具不一致错误在下载过程中，若出现如图 8 所示的某个工具不一致，则说明是上位机和相机固件版本不一致，需要更换成相应的版本，然后重新下载。 6.3 预处理个数错误图 8 上下位机工具版本不一致 由于相机内存有限，将工程下载到相机运行过程中，需要考虑到相机的运行内存， 因此针对 120 万和 500 万相机，预处理工具的个数在下载过程中，会受到相应的限制， 如图 9(a)所示，此时可以更换分辨率低的相机，若使用的预处理工具为二值化工具且处理区域不大（建议不要超过 640

17、*480），则可以在单个工具的内部选择相应的二值化选项。 6.4 脚本编译错误 图 9(a) 预处理限制图 9(b) 脚本编译错误图 9 下载错误提示示意图 如图 9(b)所示，在下载过程中出现脚本编译错误，导致工程无法下载，则需要进一步检查脚本语法错误，解决脚本编译错误后再下载，常见的脚本编译错误见 7 脚本编译 /运行错误。 7 上下位机数据不一致 上下位机数据不一致，指的是在运行同样的图片和工程过程中，上位机软件的仿真 结果和相机运行的结果不一致。为了确认上下位机不一致，可以将出现不一致的工程和 图片保存， 将工程下载到相机后，将相机切换到调试模式，然后选择“系统”中的“图像下载”，从而

18、通过modbus 依次比较上下位机的运算数据，从而定位出现不一致的部分。 7.1 脚本的输出结果不一致7.1.1 执行次数不一致 相机在运算过程中，会运行相机采集到的每一张图片，而上位机软件则不一定执行每一张图片（例相机处理过程很短的情况下），因此可能会出现由于执行次数不同导致的部分数据不一致。一般情况下，在外部触发模式，当触发间隔时间大于通讯时间的情 况下，基本不会产生由于处理次数不同导致的不一致。 7.1.2 脚本全局变量在上位机被重新编辑 由于脚本的全局变量（定义在脚本左侧的变量）在每次重新点开脚本编辑框后，会恢复到默认值，而相机在下载后，若不通过 PLC 等外部设备对其进行改写，其定义

19、的全局脚本不会恢复到初始值，因此若用户下载工程后，再重新打开脚本编辑界面，则有可能出现由于部分全局变量恢复到初始值而导致的数据不一致。如图 10 所示，在 tool2 中定义一个 val 的全局变量，其初始值为 0，每执行一次 val 会自加 1，当该工具下载后， 若相机运行 n 次后，相机和上位机中的 val 值均为 n+1，此时上位机软件点击弹出脚本编辑界面，则上位机的 val 值恢复到初始值 0，而此时相机中的 val 值仍为 n+1.图 10 全局变量不一致示意图 7.2 通用工具的输出结果不一致通用工具的输出结果不一致，一般情况均为上位机软件和相机固件的版本不一致 （工具的版本不一致

20、），该情况下，可以将上位机和相机版本更换成一致的版本。 8 常见的脚本编译/运行错误 在编写脚本的过程中，可以点击脚本工具的“检查”按钮，软件会对当前的编辑内 容进行编辑，出现 OK 后，则说明当前脚本无错误。 8.1 变量未定义当出现图 11 所示的错误，则说明变量 a 没有定义，此时可以根据提示的行数（由于软件内部索引从 0 开始，因此一般错误出现在行数+1 的位置），重新定义该变量。 8.2 数组越界如图 11(b)所示当脚本中定义一个长度为 10 的数组 arrange 时，则只能对 arrange 的0-9 的数据进行读写操作，如图 11(b)中，读取了 arrange10的数据，则

21、运行结果会显示数组越界，此时需要检查并出现越界的代码段。 8.3 排序错误图 11(a) 变量未定义图 11(b) 数组越界图 11 脚本编译错误示意图 在使用脚本的高级排序或者数组的其他操作过程中，若操作的数组被定义为全局变量， 则不能将该数组定义在本脚本的第一个位置，否则会出现脚本排序结果错误等问题， 若出现该问题，则可以先删除该全局数组，然后定义一个其他非数组的变量，最后再定义该全局数组即可。 8.4 脚本相互包含错误如图 12 所示，在脚本 tool1 和 tool2 中分别定义变量 task 和 task2，tool1 中引用了tool2 中 task2 的值，而 tool2 中同样

22、引用了 tool1 中 task 的值，从而导致两个脚本相互包含，在第一次编辑的情况下，脚本编译和运行均不会报错，但当同样的工程文件在另 外一台电脑上运行时，则会报错，此时的解决办法就是修改程序，保证脚本工具之间不 存在相互包含的关系。 8.5 缺少符号错误图 12 脚本相互包含示意图 如图 13 所示的错误即为在第 7 行（实际显示应该是第 8 行）丢失了“；”，此时仅需要添加相应的符号即可，同样的错误也会出现在丢失中括号、大括号、小括号等情况 下； 图 13 丢失符号 8.6 类型错误脚本中调用相关的函数或变量时，会有相应的变量类型要求，如果类型不一致，则可能编译不通过。如图 14 所示，代码中取点(point.x,point.y)处的灰度值，函数getpixelgray 的输入参数要求为 int 类型，而 point 的坐标值均为 float 类型，因此编译过程中会出现图 14 下方的错误。 图 14 类型错误 此时，仅