Manuel d'utilisation / d'entretien du produit IS4910 Series du fabricant Metrologic Instruments
Aller à la page 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.
Un point important après l'achat de l'appareil (ou même avant l'achat) est de lire le manuel d'utilisation. Nous devons le faire pour quelques raisons simples:
Si vous n'avez pas encore acheté Metrologic Instruments IS4910 Series c'est un bon moment pour vous familiariser avec les données de base sur le produit. Consulter d'abord les pages initiales du manuel d'utilisation, que vous trouverez ci-dessus. Vous devriez y trouver les données techniques les plus importants du Metrologic Instruments IS4910 Series - de cette manière, vous pouvez vérifier si l'équipement répond à vos besoins. Explorant les pages suivantes du manuel d'utilisation Metrologic Instruments IS4910 Series, vous apprendrez toutes les caractéristiques du produit et des informations sur son fonctionnement. Les informations sur le Metrologic Instruments IS4910 Series va certainement vous aider à prendre une décision concernant l'achat.
Dans une situation où vous avez déjà le Metrologic Instruments IS4910 Series, mais vous avez pas encore lu le manuel d'utilisation, vous devez le faire pour les raisons décrites ci-dessus,. Vous saurez alors si vous avez correctement utilisé les fonctions disponibles, et si vous avez commis des erreurs qui peuvent réduire la durée de vie du Metrologic Instruments IS4910 Series.
Cependant, l'un des rôles les plus importants pour l'utilisateur joués par les manuels d'utilisateur est d'aider à résoudre les problèmes concernant le Metrologic Instruments IS4910 Series. Presque toujours, vous y trouverez Troubleshooting, soit les pannes et les défaillances les plus fréquentes de l'apparei Metrologic Instruments IS4910 Series ainsi que les instructions sur la façon de les résoudre. Même si vous ne parvenez pas à résoudre le problème, le manuel d‘utilisation va vous montrer le chemin d'une nouvelle procédure – le contact avec le centre de service à la clientèle ou le service le plus proche.
