发那科FOCAS 1/2文档——方法返回错误码

snailiot

已于 2025-08-15 08:07:19 修改

阅读量729

点赞数 20

CC 4.0 BY-SA版权

文章标签：发那科FOCAS

于 2025-08-14 11:25:57 首次发布

本文链接：https://blog.csdn.net/snailiot/article/details/150386465

错误代码列表 (Error Code List)

错误代码 (Code)	宏定义 (Macro)	含义 (Description)
0	`EW_OK`	正常结束。函数执行成功，无错误。
-1	`EW_FUNC`	功能不可用。请求的功能在当前的 CNC 型号、系列、软件版本或配置下不支持。例如，尝试在不支持的 CNC 上调用某个特定函数，或未正确设置编译宏（如为 8 位程序号 CNC 调用未带 `2` 后缀的函数）。
-2	`EW_NOPMC`	无 PMC 模块。请求的 PMC（可编程机床控制器）相关功能无法执行，因为 CNC 系统中没有安装 PMC 模块，或 PMC 未正常运行。
-3	`EW_HANDLE`	句柄无效。传递给函数的库句柄 (`FlibHndl`) 无效或未正确初始化。通常是因为 `cnc_allclibhndl` 或 `cnc_allclibhndl3` 函数调用失败后，仍使用了返回的句柄。
-4	`EW_UNEXP`	未预期的错误。库内部发生了一个未预料到的错误。这可能表明库本身、通信或 CNC 状态存在严重问题。
-5	`EW_SYSTEM`	系统错误。操作系统或系统资源层面发生错误。例如内存分配失败、系统调用失败等。
-6	`EW_PARITY`	奇偶校验错误。在通过 HSSB 等串行通信与 CNC 通信时，检测到数据传输的奇偶校验错误。通常由通信线路干扰或硬件故障引起。
-7	`EW_MODE`	模式不匹配。函数调用的条件与 CNC 当前的运行模式冲突。例如，在 CNC 处于 DNC 模式时尝试执行某些操作。
-8	`EW_BUFFER`	缓冲区溢出。用户提供的数据缓冲区大小不足以容纳函数要返回的数据。需要检查并增大缓冲区。
-9	`EW_OVERFLOW`	数据溢出。函数处理的数据超出了其内部或定义的范围。
-10	`EW_LENGTH`	数据长度错误。指定的数据长度不正确或不被接受。
-11	`EW_NUMBER`	编号错误。指定的编号（如程序号、刀具号、参数号等）无效或超出范围。
-12	`EW_ATTRIB`	属性错误。请求操作的数据属性不匹配。例如，试图向只读区域写入数据。
-13	`EW_TYPE`	类型错误。数据类型不匹配。例如，期望整数却提供了浮点数。
-14	`EW_PROTECT`	保护错误。操作被 CNC 的保护机制阻止。例如，试图修改受保护的参数或文件，通常需要解除写保护或切换到特定模式（如写入模式）。
-15	`EW_PARAMETER`	参数错误。传递给函数的一个或多个参数无效。需要检查参数的值和格式。
-16	`EW_BUS`	总线错误。与 CNC 的通信总线（如 HSSB）发生错误。可能是硬件连接问题或总线故障。
-17	`EW_CNC`	CNC 错误。CNC 系统本身返回了一个错误，阻止了请求的操作。
-18	`EW_MACHTYPE`	机床类型不匹配。请求的功能与当前连接的机床类型不兼容。
-19	`EW_RESET`	CNC 重置。在函数执行过程中，CNC 被重置或重启。
-20	`EW_BUSY`	系统忙。CNC 或库当前正忙于处理其他任务，无法立即响应此请求。通常需要稍后重试。
-21	`EW_FLTPLC`	浮点运算库错误。与浮点运算相关的库内部错误（此描述可能较旧或特定）。
-22	`EW_STOP`	操作停止。操作被用户或系统明确停止。
-23	`EW_PASSWD`	密码错误。执行需要密码权限的操作时，提供的密码不正确或未提供。
-24	`EW_REJECT`	请求被拒绝。CNC 明确拒绝了请求，原因可能包括权限不足、状态不符等。
-25	`EW_DTSRVR`	数据服务器错误。与 CNC 的数据服务器功能相关的错误。
-26	`EW_ALARM`	CNC 报警。CNC 处于报警状态，许多读写操作会被禁止，直到报警解除。
-27	`EW_STOPMTB`	机床停止。机床（MTB - Machine Tool Builder）被停止，可能影响相关操作。
-28	`EW_PASSWD2`	密码级别 2 错误。需要更高级别（第二级）密码的操作，密码验证失败。
-29	`EW_KBDLOCK`	键盘锁定。CNC 操作面板的键盘被锁定，可能限制某些输入或操作。
-30	`EW_HSSB`	HSSB 错误。HSSB（高速串行总线）通信发生特定错误。
-31	`EW_EIO`	I/O 错误。输入/输出操作失败，如文件读写、网络通信等。
-32	`EW_ETYPE`	扩展类型错误。扩展功能的类型不匹配。
-33	`EW_FUNC2`	功能不可用 2。与 `EW_FUNC` 类似，表示功能不支持，可能是更具体的场景。
-34	`EW_DTSRVR2`	数据服务器错误 2。与数据服务器相关的另一种错误。
-35	`EW_SOCKET`	Socket 错误。在使用 TCP/IP 通信时，Socket 操作失败（如连接失败、超时）。
-36	`EW_EHST`	主机错误。主机（运行应用程序的 PC）端发生错误。
-37	`EW_EHARD`	硬件错误。检测到硬件故障。
-38	`EW_EINIT`	初始化错误。库或通信的初始化过程失败。
-39	`EW_EFIFO`	FIFO 错误。与 FIFO（先进先出）缓冲区相关的错误。
-100	`EW_SOCKET2`	Socket 错误 2。另一种 Socket 通信错误。
-101	`EW_NGHANDLE`	句柄获取失败。无法获取有效的库句柄，通常发生在 `cnc_allclibhndl` 调用时。
-102	`EW_NGLICENSE`	许可证错误。库的使用许可证无效或缺失。
-103	`EW_SETTIMER`	定时器设置错误。设置内部定时器失败。
-104	`EW_ASYN`	异步处理错误。异步函数调用或处理过程中发生错误。
-105	`EW_NORESULT`	无结果。异步请求尚未完成，无法获取结果。
-106	`EW_ALREADY`	已存在/已进行。请求的操作已经存在或正在进行中。
-107	`EW_NOPROB`	无问题 (No Problem)。此代码含义与字面相反，常用于表示“无错误”或“正常”，但在某些上下文中可能有特定含义。注意：这与 `EW_OK` (0) 不同，需结合具体函数理解。
-108	`EW_SETREF`	参考设置错误。设置参考点或相关参数失败。
-109	`EW_HOST`	主机错误。与主机（PC）相关的错误。
-110	`EW_VERSION`	版本不匹配。库版本与 CNC 软件版本不兼容。
-111	`EW_DATA`	数据错误。提供的数据格式或内容无效。
-112	`EW_NOOPT`	无此选项。请求的选项在当前系统中不存在。
-113	`EW_MACERROR`	宏错误。执行宏指令时发生错误。
-114	`EW_STOPDIAG`	诊断停止。诊断功能被停止。
-115	`EW_NODATA`	无数据。请求的数据不存在。
-116	`EW_OVERFLOW2`	溢出 2。另一种溢出情况。
-117	`EW_PROTECT2`	保护错误 2。另一种保护机制阻止了操作。
-118	`EW_HSSB2`	HSSB 错误 2。另一种 HSSB 通信错误。
-119	`EW_SOCKET3`	Socket 错误 3。第三种 Socket 通信错误。

EW_OK (0) 是成功标志: 只有当函数返回 0 时，才表示操作成功。
负数即错误: 所有负数返回值都代表某种错误或异常状态。
关键错误码:
- EW_FUNC (-1): 最常见的错误之一，意味着功能不支持。首要检查目标 CNC 型号、软件版本以及是否正确设置了编译宏（如 FS15D, ONO8D, MAX_AXIS）。
- EW_HANDLE (-3): 表明句柄无效。务必检查 cnc_allclibhndl / cnc_allclibhndl3 的返回值，仅在成功时 (EW_OK) 才使用返回的句柄。
- EW_PROTECT (-14): 操作被保护。需要确认是否需要解除 CNC 的写保护或切换到正确的操作模式。
- EW_ALARM (-26): CNC 处于报警状态。许多操作会被禁止，应先解决 CNC 报警。
- EW_BUSY (-20): 系统忙。可以考虑加入重试机制。
- EW_SOCKET (-35) / EW_HSSB (-30): 通信错误。检查物理连接（网线、HSSB 电缆）、IP 地址、端口号、HSSB 配置等。
- EW_VERSION (-110): 库与 CNC 版本不兼容。可能需要更新 FOCAS 库或确认兼容性。