MP Color Camera SDK for Python (Linux) - Documentation

Introduction

This is a MP Color Camera SDK support for Python with Linux operating system.

This basically provide an interface to API's of "MP Color Camera SDK for Linux" to python applications.

Installation - MP Color Camera SDK for Python package

Install MP Color Camera SDK for Python package using following command from Linux terminal.

"sudo dpkg -i bioptic_color_camera_sdk_python3.6_1.0.1_x86_64bit.deb"

Un-Install MP Color camera SDK for python package using following command from Linux terminal.

"sudo dpkg -r zebraCamera"

ZebraDeviceManager Class

use ZebraDeviceManager class used for following operation as follows :

1) Create and delete color camera Instance.

file - ZebraCamera.py
 
def createCameraInstance(self):
""" Enumerate and Create camera instance """
...
...
 
def deleteCameraInstance(self):
"""Delete camera instance"""
...
...

2) add / Remove Device Manager Event Listener.

file - ZebraCamera.py
 
def addDeviceEventListner(self,att_handler,dtt_handler):
""" Add USB Event Listener """
...
...
 
def removeDeviceEventListner(self,att_handler,dtt_handler):
""" Remove USB Event Listener """
...
...

3) Start / Stop Device Manager.

file - ZebraCamera.py
def startDeviceManager(self):
""" Start USB device Manager and SDK event Listener """
...
...
 
def stopDeviceManager(self):
""" Stop USB device Manager and SDK event Listener """
...
...

ZebraImageManager Class

use ZebraImageManager class used for following operation as follows :

Start and Stop the color camera with Add/remove the respective Image event listener.

file - ZebraCamera.py
 
def addContinuesImageEventListner(self,handler):
""" Add Continues Image Listener """
...
...
 
def removeContinuesImageEventListner(self,handler):
""" Remove Continues Image Listener """
...
...
 
 
def startImageManager(self):
""" This function used to add Image event listener"""
...
...
 
def stopImageManager(self):
""" This function used to remove Image event listener"""
...
...

ZebraMonochromeManager Class

use ZebraMonochromeManager class used for following operation as follows :

1) Start and Stop the Monochrome camera for register and un-register Image event listener.

file - ZebraCamera.py
 
 
def addMonoChromeImageListner(self):
""" add Monochrome Image Listener """
...
...
 
def removeMonoChromeImageListner(self):
""" remove Monochrome Image Listener """
...
...
 
def startMonochromeManager(self):
""" This function used to register Image event listener with Camera SDK """
...
...
 
def stopMonochromeManager(self):
""" This function used to Un-register Image event listener with Camera SDK """
...
...

ZebraFirmwareManager Class

use ZebraFirmwareManager class used for following operation as follows :

1) Start and Stop the firmware download process and add listener for image download status events.

file - ZebraCamera.py
 
def addFirmwareDownloadListner(self):
""" add firmware download Listener """
...
...
 
def removeFirmwareDownloadListner(self):
""" Remove firmware download Listener """
...
...
 
def startFirmwareManager(self):
""" This function used to start firmware Download event listener and process."""
...
...
 
def stopFirmwareManager(self):
""" This function used to stop firmware Download event listener and process."""
...
...

2) Start Software installer for Color camera

file - ZebraCamera.py
 
def firmwareInstall(self):
""" Install camera firmware """
...
...

Sample zcamConfig.json

This is configuration file used by "MP Color Camera SDK for Python (Linux)" to configure properties and functionality.

Following sample snippet of JSON file.

   file - zcamConfig.json
  
  {
    "AutoProperties": {
        "AutoExposure": true,
        "AutoWhiteBalance": true
    },
    "EventsState": {
        "BoundingBoxEvent": false,
        "ContinuesEvent": false,
        "DecodeEvent": true,
        "DecodeSessionStatus": false,
        "MonoChromeEvent": false,
        "ProduceEvent": false,
        "SnapshotEvent": false,
        "UsbDeviceEvent": false
    },
    "Firmware": {
        "FirmwareUpgrade": false,
        "FirmwreFileName": "CAADGS00-002-N23D0.DAT"
    },
    "ModeSetting": {
        "FrameResolution": "FRM_960x600",
        "IlluminationMode": "STANDARD",
        "PowerUserMode": false,
        "VideoMode": "WAKEUP"
    },
    "Properties": {
        "AbsoluteExposure": 5,
        "Backlight": 10,
        "Brightness": 0,
        "Contrast": 5,
        "Gain": 3,
        "Gamma": 0,
        "Saturation": 4,
        "Sharpness": 1,
        "WhiteBalance_Blue": 11736,
        "WhiteBalance_Red": 3469
    }
}