background image

 

 

11

C

AMERA 

S

UPPORT 

L

IBRARY 

C

AM

L

IB

 

Clocks 

 
The IS4910 camera has the master and pixel clocks.  The master clock provides the image sensor with 
the input clock.  The pixel clock used by the host system to sample the sensor data. 

 

The master clock is provided by the onboard oscillator and its frequency is 48 MHz. Allowed pixel clock 
frequencies on PXA270 platform are: 12 and 24 MHz.  By default, if not specified otherwise in the IS4910 
device driver initialization file VuQuest2D.ini, the pixel clock frequency is set to the maximum 24 MHz.  

 

If the camera is running in the video mode, it must be stopped before changing this property. 

camSetClocks 

 

This function sets the master and pixel clocks in Hertz. 

 

Prototype

int camSetClocks (int 

cam_handle, 

long 

pclk

, long 

mclk

); 

 

Parameters

cam_handle

  - [in] handle to the camera device returned by the camOpen function. 

pclk

 

- [in] pixel clock frequency in Hz. 

mclk - 

[in] should be 0. 

 

Return Value: 

0: Success; -1: Failure 

camGetClocks 

 

This function returns the master and pixel clocks in Hertz. 

 

Prototype

int camGetClocks (int 

cam_handle, 

long *

pclk

, long *

mclk

); 

 

Parameters

cam_handle

  - [in] handle to the camera device returned by the camOpen function. 

pclk

 

- [out] pixel clock frequency in Hz. 

mclk - 

[out] should be NULL. 

 

Return Value: 

0: Success; -1: Failure 

Window of Interest 

 
The window of interest (WOI) is the area within the field of view of the camera where image processing 
and barcode decoding operations are performed.  By default, the WOI is set to equal the entire field of 
view of the camera, which 1280 x 960 (1280 columns by 960 rows).  Note that numeration of rows and 
columns starts from 0, meaning that the very first pixel at the top left corner of the field of view has 
coordinates (0, 0).  Note also that every pixel is an 8-bit value, ranging from 0 to 255. 
 
By default, if not specified otherwise in the IS4910 device driver initialization file VuQuest2D.ini, the 
window of interest covers the entire field-of-view of the sensor, which is 1280 x 960 (1280 columns by 
960 rows). 
 
If the camera is running in the video mode, it must be stopped before changing this property. 

Содержание IS4910 Series

Страница 1: ...METROLOGIC INSTRUMENTS INC IS4910 Series Area Imaging Engine Programmer s Manual...

Страница 2: ...rior written consent except by reviewer who may quote brief passages in a review or provided for in the Copyright Act of 1976 Trademarks Metrologic is a registered trademark of Metrologic Instruments...

Страница 3: ...a Support Library CamLib 5 Omniplanar Barcode Decoding Library SwiftDecoder 5 Metrologic Demo Application 5 INSTALLING IS4910 SOFTWARE Downloading Software to the Target Device 6 Easy Downloading Usin...

Страница 4: ...Time Exposure 14 camSetIntegrationDuration 15 camGetIntegrationDuration 15 camSetAutoExpoRange 15 camGetAutoExpoRange 16 Readout Order 16 camSetReadoutOrder 16 camGetReadoutOrder 16 Illumination 17 ca...

Страница 5: ...ntrol 23 camGetAutoBrightnessControl 24 IS4910 DEVICE DRIVER 25 Installation Procedure 25 Installing Driver in the Running OS 25 Including Driver in the Target OS Image 25 Registry Settings 26 Power M...

Страница 6: ......

Страница 7: ...image acquisition in video mode The Trigger signal is used to initiate image acquisition in snapshot mode The Trigger signal is also connected to the Illumination system thus automatically initiating...

Страница 8: ...CE operating system Metrologic is fully supporting an Intel PXA270 processing platform The software system can be easily ported to any other processing platform that has camera interface controller a...

Страница 9: ...fault will make the pre compiled Metrologic Demo Application inoperable Also in this section the user can specify in what directory on the target device the driver should be installed By default the d...

Страница 10: ...h does not last too long resulting in the image saturation Specifying the minimum and maximum illumination time provides the timing boundaries for the FirstFlash circuitry Image Sensor Gain The gain i...

Страница 11: ...sion whether to use the static or dynamic library is made by a user programmer depending on his her preferences and tools used to compile and build user applications Note that the Metrologic Demo Appl...

Страница 12: ...the target device specific software components must be transferred and installed on the target device Please refer to the following subsection Downloading Software to the Target Device for details Dow...

Страница 13: ...y going to Programs VuQuest2D SDK Note that the Image Acquisition Device Driver vuqdrv dll will be placed in the directory specified by the Path key in the Device section of the Driver Initialization...

Страница 14: ...nc software Now your Windows PC will be able to connect the target device over ActiveSync 4 At this point a dialog window should appear on the screen of your PC asking you to set up a connection partn...

Страница 15: ...o CamLib Once the CamLib framework is initialized an application must call camOpen function to establish communication with the camera device This function returns the device handle which must be used...

Страница 16: ...nt calls to CamLib APIs to identify the camera device on which an operation is requested to be performed camClose This function closes communication with the specified camera device Prototype int camC...

Страница 17: ...e camGetClocks This function returns the master and pixel clocks in Hertz Prototype int camGetClocks int cam_handle long pclk long mclk Parameters cam_handle in handle to the camera device returned by...

Страница 18: ...he camera device returned by the camOpen function img_leftx in x coordinate of the window upper left corner the maximum value is 1279 img_topy in y coordinate of the window upper left corner the maxim...

Страница 19: ...i the gain is set to 0 dB no gain For the purposes of automatic brightness adjustments an application can specify the minimum and maximum boundaries for the gain value By default the minimum gain is s...

Страница 20: ...inRange_db This function returns the minimum and maximum boundaries for the gain value during an execution of the automatic brightness adjustment see the function camAdjustBrightness for more details...

Страница 21: ...on time_ s in image integration exposure time in microseconds Return Value 0 Success 1 Failure camGetIntegrationDuration This function returns the current value of camera s image integration time in m...

Страница 22: ...IS4910 device driver initialization file VuQuest2D ini the image is transferred horizontally from left to right and vertically from top to bottom The readout order can be reversed for any or both of t...

Страница 23: ...e VuQuest2D ini illumination is enabled and the minimum illumination flash time for snapshot operations is set to 0 To enable or disable illumination while the camera is running in the video mode the...

Страница 24: ...hot mode of operation In the snapshot mode the functions camAcquireImage or camAcquireImageEx can be called to execute a single image acquisition and deliver the image data to the application To turn...

Страница 25: ...eturn Value 0 Success 1 Failure camAcquireImageEx This function performs an image acquisition and delivers the image data to the application If called when the camera is running in the video mode the...

Страница 26: ...eight bit pixels maximum should be allocated by the application prior to calling the function and the pointer to it along with the information about the buffer s size should be passed to the function...

Страница 27: ...is function pauses the video mode The video mode can be resumed by calling camResumeVideo Prototype int camPauseVideo int cam_handle Parameters cam_handle in handle to the camera device returned by th...

Страница 28: ...o the camera device returned by the camOpen function Return Value 0 Success 1 Failure camTurnAimingOff This function turns the IS4910 camera s aiming system off Prototype int camTurnAimingOff int cam_...

Страница 29: ...r allowed ranges see functions camSetAutoGainRange_db and camSetAutoExpoRange for details Prototype int camAdjustBrightness int cam_handle int cur_quality float correction_db unsigned long flags Param...

Страница 30: ...values should be applied to the camera immediately after taking the current image or postponed until and applied upon the next image acquisition The individual bit values are CAM_AUTOGAIN gain can be...

Страница 31: ...driver is described in Installing IS4910 Software section of this document The following subsections provide more details on the driver installation if such installation needs to be customized Instal...

Страница 32: ...configure the driver and initialize its operating parameters Value Type Description Prefix STRING Defines the three letter name of the driver Must be VUQ The device name is constructed from the Prefi...

Страница 33: ...d the driver fails to load GPIO_CIF_DD3 DWORD Specifies the GPIO pin connected to the D3 signal If it s not specified the driver fails to load GPIO_CIF_DD4 DWORD Specifies the GPIO pin connected to th...

Страница 34: ...egrationTime DWORD Optional Defines the image integration exposure time in microseconds Default is 8000 s In the snapshot mode if illumination is enabled the image integration time equals the maximum...

Страница 35: ...completely unplugs the power from it The failure to turn the IS4910 camera to power down state D4 prior to unplugging the power from it may result in rendering the camera inoperative and may require...

Страница 36: ...omsg if specified suppresses the message box with final status of installation ini file is name of the initialization ini file that contains the driver configuration settings If the ini file parameter...

Страница 37: ...MER Resources SysIntr DMAChannel MaxMemFrames Settings IntegrationTime MinFlashTime IllumControl Gain1000 PixelClock I2CBusClock I2C_PowerOff ReverseRows ReverseCols ImgWidth ImgHeight Values in the D...

Страница 38: ...normal polarity active high POLARITY_ILLUM optional specifies the polarity active high or low of the Illum_ON signal Allowed values are 1 normal polarity active high and 0 inverted polarity active lo...

Страница 39: ...camera is entering the power down state D4 If set to 1 the I2 C controller is disabled If set to 0 the I2 C controller remains to be enabled Default value is 0 ReverseRows optional defines order in wh...

Страница 40: ...he SwiftDecoder API functions SD2 LIB to the list of modules passed to the linker Add the path to this library to the list of directories searched for libraries in the project settings 4 Define the ma...

Страница 41: ...35...

Страница 42: ...January 2008 Revision 2 0 0 0 0 2 2 9 1 A...

Отзывы: