FAST ComTec MCDWIN User Manual

Manual is about: webmca multichannel data processor

Summary of MCDWIN

  • Page 1

    Webmca multichannel data processor mcdwin user manual  copyright fast comtec gmbh grünwalder weg 28a, 82041 oberhaching, germany tel ++49 89 665180 50; fax ++49 89 665180 40 version 1.0, march 6, 2006.

  • Page 2

    Comtec gmbh iii software warranty fast comtec warrants proper operation of this software only when used with software and hardware supplied by fast comtec. Fast comtec assumes no responsibility for modifications made to this software by third parties, or for the use or reliability of this software i...

  • Page 3

    Comtec gmbh iv table of contents 1. Introduction 1-1 2. Installation procedure 2-1 2.1. Hard- and software requirements 2-1 2.2. Hardware installation 2-1 2.3. Software installation 2-2 2.4. Network configuration 2-3 2.5. Updating the firmware 2-6 3. Hardware description 3-1 3.1. Signal description ...

  • Page 4

    Comtec gmbh v 6.2.2. Preset.Xml 6-8 6.2.3. Set_preset.Xml 6-8 6.2.4. Response_getdevice_root.Xml 6-8 6.2.5. Set_spectrumlength.Xml 6-9 6.3. Delphi programming example 6-10 6.3.1. Tcptest.Dpr 6-10 6.3.2. Tcptestunit.Pas 6-10 6.3.3. Tcptestunit.Dfm 6-11 7. Technical data 7-1.

  • Page 5

    Comtec gmbh vi table of figures figure 2.1: connecting the webmca 2-1 figure 2.2: led panel of the webmca 2-2 figure 2.3: webmca config utility 2-3 figure 2.4: network configuration dialog 2-4 figure 2.5: status display 2-4 figure 2.6: scan result 2-5 figure 2.7: update dialog 2-6 figure 2.8: update...

  • Page 6

    Introduction comtec gmbh 1-1 1. Introduction the webmca is an ethernet based, high performance multi channel analyzer (mca), interfacing nim adc's to local networks as well as to the internet. Existing and new nim based electronics are easily accessible through the ethernet. The webmca is a standalo...

  • Page 7

    Installation procedure comtec gmbh 2-1 2. Installation procedure 2.1. Hard- and software requirements the following items are required using a webmca: • power over ethernet adapter (dwl-p100 included with the webmca) • 10+ mbit network connection • a pc with microsoft windows 98 / me / 2000 / xp ins...

  • Page 8

    Installation procedure comtec gmbh 2-2 the “acq” led signals the acquisition status of the device. “link” and “100m” correspond to the network interface where “100m” indicates a 100 mbit connection. 2.3. Software installation to install the mcdwin software on your hard disk insert the mcdwin cd and ...

  • Page 9

    Installation procedure comtec gmbh 2-3 2.4. Network configuration the default ip address of a webmca is 192.168.1.2. To change this address the “webmca config” utility has to be used. It can be found using the start button in the program folder "fast comtec webmca" the entries for user name and pass...

  • Page 10

    Installation procedure comtec gmbh 2-4 to transmit these parameters to the webmca the “configure” button has to be pressed. After the transmission is done you will be asked to reboot the webmca in order to accept these settings. The “status” page of the configuration tool can be used to check the de...

  • Page 11

    Installation procedure comtec gmbh 2-5 on the “search” page it is possible to scan for all available devices in the current subnet. All found devices will be listed with their ip address and their mac address. Figure 2.6: scan result.

  • Page 12

    Installation procedure comtec gmbh 2-6 2.5. Updating the firmware on the page “update” a dialog to update the firmware of the webmca is available. The ip-address has to be selected from the selection box. If the list is empty a network scan has to be done (s.A.). After selecting a firmware image fil...

  • Page 13

    Hardware description comtec gmbh 3-1 3. Hardware description 3.1. Signal description of the 25-pin adc connector sub-d male pin layout pin direction mnemonic signal 1-12 in d[0-12] inverted data d0-d12 13 in *drdy inverted data ready 14,15 in d13,d14 inverted data d13, d14 17 out *acc data accepted ...

  • Page 14

    Hardware description comtec gmbh 3-2 timing diagram 3.2. Jumper settings for the fast comtec 7070 adc to use the webmca with the 7070 adc the jumpers of the 7070 must be set as follows: figure 3.1: timing of the handshake signals figure 3.2: jumper setting for fast comtec 7070 adc.

  • Page 15

    Hardware description comtec gmbh 3-3 3.3. Network parameters for the communication with the webmca the following ip protocols and ports are used: kind of communication protocol port standard communication tcp 6668 network broadcast upd 9176-9178 update tcp 9176 ntp time synchronization sntp 123.

  • Page 16

    Windows server program comtec gmbh 4-1 4. Windows server program the window of the webmca server program webmca.Exe is shown here. It provides the full control of the webmca to perform measurements and save data. This program has no own graphic capabilities, but it provides - via a dll („dynamic lin...

  • Page 17

    Windows server program comtec gmbh 4-2 this dialog allows to edit the data settings. Mark the checkbox „save at halt“ to store a spectrum- and a configuration file at the end of a measurement. The filename can be entered. If the checkbox auto incr. Is checked, a 3-digit number is appended to the fil...

  • Page 18

    Windows server program comtec gmbh 4-3 4.1.4. System settings if more than one mca is used, the system definition dialog box comes up as shown in figure 4.5. Here the several units can be combined to form up to 4 separate systems that can be started, stopped and erased by one command. In the shown s...

  • Page 19

    Windows server program comtec gmbh 4-4 4.1.6. Remote mode the „remote mode...“ item in the settings menu or the „remote“ button in the system definition dialog boxopens the remote control dialog box. Here all settings can be made for the control of the webmca server program via a serial port. An opt...

  • Page 20

    Windows server program comtec gmbh 4-5 the file webmcaa.Cfg contains a complete list of commands for setting parameters; an example is: range=4096 ; memory size for spectra rtpreset=1000 ; realtimepreset value (seconds) rtprena=0 ; realtime preset enable (1=enabled) ltpreset=1000 ; lifetime preset v...

  • Page 21

    Windows server program comtec gmbh 4-6 cmline7=3 cmline8=ge cmline9=test range=2048 ; subset of parameters as in a webmcaa.Cfg file... Rtpreset=1000 rtprena=0 ltpreset=1000 ltprena=0 roipreset=0 roiprena=0 roimin=0 roimax=2048 autoinc=0 datname=c:\mca\data\sd0002.Mcd savedata=1 fmt=dat caluse=1 ; us...

  • Page 22

    Windows server program comtec gmbh 4-7 savedat ; saves data of actual multichannel analyzer. An existing file is ; overwritten. Pushname ; pushes the actual filename on an internal stack that can hold 4 ; names. Popname ; pops the last filename from the internal stack. Load ; loads data of actual mu...

  • Page 23

    Windows server program comtec gmbh 4-8 exec program ; executes a windows program or .Pif file. ; example: exec notepad test.Ctl ; opens the notepad editor and loads test.Ctl. Deleteallrois ; deletes all rois in the active display of mcdwin or the active ; multichannel analyzer if mcdwin is not runni...

  • Page 24

    Windows server program comtec gmbh 4-9 4.3. Controlling the webmca server via dde the webmca program can be a server for a dde (dynamic data exchange). Many windows software packages can use the dde standard protocols to communicate with other windows programs, for example grams, famos or labview. I...

  • Page 25

    Windows server program comtec gmbh 4-10 4.3.3. Dde request the dde request is a message exchange to obtain the value of a specified item. Only two items are defined for dde request up to now: range and data. The value is obtained as an ascii string, i.E. It must be converted by the client to get the...

  • Page 26

    Windows server program comtec gmbh 4-11 data with the data item the data are obtained. The value of this item is a multiline string that contains in each line a decimal number as an ascii string. 4.3.4. Close conversation after finishing the dde communication with the mca program, it must be closed....

  • Page 27

    Windows server program comtec gmbh 4-12 the following figure shows the „panel“ of the described vi for labview. Figure 4.12: control panel of the demo vi for labview.

  • Page 28

    Windows server program comtec gmbh 4-13 4.4. Controlling the webmca server via dll the webmca server program provides - via a dll („dynamic link library“) - access to all functions, parameters and data. So the server can be completely controlled from the mcdwin software that provides all necessary g...

  • Page 29

    Windows server program comtec gmbh 4-14 typedef struct { int ndevices; // number of devices: always 4 int ndisplays; // number of displays (active mca's): 0...4 int nsystems; // number of systems int bremote; // 1 if server controled by mcdwin int sys; // system definition word } acqdef; /*** functi...

  • Page 30

    Windows server program comtec gmbh 4-15 getsettingdata @3 storestatusdata @4 getstatusdata @5 start @6 halt @7 continue @8 newsetting @9 servexec @10 storedata @11 getdata @12 getspec @13 savesetting @14 getstatus @15 erase @16 savedata @17 getblock @18 storedefdata @19 getdefdata @20 loaddata @21 n...

  • Page 31

    Mcdwin program comtec gmbh 5-1 5. Mcdwin program the window of the mcdwin program is shown here. It enables the full control of the webmca via the server program to perform measurements and save data, and shows the data on-line in several windows. The server program webmca.Exe automatically starts m...

  • Page 32

    Mcdwin program comtec gmbh 5-2 in the following the several menu functions are described together with the corresponding toolbar icons. 5.1. File menu load...,add..., save, save as... These menu items provide the usual functions for loading and saving data into the mca selected by the active window....

  • Page 33

    Mcdwin program comtec gmbh 5-3 open all by selecting the open all menu item, all available displays are shown. The windows of the last opened display becomes active. Close all by selecting the close all menu item, all available displays are closed. Compare... The compare... Menu item allows to compa...

  • Page 34

    Mcdwin program comtec gmbh 5-4 if printing takes a long time and disk activity is high, please note the following: the picture for the printing is first built in the memory, but it may need quite a lot of memory if the printer resolution is high and therefore windows 9x makes intense virtual memory ...

  • Page 35

    Mcdwin program comtec gmbh 5-5 zoom the zoom item or respective icon enlarges a region to the maximum spectrum display size. Back the back menu item or clicking the corresponding icon restores the last zoom view. Each time a back command is clicked the view is stepped back one step. Zoom out the zoo...

  • Page 36

    Mcdwin program comtec gmbh 5-6 edit... With the edit item, a dialog box is opened which allows to edit the roi list, i.E. Create a new or delete, change and activate an existing roi. Also the peak values for an automatic calibration can be entered here. A roi can be edited and added to the list. It ...

  • Page 37

    Mcdwin program comtec gmbh 5-7 the full width at half maximum fwhm and position of the gaussian can be changed and a new fit can be performed, they even can be fixed to the entered value by marking the respective checkbox. The position and fwhm are displayed in channels and also in calibrated units,...

  • Page 38

    Mcdwin program comtec gmbh 5-8 the several quantities are written in standard text format with tabs as separators and a newline character at the end of each line, so the file can be read with standard calculation programs like excel. Click on print header to write a header line. Fit rois with the fi...

  • Page 39

    Mcdwin program comtec gmbh 5-9 display... The display menu item or the corresponding icon opens the display options dialog box. Here the graphic display mode of single spectra can be chosen. The 'type' combo box gives a choice between dot, histogram, spline i and line. 'dot' means that each spectra ...

  • Page 40

    Mcdwin program comtec gmbh 5-10 it provides many choices for the axis of a display. The frame can be rectangular or l-shape, the frame thickness can be adjusted (xwidth, ywidth). A grid for x and y can be enabled, the style can be chosen between solid, dash, dashdot and dashdotdot. Ticks on each of ...

  • Page 41

    Mcdwin program comtec gmbh 5-11 lin / log scale for a lin scale all data intervals have the same size. With log scale the intervals will be small for small y values and large for large y values. All options have effect only on the active display. Calibration... Using the calibration menu item or the...

  • Page 42

    Mcdwin program comtec gmbh 5-12 range, preset... The range, preset dialog box allows to make all the respective mca settings (see chapter 4.1.3). Figure 5.13: comments dialog box figure 5.14: settings dialog box.

  • Page 43

    Mcdwin program comtec gmbh 5-13 data... The data dialog box allows to make all the respective data operations and settings (see chapter 4.1.2). System... The system definition dialog box allows to make all the respective settings (see chapter 4.1.4). Figure 5.15: data operations dialog box figure 5....

  • Page 44

    Mcdwin program comtec gmbh 5-14 tool bar... Selecting the tool bar menu item opens the tool bar dialog box. It allows to arrange the icons in the tool bar. If it is enabled, an array of icons in the mcdwin menu is shown. Clicking the left mouse button with the cursor positioned on an icon, the user ...

  • Page 45

    Comtec gmbh 5-15 5.5. Action menu the action menu or corresponding toolbar icons contain the commands to start, stop, continue and erase a measurement. If more than one systems are formed, also more actions menus are available, otherwise they are grayed. Start the start toolbar button erases the dat...

  • Page 46

    Webmca programming comtec gmbh 6-1 6. Webmca programming 6.1. Overview of the xml commands for controlling the webmca 6.1.1. Version-object version contains the actual protocol version. Attribute(s) req. Content description id x protocol version protocol version 6.1.2. Error-object version contains ...

  • Page 47

    Webmca programming comtec gmbh 6-2 6.1.5. Serial-object serial contains the srial number element req. Content description serial x serial (max. 25 characters) serial number as string 6.1.6. Revision-object revision contains the hard- and software revision element req. Content description software x ...

  • Page 48

    Webmca programming comtec gmbh 6-3 6.1.8. Device-object device elements req. Content devicetype x device type revision x hard- and software revision serial x device serial number parameter x parameter 6.1.9. Parameter-object parameter elements req. Content measurement measurement parameter network n...

  • Page 49

    Webmca programming comtec gmbh 6-4 6.1.11. Preset-object preset start-/stop conditions elements req. Content start_condition value (only for date/time) stop_condition value (for date/time, realtime, livetime, counts) 6.1.12. Start_condition-object start_condition attribute(s) req. Content type x typ...

  • Page 50

    Webmca programming comtec gmbh 6-5 6.1.16. Command-object command elements req. Content name x name of command name: getdevices results a list of connected devices. Getdevice results the parameters of a device. Clearspectrum cleares spectra; select spectra via parameter objectid=n acquisition starts...

  • Page 51

    Webmca programming comtec gmbh 6-6 comment comment (r/w) name spectra name (r/w) unit_x unit of x-axis (r/w) unit_y unit of y-axis (r/w) stabilization parameter for software-controlled peak position stabilization im phas-mode (r/w) (for future use) mcs parameter for software mcs-mode (r/w) (for futu...

  • Page 52

    Webmca programming comtec gmbh 6-7 6.1.21. Calibration-object calibration_x/_y parameter for spectra elements req. Content data x polynome parameter 6.1.22. Data-object data polynome parameters for calibration attribute(s) req. Content id x actual content of array.

  • Page 53

    Webmca programming comtec gmbh 6-8 6.2. Xml examples 6.2.1. Command_acquisition.Xml 0.1.0 6.2.2. Preset.Xml // first start condition value // 0 manual, 1 extern, 2 date // ... // first stop condition type="n">value // 0 none, 1 extern, 2 date, 3 realtime, 4 livetime, 5 counts // ... 6.2.3. Set_prese...

  • Page 54

    Webmca programming comtec gmbh 6-9 1 root-device 0.0.0 0.0.0 00:aa:aa:aa:aa:aa 192.168.1.2 255.255.255.0 192.168.1.1 192.168.1.1 192.168.1.2 192.168.1.3 0 6.2.5. Set_spectrumlength.Xml 0.1.0 0 2048 0

  • Page 55

    Webmca programming comtec gmbh 6-10 6.3. Delphi programming example the example is based on the ics - internet component suite http://www.Overbyte.Be http://www.Rtfm.Be/fpiette/indexuk.Htm http://users.Swing.Be/francois.Piette/indexuk.Htm copyright (c) 1997-2001 by françois piette rue de grady 24, 4...

  • Page 56

    Webmca programming comtec gmbh 6-11 begin memo2.Lines.Add(wsocket.Receivestr); end; procedure tform1.Formclose(sender: tobject; var action: tcloseaction); begin wsocket.Close; end; procedure tform1.Button2click(sender: tobject); begin wsocket.Addr:=edit1.Text; wsocket.Connect; end; end. 6.3.3. Tcpte...

  • Page 57

    Webmca programming comtec gmbh 6-12 end object memo2: tmemo left = 24 top = 216 width = 401 height = 249 scrollbars = ssvertical taborder = 2 end object edit1: tedit left = 104 top = 16 width = 121 height = 21 taborder = 3 text = 'edit1' end object button2: tbutton left = 264 top = 16 width = 75 hei...

  • Page 58

    Comtec gmbh 6-13 figure 6.1: delphi example.

  • Page 59

    Technical data comtec gmbh appendix 7-1 7. Technical data general: device type: ................................................Network mca for nim-adcs processor: ................................................................. 32 bit risc 66 mhz adc-control:..........................................