简介：《MotoPlus 用户手册》是一份面向安川机器人调试与维护人员的官方技术资料，重点解决使用 MotoPlus 语言环境和 YRC1000 控制柜时的编程、操作与安全规范问题。整份资源为单个 PDF 文件，包体约 11.2MB，便于直接查阅和归档，适合需要系统学习 MotoPlus 开发环境及日常维护的工程师。手册涵盖 MotoPlus 语言环境、YRC1000 使用说明、报警代码表、安全注意事项和维护保养方法；开篇梳理了 MOTOMAN 使用说明书体系，并明确机器人本体、控制柜、示教器、供电电缆等术语定义，目录中更展开介绍了 MotoPlus 的特点、可提供的服务以及应用开发环境构成。针对现场高风险环节，手册详细说明了操作前确认伺服电源切断、急停键位置、急停状态解除流程，并强调示教时安全栏上锁、保持正面观看、预留躲避场所等要点，同时将安全事项划分为危险、警告、注意、通知四类，帮助读者建立完整的安全操作意识。目前已有 545 人学习下载，对于从事安川机器人应用开发、现场调试和设备维护的读者具有较高的参考价值。
1. MotoPlus 到底是给谁用的
MotoPlus 这个名字看着像插件，其实是安川为 YRC1000 控制柜准备的 C 语言编程环境。大致背景：机器人本体用的 JOB 语言做点位和顺序控制还行，但一旦涉及视觉传感器数据、位姿动态修正、外部 PC 的 TCP/IP 通讯，JOB 就显得吃力。MotoPlus 的思路很直接——你写 C 代码，在 PC 上用 MotoPlusIDE 编译出加载模块，然后放进 YRC1000 主 CPU（ACP01 基板）上由 VxWorks 实时系统调起来，作为原生任务和系统程序一起跑。不用买额外硬件，处理速度也快。这个环境主要面向集成商和熟悉 C 的机器人工程师，学习曲线比想像中平缓，但坑也不少。
2. MotoPlusIDE 装完以后：项目创建与构建参数
2.1 硬件连接与软件版本
开发用的电脑要求不高。CPU 1GHz，内存 1GB，硬盘 40GB 空余，Windows XP SP2 / Vista / Win7（32 位）都在支持列表里，实际用更高的配置也兼容。连接时有两种链路要分清：调试链路走 Ethernet，五类线以上直通或交叉都可以，两端配置好 IP 在同一个网段；安装链路是把编译出来的加载模块放进 SD 或 USB 存储器，再用示教器写入主 CPU 的内藏 SD。
这里有一个容易踩的误区：Ethernet 调试口在 YRC1000 控制柜侧，不在示教器上。现场网络环境复杂时，我一般单独加一块物理网卡给机器人调试用，固定 IP 在 192.168.0.x 段，避免和办公网混用，否则 ARP 干扰会让 TELNET 连接时断时续。安装的软件来源于随附 DVD，安装步骤是标准的：
- 插入安装 DVD，如果 AutoRun 没有启动就运行根目录的 setup.exe。
- 如果 PC 没有 .NET Framework 3.5 SP1，安装程序会自动启动它。这一步必须联网。
- 继续 MotoPlusIDE 安装，默认路径是
C:\Program Files\Yaskawa\MotoPlusIDE_YRC。 - 安装完成后，桌面和开始菜单会出现快捷方式。
注意目录名是MotoPlusIDE_YRC而不是 DX200 的路径。如果你之前在 DX200 上做过 MotoPlus 开发，两个 IDE 可以共存，但项目文件不要混用，YRC1000 的 API 变更点会在链接阶段暴露出来。
2.2 项目结构：源文件放哪里
创建一个 MotoPlus 项目后，工程目录内至少要注意这几个文件：
| 文件或目录 | 用途 |
|---|---|
| src/ | 存放 .c 源文件和 .h 头文件 |
| MotoPlus 程序库 | API 所在的静态库，IDE 自动链接 |
| 工程配置文件 | 控制编译、链接和目标输出 |
| 输出目录 | 生成MotoPlusApl.out加载模块 |
手册里强调源程序创建有规约，最需要记住的一条：不要自己维护依赖路径，IDE 构建时会自动带上 MotoPlus 程序库和 GCC 工具链路径。你只需要在工程属性的构建设置里确认两个字段——目标平台和输出格式。
# 典型工程属性示意（以 IDE 配置面板为准） Target: YRC1000 (ACP01) Toolchain: GNU C (MotoPlus 内置) Output: .out 加载模块 优化: -O2 或默认2.3 构建：编译、链接与输出
从菜单执行编译链接即可。内部流程是：源程序先被编译成目标 CPU 的机器语言，再用链接器把 GCC 提供的 C 库和 MotoPlus API 库链接在一起，生成可执行加载模块。链接时报 "undefined symbol" 的情况，多数是 API 函数名拼写不对，或者漏掉了对应的程序库，优先检查这两个地方。
如果从 DX200 项目迁移过来，不要只做宏替换。YRC1000 的 API 变更点包括部分函数签名、任务优先级常量和系统变量定义，跨代际移植时要对照 API 规格书逐项核对。构建通过后，输出目录里会生成MotoPlusApl.out，这个文件就是要装进 YRC1000 的东西。
3. MotoPlus API 矩阵：任务、数据与通信的 C 语言入口
MotoPlus 能做的事情非常多，但核心价值在于它绕过 JOB 直接操作控制柜资源。手册 1.4 节列出的服务有十几类，真正需要写代码的集中在任务控制、数据交换、串口和网口通讯这几个部分。
3.1 十六类服务全景
| 服务 | 说明 | 典型用途 |
|---|---|---|
| 应用任务控制 | 任务启停、邮箱、信号量 | 多任务协作与同步 |
| 机器人控制 | 位姿读取、运动控制 | 实时轨迹干预 |
| JOB 控制 | 程序开始和停止 | 与 JOB 联动 |
| CIO 控制 | IO、寄存器读写 | 信号采集与输出 |
| Ethernet 通信 | TCP/IP、套接字 | 与 PC、视觉通信 |
| 示教器通信 | 数据交互 | 人机界面增强 |
| 事件控制 | 周期事件通知 | IO 和插补周期任务 |
| 串行通信 | RS232C | 传感器、仪表连接 |
| 传感器控制 | 轨迹修正、速度变更 | 视觉引导 |
| 内存管理 | 受保护内存 | 安全分配与释放 |
| 文件控制 | CMOS、寄存器文件 | 存储参数 |
| 伺服控制 | 直接伺服控制 | 高级运动控制 |
| 用户看门狗 | 监控应用状态 | 防挂死 |
| 坐标转换 | 正逆解、代数运算 | 位姿计算 |
这张表对应手册 1.4 节列出的服务清单。你不需要全用，我来拆三个最常见的调用场景。
3.2 任务创建：正确写出 mpUsrRoot
所有 MotoPlus 应用从mpUsrRoot进入，它类似 main，但它不是普通主函数。mpUsrRoot的优先级相当高，必须在里面快速完成初始化，然后启动用户任务并立即退出。手册明确警告过，这个任务里如果处理超过 100μsec，可能抢占机器人控制周期，导致系统报警甚至示教器无法响应。
一个规范的入口代码如下：
#include <MotoPlus.h> /* 任务控制块和栈内存，必须定义为全局 */ MP_TASK_RAM usrTaskRam; /* 用户任务主函数 */ void usrTask(void *arg) { for (;;) { /* 业务逻辑：通信、运算、数据存取等 */ mpTaskDelay(10); /* 每 10ms 循环一次 */ } } void mpUsrRoot(void) { /* 创建用户任务，优先级用普通优先级 */ mpTaskCreate(&usrTaskRam, "usrTask", MP_PRI_NORMAL, 0x2000, usrTask, NULL); }参数说明：MP_TASK_RAM是任务控制块和栈内存的载体，必须全局定义；MP_PRI_NORMAL是普通优先级，适合大多数后台任务；0x2000是栈大小（8KB），如果函数里使用了较大的局部数组，把栈提高到0x4000再观察系统占用。任务创建完毕后，mpUsrRoot立即返回。
3.3 与 JOB 数据交换：变量读写
与 JOB 交互是 MotoPlus 应用最高频的入口之一。比如视觉做位置修正时，JOB 端只需要把位置变量拿出来用，实际数据来自 MotoPlus 侧的计算结果。手册提供的服务里，字节变量、整数变量、双精度、浮点、字符串和位置变量都可读写，且支持字节和整数变量的按位操作。下面示意整数变量读写：
#include <MotoPlus.h> long bVariable; /* 字节变量 */ int iVariable; /* 整数变量 */ double dVariable; /* 双精度变量 */ float fVariable; /* 浮点变量 */ void usrTask(void *arg) { /* 从 JOB 侧读取字节变量 B000 */ mpGetVarData(MP_VAR_B, 0, &bVariable); iVariable = 100; /* 写入整数变量 I000 */ mpSetVarData(MP_VAR_I, 0, &iVariable); }mpGetVarData/mpSetVarData的第一个参数指定变量类型，第二个参数是变量号，第三个参数是数据地址。这里我把变量号写成 0，对应 B000 / I000。需要注意：MotoPlus 侧对这些变量的读写不触发 JOB 的逻辑运算，只做数据搬运，所以 JOB 和 MotoPlus 两侧的变量类型必须保持一致，否则拿到的是解释错误的数据。
3.4 串口与 Ethernet：外部设备接入
RS232C 串口通信服务的 API 风格接近 POSIX，常见写法是先 open 再 read/write：
int fd; char buf[128]; int n; /* 打开 COM1，波特率 9600，无校验，8 位数据，1 停止位 */ fd = mpSerialOpen(0, 9600, MP_PARITY_NONE, 8, 1); if (fd < 0) { /* 端口打开失败，做错误处理 */ } n = mpSerialRead(fd, buf, sizeof(buf)); if (n > 0) { /* 处理收到的传感器数据 */ }Ethernet 通信则直接提供套接字函数库，MotoPlus 内部封装成mpSocket系列 API。实际部署时我建议把 TCP Server 放在 PC 端、机器人做 Client，这样机器人可以随时重连，不会因为服务端重启而丢会话。套接字的超时时间要显式设置，默认阻塞模式下一旦对方断线，任务会被卡住，导致看门狗来不及喂狗触发保护。
4. 上柜实操：把 .out 装进 YRC1000 并 TELNET 调试
编译出来只是第一步，YRC1000 默认不会运行你写的程序，要先在维护模式里把功能打开，再安装、再启动。
4.1 维护模式选装功能
手册第一章就提醒过：使用 MotoPlus 功能时，要在维护模式的选装功能中将 MotoPlus 功能设为「使用」。这一步对应示教器上的参数设置。注意改完必须断电重启或者按界面提示重启控制柜，只改参数而不重启，主 CPU 不会加载 MotoPlus 的初始化过程，后续安装应用会失败。
设置路径大致是：维护模式 → 选装功能 → MotoPlus → 使用。不同固件版本的菜单翻译可能略有出入，如果找不到，直接在示教器的参数搜索界面输入关键字 MotoPlus，能更快定位。
4.2 从 SD 或 USB 安装应用
把MotoPlusApl.out复制到 SD 卡或 U 盘，插入示教器的存储接口。在示教器上选择 MotoPlus 应用安装，系统会把加载模块拷贝到主 CPU 内藏的 SD 中。应用在控制柜电源接通时自动加载进 ACP01 的内存，作为 VxWorks 任务启动。不想让它自动启动，安装后不要执行启动操作，或者在安装清单里把状态改成无效。
下面是安装后的状态检查要点：
| 检查项 | 正常状态 | 异常时处理 |
|---|---|---|
| 应用文件 | 出现在主 CPU SD 列表中 | 检查文件名是否重名或缺失 |
| 任务状态 | READY / RUN | 启动后立即退出，查代码和栈大小 |
| 系统报警 | 无新增重故障 | 查看报警代码表，重点看 CPU 和看门狗条目 |
4.3 TELNET 调试：先配置参数再连接
调试环境比较轻：PC 和 YRC1000 用网线直连或经交换机连好，确保同一网段后进行两个关键步骤。
- 将参数
S2C1119设为 1，启用 TELNET 功能。 - 在 PC 的命令行执行：
telnet 192.168.0.1这里192.168.0.1是你的控制柜地址，实际以现场分配为准。连接成功后，MotoPlus 应用里使用printf()/puts()输出的信息会显示在 TELNET 会话里，适合在调试阶段观察任务运行状态。注意连接后不要进入 VxWorks 的 SHELL 调试功能，手册明确警告这会挤占机器人运动控制处理时间，可能引发系统报警。
TELNET 对调试任务的优先级有限制。常规优先级任务用 printf 没问题，但MP_PRI_IO_CLK_TAKE、MP_PRI_IP_CLK_TAKE、MP_PRI_TIME_CRITICAL这类高优先级任务，调试时不要用 printf 或 puts。我在实际项目里把 IO 周期事件回调中的打印全部改成写用户变量，否则机器人一运动就报处理超时。
4.4 用 YRC1000 用户变量做嵌入式调试
当不能或不想用 TELNET 时，可以走用户变量通道。我在任务里维护一组调试变量，周期性通过mpSetVarData写入整数变量，然后在示教器上直接监视这些变量数值。这样既不占用打印时间，也能在自动运行时观察内部状态。
int dbgState; int dbgErrorCode; void usrTask(void *arg) { for (;;) { dbgState = getState(); dbgErrorCode = getErrorCode(); /* 写入 I010 / I011 供示教器监视 */ mpSetVarData(MP_VAR_I, 10, &dbgState); mpSetVarData(MP_VAR_I, 11, &dbgErrorCode); mpTaskDelay(100); /* 100ms 刷新一次 */ } }这类变量刷新频率不能太快，一般 100ms 到 500ms 就足够。刷新太快不仅浪费 CPU，示教器画面肉眼也看不过来，反而干扰对状态的判断。
5. 跑稳 MotoPlus 应用：优先级、内存与清理节奏
最后一个章节讲几个特别容易被忽略的坑，都是现场出过问题的点。
5.1 任务优先级选择
任务优先级直接决定控制柜稳定性。正常业务放到MP_PRI_NORMAL，只有真正有硬实时要求的逻辑才考虑用带 CLOCK 或者 TIME_CRITICAL 的优先级，但这类任务必须极短，禁止在里面调用 print、文件 IO 和任何可能阻塞的系统调用。我习惯把实时性要求高的计算放到MP_PRI_IP_CLK_TAKE，函数体内只做简单运算，结果写到全局变量，由普通优先级任务负责后续通信和握手。
5.2 mpUsrRoot 的损耗控制
mpUsrRoot存在时间越短越好。创建完任务、信号量、邮箱就返回，如果需要在入口阶段做复杂初始化，可以放到用户任务里等待一个就绪信号量。千万不要用mpUsrRoot做主业务循环，它会抢占机器人控制时间，长时间占用超过 100μsec，轻则报警，重则系统关闭。
5.3 内存操作与看门狗
MotoPlus 里你可以像普通 C 程序一样使用指针，但指针错误会直接改写系统内存，表现就是系统挂起、伺服切断、示教器黑屏。排查这种问题非常被动，所以防御比技巧重要：
- 所有缓冲区访问前做边界检查。
- 使用 MotoPlus 提供的专用 malloc / mfree 管理受保护数据区域，避免直接操作大块系统堆。
- 开启用户看门狗服务，正常任务周期性喂狗，异常后系统可以自恢复或触发安全停止。
5.4 调试代码的清理节奏
这是现场事故最多的环节。TELNET 功能在项目调试结束后必须关掉，即把参数S2C1119设回 0。源码里所有printf、puts调试语句也应当删净，因为打印语句的处理时间会占用机器人实时控制的执行窗口。建议每次版本发布前强制执行三步：
- 全局搜索
printf、puts，删除或注释掉调试输出；确需保留的用宏包起来，并在正式版把宏展开为空。 - 关闭 TELNET 参数并断电重启，确认应用仍能正常运行。
- 整机连续空跑 30 分钟以上，观察系统报警记录里是否有处理超时、任务看门狗的条目。
这三步做完，再考虑把应用交付到产线。否则等到产线报警再来查，你都不知道问题是出在算法、通信还是那几行忘记删的打印语句上。
本文还有配套的精品资源，点击获取
