控制器报错码
控制器在运行、通信、工艺执行过程中会上报消息码。本目录把控制器侧的消息码按模块整理成 6 页,共 974 条。
一套码,多处共用
这套码由控制器产生,上位机 SDK(C++、C#、Python 三套语言)与控制器 SDK(NRC_* 接口)拿到的都是同一套码值和同一份消息文本,不要按语言各建一份。C# 与 Python 的《错误码表》页都指向本目录。
与 SDK 返回值的区别
本目录讲的是控制器上报的消息码(4~5 位十进制,如 4097、9249),它通过消息回调送到上位机。 SDK 接口自身的返回值是另一套:上位机 C++ 为 Result(0、-1 ~ -6),控制器 SDK 为 0 / -101 / -102 / -103。见错误码表。两者不要混用:接口返回成功不代表控制器没有上报消息。
怎么拿到这些码
订阅控制器的错误/警告消息回调,回调里的 messageCode 就是本目录的十进制码值:
Result set_receive_error_or_warnning_message_callback(
SOCKETFD socketFd,
void (*function)(int messageType, const char* message, int messageCode));messageType:消息级别(错误 / 警告 / 信息)message:消息文本,与本目录「消息文本」列一致(%d、%i会被替换为机器人编号)messageCode:本目录的十进制码值
现场反馈问题时,让客户提供界面上显示的码值即可,不必给十六进制。
按模块查
| 分页 | 覆盖内容 | 码数 |
|---|---|---|
| 操作与状态 | 上电、运行、模式互斥、标定与伺服连接、功能支持性、配置参数、人机协作、多机协调 | 182 |
| 作业文件 | 指令语法与配对校验、运行期错误(含后台任务) | 300 |
| 伺服与运动 | 急停、光幕、碰撞、限位、力矩、伺服报错、插补与运动规划 | 75 |
| 通信与总线 | 网络通讯、Modbus、Finstcp、远程数据上传、OPCUA、EIP | 45 |
| 工艺类(一) | 视觉、传送带、焊接、寻位与跟踪 | 289 |
| 工艺类(二) | 激光切割、喷涂、码垛、打磨、冲压、其他工艺 | 83 |
合计 974 条。源码中定义 977 条:9313 被两处定义复用(界面只显示其中一条),另有 2 条为开发调试码不对外发布,故按 974 条列出。
码段规律
码值按模块分段,看到码值就能大致判断方向:
| 码段(十六进制) | 十进制范围 | 模块 | 所在页 |
|---|---|---|---|
0x1001 – 0x1014 | 4097 – 4116 | 操作(上电、运行、模式互斥) | 操作与状态 |
0x1021 – 0x1215 | 4129 – 4629 | 状态(标定、伺服连接状态) | 操作与状态 |
0x1401 – 0x2044 | 5121 – 8260 | 作业文件指令校验 | 作业文件 |
0x2201 – 0x220C | 8705 – 8716 | 功能支持性 | 操作与状态 |
0x2401 – 0x2543 | 9217 – 9539 | 安全(急停、光幕、碰撞、限位、力矩) | 伺服与运动 |
0x2500 – 0x2521 | 9472 – 9505 | 伺服报错 | 伺服与运动 |
0x2601 – 0x2632 | 9729 – 9778 | 插补计算与运动规划 | 伺服与运动 |
0x3001 – 0x332A | 12289 – 13098 | 作业文件运行 | 作业文件 |
0x4001 – 0x432C | 16385 – 17196 | 配置文件与参数 | 操作与状态 |
0x5001 – 0x5048 | 20481 – 20552 | 人机协作、动力学辨识、拖拽 | 操作与状态 |
0x5101 – 0x5105 | 20737 – 20741 | 网络通讯 | 通信与总线 |
0x5201 – 0x5218 | 20993 – 21016 | Modbus | 通信与总线 |
0x5301 – 0x5304 | 21249 – 21252 | Finstcp | 通信与总线 |
0x5401 – 0x5407 | 21505 – 21511 | 远程数据上传 | 通信与总线 |
0x5501 – 0x550F | 21761 – 21775 | 其他通用 | 操作与状态 |
0x6001 – 0x604B | 24577 – 24651 | 视觉 | 工艺类(一) |
0x6101 – 0x6131 | 24833 – 24881 | 传送带 | 工艺类(一) |
0x6201 – 0x6202 | 25089 – 25090 | 喷涂 | 工艺类(二) |
0x6311 – 0x6347 | 25361 – 25415 | 码垛 | 工艺类(二) |
0x6401 – 0x644B | 25601 – 25675 | 焊接 | 工艺类(一) |
0x6501 – 0x655B | 25857 – 25947 | 寻位与跟踪 | 工艺类(一) |
0x6601 – 0x6613 | 26113 – 26131 | 激光切割 | 工艺类(二) |
0x6701 – 0x6708 | 26369 – 26376 | 打磨 | 工艺类(二) |
0x6801 – 0x680E | 26625 – 26638 | 冲压 | 工艺类(二) |
0x6901 – 0x6908 | 26881 – 26888 | 其他工艺 | 工艺类(二) |
0x7001 – 0x7103 | 28673 – 28931 | 操作扩展段(从站与控制器配置) | 操作与状态 |
0x7201 – 0x7204 | 29185 – 29188 | OPCUA | 通信与总线 |
0x7205 – 0x7206 | 29189 – 29190 | EIP | 通信与总线 |
0x7300 – 0x7305 | 29440 – 29445 | 多机协调 | 操作与状态 |
段内不连续属正常现象:未启用的码不会上报,保留编号以避免跨版本变动。
消息里的 %d、%s 怎么读
本目录的「消息文本」列是代码里的格式串,不是界面上的最终文字:
| 格式符 | 会被替换成 |
|---|---|
%d、%i | 机器人编号(多机时有用) |
%s | 具体对象名称:轴名、设备名、IO 名称、变量名等 |
%f、%0.2f | 数值(速度、位置、力矩等) |
回调的 message 参数拿到的就是替换完成的完整句子,界面弹窗显示的也是它。排查时以这句原文为准,不要拿格式串去比对。
少数码的消息文本整句都由控制器拼装(表中显示为「由控制器拼装,界面显示实际内容」或「指令[指令码] + 具体原因」)。这类码没有固定文案,处理建议里已经写明该看原文的哪一部分——例如按 message 里出现的 IO 名称去核对配置,或按指令码去作业文件里定位那一行。
级别的含义
| 级别 | 含义 | 现场处理 |
|---|---|---|
| 错误 | 触发保护或中断当前动作 | 必须处理,多数会阻止继续运行 |
| 警告 | 不中断运行,但状态异常 | 记录并观察,反复出现需排查 |
| 信息 | 状态变更通知(如急停解除) | 仅记录,无需处理 |
| 未标注 | 代码中未登记级别 | 按错误对待,联系技术支持确认 |
查不到码怎么办
- 先确认码值位数:本目录是控制器消息码(4~5 位)。4 位且形如
7500、5410的码可能来自伺服驱动器或安全模块,不在本目录内。 - 按消息文本反查:把界面上的提示文字在本目录内搜索,比按码值更容易命中。
- 确认版本:不同版本的码值可能新增或调整,对照版本与兼容性确认交付包与控制器版本匹配。
- 仍查不到时,提供码值 + 消息原文 + 控制器版本 + 复现步骤给技术支持。
关于「预留码」
少数码在代码中已定义但当前版本未上报(如部分段内的跳号),这类码不会出现在界面上,属正常情况,不必排查。