工业相机异常处理实战：断连重连、丢帧检测、超时恢复状态机

工业相机异常处理实战：断连重连、丢帧检测、超时恢复状态机

[🎯 工业相机异常处理实战：断连重连、丢帧检测、超时恢复状态机](#🎯 工业相机异常处理实战：断连重连、丢帧检测、超时恢复状态机)
- [🎯 核心目标](#🎯 核心目标)
- [🔄 推荐状态机设计（4 个状态）](#🔄 推荐状态机设计（4 个状态）)
- - 状态说明：
- [🛠️ 关键逻辑实现（伪代码 + 三大品牌适配）](#🛠️ 关键逻辑实现（伪代码 + 三大品牌适配）)
- [🔍 丢帧怎么检测？](#🔍 丢帧怎么检测？)
- - [▶ Basler：](#▶ Basler：)
  - [▶ 海康：](#▶ 海康：)
  - [▶ 堡盟：](#▶ 堡盟：)
- [⚠️ 重连注意事项](#⚠️ 重连注意事项)
- [✅ 效果对比](#✅ 效果对比)

🎯 工业相机异常处理实战：断连重连、丢帧检测、超时恢复状态机

相机一断就停机？用状态机搞定工业相机异常处理（附重连 + 丢帧 + 超时恢复）

产线上，相机因网线松动、供电波动、触发异常导致断连、丢帧、卡死 太常见。

但很多程序一出错就退出，必须人工干预------严重影响 OEE！

其实，用一个 轻量状态机，就能自动应对 90% 的异常场景。

🎯 核心目标

网线拔了 → 自动重连
偶尔丢帧 → 记录但不停机
连续超时 → 重启采集流
恢复后 → 自动加载原参数，继续工作

🔄 推荐状态机设计（4 个状态）

text 复制代码

[Idle] 
   ↓ (启动)
[Running] ←→ [TransientError]  
   ↓ (连续失败)
[Recovery] → (重连成功) → [Running]

状态说明：

Running：正常取图
TransientError：单次超时/丢帧，尝试重试（≤3 次）
Recovery：多次失败后，执行 Close → Reopen → 重设参数
Idle：初始或严重错误状态

🛠️ 关键逻辑实现（伪代码 + 三大品牌适配）

cpp 复制代码

enum State { IDLE, RUNNING, TRANSIENT_ERROR, RECOVERY };
State current_state = IDLE;
int retry_count = 0;
const int MAX_TRANSIENT_RETRY = 3;

while (running) {
    switch (current_state) {
        case RUNNING:
            ret = grab_frame_with_timeout(100); // 各品牌 timeout 设置见前文
            if (ret == OK) {
                check_frame_sequence(); // 检测丢帧（见下文）
                retry_count = 0;
            } else if (ret == TIMEOUT) {
                retry_count++;
                current_state = (retry_count <= MAX_TRANSIENT_RETRY) ? 
                                TRANSIENT_ERROR : RECOVERY;
            }
            break;

        case TRANSIENT_ERROR:
            std::this_thread::sleep_for(50ms);
            current_state = RUNNING; // 下次循环重试
            break;

        case RECOVERY:
            camera_stop_and_close();     // Basler: StopGrabbing+Close
                                     // 海康: StopGrabbing+Close+DestroyHandle
                                     // 堡盟: stopAcquisition+close
            std::this_thread::sleep_for(1000ms);
            
            if (reconnect_camera()) {    // 重新枚举设备 + Open
                reload_parameters();     // 恢复曝光、触发、PixelFormat 等
                camera_start_grabbing();
                current_state = RUNNING;
                log("✅ 相机恢复成功");
            } else {
                log("❌ 重连失败，等待 5 秒重试");
                std::this_thread::sleep_for(5000ms);
            }
            break;
    }
}

🔍 丢帧怎么检测？

工业相机通常支持 帧序号（BlockID / FrameID）：

▶ Basler：

cpp 复制代码

ptrGrabResult->GetBlockID(); // 递增，跳变即丢帧

▶ 海康：

cpp 复制代码

stInfo.nFrameNum; // 注意：部分型号需开启"帧号"功能

▶ 堡盟：

cpp 复制代码

buffer.getFrameID(); // GenICam 标准字段

✅ 检测逻辑：

cpp 复制代码

static uint64_t last_id = 0;
if (current_id != last_id + 1) {
    log("⚠️ 丢帧！期望 %llu，收到 %llu", last_id+1, current_id);
}
last_id = current_id;

⚠️ 重连注意事项

品牌	重连关键点
Basler	需调用 `EnumerateDevices()` 重新发现设备
海康	必须 `DestroyHandle` 后重建，否则句柄残留
堡盟	使用 `System::getSystems()` 重新扫描

💡 建议：重连时加 指数退避（1s → 2s → 4s），避免频繁冲击系统

✅ 效果对比

方案	异常恢复时间	是否需人工干预
无处理	永久停机	是
简单重试	5~10 秒	否（偶发有效）
状态机方案	2~5 秒	否（自动恢复）

✅ 总结：

工业相机不是"一直在线"的设备，
异常是常态，恢复是能力 。

用一个轻量状态机，

让视觉系统真正扛得住产线波动！