Benutzeranleitung / Produktwartung IS4910 Series des Produzenten Metrologic Instruments
Zur Seite of 42
METROLOGIC INSTRUMENTS, INC. IS4910 Series Area Imaging Engine Programmer’s Manual.
Copyright © 2008 by Metrologic Instruments, In c. All rights reserved. No part of this work may be rep roduced, transmitted, or stored in any form or by any means wi thout prior written consent, except by reviewer, who may quote brief passages in a review, or pr ovided for in the Copyright Act of 1976.
ii T ABLE OF C ONTENTS IS4910 S YSTEM H ARDWARE A RCHITECTURE ................................................................................................... 1 O VERVIEW OF THE IS4910 S OFTWARE C OMPONENTS IS4910 Device Driver and Its Configuration Param eters .
iii T ABLE OF C ONTENTS Window of Interest ............................................................................................................. ................. 11 camSetCent eredWOI ..........................................................
iv T ABLE OF C ONTENTS Aiming APIs .................................................................................................................... ......................... 22 camTurnAim ingOn .....................................................
.
1 IS4910 S YSTEM H ARDWARE A RCHITECTURE Figure 1 : IS4910 System Hardware Architec ture Communication with the i mage sensor is done over two bu ses – the control bus ( I 2 C ) and the data bus. The control bus is used to send com mands to the image sensor, and the data bus is used to transfer images from the image sen sor to the host system.
2 O VERVIEW OF THE IS4910 S OFTWARE C OMPONENTS The IS4910 camera engine cannot opera te on its own and must be supported by the unde rlying hardware and software systems.
3 O VERVIEW OF THE IS4910 S OFTWARE C OMPONENTS IS4910 Device Driver and Its Configuration Parameters IS4910 Device Driver is a software comp onent that does all the physical communications with IS4910 camera device. It is pre-compiled as a DLL (vuqd rv.
4 10 lg 20 1000 1000 20 GaindB AbsGain AbsGain GaindB ⋅ = ⋅ = O VERVIEW OF THE IS4910 S OFTWARE C OMPONENTS Minimum and Maximum Illumination Times These values, specified in micros econds, control the IS4910 illumination sy stem in the snapshot mode.
5 O VERVIEW OF THE IS4910 S OFTWARE C OMPONENTS Data Readout Order ReverseRows and ReverseCol s entries in the VuQuest2D. ini file provide information on wheth er the pixel read-out order for the image sen sor rows and colum ns respectively should be re versed.
6 I NSTALLING IS4910 S OFTWARE Installation of the IS4910 software is a two-stage pr o cess. In the first stage, the IS4910 software development kit (SDK) must be installe d on a Wind ows PC. To perform t he first-stage installation, insert the IS4910 CD into the CD drive of the Windows PC and follow the on-screen i nst ructions.
7 I NSTALLING IS4910 S OFTWARE Easy Downloading Using Device Setup Tool and MS ActiveSync Connection The easiest way to download software to the target device is to use the installation prog ram "Device Setup Tool", which is installed on the host Wind ows P C during the first-stage installation of the IS4910 SDK.
8 I NSTALLING IS4910 S OFTWARE Manual Downloading Using MS ActiveSync Connection Alternatively to using the Device Setup Tool, the IS4910 target device-specific software compo nents can be manually transferred to the target dev ic e by following the procedure described below.
9 C AMERA S UPPORT L IBRARY C AM L IB The IS4910 Camera Support Library CamLib provid es convenient interface betwee n an application and the IS4910 Device Driver. The library is available in two versions: static library (camlib.dll) and dynamic- link library (camdll.
10 C AMERA S UPPORT L IBRARY C AM L IB camOpen This function establishes communication with the specified camera device. Note: The target OS must support the MultiByteToW ideChar function in order for the camera support library to open the device driver properl y.
11 C AMERA S UPPORT L IBRARY C AM L IB Clocks The IS4910 camera has the master and pixel clo cks. The master clock provides the image se nsor with the input clock. The pixel clock used by the host system to sample the sensor data. The master clock is p rovided by the onboard oscillator and its freq uency is 48 MHz.
12 C AMERA S UPPORT L IBRARY C AM L IB camSetCenteredWOI This function sets the window of interest (WOI) of t he given size centered h orizont ally and vertically in the field of view of the camera.
13 C AMERA S UPPORT L IBRARY C AM L IB camGetImageSize This function returns the size of the window of interest (WOI). Prototype: int camGetImageSize (int cam_handle, int *img_width, int *img_height, int *num_bytes_per_row ); Parameters: cam_handle - [in] handle to the camera device returned by the camOpen fun ction.
14 C AMERA S UPPORT L IBRARY C AM L IB Parameters: cam_handle - [in] handle to the camera device returned by the camOpen fun ction. gain - [out] the gain value, in dB.
15 C AMERA S UPPORT L IBRARY C AM L IB For the purposes of automatic brightne ss adjus tments, an application can specif y the minimum and maximum boundaries for the image integration time. By default, the minimum image integrat ion time is set to 10 µs and the maximum is set to 8000 µs.
16 C AMERA S UPPORT L IBRARY C AM L IB camGetAutoExpoRange This function returns the minimum and maximum bou ndaries for the image integrat ion time during an execution of the automatic bright ness adjustment, see the functi on camAdjustBri ghtness() for more details.
17 C AMERA S UPPORT L IBRARY C AM L IB Parameters: cam_handle - [in] handle to the camera device returned by the camOpen fun ction. reverse_left_right - [out] 0 if normal readout from left to right, or 1 if inverted. reverse_top_bottom - [out] 0 if normal readout from top to bottom, or 1 if inverted.
18 C AMERA S UPPORT L IBRARY C AM L IB Prototype: int camSetMinFlashTime(int cam_handl e , long min_time_µs ); Parameters: cam_handle - [in] handle to the camera device returned by the camOpen fun ction. min_time_µs - [in] minimum illuminatio n time, in mi croseconds.
19 C AMERA S UPPORT L IBRARY C AM L IB camAcquireImage This function performs an image a cquisition and delivers the image data to the application. If called when the camera is running in the video mode, the functi on delivers the image of the most recent video fram e.
20 C AMERA S UPPORT L IBRARY C AM L IB Parameters: cam_handle - [in] handle to the camera device returned by the camOpen fun c tion. image_buf - [out] image data buffer (optional in the video mode). image_buf_size - [in] image data buffer’s size, in bytes (optional in the video mode).
21 C AMERA S UPPORT L IBRARY C AM L IB camStopVideo This function stops video mode and turns the came ra back into snapshot mode. Prototype: int camStopVideo (int cam_handle ); Parameters: cam_handle - [in] handle to the camera device returned by the camOpen fun c tion.
22 C AMERA S UPPORT L IBRARY C AM L IB Aiming APIs The camera’s aiming system can be turned on or off b y calling camTurnAimingOn() o r camTurnAimingOff() respectively. Note, however, t hat even if the aiming is turned on, the function camStartVideo() turns the aimi ng off until the video is stopp ed.
23 C AMERA S UPPORT L IBRARY C AM L IB Automatic Brightness Adjustment APIs The set of automatic brightness adj ustment APIs a llows an application to automatically adjust the camera’s gain and image integratio n time bas ed on the quality of the previous images.
24 C AMERA S UPPORT L IBRARY C AM L IB The flags parameter indicates whether t he gain and/or image integration time (exposure) are allowed to be adjusted, and whether the new values sh ould be app lied to the camera imm ediately after taking the current image or postponed until and applied upon the nex t image acquisition.
25 IS4910 D EVICE D RIVER The device driver is a software component that prov ides the low-level interface b e tween 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.
26 IS4910 D EVICE D RIVER Registry Settings The registry settings allow to load and to config ure the driver. The driver must be properly confi gured on the target device in order to work properly. For that purpose the d river reads the configuration parameters from the registry during loading.
27 IS4910 D EVICE D RIVER Value Type Description GPIO_CIF_FV DWORD Specifies the GPIO pin connec ted to the “VSYNC” signal. If it’s not specified the driver fails to load. GPIO_CIF_LV DWORD Specifies the GPIO pin connected to the “HSYNC” sig nal.
28 IS4910 D EVICE D RIVER Value Type Description POLARITY_TRIGGE R DWORD (Optional) Defines the pola rity (a ctive “high” or “low”) of the “Trigger” signal. Allowed value s are 1 (normal polarity, active “high”) and 0 (inverted pola rity, ac tive “low”).
29 IS4910 D EVICE D RIVER Power Management The driver supports the standar d power management interface PM CLASS_GENERIC_DEVICE used by the Power Manager under Windo ws CE to query the pow er capabilities of the device and to control its state.
30 A PPENDIX A: D RIVER R EGISTRATION A PPLICATION The driver registration application allows to inst all or to uninstall the IS4900 device driver into the operating system running on the target d evi ce. It is a simple console application. The installed device name is co nstructed from the VUQ prefix appended the index numbe r.
31 A PPENDIX B: IS4910 D RIVER I NITIALIZATION F ILE The IS4910 Driver initialization file VuQuest2D.ini contains the driver config uration settings. The file uses the following format: [Device] SubKe.
32 A PPENDIX B: IS4910 D RIVER I NITIALIZATION F ILE Index (optional) defines the instance n umber of t he device and can be a single decimal digi t starting from 1 (first instance) to 9 (ninth instance) and 0 (tenth instan ce). The Index number is appended to the VUQ prefix to construct the device name.
33 A PPENDIX B: IS4910 D RIVER I NITIALIZATION F ILE Gain1000 (optional) defines the image sensor absol ute gain multiplied by 1000. It ranges from 1000 (Gain = 1 or 0 dB) to 1600 (Gain = 16 o r 24.08 dB). Default is 1000 (Gain = 1 o r 0 dB). PixelClock (optional) defines the imag e sensor pixel clock frequency, in Hz.
34 A PPENDIX C: D EMO A PPLICATION The demo application CamTest is simple and easy to use. Just follow the on-screen instructio ns. The Push me button starts/stops or continues imag e acquis ition and real-time displ a ying. The currently displayed image can be stored in BMP file (My Do cumentsMy Picturesvuq.
35.
January 2008 Revision 2.0 00 - 02291A.
Ein wichtiger Punkt beim Kauf des Geräts Metrologic Instruments IS4910 Series (oder sogar vor seinem Kauf) ist das durchlesen seiner Bedienungsanleitung. Dies sollten wir wegen ein paar einfacher Gründe machen:
Wenn Sie Metrologic Instruments IS4910 Series noch nicht gekauft haben, ist jetzt ein guter Moment, um sich mit den grundliegenden Daten des Produkts bekannt zu machen. Schauen Sie zuerst die ersten Seiten der Anleitung durch, die Sie oben finden. Dort finden Sie die wichtigsten technischen Daten für Metrologic Instruments IS4910 Series - auf diese Weise prüfen Sie, ob das Gerät Ihren Wünschen entspricht. Wenn Sie tiefer in die Benutzeranleitung von Metrologic Instruments IS4910 Series reinschauen, lernen Sie alle zugänglichen Produktfunktionen kennen, sowie erhalten Informationen über die Nutzung. Die Informationen, die Sie über Metrologic Instruments IS4910 Series erhalten, werden Ihnen bestimmt bei der Kaufentscheidung helfen.
Wenn Sie aber schon Metrologic Instruments IS4910 Series besitzen, und noch keine Gelegenheit dazu hatten, die Bedienungsanleitung zu lesen, sollten Sie es aufgrund der oben beschriebenen Gründe machen. Sie erfahren dann, ob Sie die zugänglichen Funktionen richtig genutzt haben, aber auch, ob Sie keine Fehler begangen haben, die den Nutzungszeitraum von Metrologic Instruments IS4910 Series verkürzen könnten.
Jedoch ist die eine der wichtigsten Rollen, die eine Bedienungsanleitung für den Nutzer spielt, die Hilfe bei der Lösung von Problemen mit Metrologic Instruments IS4910 Series. Sie finden dort fast immer Troubleshooting, also die am häufigsten auftauchenden Störungen und Mängel bei Metrologic Instruments IS4910 Series gemeinsam mit Hinweisen bezüglich der Arten ihrer Lösung. Sogar wenn es Ihnen nicht gelingen sollte das Problem alleine zu bewältigen, die Anleitung zeigt Ihnen die weitere Vorgehensweise – den Kontakt zur Kundenberatung oder dem naheliegenden Service.
