background image

 

 

26 

IS4910

 

D

EVICE 

D

RIVER

  

Registry Settings 

 
The registry settings allow to load and to configure the driver. The driver must be properly configured on 
the target device in order to work properly. For that purpose the driver reads the configuration parameters 
from the registry during loading. The driver’s registry values must be stored under the 
[

HKLM\

RootKey

\

DriverKey

] key, where 

RootKey

 is a string value defined under the [

HKLM\Drivers

key and 

DriverKey

 is an arbitrary string which names the driver dedicated subkey. If the 

RootKey

 is not 

defined, it defaults to 

Drivers

. But traditionally 

RootKey

 is 

Drivers\BuiltIn

. The name of the driver’s 

subkey is arbitrary, but it should be unique among the direct subkeys of [

HKLM\

RootKey

]. For example 

good choice for the 

DriverKey

 is 

IS4910

.  

 
The following table shows the relevant registry values under the driver’s subkey. First four values in the 
table are the basic entries used by the Device Manager under Windows CE in order to load the driver. 
And the other values are the driver-specific entries used to 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 

Prefix

 value appended the 

Index

 number. 

Dll 

STRING 

Specifies the name of the DLL that implements the driver 
(

vuqdrv.dll

Index 

DWORD 

(Optional) Defines the instance number of the device and can be 
a single decimal digit starting from 

1

 (first instance) to 

9

 (ninth 

instance) and 

0

 (tenth instance). The 

Index

 number is appended 

to the 

Prefix

 value to construct the device name. Default is 

1

Order 

DWORD 

(Optional) Specifies the order in which the driver should be 
loaded and ranges from 

0

 through 

255

. The drivers with lower 

Order

 values are loaded before drivers with higher 

Order

 values 

in the registry. 

SysIntr 

DWORD 

(Optional) Specifies the system interrupt number corresponding 
to the quick capture interface IRQ. If it’s not defined the driver 
would request the IRQ-to-SYSINTR mapping.  

DMAChannel 

DWORD 

(Optional) Specifies the DMA channel to be used by the driver 
for DMA operations. If it’s not defined then the first found free 
DMA channel would be used. 

MaxMemFrames 

DWORD 

(Optional) Specifies the maximum number of frames the image 
buffer can hold. Default is 4. 

 

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

Отзывы: