Ramses I V3 - Sensor to Image GmbH
Contents
1. 12 5f General FUNCIONS REO a a aaoi 12 5 2 Area scan 0 21 2 v 31 33 ME C PCI sRALCU LI 33 SEE uta 33 2 Pin Lay Qu a aaea ea a ora dee a EEE ENEE 34 AST 10 T15 DOl SOCKET Deos Ec Gas 34 22 Jumper and signallines 1044 2 35 221 Configurationjumper JP1 JP 5 cinereae 35 A22 Connector eoe 36 DECLARATION OF CONFORMITY 38 Ramses I V3 2 User s Manual Fe i th Sensor to Image GmbH 1 Introduction RAMSES V3 is a very powerful framegrabber to upgrade a customary in trade personal computer with PCl interface Compact PCI systems and industry computer in PC104 size to a workstation for image processing This product with its proven technology of the previous versions Pictureboy and RAMSES I V2 was developed further and optimized to ensure best image quality and to allow many fields of application The RAMSES card is an active framegrabber which means the board is equipped with a microcontroller and FPGA in add2. Function Returns address of memory page Syntax BYTE get pixel ptr BYTE card nr Byte page DWORD ptradr Description This functions returns the logical address of the memory pages given page With the pointer there is access to the pixeldata The page count is dependent on the size of allocated memory One page needs 64 KB Calculation of the pages You find the size of allocated memory in byte in the registry see appendix Registry Keys The division of this value through 64 kbyte delivers the count of pages If the memory size of card 1 has to be changed the new value has to be written to MemSize1 Then restart Windows With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Example get pixel ptr 1 0 amp ptradr GPixel BYTE ptradr Ramses I V3 14 User s Manual Return Fe i th Sensor to Image GmbH 0 Success 1 Referred page does not exist 10 Card not initialized get_transfer_rate Function Syntax Description Return init ramses1 Function Syntax Description Return Reference Get the mainboard s data transferrate BYTE get transfer rate BYTE card nr float rate This function returns the motherboard s transferrate over the pci bus Result value is given in the variable rate in Mbyte s With the parameter card nr the Ramses card to talk to is specified 1 5 0 Success 1 Comm
3. Gray Max 255 4 xi a vi P x2 7 4 E Y2 496 2 4 H High Ref changes the positive reference voltage of the AD converter Low Ref changes the negative reference voltage of the AD converter Gray min sets the minimal value of the shades of gray generated by the AD converter Gray max sets the maximal value of the shades of gray generated by the AD converter With X1 Y1 X2 Y2 the video window can be set Ramses V3 11 User s Manual 5 Function Library In this chapter the different functions of the RA1V3 DLL are explained in alphabetic order Following example shows the function description Sample function Function A short description of the function Syntax The function s syntax description in Description This section contains the job and the usage of the function Also the parameters are descripted Return Here you find the type and range of the return values Reference List of other routines which have a relationship with the current function Note A sample how to program the Ramses V3 board is found in the source files of the sample application VisionAppDemo See chapter 4 The functions marked as intern are not used in application development normally But they are used by other functions and special custom commands 5 1 General Functions clear irq Function Deactivates interrupthandler Syntax BYTE clear irq BYTE card nr D
4. amp parameter not send error while sending 2 No data fetched 10 Card not initialized get ad range get ad nref get ad pref Set input lookup table BYTE set inlut BYTE BYTE write flag card nr BYTE tindex BYTE tval This function sets the lookup table of the current video in in the FPGA The data have to be sent sequentially and are cached on the Ramses 27 User s Manual Reference Fe i th Sensor to Image GmbH board until write_flag is switched from 0 to 1 Paramter tindex is the table index of the value tval With the parameter card_nr the Ramses V3 card to talk to is specified 1 5 Example to invert image for i20 1 lt 255 1 set_inlut CARD i i 0 send table values from index 0 254 error set_inlut CARD i i 1 send table value 255 and commit 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized get_inlut set_video_input get_video_input set_video_input Function Syntax Description Return Reference Set video in channel BYTE set video input BYTE card nr BYTE video in Set the video in of the Ramses I V3 board to the channel given in the parameter video in values 0 1 This channel is implicitly used by many other functions With the parameter card nr the Ramses I V3 card to talk t
5. 32 User s Manual Appendix A 1 Registry Keys A 1 1 Memory Windows NT HKEY_LOCAL_MACHINE System CurrentControlSet Services Ra1V3 Parameters MemsSize1 MemSize2 MemSize3 MemSize4 MemSize5 Windows 98 ME 2000 XP Memorysize for card 1 in byte Memorysize for card 2 in byte Memorysize for card 3 in byte Memorysize for card 4 in byte Memorysize for card 5 in byte HKEY_LOCAL_MACHINE System CurrentControlSet Services Ramses1V3 Parameters 1 MemSize2 MemSize3 MemSize4 MemSize5 Ramses V3 Memorysize for card 1 in byte Memorysize for card 2 in byte Memorysize for card 3 in byte Memorysize for card 4 in byte Memorysize for card 5 in byte 33 User s Manual Feith A 2 Pin Layout A 2 1 0580815 15 pol socket Description Signal A Signal A Signal B Video In Signal B GND 12 Volt 12 Volt Oc Oo oa A ND Vcc Signal C TTL Out0 Signal C TTL Out1 Signal D TTL Out2 Signal D TTL In 0 TxD TTL In 1 RxD TTL In 2 NES a amp gt TTL In Out not supported the standard version But it is possible to integrated that Ramses I V3 34 User s Manual Feith A 2 2 Jumper and signallines on PC104 To work correctly there must be set some jumpers on the PC104 board In the following the position of the jumpers visible PCI BUS J3 50
6. Installation of the framegrabber and the driver see chapter 3 2 Make a directoy like c program files VisionApplication 3 Copy the content of the folder SDK of the delivered disc into that folder Ramses I V3 7 User s Manual 4 2 Framegrabber Test With the application VisionAppDemo exe you can test the functions of the framegrabber At start up following errors can occur Error Action 1 PCI BIOS not present PC vendor contact Feith 2 DEVICE ID not found Check Ramses I V3 board contact Feith 3 Wrong Vendor ID Check Ramses I V3 board contact Feith 4 Reset Controller not active Shutdown Windows power off PC and restart 5 Memory not allocated Check registry keys See appendix 10 Board already initialized Start application only once possibly reboot Windows Ramses V3 8 User s Manual Fe i th Sensor to Image GmbH 4 3 Sourcefiles The program Vision Application Demo consists of following source files File Function VisionApplication c Routines of the main program VisionApplication h Headerfile for VisionApplication c Grabber c Routines to realize image grabbing and display Grabber h Headerfile for Grabber c VisionApplication rc Ressourcefile Ra1V3 lib Link library Ra1V3 h Headerfile for the function library Ra1V3 dll The dll contains the function library and is copied into the system32 directoy during driver setup VisionAppDemo exe Compiled application 4 4 Description of the sample a
7. Reference set ad nref Function Syntax Description Return Ramses I V3 Fe i th Sensor to Image GmbH finishes rror receive fast Get result of the grab function if error on error exit return error error grabb image half card nr 1 1 Grab image to page 1 and return control back to PC if error on error exit return error Display image of page 0 or process it wait 10000 Timeout 10sec WaitForSingleObject hEvent wait Wait until grab finishes rror receive fast Get result of the grab function if error on error exit return error clear 1 deactivate interrupthandler 0 Success 1 Command amp parameter not send error while sending 2 data fetched 3 Window too large 4 Transfer error 10 Card not initialized grabb image full set irq event set clear Set negative reference voltage of the AD converter BYTE set ad nref BYTE card nr BYTE ref This function sets the negative reference voltage of the current video in s AD converter with ref 0 255 The minimal voltage is OV the maximum 1 2V The function can be used to improve contrast Attention The negative voltage must not be greater than the positive With the parameter card nr the Ramses card to talk to is specified 1 5 0 Success 1 Command amp parameter not send error w
8. not initialized update firmware Function Update firmware of the Ramses board Syntax BYTE update firmware BYTE card nr char fname CALLBACK FUNC c func Description This function updates the firmware of the Ramses V3 board With the parameter card nr the Ramses I V3 card to talk to is specified 15 fname is a pointer to the update file bin With the callback function it is possible to realize a monitoring function Example BYTE WINAPI callback func int s cnt char 1 str 100 sprintf l str d s cnt SetDlgItemText StatusHWND IDC STATUS l str SendDlgItemMessage StatusHWND IDC PROGRESSI PBM SETPOS WPARAM s cnt 0 return 0 Return 0 Success 1 Timeout reset hardware 2 Programming not ready 3 Memory cannot be erased 4 Programmer file is missing 5 Programmer file is too small 6 Timeout on PCl board 7 Data error while transferring data to PCl board 8 Programming error in local flash 10 Card not initialized Attention If the update fails the board could be unusable and has to be sent to the vendor Only firmware files delivered from Feith are allowed to be flashed Ramses V3 20 User s Manual Fe i th Sensor to Image GmbH 5 2 Area scan camera functions get_ad_nref Function Syntax Description Return Reference get_ad_pref Function Syntax Description Return Reference Returns t
9. the last full image So it is only possible to change the y coordinates in steps of 2 Return 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 3 Width not modulo 4 10 Card not initialized Reference get video window video present video present Function Check current video in Syntax BYTE video present BYTE card nr Description This function checks the current video in if there is video signal If so the parameter fitting the detected camera are set Video window Can be checked with get video window PAL 768 x 576 NTSC 640 x 480 XC55 640 x 480 HR70 1024 x 768 Jai M1 1280 x 1024 Ramses V3 29 User s Manual Camera type bechecked with get camera type With the parameter card nr the Ramses I V3 card to talk to is specified 722 Return 0 Success 1 timeout 2 no vsync signal 3 no hsync signal 10 Card not initialized Reference get video window get camera type get video input set video input Ramses V3 30 User s Manual 6 Glossary BNC Busmastering CameraLink CCD CCIR DMA D SUB FPGA Framegrabber LVDS Ramses I V3 Fe i th Sensor to Image GmbH Shortform for Bayonet Neill Concelmann The BNC connector is bayonett connector to connect two coax cable BNC connectors are designed for RG 58 cables Ethernet and RG 59 cables Video The abbreviation stands also for Bayonet Na
10. 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized get_memory_size Function Returns the size of reserved memory Syntax BYTE get memory size BYTE card nr DWORD size Description This functions returns the size of allocated memory in the variable mem size zur ck With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 No memory allocated 10 Card not initialized Ramses I V3 13 User s Manual Fe i th Sensor to Image GmbH get_pixel_adr intern Function Return physical address of a memory page Syntax BYTE get pixel adr BYTE card nr BYTE page DWORD phy adr Description This functions returns the physical address of the memory pages given in page The page count is dependent on the size of allocated memory One page needs 64 KB Calculation of the pages You find the size of allocated memory in byte in the registry see appendix Registry Keys The division of this value through 64 kbyte delivers the count of pages If the memory size of card 1 has to be changed the new value has to be written to MemSize1 Then restart Windows With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Return 0 Success 1 Referred page does not exist 10 Card not initialized get pixel ptr
11. 5060000000 2 2 1 Configurationjumper JP1 JP5 In every block only one connector between first and second line has to be set In the following is assumed that the right pin pair is bridge 1 Dependent on the mount level following jumpers have to be set Level JP1 JP2 JP3 JP4 JP5 1 1 1 1 1 1 2 2 2 2 2 2 3 3 3 3 3 3 4 4 3 3 4 4 JP1 Definition Interrupt line Ramses I V3 35 User s Manual i th Sensor to Image GmbH JP2 Grant Signal Bus Request Signal JP4 Device Select JP5 Jlf the board lt is mount on level 4 the device on level must not need the signals for Bus Request and Grant Example Board is mount on level 1 that means directly on the motherboard So the jumpers have to be set as follows A 2 2 2 Connector J1 and J3 Signalconnector J1 for additinal power supply PIN Description 1 12V 2 GND 3 GND 4 Vcc Signalconnector J3 to connect camera PIN Description Signal A Vcc SignalA Signal C Signal B Signal C Video In Signal D Signal B Signal D 11 GND o oco O a A N e Ramses I V3 36 User s Manual 12 13 14 15 16 Ramses V3 TxD 12V RxD 12V GND 37 Fe i th Sensor to Image GmbH User s Manual DECLARATION CONFORMITY EU KONFORMITATSERKLARUNG DECLARATION DE CONFORMITE Wir Name des Anbieters Feith Sensor to Image GmbH W
12. FALSE initial state non signaled NULL name string error set irq event CARD hEvent 0 Success 1 Command amp parameter not send error while sending 10 Card not initialized grabb image half grabb image full set irq clear irq send val intern Function Syntax Description Return Send data to Ramses board BYTE send val BYTE card nr BYTE cmd BYTE cnt DWORD pptr With this function parameter and command are sent to the Ramses board The command is found in cmd The count of parameters is set in cnt The parameters itself are accessible through the pointer pptr With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Example error send nr cmd cnt pptr 0 Success 1 Command amp parameter not send error while sending 10 Card not initialized set memory size Function Syntax Description Ramses V3 Change memory size to allocate BYTE set memory size BYTE card nr DWORD mem size With this function the memory size to allocate is set Parameter mem size contains the new size in byte After this command Windows has to be rebooted 19 User s Manual Fe i th Sensor to Image GmbH With the parameter card_nr the Ramses V3 card to talk to is specified 1 5 Return 0 Success 1 Command amp parameter not send error while sending 10 Card
13. Ramses I V3 User s Manual by August 2003 h Sensor to Image GmbH Feith Sensor to Image GmbH Lechtorstrasse 20 D 86956 Schongau Tel 49 8861 2369 0 Fax 49 8861 2369 69 EMAIL email feith de Internet http www feith de Fe i th Sensor to Image GmbH Table of Content Table OF COHEIGDDo ie sees suns divin Rs IP ELa RES ERR ZEE IAS GbR DL E DrMERO M RACE UM IRE 2 1 Introduction aussi cavea bann EUER ExE MI NI MNQ NAME SD DI MEE E EE 3 2 Functionality and technical Properties 1 1 4 FA MEE SU eel NOR ETM 4 2 2 mci RERO 5 co A E 6 cx MEIN I iol i is Em 6 Sw EM 6 uM 6 CAP MEE OC ized oy recep TENA 6 SEEN epo 6 SR Ua lea c 7 3 2 1 Windows 98 ME 2000 XP b GER debo 7 322 Windows N m 7 4 Sampleapplication for 7 2 7 4 2 Framegrabber 8 9 4 4 Description of the sample application 9 22
14. and amp parameter not send error while sending 2 No data fetched 10 Card not initialized Initialize PCl board Ramses1 BYTE init 1 BYTE card nr This function initializes the board It will be checked if there is a PCI BIOS then the Device ID the Reset Controller and the video ins are tested With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Success PCI BIOS not present DEVICE ID not present Wrong Vendor ID Microcontroller does not respond Memory not allocated 0 Card already initialized 0 1 2 3 4 5 1 close ramses1 pci read byte intern Function Syntax Description Ramses V3 Read one BYTE from PCI controller BYTE pci read byte BYTE card nr WORD offset Reads one BYTE at the offset from PCI controller With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 15 User s Manual Return Reference Fe i th Sensor to Image GmbH Read BYTE pci_read_word pci_read_dword pci_write_byte pci_write_word pci_write_dword pci_read_word intern Function Syntax Description Return Reference Read one WORD from PCl controller WORD pci read word BYTE card nr WORD offset Reads one WORD at the offset from PCI controller With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Read WORD pci_read_byte pci_r
15. d pci write dword intern Function Write one DWORD to PCI controller Syntax void pci write dword BYTE card nr WORD offset DWORD value Description Writes one DWORD at offset to the PCI controller The value to be written is given in value With the parameter card nr the Ramses I V3 card to talk to is specified 7 2 Return Reference pci read byte pci read word pci read dword pci write byte pci write word receive Function Receive data from Ramses board Syntax BYTE receive BYTE card nr DWORD pptr Description This function reads DWORD data from Ramses PCI controller With the parameter card nr the Ramses V3 card to talk to is specified 1 5 Return 0 127 Count of DWORDS written pptr 128 no answer 130 Card not initialized receive fast Function Receive DWORD from Ramses board Syntax BYTE receive fast BYTE card nr Ramses I V3 17 User s Manual Description Return Reference Fe i th Sensor to Image GmbH This function reads one DWORD from Ramses PCl controller and return the first byte With the parameter card_nr the Ramses V3 card to talk to is specified 1 5 This function is used in conjunction with the grabb functions The return value indicated whether the grabb was successful 0 Success 1 Error during transferring data over the PCI bus 8 Timeout 10 Card not initialized grabb_imag
16. e Suppliers Name Nous Nom du Fournisseur Anschrift Lechtorstrasse 20 Address D 86956 Schongau Adress erkl ren in alleiniger Verantwortung da das Produkt declare under sole responsibility that the product d clarons sous notre responsibilit que le produit Bezeichnung Ramses 1 V3 PCI Frame Grabber Name Nom Typ Modell Artikel Nr RA1V3 Type Model Article No Type Mod le No d Article mit den Anforderungen der Normen EN 55022 fullfills the requirements of the standard EN 50081 1 2 satisfait aux exigences des normes EN 50082 11 2 bereinstimmt und damit den Bestimmungen der EU Richtlinie 89 336 EWG entspricht and therefore corresponds to the regulations of the EU Directive 89 336 EEC et ainsi correspond aux reglement de la Directive du Conseil 89 336 CCE Schongau 01 07 2003 Gesch ftsf hrer Ort und Datum der Ausstellung Name und Anschrift des Befugten Place and Date of Issue Name and Signature of authorized person Lieu et date d tablissement Nom et signature de la personne autoris e Ramses V3 38 User s Manual
17. e_full grabb_image_half receive_status Function Syntax Description Return set_irq Function Syntax Description Return Reference Check if there are data from Ramses board BYTE receive status BYTE card nr With this function is checked whether there are data from Ramses board With the parameter card_nr the Ramses V3 card to talk to is specified 1 5 0 noanswer 1 answer 10 Card not initialized Activates interrupthandler BYTE set 1 rq BYTE card nr This function activates the interrupthandler for the given card With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Activation not possible clear set event grabb image half grabb image full set irq event Function Syntax Description Ramses I V3 Submit eventobject to driver BYTE set irq event BYTE card nr ULONG Event This function submits an eventobject to the driver which is set when an interrupt occurs So it is possible to wait for the grabb without polling a CPU load 18 User s Manual Reference Fe i th Sensor to Image GmbH Event is the prior created eventobject With the parameter card_nr the Ramses V3 card to talk to is specified 12 Example hEvent CreateEvent NULL Security Setting FALSE auto reset
18. ead_dword pci_write_byte pci_write_word pci write dword pci read dword intern Function Syntax Description Return Reference Read one DWORD from PCI controller DWORD pci read dword BYTE card nr WORD offset Reads one DWORD at the offset from PCI controller With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Read DWORD pci read byte pci read word pci write byte pci write word pci write dword pci write byte intern Function Syntax Description Return Reference Ramses I V3 Write one BYTE to PCI controller void pci write byte BYTE card nr WORD offset BYTE value Writes one BYTE at offset to the The value to be written is given in value With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 pci read byte pci read word pci read dword pci write word pci write dword 16 User s Manual Fe i th Sensor to Image GmbH pci_write_word intern Function Write one WORD to PCI Controller Syntax void pci write word BYTE card nr WORD offset WORD value Description Writes one WORD at offset to the PCI Controller The value to be written is given in value With the parameter card nr the Ramses card to talk to is specified 1 5 Return Reference pci read byte pci read word pci read dword pci write byte pci write dwor
19. ed If the function set irq is called before after the transfer of the image to PC memory an interrupt will be generated When working with interrupts it is possible to wait on the interrupt with an eventobject and the API function WaitForSingleObject During this time the running thread is not running and so it needs no CPU power The parameter Iflag controls whether to wait until the command finishes Ifalg 0 or not lt 1 Then the calling routine gets back the flowcontrol and must check with receive fast whether the grab returns errors or has finished Lflag should be always 0 and is only set to 1 when using switched image memory With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 During execution no functions to read or change the configuration must be called i e get transfer rate get video window set n ref etc Example for Iflag lt 1 with Interrupt hEvent CreateEvent NULL Security Setting FALSE Auto Reset FALSE initial state non signaled NULL name string error set irq event CARD hEvent set irq activate interrupthandler error grabb image half card nr 0 1 Grab image to page 0 and return control back to PC if error on error exit return error Display image of page 1 or process it wait 10000 Timeout 10sec WaitForSingleObject hEvent wait Wait until grab 25 User s Manual
20. er additionally offer onboard image processing Short for Low Voltage Digital Signal and describes a standard for high speed data transfer LVDS is common to use for communication purposes with cameras 31 User s Manual Fe i th Sensor to Image GmbH NTSC Color coding process commonly used in USA and Japan In contrast to PAL pase errors cannot be corrected from receiver This leads to considerable color jumps between different channels PAL Color coding process which reduces the color errors originated during transmission to smaller less conspicuous color saturation errors 1991 introduced standard for PC board which expands vastly the possibilties The bus has a width of 32 bit with frequency of 33 MHz what enables transfer rates up to 133mbytes s Extensions like Plug amp Play are possible and additional boards are able to access main memory without using the host s cpu DMA Busmaster RS232 Interface for serial data transfer up to 20 kbit Second in both direction Maximal cablelength 15m RS422 Interface for serial data transfer up to 10 mbit s in both direction Maximal cablelength 1200m RS485 Extension to RS422 with more transceivers TTL Short for Transistor Transistor Logic and stands for circuit family VSYNC HSYNC Video signals for horizontal and vertical synchronisation WDM Short for Windows Driver Model It describes the way to develop und integrate new drivers for Windows Ramses I V3
21. escription This function deactivates the interrupthandler for the given card With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Return 0 Success 1 Deactivation not possible close ramses1 Function Close Ramses V3 Syntax BYTE close ramsesl BYTE card nr Description When a card was initialized with the function init ramses1 it has to be closed by this function With the parameter card nr the Ramses card to talk to is specified 1 5 Ramses I V3 12 User s Manual Fe i th Sensor to Image GmbH Return 0 Success 10 Card was not initialized Reference init ramses1 get hardware info Function Returns information about the hardware Syntax BYTE get hardware info BYTE card nr BYTE sw m BYTE sw y BYTE hw mode BYTE hw submode BYTE hw fpga Description This function returns information about the soft and hardware using the parameter sw m sw y hw mode and hw fpga With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 sw m Software Release Month SW y Software Release Year hw mode Hardware Mode 0 Area scan cameras 1 Line scan cameras 2128 Custom specific hw submode Hardware Sub Mode 0 Standard 20 Custom specific 255 start up made hw_fpga FPGA Module 50 2550 100 X28100 150 X28150 200 25200 Return
22. he negative reference voltage of the AD converter BYTE get ad BYTE card nr BYTE ref Returns the negative reference voltage of the current video in s AD converter via the parameter ref With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized set ad nref get ad pref set ad pref Returns the positive reference voltage of the AD converter BYTE get ad pref BYTE card nr BYTE ref Returns the positive reference voltage of the current video in s AD converter via the parameter ref With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized set ad nref get ad nref set ad pref get ad range Function Syntax Description Return Ramses I V3 Read the AD converter s range of the shades of gray BYTE get ad range BYTE card nr BYTE gray min BYTE gray max This function return the minimal gray min and maximal gray max value of gray of the current video in s AD converter in the range of 0 255 With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Command amp parameter not se
23. hile sending 26 User s Manual Reference set ad pref Function Syntax Description Return Reference Fe i th Sensor to Image GmbH 2 No data fetched 10 Card not initialized set_ad_pref get_ad_nref get_ad_pref Set positive reference voltage of the AD converter BYTE set ad pref BYTE card nr BYTE ref This function sets the positive reference voltage of the current video in s AD converter with ref 0 255 The minimal voltage is OV the maximum 1 2V The function can be used to improve contrast Attention The positive voltage must not be greater than the negative With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized set ad nref get ad nref get ad pref set ad range Function Syntax Description Return Reference set inlut Function Syntax Description Ramses V3 Set the AD converter s range of the shades of gray BYTE set ad range BYTE gray max card nr BYTE gray min BYTE This function sets the minimal gray min and maximal gray max value of gray of the current video in s AD converter in the range of 0 255 where gray min gray max With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Command
24. iagnostics provides different information on the card and the connected camera IT ision Application Demo Image Tools Input Interface gt Grabber Diagnostics Hardwareinfo Memory Transferrate Reference voltage neg Reference voltage pos Range of shades of gray Camera type Video Window Time one Image Hardwareinfo displays soft and hardwaredata of the used Ramses Reserved Memory returns the amount of allocated memory Transferrate detects the current Transfer rate between PC and framegrabber The value is dependent on the PC motherboard other used and the system s load Reference voltage neg returns the negative reference voltage of the AD converter Reference voltage pos returns the positive reference voltage of the AD converter Range of shades of gray displays the returns the shades of gray settings of the AD converter Ramses I V3 10 User s Manual th Sensor to Image GmbH Camera type returns an identification of the cameratype connected with the current video in see libraryfunction get_camera_type Video Window returns the current video window s coordinates Time one Image returns the time used to grab an image Works only after grabbing images With the different scroll bars the behaviour of the AD converter can be controlled 0 x High Ref 130 M Low Ref 10 NN gt 0 gt
25. ition with very fast synchronous SRAM to allow extensive image processing onboard So application with many images per second can be served and the potential for reduction of date can be used in an optimal manner Due to the two completely independent input channels no multiplexing and the parallel video data processing you can build applications with one or to monochrome colour cameras or with multi tap cameras In addition 3D applications are also possible where itis necessary to process data of two cameras together Over the PCI bus the image data possibly pre processed can be transferred to host memory very quickly without using the host s cpu Then a PC based vision application can go on with processing this data Additional you can connect the RAMSES board with a CAN field bus to communicate directly with PLCs independent from the host PC This offers the possibility to use this board as well for evaluation purposes in the development process as for PC based vision applications in production environments Many operation ranges are possible like Measurement and position detection Medicine microscopy and structure analysis Optical inspections and security Quality assurance This board can be adapted to your needs quickly and inexpensively At this the company Feith Sensor to Image likes to advise and help to realize an optimal application Ramses I V3 3 User s Manual Fe i th Sensor to Image GmbH 2 Functionalit
26. meraLink In design In design In design e CAN Bus yes yes no Camera type all all all 4 4 channel 4 2 same time Resolution 10 Bit 10 Bit 10 Bit Shades of gray 1024 oder 256 1024 oder 256 1024 oder 256 Temperature range 0 70 C 0 70 0 70 Dimension 104 x 144 mm 3HU 116 x 98 mm Ramses I V3 User s Manual Fe i th Sensor to Image GmbH 3 Setup Following components are delivered PCl board RAMSES I V3 for standard PCs or Compact board RAMSES for Compact 19 chassis or PC104 PCI board for space saving industrial PCs in PC 104 formfactor Manual Cable for camera 374 floppy disc Notice the system requirements min Pentium 100 MHz with 32MByte SVGA One PCI Slot for Ramses V3 Microsoft Windows Version 98 ME NT 2000 XP Advice Pentium 111 600 512MB with Windows 2000 XP In general The faster your PC system the greater will be the performance of the vision system 3 1 Hardware Setup The setup is dependent on formfactor of the used RAMSES V3 board Do the following steps during the hardware setup 3 1 1 Power down PC and remove cover Plug PCI Ramses V3 board into a PCI slot and screw on Mount cover Connect camera with PCl board 3 1 2 Compact Power down PC and remove cover Plug Compact PCI Ramses I V3 board into a PCI sl
27. nd error while sending 21 User s Manual Reference Fe i th Sensor to Image GmbH 2 No data fetched 10 Card not initialized set_ad_range get_ad_nref get_ad_pref get_camera_type Function Syntax Description Return Reference get_inlut Function Syntax Description Return Reference Returns detected or set camera BYTE get camera type BYTE card nr BYTE cam type Returns the detected or set camera via the parameter cam type cam 0 PAL 1 NTSC 2 XC55 3 Jai M1 With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Before executing the function video present has to be called 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized video present Read input lookup table BYTE get inlut BYTE card nr BYTE tindex BYTE tval This function reads one value of the lookup table of the current video in from the FPGA Parameter tindex is the table index to read from Valid indexes are from 0 to 255 In tval the selected table value is written With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized set_inlut set_video_input get_video_input get_video_window F
28. o is specified 1 5 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized get video input set video window Function Syntax Description Ramses I V3 Sets the coordinates of the current video window BYTE set video window BYTE card nr WORD x1 WORD yl JORD x2 WORD y2 Sets the coordinates of the current video in s video window x1 y1 coordinate of the upper left corner x2 y2 coordinate of the lower right corner The x coordinates for f r PAL CCIR have a range from 0 to 767 the y coordinates from 0 to 575 28 User s Manual Fe i th Sensor to Image GmbH X2 X1 1 has to be divisible through 4 due to a limitation of of the PCI bus With the parameter card nr the Ramses I V3 card to talk to is specified 1 5 Example 768 x 576 grab image xl 160 skip unusable edges yl 44 x2 927 1 768 1 y2 619 yl 576 1 set video window 1 1 1 2 2 grabb image full 1 0 1 0 768 x 288 grab images xl 160 yl 44 x2 927 x1 768 1 y2 381 yl 288 1 set video window 1 1 1 2 2 grabb image full 1 0 1 0 With the parameter card nr the Ramses V3 card to talk to is specified 1 5 Attention Values will be reset to the standard if function video present is called If interlaced cameras are used the y coordinates are rounded back to
29. ot and screw on Mount cover Connect camera with PCl board 3 1 3 104 Power down and remove cover Ramses I V3 6 User s Manual Plug PCI Ramses V3 board onto the motherboard or above and screw Configure the jumper see appendix Connect camera with PCl board Mount cover Power on PC 3 2 Driver Installation 3 2 1 Windows 98 ME 2000 XP If you work with Windows 98 ME 2000 XP following steps have to be done Windows automatically detects the new PCI board Your are asked to install the driver for the PCI board Putin the delivered floppy CD Then choose the file RA1V3 INF in the folder Win98 ME 2000 XP and start the installation Finally Windows has to be rebooted 3 2 2 Windows NT If you work with Windows NT 4 0 following steps have to be done Run WinNT setup exe from floppy cd Confirm with OK Finally Windows has to be rebooted Important Note During Windows start up the device driver for RAMSES V3 Ra1v3 sys will be started He allocates continuous memory to save the grabbed image data If it was allocated later memory is fragmented what slows down performance Therefore after each change of memory buffer a reboot is required 4 Sampleapplication for Windows 4 1 Installation The delivered application software consists of source files and the compiled version called VisionAppDemo 1
30. pplication The program is designed quite simple and uses a menu and different scrollbars to control the framegrabber The application menu consists of three main entries File Image and Tools Imi Vision Application Demo File Image Tools With File Exit you can quit the program Image is responsible for starting and stopping the grab I Vision Application Demo File Image Tools Start grabbing Stop grabbing Invert Image Save Image Clear In addition the image can be inverted using the look up table and saved to disc Press Clear to reset the image by setting all pixels to i e 255 meaning white what seems to be a deletion of the last image Ramses V3 9 User s Manual LJ Fe i th Sensor to Image GmbH In Tools there is access to different control and diagnostic commands In Input Interface the used video in is marked and can be set File Image Tools leeds wv Video 1 Grabber gt Video 2 Diagnostics Through Grabber the can be initilized and closed In addition it is possible to use interrupts fpr communication purposes This reduces cpu load Update Firmware is provided for updating the framegrabber s firmware Attention Incorrect usage of the update function can make the board unusable imi Vision Application Demo File Image Tools Input Interface gt Grabber Initialize Diagnostics gt Close Use Interrupt Update Firmware D
31. rabb image full BYTE card nr BYTE page BYTE lflag Beschreibung Grab an image from an interlaced camera at the current video in and store it to PC memory The PC memory is reserved during Windows start up from the Ramses driver With parameter page is controlled in which memory page the image is stored If the function set irq is called before after the transfer of the image to PC memory an interrupt will be generated When working with Ramses I V3 23 User s Manual Attention Return Ramses V3 Fe i th Sensor to Image GmbH interrupts it is possible to wait on the interrupt with an eventobject and the API function WaitForSingleObject During this time the running thread is not running and so it needs no CPU power The parameter controls whether to wait until the command finishes Ifalg 0 or not Ifalg 1 Then the calling routine gets back the flowcontrol and must check with receive_fast whether the grab returns errors or has finished Lflag should be always 0 and is only set to 1 when using switched image memory With the parameter card_nr the Ramses V3 card to talk to is specified 1 5 During execution no functions to read or change the configuration must be called i e get_transfer_rate get_video_window set_n_ref etc Example for Iflag 1 without interrupt error grabb image full card nr 0 1 Grab image to page 0 and return control back to PC if error on error exi
32. s via the CAN interface to communicate directly with systems which are involved in the production process Ramses I V3 4 User s Manual LJ Fe i th Sensor to Image GmbH 2 2 Technical Facts Color and monochrome framegrabber for high resolution industrial image processing Analog and digital camera interfaces PAL NTSC progressive scan line scan cameras and further individual camera adjustments Video and sensor connection 15 pole DSUB socket Firmware and FPGA update directly in the system Realtime image processing with onboard FPGA and 2MB of synch SRAM Driver software and programming library available for Windows and Linux FIFO Interface to the PCl bus with capacity of 16kByte optional 2 32kByte Onboard ucontroller delivers 4 external TTL IO control circuits per channel and serves as sensorcontroller and communication interface to the PC 10 bit A D converter operating at 30MHz Power requirements 5V 1A 12V for CCD camera RAMSES I V3 is completely compatible with PCI V2 1 Up to 5 boards per PC Features of the different board variants PCI Compact PCI 104 Video B W 2 Color 0 B W 2 Color 0 B W 1 Color 0 alternativ B W 1 Color 1 B W 1 Color 1 B W 0 Color 1 Data Transfer approx 100 MB s approx 100 MB s approx 100 MB s Interfaces 5 485 e RS 232 yes yes yes e LVDS In Out In Out In e Ca
33. t return error Display image of page 1 or process it while receive_status CARD 0 Wait until the grab function finishes rror receive fast Get result of the grab function if error on error exit return error error grabb image full card nr 1 1 Grab image to page 1 and return control back to PC if error on error exit return error Display image of page 0 or process it while receive status CARD 0 Wait until the grab function finishes rror receive fast Get result of the grab function if if error on error exit return error 0 Success 1 Command amp parameter not send error while sending 24 User s Manual Reference Fe i th Sensor to Image GmbH No data fetched Window too large Transfer error 0 Card not initialized c ee set irq clear irq set_irq_event grabb image half grabb image half Funktion Syntax Beschreibung Attention Ramses I V3 Grab an image from a progressive camera and store it to PC memory BYTE grabb image half BYTE card nr BYTE page BYTE lflag Grab an image from a progressive camera current video in and store it to PC memory The PC memory is reserved during Windows start up from the Ramses driver With parameter page is controlled in which memory page the image is stor
34. unction Syntax Ramses V3 Gets the coordinates of the present video window BYTE get video window BYTE card nr WORD 1 WORD yl WORD x2 WORD y2 22 User s Manual Fe i th Sensor to Image GmbH Description Gets the coordinates of the current video in s video window and stores them in the following parameters x1 y1 coordinate of the upper left corner x2 y2 coordinate of the lower right corner Example get video window 1 amp xl amp yl amp x2 amp y2 Width x2 1 Height y2 yl 1 With the parameter card_nr the Ramses V3 card to talk to is specified 1 5 Return 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized Reference set video window get video input Function Return current video in Syntax BYTE get video input BYTE card nr BYTE video in Description Read current video in of the Ramses I V3 board and write it with the values 0 1 in the variable video in With the parameter card nr the Ramses card to talk to is specified 1 5 Return 0 Success 1 Command amp parameter not send error while sending 2 No data fetched 10 Card not initialized Reference set video input grabb image full Funktion Grab an image from an interlaced camera and store it to PC memory Syntax BYTE g
35. vy Connector British Naval Connector and Baby N Connector Enables a device connected to the PCl bus to control its traffic itself So it is possible for certain devices for example the harddisc controller or a framegrabber to transfer data over the PCl bus into main memory without using the host CPU This increases performance because the processor can do some other jobs during the transfer Definition for high performance datatransfer In contrast to LVDS connectors are defined too CameraLink is used increasingly for communication purposes includes data transfer with camera systems This abbreviation stands for Charge Coupled Device These photosensitive microelectronical components transform light to proportinal electrical signals A CCD sensor consists of several CCD elements either line for scanners or linescan cameras or in matrix for area scan cameras CCD elements only react with brightness so for every ground color a filter has to be applied A former standard to digitize images Direct Memory Access describes a possibility for certain devices like harddisc controller sounddevices or even framegrabber to access main memory without using the host s cpu Heteropolar plug connector Field Programmable Gate Array an electronical component which can be programmed free Addon board for PCs which records a video signal digitizes it and writes the digital image into the hosts memory Powerful framegrabb
36. y and technical Properties 2 1 Functionality The working of RAMSES V3 in general is being explained with the following block diagram m Sync 5 m 199 bw o m gt 2 Color a run m Sync m g lt gt 5 a ADC _ b w D SUB PLL yController Memory CAN Controller CAN BUS The analogue video signals of the cameras come to the board via the two DSUB connectors There they will be digitized independent from each other and therefore in a parallel manner In addition the camera s control signals can be used With the FPGA the image date be pre processed The gController is used for card specific functions camera control control of image transfer and as a helper for the host CPU Because Windows is not a real time operating system many time critical tasks can be done by the onboard controller Via the possibly pre processed data will be transferred into a reserved memory area of the PC where they can be processed further on Because of allocating the memory as an unfragemented block no wasteful mappings of logical memory to physical memory are necessary To expand the integration capabilities it is possible to connect the vision system with a CAN bu
Download Pdf Manuals
Related Search