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

错误代码列表 (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 通信错误。

1. EW_OK (0) 是成功标志: 只有当函数返回 0 时，才表示操作成功。
2. 负数即错误: 所有负数返回值都代表某种错误或异常状态。
3. 关键错误码:
   • 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 库或确认兼容性。