一、手眼标定
先分清 Eye-to-Hand（固定相机）/Eye-in-Hand（相机装法兰）
Eye-to-Hand：相机固定机架，标定板在机器人抓取空间内，标定姿态必须覆盖整个工作视野，远近、高低、多角度，8~12 个分散姿态，不要只在一小块区域采点，否则边缘误差巨大
Eye-in-Hand：相机随法兰动，海康 VM3D 里选对应手眼模型；标定期间机器人不能有抖动、夹具不能松动，标定板本身平面度要高
标定环境必须和生产工况一致：光照、温度、震动、相机高度，标定的时候是什么样，生产就什么样；标定完不要动相机支架、不要松法兰螺丝，一动必须重标
顺序不能乱：先相机内参标定（海康 3D 自带）→再手眼外参标定；不要直接拿 2D 九点标定代替 3D 手眼，3D 是 6 自由度（X/Y/Z/A/B/C），2D 只有平面偏移，姿态会错
标定后验证：用 TCP（工具中心点）去碰标定板特征点，在视野中心、视野四角分别验证 Z 向高度，Z 是 3D 最容易飘的轴
二、通讯方案（库卡 KSS，KRC4/KRC5）
库卡直接和海康 3D 通讯，主流 3 种：Socket（EthernetKRL）、Profinet、PLC 中转
Socket（EthernetKRL）：最常用，必须确认机器人有 EthernetKRL 选项包，没有就不能直接开 Socket 收发；KSS8.2/8.5 版本兼容性不一样，老版本容易丢包、断连
数据格式统一：海康 VM3D 输出6 维位姿 X,Y,Z,A,B,C（欧拉角，注意库卡是 XYZABC，角度顺序、旋转定义一定要对齐！海康和库卡欧拉角顺序
约定握手协议：机器人发【拍照触发】→海康采集 + 点云处理→返回【有效位姿 / 失败码】→机器人收到后再走偏移抓取；必须加超时、心跳、失败标记，相机没识别到工件时不能传脏坐标给机器人
Profinet：实时性更好，适合高速；海康 3D 智能相机做 Profinet 从站，库卡 Profinet 主站；注意设备名、GSDML 版本匹配，过程数据区定义好状态位、结果位、故障位
不推荐直接裸跑无握手：不要视觉持续往外发坐标，机器人循环读；极易出现：上一帧旧坐标覆盖新坐标、工件已经拿走机器人还抓旧位置
网络隔离：视觉单独千兆交换机，相机、工控机、机器人控制器同网段；** jumbo 帧建议 9014（海康 3D 大尺寸点云）**，不要和其他设备混在普通局域网，避免丢点云、卡顿海康机器人
三、硬件安装与机械结构
Eye-in-Hand（相机装法兰）：
线缆用机器人专用拖链 M12 航空插头，避免反复弯折断线；相机自重算进机器人负载，不要超额定载荷，重心偏移会影响 TCP 精度
预留防撞：相机突出夹具，优先撞相机，加防撞缓冲，否则直接撞坏镜头
Eye-to-Hand 固定安装：支架厚重、打膨胀螺丝，杜绝震动；振动会直接让点云噪点暴涨、标定漂移
相机工作距离：严格卡在海康规格书的工作区间（最近 / 最远），离太近、太远，Z 精度断崖下跌；视野刚好包住料箱，不要盲目做大视野，视野越大精度越低
接地：相机、工控机、库卡控制柜、机架共地，防止电位差导致的随机丢包、噪点、相机重启
四、光学与环境
结构光 / 激光 3D：强光直射、阳光、车间频闪灯、焊接弧光、反光工件（铝、不锈钢）是头号杀手
反光件：用偏振片、调整相机入射角度、多曝光融合；不要让激光直接镜面反射回相机
环境光稳定：尽量封闭遮光；如果现场自然光变化大，加遮光罩
材质影响：深色吸光、透明件、高反光件，提前在 VM3D 调曝光、增益、ROI，多曝光模式
激光安全：激光 3D 注意防护等级，现场人员防护，合规，避免激光入眼
五、库卡程序、坐标系、偏移逻辑
分清：基坐标系 $ROBROOT、工具坐标系 TOOL、视觉坐标系
海康返回的位姿，是【相机坐标系→机器人基坐标系】的 6 维变换；库卡用
frame或者POS接收，欧拉角顺序、旋转方向必须统一（ extrinsic/intrinsic），海康默认欧拉角经常和库卡不一样，角度错了抓取直接翻视觉偏移优先用
$base或者TOOL偏移，不要随便叠加多个偏移，叠加多了误差链放大奇点、可达性：视觉返回的姿态，一定要先在程序里做可达性判断、奇点判断；无序抓取经常返回一个机器人到不了的姿态，不加判断直接跑会撞机
抓取前加安全接近点：不要直接飞到视觉坐标；先到安全高度，再直线下降抓取，
LIN直线运动，不要用PTP点到点，姿态容易跑偏夹具 TCP 提前标定好：夹具吸盘 / 夹爪 TCP 不准，视觉标定再准也抓不准；TCP 标定是前提
六、安全联锁
视觉故障、拍照超时、工件识别失败、点云无效 → 机器人必须停止抓取，报警，不能继续执行偏移
安全信号分开：视觉 IO / 通讯信号是工艺信号，不能替代库卡安全总线（PROFIsafe）、安全门、安全光栅
自动模式下，每次拍照前，机器人要确认在安全等待位，相机视野内无人员干涉
七、精度与误差链
误差传递顺序：相机内参 → 手眼标定 → 点云匹配 (ICP) → 机器人本体精度 → 夹具 TCP
无序料箱抓取：ICP 粗配准失败（工件重叠、遮挡、特征太少），视觉返回的姿态本身就错，不是标定问题；VM3D 里要做遮挡过滤、抓取点优选
温度漂移：长时间连续生产，温度变化，法兰、支架热胀冷缩，Z 方向慢慢飘；高精度场景需要定期标定补偿或定时基准校验
节拍：3D 点云处理耗时远大于 2D，在 VM3D 里面控制点云 ROI，裁剪无关背景，降低点云数量，提升处理速度，避免节拍不匹配
八、版本与兼容性、调试清单
版本匹配：海康 3DMVS/VM3D 固件版本、相机固件、库卡 KSS 版本；KRC4 老 KSS8.2 和新版 VM3D 对接偶发解析异常
调试顺序
机器人 TCP、基坐标标定完成
相机光学调试，点云干净、噪点可控
手眼标定，保存标定文件，记录重投影误差
通讯握手单步测试：触发→拍照→返回坐标→机器人接收解析
单点验证（视野中心 + 四角）
小批量试跑，统计误差，区分是视觉误差还是机器人机械误差
异常分支：超时、无工件、点云异常、通讯断连
九、总结
欧拉角顺序不一致 → 工件抓歪、翻转
标定点位只集中在视野中间 → 边缘抓取不准
没有握手，视觉一直发坐标 → 抓上一个工件位置
Eye-in-Hand 没算负载重心 → 精度漂移、报警超载
强光 / 反光不做遮光偏振 → 点云乱、识别不稳定
把工艺通讯信号当成安全信号 → 安全风险。
