发那科FOCAS 1/2——cnc_clralm清除报警

函数功能 (Function Description)

清除指定 ID 的 CNC 报警状态。

当 CNC 发生某些类型的报警（如 P/S 报警）后，可以通过外部操作（如按复位键）来清除这些报警，使 CNC 恢复正常运行。cnc_clralm 函数提供了通过程序化方式执行此操作的能力。它相当于在 CNC 操作面板上按下了“复位”（Reset）键。

重要提示:

• 该函数只能清除 P/S 报警（程序/系统报警）。
• 对于 伺服报警 (SERVO ALARM)、主轴报警 (SPINDLE ALARM)、行程极限报警 (OT ALARM) 等硬件或严重故障报警，此函数无效。这些报警通常需要操作员在排除故障后手动复位。
• 对于 Series 15i, 30i, 0i-D/F, Power Mate i-A 等系列，应使用改进版本的 cnc_clralm2 函数。

---

函数原型 (Function Prototype)

C

深色版本

#include "fwlib32.h" // 或 "fwlib64.h"

FWLIBAPI short WINAPI cnc_clralm(
    unsigned short FlibHndl, // [in] 库句柄
    long           id        // [in] 报警 ID
);

---

参数说明 (Arguments)

参数	类型	方向	说明
FlibHndl	unsigned short	[in]	库句柄 (Library Handle)。通过 cnc_allclibhndl 或 cnc_allclibhndl3 函数获得的有效连接句柄。
id	long	[in]	报警 ID。指定要清除的报警号。<br>• 0: 清除所有当前激活的 P/S 报警。<br>• > 0: 清除指定报警号的 P/S 报警（例如 id=100 清除 P/S 100 报警）。

---

返回值 (Return Value)

• EW_OK (0): 函数执行成功，指定的报警已被清除（如果存在且可清除）。
• 其他值: 函数执行失败，返回值为错误代码（负数）。常见错误包括：
  • EW_HANDLE: 句柄无效。
  • EW_ATTRIB: 参数错误（如 id 为负数）。
  • EW_PROTECT: 操作被保护（可能需要解除写保护）。
  • EW_BUSY: CNC 当前正忙。
  • EW_ALARM: CNC 处于不可清除的报警状态（如伺服报警）。
  • 具体错误信息可参考 cnc_getdtailerr 函数。

---

技术要求与限制 (Technical Requirements & Limitations)

• 功能限制: 仅对 P/S 报警有效。对于其他类型的报警（伺服、主轴、OT等），此函数调用会成功返回 (EW_OK)，但实际不会清除报警。
• CNC 选项 (CNC Option): 无特殊要求。
• CNC 参数 (CNC Parameter): 无特殊要求。
• CNC 模式 (CNC Mode): 可在任何 CNC 模式下使用。
• 可用 CNC (Available CNC): 支持多种 FANUC CNC 型号，包括：
  • 0i-A, 0i-B/C, 0i-D, 0i-F
  • 15, 15i
  • 16, 18, 21
  • 16i-A/B, 18i-A/B, 21i-A/B
  • 30i-A/B
  • Power Mate i-D/H
  • Machining, Turning, Punch press, Loader, Laser, Wire 等类型的机床。
  • 注意: 0i-C 型号不支持 HSSB 功能。