Newport Oriel MS260i Series User Manual Download Page 63

M74050 

1/4M IMAGING SPECTROGRAPHS 

63 

 

 

 

18.3  C# USERS 

 

This demonstrates how to call the DLL in C# .NET. 
Below the code is how to add a DLL Reference to a .NET project. 
 

Summary: 

 

1.  Add Code Reference to both the Cornerstone DLL and the CyUSB (Cypress) DLL 
2. 

In the Form Designer file  {Form.D} add the ‘using’ sections 

3.  {Form.D} Create new Cornerstone object 
4.  {Form.D} (optional)  

 
 

Changes to (Form Designer) file: 

 
 
//… 
using CyUSB; 
using CornerstoneDll; 
 
 
namespace CornerstoneApp 
 

    partial class MainForm 
    { 
        /// <summary> 
//…. 
 
        USBDeviceList usbDevices; 
 
        CyUSBDevice cornerstone; 
 
        Cornerstone cs = new Cornerstone(true); 
 
 
        Int32 deviceCount = 0; 
 
 
        public MainForm() 
 
        { 
            InitializeComponent(); 

// This is C# standard form init function 

 
            connect();  
 
            usbDevices.DeviceAt= new EventHandler(usbDevices_DeviceAttached); 
 
            usbDevices.DeviceR= new EventHandler(usbDevices_DeviceRemoved)       
        } 
 
  /// These two functions below handle dynamic USB plug and unplug events 
 
        void usbDevices_DeviceRemoved(object sender, EventArgs e) 
        { 
            USBEventArgs usbEvent = e as USBEventArgs; 

Summary of Contents for Oriel MS260i Series

Page 1: ...Family of Brands ILX Lightwave New Focus Ophir Corion Richardson Gratings Spectra Physics M74050 Rev B Oriel 1 4m Imaging Spectrograph Family User s Manual MS260i...

Page 2: ...GRATING EFFICIENCY AND BLAZING 22 6 3 POLARIZATION EFFECTS 25 7 SPECTROGRAPH RESOLUTION AND BANDPASS 26 7 1 DETERMINING RESOLUTION 27 8 GETTING LIGHT INTO A MONOCHROMATOR 29 8 1 ACCEPTANCE PYRAMID 29...

Page 3: ...REFERENCE 60 18 APPENDIX III USB DLL 62 18 1 GENERAL CONSIDERATIONS 62 18 2 LABVIEW USERS 62 18 3 C USERS 63 18 4 C USERS 66 19 APPENDIX IV GRATING PHYSICS TUTORIAL 67 19 1 THE GRATING EQUATION 67 19...

Page 4: ...ctrograph 29 Figure 20 Grating Correctly Filled with Light 29 Figure 21 Mismatched F Numbers Resulting in Stray Light 30 Figure 22 F Number Matcher Used with Fiber Optic Cable 30 Figure 23 Model 74010...

Page 5: ...fer to the complete User s Manual and all other documentation provided for additional important notes and cautionary statements regarding the use and operation of the system Do not attempt to operate...

Page 6: ...complying with all applicable European Union CE regulations and recommendations WEEE This symbol on the product or on its packaging indicates that this product must not be disposed of with regular wa...

Page 7: ...ibed in the manual Do not remove the cover for normal usage 1 3 ELECTRICAL HAZARDS Make all connections to or from the instrument with the power off This instrument requires DC voltage for operation w...

Page 8: ...am of dry clean air or nitrogen Wiping the grating surface will cause permanent damage Avoid getting any moisture or condensation onto the grating Do not breathe on or talk directly in front of a grat...

Page 9: ...ut requiring a computer This is especially beneficial in universities and secure facilities Please note that the utility software controls only the spectrograph and does not acquire data from the came...

Page 10: ...cumstances The spectral distribution of the source and the response of the detection system are often the dominant factors when determining a stray light value 2 3 AVAILABLE MODELS The model number of...

Page 11: ...ully packaged to minimize the possibility of damage during shipment Inspect the shipping box for external signs of damage or mishandling Inspect the contents for damage If any item is missing or damag...

Page 12: ...an arc lamp or quartz tungsten halogen light source This kit is compatible with Oriel s Research Lamp Housings that hold 50 to 250 watt lamps It includes a base plate a flexible light shield a 1 5 in...

Page 13: ...stions or concerns contact Oriel Instruments or the regional sales representative for Newport ELECTRICAL SHOCK Never attempt to open the lamp power supply or spectrograph power adapter These items do...

Page 14: ...B GPIB or USB RS232 converter cable the driver for the cable must be installed before communication to the spectrograph can be established This driver is available from the manufacturer of the cable F...

Page 15: ...ths In order to prevent saturation of a detection system it is suggested to close the shutter temporarily while changing gratings It is especially important to prevent saturation and possible damage w...

Page 16: ...increase throughput 5 1 FIXED SLIT HOLDER AND FIXED SLITS The fixed slits slide into the holders at the input and optional lateral output port The width and height cannot be adjusted but may be indivi...

Page 17: ...these locations line up the slit is fully closed Turning the dial clockwise advances the dial position further down on the shaft closer to the body of the micrometer This opens the slit Use a 10x mul...

Page 18: ...lution starting from the fully closed position will give a reading of 50 on the micrometer Using the multiplier this indicates the micrometer width is set to 500 um If unsure of the reading begin at t...

Page 19: ...t width the software may be configured to an automatic bandpass setting The software then adjusts the slit width to maintain the chosen bandpass as scans are performed using multiple gratings The math...

Page 20: ...roduced by Richardson Gratings Both Oriel Instruments and Richardson Gratings are part of the Newport family of brands and have a long history of working together to design spectrographs that are appr...

Page 21: ...eadings or ghosts Holographic gratings do not suffer from ghosts so interpretation of line spectra is simplified The signal to noise ratio SNR is the ratio of diffracted energy to unwanted light energ...

Page 22: ...grating depends on the specific application Often the desired instrumental efficiency is linear that is the intensity of light transformed into signal at the image plane must be constant across the sp...

Page 23: ...M74050 1 4M IMAGING SPECTROGRAPHS 23 Figure 16 Grating Efficiency Curves High Resolution and Holographic Models...

Page 24: ...M74050 1 4M IMAGING SPECTROGRAPHS 24 Figure 17 Grating Efficiency Curves Extended Range and Wide Bandpass Models...

Page 25: ...optics where the plane of incidence rather than the grooves are used to define parallel and perpendicular The graphs for the MS260i configurations have one efficiency curve per grating This is repres...

Page 26: ...trograph mechanism can only tilt the grating through a limited range of angles The angle and groove density determine the transmitted wavelength The gratings can be tilted to 0 degrees so the lowest p...

Page 27: ...service technician Unless otherwise stated the values shown are for a 1024 array with 26 x 26 um pixels For 200 um high pixels 2048 element array the resolution is half this value All gratings used i...

Page 28: ...rule a grating with 1200 lines mm will have half the resolution value of a 600 line mm grating Please note that this equation is valid at the blaze wavelength of the grating and does not take into acc...

Page 29: ...n described by an F The position and dimensions of the internal optics determines the pyramid The optical equivalent is a grating image located behind the slit as shown in below Only light that passes...

Page 30: ...increases and throughput of desired signal suffers To illustrate this concept the photos below show a fiber optic cable placed at the entrance of a spectrograph Fibers are typically F 2 The Oriel mod...

Page 31: ...ingful spectral measurements care should be taken to remove unwanted orders of radiation particularly if the input radiation is intense or the detector more sensitive at the higher order The examples...

Page 32: ...fraction The filter wheel may be mounted to the male flange of the spectrograph slit or slit holder The filters are mounted external to the spectrograph Thus the refractive index and thickness of the...

Page 33: ...M74050 1 4M IMAGING SPECTROGRAPHS 33 Figure 244 Model USFW 100 Filter Wheel...

Page 34: ...optional motorized filter wheel The MonoTerm software provided with the spectrograph includes USB drivers for Windows 7 32 bit and 64 bit operating systems The software can also control the instrument...

Page 35: ...s a concern such as defense facilities and universities There is no need to memorize commands or key sequences The 24 keys are clearly labeled with functions like Shutter Go Wave and Filter The displa...

Page 36: ...ion and processing occurs in real time TracQ Basic is an application integrating Oriel spectrographs with various detection instruments such as the Newport Optical Power and Energy Meters 1918 R 1936...

Page 37: ...r those users who are developing their own LabVIEW based programs an Application Programming Interface API document is included with the instrument The Oriel MonoTERM utility is also provided for send...

Page 38: ...he operating range of the grating Oriel offers a number of pencil calibration lamps for this purpose such as the model 6035 Hg lamp Another line source such as a laser may also be used Always be sure...

Page 39: ...EP command to move the grating position until the first spectral line is visible at the output 7 Note the wavelength at which this first spectral line peak appears 8 Use the STEP command to move the g...

Page 40: ...d be held in place using a free hand by grasping or pressing down on the remaining grating holder s 8 Carefully uncover the new grating to be installed and set aside 9 Use the cover from the new grati...

Page 41: ...M74050 1 4M IMAGING SPECTROGRAPHS 41 Figure 299 Grating Platform Without Gratings Figure 30 Grating Platform With Three Gratings Installed...

Page 42: ...tion parameters which are stored in a file on the memory stick shipped with the instrument If these parameters were corrupted from possibly performing an incorrect field calibration they will need to...

Page 43: ...instrument is turned on This may be due to a sudden power outage inadvertently toggling the power switch very rapidly or entering an incorrect calibration value most often a decimal point error To cor...

Page 44: ...dual port models External Shutter Control BNC connector normally closed TTL low or short opens shutter Shutter minimum exposure time 0 2 s Shutter maximum repetition rate 0 5 Hz Motorized Filter Whee...

Page 45: ...ons Width Range 6 m to 2 mm in 6 m increments Height 15 mm Repeatability 5 m Accuracy 10 m Micrometer Adjustable Slit Specifications Width Range 4 m to 3 mm Height 3 mm to 12 mm Repeatability 10 m Acc...

Page 46: ...M74050 1 4M IMAGING SPECTROGRAPHS 46 14 DIMENSIONS Figure 33 MS260i Dimensions...

Page 47: ...M74050 1 4M IMAGING SPECTROGRAPHS 47 Figure 344 Micrometer Adjustable Slit Dimensions Figure 35 Model 74104 Mounting Kit...

Page 48: ...Rev A for the full model numbers Year mark affixed 2015 Type of Equipment Electrical equipment for measurement control and laboratory use in industrial locations Manufacturer Newport Corporation 1791...

Page 49: ...nt two types of Statements are used Commands and Queries A Command causes some physical action or sets an internal parameter A Query asks a question of the instrument and automatically returns a Respo...

Page 50: ...e status byte i e status byte not equal to 0 Moreover the status byte must be explicitly read It is not returned after general Statements Correct Statements are handled as follows Commands Under RS 23...

Page 51: ...byte i e status byte 0 This status byte will be reported immediately if it contains an error otherwise the status byte 00 will be returned upon completion of the Statement Correct Statements are handl...

Page 52: ...FT LABEL GRAT1LINES XXXX GRAT1LINES LINES GRAT1OFFSET XXX XXX GRAT1OFFSET GRAT1ZERO XXX XXX GRAT1ZERO GRAT2FACTOR XXX XXX GRAT2FACTOR GRAT2LABEL TTTTTTTT GRAT2LABEL SHIFT LABEL GRAT2LINES XXXX GRAT2LI...

Page 53: ...ng point number or an integer i e GOWAVE 500 00 lf and GOWAVE 500 lf will be understood the same way For each grating there is a maximum possible wavelength approximately 1400 nm for a 1200 line mm gr...

Page 54: ...ed label for the grating 3 to the 9 character string parameter TTTTTTTT The parameter can letters or numbers This label is for informational purposes only Oriel uses these labels to indicate blaze wav...

Page 55: ...d in XXX XXX Warning this value is used to calculate wavelength motion Offset is usually changed only when installing a new grating and in that case the parameter should match the value provided by Or...

Page 56: ...result in a status byte error indicating a bad command not a bad parameter The value of TTTTTTTT can be letters or numbers This label is for informational purposes only SLIT1MICRONS XXXX SLIT1MICRONS...

Page 57: ...andard Mode The response to the query HANDSHAKE is the single integer describing the current mode 0 or 1 STB Use this query to check for MS260i error conditions The response will be 32 when an error o...

Page 58: ...check the code for that particular error using the query ERROR Please note that reading the Status Byte and the Error Code resets them back to 0 Errors may be checked for immediately in Handshake Mode...

Page 59: ...ey to activate communications through the Hand Controller Please note that if the Hand Controller is active the display is lit and information fills the screen you cannot command the MS260i via either...

Page 60: ...r the desired wavelength and finally press ENTER to execute the move SLIT 1 This key initiates the motorized slit located at the axial port This opens the desired slit width measured in micrometers Pr...

Page 61: ...the port press this key Followed by either 1 or 2 and then press ENTER The number 1 corresponds to the axial port and the number 2 corresponds to the lateral output port FILTER Move the Filter Wheel a...

Page 62: ...stone monochromator is referenced throughout this set of examples They can also be applied to the MS260i 18 1 GENERAL CONSIDERATIONS Before using any of these programming examples the MS260i must be s...

Page 63: ...file using CyUSB using CornerstoneDll namespace CornerstoneApp partial class MainForm summary USBDeviceList usbDevices CyUSBDevice cornerstone Cornerstone cs new Cornerstone true Int32 deviceCount 0...

Page 64: ...file code namespace CornerstoneApp public partial class MainForm Form public Int32 nActiveUnit 1 Used only for multiple devices default below private void btnSend_Click object sender EventArgs e cs se...

Page 65: ...IMAGING SPECTROGRAPHS 65 cs setActiveDevice nActiveUnit private void btnResponse2_Click object sender EventArgs e cs setActiveDevice cs usbDevices Count txtInfo Text cs getResponse cs setActiveDevice...

Page 66: ...rCommand Functions Defined in class char GetLibraryVersion void INT32 Send const char strCommand INT32 Read LPSTR strReturn INT32 Query const char strCommand char strReturn Sample Query code void OnBt...

Page 67: ...nt grooves at angle I to the grating normal are shown Consider light at angle D to the grating normal this light originates from the A and B rays as they strike the grating The path difference between...

Page 68: ...it slit fix the output direction Only wavelengths that satisfy the grating equation pass through the exit slit The remainder of the light is scattered and absorbed inside the spectrograph As the grati...

Page 69: ...d order are zero and the light is simply being reflected If the grating angle is positive then the order is positive m 1 if the grating angle is negative then the order is negative m 1 The half angle...

Page 70: ...f the grating Normally the smallest slit available and optical aberrations rather than the grating determine the attainable resolution As an example a spectrograph in this case Oriel s MS257 model is...

Page 71: ...worldwide Every year the Newport Resource catalog is hailed as the premier sourcebook for those in need of advanced technology products and services It is available by mail request or through Newport...

Page 72: ...tion RMA number must be obtained prior to shipment to Newport This RMA number must appear on both the shipping container and the package documents Return the product to Newport freight prepaid clearly...

Page 73: ...r s expense to Newport s facility provided that Buyer notifies Newport in writing promptly after discovery of the defect or nonconformity and within the Warranty Period Products may only be returned b...

Page 74: ...of Newport and are for use only in the manner expressly permitted Newport claims and reserves all rights and benefits afforded under law in the Programs provided by Newport Corporation Newport shall r...

Reviews: