Home

Installation and Reference Manual

Contents

1. Directory of YIs or VI library to compile FRA Starting Mass Compile Mo 20 Jun 2005 10 46 27 or Files t Log Results 4 Append Cache Is si Directory Gs Labyview 6 00 Licel libi TR_EthernetB ttt Bad VI Licel TEPIP VI Tree vi Path E Labview Files Licel TCPIP VI Tree vi ttt Finished Mass Compile Mo 20 Jun 2005 10 48 30 Reload CINs Cancel Mass Compile Cancel Mass Compile 5 Later the mass compile status will be shown Please ignore that the vi Licel TCPIP VI Tree Is indicated to be a bad vi Please note that the removal of older libraries is a necessity since LabVIEW often links to various libraries with the same name As a result if a library is installed twice one can not be certain which library is actually being used If you still have any problems please contact Licel for further assistance 20 Chapter 4 Setting up the Network To operate the Licel Multispectral Lidar Detector in your local network you will have to carry out the following steps as described in the corresponding subsections 1 Get the required Network Information 2 Prepare the PC to communicate with the ethernet controller using a cross link cable Network Preparation 3 Setup the ethernet controller for your local area network either by setting a fixed IP address or by activating the DHCP mode Network Setup 4 Reconfigure the PC for your local area network and test the c
2. 800 D030 0057 S39 0 0 DO VOO VP OU OO S Ae OOS BeO w ak OLOO0 E 0800 0040 003300140 O00 000 00 00 L00S 1 1905 Ber dd OO dd OOO O50 OO Gk 0 Or O 000 00 0041005 te WU D gt Tac Line 1 Filename Line 2 Location Start Time Stop Time Height asl Longitude Latitude zenith angle string Format YYMDDhh mmssxxx The first letter can be chosen freely yy two numbers showing the years in the century M one number containing the month as a hexadecimal number December c DD two numbers containing the day of month hh two numbers containing the hours since midnight mm two numbers containing the minutes ss two numbers containing the seconds xxx three numbers containing the milliseconds 3 decimal places of the seconds String with 8 Letters dd mm yyyy hh mm ss dd mm yyyy hh mm ss four digits in meter four digits including sign dot one digit four digits including sign dot one digit two digits in degrees 93 Line 3 Laser 1 Number of shots Data File format digits integer Pulse repetition frequency for Laser 1 5 digits integer Laser 2 Number of shots digits integer Pulse repetition frequency for Laser 2 5 digits integer Not used for the Licel Multispectral Lidar Detector number of datasets in the file 2 digits integer Dataset description Active 1 if dataset is present O otherwise Analog Photon Counting Always Photon Counting 1 i
3. Step 2 Start the Detector to acquire 100 shots data in the push mode The corresponding command will be START 100 PUSH Step 3 Read the first incoming dataset on the push socket decompress the data section of the incoming dataset and store it in the summation array The summation array now has just 1 dataset of 100 internally averaged shots Step 4 Read the second incoming dataset on the push socket decompress the data section of the incoming dataset and add it to the summation array The summation array now has 2 datasets of 100 internally averaged shots Hence the summation array has 200 shots of averaged data Step 5 Continue the above process for 38 more incoming datasets Once this is finished the Summation array will have 40 datasets of 100 internally averaged shots Hence the summation array has 4000 shots of averaged data It is recommended to internally average with the the maximum possible shots as this is the fastest and in some cases most accurate way to acquire a given number of shots Using a mechanism with internal averaging of shots far below its maximum possible capability and consequently increasing the number of external averaged datasets puts heavy load on the Ethernet transmission This could lead to possible loss of shots as the detector is not able to transfer the data fast enough to the client before restarting itself for the next acquisition cycle This possible loss of shots can be detected by observing ir
4. Change the center wavelength and or the wavelength resolution and repeat the 2 previous steps Minimize the mean square deviation This procedure is implemented in the calibration routine The corresponding steps here are 1 acquire a spectrum of a calibration lamp e g mercury with the Licel Multichannel Lidar Detec tor Acquisition mode Make sure that all 32 channels are written to the data file get a known high resolution line level spectrum for your calibration lamp You may get spectro scopic data for many atomic transitions e g at http ohysics nist gov PhysRefData ASD lines_form html The file format needed is a text ascii file containing two columns wavelength in nanometers and the relative intensity A line spec trum of mercury is provided in the delivered file allLines_NIST txt 50 Calibration a load the spectrum to the calibration routine using the Load Lines button and choosing a file in a subsequent file dialog Load Lines The data found in the file are plotted in the to left display You may specify a Cut Wavelength to simulate a wavelength high pass filter before loading the file 0 000 Cut Wavelength are ignored in that case Wavelengths below the specified Cut Wavelength b Enter your guessed center wavelength Lambda Center and wavelength resolution Delta Lambda Lambda Center Delta Lambda i 5 rl y etah yp 5 000 Click on the button Integrate _Integra
5. Licel SP32 Detector SLAVE Mode Operation 56 Data Acquisition Overview LabVIEW SLAVE Mode Template As part of the LabVIEW sources the template VI PMT32Channel SLAVE Template vi Is included lt is located in the LabVIEW LLB PMT32Channel 11b and may easily be opened from the delivered LabVIEW project a PMT32Channel SLAVE Template vi Front Panel on PMT32Channel vproj My Computer Se x File Edit View Project Operate Tools Window Help om 1 Select 2 Select 3 Run the VI IP Address and High Voltage and click on Arrow Discriminator High Voltage 5 Wait until done Acquired data ist index rows 32 channels 2nd index columns 1000 bins Target Shots PMT32Channel lvproj My Computer 4 n i Flowchart Front Panel of the PMT32Channel SLAVE Template vi o Data Acquisition Overview To run the template VI 1 2 3 Select the IP Address and Port Select the desired High Voltage and Discriminator level Rrun the VI by clicking on the arrow icon The VI will then 1 O OO O N OO Oo A W PD meek th 12 Open a TCP IP connection with the device at the given IP Address and Port only 1 attempt in the template VI Read the hardware information and display it in the corresponding indicators Set the discriminator level to the selected value Set the high voltage to the selected value Set the resolution to 200 ns if supported by the hardware Set the range bins
6. Size 10 0 MB 10 492 317 bytes Size on disk 10 0 MB 10 555 392 bytes Contains 26 Files 2 Folders Created Today June 10 2005 3 00 57 PM Attributes C Read only C Hidden Verify that the Read only attribute is not checked uncheck it if necessary Click OK and check in the next dialog Apply changes to this folder subfolders and files Leave the dialog by clicking OK Confirm Attribute Changes You have chosen to make the Following attribute changes unset read only Do you want to apply this change to this Folder only or do you want to apply it to all subfolders and files as well Apply changes to this Folder only Apply changes to this folder subfolders and files l Cancel 11 If you have backuped your initialization files from an older version of Licel Ethernet Software you may copy the TCP IP parameters from the corresponding old initialization files to the files of the current installation Please note that copying information from older to new initialization files should be done value by value line by line 3 4 Installing the Licel LabVIEW Libraries To install the Licel LabVIEW libraries you may choose between the following options The Licel LabVIEW Libraries will be copied automatically from the Licel CD ROM by pressing Copy LabVIEW Source in the setup selection dialog You will be asked to select or create a target folder e You may manually copy all files contained in the d
7. and another to convert the data from several files to corresponding ASCII files Datafile Batch Converter vi By pressing Combine Datafile Addfiles Interface vi Is interactively called to sum the data contained in a set of subsequently recorded data files You will have to specify 1 the name of the first file to add Please select the first file to add Suchen in Ej temp ha E AE d0530915 131122 d0530915 135309 aa dOS30915 143598 aa dOS30915 131444 d0530915 135632 aa d0530915 143820 Netzwerku mg Dateiname d0530915 132188 D ateityp al Files r Abbrechen As ai 0530915 123670 fa dOS30915 123994 fa d0530915 124219 aa d0530915 124542 d0530915 124967 0530915 125288 fa d0530915 125511 d0530915 125832 d0530915 130256 faa d0530915 130578 d0530915 130899 d0530915 131865 9 d0530915 132188 dOS30915 132409 d0530915 132732 aa d0530915 133153 d0530915 133475 d0530915 133797 fa dO530915 134018 d0530915 134342 d0530915 134765 d0530915 135088 2 the name of the last file to add Please select the last file to add a 0530915 140051 fa dOS30915 140375 d0530915 140697 d0530915 140922 fa dOS30915 141244 fa dOS30915 141664 faa dOS30915 141986 dOS30915 142208 dO530915 142532 fae dOS30915 142954 d0530915 143277 Suchen in Ej temp T a dO530915 164750 dOS30915 165071 fae dOS30915 165389 dO
8. Defining the IP Address and Port is different for the Windows applications and the LabVIEW sources Windows Applications Initialization Files The Windows applications communicating with the Licel Multispectral Lidar Detector use an initializa tion files named PMT32Channel ini to read their TCP IP parameters IP Address and Port An example of the TCP IP relevant information is given below ICE TE UseValues TRUE IPAddress 10 49 234 234 POrL 2055 You may edit this file using a text editor like Notepad which is installed by default when setting up a Windows operating system You may use Notepad as well to create a required initialization file if it does not exist in the installation directory Make sure that you save the file before leaving the editor You must change the values for IP address and port to the values you will set following the Instructions in the network setup section LabVIEW Setting Default TCP IP Parameters The initialization files described above are necessary for the Windows applications because there it is not possible to set specific values as default values for control fields However when running the software within a LabVIEW development environment default values can be defined for controls on the panel of a LabVIEW vi This is especially convenient and recommended for the TCP IP parameters IP Address and Port Change the values to the values you set following the Instructions in the network setup section 1
9. Open the vi using LabVIEW do not run the vi 2 Enter the value for the IP address into the control named IP Address 3 Right click on the control IP Address the context menu opens 4 Select Data Operations a sub menu opens 5 Select Make Current Value Default 192 168 69 112 BOSS Visible Items k Find Change to Indicator Description and Tip Create Replace Data Operations Reinitialze to Default Value Advanced Make Current value Default Normal Display DataSocket Connection VU Codes Display Password Display uk Data Hex Display Copy Data ste Data Limit to Single Line Update Value while Typing 6 Repeat this procedure for Port 7 Save the vi 29 TCP IP Connection Parameters 4 5 1 TCP IP Connection Problems Software The parent application Lice Main Module Control as well as the software modules when run stand alone Track Live Acquis Control APD PMT and Control Timing have a built in mechanism to re establish the TCP IP connection to the Licel Multispectral Lidar Detector when the connection is lost or when the connection is not successful after the program start lf the reconnection mechanism is not successful after 5 attempts the software assumes that some basic TCP IP settings may be incorrect Therefore the following error message is displayed Warning while fre establishing the TCP IP connection the connection cou
10. IP address 25 Network Setup 4 3 Network Setup In order to configure the ethernet controller you need either to set the controller to a fixed IP address or invoke the DHCP Mode Whether a fixed or dynamic DHCP mode is used or not will depend upon your network type Dependent on this please refer either to the subsection Fixed IP Address or DHCP Mode and skip the corresponding other subsection Please contact your administrator if you have not yet requested the information described in the above subsection Network Setup Afterwards you will have to reconfigure your PC for operating in the local network Once you have set the IP Address and Port for the Licel Multispectral Lidar Detector you should define these values to be used by the software 4 3 1 Fixed IP Address If you need to set the controller to a fixed IP address carry out the following steps Skip the steps described in next subsection DHCP Mode 1 Open Licel TCPIP Set New Fixed IP Address vi or the corresponding Windows ap plication from the Windows start menu Please enter the new network parameters Run the vi Power Off On the Licel Ethernet Controller Current IP Address New IP Address 10 49 234 234 192 168 69 12 Current Port Port 2055 h 2055 Password New Network Mask 2 Set the desired network parameters in the fields New IP Address Port and New Network Mask 3 Do not forget to enter the correct administrator Password 4 Run the
11. PARTY TO THIS AGREEMENT AND BE BOUND BY ALL OF ITS TERMS AND CONDITIONS CLICK THE APPROPRIATE BUTTON TO CANCEL THE INSTALLATION PROCESS DO NOT INSTALL OR USE THE SOFTWARE AND RETURN THE SOFTWARE WITHIN THIRTY 30 DAYS OF RECEIPT OF THE SOFTWARE INCLUDING ALL ACCOMPANYING WRITTEN MATERIALS ALONG WITH THEIR CONTAINERS TO THE PLACE YOU OBTAINED THEM ALL RETURNS SHALL BE SUBJECT TO N S THEN CURRENT RETURN POLICY 1 Definitions As used in this Agreement the following terms have the following meanings accept the License Agreements Cl do not accept the License Agreerment s 4 The next screen will inform about the software components that will need to be installed on your system 15 Installing the Windows Applications PMT32 Channel Acquisition Software ale AX Start Installation Review the following summary before continuing Upgrading PMT 32 Channel Acquisition Software Files Adding or Changing National Instruments system components Click the Next button to begin installation Click the Back button to change the installation settings Please click Next to proceed 5 The next screen contains the progress indicators during the installation eam eS Overall Progress Currently installing PMT32 Channel Acquisition Software Part 1 of 1 Copying new files CP 6 When the installation has finished please click Next to proceed 16 Installing the Windows Applications Inst
12. SP SlaveMode DataRead Seq Syntax int Licel SP SlaveMode DataRead Seq SOCKET cmd soc Spectro Hardware sp hw long int advanced viewer data Description The slave mode data read sequence performs the following operations Issues the DATA command which instrucis the controller to transmit the acquired data Reads the incoming slave mode data Preamble Header Extracis the parameters from the preamble and uses it to read the Channel Trace Lata Licel SP Write Data2File Seq Syntax int Licel SP Write Data2File Seq Spectro Measurement x spymes Spectro Application sp app long int advanced viewer data Description The write data to file sequence performs the following operations Prepares the name of the data file to write the data Writes the acquired data into the file in the Licel Advanced Viewer Data File format The file name and the data format is described in the section Data File format Licel SP Shutdown Seg Syntax int Licel SP Shutdown Seqg SOCKET cmd soc Description The shutdown sequence performs the following operations 86 8 1 2 SP32 Detector C Drivers Stops the controller using the STOP command Turns off the PMT high voltage by setting it to 0 Licel SP SlaveMode Read Preamble Syntax int Licel SP SlaveMode Read Preamble SOCKET cmd soc Spectro Preamble xsp preamble Spectro Hardware xsp hw Description The slave mode read preambl
13. VI s Licel TCPIP Activate DHCP vi This VI is used to activate the DHCP mode of the transient recorder controller In order to do so the user must enter the proper password and port number for the controller After DHCP mode has been set communication will be lost until the acquisition computer is configured for DHCP communication as well po TCPIP Ref In TCPIP Ref Out error in no error error out password Licel TCPIP Dump TCPIP Buffer vi This VI empties the TCPIP buffer by reading all the data that is available in the buffer The Number of bytes trashed shows how many bytes were read from the buffer and disposed of TCP Ref In TCP Ref Out error in no error Number of bytes trashed error out Licel TCPIP Get ID vi Gets the identification string from the transient recorder controller TCPIP Ref In TCPIP Ref Out error in no error E e error out Licel TCPIP Kill Sockets vi This VI opens a new connection to the TR and sends the command to close down and reset all TCPIP connections After doing this the VI shuts down its TCPIP connection and waits the specified number of milliseconds milliseconds to wait before returning miliseconds to wait address uia error out error in no error 96 Licel TCPIP Driver VIs Licel TCPIP Send Data vi Adds a CRLF to the end of the string and sends it via TCPIP using the TCPIP reference input TCPIP Ref In TCPIP Ref out Typecasted Data TCPIP error error in no error S
14. Zenith Angle Longitude Latitude Leading letter of the file name Output directory for data IP address of the Host Application Acquisition Parameters integer string integer integer integer integer float float int Target Shots to acquire Activate High Voltage 1 turn on high voltage O turn off high voltage High Voltage value in Volts Laser Rep Rate Discriminator level range 0 63 Total number of acquisition cycles Central Wavelength in nm Dispersion per Channel in nm Resolution in nano seconds 91 SP32 Detector Sample Applications int Rangebins Please note This chapter only includes SP 32 Detector specific function documentation Please refer to the Licel Transient Recorder and Ethernet Controller Programming Manual for additional functions The manual call be downloaded at http www licel com programmingManual pdf 92 Data File format 8 3 Data File format This describes the file format written by PMT32 Channel Acquisition and other Licel acquisition software The files are interoperable between the different platforms The file format is a mixed ascii binary format where the first lines describe the measurement situation below follow the dataset description and then raw data as 32 bit integer values itself 8 3 1 Sample file header aU oC Las 3 Ea 7 od Berlin LTS E27 2008 14281422 Lise 272008 124581222 10085 0013 4 0052 5 00 JOO 1000 OUTO 0000000 0000 32 Lol ae 0LODO
15. amp electronics housing Lemo CAMAC to BNC cable included 4 Ethernet connection to the detector amp electronics housing A cross link cable for a direct con nection to the computer is provided A straight patch cable is required when connecting to an Ethernet switch or hub Chapter 3 Software Installation Licel provides a package of software modules for setting up the Licel Multispectral Lidar Detector for network operation and for operating the Licel Multispectral Lidar Detector These software modules are written in LabVIEW s G language The software is provided as LabVIEW source for users who have LabVIEW beginning with version 8 2 installed or alternatively as a set of Windows applica tions The Windows applications come within a Windows Installer package for an easy installation on your Windows 2000 XP Vista computer Licel provides the software on a CD ROM 3 1 Preparation Windows Application Users If you have used older versions of Licel Windows applications it is recommended to backup existing initialization files x ini Search the installation directory of the older version of Licel Windows applications standard lt Program Files Directory gt lLicel and backup all files with the ending ini to an archive file zip ARJ TAR etc or onto a CD ROM LabVIEW Users If you have used older versions of Licel LabVIEW libraries it is necessary to remove and backup older versions 1 Backup all your current L
16. be stored and the First Letter is a letter that will be used as a prefix for the file names Directly enter the path of the Working Directory into the control field or browse your file system using the browse l button The format of the file names is 2YYMDDhh mmssxx where is the First Letter yy is the year of the century where M is the month hexadecimal 0 DD is the day of the month hh is the current hour of the day mm are the minutes ss the seconds and xx the first 2 decimal places of the seconds For example the filename avooZ2ULl Z61650 is a file that would have been taken on May 20 2005 or 2105 The operator set a to be the first letter as in the screenshot and the time was 11 28 16 50 The other information above has no effect on the program execution it is only stored in the data file headers for later reference The fields available are your current Location e g Berlin the Longitude and Latitude of your location the Height asl above sea level of the location of your acqusition system and the repetition rate of your laser Laser Frequency Upon starting the program preloads the information that it finds in the file global info ini that is located in the same directory as the libraries or the Windows applications respectively The changes you make here will be saved there when leaving the dialog by pressing Continue The data file format is described in an appendix Channel Configuration Also on the Confi
17. in fig 1 2 52 0 0 5 Figure 1 2 Mechanical outline of the detector cathodes 1 3 1 Gain characteristics Like in individual photomultipliers these dynode chains vary with respect to their individual gain voltage behavior The gain of each cathode strip depends on the voltage setting and on these gain characteristics The pulse height distributions for all dynode chains at 900 V and 950 V are shown in the plots below Detector 13 PMT32Channel Pulse version 1 07 09 TCPIP 2 49 rev 423 e BE File Edit View Project Operate Tools leon Window Help High Voltage 400 500 600 300 Not 700 t 200 800 ON 1007 900 af E 0 1000 a w 1 1 1 U 1 I w u 2 i3 i4 i5 Ds i7 Discriminator Level to Binwidth ns Haw 99090909990060999999 ER Differential MHz 999090999999999999 Start Signal ia j0 A PMT32Channel_Pulse version 1 07 09 TCPIP 2 49 rev 423 Integral MHz 0 00 File Edit View Project Operate Tools Window Help lou Pulse Distribution Raw Data l TCP IP l 0 00 0 Discriminator Level He 9999999999999999 9999999999999999 Figure 1 4 Pulse height distribution Zoomed at 900 V Detector T PMT32Channel Pulse version 1 07 09 TCPIP 2 49 rev 423 e SE File Edit View Project Operate Tools Window Help nm lips Integral MHz 0 78 0 70 0 6
18. indicator on the TCP IP page PMT32Channel PMT32Channel ini 30 Network Security While a Licel Windows application is running and has not yet a TCP IP connection you may enter the IP Address and the Port directly If a connection can be estab lished i e the values are correct the parameters will be written to the appropriate initialization file when the program terminates without an error check whether the Licel Multispectral Lidar Detector operates in secure mode If secure mode is used please check the following section in the file LicelTCPIP ini TCPIP_ lt Controller IP Address gt _ lt Controller Port gt UseSecureMode TRUE SecureModePwD lt SecureModePassword gt where Controller IP Address and Controller Port are the IP address and port of the Licel Multispectral Lidar Detector respectively If necessary ask your administrator for the correct password for usage in secure mode You have two choices to leave the message dialog 1 Click Retry to continue to reconnect to the Licel Multispectral Lidar Detector 2 Click Cancel to exit The program will display an error message here an example for Control APD PMT the dialog s appearance may depend on the LabVIEW version x Error 56 occurred at TCP Open Connection in Licel TCPIP Open Secure Mode yi Licel TCPIP Kill Sockets i Licel TCPIP Reopen Connection vi Control APD PMT vi Possible reason s LabvIEW The network operation exceeded the us
19. prompt DOS box Use the IP address you as signed to the Licel Multispectral Lidar Detector If the ethernet controller is in DHCP mode you need to ask your system administrator for the assigned network address The ping command s response should indicate a correctly working connection 9 Test the access using Licel TCPIP Getting Started vi or the corresponding Windows application to be started from the Windows start menu 10 A TCP IP timeout error with LabVIEW s error code 56 may be caused by a wrong IP address Error 56 occurred at TCP Open Connection in Control PMT Panel vi Possible reasons LabVIEW The network operation exceeded the user specified or system time limit Please check carefully that the values for IP Address and Port match with the parameters set at the Licel Multispectral Lidar Detector Set the correct values as defaults for future operation Other reasons for errors with code 56 are non existing connections check if the cable in use is correct or unstable network operation 4 5 TCP IP Connection Parameters To work properly with the Licel Multispectral Lidar Detector both the Windows applications and the LabVIEW software must be able to establish a TCP IP connection The user of the software must 28 TCP IP Connection Parameters define the IP Address and Port these values must be equal to the parameters that have been for the Licel Multispectral Lidar Detector following the network setup section
20. switch the trigger input Lemo CAMAC and the Ethernet connector RJ45 are located as seen in the figure DC Reset Trigger Eth ernet 4 1 r i 1 kS i ae a E E i Figure 2 2 Detector amp electronics housing 2 3 Mounting the Detector amp Electronics Housing To connect the detector amp electronics housing to the spectrometer the mounting flange is used Mounting flanges for several spectrometers are available The appropriate mounting flange must be specified when ordering the Licel Multispectral Lidar Detector The mounting flange is already premounted at the detector amp electronics housing makes sure that the photocathode plane of the detector lies in the focal plane of the spectrom eter uses O ring seals at it s mounting surfaces has prepared holes and or threads for mounting at the spectrometer Please make sure that daylight illumination of the detector is carefully avoided during mount ing The holes and or threads of the mounting flange have to be aligned to the spectrometer s threads and or holes Then it must be carefully screwed 2 4 Cable Connections The following cable connections are required 1 line connection to the rear side of the power supply unit line cable included 10 2 DC supply connection from the front of the power supply to the detector amp electronics housing Lemo 4 pole cable included 3 trigger input from a trigger source to the trigger input at the detector
21. 0 of Channels 3000 32 2500 Delta Lambda E 2000 ao 1500 _Integrate 1900 500 Reset 0 Line File Multichannel Mean Square Deviation toaa Minimum Lambda Fix Inf pee Delta Fix current Lambda Optimal Lambda Center 420 000 420 000 Current Delta Optimal Delta Lambda 5 000 5 000 Lambda Center Search Range nm Lambda Center Search Step nm J5 0 05 Delta Lambda Search Range nm Delta Lambda Search Step nm a2 0 01 A Data File 4 The calibration is done using the following steps J Acquire a spectrum of a calibration lamp e g mercury with the Licel Multichannel Lidar De tector using PMT32Channel Main vi Single Acquisition Load a known high resolution line spectrum into the calibration routine e g the mercury line spectrum in the delivered file in allLines_NIST txt Guess a center wavelength and a wavelength resolution nm per channel of the Licel Multi channel Lidar Detector If you are using the MS125 spectrometer please refer to the spectrom eter s user manual to obtain the center wavelength from the micrometer scale and the grating s number of lines per millimeter Press the Integrate button to integrate the high resolution spectrum using the center wavelength and the wavelength resolution This simulates the acquisition with the Licel Multichannel Lidar Detector Compare the integrated line spectrum with the acquired spectrum and calculate the mean square deviation
22. 0 0 50 E 0 40 0 30 0 20 0 10 h 0 00 By e SSS TS Ti 1 I 1 1 I 1 1 1 1 1 I 1 i ino 1 E 1 I Bei A Sos SS or 68 0 18 i 5 essas J Discriminator Level Haw 9990909099999999999 Differential MHz 9990909099999999999 Start Signal Bin 5 jo Final Signal Bin J 1024 Shots to Average 6 so0 Current Shotnumber 500 Start Discr Level 0 Stop Discr Level Jes Current Discr Level 63 is 13 PMT32Channel_Pulse version 1 07 09 TCPIP 2 49 rev 423 gt SE File Edit View Project Operate Tools Window Help nm BULA a ae Pulse Distribution Raw Data TCP IP MHz 0 i 1 1 25 30 Discriminator Level Hg 9990009009999 Differential MHz 9900909999999 Figure 1 6 Pulse height distribution Zoomed at 950 V 1 3 2 Crosstalk Two different effects are responsible for crosstalk effects in a multispectral application using the Licel SP 32 detector assembly at the spectrometer image plain 1 Straylight from the grating In a single grating spectrometer typical straylight levels are in the order of 10 2 Amplification of photoelectrons from neighboring photocathodes If photoelectrons are emitted towards the neighbouring dynode chain these photoelectrons can be amplified by the wrong dynode chain For the H7260 detector this probability is 3 for the adjacent channel and 0 6 for the n 2nd channel 3 Saturation effects will occur when to
23. 1 TCP IP Connection Problems Software 50450502 eas 4 6 Network Security 2 A 4 6 1 Changing the Administrator Password 2 000 ee eens 4 7 Hardware Reset 2 Software Modules 5 1 Overview 2445442646 dR a RE SED ARA AEREAS HE we 5 2 PMT32 Pulse Height Distribution 0 0 0 02 ee ee 5 3 PMT32 Channel Acquisition 2 2 0 5 4 PMT32 Viewer aoaaa a ee a 59 Ga nee et kee BSR eRe ee Bee eae ee eed CONTENTS 6 Data Acquisition using the Licel SP32 Detector 6 1 Data Acquisition Overview o oo e 6 1 1 SLAVE Mode 2 a 6 1 2 PUSH NOUS 6 6 oh es Awe RE ew HEE eH ew EE es 6 2 Transmitted Data Format 0 0 0 0 ee a 6 2 1 SLAVE Mode ce h dh ORR ORR RENA ERE ERK RENA DS OHH SA 6 2 2 PUSH Mode nwa ce eae wee OEE RAE EE em HOE ee 6 3 PUSH Mode Transmission Data Compression 000002 eee 6 4 PUSH Data Time Stamps 2 2 a a a a ee 6 5 PUSH Mode Internal Shot Acquisition Status 002 2 0004 6 6 Efficient use of SP32 Detector for Data Acquisition 2 0 6 7 Internal and External Data Averaging 1 ee a 6 8 Client Side External Averaging of PUSH Data 7 SP32 Controller TCPIP Command List and Syntax 8 SP32 C Sources Drivers 8 1 SP32 Detector C Drivers 2 a a a dd GIA Stee eee bee ER GREGOR EERE DR SHORE EG HS See MOO bea ee ee AOE wee ee wee d Bites II ik we ee ee ER eo De a Ys 8 2 SP32 D
24. 1 licel_sp This category contains block level algorithm functions that implement the flow charts illustrated in the Data Acquisition Overview section All the functions in this category return 0 if successful or a negative number in case of an error e Licel_SP_SlaveMode_Startup_Seq Syntax int Licel_SP_SlaveMode_Startup_Seq SOCKET cmd soc Spectro Application sp app Spectro Hardware xsp hw Description The slave mode startup sequence function performs the following operations Gets the software id of the controller using the IDN command 85 SP32 Detector C Drivers Gets the hardware information of the controller using the Hw command and assigns the parameters to the Hardware Parameters Structure Assess the validity of the parameters in the Application Parameters Structure with that of the Hardware Parameters Structure Sets the discriminator level of the controller using the DISC command Sets the PMT high voltage level of the controller using the PMTG command Licel_SP_SlaveMode_Acquisition_Seq Syntax int Licel SP SlaveMode Acquisition _Seq SOCKET cmd soc Spectro Application sp app Description The slave mode acquisition sequence function performs the following operations Staris the SP32 in SLAVE mode to acquire the target number of shois Polls the status of the acquisition using the STAT command until the acquired shots is equal to the target shot number Licel
25. 17500 20000 22500 24870 ER reer 25000 27500 29970 m l 1 l TE 0 2500 5000 7500 10000 12500 15000 ajja me ajaj l The two green cursors define the range for the integration of the spectral display at the bottom of the program s panel Please note that not all channels have been saved in our example so the drawn line representing the spectrum is broken at the missing channels Spectrum between the green Cursors Spectrum Start and Spectrum End 55 Hi SO 45 gu IL aa a 5 E 3 E W 25 E js 10 y o gJ A E Channel LS Ha l l l l l l l l l l l l l l l l l 2 4 6 8 DO WF 14 e 8 2 2 2 2 28 3031 re elle The x axis may be set with the Channel Display switch either to Index or Wavelength Channel Display Index All cursor coordinates are displayed in the cursor list 45 PMT32 Viewer Cursors x ma Photoncoum 2 6 0 DOE C Offset Start Photoncoum 24717 0 00E f HEM Offset End Photoncour 16590 O 00E f HH Spectrum Start Photoncoun 7410 4 O4E 3 HH Spectrum End Photoncoun 1560 2 47E 2 0 Currently the data is being shown in raw mode The Offset Start blue and Offset End red cursors can be used to correct for the baseline offset If the Display Mode Offset Corr is used then the mean value of the signal between these two cursors will be subtracted from the signal in order to create a baseline corrected signal Use the cursor controls to move the blue a
26. 28 30 1S 5 7 9 11 13 15 17 19 2t 28 25 27 29 31 Click on the stat button The Licel Multispectral Lidar Detector will acquire the de sired number of shots for each discriminator level between the Start Discriminator Level and the Stop Discriminator Level The acquired data of the active channels is averaged between Start Signal Bin and Final Signal Bin The result is displayed in the graphic plots Integral MHz and Differential MHz The most bottom display is intended to show the Acquired Raw Data for the active channels button to stop a running pulse height distribution By clicking the Save button and choosing a file name in a subsequent dialog the Inegral MHz data is saved to a text ascil file Clicking the button and choosing a file name in a subsequent dialog will save the current panel to a portable network graphics png file 35 PMT32 Channel Acquisition 5 3 PMT32 Channel Acquisition You can load PMT32 Channel Acquisition by either double clicking on the PMT32Channel 11b or by selecting the virtual instrument PMT32Channel Main vi IN PMT32Channel 11b If you installed the Windows applications please start the program by selecting the entry PMT32 Channel Acquisition in the Licel section of the Windows Start menu After doing so you should see a screen similar to the one below IT 7 E 13 PMT32Channel Main version 1 07 04 TCPIP 2 44 rev 767 DD File
27. 4 bytes unsigned int The Rangebins of the PUSH mode is the same as that of the SLAVE mode Data Time Stamp 8 bytes double The Data Time Stamp is a time stamp in milliseconds accurate to micro seconds associated with each data set transmitted Current Sensor Value 4 bytes unsigned int The Current Sensor Value indicates the Analog to Digital converted value of the current sen sor reading which measures the current drawn by the high voltage module that powers the Photo Multiplier Tube PMT on board the SP32 detector Data Compression Factor 4 bytes unsigned int The Data Compression Factor indicates the compression factor with which the detector is going to transmit the acquired data 6 Transmitted Data Format When a PUSH mode acquisition is running the detector also transmits the Data Preamble Header with only the Dataset Marker and Acquired Shots information All other fields of the Pream ble Header are set to 0 This is sent to indicate to the user the current status of the internal shot acquisition during an active PUSH mode Please refer to the section on PUSH Mode Internal Shot Acquisition Status for more information Channel Trace Data The PUSH mode Channel Trace Data format depends upon the Data Compression Factor used which can be obtained from the Preamble Header Compression techniques are used in order to optimize ethernet data transmission by cutting out redundancy Please refer to the section on PUSH M
28. CEI lidar computing and electronics Licel Standard Resolution Multispectral Lidar Detector SP32 Installation and Reference Manual Licel GmbH April 16 2015 Contents The Licel Multispectral Lidar Detector 1 1 Overview 2 64 22566 be ewww eee eee Ee we OR ee ew a 1 2 The Counter 2 0 ee ee 1 3 Detector 6 the cee ew Ee REE RRRS a ee a 1 3 1 Gain characteristics 00 0 ee ee 132 CIOSStAK ote ee the eee eR ERR REDE eS 1 3 3 Detector Homogenity 0 0 ee a Hardware Installation 2 1 Power Supply Unit 2 2 2 e265 eee nee eo ew ee CR ER ew A ee ee 2 2 Detector amp Electronics Housing 0 0 eee ee ee 2 3 Mounting the Detector amp Electronics Housing 0200005 2 4 Cable Connections o o aoao aoao a a a a e e A Software Installation 3 1 Preparation een beak ee ee ae eed hee eRe he ee ee 3 2 TheLicelCDROM 0 A 3 3 Installing the Windows Applications 0 000 eee ee ee ee ees 3 4 Installing the Licel LabVIEW Libraries 2 2 2 2 0000000 Ge Setting up the Network 4 1 Network Information 0 ee a 4 2 Network Preparation 1 4 2 1 Establish the Connection aa ee 4 2 2 Diagnostics o oo 4 3 Network Setup ike be Ee wt ee ew we E a 43 1 FkedIF AGOrOSS rsrsrsrs hE papd EE ED Ee ek DE os o DHCP ROGS 6 oe whew bee a eee Ew Ee 4 4 Reconfigure the PC 2 a 4 5 TCP IP Connection Parameters 0 aa ee ee 4 5
29. Connections be Go LAN or High Speed Internet Network Tasks Co Bee Connection E Create a new Connected Firewalled connection eR PRC HOO VE Network 9 Set up a home or small Disable office network Status E Change Windows Repair Firewall settings Se Disable this network Bridge Connections de pt D Create Shortcut Delete Rename EN Repair this connection mij Rename this connection gt view status of this connection Properties Change settings of this connection 3 Click on the TCP IP protocol entry in the lists of components used by the assigned ethernet adapter card LAN connection and press the Properties button 23 Network Preparation Local Area Connection Properties General Authentication Advanced Connect using E9 Intel R PROWMO0 VE Network Conne This connection uses the following items fel Client For Microsoft Networks A File and Printer Sharing for Microsoft Networks gel nos Packet Scheduler Internet Protocol TCP IP Install Description Transmission Control Protocol ntermet Protocol The default Wide area network protocol that provides communication across diverse interconnected networks C Show icon in notification area when connected Notify me when this connection has limited or no connectivity 4 Write down your current TCP IP settings i e all settings seen in the following graphics You will need this information to reconfigure your PC to access the
30. Data Is stored in the internal memory of the detector 65 Transmitted Data Format CHORB1 Width BinSize parameter of the Hw reply CHORB2 TraceO CHORB3 CHORBN CH1RB1 CH1RB2 Trace 1 CH1RB3 CH1RBN CH2RB1 CH2RB2 Trace2 CH2RB3 CH2RBN CH31RB1 CH31RB2 Trace31 CH31RB3 CH31RBN Figure SLAVE Mode Channel Trace Data Memory Diagram Where CH x RB Y represents Channel x Rangebin y and CH x RB N represents Channel x Rangebin N where N is the number of rangebins 66 Transmitted Data Format 6 2 2 PUSH Mode Preamble Header The Preamble Header of the data set transmitted in the PUSH mode has a fixed 32 bytes length Figure PUSH Mode Transmission Data Preamble Header Dataset Marker OxFFFFFFFF 4 bytes Dataset Marker 4 bytes unsigned int The Dataset Marker of the PUSH mode is the same as that of the SLAVE mode The client must use the Data Marker as a boundary to separate the continuously incoming data sets on the PUSH Socket when the Detector is operated in the PUSH mode It also serves as a reference to the start of current dataset Acquired Shots 4 bytes unsigned int The Acquired Shots of the PUSH mode Is the same as that of the SLAVE mode Compressed Traces 4 bytes unsigned int The Compressed Traces Is a 4 byte value used to denote the total number of compressed traces present in the acquired data after the suitable compression technique Is applied Rangebins
31. Edit View Project Operate Tools Window Help m um PrA32 Multispectral Lidar ROI Configuration PM Selector d 2 3DPlot Contour Plot No Display 27 5 500 J5 a 2s 25 20 F l amp 17 5 ON su 400 500 600 ia 300 La 700 k 10 Z 75 5 2 5 e Ml ub tus TPL da 0 5000 10000 15000 20000 25000 30000 35000 40000 45000 50000 Range m Ee l Range m ffe Averaged Count affey 1 The program s front panel is structured using three pages Multispectral Lidar ROI and Config uration General settings are defined on the page Configuration The acquisition settings and the main data display are located on Multispectral Lidar The page ROI enables to inspect the 32 channel spectrum in a defineable range 2 Before you start please enter the correct values for the IP Address and Port You should already have set these values for the Licel Multispectral Lidar Detector e Using the LabVIEW vi just enter the required values on the TCP IP page and save them as defaults Multispectral Lidar l ROI Configuration IF Address Fort _ Timeout 10 49 234 234 E 2055 J 5000 e If you run the Windows application you should set the values in the initialization file PMT32Channel ini You will see the full path of the file in a file path indicator on the TCP IP page 36 PMT32 Channel Acquisition 3 Please switch the Licel Multispectral Detector on and connect a trigger to the trigger
32. LAN again Internet Protocol TCP IP Properties eee General fou can get IP settings assigned automatically if your network supports this capability Othenvise pou need to ask pour network administrator for the appropriate IP settings Obtain an IP address automatically Use the following IP address IP address 10 49 234 230 Subnet mask 255 255 255 0 Use the following DNS server addresses Preferred ONS server fo Alternate DNS server fo 5 If activated disable DHCP checkbox Obtain an IP address automatically and manually assign an IP address within the default address range of the Licel Multispectral Lidar Detector A good choice would be 10 49 234 230 Never use the default address 10 49 234 234 of the Licel Multispectral Lidar Detector as IP address for your PC 6 Quit the dialog by pressing OK 7 Reboot your PC 8 Power up the rack with the Licel Multispectral Lidar Detector and connect the PC with the controller using the cross link cable shipped together with your hardware Now you should be able to access the Licel Multispectral Lidar Detector via your ethernet card Please test this first connection with the methods given in the next section 24 Network Preparation 4 2 2 Diagnostics Please carry out the following steps to verify that the connection of the Licel Multispectral Lidar Detector with the PC is established 1 Verify that the green LNK LED lights up indi
33. ORD set to MyPassword lf an error occurs wrong Old Password non matching New Password entries or empty New Passwords the reply is PASSWORD not set PMT lt Device Number gt PMTSTATUS lt Device Number gt Returns the status of the PMT with the specified device number The reply parameters are lt HV value in Volts gt lt HV on off gt lt local remote gt The PMT device number for the SP32 detector is fixed to 0 and does not support any other device number 80 CHAPTER 7 SP32 CONTROLLER TCPIP COMMAND LIST AND SYNTAX An example to request the status of the PMT would be PMT O An example corresponding reply from the controller could be PMT 970 on remote Which indicates that the PMT is in remote mode the HV power supply is on and is set to 970 Volts Another example reply could be PMT O off remote Here the HV power supply is off and set to 0 which is the default return value when the PMT is off lf a request for the status of the PMT with a non zero device number is made the reply is PMT 5 is not available Where the number 5 is the device number of the non existent PMT PMTG lt Device Number gt lt Voltage gt PMTGAIN lt Device Number gt lt Voltage gt This command sets the gain voltage applied to the dynodes of the PMT with the specified device number The PMT device number for the SP32 detector is fixed to 0 and does not support any other device number An example would be PMIG O93 0 T
34. S30915 165607 faa dOS30915 165933 d0530915 170351 d0530915 170671 fae dOS30915 170992 fa dOS30915 171213 aa d0530915 171534 faa d0530915 171957 d0530915 172277 faa d0530915 172501 D ateiname D ateityp a dO530915 172820 fa d0530915 173141 0530915 173567 0530915 173688 9 d0530915 174108 faa d0530915 174428 dOS30915 174748 fa dOS30915 175169 0530915 175489 d0530915 175709 faa dOS30915 175867 dOS42012 573454 dOS42012 574665 E aos3031 5 174108 E au Files a d0542012 575261 faa d0542012 575530 a d0552013 281650 d0552014 575687 faa dOSS2014 580207 dO552014 581757 d0552014 582217 faa dOS52014 585162 dOS52014 585480 aa dOSS2014 585707 d0552014 590019 d0552014 590342 faa dOS52014 590756 Offnen Raa AES SEACSE SCARE REECE Ra APAESCAE ACSC ACRES CERES Abbrechen 3 the name of the target directory for the file containing the summed data 48 Calibration Please select a directory for the accumulated files E x Suchen in e E cf Eee Verlaut Dateiname p0530915 141244 Dateityp al Files Abbrechen Verzeichnis wahlen 4 the first letter of the file name if Please enter the requested value E loj xj Enter the first letter for the file x ZA Both the first and the last file must reside in the same directory The data from the files with acquisition dates times lying between the first and
35. T32 Data Management p gt PMTS2 Viewer 10 Please note that the Licel software needs write permissions for the initialization files located in the installation directory Normally sufficient permissions are set during the installation process 17 Installing the Licel LabVIEW Libraries If any problems indicating missing permissions occur select the directory and right click on it Select Properties from the context menu Licel File Edit View Favorites Tools Help sack td Ei p Search Key Folders fi Address C Program Files Licel Folders 5 Java cE 5 Messi 5 micro Mode Movie E MSM CS MSM ES Natio 3 Net Netse C Net i Onlin i Sutlo Roxic winds CS wind i FRN Expand Explore Open Search Sharing and Security Send To fuk Copy Paste Delete Rename EEEE Mame a Luser lib FaJadvancel viewer FS Control APD Pt Contral PMT Ra Data Analysis a p M Licel TCPIP Activate DHCP Mode Beart jce TCPIP Getting Started PAD Licel TCPIP Set New Password PB crie acquis Ererir Disable Secure Mode E TFF Enable Secure Mode WE TCPIP Live Display mi TCPIP Pulse Height Distribution IF TCPIP Set Fixed IP Address BIS TCPIP Track a Iranhys dll Acquis T Control APD Panel IP values Licel Properties General Sharing Customize Dom Type File Folder Location C Program Files
36. TRING SENT error out Licel TCPIP Set IP Parameter vi This VI is used to configure the transient recorder controller for static IP communication With it the values of the IP address port number subnet mask and gateway can be set port TCPIP Ref In IP Mask gateway error in no error password TCPIP Ref Out error out Licel TCPIP Set Password vi This VI is used for setting the password of the transient recorder controller This password must be given in order to change the IP configuration of the controller TCPIP Ref In TCPIP Ref Out ee bo out new password error in no error 9 1 3 Transient Recorder Commands applicable to PM32 Detector Licel TCPIP Set Discriminator Level vi Sets the discriminator level between 0 and 63 for the selected transient recorders TCPIP Ref In TCPIP Ref out Discriminator Level cic error in no error Licel TCPIP Stop Acqusition vi This VI stops the acquisition process after the next received trigger TCPIP Ref In _ TCPIP Ref Out error in no error error out 9 1 4 PMT Commands applicable to PM32 Detector Licel TCPIP PMT Get Status vi This VI gets the status of the PMT with the corresponding device number The values that are returned are the HV Voltage this is the actual gain voltage On this boolean is true if the gain voltage power supply is on otherwise it is false control state if true the PMT is being controlled remotely if false then the PMT is being co
37. The number of range bis to acquire has to be tuned until the time stamp difference between two incoming data sets reach a stable expected value Please refer to the section on PUSH Data Time Stamps for more information on using the data time stamps to detect missed triggers loss of shots The ethernet controller inside the SP32 detector supports ethernet transfer speeds of 10Mbps 100Mbps and 1000Mbps 1Gbps The link speed is auto negotiated with the client hardware upon powering on the SP32 during the boot process It is highly recommended to make use of the 1Gbps transfer speed capability of the controller by using a client PC that supports 1Gbps ethernet speed If the SP32 detector is connected to the client PC via a switch box hub make sure the switch box hub supports 1Gbps speed This ensures the best performance and response time of the system espe cially in applications where data transfer rates are crucial 6 7 Internal and External Data Averaging The SP32 detector is capable of averaging up to a certain number of shots in its internal memory This is known aS Internal Averaging The maximum number of shots it can average internally is made known to the client in its reply to the Hw command Please refer to the HW command in the appendices for more information If the desired number of shots to acquire is larger than the maximum number of shots the detector is capable of averaging internally the client has to additionally average the
38. Window Help ua gt ln 2 ficara Rx Cntr PM Selector A 17 Spectrum between Cursors 100 Start Height m 13470 1 Range m 10770 Epa Bins 359 i 0 8 Mean Value 150 64 gt 0 g 60 m 0 b 50 0 i k 30 0 20 K 0 2 10 Cursors Ax Y daj 0 EJ stat 13470 0 025 0 MES 220 005 LL a 20000 25000 30000 0 2 4 6 8 DB rRMWKH Baa aA SD BD ZZ Range m Channel Eas Range m us rag HE b Channel Display Channel Afafe Index Averaged Count alpy Averaged amp Ly eta Figure 1 8 Example for crosstalk effects on all dynodes at the beginning of the square wave pulse followed by a breakdown of the amplification chain The max average current per anode is 6uA This corresponds to 12 5 x 10 photoelectrons per second at 850 V 3 x 10 gain Like in other photomultipliers the max average current value can be exceeded for a short period of time but exceeding this value by more than a factor of 10 20 is not recommended to avoid saturation effects as described above This means that light levels corresponding to single photon count rates of 125MHz to 250MHz should be avoided 1 3 3 Detector Homogenity Typical sensitivity variations for the Hamamatsu H7260 detectors are shown in the H7260 series datasheet attached here The individual gain variations for the detector ZB1487 are shown in fig 1 9 Detector This sensi
39. a compression technique The data sent on the PUSH Socket is in the following binary format Fixed Marker 0xFFFFFFFF 4 byte unsigned int Number of Shots 4 byte unsigned int Number of Traces 4 byte unsigned int Number of Bins 4 byte unsigned int Data Time Stamp 8 byte double Current Sensor Value 4 byte integer Data Compression Factor 4 byte integer DATA no of compressed traces x no of bins 2 byte unsigned integer numbers Where the first seven fields in the above described binary data format is referred to as the PUSH mode Data preamble header An example of this command would be START 16 PUSH This will instruct the controller to start acquisition of 16 shots with the PUSH mode enabled When the START command is sent with the TRANSMIT flag the data is sent automatically on the COMMAND Socket oncethe target shot number has been acquired Different to the Push mode that is activated by the PUSH flag the TRANSMIT flag does not restart the SP32 detector automat ically to acquire the next set of target shot number The data response for this command is exactly the same as the response for the DATA Command An example of this command would be 82 CHAPTER 7 SP32 CONTROLLER TCPIP COMMAND LIST AND SYNTAX START 1 TRANSMIT This will instruct the controller to start acquisition of 1 shot and transmit the data automatically on the COMMAND Socket The reply from the controller is the same for all the variants of the START command and i
40. able discriminator and the trigger logic is integrated on the module The Ethernet interface is used together with LabVIEW software to control the measurement and readout the acquired data The Licel Multispectral Lidar Detector can be used with various flat field spectrographs 1 2 The Counter The counter contains a microcontroller which receives its commands over the Ethernet It will set the high voltage for the PMT and the discriminator level It will transmit the averaged time resolved spectra over the Ethernet to the PC The 32 channel counter receives the raw anode signals from the PMT It also provides the software controlled high voltage for the PMT The 32 raw signals are then amplified and fed in to the discrimi nator The threshold level is software controlled Behind the 32 discriminators are 32 counters which Detector will count the single photons for each channel individually Beginning with an external trigger the counts of all 32 channels are recorded A fixed quartz based time base will be used to read out all 32 counters in parallel The microcontroller will average the spectra over multiple trigger events Once enough data has been acquired the summed up spectra will be transferred to the PC 1 3 Detector The module is based on a Hamamatsu H7260 Multi Anode photomultplier 32 photocathodes each 0 8 mm x 1 mm have their own dynode structure to amplify photoelectrons from each cathode strip The mechanical outline is shown
41. ace Data to be read Decompress Data A decompression routine is needed to extract the compressed traces back into its original format where each channel corresponded to a separate trace Summation Process The decompressed data is accumulated in the summation process The Q dataset is summed with the averaged data upto the Q 1 dataset and stored in the averaged data memory Averaging Done After the summation process check if the required external averaging datasets are completed If yes stop the process by issuing a STOP command If not read the PREAMBLE and repeat the above steps again 1 Chapter 7 SP32 Controller TCPIP Command List and Syntax This Chapter lists and describes the TCPIP command syntax for the Licel TCPIP Ethernet Controller present inside the Licel SP32 Detector Most commands can be sent either in its short or long format lt CRLF gt is carriage return line feed All commands sent to the controller should end with lt CRLF gt and all replies from the controller end with lt CRLF gt which will not be shown explicitly in this document If an unknown command is sent to the controller then the controller sends lt COMMAND gt unknown command back to the client where lt COMMAND gt is the command sent by the client to the controller Please Note Through out this document HOST refers to the the Ethernet Controller of the Licel SP32 Detector and CLIENT refers to the PC Acquisition System The following
42. allation Complete The installer has finished updating your system lt lt Back Cancel 7 At the end of the installation process permissions on some files will be set E Licel Setup Changing File permissions 8 If it is is necessary to restart the computer after the applications a dialog will pop up with an appropriate button for the restart procedure 9 After the installation has successfully been completed you are able to start the Windows appli cations through the corresponding entry in the program group Licel in the Windows start menu Tae Licel TCPIP Activate DHCP Mode 7 Windows Media Playe 33 Windows Messenger a Windows Messenger A Windows Movie Maker stat Licel TCPIP Getting Started National Instruments vision Assistant 7 1 Piet Licel TCPIP Set Mew Password Irfanview fay Licel PMT32 Acquisition A Log OFF o Turn OFF Computer E TCPIP Disable Secure Mode All Programs IE TCPIP Enable Secure Mode IF TCPIP Set Fixed IP Address Eu Search Controllers fag PMT32 Configuration k k 7 PMT32 Data Management d The links to the applications are grouped into the subfolders PMT32 Configuration PMT32 Acquisition and PMT32 Data Management ma a e PMTS2 Acquisition j wa PMT32 Acquisition PMT32 Pulse Height Distribution E PMT32 Configuration ff BH PMT32 Channel Acquisition E PMT32 Configuration F PMT32 Data Management gt fay PM
43. cating a correct electrical connection 2 Verify that in case of a 100Mbit ethernet connection the Spd lights up 3 Verify that the network settings of your PC have changed according to your settings a Open a command prompt window DOS box b Type ipconfig and press enter At least one of the ethernet adapters should show the address that you previously set 10 49 234 230 The response should be similar to the following 1 Ethernet Adapter IP AddreSsd wma s a a 10249 254 200 SUDO Mask s s e amp r s e E ANAA Standard Gateway 4 Verify that the Licel Multispectral Lidar Detector is accessible via the network now a Open a command prompt window DOS box or use the one from above b Type ping 10 49 234 234 and press enter The Licel Multispectral Lidar Detector should respond without loss of any packet If the controller is not responding check whether the network cable is correctly mounted and that an appropriate cable is used i e a cross link cable when working with a direct connection from the computer Most ethernet adapters indicate a correct connection with a green LED A non existent or incorrect connection is often identified by an unlighted LED left or red LED right Please note that these indi cators may be different on your PC c If the network cable connection is correct and the controller is still not responding execute a hardware reset and repeat the procedure with the default
44. commands are available Short Long HW HARDWARE CAP CAPABILITY DATA DATA DISC DISCRIMINATOR IDN IDENTIFICATION MSEC MILLISEC PASS PASSWORD PMT PMTSTATUS PMTG PMTGAIN RES RESOLUTION RANGE RANGEBINS STAR START STOP STOP STAT STATUS TCPIP TCPIP HARDWARE HW Requests the hardware information of the SP32 detector The format of the reply from the controller is as follows HW HWRev BinLen MaxRangeBins BinSize MaxShots Endianness PUSH MaxPushShots CmpFtor VARCOMP VARTRACE CurrentRangebins MaxBinLen 78 CHAPTER 7 SP32 CONTROLLER TCPIP COMMAND LIST AND SYNTAX Where HWRev Is the hardware revision number of the detector BinLen Is the current resolution binlength in nano seconds setting of the detector MaxRangeBins Is the maximum acquisition range bins BinSize Is the size in bytes of each range bin MaxShots Is the maximum number of shots the detector is capable of internally averaging Endianness Is the endianness of the system big endian little endian BE LE PUSH Indicates that the detector supports MASTER PUSH mode MaxPushShots Is the maximum number of shots the detector is capable of averaging internally in the PUSH mode CmpFtor is the compression factor of the PUSH mode data VARCOMP indicates that the detector supports variable compression VARTRACE indicates that the detector supports variable trace length CurrentRangebins is the current rangebins setting of the detector MaxBinLen Is t
45. ctivate DHCP for the transient recorder controller This VI uses the default password Administrator and the default port 2055 If the port has been changed you must change the current port to the proper value The DHCP port is the port that will be used for DHCP communication After DHCP mode has been set communication will be lost until the acquisition computer is configured for DHCP communication as well Licel TCPIP Disable Secure Mode vi This VI is used to disable the Secure Mode of the Licel Ethernet Controller The initialization file LicelT CPIP ini is modified to allow future access without using the Secure Mode login Licel TCPIP Enable Secure Mode vi This VI is used to enable the Secure Mode of the Licel Ethernet Controller The initialization file LicelTCPIP ini is modified to allow future access using the Secure Mode login This file should be copied to the same directory where Licel TCPIP Ilb resides on all PCs from where access is allowed Licel TCPIP Getting Started vi This VI gets the identification information from the transient recorder controller 95 Licel TCPIP Driver VIs IP Address Identification Port error out error in no error Licel TCPIP Set Fixed IP Address vi This VI is used for setting the new IP configuration for the transient recorder controller Licel TCPIP Set New Password vi This VI is used for setting the new password for the Licel Ethernet Controller 9 1 2 Controller related
46. data externally in order to reach the desired shot number This is known as External Averaging This is performed by operating the detector in the PUSH mode The PUSH mode operation makes use of data compression mechanisms to optimize transmission Hence when performing External Averaging using the PUSH mode care must be taken to cor rectly decompress the incoming data before averaging them A clear understanding of the data com pression techniques used by the Detector to transmit data on the PUSH Socket is necessary before performing the decompression at the client side Please refer to the PUSH Mode Transmission Data Compression for more information on these techniques Consider the following example Suppose we have to acquire 4000 shots of data from the SP32 detector The following steps lists the brief procedure to go about it e Step 1 Determine the hardware information of the detector using the HW command Let the reply from the detector be HW 2 500 0 8000 2 10000 LE PUSH 100 2 VARCOMP VARTRACE 2000 1000 0 From the reply it can be concluded that the detector is a l1ittle endian system supports PUSH mode supports variable compression data transmission can average a maximum of 100 shots internally and transmits the data with a compression factor of 2 Hence in order to acquire 4000 shots a mechanism of 100 shots internal averaging and 40 datasets external averaging is required 74 Client Side External Averaging of PUSH Data
47. de int xspCompFact bool xspVarTrace bool xspVarComp int spCurBins double xspMaxBinlen Description Get the control Hardware Configuration parameters Licel_SP_TCPIP_SlaveMode_Start_Acq Syntax int Licel SP TCPIP SlaveMode Start Acq SOCKET s int targetshots Description Starts the acquisition of the SP32 controller in the Slave Mode Licel_SP_TCPIP_SlaveMode_Get_AcqStatus Syntax int Licel SP TCPIP SlaveMode Get AcqStatus SOCKET s int x AcqgStatus int xcurrentshots int current Description Get the current acquisition status of the controller Licel SP_TCPIP_SlaveMode_Get_Data Syntax int Licel SP TCPIP SlaveMode Get Data SOCKET s 88 Description SP32 Detector C Drivers Get the acquired data from the controller Syntax Licel_SP_TCPIP_Stop_Acq int Licel SP TCPIP Stop Acq SOCKET s Description Stop the data acquisition of the controller Syntax Licel SP_TCPIP_Set_Resolution int Licel SP TCPIP Set Resolution SOCKET s int resolution Description Set the resolution setting of the controller only for controllers that support variable trace acqui sition Syntax Licel SP TCPIP Set Rangebins int Licel SP TCPIP Set Rangebins SOCKET s int rangebins Description Set the rangebins setting of the controller only for controllers that support variable trace acqui sition Function arguments cmd soc sp app so_hw sp_mes sp pr
48. e function is used to read the Slave Mode Preamble Header The parameters extracted from the preamble are stored in the Spectrometer Preamble Structure and are used to dynamically set up the memory trace required to read the rest of the incoming data Licel SP SlaveMode Read Dataset Syntax int Licel SP SlaveMode Read Dataset SOCKET cmd soc Spectro Preamble xsp preamble Spectro Hardware xsp_hw long int xadvanced viewer data Description The slave mode read data set function is used to read the Slave Mode Channel Trace Data Since the controller transmits uncompressed data in the slave mode a decompression routine is not required on the client side However the raw data is transmitted as an unsigned char data type and hence has to be reconstructed at the client side if the data width is greater than 1 byte After the acquisition of the RAW Data data reconstruction functions are used to reconstruct the data according to its corresponding data widths Please note that the data is reconstructed taking into consideration the endianness of the incoming data licel sp util This category implements utility helper functions that are called by the functions in the licel sp cate gory Licel SP UTIL Reconstruct SlaveMode 2Byte TraceData Syntax void Licel SP UTIL Reconstruct SlaveMode 2Byte TraceData unsigned char incomingdata unsigned short xreconstructedtrace Spectro Preamble xsp preamble Spectro Hardware sp hw Desc
49. e g if the software has not been cor rectly stopped in a previous run Set the discriminator level to the selected value Set the high voltage to the selected value Set the resolution to 200 if supported by the hardware Set the range bins to1000 if supported by the hardware Start a PUSH mode acquisition Stop if the acquisition atthe PUSH socket has been Done or lt Cancel gt is pressed then set Stopped TRUE or a previous error has been detected A STOP command is sent via the command socket The VI sets the high voltage to O V Program end 14 The will close the TCP IP connection PUSH Socket Open a TCP IP connection PUSH socket with the device at the given IP Address and Port 1 Read bytes from the PUSH socket Extract data from complete data telegrams Update the shot number Stop if the Target Shots have been reached then set Done TRUE or the acquisition has been Stopped or a pre vious error has been detected The acquired data is displayed Data at the PUSH socket is trashed The TCP IP PUSH socket is closed 15 If an error occurs it will be shown in a standard dialog and on the front panel indicator 63 Data Acquisition Overview These execution steps can be seen on the block diagram of the VI in the next figure qno Joua 54 pom avr op fti tii sayndwo gt Ap fosdayjauueydZe Ld cl sesusnesenaveesensnenenens
50. eamble advanced viewer data incomingdata reconstructedtrace filename tStartTime S The client TCPIP socket to communicate with the command socket of the SP32 controller The Spectrometer Application Structure object used to store application acquisition parameters from the configuration file The Spectrometer Hardware Structure object used to store the controller s hardware parameters from the Hw command The Spectrometer Measurement Structure object used to store application measurement parameters from the configuration file The Spectrometer Preamble Structure object used to store parameters from the data preamble The acquired data in long int format The raw incoming data from the controller in unsigned char format The reconstructed trace from the raw data dependent on data width The name of the file to write the acquired data The data acquisition start time stamp The client TCPIP communication socket 89 SP32 Detector Sample Applications sohwRev The controller hardware revision number spBinlen The length of each rangebin in nano seconds soMaxBinlen The maximum length minimum resolution of each rangebin in nano sec onds spBins The maximum number of rangebins spCurBins The current rangebins setting soNumBytes The size in bytes of each element in the incoming data trace spVarComp Variable compression factor flag sp Var Trace Variable acquisition trace flag resolution The resolution s
51. ector the acquired shots and the target shots Optionally a value Inum representing the current is returned The current in mA is obtained by I mA Inum Scale Offset Scale defaults to 0 0028172248 mA Offset defaults to 0 0143994941 mA Timeout TCPIP Ref In TCPIP Ref Out acquired Shots error in no error ii ie Mode error out Current PMT32Channel Set NumBins vi Set the number of bins to read This VI is supported only by controllers returning Variable Trace TRUE in the hardware information request Timeout TCPIP Ref In Bins error in no error TCPIP Ref Out Received String i Ignored error out PMT32Channel Set Resolution vi Set the resolution in nanoseconds This VI is supported only by controllers returning Variable Trace TRUE in the hardware information request Timeout TCPIP Ref In Binwidth ms error in no error TCPIP Ref Out Received String i Ignored error out 99 PM32 Detector Specific Vis PMT32Channel Read ADC vi Read Samples points of the ADC trace Timeout TCPIP Ref In Samples error in no error TCPIP Ref Qut Recerved String ADC Data error out l PMT32Channel Read Current vi Read the current value Inum of the PM32 detector The current in mA is obtained by I mA Inym Scale Offset Scale defaults to 0 0028172248 mA Offset defaults to 0 0143994941 mA Timeout TCPIP Ref In TCPIP Ref Out Recerved String Current error out error in n
52. ecureMode is true and SecureModePWD is found the vi will send the password using the LOGON command Licel TCPIP Login Secure Mode vi Otherwise just the TCP IP connection will be opened Show Warnings T address connection ID Remote Port Connection Failed Timeout error out error in no error local port Licel TCPIP Set Access Limited vi Enables the limited access to the controller i e activates the secure mode Access is granted only for IP addresses as specified with the WHITELIST command Moreover the connection password is specified TCPIP Ref In TCPIP Ref Out Password m Connection Password Sia E error in no error 98 PM32 Detector Specific Vis Licel TCPIP Set Access Unlimited vi Disables the limited access to the controller i e deactivates the secure mode Access is granted for everybody TCPIP Ref In TCPIP Ref Out 7 MASS e error out error in no error Licel TCPIP Set Whitelist vi This VI is used to set the allowed hosts at the controller In order to do so the user must enter the appropriate password and 3 host strings to allowed IP addresses or IP address ranges Such a string must be specified in the following format XX XX XX XX a single IP address xx xx xx 295 an IP address range 0 255 or may be empty TCPIP Ref In TCPIP Ref Out ERA error out error in no error Password 9 2 PM32 Detector Specific Vis PMT32Channel Get Status vi Returns the acquisition mode of the PM32 det
53. er routines in your project EXIT lidar Goraputing and electronmcs e Press Install Applications to start the Windows Installer which will guide you through the installation of the Licel Applications Please proceed to the section 3 3 e Press Copy LabVIEW Sources to copy the LabVIEW source files from the CD ROM to a folder of your choice on your computer Please note the remarks according to existing LabVIEW library files Please refer to the section 3 4 for further details e Press Browse CD to inspect the content of the CD ROM e Press Exit to exit the dialog without any further action sa Start 3 If the selection dialog does not come up please press the button select Run in the upcoming menu Tour Windows XP O Help and Support Search programs gt Ci Be Log CFF fo Turn CFF Computer In the dialog box enter lt CD drive letter gt autorun exe where CD drive letter is the letter corresponding to your CD ROM drive E in the picture and press OK Installing the Windows Applications Type the name of a program Folder document or Internet resource and Windows will open it For you des Lx The selection dialog from above should now be started you will be able to select one of the installation options 3 3 Installing the Windows Applications This subsection describes the installation process for the Licel Windows applications To operate the Licel Windows applicati
54. er specified or system time limit 4 6 Network Security Certain administrative tasks use an administrator password An example is the change of the IP address of the controller The administrator password has to be sent with the related commands 4 6 1 Changing the Administrator Password The Licel Multispectral Lidar Detector is shipped with the default administrator password Adminis trator In order to change this password which grants administrative access to the controller please carry out the following steps 1 Open Licel TCPIP Set New Password vi or start the corresponding Windows applica tion from the Windows start menu 31 Hardware Reset Please enter the new password Run the yi Current IP ddress 10 49 254 254 Current Pork Password New Password et 2 Enter the current administrator Password E o E oo a 3 Enter the New Password 4 Run the vi by pressing the start button It should finish without opening an error message dialog Please note that the password is case sensitive 4 7 Hardware Reset A reset is performed by pressing the reset switch while powering up the controller The reset switch is located between the DC connector and the trigger input connector To reset the system e turn off the unit press the reset switch turn the rack on while keeping the switch pressed release the switch 5 seconds after switching the unit on wait for 30 seconds Afte
55. essfully then the reply from the controller is RANGEBINS executed lf the controller fails to change the rangebins successfully then reply from the controller is RANGEBINS ignored START lt target shot number gt PUSH TRANSMIT STAR lt target shot number gt PUSH TRANSMIT Starts an acquisition of the SP32 detector with target shot number shots to acquire The START command can be used in 3 different ways It can be sent without any optional PUSH TRANSMIT flags in which case the command just starts the acquisition of the SP32 detector for the target shot number An example of this command would be START 16 This will instruct the controller to start the acquisition of 16 shots The START command can be sent with either of the optional flags in which case the controller will show some modified behavior When the START command is sent with the PUSH flag it activates the PUSH mode mechanism in the SP32 detector In this mode the data is sent automatically on the PUSH Socket once the target shot number has been acquired and restart itself to acquire the next set of target shot number Different to the data response sent for the DATA command the format of the data sent on the PUSH Socket has an additional time stamp information in milliseconds accurate to micro seconds for each of its data sets ADC value of the on board high voltage supply current sensor and the current compression factor The data is also transmitted using
56. etector Sample Applications 0 2 000 ee es 8 2 1 SP32 SlaveMode Acquisition Application 0 500008 8 2 2 Application Configuration File 0 000 2 eee ee ee 8 3 Data File format 0 0 2 8 3 1 Samplefileheader 2 0 0 2 ee 9 LabVIEW Driver Vis 9 1 Licel TCPIP Driver VIS 2 2 ee Mid TODLOGI VE a coche hee ee bh ES REDE BRR Ow EE OE 9 1 2 Controller related VIS 2 0 9 1 3 Transient Recorder Commands applicable to PM32 Detector 9 1 4 PMT Commands applicable to PM32 Detector 9 1 5 Network Security 2 ee 9 2 PM32 Detector Specific VIs a aoao A 54 54 54 60 65 65 67 70 72 73 73 74 19 Chapter 1 The Licel Multispectral Lidar Detector 1 1 Overview The Licel Multispectral Lidar Detector allows simultaneous detection of multiple spectrometer wave lengths It is based on a multianode metal channel dynode photomultiplier 32 photocathode ele ments together with 32 single photon counting systems provide 2 dimensional spectral and range resolved data DC AC 1 High Voltage Power supply 32 Discriminator 32 Counter 1 Quartz Timebase 1 Microcontroller Spectrometer MT External Trigger P y 32 time resolved spectra Ethernet lt i PC gt Entrance Slit Mounting Flange Figure 1 1 Licel Multispectral Lidar Detector The high voltage supply an adjust
57. etting of the controller rangebins The rangebins setting of the controller soMaxShots The maximum shots acquirable by the controller soMaxPushShots The maximum shots acquirable in the Push mode spBE Big Endian data format flag If this flag is set then the incoming data is in big endiann format spPushMode Push Mode supported flag soCompFact The compression factor of the incoming data traces current The ADC value from the Current Sensor This is displayed as an integer targetshots The target number of shots to acquire AcqStatus The acquisition status of the system O Idle 1 Armed or 2 Acquiring currentshots The current number of shots acquired by the system 8 2 SP32 Detector Sample Applications The file SP32_SlaveMode_Acquisition cpp contains the application that demonstrates the use of the SP32 slave mode C drivers 8 2 1 SP32_SlaveMode_Acquisition_Application The Slave Mode Acquisition application implements the data acquisition technique as illustrated in the SLAVE Mode Data Acquisition Overview This application makes use of an Application Configuration File to configure the application acquisition parameters The user can enter the desired values in the corresponding fields of the configuration file to work with different parameters Currently this application does not support the use of the TRANSMIT flag The application opens up a connection to the command socket of the SP32 controller using the host IP addres
58. f the transmitted data is 2 bytes 16 bits long and and only 4 bits of that rangebin contains the needed information with the others being redundant 0 s then a compression factor of 4 is used This implies that four channels of trace data are compressed into one single transmission trace This gets rid of all the redundant O s and all the 16 bits now contain the required information Since the SP32 detector has 32 channels the compressed data will now have 8 traces with each trace as wide as the number of rangebins It can be represented as the following 2D array COMPRESSED_DATA 8 no of rangebins Where the size of each element of the 2D array is as determined by the BinSize parameter of the Hw command reply Shown below is the graphical representation of 0 range bin of the 0 transmitted data trace 16 bits long for the above example 70 PUSH Mode Transmission Data Compression Rangebin 0 Rangebin 0 Rangebin 0 Rangebin 0 Channel 3 Channel 2 Channel 1 Channel 0 Where C 3 Cz9 denotes the corresponding Channel Trace bits and T 15 7o denotes the corre sponding Transmission Trace bits Please Note With reference to the above example if the controller is a Little Endian system then the bits 7o7 Jo0 Rangebin O of Channel 1 and Channel 0 is transmitted first followed by bits Toi5 7os Rangebin O of Channel 3 and Channel 2 If the controller is a Big Endian system then bits 715 7 Rangebin O of Channel 3 and Channel 2 is
59. g the blue and red Cursors Once you have adjusted your signal and would like to save it to a file in ASCII format as it is displayed press the Save Single button Please select a filename for ASCI columns data 2 x Save in temp amp E E Summed Files File name My ASCII E ata Save as type Custom Pattern dat Cancel Enter the desired file name press Save The file extension dat will automatically be added to the file name unless you choose a different extension Afterwards the data is saved in ASCII format as a column and can be imported into other programs for further evaluation converts all datasets contained in the actual data file to an ASCII format file and appends the ex tension dat to the end of the actual file s name The whole file can then be imported into other programs If you would like to load the next file or previous file in a time series this can be done by pressing the lt Previous or Next gt buttons By pressing one of these buttons either the file acquired before or after the current file will be dis 47 PMT32 Viewer played if it exists in the same directory You can then manipulate the data using the aforementioned capabilities of Advanced Viewer and save the data from the new datasets to ASCII if desired Two data file utilities may be called from the Advanced Viewer one to sum the data values of several files to one single file Datafile Addfiles Interface vi
60. gebin 0 If the system is Big Endian 0x5A is transmitted first since its the highest byte followed by 0x9c The first byte received at the client 0x5A represents Channel 1 Rangebin 0 and the second byte received at the client 0x9C represents Channel 0 Rangebin 0 6 4 PUSH Data Time Stamps Every dataset transmitted by the detector in the PUSH mode on the PUSH Socket has a time stamp associated with it This is the time in milliseconds since powering on the detector The PUSH Data Time Stamp can be used to monitor the interval in which the push datasets arrive at the client For a certain laser trigger frequency and target shot number the detector acquires data timestamps the data transmits the data and finally restarts itself to acquire the next acquisition cycle at fixed intervals Hence the datasets arriving at the client must have a fixed timestamp difference between two consecutive datasets If there is an irregularity in the difference between two consecutive time stamps even though the target shots trace length parameters and the laser trigger frequency is kept constant there could be a possible loss of shots The detector has an internal buffering mechanism which stores the data acquired in temporary buffers if the detector is not able to transmit the data fast enough and restart itself before the arrival of the next laser trigger However if there is heavy load on the ethernet the untransmitted data gets continuously buffered and can ca
61. guration tab page the 32 PMT channels options can be set 00000000000000000000000000000000 do do The following settings are available Active Channels for Saving defines the channels to be saved to data files This setting is stored in the initialization file Select All selects all channels Unselect All unselects all channels Center Wavelength this wavelength is the center wavelength of the 32 channel PM array found after a calibration This value effects together with nm per Channel the wavelength of the individual channels in the header lines of the data files and the display of the spectrum on the Multispectral Lidar tab page This setting is stored in the initialization file nm per Channel this wavelength is the center wavelength of the 32 channel PM array found after a calibration This value effects together with Center Wavelength the wavelength of the individual channels in the header lines of the data files and the display of the spectrum on the Multispectral Lidar tab page This setting is stored in the initialization file 38 PMT32 Channel Acquisition Voltage and Discriminator Level The High Voltage and Discriminator are set in the middle of the page Multispectral Lidar Both the Discriminator level and the High Voltage value are saved to the initialization file The voltage set at the Licel Multispectral Lidar Detector is displayed at the top External Internal Trigger In normal operation it is ass
62. he discriminator level of the SP32 detector Valid values for the discriminator are 0 63 An Example To set the discriminator level to 16 send the command DISCRIMINATOR 16 The corresponding reply from the controller is DISCRIMINATOR set to 16 If the Integer value is out of range the reply is DISCRIMINATOR value is out of range IDENTIFICATION IDN Requests the controller to send its identity and firmware revision An example reply is as follows Licel Zyng SP32 Standard Resolution Spectrometer Ethernet Controller Rev 19 11 2014 MILLISEC MSEC Requests the millisecond timer value of the ethernet controller The corresponding reply is MILLISEC time Where time is a number in milliseconds since the powering on of the ethernet controller PASSWORD lt Old Password gt lt New Password gt lt New Password gt PASS lt Old Password gt lt New Password gt lt New Password gt Changes the password of the ethernet controller The actual password is required to change the IP configuration of the ethernet controller The user needs to enter the old password and then the new password twice The default password is Administrator The password will be reset to this if a hardware reset is executed on the controller An example would be PASS Administrator MyPassword MyPassword This will change the password to MyPassword The corresponding reply from the controller is PASSW
63. he maximum binlength minimum resolution of the detector An example would be HW 2 50 0 8000 2 10000 LE PUSH 100 2 VARCOMP VARTRACE 2000 1000 0 Please Note Data compression techniques are applied only when the detector is operated in the PUSH mode For more information about data compression please read the section on PUSH Mode Transmission Data Compression CAPABILITY CAP Requests the capabilities of the ethernet controller The controller s response is CAP Capability Where Capability Is the fixed expression 32CHANNEL in the case of the Licel Sp32 Detector The response is CAP 32CHANNEL DATA Requests data from the controller Sending a DATA command will instruct the controller to transmit the acquired data in the following binary format Fixed Marker OxFFFFFFFF 4 byte unsigned int Number of Shots 4 byte unsigned int Number of Traces 4 byte unsigned int Number of Bins 4 byte unsigned int DATA number of traces x number of bins 2 byte unsigned integer numbers Different to the response of the other commands no lt CRLF gt Is added here The first four fields in the above described binary data format is referred to as the data preamble header Please note Different to the DATA response sent when the PUSH mode is active the DATA response sent here is in the uncompressed format 19 CHAPTER 7 SP32 CONTROLLER TCPIP COMMAND LIST AND SYNTAX DISCRIMINATOR lt Integer gt DISC lt Integer gt Sets t
64. hich the detector will be ready to accept the next trigger The internal acquisition process continues until the desired number of shots has acquired For example if the number of rangebins is 8000 bins and the resolution is 10 ns trace length 12 km the acquisition time for a single shot would be 8000 x 10 ns 80000 ns Factoring in the dead time of 6 rangebins between two triggers the system will be ready to accept the next trigger after 80060 ns This corresponds to an approximate trigger rate of 12 49 KHz After the internal acquisition process is finished the data has to be readout to the slower DDR3 DRAM so that it can be prepared for ethernet transmission The data readout is a slow process and will block the trigger for a time period that depends on the trace length and the number of shots being acquired The internal acquisition process ensures data acquisition without loss of shots provided the acquisition time for a single shot is less than the time between two trigger pulses The mode in which the SP32 detector is operated is entirely dependent on the application require ments If the application needs a single data set of a fixed number of shots then the SP32 should be used in the SLAVE mode If the application needs a continuous stream of data sets at regular intervals each containing a fixed number of shots then the PUSH mode must be used For example if laser repetition rate is 100 Hz 10 ms and the user needs to acquire a con
65. his will set the gain voltage of the PMT with device number 0 to 980 volts The corresponding reply from the controller is PMTG executed If a non zero device number is specified the reply is PMT 3 is not available Where the number 3 is the device number of the non existent PMT RES lt value gt RESOLUTION lt value gt This command sets the resolution at which the SP32 detector must acquire the data The highest resolution possible is 10 ns and the lowest resolution is determined by the MaxBinLen parameter of the Hw Command The default value after powering on the detector would be 10 ns An example would be RESOLUTION 50 This instructs the controller to change the resolution of the detector to 50 ns If the controller changes the detector resolution successfully then the reply from the controller is RESOLUTION executed If the controller fails to change the detector resolution successfully then reply from the controller is RESOLUTION ignored RANGE lt value gt RANGEBINS lt value gt This command sets the number of rangebins the detector must acquire The highest number of rangebins acquirable is 8000 and the lowest is 10 The default value after powering on the detector would be 8000 bins 81 CHAPTER 7 SP32 CONTROLLER TCPIP COMMAND LIST AND SYNTAX An example would be RANGEBINS 4000 This instructs the controller to change the total rangebins to acquire to 4000 If the controller changes the rangebins succ
66. ho EM High Voltage gates 500 ae 0 50 chio EM a no dh EM 5 qa 800 y chiz EM 3 1007 900 E 0 00 h3 EM 0 1000 0 25 chit RM PMH 900 0 50 chis EM 0 75 chis Za 1 00 l l 1 l l l l l l l 1 l l chi Av O 5 10 15 20 25 30 35 40 45 50 55 60 63 chi Discriminator Level i 3000000000000000 a ests av f 3 art Signal Bin Differential MHz CAA A 000000000888 do TM 0 25 chaz EM Final Signal Bin 1024 0 20 F h23 A 0 15 asa Shots to Average 100 i ch24 EM 0 10 ve J hos EM Current Shotnumber 100 J tN m 000 Start DiscrLevel 0 05 0 10 Stop DiscrLevel 1 5 0 15 Current Discr Level 2 0 20 A 0 25 i i i i i i 0 E 10 15 20 25 30 o Discriminator Level HE e Acquired Raw Data 2250 2000 raso 1500 1250 3 J amp 1000 Eis 500 ard 0 l l l l l 1 l l 1 l O 100 200 300 400 500 600 700 300 900 1000 Bin wack e 4 D 1 Before you start please enter the correct values for the IP Address and Port You should already have set these values for the Licel Multispectral Lidar Detector e Using the LabVIEW vi just enter the required values on the TCP IP page and save them as defaults Multispectral Lidar l ROI Configuration IF Address 10 45 234 254 Timeout 5 5000 l Fort i ry 52055 e If you run the Windows application you should set the values in the initialization file PMT32Channel ini You will see the full path of the f
67. icel software libraries in case you want to restore them by either compressing them zip ARJ TAR etc or burning them onto a CD ROM 2 Scan your disks to find all versions of the following files and delete them once you have made backups of them Advanced Viewer 1llb patetiles11b Licel Graph llb Lic l Module ilb Lica ll FCP PP ei rece UCEL eS PMT32 Viewer 1llb PMT 3SzZChannel Pulse 1b PMT 3 2Channek Lib TEP EP Acquis Vib The Licel CD ROM Please note Licel may have provided individual software solutions with additional or less Lab VIEW library files than noted in the list above 3 Search the directory your older version of Licel LabVIEW libraries reside and backup all initial ization files x ini 3 2 The Licel CD ROM The CD ROM provided by Licel contains both the LabVIEW sources and the Windows Installer for installing the Windows applications and a documentation folder Licel may add customer specific components on the CD ROM 1 Insert the Licel CD into your CD ROM drive 2 The following selection dialog should appear automatically Licel Ethernet Software ae This will install the applications together with a run time engine Install Applications Use this option if you don t have a Labh l EW environment installed on pour machine Copy LabVIEW S This will copy the LabVIEW Sources to your machine Use this Copy LabVIEW Sources option if you have LabViEW installed and plan to use the driv
68. igth the spectrum Is obtained by integrating all acquired chan nels in the range specified by the cursors in the individual channel display The specified range is shown at the bottom below the graphic display The Channel Display x axis may be switched either to the channel Index display or to a Wavelength scale according to the Center Wave length and nm per Channel from the configuration Start Height m 2700 Channel Display Range m 8460 Index 5 4 PMT32 Viewer You can load the PMT32 Viewer by either double clicking on the PMT32 Viewer 11b or by selecting the virtual instrument PMT32Channel Viewer vi IN PMT32 Viewer 11b If you installed the Windows applications please start the program by selecting the entry PMT32 Viewer in the Licel section of the Windows Start menu After doing so you should see a screen similar to the one below Viewer Calibration Channel 1 MHz Photoncounting 0 00 Bawa tho Dataset BR t null Photonc 330 0 00E C BI Offset Start Photonc 24870 0 00E Offset End Photonc 16590 0 00E C Spectrum S 7410 4 94E 3 Photonc MESES 1560 2 47E 2 Photonc Eil Mode Photon Counting Discr Level 5000 10000 12500 15000 17500 20000 22500 25000 27500 29970 m ale Baie amp Path 5 lt Previous next gt pis between the green Cursors Spectrum Start and Spectrum End HE m E E B 30 i os 5 20 T15 10 Channel Display 5 jp eveenat 0 Cha
69. ile in a file path indicator on the TCP IP page 34 E PMT32 Pulse Height Distribution Initialization File E Program Files Licel PMT32Channel PMT32Channel ini Please switch the Licel Multispectral Detector on and connect a trigger to the trigger input 3 To start the program press the Run button at the top left of the screen The Windows application will start automatically when called for the first time After a short time the TCPIP indicator should change its color from red to green indicating a successful connection with the Licel Multispectral Lidar Detector If the indicator remains red and or an error is indicated please check the values for IP Address and Port change them on the program s panel or in the initialization file if necessary Check if the Licel Multispectral Lidar Detector is running and that all network connections are correct er ter To record pulse height distributions please follow the steps below 1 2 3 4 5 Click on the Make sure that your TCP IP connection is alive Enter the desired voltage PM HV and switch the High Voltage on Select the Start Signal Bin Final Signal Bin and the Shots to Average Select the Start Discriminator Level and the Stop Discriminator Level Select the Active channel by enabling the LED type control field below the upper graphics The numbering is as follows 9 2 4 16 8 10 12 14 16 18 20 22 24 26
70. input 4 To start the program press the Run button at the top left of the screen The Windows application will start automatically when called for the first time 5 After a short time the TCPIP indicator should change its color from red to green indicating a successful connection with the Licel Multispectral Lidar Detector If the indicator remains red and or an error is indicated please check the values for IP Address and Port change them on the program s panel or in the initialization file if necessary Check if the Licel Multispectral Lidar Detector is running and that all network connections are correct ya E 6 If the controller sends the data via a second TCP IP connection a second TCPIP indicator will be visible lf you run the program for the first time it is recommended to verify and set some parameters If the storage path for the data files found in the initialization file is invalid a message will inform you A Please select a valid path as your working directory The working directory is used to store your data files Please refer to the next subsection to set the working directory and the other parameters Clicking the switch will stop the program Global Configuration Parameters The global configuration parameters can be set in the middle of the tab page Configuration liso ds so Ho 3 PMT32 Channel Acquisition The Working Directory is the location where you want data files to
71. ion time is small low number of shots to acquire and or a high laser repetition rate then the rate at which the detector sends data to the client is relatively much faster when compared to the case where the acquisition time is large large number of shots to acquire and or a low laser repetition rate Hence in cases where the acquisition time is large it is important to know the internal shot acquisition status The detector sends the current shot acquisition status using a full sized PUSH mode Data Preamble Header When the PUSH mode Data Preamble Header is used to send the internal shot acquisition status all its fields are set to O except for the Dataset Marker andthe Acquired Shots fields When such a Data Preamble Header is received it should be used only to update the shot number and for nothing else 6 6 Efficient use of SP32 Detector for Data Acquisition This section explains the recommended methods for the efficient acquisition of data using the Licel SP32 Detector The data acquisition process of the SP32 detector can be divided into two steps the internal acquisi tion and the data readout During the internal acquisition the detector accepts a trigger and acquires the full trace length of the data and stores it in its internal fast SRAM After receiving a trigger the detector blocks all other triggers until the full trace length of the data is acquired Once the full trace length is acquired there is a dead time of 6 rangebins after w
72. irectory LabVIEW Files on the CD ROM to a directory of your choice 18 Installing the Licel LabVIEW Libraries e If you downloaded the Licel software from hitp www licel com software htm please unpack the content from the downloaded zip file and copy it to a directory of your choice Please note that in the case the software is copied from a CD you may have to unselect the Read only attribute for the destination folder This is done by selecting the directory and right clicking on it Select Properties from the context menu Licel Ethernet Software File Edit View Favorites Tools Help sack E Ei Search Licel Properties gt Folders EF ll E General Sharing Customize Address C Licel Ethernet Software y paas x me o 55 DRIVERS acquis E E 1226 EA advanced viewer Tone File Folder 5 Licel Ethernet Software 68 ControlAPD E B Program Files 1T Location C Program Files CQ VxIPNP Explore Size 10 0 MB 10 492 317 bytes ES WwINbow s Open p E WINDOWS Search Size on disk 10 0 MB 10 555 392 bytes ee Licel Software EH m s Contains 26 Files 2 Folders E E Control Panel Sharing and Security P Shared Documents a E q My Network Places alobals Created Today June 10 2005 3 00 57 PM cg Recycle Bin Cu Copy a Attributes Read only Paste quis d e display Hidden Delete EE Rename Lick Verify that the Read only attribute i
73. is intended to be used in the SLAVE mode Please Note If the TRANSMIT flag is used care must be taken that no other command is sent on the COMMAND Socket until all the data is received from the controller In other words the COMMAND Socket must be blocked until the complete reception of data It is for this reason that the use of the TRANSMIT flag is recommended only when a smalltarget shot number has to be acquired step 9 Status If the detector was started without the TRANSMIT flag the client should monitor the data acquisition status of the detector by polling with the STAT command on the COMMAND Socket The shot number should keep increasing till the target shots is reached Once the target shots is reached the data is ready to be read out If the detector was started with the TRANSMIT flag it automatically transmits the data once the acquisition is completed and hence there is no need to poll with the STAT command Step 10 Data Once the detector has acquired all the shots it is ready to transmit the data to the client Issue the DATA command on the COMMAND Socket to instruct the detector to transmit the data If the TRANSMIT flag was used with the START command then the detector automatically transmits the data to the client without the need for a DATA command All of the above steps are illustrated in the form of a flowchart on the next page for easy reference 55 Data Acquisition Overview Yes Flowchart
74. is completed and restarts itself for the acquisition of the next cycle This process loops until a STOP command is sent by the client on the COMMAND Socket The STOP command disables the PUSH mode and sets the detector back into the SLAVE mode Please refer to the section on Efficient use of SP32 for Data Acquisition for more information on when to make use of the PUSH mode The typical steps involved in acquiring data from the detector in the PUSH mode are e Step 1 TCP IP Connection Open up a connection to the COMMAND Socket and PUSH Socket on the corresponding ports The detector makes use of the COMMAND Socket to receive commands and send replies The PUSH Socket Is used to send acquisition status and data to the client Step 2 Step 7 These steps are exactly the same as in the SLAVE mode Operation Step 6 Start Issue a START command for an acquisition of the required number of shots ca pable of being averaged internally along with the PUSH flag enabled The maximum shots capa ble of being averaged internally is determined by the Hw command reply by the MaxPushShots parameter The PUSH mode is only enabled after the START command is sent with the PUSH flag Once the PUSH mode is enabled all the client has to do is read and process the incoming data on the PUSH Socket 60 Data Acquisition Overview Yes Flowchart Licel SP32 Detector PUSH Mode Operation LabVIEW PUSH Mode Template As part of the LabVIEW so
75. isition Overview 6 1 2 PUSH Mode The SLAVE mode can sometimes cause a lot of delays due to Nagle Algorithm when the number of shots to acquire is very low like in the case of single shot acquisition mode due to the large number of small sized commands being issued In order to overcome this the PUSH mode was introduced In this mode the detector takes on the roll of the MASTER and the client acts as the SLAVE The detector is by default initialized to operate in the SLAVE mode after powering on The PUSH mode is activated only when the PUSH flag is used along with the START command Once the PUSH mode is activated the detector does not need any additional commands for data acquisition It transmits the data once the predetermined number of shots are acquired and automatically restarts the detector for the next acquisition cycle The PUSH mode makes use of a separate PUSH Socket in order to send data to the client The PUSH Socket is on the port COMMAND Socket 1 and hence the default port for the PUSH Socket Is 2056 The PUSH Socket is a unidirectional communication socket It is only used to send the acquisition data from the detector to the client All commands sent to the detector should be on the COMMAND Socket and the client can not use the PUSH Socket for any purpose other than to receive the data Once the detector is put into the PUSH mode it starts the acquisition of the requested shots transmits iton the PUSH Socket once the acquisition
76. ld not be re established after 5 attemps Check the network connection and the involved hardware Check if the IP Address and the Port are correct Check if the Licel Ethernet Controller accepts only secure mode connections if yes please contact the administrator of the Licel Ethernet Controller to provide you with an initialization File with the appropriate key values TCPIP_10 49 234 234 2055 UseSecureMode TRUE SecureModeP wos Do you want ko Retry and not wank to see this message again or do wank to Cancel and try bo Fix the problem cancel In the case that this dialog comes up please check the network connection and the involved hardware Check whether the Licel Multispectral Lidar Detector and all other Licel hardware is switched on Check that the ethernet cable is plugged correctly and that the correct ethernet cable is used Check whether the IP Address and the Port the software is using equal to the values of the Licel Multispectral Lidar Detector refer to the network setup 1 Before you start please enter the correct values for the IP Address and Port You should already have set these values for the Licel Multispectral Lidar Detector Using the LabVIEW vi just enter the required values on the TCP IP page and save them as defaulis If you run a Windows application you should set the values in the corresponding ini tialization file You will see the full path of the file in a file path
77. mbda Center Search Range with Delta Lambda Delta Lambda Search Range using the step widths Lambda Center Search Step and Delta Lambda Search Step A search is started by clicking the Search button 52 Calibration Seara tomar Z oe b A running search can be stopped using the button Stop c Lambda Center or Delta Lambda can be fixed using the corresponding checkboxes Lambda Fix and Delta Fix 6 After a search has finished the best combination of Lambda Center and Delta Lambda will be used to display the Combined result lamp G Combined spectrum 4 l E l l BOF l l I I I aos l l 340 350 380 40 420 40 460 0 500 520 Wavelength The resulting values for Lambda Center and Delta Lambda should be entered into the PMT32 Channel Acquisition program in the appropriate fields in the Configuration tab 7 The result of the search can be saved to a text file 4 columns index wavelength integrated lines acquired spectrum using the Save button 53 Chapter 6 Data Acquisition using the Licel SP32 Detector 6 1 Data Acquisition Overview This section describes how to acquire data from the Licel SP 32 Detector It shows in detail the two modes of data acquisition supported by the detector The PUSH mode and the SLAVE mode and lists the steps procedures for operating the detector in the respective modes Please Note Usage of the term Detector refers to the Licel Multispectral Lidar Detector which is abb
78. mode on the network controller The controller will listen at the specified Port Port 1 and Port 2 This command will only be executed if the password corresponds with the controller s internal password If not the controller replies with the following response TCPIP failed due to invalid password If the command is successfully executed the controller replies as follows DHCP activated The controller comes up with the defaults described in the TCPIP IP command Please Note A hardware reset will disable the DHCP mode 84 Chapter 8 SP32 C Sources Drivers 8 1 SP32 Detector C Drivers This section describes the C Drivers Sources that are provided for the SP32 detector The drivers are broadly classified under the following three categories e licel sp e licel sp util e licel sp tcpip In order for the driver functions to access the numerous parameters four structures are used to store and keep track of the corresponding parameters These are e Spectro Application Used to store the application acquisition parameters extracted from the application configuration file Spectro Measurement Used to store the application measurement parameters extracted from the application configuration file Spectro Hardware Used to store the controller s hardware configuration information ex tracted from the Hw command Spectro Preamble Used to store the acquisition parameters extracted from the incoming data preamble 8 1
79. move Programs Date Time Language and Regional Options o Other Control Panel Options l O Sounds Speech and Audio Devices Accessibility Options a Performance and Maintenance Security Center c In the next window click on Network Connections 22 Network Preparation E Network and Internet Connections File Edit View Favorites Tools Help sack k IH search 17 Folders N ait Network and Internet Connections x See Also sy My Network Places nl Pick a task a Remote Desktop te T n tacts gt Set up or change your Internet connection one and Modem Options gt Create a connection to the network at your workplace Troubleshooters A gt Set up or change your home or small office network 2 Home or Small Office Networking 2 Internet Explorer 2 Network Diagnostics gt Set up a wireless network for a home or small office gt Change Windows Firewall settings or pick a Control Panel icon wa Internet Options Network Connecti ns o S Er E wf Network Setup Wizard 3 Windows Firewall Wireless Network Setup Wizard d The installed network connections will be shown right click on the local ethernet connec tion to be used with the Licel Multispectral Lidar Detector and choose Properties from the context menu Network Connections File Edit View Favorites Tools Advanced Help Back a Ei P Search Ta Folders 9 555 Address e Network
80. must have its Photo Multiplier Tube PMT high voltage turned on in order to detect photons Set a suitable level of high voltage by issuing the PMTG command on the COMMAND Socket Step 5 Resolution When the detector is powered on the default resolution of the detector is 10 ns A different resolution can be set by issuing the RES command on the COMMAND Socket Step 6 Rangebins When the detector is powered on the default rangebins of the detector is 8000 A different value can be set by issuing the RANGE command on the COMMAND Socket 54 Data Acquisition Overview e Step 7 Status The current status of the detector must be determined before the start of the data acquisition Issue a STAT command on the COMMAND Socket to find out the current status of the detector If the detector is not in the Idle state issue a STOP command on the COMMAND Socket to stop the detector and bring it to the idle state Step 8 Start After all the above procedures are complete the detector can be instructed to begin its data acquisition Issue a START command on the COMMAND Socket to start the data acquisition The START command makes use of additional flags as explained in command syntax If the detector is intended to be used in the SLAVE mode care must be taken that the START command is either sent without any optional flags or with the TRANSMIT flag under special circumstances Under no condition should the PUSH flag be used if the detector
81. n case of the Licel Multispectral Lidar Laser source Number of bins 1 PMT high voltage bin width Channel wavelength 0000 000 number of ADC bits number of shots Detector one digit Always Laser 1 1 in case of the one digit 5 digits backward compatibility four digits in Volt two digits dot two digits in meter five digits dot one digit in nm backward compatibility two digits 00 in case of the Licel Multispectral Lidar Detector 6 digits integer analog input range discriminator level Dataset descriptor one digit dot 4 digits discriminator level in case of the Lice Multispectral Lidar Detector BC photon counting the number is the channel number as a hex adecimal O 1F The data set description is followed by an extra CRLF The datasets are 32bit integer values Datasets are separated by CRLF The last dataset is followed by a CRLF These CRLF are used as markers and can be used as check points for file integrity 94 Chapter 9 LabVIEW Driver VIs In this chapter an overview about the provided LabVIEW VIs is given The Licel TCPIP driver VIs are located in the LabVIEW library Licel TCPIP 11b The PM32 detector specific Vis are located in LabVIEW library PM32 Channel 11b Please Note The abbreviation SP32 is referred to as PM32 in this chapter for naming compatibility purpose 9 1 Licel TCPIP Driver Vis 9 1 1 Top Level Vis Licel TCPIP Activate DHCP Mode vi This VI is used to a
82. nced Timestamp CompressionLevel PMT32Channel Push CheckMarker vi Sub Vl of PMT32Channel Push Parser vi Test the data stream for the availablity of the marker DWord OxFFFFFFFF at the beginning Search for it if necessary Buffer im Buffer out InSync na er PMT32Channel Push EnoughDataBytes vi Sub VI of PMT32Channel Push Parser vi Check whether or not the data header is complete and if yes whether or not enough data according to the extracted values for Width Length and Data Width is available ByteOttset Width Length Buffer in Current Data Width 1 Shots VariableCompression i ShotHeaderAvailable CompressionLevel BytesAvailable Endian CompressionLevel out Timestamp PMT32Channel PushDecompress vi Sub VI of PMT32Channel Push Parser vi Extract the data from the data stream according to the parameters ByteOffset Width Length Data Width Compression Level and Endian Data Width Buffer im ByteOffset Width Length CompressionLevel Endian Buffer out Data 102
83. nd red cursors Offset Start and Offset End to a region which will be evaluated to generate the new baseline Change the Display Mode to Offset Corr and observe that the baseline of the signal changes Mm eee l l l l l l l l l l l O 2500 5000 7500 10000 12500 15000 17500 20000 22500 25000 27500 29970 m In the image above you can see that the baseline is now closer to zero The end values of the region to be used to evaluate the baseline are shown in the Offset Start and Offset End indicators Offset Start 24870 mi Offset end 16050 m The data can also be displayed in the Pr2 Pr mode which corrects for the power loss due to the length of travel of the signal The key parameter for the Pr2 mode is t null yellow cursor which defines the starting point of the signal When switching to the Pr2 mode the data will look similar to the following 46 PMT32 Viewer 1 20E 6 a Wy Cla toe act 1 20E 3 O 2500 5000 7500 10000 12500 15000 17500 20000 22500 25000 27500 29970 m Note that the signal is only corrected for power loss after the yellow cursor which is the t null point All values before t null are left unchanged and those after t null are corrected for the power loss due to distance The difference in the display is due to the fact that the scaling has been changed to a logarithmic scale for easier viewing Please remember that the Pr2 signal is always offset corrected as well usin
84. nection to the Licel Multispectral Lidar Detector 1 2 Reconnect the PC to the local network Open the Properties dialog of the network connection your ethernet adapter is assigned to A more detailed instruction has been given above Open the Properties dialog of the TCP IP protocol entry in the lists of components used by the assigned ethernet adapter card Reset your current TCP IP settings to the values you recorded while processing the subsection to establish a network connection 2 TCP IP Connection Parameters Internet Protocol TCP IP Properties General fou can get IF settings assigned automatically if your network supports this capability Othenvise You need to ask pour network administrator for the appropriate IP settings Obtain an IP address automatically Use the following IP address IF address 192 168 69 10 Subnet mask 255 755 255 0 Default gateway 152 168 69 254 Use the following DNS server addresses Preferred ONS server 192 168 69 1 Alternate ONS server Note that the values shown here are just example settings You must exactly use the settings present on your PC before configuring the Licel Multispectral Lidar Detector 5 Quit the dialog by pressing OK 6 Reboot your PC 7 Connect the Licel Multispectral Lidar Detector with your local network through a hub or switch using an ordinary patch cable 8 Execute a ping command from a command
85. nnel Sff nas Averaged amp vwy To start the program press the Run button at the top left of the screen 42 PMT32 Viewer The Windows application will start automatically when called for the first time A desired data file may be loaded by pressing the Open button A file selection dialog will appear At the program start this dialog will come up without pressing the button Look im Stem o H a m es 20361815 342 File name a0382413 532 Files of type al Files Cancel Select a valid data file press open and the dataset number specified by the dataset control will appear in the graph indicator 43 PMT32 Viewer Viewer Calibration Channel 5 MHz Photoncounting 355 00 Fava Dataset A3 1 10E 1 Cursors x qr q 1 006 1 E Enui Mode Photon Counting Photoncoun 276 0 00E 9 00E 2 E BJ Offset Start 8 00E 2 Photoncoun 24717 0 00E 3 JE Offset End TE Photoncoun 16590 0 00E 6 00E 2 Spectrum Start Photoncoun 7410 4 94E 3 5 00E 2 Spectrum End 4 00E 2 Photoncoun 1560 2 47E 2 3 00E 2 Background Offset 2 00E 2 1 00E 2 0 00E 0 O 2500 5000 7500 10000 12500 15000 17500 20000 22500 25000 27500 29970 m ES o amp Display Mode J Raw Offset Start Offset end 24870 16590 Bhae ajaj Path D data PMT32 a08C 1616 184619 iooni errou meta _seveas_ sove sinnte f Spectrum between the green Cu
86. ntrolled locally For usage with the PM32 detector controller set Device Number 0 97 Licel TCPIP Driver VIs TCPIP Ref In terre TCPIP Ref Out Device Number ES ha On Off error in no error HV Voltage kandi control state error out Licel TCPIP PMT Set Gain vi Sets the Gain Voltage for the PMT specified by the Device Number to the value specified by HV Voltage For usage with the PM32 detector controller set Device Number 0 TCPIP Ref In TCPIP Ref Out HV Voltage Device Number x dido error in no error 9 1 5 Network Security Licel TCPIP Login Secure Mode vi Send the LOGON command to work in secure mode Reads a string from TCPIP attempts to convert the string to 2 U32 numbers used to encrypt the password to 2 output U32 numbers using the Blowfish encryption algorithm These output numbers are converted to a hexadecimal string to be used in the LOGON command If the LOGON command fails the controller will close the connection without any notification TCPIP Ref In TCPIP Ref Out Connection Password EA aids aid error in no error Licel TCPIP Open Secure Mode vi Open a TCP IP connection to the Licel controller in secure mode The vi tries to open the initialization file LicelTCPIPini to read the values for the keys UseSecureMode and SecureModePWD from the secureMode section SecureMode UseSecureMode TRUE SecureModePWD ConnectMe lf the initialization file is found and UseS
87. o error l PMT32Channel ReadTemp vi Read the temperature in deg C from the PM32 detector controller Timeout TCPIP Ref In TCPIP Ref Qut Received String Temperature error out error in no error PMT32Channel ReadDieTemp vi Read the die temperature in deg C Timeout TCPIP Ref In TCPIP Ref Out Received String Temperature error out error in no error PMT32Channel Simulation vi Switch the trigger simulation on generate an internal trigger or off expect an external trigger Timeout TCPIP Ref In TCPIP Ref Out error out error in no error PMT32Channel Shutter vi Switch the the mechanical shutter if installed and supported Timeout TCPIP Ref In sn error in no error TCPIP Ref Out error out PMT32Channel Start vi Starts an acquisition of Shots shots at the PM32 detector lf TRANSMIT is true the acquired data will be returned without any further request for data 100 PM32 Detector Specific Vis lf PushSupport is true the PM32 detector will continuously transfer sequences of acquired data of Shots shots via the TCP IP data socket push socket Timeout TCPIP Ref In TCPIP Ref Out Shots error out error in no error E PMT32Channel Get Data vi Request data if QueryBefore TRUE Read data from the multispectral detector lf QueryBefore FALSE a subsequent acquisition must have been started with the TRANSMIT option Timeout TCPIP Ref In TCPIP Ref Out Data Width Shot
88. o many photoelectrons or amplified secondary electrons 6 Detector are created to be amplified by the individual dynode chain As soon as one dynode chain is saturated the electric field towards the next dynode will decrease and the neighboring dynodes will amplify these electrons In fig 1 7 a Square wave pulse saturating dynode chain 16 and 17 appears on all dynodes Increasing the light level even further leads to crosstalk effects on all dynodes at the beginning of the square wave pulse followed by a breakdown of the amplification chain This is demonstrated in fig 1 8 5 3 PMT32Channel Main version 1 07 04 TCPIP 2 44 rev 767 N M o W panza File Edit View Project Operate Tools Window Help O 2 PM Selector A 16 Spectrum between Cursors 100 Start Height m 13470 Range m 10770 Bins 1359 Mean Value 168 22 L L ia oO a o E 8 E l T a 5 3 E Cursors jy qu EJ stat 13470 0 025 1 1 1 1 1 1 1 HES 0 025 ae rane ea arg EDS USE E DER 0 5000 10000 15000 20000 25000 30000 G 0 2 160 ELENO ie 16 3B e OO a Range m ni Hal Range m fs i Channel Display Channels DO Index r Averaged Count al e eng Averaged Ep vty Figure 1 7 Display for a square wave pulse saturating dynode chain 16 and 17 appearing on all dynodes 7 13 PMT32Channel Main version 1 07 04 TCPIP 2 44 rev 767 aaa o Na no B File Edit View Project Operate Tools
89. ode Transmission Data Compression for more information on the different com pression techniques used Shown below is the diagram illustrating how the Channel Trace Data Is stored in memory with a Compression Factor of 2 68 Transmitted Data Format CH1RB1 CHORB1 Width BinSize parameter of the HW reply CH1RB2 CHORB2 TraceO CH1RB3 CHORB3 CH1RBN CHORBN CH3RB1 CH2RB1 CH3RB2 CH2RB2 Trace CH3RB3 CH2RB3 CH3RBN CH2RBN CH5RB1 CH4RB1 CH5RB2 CH4RB2 Trace2 CH5RB3 CH4RB3 CHSRBN CH4RBN CH31RB1 CH30RB1 CH31RB2 CH30RB2 Trace15 CH31RB3 CH30RB3 CH31RBN CH30RBN Figure PUSH Mode Channel Trace Data Memory Diagram with a Compression Factor of 2 69 PUSH Mode Transmission Data Compression Where CH x RB Y represents Channel x Rangebin y and CH x RB N represents Channel x Rangebin N where N is the number of rangebins 6 3 PUSH Mode Transmission Data Compression One of the key factors for the efficient transfer of data from the detector over the ethernet is to avoid transmitting redundant values e g appended 0 s Since the width of each rangebin in the transmitted data BinSize parameter of the Hw Command is fixed based on the number of shots to acquire and the current resolution setting there can be different number of redundant O s For small shot numbers the rangebins will have larger number of redundant 0 s as the summation value will be small However for larger
90. ommunication with the ethernet controller 4 1 Network Information The Licel Multispectral Lidar Detector is shipped with a default static IP address The default param eters are IP address 10 49 234 234 network mask 255 255 255 0 gateway port 2055 The network parameters should be aligned according to your local network environment Before doing this the system administrator should be contacted He should provide the following information 1 Should the ethernet controller use a dynamically assigned IP address DHCP a If yes the network parameters will be set by a DHCP server residing in your LAN Refer to the subsection DHCP Mode 4 3 2 to enable the Licel Multispectral Lidar Detector to automatically receive the network parameters from the DHCP server b If a static address configuration is to be used i the IP address li the network mask lil and the gateway should be set by yourself Refer to the subsection Fixed IP Address 4 3 1 2 The default ports used by the ethernet controller are 2055 and 2056 Can these ports be used 3 Is it necessary to change the configuration of any firewall in the case you need to access the controller outside of the LAN boundaries 21 Network Preparation 4 2 Network Preparation After having installed the Licel Windows applications or the Licel LabVIEW modules on your PC you are ready to change the network configuration parameters of the Licel Multispectral Lidar Detecto
91. ons a LabVIEW runtime environment needs to be installed The Windows applications together with the LabVIEW runtime environment come as a Windows Installer package For the installation of the LabVIEW runtime part of the installer package local administrator privileges are required The following items describe the installation process after starting the Windows Installer s setup routine setup exe The setup program is automatically started when using the CD ROM and pressing Install Applications in the setup selection dialog setup exe Is located on the Licel CD ROM in the subdirectory Installer or in the temporary directory you unzipped the downloaded Licel Installer package You may directly start the setup routine from the corresponding directories The Windows Installer dialogs will guide you through the installation process 1 The installation will start with the following screen Please wait until the installer has initialized Ik iz strongly recommended that vou exit all programs before running this installer Applications that run in the background such as virug scanning utilities might cause the installer to take longer than average to complete o A Please wait while the installer initializes Cancel 2 The next screen will allow you to choose the installation directory standard lt Program Files Directory gt Licel and specify the directory where former National Instruments products are installed The latte
92. ons is set the acquisition will stop automatically after the specified number of data files has been written Data Display The data is displayed on the two pages Multispectral Lidar and ROI Multispectral Lidar Two display indicators are available on the page Multispectral Lidar 1 Individual channel display left here the averaged count rate for an individual channel is displayed The channel is selected by the PM Selector 3 The channel selector as well as the scale settings are used for the channel display on the page ROI as well 2 Multidimensional Display right Furthermore the data is displayed either as a 3D Plot see above or a Contour Plot 30000 28000 26000 24000 22000 20000 __ 18000 15000 5 14000 12000 10000 8000 6000 4000 2000 For the Contour Plot three Color Scale options are available Linear Logarithmoc and Auto where all color regions represent the same number of counts ROI Two display indicators are available on the page ROI 1 Individual channel display left here the averaged count rate for an individual channel is displayed The channel is selected by the PM Selector Ssssar de The cursors are used to specify the integration region for the spectrum right The channel selector as well as the scale settings are used for the channel display on the page Multispectral Lidar as well 41 PMT32 Viewer 2 Spectrum between Cursors r
93. r according to the local network settings described in the previous section 4 2 1 Establish the Connection A straight forward way to do this is the following procedure You will need local administrator rights on your PC for the following steps 1 Disconnect the PC from the local network 2 Open the Properties dialog of the network connection your ethernet adapter is assigned to Usually you will find the appropriate network connection by opening Network Connections from the Windows start menu or the System Settings The following list shows the steps to follow on a Windows XP operating system a Click on the EEE button and then on Control Panel 53 My Computer xI MSN a My Network Places Windows Media Player 33 Windows Messenger i Tour Windows XP ta Printers and Faxes Files and Settings Transfer Help and Support Wizar E Search all Programs gt I Run Ea Log Off 0 Turn OFF Computer Control Panel e Set Program Access and Defaults b Once the control panel has come up click on Network and Internet Connections E Control Panel File Edit view Favorites Tools Help Back Ei pO search 1 Folders FEL E Control Panel E Pick Fa category g Switch to Classic View z e Appearance and Themes Printers and Other Hardware See Also Windows Update Fi 49 Help and Support ei Network and Internet Connections y User Accounts FA Add or Re
94. r a reset the controller has the default IP address the port number is reset to the default value the controller operates in its fixed IP address mode the password is reset to the default password 32 Chapter 5 Software Modules 5 1 Overview This chapter describes how to use the data acquisition software as well as the functions of the indi vidual controls and indicators In order to work through the information in this tutorial the hardware and network setup must be completed The next sections give brief introductions to the software module PMT32 Pulse Height Distribution PMT32 Channel Acquisition and PMT32 Viewer 5 2 PMT32 Pulse Height Distribution With the PMT32 Pulse Height Distribution utility you are able to acquire pulse height distributions for either all or selected channels of the Licel Multispectral Lidar Detector You can load the PMT32 Height Distribution utility by either double clicking on the PMT32Channel Pulse 11b or by selecting the virtual instrument PMT32Channel_Pulse vi in PMT32Channel Pulse 11b If you installed the Windows applications please start the program by selecting the entry PMT32 Pulse Height Distribution in the Licel section of the Windows Start menu After doing so you should see a screen similar to the one below 33 PMT32 Pulse Height Distribution File Edit view Project Operate Tools Window Help Da Pulse Distribution TCP IP Integral MHz 1 00 chs 0 75
95. r directory will be the root directory for the LabVIEW runtime engine Installing the Windows Applications CI PMT32 Channel Ac Destination Directory Select the primary installation directory All software will be installed in the following location s To install software into a different location s click the Browse button and select another directory Directory for PMT 32 Channel Acquisition Software C Program Files Licel Directory for National Instruments products C Program Files National Instruments If you would like to change one of these directories click Browse and choose or create a direc tory of your choice Click Next to proceed 3 As National Instrument s LabVIEW runtime engine has to be installed you are asked to accept a software license agreement for National Instruments software Plese check accept the license agreenment s and proceed by clicking Next 1 PMT32 Channel Acquisition Software License Agreement Tou must accept the license s displayed below to proceed NATIONAL INSTRUMENTS SOFTWARE LICENSE AGREEMENT gt INSTALLATION NOTICE THIS IS A CONTRACT BEFORE YOU DOWNLOAD THE SOFTWARE L AND OR COMPLETE THE INSTALLATION PROCESS CAREFULLY READ THIS AGREEMENT BY DOWNLOADING THE SOFTWARE AND OR CLICKING THE APPLICABLE BUTTON TO COMPLETE THE INSTALLATION PROCESS YOU CONSENT TO THE TERMS OF THIS AGREEMENT AND YOU AGREE TO BE BOUND BY THIS AGREEMENT IF YOU DO NOT WISH TO BECOME A
96. regularities in the time stamps of the transmitted data sets Please refer to the PUSH Data Time Stamps section of this chapter for more information 6 8 Client Side External Averaging of PUSH Data The following flowchart outlines the procedure for performing External Averaging by the client application 79 Client Side External Averaging of PUSH Data Incomming Dataset Q dataset Q dataset _4yth E Q 1 val Q dataset Flowchart External Averaging of PUSH Mode Data at the Client Application Incomming Dataset The continuous incoming data on the Push Socket Read PREAMBLE The size of the PUSH Data Preamble is 32 bytes The PREAMBLE must be read first and processed in order to determine the parameters needed to read the rest of the Channel 76 Client Side External Averaging of PUSH Data Trace Data If the received PREAMBLE has all its fields set to 0 except the Dataset Marker and the Acquired Shots then the received PREAMBLE is just shot status indicator and not the PREAMBLE for the Channel Trace Data This much be used only to update the shots acquired parameter at the client software Care must be taken to determine if a byteswap is necessary based on the Endianess Read Data The BinSize parameter from the Hw command reply along with the Compressed Traces and Trace Length parameters extracted from the PREAMBLE provides for all the param eters necessary to determine the size of the Channel Tr
97. reviated as SP 32 Controller refers to the Licel TCPIP Ethernet Controller present inside the SP32 and Client refers to the Data Acquisition Software running on the PC 6 1 1 SLAVE Mode In the SLAVE mode the detector always expects a command from the client in order to perform any kind of action and send a reply Hence in this mode detector is the SLAVE and the client is the MASTER The different commands accepted by the detector and its corresponding replies are listed inthe the TCP IP Command List and Syntax Inthe appendices chapter of this manual Please refer to the appendices for more information on the corresponding commands The typical steps involved for acquiring data from the detector in the SLAVE mode are Step 1 TCP IP Connection Open up a connection to the COMMAND Socket All the commu nication to the detector in the SLAVE mode takes place on the bi directional COMMAND Socket The COMMAND Socket Is by default on port 2055 Step 2 Hardware Information Once the connection to the detector is established the hard ware information of the detector must be read out in order to know the different capabilities of the detector This can be obtained by issuing the Hw command on the COMMAND Socket Step 3 Discriminator Level A suitable discriminator level must be set before start of data acquisition This can be done by issuing the DISC command on the COMMAND Socket Step 4 Highvoltage The detector
98. ription This function is used to reconstruct a 2 byte wide data trace from the received raw data Please Note This function assumes the client is a little endian system Licel SP UTIL Reconstruct SlaveMode 4Byte TraceData Syntax void Licel SP UTIL Reconstruct SlaveMode 4Byte TraceData unsigned char incomingdata long reconstructedtrace Spectro Preamble xsp preamble Spectro Hardware xsp hw 8 7 8 1 3 SP32 Detector C Drivers Description This function is used to reconstruct a 4 byte wide data trace from the received raw data Please Note This function assumes the client is a little endian system Licel SP UTIL Write AdvancedViewerData Syntax int Licel SP UTIL Write AdvancedViewerData Spectro Application sp app Spectro Measurement sp mes char filename timet tStartTime long int advanced viewer data Description This function is used to write the acquired data into a file in the Licel Advanced Viewer Data format licel_sp_tcpip This category implements low level TCPIP functions used to communicate with the SP32 controller All functions in this subsection have a common return type and return a positive number if successful On failure it either returns zero or a negative number Licel SP TCPIP Get HWConfig Syntax int Licel TCPIP GetSpectroHWConfig SOCKET s int xsphwRev double xspBinlen int spBins int xspNumBytes int spMaxShots int spMaxPushShots bool spBE bool xspPushMo
99. rsors Spectrum Start and Spectrum End HAW ns Averaged Countrate MHz Channel Display 5 J Wavelength 0 Wavelength nm zsa Tijg TET 1 I 1 I l l l TAURA 1 l 1 l l 1 l 324 340 350 360 370 380 390 400 410 420 430 440 450 460 470 480 490 500 510 eme Wavelength nm verage The channel index corresponding to the dataset read from the file is displayed top left Channel 5 The wavelength is displayed in the graph legend Photoncounting 355 00 ERR 1 and the units used for the y axis MHz is seen in the upper left hand corner of the graph MHz The discriminator level used during the acquisition is displayed Discr Level 3 Furthermore the bin resolution is given in meters Resolution 30 00 m and the number of range bins and the number of acquired shots are displayed Bins 1000 The full path to the current data file is shown in the path indicator 44 PMT32 Viewer Path 4 D data PMT32 a08C 1616 184619 lf you would like to see a different dataset spectral channel from the loaded file use the Dataset control to choose tt rl Dataset RD T il Below dataset 13 Channel 19 in our example is shown MHz Photoncounting 442 00 BA 1 10E 2 1 00E 2 Mode Photon Counting ee Discr Level 3 8 00 1 RE onte a 7 00E 1 Bins 1000 mee Ra 5 00E 1 4 00E 1 3 00E 1 Background Offset 2 00E 1 Display Mode Raw Offset Start Offset end ee ee pp a are a Bi rt ER a ot
100. s START executed Please Note If the START command is sent with a target shot number that is greater than the maximum shots it can acquire internally the controller acquires data until it reaches its maximum shot capability and stops External Averaging must be done to acquire a target shot number greater than the maximum internal shots acquirable Please refer to the section on Internal and External Data Averaging for more information on External Averaging STOP Stops the data acquisition of the detector The corresponding reply from the controller is STOP executed STATUS STAT Returns the current status of the controller The format of the reply is RUN AcqStatus ShotNum Shots of TargetShotNum Current Where AcgStatus is the acquisition status of the SP32 detector which can be either O Idle 1 Armed or 2 Acquiring ShotNum is the current shots number acquired Target Shot Num Is the target shots to acquire set by the START command and Current is the ADC value of the on board high voltage supply current sensor displayed as an integer An example reply would be Rum Ay 10 Shoes of 100 65555 TCPIP lt ip gt lt subnet mask gt lt Gateway gt lt Port gt lt Password gt TCP lt ip gt lt subnet mask gt lt Gateway gt lt Port gt lt Password gt Sets the IP address subnet mask gateway and ports that are used for TCP connections Please note tha
101. s error in no error Raw Data Endian error out QueryBefore H PMT32Channel HW Info vi Returns the hardware information about the PM32 detector controller Default values are used in the case that parameters are not available from the current PM32 detector controller The returned values are bundled into two clusters e Data Info Version current Binwidth ns MaxBins maximum number of bins to return GO N a DataWidth default 2 bytes MaxShots default 4096 Endian default big endian VariableTrace FALSE if not supported current Bins changeable if Variable Tryce TRUE otherwise Bins MaxBins MaxBinwidth ns Binwidth ns if VariableTrace FALSE otherwise Binwidth ns is changeable NOOO fF WDB e Pushinfo 1 PushSupport TRUE the controller is capable to transfer acquired data via the TCP IP data socket push socket FALSE if not supported 2 PushDataSize use if PushSupport TRUE 3 CompressionLevel use if PushSupport TRUE 4 VariableCompression use if PushSupport TRUE Timeout TCPIP Ref In TCPIP Ref Out error in no error Error out PushInfo 101 PM32 Detector Specific Vis PMT32Channel Push Parser vi Parse the pushed data stream for the data heder and the acquired data bytes Current Data Width Buffersize Buffer in Buffer out Endian Shots VariableCompression Data DataAvailable ShotHeaderAvailable CompressionLevel out Resy
102. s a reference to the start of the data set for further processing Acquired Shots 4 bytes unsigned int The Acquired Shots Is a 4 byte value used to denote the number of internally averaged shots present in the current data set This has to be equal to the target shot number of the START command Number of Traces 4 bytes unsigned int The Number of Traces is a 4 byte value used to denote the total number of traces present in the acquired data In the SLAVE mode each trace corresponds to a single channel of the detector Hence this is a fixed value of 32 Rangebins 4 bytes unsigned int The Rangebins Is a 4 byte value used to denote the total number of rangebins present in each trace of the data set This is equal to the RangeBins parameter of the Hw command reply Channel Trace Data The Channel Trace Data follows the Preamble Header In the SLAVE mode operation the detector transmits the Channel Trace Data without any form of compression The uncompressed data consists of a single trace for each channel of the SP32 detector Since the detector has 32 channels the data consists of 32 traces and each trace is as wide as the number of rangebins This can be represented as the following 2D array UNCOMPRESSED_DATA 32 no of rangebins Where the size in bytes of each element of the 2D array is as determined in the BinSize parameter of the HW command reply Shown below is the diagram illustrating how the acquired Channel Trace
103. s information in the application configuration file The default port number of 2055 is used to connect to the command socket After the connection is successfully established the application calls high level sequence functions present in the 1icel_sp category of the driver functions These sequence functions are called in the following order 90 SP32 Detector Sample Applications Licel SP SlaveMode Startup Seg e Licel SP SlaveMode Acquisition Seg e Licel SP SlaveMode DataRead Seg e Licel SP Write Data2File Seg e Licel SP Shutdown Seg The application closes the connection to the command socket after all the sequence functions are implemented The data file is written to the data folder which must be created by the user Please Note For this application to work the application configuration file must be stored in the same directory as the application executable and the data folder must be created in the output directory as specified in the application configuration file 8 2 2 Application Configuration File The sample applications provided make use of an ASCII based application configuration file called standard cfg This configuration file contains parameters the user can enter to interact with the application The parameters can be classified into two groups Application Measurement Parameters char 8 integer integer double double char char 80 char 20 Location of the experiment Altitude
104. s not checked uncheck it if necessary Click OK and check in the next dialog Apply changes to this folder subfolders and files Leave the dialog by clicking OK Confirm Attribute Changes You have chosen to make the Following attribute changes unset read only Do vou want bo apply this change to this Folder only or do you want to apply it to all subfolders and Files as well O Apply changes to this Folder only Apply changes to this Folder subfolders and files Cancel Now you should be able to run all the files If you are still having problems apply a mass compile to the directory where the software was extracted to 1 Start LabVIEW press on New VI 2 Select the menu Tools then Advanced and finally Mass Compile 19 Installing the Licel LabVIEW Libraries gt Untitled 2 File Edit Operate PERES Browse window Help Measurement amp Automation Explorer Instrumentation k YI Revision History Ctrl User Name YI Library Manager Edit WI Library Web Publishing Tool Advanced Options Profile VIs Export Strings Import Strings Import Actives Controls Actives Property Browser 3 You will be asked to select a directory select the target directory of the LabVIEW source files 4 Press Mass Compile in the next dialog if Mass Compile x i Mass Compile E x Options Status Options Status
105. shot numbers the rangebins will have a smaller number of redundant O s due to larger Summation values The current resolution setting also determines the number of redundant O s present in each rangebin If the detector has a very low resolution setting the number of photons detected in a single rangebin will be large and consequently the number of redundant 0 s in that range bin will be less as they hold a larger value The detector takes into account both these factors and implements a variable compression technique where it calculates the best compression factor and transmits the data using that compression factor Since the compression factor changes dynamically based on the number of shots to acquire and resolution setting the Data Compression Factor parameter is included in the Data Preamble Header The client must decompress the data based on this factor Please Note The graphical representations shown below explain how the data is acquired in the internal memory of the controller However it is very important to note that the order in which data is sent over the ethernet completely depends on the endianness of the controller If it is a Big Endian system the highest 8 bits most significant byte is first sent If it is a Little Endian system the lowest 8 bits least significant byte is first sent The endianness of the controller can be read from the Endianness parameter of the HW command Compression Factor 4 lf each range bin o
106. sneneneneneneen a EEA ona E pese E sea tios Mee Rlabsauilt o BEER ITED dee eos 10112 ou ul 1012 i TE i pose i TE 3 d i 3 k TE y E ii 3 em ER j 7 dos 5a gt ze i i T pz r a oe TEH pec JOJLUILULIDSIG ojupreg uojgeuuoui auempuey peal paseo aa ce ea rn Od ae SSAIPpY di Jaquunu joys 26123 e em 0007 ZE Er gt wog uoneonddy vst sjaja Ealen Le dpH mopu sjooT ajudo paloig maik p3 api Findo Ay fosdayyauuedze Nd uo wesbeig og waedu HSNd PUUEYIZELNA EF 64 Transmitted Data Format 6 2 Transmitted Data Format The transmitted data from the detector consists of two parts namely Preamble Header followed by the Channel Trace Data The Preamble Header contains information about the current data set necessary for the client to read the incoming Channel Trace Data Both these parts have different formats based on the mode of operation of the detector 6 2 1 SLAVE Mode Preamble Header The Preamble Header of the data set transmitted in the SLAVE mode has a fixed 16 bytes length Dataset Marker OxFFFFFFFF 4 bytes Acquired Shots 4 bytes Number of Traces 4 bytes Rangebins 4 bytes Figure Slave Mode Transmission Data Preamble Header Dataset Marker 4 bytes unsigned int The Data Marker Is a fixed 4 byte value used to denote the start of a data set The client must use the Data Marker of the Preamble Header a
107. t the port number port number 1 and port number 2 are used by the controller This command will only be executed if the password corresponds with the controller s internally stored password The defaults settings are IP Address 10 49 234 234 Subnet Mask 255 255 255 0 Gateway empty Port 2055 In this case the ports 2055 2056 and 2057 are used by default The Port 2055 is used for the bidirec tional communication with the controller and is called the COMMAND Socket The port 2056 is used for the unidirectional PUSH mode data transfer from the controller and is called the PUSH Socket In order to restore the default values the reset button needs to be pressed when powering up the controller hardware reset The default password is Administrator To change the password see the PASS command An example would be TCP ie COPAS ALTAR ODDS 2 2 TOOLS TAdMINLSCrACOr 83 CHAPTER 7 SP32 CONTROLLER TCPIP COMMAND LIST AND SYNTAX This will change the IP Address to 197 13 17 23 the subnet mask to 250 250 250 39 the gateway would be empty and the ports 2013 2014 and 2015 would be used The corresponding reply from the controller is LP bo ye loe ly e25 Subner 250 250 250 509 Gateway Y Port 20153 executed If the password is incorrect the reply is TCPIP failed due to invalid password TCPIP DHCP lt Port gt lt Password gt TCP DHCP lt Port gt lt Password gt Enable DHCP
108. te Now the intgrated high resolution spectrum is shown in the Calibration Lamp display z 0 000 Cut Wavelength Calibration Lamp c You may reset the intgration using the button Reset d The path of the loaded Line File is displayed below the graphics e You may save the intgrated line spectrum using the button Save and specifying a file name in a subsequent dialog 3 a Load the acquired spectrum to the calibration routine using the button Load on the left and choosing a file in a subsequent file dialog Load The acquired Multichannel Spectrum is displayed at the bottom left 91 Calibration Multichannel Spectrum Spectrum Es 16 gt 14 Ss EM I Averaged Countrate MHz oo b The path of the loaded Data File is displayed below the graphics c a further click on Integrate _Integrate will display the acquired spectrum together with the integrated line spec trum at the top right Combined l l E a l Si l l l ars l l Wavelength 4 The result of the current comparison of the integrated line spectrum with the acquired data is displayed in the corresponding indicators Mean Square Deviation 0 03411763 Minimum 0 03411763 Current Lambda Optimal Lambda Center 430 000 430 000 Current Delta 5 000 5 a Asearch will calculate the Mean Square Deviation after integrating the loaded line spec trum with all combinations of Lambda Center La
109. the last files including them are summed and written to a target file into the target directory The target file s name begins with the first letter and the rest of the name is taken from the first selected file By pressing Convert Datafile Batch Converter vi Is interactively called to convert the data contained in a set of subsequently recorded data files to ASCll files The selection mechanism to select the first file the last file and the target directory is the same as for the sum operation Both the first and the last file must reside in the same directory The data from the files with acquisition dates times lying between the first and the last files including them are converted as described above for the Save All operation Each data file will result in an ASCII file named by the original file name with the additional extension txt The Advanced Viewer Is terminated by pressing the Exit Program button 5 5 Calibration A calibration routine is included in the PMT32 Viewer to calibrate the Licel Multispectral Lidar Detec tor Please note that the calibration depends on the used spectrometer and especially on the grating inside Please open PMT32 Viewer as described above and switch to the tab page Calibration 49 Calibration Viewer Calibration A Calibration Lamp x 0 000 Cut Wavelength Lamp Fara Combined 5000 Load Lines 4500 Lambda Center 4000 2 r 420 000 E 350
110. the redundant 0 s and the 16 bits now contain the required information Since the SP32 detector has 32 channels the compressed data will now have 16 traces with each trace as wide as the number of rangebins It can be represented as the following 2D array COMPRESSED_DATA 16 no of rangebins Shown below is the graphical representation of 0 range bin of the 0 transmitted data trace 16 bits long for the above example 11 PUSH Data Time Stamps Rangebin 0 Rangebin 0 Channel 1 Channel 0 Where C 7 Cz9 denotes the corresponding Channel Trace bits and T 15 7 9 denotes the corre sponding Transmission Trace bits Please Note With reference to the above example if the controller is a Little Endian system then the bits To7 Too Rangebin O of Channel 0 is transmitted first followed by bits 715 7o3 Rangebin O of Channel 1 If the controller is a Big Endian system then bits 7o15 793 Rangebin O of Channel 1 is transmitted first followed by bits 77 7o9 Rangebin O of Channel 0 The decompression of the data on the client side must be done accordingly Example Let 0x5A9c be the the 2 bytes wide Rangebin O Transmission Trace O as shown in the graphical representation above If the system is Little Endian 0x9Cc is transmitted first since its the lowest byte followed by 0x5A The first byte received at the client 0x9C represents Channel O Rangebin O and the second byte received at the client 0x5A represents Channel 1 Ran
111. tinuous stream of 100 shots of data where each data set arrives at fixed intervals corresponding to the laser repetition rate 10 ms x 100 shots 1000 ms then it is recommended to operate the SP32 in the PUSH mode It 73 Internal and External Data Averaging is also recommended to use the PUSH mode in single shot applications or for applications that make use of the External Averaging mechanism The PUSH mode implements an optimized data transmission mechanism which works for both the single shot acquisition and for large shot numbers making the SP32 detector very flexible However due to these optimizations the processing of the data at the client application becomes much more complicated when compared to the SLAVE mode The number of range bins to acquire has to be tuned for applications where a continuous stream of data sets at regular intervals containing a fixed number of shots is expected If the number of range bins to acquire is very high then the data readout and transmission times are proportionally long Since the trigger is blocked during the data readout phase the detector will miss the next trigger if the readout time is too long In single shot applications where a continuous stream of single shot data sets are expected the trigger is blocked during both the read out and transmission phase The missing of triggers is more prominent in such applications as both the readout and transmission time contribute to blocking the trigger
112. tiple acquisitions including file storage The following list explains the functionality of the buttons and input fields related to acquiring data and saving it to files Start F1 starts a single acquisition with the number of Shots specified below The acquisition stops when the number of Shots has been reached or when the user presses Stop The number of acquired shots is displayed below All acquired data are displayed and the data corresponding to the Selected Channels for Saving are saved to a temporary Last File temp dat in the Working Directory specified before Stop F2 Stops a running acquisition Save F2 Saves the current temporary file to a file named according to the file name convention Multiple acquisitions are started with the Start button in the bottom section from the figure above Once a multiple acquisition has been started the label of the button changes to 40 PMT32 Channel Acquisition Stop and could be used to stop a running acquisition The data corresponding to a com pleted acquisition is written to a file in the Working Directory The file name is displayed in the Last File field The number of acquired shots and the number of completed acquisitions are displayed The program acquires data and writes files un til Stop is pressed Optionally a fixed number of acquisitions to acquire can be set by switching the Multiple unlimited field to FE o ue If a fixed number of acquisiti
113. tivity curve has been determined by illuminating the detector through a Newport MS125 spectrometer and varying the incident angle of the grating The measurement was taken at HV 900 V and a discriminator setting of 4 and 8 37 5 35 32 5 30 27 5 25 22 5 E count rate O disc 4 20 4 count rate O disc 8 17 5 1 2 2A KR A 7 R O1N11419121414151681718 10 9N 91 99 92 DADA OR 97 OQ 990 QBN 21 ND Figure 1 9 Individual sensitivity of the 32 cathode portions including their dynode chain Chapter 2 Hardware Installation The Licel Multispectral Lidar Detector consists of the following equipment N O OF A W N 2 1 power supply unit detector amp electronics housing mounting flange premounted at the detector amp electronics housing DC power cable Lemo 4 pole line cable Ethernet cross link cable trigger cable Lemo CAMAC to BNC coaxial Power Supply Unit The power supply cassette can be integrated to standard 19 form factor systems The line connector is located at the rear side The power switch the control LED and the DC output connector are on the front side DC LED Power Figure 2 1 Front left and rear sides of the power supply cassette Cable Connections 2 2 Detector amp Electronics Housing The detector amp electronics housing contains the 32 channel detector the 32 channel counter and the network interface On top the DC input connector 4 pole Lemo the network reset
114. to 1000 if supported by the hardware Start an acquisition with 1000 shots to acquire During the acquisition the number of shots and the acquisition status is displayed When the acquisition is finished the data is read and displayed At the end the VI will set the high voltage back to O V Close the TCP IP connection If an error occurs it will be shown in a standard dialog and on the front panel indicator These execution steps can be seen on the block diagram of the VI in the next figure 58 Data Acquisition Overview J PM SLAVE Template vi Block Diagram on PMT32Channelivproy My Computer DD 13 PMT32Channel SLAVE Template vi Block Diagram on PMT32Channel Computer File Edit View Project Operate Tools Window Help O 00 V 5 baT as 15pt Application Font v Ra tmx S TOO OCO COCO OCO CC ROO STRESS HW information Data Info Max Shots il p VariableTrace IP Address Labc Port Luie bendita miride error in no error error PushInfo Discriminator Dot Timeout etresolution set bins open TCP IP connection information PMT32Channel lvproj My Computer lt 4 Hr ds a HW information Data Info target shot number Shotnumber TCP IP ref e Error error out multiple shots wait until done read data close TCP IP connection his example uses 1000 shots 59 Data Acqu
115. transmitted first followed by bits 7o7 7o9 Rangebin O of Channel 1 and Channel 0 The decompression of the data on the client side must be done accordingly Example Let 0x9A8c be the the 2 bytes wide Rangebin O Transmission Trace O as shown in the graphical representation above If the system is Little Endian 0x8Cc is transmitted first since its the lowest byte followed by 0x9A The first byte received at the client 0x8c can be split as 0xc and 0x8 where 0xc represents Channel 0 Rangebin 0 and 0x8 represents Channel 1 Rangebin 0 The second byte received at the client 0x9A can be split as 0xA and 0x9 where 0xA represents Channel 2 Rangebin O and 0x9 represents Channel 3 Rangebin 0 If the system is Big Endian 0x9A is transmitted first since its the highest byte followed by 0x8c The first byte received at the client 0x9A can be split as 0xA and 0x9 where 0xA represents Channel 2 Rangebin O and 0x9 represents Channel 3 Rangebin 0 The second byte received at the client 0x8Cc can be split as 0xc and 0x8 where 0xC represents Channel O Rangebin O and 0x8 represents Channel 1 Rangebin 0 Compression Factor 2 If each range bin of the transmitted data is 2 bytes 16 bits long and and only 8 bits of that rangebin contains the needed information with the others being redundant 0 s then a compression factor of 2 is used This implies that two channels of trace data are compressed into one single trace while transmitting This gets rid of all
116. umed that an external trigger source is available For testing purposes or calibration with a continuous spectral lamp the controller is capable to generate an internal trigger signal The function is enabled by the Trigger switch Mechanical Shutter A Shutter switch is operable if an external mechanical shutter is supported by the controller The Live Mode PMT32 Channel Acquisiton will always start in the Live mode The Mode can be switched with the mode selector at the top in the middle of the Multispectral Lidar tab page Please refer to the screenshot above 39 PMT32 Channel Acquisition In the oscilloscope like Live mode an acquisition is started and the shot number is monitored and displayed in the Shotnumber field When the detector has acquired the desired number of shots Up date and is ready to be read out the data is read and displayed at the left side The only necessary action in the software to obtain a signal is to set a value for the High Voltage and switch on the high voltage on the right The Mode above is the current acquisition mode of the Licel Multispectral Lidar Detector If the Update is set to 1 the acquisition is started with the TRANSMIT option Data is immediately read from the Licel Multichannel Lidar Detector If no trigger is received in this mode this is indicated at the top The Acquisition Mode The Acquisition mode is intended for single acquisitions or a number of fixed or unlimited mul
117. urces the template VI PMT32Channel PUSH Template vi Is included lt is located in the LabVIEW LLB PMT32Channel 11b and may easily be opened from the delivered LabVIEW project 61 Data Acquisition Overview HS PMT32Channel PUSH T a a Ea e o o m el m i3pt Tahoma joie Search gis Er PUSH Mode Example 2 Select 3 Run the VI High Voltage and click on Arrow Discriminator High Voltage 400 500 600 300 al E 700 p dt 5 Wait until done Acquired data ist index rows 32 channels 2nd index columns 1000 bins Target Shots of of of of of of ofofo PMT32Channel lvproj My Computer 4 Flowchart Front Panel of the PMT32Channel SLAVE Template vi 62 Data Acquisition Overview To run the template VI 1 Select the IP Address and Port 2 Select the desired High Voltage and Discriminator level 3 Run the VI by clicking on the arrow icon The VI will then 1 Open a TCP IP connection command socket with the device at the given IP Address and Port only 1 attempt in the template VI 2 Read the hardware information and display it in the corresponding indicators 3 If the PUSH mode is not supported by the PM32 detector controller the program will terminate If the PUSH mode is supported the VI proceeds by executing the following operations in parallel on the COMMAND and PUSH Socket 10 11 12 13 COMMAND Socket Sending a STOP command to stop any data transfer
118. use the temporary buffers to reach its limit very quickly In such situations the subsequent datasets cannot be buffered and will over write the previous datasets in the internal memory of the detector When this data is finally transmitted the timestamp difference between two consecutive datasets will be twice the expected value because of the missing dataset that was overwritten For applications where the emphasis is on least possible shot loss it is strongly recommended to make full use of the internal shot averaging capability Internal data averaging ensures loss less 12 Efficient use of SP32 Detector for Data Acquisition acquisition of the required number of shots In applications where internal averaging capability of the detector is not sufficient and external averaging is necessary it is recommended to maximize the internal averaging and minimize the external averaging For more information on efficient use of the detector for acquisition please refer to the section on Efficient use of SP32 for Data Acquisition In this chapter For more information on internal and external averaging please refer to the section on Internal and External Data Averaging in this chapter 6 5 PUSH Mode Internal Shot Acquisition Status When the detector is operated in the PUSH mode the client effectively hands over the control to the detector The detector sends the data sets to the client on the PUSH socket once the acquisition is completed If the acquisit
119. vi by pressing the start button It should finish without opening an error message dialog 5 Turn the Licel Multispectral Lidar Detector off and switch it on again Wait approximately 20 30 seconds 6 Aping 10 49 234 234 executed from a command prompt DOS box should now time out 4 3 2 DHCP Mode In order to configure the Licel Multispectral Lidar Detector for DHCP operation carry out the following steps You must have skipped the steps described in the last subsection Fixed IP Address 1 Open Licel TCPIP Activate DHCP Mode vi or the corresponding Windows application from the Windows start menu 26 Reconfigure the PC Please enter the DHCP Port Run the vi Power OFF On the Licel Ethernet Controller Current IP Address 10 49 234 234 Current Port DHCP Port 2055 i2055 Aa Fa Password ep Set the desired DHCP Port number Do not forget to enter the administrator administrator Password Run the vi by pressing the start button It should finish without opening an error message dialog Turn the Licel Multispectral Lidar Detector off and switch it on again Wait approximately 20 30 seconds Aping 10 49 234 234 executed from a command prompt DOS box should now time out 4 4 Reconfigure the PC After you successfully configured the Licel Multispectral Lidar Detector the following last steps have to be carried out to reconfigure your PC for the local network and to test the con

Download Pdf Manuals

Related Search

Related Contents

SMC Networks SMC8014W-G User's Manual  Assembly-Instructions  Dodge 2004 DR Ram SRT-10 Automobile User Manual  Thank you for purchasing our product  Fiche technique FAST U1899  HH 1448 Standard - Hutchison Hayes  Electrolux ES510L User's Manual  livret_formations_IDF_2015-2016  

Copyright © All rights reserved. Failed to retrieve file