当前位置：首页 > news >正文

工业相机“心跳”监测脚本（C++版）支持海康 / Basler / 堡盟工业相机

news 2026/7/14 19:32:17

工业相机“心跳”监测脚本（C++版）支持海康 / Basler / 堡盟，一套代码搞定多品牌在线状态监控！

“产线半夜停机，发现相机离线了？”
“PLC 发了触发信号，但相机没反应？”
“现场网络一抖，相机就‘假死’？”

在工业视觉系统中，相机的在线状态是整个检测流程的基石。然而，不同品牌的相机 SDK 各有千秋，如何用统一、高效、低开销的方式监控它们的“心跳”？

本文将为你揭晓答案，并提供一份可直接复用的 C++ 跨平台心跳监测脚本，完美支持海康（Hikvision）、Basler、堡盟（Baumer）三大主流品牌。

🤔 一、什么是“心跳”？为什么需要它？

心跳（Heartbeat）：指定期向相机发送一个轻量级指令（如读取设备信息），并等待其响应。
目的：
- 实时感知相机是否在线。
- 提前预警网络中断或相机异常。
- 避免因相机“假死”导致的产线长时间停机。

💡关键点：心跳操作必须极其轻量，不能干扰正常的图像采集流程。

🔧 二、各品牌 SDK 的心跳实现方式

品牌	SDK	心跳方法	注意事项
海康 (Hikvision)	MVS SDK	`MV_CC_GetDeviceInfo()`	需要先打开设备句柄，调用后立即释放。
Basler	Pylon SDK	`CInstantCamera::GetDeviceInfo()`	可以在不开启流的情况下获取信息。
堡盟 (Baumer)	BGAPI SDK	`BGAPI2::Device::GetModel()`	设备对象保持打开即可，调用非常快。

💻 三、核心代码：跨品牌心跳监测器

我们使用C++17和策略模式，将不同品牌的实现细节封装起来。

1. 定义通用接口 (`ICameraHeartbeat.h`)

// ICameraHeartbeat.h#pragmaonce#include<string>#include<chrono>classICameraHeartbeat{public:virtual~ICameraHeartbeat()=default;// 初始化连接virtualboolConnect(conststd::string&deviceID)=0;// 执行一次心跳检查virtualboolPing()=0;// 断开连接virtualvoidDisconnect()=0;// 获取最后一次心跳的时间戳std::chrono::steady_clock::time_pointGetLastPingTime()const{returnlast_ping_time_;}// 获取品牌名称virtualstd::stringGetBrandName()const=0;protected:std::chrono::steady_clock::time_point last_ping_time_;};

2. 海康相机实现 (`HikHeartbeat.cpp`)

// HikHeartbeat.cpp#include"ICameraHeartbeat.h"#include"MvCameraControl.h"// 海康MVS SDK头文件classHikHeartbeat:publicICameraHeartbeat{public:boolConnect(conststd::string&deviceID)override{// 通过设备ID查找并打开设备MV_CC_DEVICE_INFO_LIST stDevList;MV_CC_EnumDevices(MV_GIGE_DEVICE,&stDevList);for(inti=0;i<stDevList.nDeviceNum;i++){MV_CC_DEVICE_INFO*pDevInfo=stDevList.pDeviceInfo[i];if(/* 匹配deviceID */){nRet=MV_CC_CreateHandle(&handle_,pDevInfo);if(nRet==MV_OK){nRet=MV_CC_OpenDevice(handle_);returnnRet==MV_OK;}}}returnfalse;}boolPing()override{MV_CC_DEVICE_INFO stDevInfo;intnRet=MV_CC_GetDeviceInfo(handle_,&stDevInfo);last_ping_time_=std::chrono::steady_clock::now();return(nRet==MV_OK);}voidDisconnect()override{if(handle_){MV_CC_CloseDevice(handle_);MV_CC_DestroyHandle(handle_);handle_=nullptr;}}std::stringGetBrandName()constoverride{return"Hikvision";}private:void*handle_=nullptr;};

3. Basler 相机实现 (`BaslerHeartbeat.cpp`)

// BaslerHeartbeat.cpp#include"ICameraHeartbeat.h"#include<pylon/PylonIncludes.h>classBaslerHeartbeat:publicICameraHeartbeat{public:boolConnect(conststd::string&deviceID)override{try{Pylon::CTlFactory&TlFactory=Pylon::CTlFactory::GetInstance();camera_=newPylon::CInstantCamera(TlFactory.CreateFirstDevice());// 这里可以根据deviceID进行更精确的匹配camera_->Open();returntrue;}catch(constGenICam::GenericException&){returnfalse;}}boolPing()override{try{// 即使相机未开启流，也能获取设备信息autoinfo=camera_->GetDeviceInfo();last_ping_time_=std::chrono::steady_clock::now();returntrue;}catch(constGenICam::GenericException&){returnfalse;}}voidDisconnect()override{if(camera_&&camera_->IsOpen()){camera_->Close();}deletecamera_;camera_=nullptr;}std::stringGetBrandName()constoverride{return"Basler";}private:Pylon::CInstantCamera*camera_=nullptr;};

4. 主监控循环

// main.cpp#include<thread>#include<chrono>#include<memory>#include<iostream>voidHeartbeatMonitorLoop(std::unique_ptr<ICameraHeartbeat>camera,intinterval_ms){while(true){boolisAlive=camera->Ping();autonow=std::chrono::steady_clock::now();autolast=camera->GetLastPingTime();autodiff=std::chrono::duration_cast<std::chrono::milliseconds>(now-last).count();if(!isAlive){std::cout<<"["<<camera->GetBrandName()<<"] 心跳失败！离线超过 "<<diff<<" ms"<<std::endl;// 此处可集成企业微信/邮件告警}else{std::cout<<"["<<camera->GetBrandName()<<"] 心跳正常 ("<<diff<<" ms)"<<std::endl;}std::this_thread::sleep_for(std::chrono::milliseconds(interval_ms));}}intmain(){// 示例：监控一台海康相机autohik_camera=std::make_unique<HikHeartbeat>();if(hik_camera->Connect("Your_Hik_Device_ID")){std::thread(HeartbeatMonitorLoop,std::move(hik_camera),1000).detach();}// 主程序继续执行其他任务...while(true){/* ... */}}