background image

 

 

25

IS4910

 

D

EVICE 

D

RIVER

 

 

The device driver is a software component that provides the low-level interface between operating system 
and the IS4910 camera module. 
 
It is strongly recommended that the applications use CamLib APIs to communicate with the IS4910 
camera instead of calling the IS4910 Device Driver directly.  The CamLib APIs provide an easier and 
more convenient way of communicating with the camera. 
 
Note:  In order to achieve consistent image brightness in the snapshot mode from frame to frame the 
target OS should support the high-resolution timer functions QueryPerformanceCounter() and 
QueryPerformanceFrequency() with more accurate timing than the one-millisecond granularity. 
Availability of the high-resolution timer is desirable though it is not mandatory requirement. 

 

Installation Procedure 

 

The IS4910 Device Driver can be installed on the target device in two ways: as a part of the operating 
system or as an installable driver.  An easy way of installing the 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. 

 

Installing Driver in the Running OS 

 
The driver may be installed in the running system by a setup application. To do that the setup application 
should do the following: 
 

1.  Copy vuqdrv.dll to \windows directory on the target device. 

2.  Add the appropriate driver settings to the registry on the target device. 

3.  Use the function ActivateDeviceEx to load the driver to the system. 

4.  Note that the Driver Registration Application (vuqreg.exe) implements steps 2 and 3 of the above 

steps. 

 

Including Driver in the Target OS Image 

 

Built-in driver is considered a permanent feature of the target platform. In order to include the driver into 
platform, do the following.  
 

1.  Incorporate the driver into the Board Support Package (BSP) or Platform Builder catalog.   

See the Platform Builder supplied documentation for details. 

2.  Add the driver component to the target platform design. 

3.  Add the appropriate driver settings to the registry file. 

4.  Rebuild the OS image and load it into the target device. 

 

Содержание 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...

Отзывы: