简介《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 主 CPUACP01 基板上由 VxWorks 实时系统调起来作为原生任务和系统程序一起跑。不用买额外硬件处理速度也快。这个环境主要面向集成商和熟悉 C 的机器人工程师学习曲线比想像中平缓但坑也不少。2. MotoPlusIDE 装完以后项目创建与构建参数2.1 硬件连接与软件版本开发用的电脑要求不高。CPU 1GHz内存 1GB硬盘 40GB 空余Windows XP SP2 / Vista / Win732 位都在支持列表里实际用更高的配置也兼容。连接时有两种链路要分清调试链路走 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/writeint 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 分钟以上观察系统报警记录里是否有处理超时、任务看门狗的条目。这三步做完再考虑把应用交付到产线。否则等到产线报警再来查你都不知道问题是出在算法、通信还是那几行忘记删的打印语句上。本文还有配套的精品资源点击获取