作者小小張日期2025-07-24 這篇博文不是“Hello World”而是一篇“Hello 三相機(jī) 串口 回調(diào) 外部觸發(fā)”的筆記。 如果你也正好被“?？倒I(yè)相機(jī) Python 多相機(jī)同步 串口發(fā)字符”的組合折磨過希望下面的 3000 字能幫你少掉幾根頭發(fā)。## 1. 需求背景一句話講清楚 **“電腦連 3 臺(tái)?？迪鄼C(jī)USB/GiGE 都行只要相機(jī)被外部信號(hào)觸發(fā)一次就立刻通過串口往外發(fā)一個(gè)字符3 臺(tái)相機(jī)互不干擾?！?*聽起來簡單過程卻踩了 5 個(gè)大坑1. ?？倒俜?Python Demo 只有單相機(jī)。2. Windows 下 Python 多相機(jī)回調(diào)容易“串臺(tái)”。3. 官方 SDK 的“外部觸發(fā)”必須**先關(guān)閉取流**才能配置否則報(bào)錯(cuò)。4. USB 相機(jī)與 GiGE 相機(jī) API 混用時(shí)枚舉順序每次啟動(dòng)都可能變。5. 串口句柄必須**在回調(diào)線程里重新判空**否則偶發(fā) OSError: exception: access violation。---## 2. 最終效果運(yùn)行腳本后控制臺(tái)出現(xiàn)串口就緒!!找到:3個(gè)相機(jī)usb相機(jī):0 相機(jī)名:正相機(jī) 相機(jī)序列號(hào): 18137521usb相機(jī):1 相機(jī)名:反相機(jī) 相機(jī)序列號(hào): 18137635usb相機(jī):2 相機(jī)名:帶相機(jī) 相機(jī)序列號(hào): 18138184默認(rèn)0/1/2代表 正/反/三 [3個(gè)相機(jī)] 如正確 輸入一個(gè)數(shù)字[按回車]:按回車后3 臺(tái)相機(jī)同時(shí)開始取流并進(jìn)入回調(diào)模式。此時(shí)用 PLC / 按鈕 / 信號(hào)發(fā)生器給相機(jī)觸發(fā)一次終端立刻出現(xiàn)1 M1 m1 O同時(shí)串口 COM3 會(huì)依次吐出字符 M、m、O對(duì)應(yīng) 0/1/2 號(hào)相機(jī)。按任意鍵退出相機(jī)會(huì)優(yōu)雅地關(guān)閉。---## 3. 關(guān)鍵實(shí)現(xiàn)拆解### 3.1 三相機(jī)枚舉 序列號(hào)綁定海康的 Python SDK 枚舉結(jié)果順序**不固定**用序列號(hào)硬綁定最穩(wěn)pythoncam1_nConnectionNum next(i for i in range(deviceList.nDeviceNum)if 18137521 in str(deviceList.pDeviceInfo[i]))cam2_nConnectionNum ...### 3.2 注冊(cè)回調(diào)的正確姿勢(shì)官方 Demo 里 RegisterImageCallBackEx 只能注冊(cè)一次多相機(jī)必須**每實(shí)例注冊(cè)一次**pythonCALL_BACK_0 FrameInfoCallBack(image_callback_0)CALL_BACK_1 FrameInfoCallBack(image_callback_1)CALL_BACK_2 FrameInfoCallBack(image_callback_2)cam.MV_CC_RegisterImageCallBackEx(CALL_BACK_0, None)cam2.MV_CC_RegisterImageCallBackEx(CALL_BACK_1, None)cam3.MV_CC_RegisterImageCallBackEx(CALL_BACK_2, None)### 3.3 觸發(fā)模式配置順序必須先 MV_CC_SetEnumValue(TriggerMode, MV_TRIGGER_MODE_OFF) 把觸發(fā)關(guān)掉再設(shè)置 TriggerSource, TriggerActivation 等參數(shù)最后 MV_CC_SetEnumValue(TriggerMode, MV_TRIGGER_MODE_ON)。否則設(shè)置會(huì)失敗返回 0x80000010參數(shù)無效。### 3.4 串口線程安全回調(diào)函數(shù)里直接 ser.write(...) 偶爾會(huì)崩加鎖 判空pythondef Ser_send(send_data):if ser and ser.is_open:try:ser.write(send_data.encode())except Exception as e:print(串口寫入失敗, e)---## 4. 完整代碼可直接運(yùn)行# -- coding: utf-8 -- r 實(shí)現(xiàn)功能: 打開3個(gè)?？倒I(yè)相機(jī) 回調(diào)模式 支持 網(wǎng)口gige USB 進(jìn)入回調(diào)后就串口輸出字符 支持外部觸發(fā) 備注:3個(gè)相機(jī)和1個(gè)串口同時(shí)打開才能正常運(yùn)行 名稱:小小張 python3.8 thonny import random import os,sys,time,msvcrt from ctypes import * #主要靠的ctypes 導(dǎo)C語言的包 sys.path.append(os.getenv(MVCAM_COMMON_RUNENV) /Samples/Python/MvImport) #運(yùn)行環(huán)境依賴?？档膒ython包 mvs4.5.1安裝后 可獨(dú)立運(yùn)行 from MvCameraControl_class import * R_list[M,N,m,n,O,S] # 打開 COM3波特率 1152008 數(shù)據(jù)位無校驗(yàn)1 停止位超時(shí) 0.5 秒 import serial serserial.Serial(COM3,115200,bytesizeserial.EIGHTBITS,parityserial.PARITY_NONE,stopbitsserial.STOPBITS_ONE,timeout0.5) #winsows系統(tǒng)使用com連接串行口 if (ser.isOpen()):print(串口就緒!!) def port_close(): ser.close() if (ser.isOpen()): print(關(guān)閉失敗) def Ser_send(send_data): if (ser.isOpen()): ser.write(send_data.encode(utf-8)) #utf-8 編碼發(fā)送 #ser.write(binascii.a2b_hex(send_data)) #Hex發(fā)送 return send_data r flag_a False flag_b False flag_c False # 函數(shù) A每次調(diào)用將 flag_a 取反 #【新增三相機(jī)回調(diào)函數(shù)定義】 winfun_ctype WINFUNCTYPE stFrameInfo POINTER(MV_FRAME_OUT_INFO_EX) pData POINTER(c_ubyte) FrameInfoCallBack winfun_ctype(None, pData, stFrameInfo, c_void_p) #C指針轉(zhuǎn)成 py對(duì) # 0 號(hào)相機(jī)的回調(diào) def image_callback_0(pData, pFrameInfo, pUser): global flag_a flag_a not flag_a stFrameInfo cast(pFrameInfo, POINTER(MV_FRAME_OUT_INFO_EX)).contents if stFrameInfo: print(f {stFrameInfo.nFrameNum1} {Ser_send(M)} ) # 1 號(hào)相機(jī)的回調(diào) def image_callback_1(pData, pFrameInfo, pUser): global flag_b flag_b not flag_b stFrameInfo cast(pFrameInfo, POINTER(MV_FRAME_OUT_INFO_EX)).contents if stFrameInfo: print(f {stFrameInfo.nFrameNum1} {Ser_send(m)} ) #random.choice([O, S]) # 2 號(hào)相機(jī)的回調(diào) def image_callback_2(pData, pFrameInfo, pUser): global flag_c flag_c not flag_c stFrameInfo cast(pFrameInfo, POINTER(MV_FRAME_OUT_INFO_EX)).contents if stFrameInfo: print(f {stFrameInfo.nFrameNum1} {Ser_send(O)} ) CALL_BACK_0 FrameInfoCallBack(image_callback_0) CALL_BACK_1 FrameInfoCallBack(image_callback_1) CALL_BACK_2 FrameInfoCallBack(image_callback_2) # if __name__ __main__: # ch:初始化SDK | en: initialize SDK MvCamera.MV_CC_Initialize() deviceList MV_CC_DEVICE_INFO_LIST() tlayerType (MV_GIGE_DEVICE | MV_USB_DEVICE | MV_GENTL_CAMERALINK_DEVICE | MV_GENTL_CXP_DEVICE | MV_GENTL_XOF_DEVICE) # ch:枚舉設(shè)備 | en:Enum device ret MvCamera.MV_CC_EnumDevices(tlayerType, deviceList) if ret ! 0: print(枚舉設(shè)備0個(gè)) if deviceList.nDeviceNum 0: input(枚舉設(shè)備0個(gè):) print (f找到:{deviceList.nDeviceNum}個(gè)相機(jī)) for i in range(0, deviceList.nDeviceNum): mvcc_dev_info cast(deviceList.pDeviceInfo[i], POINTER(MV_CC_DEVICE_INFO)).contents if mvcc_dev_info.nTLayerType MV_GIGE_DEVICE or mvcc_dev_info.nTLayerType MV_GENTL_GIGE_DEVICE: print (\ngige device: [%d] % i) strModeName for per in mvcc_dev_info.SpecialInfo.stGigEInfo.chModelName: if per 0: break strModeName strModeName chr(per) print (device model name: %s % strModeName) nip1 ((mvcc_dev_info.SpecialInfo.stGigEInfo.nCurrentIp 0xff000000) 24) nip2 ((mvcc_dev_info.SpecialInfo.stGigEInfo.nCurrentIp 0x00ff0000) 16) nip3 ((mvcc_dev_info.SpecialInfo.stGigEInfo.nCurrentIp 0x0000ff00) 8) nip4 (mvcc_dev_info.SpecialInfo.stGigEInfo.nCurrentIp 0x000000ff) print (current ip: %d.%d.%d.%d\n % (nip1, nip2, nip3, nip4)) elif mvcc_dev_info.nTLayerType MV_USB_DEVICE:# 這里usb 開始 print (fusb相機(jī):{i}) strModeName for per in mvcc_dev_info.SpecialInfo.stUsb3VInfo.chModelName: if per 0: break strModeName strModeName chr(per) print (f相機(jī)名:{strModeName}) strSerialNumber for per in mvcc_dev_info.SpecialInfo.stUsb3VInfo.chSerialNumber: if per 0: break strSerialNumber strSerialNumber chr(per) print (f相機(jī)序列號(hào): {strSerialNumber}) pass# usb 在這 elif mvcc_dev_info.nTLayerType MV_GENTL_CAMERALINK_DEVICE: print (\nCML device: [%d] % i) strModeName for per in mvcc_dev_info.SpecialInfo.stCMLInfo.chModelName: if per 0: break strModeName strModeName chr(per) print (device model name: %s % strModeName) strSerialNumber for per in mvcc_dev_info.SpecialInfo.stCMLInfo.chSerialNumber: if per 0: break strSerialNumber strSerialNumber chr(per) print (user serial number: %s % strSerialNumber) elif mvcc_dev_info.nTLayerType MV_GENTL_CXP_DEVICE: print (\nCXP device: [%d] % i) strModeName for per in mvcc_dev_info.SpecialInfo.stCXPInfo.chModelName: if per 0: break strModeName strModeName chr(per) print (device model name: %s % strModeName) strSerialNumber for per in mvcc_dev_info.SpecialInfo.stCXPInfo.chSerialNumber: if per 0: break strSerialNumber strSerialNumber chr(per) print (user serial number: %s % strSerialNumber) elif mvcc_dev_info.nTLayerType MV_GENTL_XOF_DEVICE: print (\nXoF device: [%d] % i) strModeName for per in mvcc_dev_info.SpecialInfo.stXoFInfo.chModelName: if per 0: break strModeName strModeName chr(per) print (device model name: %s % strModeName) strSerialNumber for per in mvcc_dev_info.SpecialInfo.stXoFInfo.chSerialNumber: if per 0: break strSerialNumber strSerialNumber chr(per) print (user serial number: %s % strSerialNumber) print (f默認(rèn)0/1/2代表 正/反/三 [3個(gè)相機(jī)] 如正確 輸入一個(gè)數(shù)字[按回車]:) print (f不正確 請(qǐng)修改順序) nConnectionNum input(默認(rèn)0/1/2代表 正/反/三 [3個(gè)相機(jī)] 如果正確 輸入0[按回車]:) if int(nConnectionNum) deviceList.nDeviceNum: print (intput error!) # ch:創(chuàng)建相機(jī)實(shí)例 | en:Creat Camera Object cam MvCamera();cam2 MvCamera();cam3 MvCamera() r 串口就緒!! 找到:3個(gè)相機(jī) usb相機(jī):0 相機(jī)名:正相機(jī) 相機(jī)序列號(hào): 18137521 usb相機(jī):1 相機(jī)名:反相機(jī) 相機(jī)序列號(hào): 18137635 usb相機(jī):2 相機(jī)名:帶相機(jī) 相機(jī)序列號(hào): 18138184 相機(jī)名:正相機(jī)0 相機(jī)名:反相機(jī)1 相機(jī)名:帶相機(jī)2 根據(jù)情況修改下面3個(gè)參數(shù) 從而實(shí)現(xiàn)相機(jī)對(duì)應(yīng) cam1_nConnectionNum0 cam2_nConnectionNum1 cam3_nConnectionNum2 # ch:選擇設(shè)備并創(chuàng)建句柄 | en:Select device and create handle stDeviceList cast(deviceList.pDeviceInfo[int(cam1_nConnectionNum)], POINTER(MV_CC_DEVICE_INFO)).contents ret cam.MV_CC_CreateHandle(stDeviceList) stDeviceList2 cast(deviceList.pDeviceInfo[int(cam2_nConnectionNum)], POINTER(MV_CC_DEVICE_INFO)).contents ret cam2.MV_CC_CreateHandle(stDeviceList2) stDeviceList3 cast(deviceList.pDeviceInfo[int(cam3_nConnectionNum)], POINTER(MV_CC_DEVICE_INFO)).contents ret cam3.MV_CC_CreateHandle(stDeviceList3) #【新增打開三相機(jī)】 ret cam.MV_CC_OpenDevice(MV_ACCESS_Exclusive, 0) if ret ! 0: print (f1相機(jī)已經(jīng)打開) ret cam2.MV_CC_OpenDevice(MV_ACCESS_Exclusive, 0) if ret ! 0: print (f2相機(jī)已經(jīng)打開) ret cam3.MV_CC_OpenDevice(MV_ACCESS_Exclusive, 0) if ret ! 0: print (f3相機(jī)已經(jīng)打開) # # ch:探測(cè)網(wǎng)絡(luò)最佳包大小(只對(duì)GigE相機(jī)有效) | en:Detection network optimal package size(It only works for the GigE camera) if stDeviceList.nTLayerType MV_GIGE_DEVICE or stDeviceList.nTLayerType MV_GENTL_GIGE_DEVICE: nPacketSize cam.MV_CC_GetOptimalPacketSize() if int(nPacketSize) 0: ret cam.MV_CC_SetIntValue(GevSCPSPacketSize,nPacketSize) if ret ! 0: print (Warning: Set Packet Size fail! ret[0x%x] % ret) else: print (Warning: Get Packet Size fail! ret[0x%x] % nPacketSize) r input(任意鍵繼續(xù)) # ch:設(shè)置觸發(fā)模式為off | en:Set trigger mode as off #設(shè)置觸發(fā)模式 #設(shè)置 觸發(fā)極性 #設(shè)置 觸發(fā) 消抖時(shí)間 #設(shè)置 相機(jī)的相關(guān)參數(shù) # 設(shè)置曝光# 設(shè)置增益 exposureTime130;gain11; fValue 30; for h in [cam, cam2, cam3]: h.MV_CC_SetEnumValue(TriggerMode, MV_TRIGGER_MODE_OFF)#3相機(jī)觸發(fā)模式 h.MV_CC_SetBoolValue(TriggerCacheEnable, True);# 憑感覺 打開這個(gè) 可以緩存一個(gè)觸發(fā)信號(hào) h.MV_CC_SetFloatValue(ExposureTime, float(exposureTime)) h.MV_CC_SetFloatValue(Gain, float(gain)) h.MV_CC_SetFloatValue(AcquisitionFrameRate, float(fValue));#設(shè)置相機(jī)30幀 #h.MV_CC_SetEnumValue(TriggerMode, 1)#觸發(fā)模式打開 #h.MV_CC_SetEnumValue(TriggerSource, 7)#觸發(fā)線路Line0 #h.MV_CC_SetEnumValue(TriggerActivation, 0)#觸發(fā)極性 上升沿 #參數(shù) 采集控制 r 開硬件觸發(fā) 虛擬相機(jī)肯定不進(jìn)回調(diào) #【新增為三相機(jī)分別注冊(cè)回調(diào)】 cam.MV_CC_RegisterImageCallBackEx(CALL_BACK_0, None) cam2.MV_CC_RegisterImageCallBackEx(CALL_BACK_1, None) cam3.MV_CC_RegisterImageCallBackEx(CALL_BACK_2, None) # #【新增三相機(jī)同時(shí)開始取流】 cam.MV_CC_StartGrabbing();cam2.MV_CC_StartGrabbing();cam3.MV_CC_StartGrabbing() # # 只要不開始取流 mvs可以設(shè)置的參數(shù)都可以設(shè) # 打開相機(jī)后停止取流狀態(tài)可以mvs可以設(shè)置的參數(shù)都可以設(shè) # 有些參數(shù) 開始取流 或取流過程中也可以設(shè)置 # 讀取參數(shù) 只要相機(jī)打開就能讀. print (按任意鍵 停止取流!) msvcrt.getch()# # 阻塞 #【新增三相機(jī)同時(shí)停止取流】 cam.MV_CC_StopGrabbing();cam2.MV_CC_StopGrabbing();cam3.MV_CC_StopGrabbing() # #【新增三相機(jī)同時(shí)關(guān)閉并銷毀】 cam.MV_CC_CloseDevice();cam2.MV_CC_CloseDevice();cam3.MV_CC_CloseDevice() cam.MV_CC_DestroyHandle();cam2.MV_CC_DestroyHandle();cam3.MV_CC_DestroyHandle() # MvCamera.MV_CC_Finalize()# ch:反初始化SDK---## 5. FAQ| 問題 | 解決思路 ||---|---|| **枚舉不到 USB 相機(jī)** | 確認(rèn)已安裝 MVS 4.5.1并在“設(shè)備管理器”里能看到 Hikrobot Industrial Camera。 || **回調(diào)不觸發(fā)** | 先確認(rèn)相機(jī)真的被外部觸發(fā)MVS 客戶端里能看到幀計(jì)數(shù)再檢查 TriggerSource 是否和硬件接線一致。 || **串口發(fā)字符亂碼** | ser.write(M.encode(utf-8)) 用 utf-8 編碼接收端也請(qǐng)用相同編碼。 || **退出時(shí)卡死** | 先 StopGrabbing 再 CloseDevice順序反了會(huì)阻塞。 |---## 6. 下一步可以做什么- 把 M/m/O 換成 JSON帶上時(shí)間戳方便上位機(jī)解析。- 用 asyncio pyserial-asyncio 做異步串口減少阻塞。- 把觸發(fā)信號(hào)改成軟觸發(fā)用 Python 直接 MV_CC_SetCommandValue(TriggerSoftware) 做時(shí)序同步。--- 如果文章幫到了你歡迎點(diǎn)個(gè) ?Star 或留言交流 也歡迎把需求扔給我。