Summary of Contents for FAST ComTec 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 You have purchased the license to use this software, not the software itself. Since title to this software remains with FAST ComTec, you may not sell or transfer this software. This license allows you to use this software on only one compatible computer at a time. You must get FAST ComTec's written permission for any exception to this license.
-
Page 3: Table Of Contents
Network Configuration 2.5. Updating the Firmware Hardware Description 3.1. Signal description of the 25-pin ADC connector 3.2. Jumper settings for the FAST ComTec 7070 ADC 3.3. Network parameters Windows Server Program 4.1.1. WEBMCA.INI file 4.1.2. Data Operations 4.1.3. MCA Settings 4.1.4. - Page 4 6.2.2. Preset.xml 6.2.3. Set_Preset.xml 6.2.4. Response_getdevice_root.xml 6.2.5. Set_Spectrumlength.xml 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 Technical Data ComTec GmbH...
- Page 5 Figure 2.7: Update dialog Figure 2.8: Update successfull Figure 3.1: Timing of the handshake signals Figure 3.2: Jumper setting for FAST ComTec 7070 ADC Figure 4.1: WEBMCA Server program Figure 4.2: Sample WEBMCA.INI file Figure 4.3: Data Operations dialog box Figure 4.4: MCA Settings dialog box...
-
Page 6: Introduction
The sophisticated WINDOWS based control and analysis software MCDWIN ensures quick learning and easy usage. Some of MCDWIN’s features are high resolution graphics displays with zoom, linear and logarithmic (auto)scaling, grids, ROIs, Gaussian fit, calibration using diverse formulas. and FWHM calculations. -
Page 7: Figure 2.1: Connecting The Webmca
• 10+ Mbit network connection • A PC with Microsoft Windows 98 / ME / 2000 / XP installed is required for use of the supplied control and analysis software MCDWIN. 2.2. Hardware Installation The webMCA has to be connected to the local network either with a Power over Ethernet (PoE) adapter DWL-P100 or a PoE switch using a +48V power supply for the PoE device (optional). -
Page 8: Figure 2.2: Led Panel Of The Webmca
“100M” indicates a 100 Mbit connection. 2.3. Software Installation To install the MCDWIN software on your hard disk insert the MCDWIN CD and start the installation program file by double clicking SETUP A directory called C:\WEBMCA is created on the hard disk and all webMCA and MCDWIN files are transferred to this directory. -
Page 9: Figure 2.3: Webmca Config Utility
Installation Procedure 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" Figure 2.3: WebMCA Config utility The entries for user name and password in the login dialog are not evaluated currently and can be left blank. -
Page 10: Figure 2.4: Network Configuration Dialog
Installation Procedure Figure 2.4: Network configuration dialog 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 11: Figure 2.6: Scan Result
Installation Procedure 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 ComTec GmbH... -
Page 12: Figure 2.7: Update Dialog
Installation Procedure 2.5. Updating the Firmware On the page “Update” a dialog to update the firmware of the webMCA is available. Figure 2.7: Update dialog 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.). -
Page 13: Hardware Description
Hardware Description Hardware Description 3.1. Signal description of the 25-pin ADC connector Sub-D male pin layout Direction Mnemonic Signal 1-12 D[0-12] Inverted Data D0-D12 *DRDY Inverted Data Ready 14,15 D13,D14 Inverted Data D13, D14 *ACC Data Accepted *STOP Stop ADC Inverted Data D15 Inhibit, Drop Data DTIME... -
Page 14: Figure 3.1: Timing Of The Handshake Signals
Figure 3.1: Timing of the handshake signals 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.2: Jumper setting for FAST ComTec 7070 ADC ComTec GmbH... -
Page 15: Network Parameters
Hardware Description 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 6668 Network broadcast 9176-9178 Update 9176 NTP time synchronization SNTP ComTec GmbH... -
Page 16: Figure 4.1: Webmca Server Program
This program has no own graphic capabilities, but it provides - via a DLL („dynamic link library“) - access to all functions, parameters and data. The server can be completely controlled from the MCDWIN software that provides all necessary graphic displays. -
Page 17: Figure 4.3: Data Operations Dialog Box
Windows Server Program Figure 4.3: Data Operations dialog box 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. -
Page 18: Figure 4.5: System Definition Dialog Box, Two Webmcas
.MCD is saved. This header also contains all settings and in addition some information like the date and time of the measurement, comments and calibration parameters entered in the MCDWIN program. ComTec GmbH... -
Page 19: Figure 4.6: Remote Control Dialog Box
A sequence of commands that are stored in a file with extension .CTL can be executed by the WEBMCA server program or MCDWIN with the „Load “ command. Also the configuration files WEBMCAA.CFG or the header files with extension .MCD ontain such commands to set the parameters. - Page 20 Windows Server Program 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 value (seconds) ltprena=0 ;...
- Page 21 Windows Server Program 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 ; Use Energy calibration calch00=1172.00 ; Calibration points.. calvl00=1173.264000 calch01=1331.00 calvl01=1332.500000 caloff=-0.506315 ;...
- Page 22 ; Smoothes the data in actual multichannel analyzer eras ; Clears the data of system 1. exit ; Exits the MCA.exe (and MCDWIN) programs alert Message ; Displays a Messagebox containing Message and an OK button that ; must be pressed before execution can continue.
- Page 23 ADC? ; Sends the AXAS Status sendfile filename ; Sends the ASCII file with name ‘filename’ via the serial line. The execution of a control file can be finished from the Server or MCDWIN with any Halt command. ComTec GmbH...
-
Page 24: Figure 4.7: Opening The Dde Conversation With The Webmca Server In Labview
Windows Server Program 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. In the following the DDE capabilities of the server program are described together with a demo VI („Virtual Instrument“) for LabVIEW. -
Page 25: Figure 4.8: Executing A Control Command From A Labview Application
Windows Server Program Figure 4.8: Executing a control command from a LabVIEW application 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. -
Page 26: Figure 4.10: Getting The Data With Labview
Windows Server Program 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. Figure 4.10: Getting the data with LabVIEW 4.3.4. -
Page 27: Figure 4.12: Control Panel Of The Demo Vi For Labview
Windows Server Program The following figure shows the „Panel“ of the described VI for LabVIEW. Figure 4.12: Control Panel of the demo VI for LabVIEW ComTec GmbH 4-12... -
Page 28: Controlling The Webmca Server Via Dll
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 graphic displays. - Page 29 // 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; /*** FUNCTION PROTOTYPES (do not change) ***/ VOID APIENTRY StoreSettingData(ACQSETTING FAR *Setting, int nDisplay);...
- Page 30 Windows Server Program GetSettingData StoreStatusData GetStatusData Start Halt Continue NewSetting ServExec StoreData GetData GetSpec SaveSetting GetStatus Erase SaveData GetBlock StoreDefData GetDefData LoadData NewData HardwareDlg UnregisterClient DestroyClient ClientExec LVGetDat RunCmd AddData LVGetRoi LVGetCnt LVGetStr SubData Smooth ComTec GmbH 4-15...
-
Page 31: Figure 5.1: Mcdwin Main Window
MCDWIN Program 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 MCDWIN. If you try to start MCDWIN before the server is started, a message box warns that you should start the server first. -
Page 32: Figure 5.2: Mcdwin Map And Isometric Display
MCDWIN Program Figure 5.2: MCDWIN Map and Isometric display 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: Figure 5.3: File New Display Dialog Box
MCDWIN Program Figure 5.3: File New Display dialog box 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. -
Page 34: Window Menu
The Window menu allows to arrange the Display windows. Tile With the Tile menu item or clicking the corresponding icon, all opened and displayed MCDWIN Display windows are arranged over the full MCDWIN client area trying to allocate the same size for each window. Cascade The Cascade menu item or respective icon arranges all windows in a cascade display. - Page 35 MCDWIN Program 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.
-
Page 36: Figure 5.5: Roi Editing Dialog Box
MCDWIN Program 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. -
Page 37: Figure 5.6: Single Gaussian Peak Fit
MCDWIN Program Figure 5.6: Single Gaussian Peak Fit 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. -
Page 38: Figure 5.7: Log File Options For The Single Gaussian Peak Fit
MCDWIN Program Figure 5.7: Log file Options for the Single Gaussian Peak Fit 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. -
Page 39: Figure 5.8: Colors Dialog Box
MCDWIN Program Figure 5.8: Colors dialog box 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. -
Page 40: Figure 5.10: Axis Parameter Dialog Box
It allows to change the ranges and attributes of a Spectrum axis. By setting the Auto scaling mode, the MCDWIN will automatically recalculate the maximum y axes of the visible Spectrum region only. To keep the same height of the visible region for a longer time, set the Auto scaling mode off. -
Page 41: Figure 5.12: Calibration Dialog Box
MCDWIN Program 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. -
Page 42: Figure 5.13: Comments Dialog Box
MCDWIN Program Figure 5.13: Comments dialog box Range, Preset... The Range, Preset dialog box allows to make all the respective MCA settings (See chapter 4.1.3). Figure 5.14: Settings dialog box ComTec GmbH 5-12... -
Page 43: Figure 5.15: Data Operations Dialog Box
MCDWIN Program Data... The Data dialog box allows to make all the respective Data operations and settings (See chapter 4.1.2). Figure 5.15: Data Operations dialog box System... The System Definition dialog box allows to make all the respective settings (See chapter 4.1.4). -
Page 44: Figure 5.17: Tool Bar Dialog Box
Status window The same way it is possible to hide or show the status window at the left side of the MCDWIN main window. The fonts can be chosen between a larger and smaller set if again selecting this item. -
Page 45: Action Menu
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 data and starts a new measurement. Halt The Halt toolbar button stops a measurement. -
Page 46: Webmca Programming
WEBMCA Programming 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 Protocol version Protocol version 6.1.2. Error-Object VERSION Contains the error number of a REQUEST Element req. -
Page 47: Serial-Object
WEBMCA Programming 6.1.5. Serial-Object SERIAL Contains the srial number Element req. Content Description SERIAL 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 Software version HARDWARE Hardware version Attribute(s) req. -
Page 48: Device-Object
WEBMCA Programming 6.1.8. DEVICE-Object DEVICE Elements req. Content DEVICETYPE Device type REVISION Hard- and software revision SERIAL Device serial number PARAMETER Parameter 6.1.9. PARAMETER-Object PARAMETER Elements req. Content MEASUREMENT Measurement parameter NETWORK Network parameter AUTH Auth.-parameter OBJECTS Data objects 6.1.10. MEASUREMENT-Object (ext. ADC) MEASUREMENT Elements Req. -
Page 49: Preset-Object
WEBMCA Programming 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 Type of start condition 0 - manual 1 - external via gate signal 2 - via date/time specification 6.1.13. -
Page 50: Command-Object
WEBMCA Programming 6.1.16. COMMAND-Object COMMAND Elements req. Content NAME 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 or stops measurement; select device via DEVICETYPE=TYPE and ACQUISITIOPN=0/1 6.1.17. -
Page 51: Stabilization-Object
WEBMCA Programming 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) Parameter for software MCS-mode (r/w) (for future use) LINEARIZATION Structure array for linearization of spectra (each structure contains the coefficients of... -
Page 52: Calibration-Object
WEBMCA Programming 6.1.21. Calibration-Object CALIBRATION_X/_Y Parameter for spectra Elements req. Content DATA Polynome parameter 6.1.22. DATA-Object DATA Polynome parameters for calibration Attribute(s) req. Content Actual content of array ComTec GmbH... -
Page 53: Xml Examples
WEBMCA Programming 6.2. XML Examples 6.2.1. command_acquisition.xml <?xml version="1.0" encoding="UTF-8"?> <REQUEST ID="1"> <!--Protocol-Version--> <VERSION>0.1.0</VERSION> <!--Command--> <COMMAND NAME="ACQUISITION" ACQUISITION="0" DEVICEID="0" /> </REQUEST> 6.2.2. Preset.xml <PRESET> // first start condition <START_CONDITION TYPE="n">VALUE</START_CONDITION> // 0 manual, 1 extern, 2 Date // ... // first stop condition </STOP_CONDITION TYPE="n">VALUE</STOP_CONDITION>... -
Page 54: Set_Spectrumlength.xml
WEBMCA Programming <DEVICETYPE>1</DEVICETYPE> <DESCRIPTION>Root-Device</DESCRIPTION> </DEVICETYPE> <REVISION> <HARDWARE>0.0.0</HARDWARE> <SOFTWARE>0.0.0</SOFTWARE> </REVISION> <PARAMETER> <!-- network parameters --> <NETWORK> <!-- mac --> <ETHADDR>00:aa:aa:aa:aa:aa</ETHADDR> <!-- ip --> <IP>192.168.1.2</IP> <!-- netmask, empty default netmask --> <NETMASK>255.255.255.0</NETMASK> <!-- gateway, empty default gateway --> <GATEWAY>192.168.1.1</GATEWAY> <!-- dns server list, empty no dns server --> <DNS>... -
Page 55: Delphi Programming Example
WEBMCA Programming 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, 4053 Embourg, Belgium 6.3.1. TCPTest.dpr program TCPTest; uses Forms, TCPTestUnit in 'TCPTestUnit.pas' {Form1}; {$R *.res} begin Application.Initialize;... -
Page 56: Tcptestunit.dfm
WEBMCA Programming 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. TCPTestUnit.dfm object Form1: TForm1 Left = 465 Top = 240 Width = 449 Height = 554 Caption = 'Form1' Color = clBtnFace Font.Charset = DEFAULT_CHARSET Font.Color = clWindowText... - Page 57 WEBMCA Programming object Memo2: TMemo Left = 24 Top = 216 Width = 401 Height = 249 ScrollBars = ssVertical TabOrder = 2 object Edit1: TEdit Left = 104 Top = 16 Width = 121 Height = 21 TabOrder = 3 Text = 'Edit1' object Button2: TButton Left = 264...
-
Page 58: Figure 6.1: Delphi Example
Figure 6.1: Delphi example ComTec GmbH 6-13... -
Page 59: Technical Data
Technical Data Technical Data General: Device Type: ..........Network MCA for NIM-ADCs Processor: ..............32 Bit RISC 66 MHz ADC-Control:............. FPGA and adapter board IP protocols: ............ICMP, NTP, TCP, UDP Communication: ............XML based protocols MCA: Operating modes:................PHA Spectrum length: ......... 256, 512, 1k, 2k, 4k, 8k channels Presets: ............