点位管理
点位管理用于保存机器人关节位置或 TCP 位姿。示教、离线路径设计和批量导入点位时使用,执行前仍需验证坐标系、单位和可达性。
点位内容
| 字段 | 说明 |
|---|---|
| 名称 | 项目内用于识别点位的唯一名称 |
| 类型 | 关节点位或笛卡尔点位 |
| 关节值 | 各关节位置,保存单位为弧度 |
| TCP 位姿 | X、Y、Z 和 Rx、Ry、Rz;位置用毫米,点位库姿态用弧度 |
| 坐标系 | World、Base、工具或工件坐标系名称 |
| 工具 | 记录点位时使用的工具名称 |
| 分组和备注 | 用于组织和说明点位 |
单位对照
现场 SCL 运动入口按 API 合同使用另一套姿态单位:
| 数据 | 点位库 / CSV | robot.MoveJ / robot.MoveL / MC_MOVE_* |
|---|---|---|
| X / Y / Z | 毫米 | 毫米 |
| Rx / Ry / Rz | 弧度(导入界面可按度解释) | 度 |
| J1..Jn | 弧度 | 不作为 MoveJ/MoveL 参数;由 IK 计算 |
生成程序前必须把点位库中的姿态换成度,不能把弧度直接填进运动调用。
创建与更新
- 连接机器人或打开仿真模型。
- 选择正确的工具和坐标系。
- 点动到目标位置。
- 记录当前位置并输入名称、分组和备注。
- 在 3D 视口核对点位位置与姿态。
- 真机低速返回该点位,确认关节构型和工具间隙。
更新现有点位前应保留原值或提交项目版本,避免一个点位改动影响多条路径。
关节点位与笛卡尔点位
| 类型 | 适用场景 | 注意事项 |
|---|---|---|
| 关节点位 | Home、折叠姿态、安全过渡姿态 | 与具体机械构型强绑定,换机器人后必须重验 |
| 笛卡尔点位 | 取放、焊接、装配等工作点 | 依赖运动学、工具和工件坐标系,可能有多组逆解 |
工作点优先记录在工件坐标系中;Home 和大范围过渡姿态通常用关节点位更清晰。
CSV 导入
当前通用 CSV 列顺序为:
name,x,y,z,rx,ry,rz,j1,j2,j3,j4,j5,j6,group,comment
Home,,,,,,,0.0,-1.5708,1.5708,0.0,-1.5708,0.0,home,折叠姿态
Pick,450.0,0.0,420.0,3.1416,0.0,3.1416,,,,,,,work,取料位
- X、Y、Z 使用毫米。
- Rx、Ry、Rz 默认使用弧度;导入界面可选择按度解释。
- J1 到 J6 使用弧度。
- 一行既没有 TCP 位姿也没有关节值时会被跳过。
- 非有限数值会被拒绝,不会替换成零。
JSON 导入
当前也支持通用 JSON 点位数组,以及外层包含 points 的 JSON 对象。导入时可选择:
- 改名:默认策略,重名时添加后缀。
- 跳过:保留已有点位。
- 覆盖:由上层合并时替换同名点位。
当前不支持从其他厂商工程文件直接导入点位。需要迁移时请先转换为通用 CSV 或 JSON,并人工核对单位、姿态约定和坐标系。RAPID / KRL / INFORM / Fanuc TP 工程导入属于产品边界外能力。
与运动程序的边界
当前 robot.MoveJ 和 robot.MoveL 接收数值位姿,不能直接使用字符串点名。生成程序前应先把点位解析为数值,并把姿态从弧度换成度。
// 点位库 Pick = (450 mm, 0, 420 mm, π, 0, π rad)
// 生成现场调用时姿态改为度:
Rc = robot.MoveL(0, 450.0, 0.0, 420.0, 180.0, 0.0, 180.0, 30.0);
验证清单
- 点位名称不重复。
- 关节数与机器人轴数一致。
- 角度单位没有把度当弧度,也没有把弧度直接写进 SCL。
- TCP 位姿对应正确的工具和工件坐标系。
- 逆运动学有解,关节值在软限位内。
- MoveJ 的中间关节路径和 MoveL 的整条直线路径均已检查。
- 真机首次返回点位时使用低速度倍率。
仿真不是安全证明
点位在 3D 视口中看起来正确,不代表真机安全。真机返回点位仍需低速度倍率、硬件急停和操作员确认。