Technical Information Manual
Contents
1. Filename CAENVMETool_REV0 doc VALUE v1718 V2718 0 N 1 0 N 1 OxXHHHH HHHH DESCRIPTION Allows to set the used VME bridge Allows to set the link number see documentation of CAENVMELib Allows to set the board number see documentation of CAENVMELib Allows to set MSW of theVME address of the board Hex or Dec format Number of pages Page 16 162. The oscilloscope window shows The grid The enabled channels with the following options e Marker of trigger position e Marker of vertical position e Cursor if enabled 3 2 1 14 CAENScope Settings The main settings of CAENScope are in series on a text file settings txt This file has a tree structure and can be modified via a common text editor The configuration file is loaded as the application is launched and saved as the application is exited All the modifications made manually editing the file during the application execution will be overwritten as the application is exited Normally the User will not edit manually since it is better to use the CAENScope commands in order to edit the functional parameters Some parameters used by CAENScope in read only mode make exception and must be set una tantum by the User such parameters are written in bold in the following The file is divided into sections defined by an alphanumerical identifier The section identifier ha sthe following format parent list Jidentifier where parent list identifier of the father section not present in the root identifier unique alphanumerical identifier of parent section or root Example SEZ1 identifies section SEZ1 SEZ1 SUB1 identifies section SUB1 inside SEZ1 Each section is composed by couples token value where token unique alphanumerical identifier inside section associated to the parameter to be
3. o 1000 gt A 1000 2 w lt gt o J 5 fo 117 12 Reset channel view offset z 0 7 1000 4 5 EE 2 0 1000 A H 4 gt COMMON TRIGGER RECORD Buffer size Channels 0 1 2 3 4 5 6 l l 512 v Enable Enable Enable Enable Enable Enable Enable Disable Enable Ext signals z Sec Div F 4 Z F F z A Z Cnm fos F pac offset o i Co i Lo BM Co MB L A e e Le e L g Ext clock Medium my 0 0 0 0 o 0 0 010 0 Overload A a a a a a g RUN AUTO TRIG RAISING EDGE TTL Fig 3 2 Main screen 3 2 1 3 CAENScope Toolbar GQ Y Exit Left Bottom About Fig 3 3 Toolbar The Toolbar contains the command and visualisation buttons Exit allows to close the application Left allows to display hide the Left Top panel Bottom allows to display hide the Bottom panel About allows to display the dialog about window information about application and CAENVMET oo library release CAEN Scope about CAE N 0 CAEN Scope 3 z CAENYMETool usage demo software Tools for Discovery CAENSCOPE Rev 1 0 CAENVMETool Rev 1 0 www caen it Fig 3 4 About box NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 10 Document type User s Manual MUT NPO PRELIMINARY Title Revision date Revision CAENVMETool 07 11 2006 0 3 2 1 4 CAENScope Statusbar REC EXT CLK EXT TRIG AUTO TRIG RAI
4. NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 5 EA a PRELIMINAR Y Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 gt CAEN 3 5 CAENYMETool 3 Demo 5 CAENScope O bin O doc include O CAENVMELib O CAENYMETool B src 3 Lib O bin 3 doc O html 5 include O CAENYMELib src Fig 2 2 Installation folder structure 2 1 1 1 Software installation Lib folder This folder contains the CAENVMETool library bin contains the compiled library as file lib doc contains miscellaneous documentation on the library include contains all the functions necessary to the operation and recompiling of the library src contains the sources of the library A solution file for Microsoft Visual Studio 2003 lib sIn is provided in order to modify and recompile the library 2 1 1 2 Software installation Demo folder This folder contains the demo applications of the library each demo contains a sub folder with the following structure bin contains the application compiled as file exe in Release version doc contains miscellaneous documentation on the demo application include contains all the functions necessary to the operation and recompiling of the application Third part libraries make exception ex wxWidgets and have to be installed through the proper tools src contains the sources of the application that this fold
5. 11 2006 0 e color e line size Pixel e line type NOGRID SOLID DASHED DASH DOT DOTTED Channel allows to set the channel visualisation e color e line size Pixel e Vertical visualisation offset by clicking 0 the offset is reset A marker on the left of the oscilloscope window shows the signal 0 level e Vertical resolution mV Div CURSORS H 0 gt ous 0 Enable 0 mv 1 0 lt gt 0 uS Enable 0 mu 2 OL la 0 us Enable 0 mv 3 x p lt x lt x nn lt lt gt ous Enable x 1 v 0 mv 4 s ous Enable Le x 1 W 0 mv Fig 3 10 CURSORS tab 3 2 1 11 CAENScope CURSORS tab This tab contains the cursors settings Enable allows to enable disable the channel cursors Cursor position by clicking on 0 the cursor position is reset The multiplying factor sets the cursor increase step uS cursor position us mV signal value at the cursor position 3 2 1 12 CAENScope Top Right pane This section contains one tab SCOPE which represents the oscilloscope window VIEW general setting CURSORS cursor setting NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 14 C A E R PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 3 2 1 13 CAENScope SCOPE tab SCOPE Fig 3 11 SCOPE tab
6. contains controls for setting the trigger functions Ext allows to enable disable the trigger on the external signal Auto allows to enable disable the production of continuous software trigger commands Force forces the trigger sends an unique software trigger command Post Trigger allows to set the post trigger value i e the number of samples from the bottom of the acquired buffer Post Trigger Keep position if enabled allows to keep the post trigger point fixed on the display as the time scale changes CAENScope automatically adjusts the horizontal offset Edge NO TRIG RAISING FALLING allows to select the edge for the trigger as the threshold set for each channel is exceeded This setting is common to all channels Channels Threshold mV threshold for triggering on a particular channel Channels Thr samples number of samples for which the trigger condition must be kept threshold exceeded on leading trailing edge before trigger production 3 2 1 8 CAENScope RECORD tab RECORD Channels 0 1 2 3 4 5 6 7 Enable Enable Enable Enable Enable Enable Enable Enable Enable 6 s 1 1 1 1 1 2 1 Rate divider 1 Folder A il 5 E File format HEX vw ascuoe we asci Helv Hex x Hex x Hex x Hex x Hex y Fig 3 8 RECORD tab This tab contains the controls for setting the functions of data recording on file Start Stop it allows to start stop d
7. cvt_board_commons c cvt_common_defs h and a couple of files made to measure for each board cvt_V c cvt_V h Supported boards are V792 V812 1190 V1495 V1724 Common definition files cvt_board_commons h cvt_common_defs h provide data structure definition and API s common to all boards such as register read write set and reset of registers bitmasks etc The board definition files cvt_V c cvt_V h provide data structure definition and API s related to the board such as registers address access type address modifier and data size registers bitmask API s and data structures extend the API s common to all boards Filename Number of pages Page CAENVMETool_REV0 doc 16 Document type User s Manual MUT 3 2 NPO PRELIMINARY Title Revision date Revision CAENVMETool 07 11 2006 0 3 1 2 CAENVMET oo library typical use All the board modules are used as follows Obtaining a valid vme_handle using CAENVMELib see documentation of the CAENVMELib Module opening cvt_V open cvt_V data p data UINT16 base_address long vme_handle Usage of API s of the library cvt_V _ all the APIs of the library use as input parameter cvt_V data p_data initialised on module s opening Module s closing cvt_V close cvt_V data p_data Release of vme_handle using CAENVMELib see documentation of the CAENVMELib Demos software Demo softw
8. set value token value value type int double string etc depends on the relevant parameter Example NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 15 Document type User s Manual MUT NPO Title CAENVMETool item1 10 0 gives value 10 0 to item1 item2 text String gives value 10 to item1 one section can include several daughter sections RECORD RECORD_FOLDER TRIGGER TRIGGER_MSK 4 POST_TRIGGER 12060 TRIGGER_POSITION_KEEP 1 TRIGGER_EDGE 1 SAMPLE_BLOCK_SIZE 5 MISC VME_BOARD_TYPE V2718 VME_LINK 0 VME_BOARD_NUM 0 GRID_LINE_COLOR 0xffff80 GRID_LINE_TYPE 4 GRID_LINE_WIDTH 2 OFFSET_SEC 0 INT_RATE_MHZ 100 EXT_RATE_MHZ 10 USE_EXT_CLOCK 0 USE_TTL 1 SEC_2_DIV 100000 MAX_LOG_X 16384 BACKGROUND_COLOR 0x000000 ACQ_BOARD_NUM 1 ACQ_BOARDS ACQ_ BOARDS BOARD_TYPE V1724 ADDRESS 0x3210 NUM_CHANNEL 8 ACQ_BOARDS ENABLED 1 LINE_COLOR 0x80ffff LINE_WIDTH 1 OFFSET_Y 0 VOLT_2_BIT 6553 6 VOLT_2_DIV 10 DAC_OFFSET_BIT 20 DAC_VOLT_2_BIT 26214 4 TRIGGER_THRESHOLD_VOLT 1 TRIGGER_THR_SAMPLE 620 RECORD_RATE_DIVIDER 1 RECORD_ENABLED 1 RECORD_FORMAT 1 PRELIMINARY Revision date Revision 07 11 2006 0 The parameter that the User has to edit in bold at least one time prior to application launch are described in the following table Table 3 1 User settings ITEM MISC VME_BOARD_TYPE MISC VME_LINK MISC VME_BOARD_NUM ACQ_BOARDS ADDRESS
9. RPE RE Technical Information Manual Revision n 0 7 November 2006 CAENVMETool LIBRARY AND DEMO APPLICATION SOFTWARE CAEN will repair or replace any product within the guarantee period if the Guarantor declares that the product is defective due to workmanship or materials and has not been caused by mishandling negligence on behalf of the User accident or any abnormal conditions or operations CAEN declines all responsibility for damages or injuries caused by an improper use of the Modules due to negligence on behalf of the User It is strongly recommended to read thoroughly the CAEN User s Manual before any kind of operation CE CAEN reserves the right to change partially or entirely the contents of this Manual at any time and without giving any notice PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 TABLE OF CONTENTS T GENERAL DESCRIPTION veccessessgscececaeeeges seek E iaa EEE 4 lls VONER VIE Week ss fest ect da Ito Mea 4 2 SOFTWARE INSTALLATION res 5 2 1 SOFTWARE INSTALLATION GETTING STARTED cccscssssccececeesecceceeccecseaaesecccecseseeaeceeececeeseaseeeeeeeeensas 5 2 1 1 Software installation WindOWS ccccccccsssssscsscecsesssssesccscsesseessesceeceessessssscecsessesssssesceeseesessesess 5 2 1 1 1 Software installation Lib foldet cccccccesceecesscese cess cnseeaeeeseeeseeeseeseeeseceseensecaececesecnaeonaeonae 6 2AL 2 Soft
10. SING EDGE TTL Fig 3 5 Statusbar The Statusbar provides information about the application operational RUN if displayed indicates that CAENScope is receiving data from the board REC if displayed indicates that CAENScope is recording data from enabled channels on file EXT CLK if displayed indicates that the provided sampling clock is external CAENScope uses this information only for the correct setting of the time reference EXT TRIG if displayed indicates that the trigger on external signal is enabled AUTO TRIG if displayed indicates that the software trigger is enabled CAENScope sends continuously software trigger signals to the board RISING EDGE FALLING EDGE if displayed indicates the triggering edge as the channel reaches the threshold value TTL NIM indicates the type of signal used on the front panel of the board 3 2 1 5 CAENScope Bottom panel This section contains the controls to set the CAENScope functions It is composed by three tabs COMMON general commands TRIGGER triggering commands RECORD data record commands 3 2 1 6 CAENScope COMMON tab COMMON Ext signals Buffer siz e Channels 0 1 2 3 4 5 6 7 16K xj Enable Disable Disable Enable Enable Enable Enable Enable Enable pac offset ioa Ged od Gea od 6 God bed E od E Ext clock Medium mV 0 o o o D D D 0 Overload i i mu a w a E Fig 3 6 COMMON tab This tab contains the contr
11. ares are applications which run on boards or board families and show the usage of the CAENVMETool These applications can be used both as example of library usage and to test the board operation 3 2 1 Demos software CAENScope 3 2 1 1 CAENScope Overview CAENScope is a graphical application that implements an oscilloscope and shows the usage of the V1724 through the API s provide by the CAENVMETool cvt_V1724 h cvt_V1724 c The software is written in C using the libraries of open source classes wxWidgets v 2 6 3 http www wxwidgets org After installation before launching the program it is necessary to edit the configuration file and to set the parameters as shown in 3 2 1 14 3 2 1 2 CAENScope Main screen All the commands and application visualisations are available from the main window which is divided into three sections Toolbar Statusbar Bottom panel contains the tabs for setting the boards functions this section can be hidden via the toolbar command Top Left panel contains tabs which allows to modify visualization settings this section can be hidden via the toolbar command Top Right panel displays the signal visualisation Filename Number of pages Page CAENVMETool_REV0 doc 16 9 C A E R PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 EE CAEN SCOPE 10 Exit Left Bottom About pein E A VIEW CURSORS SCOPE 5 A EE
12. ata recording on file for each enabled channel a file in the selected destination folder is produced in the selected format The filename is the following caen_scope_BOOC _YYYY_MM_DD_hh_mm_ss ext where e channel index e YYYY current year e MM current month e DD current day e hh current hour e mm current minute e ss current second NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 12 PA Ema PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 e ext extension depending on file format bhx binary format data are saved on 4 Byte word in two complement format adc decimal ASCII format data are saved on distinguished lines separated by n r in decimal ASCII format ahx hexadecimal ASCII format data are saved on distinguished lines separated by n r in hexadecimal ASCII format Folder allows to select the folder where files are saved It is possible to edit directly either absolute or relative paths each editing is confirmed by pressing lt ENTER gt The field has red background if the path is incorrect or not confirmed By Clicking on the button it is possible to select the existing path via graphical interface Channels enable allows to enable disable the channel for data recording Each enabled channel must be enabled for acquisition tab Common Channels enable because no samples are available for disabled channels Cha
13. eensas 6 FIG 2 37PROGRAM MENU DEMO ai A a AA da Hess tas RG IA ai dica 6 FIG 2 4 PROGRAM MENU LIBRARY ccccccsessscecececeessssececececeeseueaecececeenenssaesecececsesaaeseccceeseeaaececececsessaaseeeeeeeeeneas 7 FIG 3 LU SOFTWARELA TER ide 8 EIG23 2 MIATN SCREEN nto ti leo it att ento e Re Trate ers canoe eee 10 HG32 TOOLBAR A a A a NT Boe Sateen eS 10 BIG 34 ABOU DIB OX cesta arte o O oe Oe cere S 10 EAN SN NA 11 EIG 3 6 COMMON TAB a a tl ete 11 HG IT TRIGGER TAB A A ta ES 12 RIG 3 82 RECORD TABS ld 12 PGE A A SAE DEN s EAEE A isis 13 EIG lt 3 103 CURSORS FAB 0d A AE A EA EE AEE 14 fy Ps PO SC OPE TAB a A e a E Pe 15 LIST OF TABLES SUN ID AER 1 BE S E A UN E e E EA EET 16 NPO Filename CAENVMETool_REV0 doc 16 Number of pages Page 3 C A E R PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 1 General description 1 1 NPO Overview CAENVMET ool is a software package that facilitates the CAENVMELib usage it consists of a library and a set of demo s applications showing the the CAENVMETool library usage CAENVMETool is a demo application software set which allows an easy management of the CAENVMELib CAENVMETool library provides for each supported board API s which allows to perform the most common operations such as configuration readout etc masking the lowest level details such as registers address access type data size etc t
14. er contains A solution file for Microsoft Visual Studio 2003 lib sIn is provided in order to modify and recompile the library The structure of the applications menu will be as follows fa CAEN gt Gm CAENYMETool gt fe AAA CAENScope Folder Y CAENYMETooIReadme CAENScope Y CAENVMEToolReleaseNotes Uninstall CAENVMETOO Library gt Fig 2 3 Program menu demo Filename Number of pages Page CAENVMETool_REV0 doc 16 EA a PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 It is possible to read the release notes the readme file the library project folders and the demo applications fm CAEN gt h CAENVMETool S 7 Demo Y CAENVMETooIReadme Y CAENVMEToolReleaseNotes 13 Uninstall CAENYMETOO a Library Documentation fam Library Folder Fig 2 4 Program menu library NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 7 EA a PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 3 Software overview 3 1 NPO CAENVMETooI library 3 1 1 CAENVMET oo library Overview The CAENVMETool library is written in C language and is a middleware tool between CAENVMELib and the User application end user application Fig 3 1 Software layers The library has a modular structure it is made up by a set of files common to all boards cvt_board_commons h
15. nnels rate divider allows the setting of a samples rate divider CAENScope saves one sample every N acquired N is the setting of rate divider Channels file format allows the setting of the output files setting e HEX binary format data are saved on 4 Byte word in two complement format e ASCII DEC decimal ASCII format data are saved on distinguished lines separated by n r in decimal ASCII format e ASCII HEX hexadecimal ASCII format data are saved on distinguished lines Separated by n r in hexadecimal ASCII format 3 2 1 9 CAENScope Top Left panel This section contains the controls for setting the visualisation of CAENScope The controls are VIEW general settings CURSORS cursor settings 3 2 1 10 CAENScope VIEW tab FREED HIEW Background E Horizontal 10 Grid CG 2 S poreo Y D EG g ws lr Je aliia E v E WO Ji E f o 2 100 e UA x a ME 1S A 2 Je danna LA a 3 MW Sl fho 350 Sunn e x Fig 3 9 VIEW tab This tab contains the controls of visualisation settings Background allows to set the oscilloscope background color Horizontal allows to set the horizontal visualisation offset us Grid allows to set the following grid parameters NPO Filename Number of pages Page CAENVMETool_REV0 doc 16 13 CA Ema PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07
16. o the developer Provided include files ANSI C can be also used independently from the library they provide all the definitions registers address access type data size registers bit mask etc necessary to develop any application Application sets shows the most common use of CAENVMETool library for any supported board These can be used to test the board operation and the CAENVMETool library usage Filename Number of pages Page CAENVMETool_REV0 doc 16 4 EA a PRELIMINAR Y Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 2 Software installation 2 1 Software installation Getting started Place the CD in the CD tray in your PC then the following window will open CAEN Tools for Discovery CD Software Pack The CAEN VME Bridges Demo Program is an user friendly Install CAEN VME Bridges interface for the CAEN Bridges V1718 V2718 VX1718 Demo 4xX2718 control Suitable for Windows 2000 XP CAENYMETooI is a software package that facilitates the CAEN VME Software Library usage it consists of a library and a set of demo s applications Suitable for Windows 2000 XP Install CAENVMETool eee CAENScope Demo for CAENScope is a graphical application that implements an Y1724 oscilloscope and shows the usage of the 41724 through the 1724 CAENVMETool API Suitable for Windows 2000 XP All the components for the Linux Operating System are a
17. ols for setting the common functions of CAENScope Run Stop allows to enable disable the request of samples from the data buffer of the board Ext signals NIM TTL allows to set the level of the external signal used on the board NIM or TTL CAENScope sends to the board the right command for the selected setting Buffer size allows to select the size of data buffer required to the board for single access Sec Div allows to set the displayed time scale Ext Clock if enabled CAENScope uses as sampling rate MHz the set value otherwise the internal value 100 MHz is used Channels enable allows to enable disable the channel visualisation Channels DAC offset allows to set the offset added to the input channel press 0 to reset Filename Number of pages Page CAENVMETool_REV0 doc 16 11 C A E R PRELIMINARY Document type Title Revision date Revision User s Manual MUT CAENVMETool 07 11 2006 0 Channels medium mV provides the average value of the signal averaged over the samples in the buffer Channels overload indicates saturation red values high or low normal values green 3 2 1 7 CAENScope TRIGGER tab TRIGGER Post Trigger Channels o 1 2 3 4 5 6 7 9985 e Threshold mv 1000 S 1250 2 1250 S 1250 1250 S 1250 5 1250 51250 e eiii Y Keep position Thr samples 174 2 lo a llo lo 2 lo a lo ME 2 o 2 RAISING v Fig 3 7 TRIGGER tab This tab
18. vailable here See the Readme file to install the software Windows developers can install the CAEN YME Software Library to build their own software application in order to use Programmer s Interface and control the module A LabYiew library is provided too All the components for the Linux Operating System are available here See the Readme file to install the software This section contains the technical manuals of CAEN YME User Guides products and other documents related to CAEN VME technology Keep yourself updated with the latest technical information Online Resources visiting periodically the CAEN web site Important Notice This note is dedicated to owners of V17 18 V2718 modules with firmware releases previous to 0 12 All the software included in this CD doesn t work with 1718 2718 modules equipped with firmware releases previous to 0 12 Please contact support computing caen it to obtain the needed support in order to upgrade your hardware 0 2006 CAEN Costruzioni Apparecchiature Elettroniche Nucleari spa All rights reserved Ver 2 5 Fig 2 1 The Software amp Documentation Pack CD introduction Click on Install CAEN VMETool amp CAENScope Demo in order to install the provided user friendly interface which allows an easy and immediate control of the module 2 1 1 Software installation Windows As installation is completed the structure of the created folders will be as follows
19. ware installation Demo folder ccccccccsccesscesscesecnseenseeseeeseessceseceseesseeseeeseeesecesecaeenaeenae 6 3 SOFTWARE OVERVIEW cosida rta ie dd datada 8 317 EAENVMETOOL LIBRARY cta a o codes 8 3 1 1 CAENV METool library Oye Vie Wario ia 8 3 1 2 CAENVMETool library typical Use 0 o ooononciononononnonononoonnon cnn coo nono non sirai E dn none i birras 9 32 IDEMOS SOFTWARE ups ao E IN E as EU A Ss 9 3 2 1 Demos software CAENS CODE henare nirani aari e e E N A TATE 9 3 2 1 1 CAENSCOpeS OVETVIEW minnene GE ES Os aS eee E 9 3 2 1 2 CAENSCOPC Main SCLE CI seuss iw di a este os 9 21 3 CAENSCOpe Toolbatrsenn eas ee RI Aa Se SLR a st 10 3 2 1 4 CAENS cope St t sbat ii da A ea aT Rectan dost 11 3219 CAENScope Bottom panel oca its 11 3 2 1 6 CAENScope COMMON tbose poeier E ida 11 ILLA CAENScope TRIGGER GD vss copii a E ETE 12 3 2 1 8 CAENScope RECORD TdbDi coi in ie 12 3 2 1 9 CAENScope Top Left panel as 13 IZO CAENS CODE VIEW tab 00 a ects thee eae ete Bee 13 321 11 gt CAENSCope CURSORS tab iii naaa s 14 32112 CAENSCope Top Right pane conidios ondaa pdas 14 S2AT3 CAENSCOPe SC ORE AD andadas 15 B2114 lt CAENSCOPES CUINA dci das 15 LIST OF FIGURES FIG 2 1 THE SOFTWARE amp DOCUMENTATION PACK CD INTRODUCTION oococcccconooonnnononccnononnanononcononnanonononconinannns 5 FIG 2 2 INSTALLATION FOLDER STRUCTURE ccccessssssceccceceesensececececeesescaeceeececsesaaecececeeseeaaeceeececsessaaeeeeeese
Download Pdf Manuals
Related Search