Skip to content
🤖 AI 助手 / 自动化工具:先读 《AI 助手先读》 《Agent 开发指引》 《生成前信息采集清单》;机器可读入口 /llms.txt;技能包(SKILL)直链:SKILL.md

控制器报错码 ​

控制器在运行、通信、工艺执行过程中会上报消息码。本目录把控制器侧的消息码按模块整理成 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 就是本目录的十进制码值:

cpp
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、EIP45
工艺类(一)视觉、传送带、焊接、寻位与跟踪289
工艺类(二)激光切割、喷涂、码垛、打磨、冲压、其他工艺83

合计 974 条。源码中定义 977 条:9313 被两处定义复用(界面只显示其中一条),另有 2 条为开发调试码不对外发布,故按 974 条列出。

码段规律 ​

码值按模块分段,看到码值就能大致判断方向:

码段(十六进制)十进制范围模块所在页
0x1001 – 0x10144097 – 4116操作(上电、运行、模式互斥)操作与状态
0x1021 – 0x12154129 – 4629状态(标定、伺服连接状态)操作与状态
0x1401 – 0x20445121 – 8260作业文件指令校验作业文件
0x2201 – 0x220C8705 – 8716功能支持性操作与状态
0x2401 – 0x25439217 – 9539安全(急停、光幕、碰撞、限位、力矩)伺服与运动
0x2500 – 0x25219472 – 9505伺服报错伺服与运动
0x2601 – 0x26329729 – 9778插补计算与运动规划伺服与运动
0x3001 – 0x332A12289 – 13098作业文件运行作业文件
0x4001 – 0x432C16385 – 17196配置文件与参数操作与状态
0x5001 – 0x504820481 – 20552人机协作、动力学辨识、拖拽操作与状态
0x5101 – 0x510520737 – 20741网络通讯通信与总线
0x5201 – 0x521820993 – 21016Modbus通信与总线
0x5301 – 0x530421249 – 21252Finstcp通信与总线
0x5401 – 0x540721505 – 21511远程数据上传通信与总线
0x5501 – 0x550F21761 – 21775其他通用操作与状态
0x6001 – 0x604B24577 – 24651视觉工艺类(一)
0x6101 – 0x613124833 – 24881传送带工艺类(一)
0x6201 – 0x620225089 – 25090喷涂工艺类(二)
0x6311 – 0x634725361 – 25415码垛工艺类(二)
0x6401 – 0x644B25601 – 25675焊接工艺类(一)
0x6501 – 0x655B25857 – 25947寻位与跟踪工艺类(一)
0x6601 – 0x661326113 – 26131激光切割工艺类(二)
0x6701 – 0x670826369 – 26376打磨工艺类(二)
0x6801 – 0x680E26625 – 26638冲压工艺类(二)
0x6901 – 0x690826881 – 26888其他工艺工艺类(二)
0x7001 – 0x710328673 – 28931操作扩展段(从站与控制器配置)操作与状态
0x7201 – 0x720429185 – 29188OPCUA通信与总线
0x7205 – 0x720629189 – 29190EIP通信与总线
0x7300 – 0x730529440 – 29445多机协调操作与状态

段内不连续属正常现象:未启用的码不会上报,保留编号以避免跨版本变动。

消息里的 %d、%s 怎么读 ​

本目录的「消息文本」列是代码里的格式串,不是界面上的最终文字:

格式符会被替换成
%d、%i机器人编号(多机时有用)
%s具体对象名称:轴名、设备名、IO 名称、变量名等
%f、%0.2f数值(速度、位置、力矩等)

回调的 message 参数拿到的就是替换完成的完整句子,界面弹窗显示的也是它。排查时以这句原文为准,不要拿格式串去比对。

少数码的消息文本整句都由控制器拼装(表中显示为「由控制器拼装,界面显示实际内容」或「指令[指令码] + 具体原因」)。这类码没有固定文案,处理建议里已经写明该看原文的哪一部分——例如按 message 里出现的 IO 名称去核对配置,或按指令码去作业文件里定位那一行。

级别的含义 ​

级别含义现场处理
错误触发保护或中断当前动作必须处理,多数会阻止继续运行
警告不中断运行,但状态异常记录并观察,反复出现需排查
信息状态变更通知(如急停解除)仅记录,无需处理
未标注代码中未登记级别按错误对待,联系技术支持确认

查不到码怎么办 ​

  1. 先确认码值位数:本目录是控制器消息码(4~5 位)。4 位且形如 7500、5410 的码可能来自伺服驱动器或安全模块,不在本目录内。
  2. 按消息文本反查:把界面上的提示文字在本目录内搜索,比按码值更容易命中。
  3. 确认版本:不同版本的码值可能新增或调整,对照版本与兼容性确认交付包与控制器版本匹配。
  4. 仍查不到时,提供码值 + 消息原文 + 控制器版本 + 复现步骤给技术支持。

关于「预留码」

少数码在代码中已定义但当前版本未上报(如部分段内的跳号),这类码不会出现在界面上,属正常情况,不必排查。