XS3D 常见故障排除

1. 设备枚举不到

1. 检查网线与网口指示灯
2. 确认工控机网卡与相机在同一网段（相机默认 IP 见铭牌）
3. 防火墙放行 GigE Vision 端口，或临时关闭防火墙测试
4. 千兆网卡协商速率应为 1000Mbps（100Mbps 带宽不足会丢帧）

2. 轮廓数据异常（断线 / 跳变）

• 被测面强反光或深色吸光区域会丢失轮廓 → 调整曝光与激光功率
• Halo（光晕）干扰 → 在 UC3DStudio 中启用光晕去除（多档模式）
• 环境光过强 → 加遮光罩

3. 测量值抖动大

• 确认相机与支架机械紧固
• 检查触发信号是否稳定（编码器抖动会引入扫描相位误差）
• 数据噪声可用点云滤波（如双边滤波）改善，但注意不要把真实特征滤掉

4. SDK 调用报错

调用顺序必须遵守 SDK 约束，最常见的是 KSJXS_GetRoi 必须在 KSJXS_SetDataFormat 之后调用，详见 SDK 章节。