Home

AS-5216-DLL - Pembroke Instruments

1. Return code Value Description compatible with the Averaging function ERR INVALID MEASPARAM AVG RAM 111 Use of Averaging is not compatible with the StoreToRam function ERR INVALID MEASPARAM SYNC RAM 112 Use of the Synchronize setting is not compatible with the StoreToRam function ERR INVALID MEASPARAM LEVEL RAM 113 Use of Level Triggering 1s not compatible with the StoreToRam function ERR INVALID MEASPARAM SAT2 RAM 114 Use of Saturation Detection Level 2 Parameter is not compatible with the StoreToRam function ERR INVALID MEASPARAM FWVER RAM 115 The StoreToRam function is only supported with firmware version 0 20 0 0 or later Oct 07 AS 5216 DLL Manual doc 39 Avantes website http www avantes com email Info avantes com 2 4 2 cy ntes The following table gives an overview of window messages Windows messages Windows message WPARM LPARM Description identifier WM MEAS READY 0 on success device after measurement data 0 one of the above error reasons handle is available the DLL gt 0 in StoreTORAM mode Betids this ee to the application The command value used is WM MEAS READY and is defined as WM USER 1 WM DEVICECHANGE DBT DEVNODES CHANGED 7 0 After device attachment removal Windows sends this message to the application 40 Avantes AS 5216 DLL Manual doc website http www avantes com Oct 07 email Info av
2. m_aNLCorrect 0 9 93286529334744E 001 m aNLCorrect 1 7 18891352982627E 006 m_aNLCorrect 2 4 65464905353804E 009 m_aNLCorrect 3 1 11258994803382E 012 m_aNLCorrect 4 1 42157972847117E 016 m_aNLCorrect 5 1 03925487491128E 020 m_aNLCorrect 6 4 02566735990250E 025 m_aNLCorrect 7 6 44850644473040E 030 m_aLowNLCounts 200 0 m_aHighNLCounts 15500 0 Oct 07 AS 5216 DLL Manual doc 51 Avantes website http www avantes com email Info avantes com cy ntes The polynomial is calculated by measuring the AD Counts for a number of pixels 10 over different integration times to get the pixel data over a wide range from in this example 200 to 15500 counts The measured AD Counts are corrected for the offset value by subtracting the dark spectrum For each of the 10 pixels in the measurement the counts per second is calculated and normalized to its maximum value which is set to 100 In the left figure below the normalized counts per second are displayed against the measured AD Counts corrected for dark The polynomial is the best fit through these measured points The right figure below has been created by applying the polynomial to the measured points and recalculating the normalized counts per second It is important to realize that the polynomial should be applied to the AD Counts that have been corrected for the dark counts 995 a o 990 D 985 e 98 0 97 5 E 2
3. Blocking read function Deletes a file from the SD card a hDevice device identifier returned by AVS_ Activate a pName file name 14 characters including terminating zero On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or no more files on the SD card 2 3 24 AVS GetFirstDirectory Function Group Description Parameters Return int AVS GetFirstDirectory AvsHandle a hDevice unsigned char a pName Blocking read function Returns the name of the directory in the root directory of the SD card a hDevice device identifier returned by AVS Activate 1 for first active device a pName directory name 14 characters including terminating zero On success ERR SUCCESS a pName buffer contains valid info On error ERR DEVICE NOT FOUND communication not open yet ERR INVALID DEVICE ID device handle is not known in DLL ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or no directory found on the SD card 2 3 25 AVS GetNextDirectory Function Group Description Parameters Oct 07 Avantes int AVS GetNextDirectory AvsHandle a hDevice unsigned char a pPrevName unsigned char a pNextName Blocking read function Returns the name of the next directory in the root directory after a pPrevName a hDevice device identifier returned by AVS_ Activat
4. AvsHandle a hDevice char a aFileRootName 6 Blocking data send function Sets current working directory All file functions will act on this directory a hDevice device identifier returned by AVS Activate 1 for first active device a aFileRootName string that sets the current working directory for all file based functions On success ERR SUCCESS On error ERR DEVICE NOT FOUND communication not open yet ERR INVALID DEVICE ID device handle is not known in DLL ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com cy ntes 2 3 28 AVS SaveSpectraToSDCard Function Group Description Parameters Return Oct 07 Avantes int AVS SaveSpectraToSDCard AvsHandle bool unsigned char char TimeStampType a hDevice a Enable a SpectrumType a aFileRootName 6 a TimeStamp Blocking data send function Enables disables writing spectra to file 1f disabled the other parameters are neglected a hDevice a Enable a SpectrumType a aFileRootName 6 a TimeStamp On success On error device identifier returned by AVS_ Activate enable disable storage of spectra to SD card 0 Dark Spectrum 1 Reference Spectrum 2 Normal Spectrum The spectrumtype determines the file extension drk ref or roh string that 1s used as first part of the name of the stored spectra f
5. Oct 07 AS 5216 DLL Manual doc 11 Avantes website http www avantes com email Info avantes com cy ntes 4 Laser Delay The 1 3 us period between receiving a trigger measurement request in software trigger mode or TTL pulse in hardware trigger mode can be delayed from 1 3ps to 89 sec 21ns steps 1 5 4 USB2 platform specific functions The functions that have been added to as5216 dll to support the new hardware features in the USB2 platform spectrometers can be grouped into the following categories e Analog IO e Digital IO and Pulse Width Modulation e SDCard support e Eeprom IO 1 Analog IO The USB2 platform spectrometers have 2 programmable analog output pins and 2 programmable analog input pins available at the DB26 connector The functions AVS SetAnalogOut and AVS GetAnaloglIn can be used to control these ports Moreover a number of onboard analog signals can be retrieved with the AVS_GetAnalogIn function One of these onboard signals is an NTC thermistor which can be used for onboard temperature measurements 2 Digital IO and Pulse Width Modulation The USB2 platform spectrometers have 10 programmable digital output pins and 3 programmable input pins available at the DB26 connector The function AVS SetDigOut and AVS_GetDigIn can be used to control these ports Moreover 6 out of the 10 programmable ouput ports can be configured for pulse width modulation With the AVS SetPwmoOut function a frequency and duty cycle ca
6. 18 Avantes int AVS GetScopeData AvsHandle a hDevice unsigned int a pTimeLabel double a pSpectrum Internal data read function Returns the pixel values of the last performed measurement Should be called by the application after the notification on AVS Measure is triggered The DLL does not check the allocated buffer size AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com Parameters Return cy ntes a hDevice device identifier returned by AVS_ Activate a pTimeLabel ticks count last pixel of spectrum is received by microcontroller ticks in 10 p S units since spectrometer started a pSpectrum array of doubles size equal to the selected pixelrange On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID MEAS DATA no measurement data received 2 3 15 AVS GetSaturatedPixels Function Group Description Parameters Return int AVS GetSaturatedPixels AvsHandle a hDevice unsigned char a pSaturated Internal data read function Returns for each pixel if that pixel was saturated 1 or not 0 a hDevice device identifier returned by AVS_ Activate a pSaturated array of chars each char indicates if saturation occurred for corresponding pixel size equal to the selected pixelrange On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID MEAS DATA no measurement data recei
7. 5 Measurement parameters There are a lot of parameters involved that determine the result of a scan such as integration time number of averages smoothing pixelselection dark correction etc In the as161 dll a lot of different functions are used to set these parameters integration time and averaging are setin AVS Measure smoothing in AVS SetSmoothing Pixelselection in AVS SetPixelSelection etc The as5216 dll uses a measurement structure which includes all measurement parameters and uses only one function AVS PrepareMeasure to send these parameters to the spectrometer 10 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 6 External Trigger The only setting in the as161 dll for external trigger functionality 1s to switch this mode on or off by calling the function AVS SetExternalTrigger In external trigger mode the USBI platform spectrometer will start one single scan on the rising edge of the TTL pulse that is sent to the external trigger input port of the spectrometer In the as5216 dll the USB2 platform spectrometer can be set into external trigger mode by setting the trigger mode parameter into hardware trigger mode If the trigger type parameter is set to EDGE the number of measurements to perform after receiving one TTL pulse can be specified by setting the nrms parameter in the AVS Measure function If the trigger type parameter is set to LEVEL the spectrom
8. 5 0V On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER 2 3 31 AVS SetDigOut Function 26 Avantes int AVS SetDigOut AvsHandle a hDevice unsigned char a PortlId unsigned char a Value AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com Group Description Parameters Return cy ntes Blocking data send function Sets the digital output value for the specified digital output a hDevice a PortId a Value On success On error 2 3 32 AVS SetPwmOut Function Group Description Parameters Return Oct 07 Avantes device identifier returned by AVS_ Activate identifier for one of the 10 output signals 0 DOI pin 11 at 26 pins connector 1 DO2 pin 2 at 26 pins connector 2 DO3 pin 20 at 26 pins connector 3 DO4 pin 12 at 26 pins connector 4 DOS pin 3 at 26 pins connector 5 DO6 pin 21 at 26 pins connector 6 DO7 pin 13 at 26 pins connector 7 DOS pin 4 at 26 pins connector 8 DOO pin 22 at 26 pins connector 9 DO10 pin 25 at 26 pins connector value to be set 0 1 ERR SUCCESS ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER int AVS SetPwmOut AvsHandle unsigned char unsigned long unsigned char a hDevice a PortlId a Frequency a Dut
9. Returns the name of the first file in the root directory of the SD card a hDevice device identifier returned by AVS_ Activate a pName file name 14 characters including terminating zero On success ERR SUCCESS buffer contains valid value On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or file not found 2 3 22 AVS GetNextFile Function Group Description Parameters Return 22 Avantes int AVS GetNextFile AvsHandle a hDevice unsigned char a pPrevName unsigned char a pNextName Blocking read function Returns the name of the next file in root directory after a pPrevName a hDevice device identifier returned by AVS_ Activate a pPrevName file name 14 characters including terminating zero this is the name returned by AVS GetFirstFile or by the previous call to AVS GetNextFile a pNextName file name 14 characters including terminating zero On success ERR SUCCESS buffer contains valid value On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or no more files on the SD card AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com cy ntes 2 3 23 AVS DeleteFile Function Group Description Parameters Return int AVS DeleteFile AvsHandle a hDevice unsigned char a pName
10. by the DLL and necessary for the application interface are given below Note To match the structures that are used in the AS5216 firmware the structures mentioned here have to be compiled with byte alignment Table 1 API data elements Type Format Value Range Description bool 8 bits value 0 1 false true char 8 bits value 128 lt x lt 127 signed character unsigned char 8 bits value 0 lt x lt 255 unsigned character short 16 bits value 32768 lt x lt 32767 signed integer unsigned short 16 bits value 0 lt x lt 65535 unsigned integer int 32 bits value 2 147 483 648 lt x lt signed integer 2 147 483 647 unsigned int 32 bits value 0 lt x lt 4294967295 unsigned integer float 32 bits value floating point number 7 digits precision double 64 bits value double sized floating point number 15 digits precision HWND 32 bits value Windows typedef for window identification HWND is used for Windows API calls that require a Window handle Avsldentity struct Type char m aSerialld 10 serial identification number char m_aUserFriendlyld 64 user friendly name to be defined by application DeviceStatus m_Status device status Oct 07 AS 5216 DLL Manual doc 31 Avantes website http www avantes com email Info avantes com cy ntes Type Format Value Range Description ControlSettings struct Type unsigned short m StrobeControl 0 OxFF
11. eee in DI A 7 2 Diz Get Digital Inputs pin18 DI3 Close 3 5 Analog IO The USB2 platform spectrometers have 2 o xi programmable analog output pins and 2 programmable Analog Output analog input pins available at the DB26 connector The p functions AVS SetAnalogOut and AVS GetAnalogIn d Set Analog Out can be used to control these ports For the Analog Out paene signals an 8 bit DAC is used The Analog In signals are converted by the internal 10 bit ADC s A number of onboard analog signals can be retrieved Analog Input SUBD26 F connector as well with the AVS GetAnaloglIn function One of o 8 8 AH these onboard signals is the NTC1 X8 thermistor which WEE p _GetAnalogin Aneea In can be used for onboard temperature measurements The polynomial for converting the voltage U to degrees Celsius for NTC1 is Onboard Analog Input thermistor X11 5 00 Temp C 118 69 70 361 U 21 02 U 3 6443 U 0 1993 U WA 5VUSB The thermistor X11 is the signal received from the Co B cooled NIR detector and can be used to monitor the 5 detector temperature NTC2 X9 is not mounted ee E The 1V2 5VIO and 5VUSB are used internally to test the power supply Oct 07 AS 5216 DLL Manual doc 49 Avantes website http www avantes com email Info avantes com cy ntes The EEProm parameters in the DeviceConfigType structure have been briefly described in sect
12. has been loaded The number of pixels is determined by the detectortype and should therefore not be changed unless another detectortype has been connected and the right FPGA code has been loaded Wavelength Calibration The polynomial coefficients in m aFit 5 describe the relation between the pixelnumber of the detector array 0 m NrPixels 1 and the corresponding wavelength in nanometer at this pixelnumber m aFit 0 m aFit 1 pixnr m aFit 2 pixnr m aFit 3 pixnr m aFit 4 pixnr x E P In the function AVS_GetLambda the m aFit coefficients are used internally to store the wavelength numbers into an array Nonlinearity Calibration and Correction A polynomial can be used to correct for nonlinear behavior of the detector The polynomial coefficients can be stored in the EEProm and used by the application software to correct the raw AD Counts The nonlinearity calibration service determination of the polynomial coefficients is included in the IRRAD CAL irradiance calibration service but can also be ordered separately NL Calibration New in version 1 1 of the as5216 dll are the m aLowNL Counts and m aHighNL Counts parameters These have been added to be able to limit the range in counts for which the correction polynomial should be applied The correction that needs to be implemented in the application software can be illustrated by using an example Suppose the following nonlinearity polynomial has been calculated
13. has been received at at pin 6 of the Master DB26 connector The nrms parameter in the AVS Measure function should be set to the same value for all activated channels Synchronization is done at a measurement level A measurement can include a number of scans to average This number of average scans is only synchronized for the first scan For example if the number of measurements integration time and number of average for two channels are set to Channel A nrms 2 integration time 100ms average 3 Channel B nrms 2 integration time 65ms average 2 then the data acquisition timing and response in synchronized mode will look like Idle time channel B Idle time channel B Measurement Measurement Request Result channel A Channel A Measurement 2 easurement ChannelB Result channel B Synchronized Result channel B Measurement Start n 2 Measurement Result channel A All nrms 72 ready Note that in the example above the number of averages for channel B can be set to 4 without losing time because the extra two scans will be taken in the idle time for channel B 46 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 3 2 9 Measurement structure Control Settings Control Settings Flashes per Scan 0 Laser delay jo a 0 omo Laser width ns Laser wavelength 0 000 n Spectra stored to RAM E qooo m The Control Settings include parameters
14. section section 2 4 1 The Lparam value of the message contains the devicehandle for the spectrometer for which the data is ready LabVIEW cannot easily respond to the incoming Windows message that signals the arrival of new data AVS Pollscan allows the application program to poll the arrival of data i e to actively get the status of this data instead of letting a message handler react to the Windows message from the dll By calling the function AVS GetScopeData the spectral data is stored in the application for further processing 48 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 3 4 Digital IO The USB2 platform spectrometers have 10 Test Digital 10 olx programmable digital output pins and 3 Digital Outputs programmable input pins available at the DB26 a BN A m ieaanc peer a connector The function AVS SetDigOut and W2 roo Cen E li AVS GetDiglIn can be used to control these pin20 moos PwM 5 ports Moreover 6 out of the 10 programmable pn12 7 poa ouput ports can be configured for pulse width pn3 Dos PWM 5S po modulation With the AVS_SetPwmOut function pn2i ooe PwM feo a frequency and duty cycle can be programmed n13 f ip T PWwM fo for these 6 digital output ports co UM The PWM functionality can be used e g in Sa oe controlling the intensity dutycycle of an ood AvaLight LED lightsource which receives input from DOI pin 11 of the DB26 connector
15. setpoint in degrees Celsius is 20 C but it can be changed if needed It is not recommended to change the DAC polynomial m aFit which has been optimized for the AvaSpec 256 NIR2 2 To monitor the detector temperature of the AvaSpec 256 NIR2 2 use the AVS GetAnaloglIn function with a AnalogInld set to 0 see also section 2 3 16 and 3 5 The polynomial for converting the voltage U to degrees Celsius for the thermistor is Temp C 58 70 20 48 U The thermistor coefficients are stored in m_Temperature 2 see section 3 6 4 56 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 3 6 6 EEProm structure ProcessControl The settings in the ProcessControl structure can be used for the 2 analog and 10 digital output signals at the DB26 connector The analog settings can be used to store a function output range that should correspond to the 0 5V range of the analog output signals For example if the measured function output is expected to be in a range between 1000 and 2000 these values can be stored in the m AnalogLow 0 and m AnalogHigh 0 parameters The function output can then be converted to a 0 5V analog output at pin 17 by using the range stored in eeprom The digital output settings can be used as lower and upper thresholds to set the corresponding pins to 0 or 5V if these thresholds are exceeded The Process Control structure has been successfully used in appli
16. to control e A pulsed lightsource m_StrobeControl A laser pulse m LaserDelay and m LaserWidth The Number of Spectra that will be stored to onboard RAM m StoreToRam Pulsed lightsource control A pulsed lightsource like the AvaLight XE needs to be synchronized with the integration time cycle The m StrobeControl parameter determines the number of pulses the spectrometer sends out at pin 5 at the DB26 connector during one integration time cycle The maximum frequency at which the AvaLight XE operates is 100 Hz This means that the minimum integration time for 1 pulse per scan is 10 ms When setting the number of pulses e g to 3 the minimum integration time should be 30 ms The as5216 dll does not check for this limitation because other light sources may operate at higher frequencies and should also be controllable by the AvaSpec and as5216 dll Laser pulse control Pin 23 at the DB26 connector can be used to send out a TTL signal which is related to the start of the integration time cyle In the figure below a measurement is started at the rising edge of the Trig signal This can be a hardware or software trigger see also section 3 2 8 The TTL signal at pin 23 Laser is set after the laserdelay T1 expires The pulsewidth for the laser pulse T3 1s set by the m LaserWidth parameter The integration time cycle starts after the integration delay parameter see section 3 2 3 expires Trig Integration The unit for T1 T
17. to develop applications for other purposes you MUST obtain a separate software license 2 You distribute only the drivers necessary to support your application 3 You place all copyright notices and other protective disclaimers and notices contained on the Software on all copies of the Software and your software product 4 You or your company provides technical support to the users of your application Avantes bv will not provide software support to these customers 5 You agree to indemnify hold harmless and defend Avantes bv and its suppliers from and against any claims or lawsuits including attorneys fees that arise or result from the use or distribution of your software product and any modifications to the Software Oct 07 AS 5216 DLL Manual doc 3 Avantes website http www avantes com email Info avantes com 0 INSTALLA TION er 6 T VERSION HISTORY iiciisiccincinroienicierecssescncadsacaduactudccccansuansiactndeanesiexnuaeveruumcuuausacus 8 1 1 New in Version 1 4 0 0 es esasi assess asins a s sses esa s ss 8 1 2 New in version BRE mec MS 9 1 3 New SUB CIE B AALRL 9 1 4 Newin version 1 1 0 0 em M 9 1 5 New in version 1 0 0 0 as5216 dll versus as161 dll 1 5 1 Data ACQUISITION szinre osare eret PR aD AE EDONON EIE pi peri SNTE TEES 1 5 2 Synchronization in Multichannel systems sess nne 1 5 3 Laser control and integration tim
18. unsigned int a ListSize unsigned int a pRequiredSize AvsIdentityType a_pList Blocking control function Returns device information for each spectrometer connected to the ports indicated at AVS Init a ListSize number of bytes allocated by the caller to store the list data a pRequiredSize number of bytes needed to store information a pList pointer to allocated buffer to store identity information 20 number of devices in the list 0 no devices found ERROR INVALID SIZE if a_pRequiredSize gt a_ListSize then allocate larger buffer and retry operation 2 3 5 AVS Activate Function Group Description Parameters Return AvsHandle AVS Activate AvsldentityType a pDeviceld Blocking control function Activates selected spectrometer for communication and reads device configuration data from Eeprom On success AvsHandle handle to be used in subsequent function calls On error INVALID AVS HANDLE VALUE 2 3 6 AVS Deactivate Function Group Description Parameters Return Oct 07 Avantes bool AVS Deactivate AvsHandle a hDeviceld Blocking control function Closes communication with selected spectrometer a hDeviceld device identifier returned by AVS Activate true device successfully closed false device identifier not found AS 5216 DLL Manual doc 15 website http www avantes com email Info avantes com cy ntes 2 3 7 AVS Register Function Group Description Parame
19. 2 and T3 is FPGA clock cycles The FPGA clock runs at 48 MHz so delays and pulse width can be set with 20 83 nanoseconds steps If the integration delay T2 is set to 0 FPGA cycles the rising edge of the integration signal will start one clock cycle 20 83ns before the rising edge of the laser pulse This will ensure that with this setting the flash of the source that 1s triggered by the laser pulse entirely falls in the integration time cycle Oct 07 AS 5216 DLL Manual doc 47 Avantes website http www avantes com email Info avantes com cy ntes Laser Induced Breakdown Spectroscopy LIBS is an application where the integration delay is used in combination with a TTL out at the DB 26 connector to fire a laser After a measurement request or on an external hardware trigger the laser 1s fired by the TTL out The integration time period should not include the laser light so the start of the integration time needs to be delayed A typical integration delay in LIBS applications is about 1 us Laser wavelength The Laser wavelength m_LaserWaveLength control setting is not used in the current version of as5216 A value can be entered but the as5216 firmware does not use this information StoreToRam As of firmware version 0 20 0 0 the StoreToRam function has been implemented To use this function you must set the requested number of scans in the m_StoreToRam control setting and start measuring with a call to AVS Measure using 1 as the numb
20. 6 0 and Borland Oct 07 AS 5216 DLL Manual doc 9 Avantes website http www avantes com email Info avantes com ay ntes C 5 0 The AVS SetPrescanMode function for the AvaSpec 3648 is described in section 2 3 35 and detailed information about how to apply the nonlinearity correction can be found in section 3 6 1 1 5 New in version 1 0 0 0 as5216 dll versus as161 dll Although there is no previous version for as5216 dll v1 0 a comparison can be made for programmers who have used the as161 dll to write application software for the USBI platform AvaSpec spectrometers A number of improvements have been implemented in the as5216 dll when comparing the functions to the as161 dll These improvements can be grouped into the following categories Data acquisition Synchronization in multichannel systems Laser control and integration time delay e g for Laser Induced Breakdown Spectroscopy USB2 platform spectrometer These categories will be described in sections 1 5 1 to 1 5 4 1 5 1 Data acquisition Just like with the as161 dll a spectrum can be collected by calling the function AVS Measure and when a scan has been sent to the PC it can be retrieved with the function AVS GetScopeData The following improvements have been realized in as5216 dll for the USB2 platform spectrometers 1 Starting a measurement In continuous mode the USBI platform spectrometers always run continuously also if no measurement requests are posted A cal
21. 8 2304 AVS GECO DAI ne mter treten teeters rentre need dtt tc dM cud 18 2 3525 AVS GeltSaturatedPixels siccare cepe er rr rg i E HR KE YR E EHE Fe EP ve XE ER EAR 19 ZING AVS GetANalOg IL scettr tien mina rit entem arent en nationis Fevrc Ei eu E eR IEEE 19 2347 SUE Bum 20 2 3 18 AVS GetVersionInto eoonioseoDeu iieri e ORG ETOILE ROO PO e PO DEI 20 2 3 19 AVS GetPIleSiZ iieeeceeeemimieemmte rr ein deii ree adeste reti iere 21 23 20 AVS Get Bless gosse ien e PD en ODD NS 21 232l ANS Eccmrdicm 22 2 3 22 ANS GetNextPile cssescesess sussasdiousttecspivesisscecassesevassvevsevtadbesessoaievs TR POOR ED DEG EFIE 22 2 3 23 AVS JDeletcPile sees ere nne rerit i el sous P OE ek e reed REFER EEEN 23 23 24 AVS GetPirstDifectOry eaedem Oo reine Oddo DO IDPETIEES 23 2 225 JAMSCOCINOXIDITECIODy aoao O T atrae OH Era died steh rep ur rani ere RUE 23 2 3 26 AVS DeleteDirectony sak cies nr teer niae red EY VR Pea n Peg e d i Fe ERE ER EVE Fo eR ER FAR RR 24 232p AVS SDren yeaa A a umet Dome t cac 24 4 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 2 3384 AVS SayeSpectra OoS DCAT ood uoa aU qute Hv ORE MEER HEAD Or rrr agentes 25 23 29 ANS iuarindgoc PR AOU ANS SeAap Outen e a a A m mbatberidehadtaeten Perey eens teeta eas 2 3 31 AVS SetDi
22. DY with SUCCESS or INVALID MEAS DATA as WPARM value and a hDevice as LPARM value a Nmsr number of measurements to do after one single call to AVS Measure 1 is infinite On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID PARAMETER ERR INVALID STATE measurement already pending 2 3 10 AVS GetLambda Function Group Description Parameters Return int AVS GetLambda AvsHandle a hDevice double a pWavelength Internal data read function Returns the wavelength values corresponding to the pixels if available This information is stored in the DLL during the AVS Activate procedure The DLL does not test if a pWaveLength is correctly allocated by the caller a hDevice device identifier returned by AVS_ Activate a pWaveLength array of double with array size equal to number of pixels On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID 2 3 11 AVS GetNumPixels Function Group Description Parameters Return Oct 07 Avantes int AVS GetNumPixels AvsHandle a hDevice unsigned short a pNumPixels Internal data read function Returns the number of pixels of a spectrometer This information is stored in the DLL during the AVS Activate procedure a hDevice device identifier returned by AVS_ Activate a pNumpPixels pointer to unsigned integer to store number of pixels On success ERR SUCCESS On error ERR DEVICE NOT FO
23. ERR INVALID DEVICE ID ERR TIMEOUT error in communication The Toshiba detector in the AvaSpec 3648 can be used in 2 different control modes The Prescan mode default mode In this mode the Toshiba detector will automatically generate an additional prescan for every request from the PC the first scan contains non linear data and will be rejected the 2 scan contains linear data and will be sent to the PC This prescan mode is default and should be used in most applications like with averaging only one prescan is generated for a nr of averages with the use of an AvaLight XE one or more flashes per scan and with multichannel spectrometers The advantage of this mode is a very stable and linear spectrum The disadvantage of this mode is that a minor lt 5 image of the previous scan ghostspectrum is included in the signal This mode cannot be used for fast external trigger and accurate timing since the start of the scan 1s always delayed with the integration time min 3 7 ms The Clear Buffer mode In this mode the Toshiba detector buffer will be cleared before a scan is taken This clear buffer mode should be used when timing is important like with fast external triggering The advantage of this mode is that a scan will start at the time of an external trigger the disadvantage of this mode is that after clearing the buffer the detector will have a minor threshold in which small signals 500 counts will not appear and with dif
24. FF number of strobe pulses during integration period high time of pulse is 1 ms 0 no strobe pulses unsigned int m LaserDelay 0 OXFFFFFFFF laser delay since trigger unit is internal FPGA clock cycle unsigned int m LaserWidth 0 OxFFFF laser pulse width unit is internal FPGA clock cycle 0 no laser pulse float m LaserWaveLength Peak wavelength of laser nm used for Raman Spectroscopy unsigned short m StoreToRam 0 OxFFFF O no storage to RAM gt 0 number of spectra to be stored Size 16 bytes DarkCorrection struct Type unsigned char m Enable 0 1 disable enable dynamic dark correction sensor dependent unsigned char m ForgetPercentage 0 100 percentage of the new dark value pixels that has to be used e g a percentage of 100 means only new dark values are used A percentage of 10 means that 10 percent of the new dark values is used and 90 percent of the old values is used for drift correction Size 7 2 bytes 32 Avantes AS 5216 DLL Manual doc website http www avantes com Oct 07 email Info avantes com cy ntes Type Format Value Range Description DeviceConfig struct Configuration data structure Type unsigned short m_Len 0 OxFFFF size of this structure in bytes unsigned short m ConfigVersion version of this structure char m aUserFrienadlyld 64 user friendly identification string DetectorType m Detector sensor detector related para
25. NN Hours 0 23 fis The Measurement parameter structure MeasConfigType has been described in detail in section 3 2 as well as the Number of Measurements parameter m_Nmsr The SDCardType structure includes the following parameters bool m_Enable unsigned char m_SpectrumType char m aFileRootName 6 TimeStampType m TimeStamp These are the same parameters that have been defined in the function AVS_SaveSpectraToSDCard The boolean m Enable is not used but has been added for possible future standalone functionality to start saving spectra to the SDCard ifm Enable becomes true The m SpectrumType can be set to 0 1 or2 to indicate that a dark drk reference ref or scope roh spectrum should be saved The m aFileRootName 6 parameter is a character string that is used as first part of the name of the stored spectra A sequence number 00 to 99 if the rootname is six characters long 000 to 999 if the rootname is five characters long etc and the file extension drk reference ref or scope roh completes the filename on SDCard The m TimeStamp parameter has been added to be able to add a date time to the files saved on SDCard 54 Avantes AS 5216 DLL Manual doc website http www avantes com Oct 07 email Info avantes com cy ntes 3 6 3 EEProm structure Irradiance Reflectance Calibration and Spectrum Correction The m Irradiance m Reflectance and m SpectrumCorrect parameters occupy together ov
26. Normalized Counts per Second in 8 amp 8 o 955 96 0 0 200 4000 600 8000 10000 1200 14000 1600 0 2000 400 600 800 Counts ants Before linearization After linearization In the application software a dark spectrum needs to be saved first and subtracted from the measured AD Counts before the correction is applied For example suppose the measured AD Counts in the dark for a pixel is a value of 300 Counts At a certain light intensity the measured AD Counts for this pixel becomes a value of 14000 Counts The AD Counts corrected for dark therefore becomes 13700 The Normalized Counts Per Second can be calculated from the polynomial NCPS m_aNLCorrect 0 m aNLCorrect 1 13700 m aNLCorrect 2 13700 m aNLCorrect 3 13700 m aNLCorrect 4 13700 m aNLCorrect 5 13700 m aNLCorrect 6 13700 m aNLCorrect 7 13700 0 97741 The AD Counts value corrected for linearity and dark becomes 13700 0 97741 14017 Counts The AD Counts value corrected for linearity only not for dark becomes 14017 300 14317 Counts Note that the AvaSpec 2048 2048x 14 and 3648 include a Correct for Dynamic Dark option see section 3 2 5 If this correction is applied the measured dark AD Counts value without subtracting measured dark counts is already fluctuating around zero The polynomial can therefore be applied directly to the measured counts The m_aLowNLCounts a
27. UND ERR INVALID DEVICE ID AS 5216 DLL Manual doc 17 website http www avantes com email Info avantes com cy ntes 2 3 12 AVS GetParameter Function Group Description Parameters Return int AVS GetParameter AvsHandle a hDevice unsigned int a Size unsigned int a pRequiredSize DeviceConfigType a pData Internal data read function Returns the device information of the spectrometer This information is stored in the DLL during the AVS Activate procedure a hDevice device identifier returned by AVS Activate a Size number of bytes allocated by caller to store DeviceConfigType a pRequiredSize number of bytes needed to store DeviceConfigType a pData pointer to buffer that will be filled with the spectrometer configuration data On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID SIZE a Size is smaller than required size 2 3 13 AVS PollScan Function Group Description Parameters Return int AVS PollScan AvsHandle a hDevice Internal data read function Determines if new measurement results are available a hDevice device identifier returned by AVS_ Activate On success 0 no data available 1 data available 7 When using the StoreToRam function the return value signals the number of scans available for retrieval On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID 2 3 14 AVS GetScopeData Function Group Description
28. ams9840 Smoothing struct Type unsigned short m_SmoothPix 0 2048 number of neighbour pixels used for smoothing max has to be smaller than half the selected pixel range because both the pixels on the left and on the right are used unsigned char m SmoothModel 0 Only one model defined so far Size 3 bytes Spectrum struct Calibration Type SmoothingType m Smoothing smoothing parameter during calibration float m Callnttime 0 01 600000 integration time during calibration ms float m_aCalibConvers 4096 Conversion table from Scopedata to calibrated data Size 16391 bytes Spectrum struct Correct pixel values e g for PRNU Correction Type float m aSpectrumCorrect 4096 Size 16384 bytes 36 Avantes AS 5216 DLL Manual doc website http www avantes com Oct 07 email Info avantes com cy ntes Type Format Value Range Description Standalone struct Type bool m Enable MeasConfigType m Meas signed short m Nmsr SDCardType m SDCard Size 56 bytes TecControl struct Tec Control parameters for AvaSpec 256 NIR2 2 Type bool m Enable Set to True if device supports TE Cooling float m_ Setpoint SetPoint for detector temperature in degr Celsius float m aFit 2 DAC polynomial Size 13 bytes TempSensor struct Calibration coefficients temperature sensor Type float m aFit 5 Fit Size 20 bytes TimeStamp struct Type unsigned short m_Date bit 0 4 d
29. antes com cy ntes Example source code can be found in the directory tree of the driver Sample programs including header files and link libraries where appropriate are provided for the following programming environments 3 Example source code Borland Delphi v 6 0 Borland C Builder v 5 0 Microsoft Visual C Visual Studio v 6 0 Microsoft Visual C 2005 Microsoft Visual Basic Visual Studio v 6 0 Microsoft Visual Basic NET 2005 v 2 0 Microsoft C NET 2005 v 2 0 National Instruments LabView v 8 2 older versions on request 3 1 Initialization and Activation of a spectrometer After starting one of the Borland example programs Borland C or Delphi the main window will be displayed By clicking the Open Communication button the AVS Init function is called and if successful the serial number and status for the connected spectrometer s is collected AVS GetNrOfDevices and AVS GetList The result is displayed in the list at the top left of the window as shown in the figure below ox Prepare Measurement Settings rMeasue 4 Start pixel 0 Dark Correction Setting pu Enable Nr Of Scans Ho Update List Stop pixel 2047 1 infinite wie fi 00 x ei status a megatontine CUT ms Ta ABLE Integration Delay fo ns Smoothing Settings O601001U1 AVAILABLE listed ho oen p Stop Measurement Saturation dete
30. are 4 sample programs acomprehensive program for a single channel AvaSpec USB2 which also includes subvi s for all functions in the as5216 dll aprogram that illustrates the use of Windows Messaging in LabView asimple sample program that uses AVS PollScan instead of Windows Messaging a multichannel example program which illustrates how to run multiple spectrometer channels fixed to 2 channels in the example program in SYNC mode as well as ASYNC mode In this manual examples have been added for using the function AVS UseHighResAdc in combination with nonlinearity correction and or irradiance calibration see section 3 6 1 under Using the nonlinearity correction polynomial in combination with the 16bit ADC Counts range and section 3 6 3 under How to convert ScopeData A D Counts to a power distribution nu Watt cm nm AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com 1 2 New in version 1 3 0 0 cy ntes New Sample programs in Visual C and Visual Basic NET 2001 These sample programs can also be used in more recent NET versions 2005 in which case the Visual Studio Conversion Wizard will convert the project to the new version Note that for Visual Basic NET there was already a VB NET 2005 sample program available ProcessControl Structure added for standalone functionality see section 3 6 6 Stability issues solved Some spectrometer types mainly the AvaSpec 102 USB2
31. artPixel n For example if m_StartPixel 10 then a pSpectrum 0 represents the measured data at pixel number 10 42 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 3 2 2 Measurement structure Integration Time The integration time is the exposure time during one scan The longer the integration time the more light is exposed to the detector during a single scan and therefore the higher the signal The unit is milliseconds ms and the resolution 0 01 ms steps The minimum integration time is detector dependent The table below shows the values for the different detector types Spectrometer Detector Type Min Integration time ms AvaSpec 256 US B2 SENS HAMS8378 256 0 56 AvaSpec 1024 USB2 SENS HAMS8378 1024 2 20 AvaSpec 2048 USB2 SENS ILX554 1 10 AvaSpec NIR256 USB2 SENS HAMS9201 0 52 AvaSpec 3648 USB2 SENS TCD1304 0 01 AvaSpec 102 USB2 SENS TSL1301 0 06 AvaSpec 128 USB2 SENS TSL1401 0 06 AvaSpec 2048x14 USB2 SENS HAMS9840 2 24 The longest integration time is 10 minutes 600000 ms 3 2 3 Measurement structure Integration Delay The integration delay parameter can be used to start the integration time not immediately after the measurement request or on an external hardware trigger but after a specified delay The unit for this delay is FPGA clock cycles The FPGA clock runs at 48 MHz so the integration dela
32. ay 0 31 bit 5 8 month 1 12 bit 9 15 years since 1980 0 119 unsigned short m Time bit 0 4 2 second unit 0 30 i bit 5 10 minutes O 59 bit 11 15 hours 0 23 TriggerType struct Trigger parameters unsigned char m_Mode 0 1 mode 0 Software 1 Hardware unsigned char m Source 0 1 trigger source 0 external trigger 1 sync input unsigned char m SourceType 0 1 source type 0 edge trigger 1 level trigger Size 3 bytes Oct 07 AS 5216 DLL Manual doc 37 Avantes website http www avantes com email Info avantes com cy ntes The following table gives an overview of possible integer return codes 2 4 1 Return value constants Return code Value Description SUCCESS 0 Operation succeeded ERR INVALID PARAMETER 1 Function called with invalid parameter value ERR OPERATION NOT SUPPORTED 2 Fixed strobe not supported for ILX in fast trigger mode ERR DEVICE NOT FOUND 3 Opening communication failed or time out during communication occurred ERR INVALID DEVICE ID 4 AvsHandle is unknown in the DLL ERR OPERATION PENDING 5 Function is called while result of previous function is not received yet ERR TIMEOUT 6 No answer received from device Reserved 7 ERR INVALID MEAS DATA 8 No measurement data is received at the point AVS GetScopeData is called ERR INVALID SIZE 9 All
33. c 2048 spectrometers the third level is available m SaturationDetection 2 autocorrect inverted pixels The reason for this is that if the detector type in the AvaSpec 2048 Sony ILX554 is heavily saturated at a light intensity of approximately 5 times the intensity at which saturation starts it will return values 65535 counts The other detector types in the AvaSpec 102 128 256 1024 2048x14 and 3648 and AvaSpec NIR do not show this effect so no correction is needed Normally you don t need to use this third level for the AvaSpec 2048 but when measuring a peaky spectrum with some heavily saturated peaks the autocorrect can be used A limitation to this level is that it can be used only if no averaging is used m NrAverages 1 The AvaSpec USB2 spectrometers with an as5216 board Rev C and earlier were equipped with a 14 bit AD converter range 0 16383 In this case the detector is saturated at 16383 counts 3 2 8 Measurement structure Trigger Type Trigger Settings Trigger mode Hardware IV Software Trigger source V External Synchronized Trigger type V Edge Level The trigger type structure includes settings for Trigger Mode Hardware Software Trigger Source External Synchronized and Trigger type Edge Level Setting the Trigger Source to Synchronized is relevant if multiple spectrometers need to run synchronised all spectrometers start a measurement at the same time This option will be descr
34. cations in which the spectrometer runs completely standalone without a connection to a PC Data processing is in that case done onboard by dedicated firmware and the analog and digital outputs are used to signal the function output Oct 07 AS 5216 DLL Manual doc 57 Avantes website http www avantes com email Info avantes com
35. ced by selecting the start and stoppixel StoreToRam requires firmware version 0 20 or later A firmware upgrade utility can be downloaded from our website Implementation of directory support for the Secure Digital Card In a few occasions there have been problems with detecting and or activating AvaSpec USB2 spectrometers under Windows Vista The reason for this is that according to MicroSoft a USB device takes a long time to resume from selective suspend mode on a Windows Vista based computer that uses UHCI Universal Host Controller Interface USB controllers In the as5216 dll version 1 4 a workaround has been implemented to solve this problem New sample programs for Visual C 2005 Delphi and LabView o The Visual C 2005 sample program has been created in the Express version o A few sample programs in Delphi have been added besides the comprehensive sample program that was already available in earlier as5216 dll versions 3 new sample programs have been added A multichannel sample program in which up to 16 spectrometer channels can run simultaneously in SYNC mode or ASYNC mode An sdcard sample program which demonstrates how to save spectra to an onboard sdcard Asimple program with only a few lines of code which demonstrates the basic data acquisition for a single channel AvaSpec USB2 spectrometer o The LabView sample programs have been updated to LabView version 8 2 earlier versions can be obtained on request There
36. ction fo Nr Of Pixels 0 Trigger Settings Control Settings gt Trigger mode Hardware Flashes per Scan iV Software Laser delay 0 n Trigger source V External Laser width 10000 ne I Synchronized zl F Ed Laser wavelength 785 nm i v le Trigger ype r eee Spectra stored to RAM JO Activate Deactivate Read Measurement Settings from EEPROM Write Measurement Settings to EEPROM Selected Device Into 3 Measurement Statistics 7 Detector Time Since Stai Nr Of Pixels J Nr Of Scans FPGA Version Nr Of Failures J 455216 FW Version Avg Time Scan ms 55216 DLL Version Last scan in ms Digital 1G Analog IG Show EEProm parameters Disable Graphical Output IConnected USB Device arrival Oct 07 AS 5216 DLL Manual doc 4l Avantes website http www avantes com email Info avantes com cy ntes After selecting a spectrometer from the list clicking the Activate button results in a call to the AVS Activate function This function returns a DeviceHandle which needs to be used in further communication between the dll and this device After a succcessful call to AVS_ Activate the status for the selected device will change from AVAILABLE to IN USE BY APPLICATION The sample program uses one DeviceHandle so if you want to run multiple devices simultaneously you need to allocate storage space for multiple devicehandles For the a
37. ctivated device the Device information is collected AVS_GetVersionInfo AVS GetNumPixels AVS GetParameter AVS GetLambda and displayed in the main window Thanks to the Windows API OnDeviceChange function attachment and removal of spectrometers can be detected by the application see the OnDeviceChange function in the source code Note To match the structures that are used in the AS5216 firmware the structures used in the as5216 dll should be compiled with byte alignment 3 2 Starting a measurement Measurements can be started by clicking the Start Measurement button The Nr of Scans field displays how many scans will be performed after one measurement request Before a call to AVS Measure is done the AVS PrepareMeasurement function is called with the parameters in the MeasConfigType structure The Prepare Measurement Settings group in the figure below shows all the parameters in this MeasConfigType structure Prepare Measurement Settings j unsigned short m StartPixel Start pixel 0 Dark Correction Settings unsigned short m_StopPixel Siege 2756 v Enable float m IntegrationTime id 100 unsigned int m IntegrationDelay Integration time 10 00 ms S unsigned int m NrAverages Integration Delay 21 ng Smoothing Settings DarkCorrectionType m_CorDynDark SmoothingType m Smoothing Number of avera 100 0 i fies unsigned char m SaturationDetection Saturation detection 1 Nr Of Pixels 0 TriggerType m Tr igger ControlSett
38. cy ntes AS 5216 DLL Interface Package for 32 bit Windows Applications Version 1 4 0 0 USER S MANUAL October 2007 Avantes B V Soerense Zand 4a NL 6961 LL Eerbeek The Netherlands Tel 31 313 670170 Fax 31 313 670179 Web www avantes com Email info avantes com Oct 07 AS 5216 DLL Manual doc 1 Avantes website http www avantes com email Info avantes com cy ntes Microsoft Visual C Visual Basic Visual C Windows Windows 95 98 Me Windows NT 2000 XP and Microsoft Office are registered trademarks of the Microsoft Corporation Windows Vista is either a registered trademark or trademark of Microsoft Corporation in the United States and or other countries Borland and Borland C are registered trademarks and C Builder and Delphi are trademarks of Borland International Inc LabVIEW is a trademark of the National Instruments Corporation Copyright O 2007 Avantes bv All rights reserved No part of this publication may be reproduced stored in a retrieval system or transmitted by any means electronic mechanical photocopying recording or otherwise without written permission from Avantes bv This manual is sold as part of an order and subject to the condition that it shall not by way of trade or otherwise be lent re sold hired out or otherwise circulated without the prior consent of Avantes bv in any form of binding or cover other than that in which it is published Every effort has been made to
39. data except for the last scan will be sent This mode is specially useful for conveying belt applications when a product needs to be scanned independent of the transport speed Running multiple spectrometers Synchronized All USB2 platform spectrometers can be connected by a SYNC cable In syncmode one spectrometer is configured as Master by calling the AVS SetSyncMode function for this channel The trigger source for the Master channel should not be set to Synchronized but to External The trigger mode for the Master can be set to Software if a measurement should start after a measurement request in the software or to Hardware 1f a measurement should start after an external hardware trigger pulse at pin 6 of the Master DB26 connector All other slave spectrometers are set into Synchronized mode by setting the Trigger Source to Synchronized and the Trigger Mode to Hardware Do not call the AVS SetSyncMode for the Slave spectrometers A synchronized measurement is started by calling AVS Measure first for all slave channels As a result these channels start listening to their SYNC input port Secondly a measurement request call to AVS Measure needs to be posted for the Master channel If the trigger mode for the Master is software this result in nrms measurements for all channels If the trigger mode for the Master is hardware the nrms measurements for all channels are started after an external trigger
40. e 1 for first active device AS 5216 DLL Manual doc 23 website http www avantes com email Info avantes com Return cy ntes a pPrevName directory name 14 characters including terminating zero this is the name returned by AVS GetFirstDirectory or by the previous call to AVS GetNextDirectory a pNextName directory name 14 characters including terminating zero On success ERR SUCCESS a pNextName contains valid value On error ERR DEVICE NOT FOUND communication not open yet ERR INVALID DEVICE ID device handle is not known in DLL ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or no more directories on the SD card 2 3 26 AVS DeleteDirectory Function Group Description Parameters Return int AVS DeleteDirectory AvsHandle a hDevice unsigned char a pName Blocking read function Deletes a directory from the SD card a hDevice device identifier returned by AVS Activate 1 for first active device a pName directory name 14 characters including terminating zero On success ERR SUCCESS On error ERR DEVICE NOT FOUND communication not open yet ERR INVALID DEVICE ID device handle is not known in DLL ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or no more directories on the SD card 2 3 27 AVS SetDirectory Function Group Description Parameters Return 24 Avantes int AVS SetDirectory
41. e delay e g for LIBS ssssseeeeeeeene 11 1 5 4 USB2 platform specific TUNCHONS cccssssescsseccsesessosesccseetesnseissovsosesesesesesesssssesssossessonsseenas oveseeee 12 2 AS 5216 DLL DESCRIPTION iuiisasiniusbssnendddxiskusssbu ka mi csn ns pt DrU Mas ERG AN r S iana 13 EnU 13 2 2 Usage P 13 2 3 Exported fUMctions scsssscsssssrssssesscsccscsssscsscsssssssesssssesesssssssssnessssssecssscscusssassessesssssssesensesessesssseeses 14 2 3 1 ANS E ea a a T hcca tts T E T T A T assed oes E T 14 2 32 LONE E A 14 2 3 3 AVS OeEUNTOIDEVICES i orate dest riter iei trii d rd ER Oo va sa ebore et Pepe du LER reae IR dd 14 2 34 AVS GOtL ASE EET 15 2 3 5 AVS AGIVale eese ERROR EI USE MED YII DET ER S 15 2 3 6 RAPIT DS ESE N Nasa 15 2 3 7 AVS RegISteE eee a Deere EDU D DII DEED DE 16 2 3 8 AVS PrepareMGasute ois iss cscs cerit eripe tereti te ore OP i Cer Yi ote sus XE ET OSTAA i ze Ee Sa INESE Eaa 16 2 3 9 AVS MOGBSUTO irre rrt etre Fees eee da UH PERTH Eo pe FERE ER UR ERR RN EARS AR FU KE TRA tea LH EROR ERBEN EA Pe HERE ER Fes da a da 16 PISMO CA VS Get ainda costesieoneiaretishtuttostt tanc A taco fiant 17 2 343 AVS GetNumPixels 4 eterne teet ere n da i rr n dg Pt E i Ed Fee HP Fen S 17 ZOD AVS GOUP ATA ele E secedere NR rrr E UR LR Ee etam esta na E S ids 18 2313 WNddicumt E 1
42. e master device identifier returned by AVS_ Activate a Enable 0 1s disable sync mode 1 1s enables sync mode On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID 2 3 34 AVS StopMeasure Function Group Description Parameters Return 28 Avantes int AVS StopMeasure AvsHandle a hDevice Blocking data send function Stops the measurements needed if Nmsr infinite can also be used to stop a pending measurement with long integrationtime and or high number of averages a hDevice device identifier returned by AVS_ Activate On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com cy ntes Function int AVS SetPrescanMode 2 3 35 AVS SetPrescanMode AvsHandle a hDevice bool a Prescan Group Blocking data send function Description Ifa Prescan is set the first measurement result will be skipped This function is only useful for the AvaSpec 3648 because this detector can be operated in prescan mode or clearbuffer mode see below Parameters a hDevice device identifier returned by AVS Activate a Prescan If true the first measurement result will be skipped prescan mode else the detector will be cleared before each new scan clearbuffer mode Return On success ERR SUCCESS On error ERR DEVICE NOT FOUND
43. e pair of open and close functions AVS Init and AVS Done that have to be called by an application As long as the open function is not yet called or not successfully called all other functions will return an error code The open function AVS Init tries to open a communication port for all connected devices The close function AVS Done closes the communication port s and releases all internal data storage The interface between the application and the DLL can be divided in four functional groups e internal data read functions which read device configuration data from the internal DLL storage e blocking control functions which send a request to the device and wait till an answer is received or a time out occurs before returning control to the application e non blocking data read functions which send a request to the device and then return control to the application After the answer from the device is received or a timeout occurs a notification is sent to the application e data send functions which send device configuration data to the device After the application has initialised it should select the spectrometer s 1t wants to use Therefore the following steps have to be taken 1 Call AVS GetNrOfDevices to determine the number of attached devices 2 Allocate buffer to store identity info RequiredSize NrDevices sizeof AvsIdentityType 3 Call AVS GetList with the RequiredSize and obtain the list of connected spectrom
44. e read from the SD card a hDevice device identifier returned by AVS_ Activate a pName file name 14 characters including terminating zero a pSize pointer to buffer to store length On success ERR SUCCESS buffer contains valid value On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or file not found 2 3 200 AVS GetFile Function Group Description Parameters Return Oct 07 Avantes int AVS GetFile AvsHandle a hDevice unsigned char a pName unsigned char a pDest unsigned int a pSize Blocking read function Returns the contents of a binary file from the SD card a_hDevice device identifier returned by AVS_Activate a_pName file name 14 characters including terminating zero a_pDest pointer to buffer to store binary file data a pSize length of buffer expected file size as determined with AVS GetFileSize max length is 64kB On success ERR SUCCESS buffer contains valid value On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER no SD card present or file not found AS 5216 DLL Manual doc 21 website http www avantes com email Info avantes com cy ntes 2 3 21 AVS GetFirstFile Function Group Description Parameters Return int AVS GetFirstFile AvsHandle a hDevice unsigned char a pName Blocking read function
45. elements vores x Feee x2 4 B546491E 9 SensorType m SensorType Caen xg unmeee 2 C unsigne d short m NrPixel co 10 x4 a2 5797616 a BA xI aza 1 0392549E 20 float m aFit 5 n manas x5 bool m NLEnable xE 4 0256674E 25 x3 3 3985930E 9 eas 30 a m aNLCorrect 8 oeo x7 ouble m aLowNLCounts LoCouns 20000000E 2 double m aHighNLCounts Deleciive Pek HiCounts 15500000E 4 float m G a in 2 v Enable NonLinearity Correction float m Reserved float m Offset 2 Gam 112 float m ExtOffset Bang 100 unsigned short m DefectivePixels 30 PENES Of seg J000 Ext Offset 0 00 50 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes SensorType and Number of Pixels The as5216 board supports many different detectors which are used in the AvaSpec spectrometers as shown in the table below Spectrometer DetectorType Number of Pixels AvaSpec 256 USB2 SENS HAMS8378 256 256 AvaSpec 1024 USB2 SENS HAMS 8378 1024 1024 AvaSpec 2048 USB2 SENS ILX554 2048 AvaSpec NIR256 USB2 SENS HAMS9201 256 AvaSpec 3648 USB2 SENS TCD1304 3648 AvaSpec 102 USB2 SENS TSL1301 102 AvaSpec 128 USB2 SENS TSL1401 128 AvaSpec 2048x14 USB2 SENS HAMS9840 2048 For each detector different FPGA firmware is needed The SensorType parameter should therefore not be changed unless new FPGA firmware for another detectortype
46. ennen ete enne nne 3 2 9 Measurement structure Control Settings sess nennen KKEEMUTu 48 49 49 EK NN H D Aa E M 50 3 6 1 EEProm structure Detector Parameters sse eene enn eren 50 3 6 2 EEProm structure Standalone Parameters sees nennen 54 3 6 3 EEProm structure Irradiance Reflectance Calibration and Spectrum Correction 55 3 6 4 EEProm structure Temperature Sensors 3 6 5 EEProm structure Tec Control 3 6 6 EEProm siructure ProcessControl 5 re rte ro ren E OR s ERE Pa ea YER aay Oct 07 AS 5216 DLL Manual doc 5 Avantes website http www avantes com email Info avantes com cy ntes AS 5216 DLL is a 32 bit driver interface package and can be installed under the following operating systems e Windows 95 98 Me e Windows NT 2000 XP Vista 0 Installation The installation program can be started by running the file setup exe from the CD ROM Installation Dialogs The setup program will check z 2 Choose Destination Location the system configuration of the computer If no problems are detected the first dialog 1s the Welcome dialog with some general information Setup will install 4S 5216 DLL interface package in the following folder To install i
47. er 99 of the defined memory in the EEProm structure Sizeof DeviceParamType with the m aReserved block excluded This is because each of these three parameters include an array of 4096 MAX NR PIXELS float numbers which can hold pixel specific calibration data The Irradiance Calibration structure IrradianceType has been defined to store the results of an irradiance intensity calibration in EEProm as well as the settings during this calibration integration time smoothing measurement setup fiberdiameter By reading these data from EEProm it will be possible to convert a spectrum with raw scopedata into an irradiance spectrum How to convert ScopeData A D Counts to a power distribution pWatt cm nm In the application software the smoothpix value in the preparemeasurement structure should be set to the same value as the smoothpix during the intensity calibration This value can be found in m Irradiance m IntensityCalib m Smoothing m SmoothPix Also before the irradiance intensity for a pixel i can be calculated a dark spectrum A D Counts with no light exposed to spectrometer should be saved once at the integration time that will be used in the measurements The dark spectrum for each pixel 1 can be called e g darkdata i The irradiance intensity at a certain pixel 1 i 0 totalpixels 1 can then be calculated from ScopeData i Measured A D Counts at pixel i AVS GetScopeData DarkData i Dark data at p
48. er of measurements a Nmsr There is an amount of 4MB available for scans corresponding with 1013 scans of 2048 pixels Scanning less pixels will yield a larger capacity in scans The AVS Measure message signaling the arrival of data will have a WParam value equal to the number of scans stored in RAM In regular measurements this value only signals success with value ERR SUCCESS or failure with a negative error message Alternatively when using polling instead of a message driven interface the AVS PollScan function will also return the number of available scans In regular measurements it will return 1 when data are available and 0 when they are not The scans can subsequently be read with a corresponding number of calls to AVS GetScopeData If you request more scans than will fit in memory scanning will continue until the memory is fully used therefore you should always request the number of scans that is returned in WParam or AVS PollScan The StoreToRam functionality has been implemented in most sample programs that come with the as5216 dll interface package 3 3 Measurement result If a measurement is ready the windows message WM MEAS READY is sent to the application The Wparam value of the message should be Oinregular measurements where the StoreToRam parameter is zero to indicate SUCCESS gt 0inStoreToRam mode Wparam holds the number of spectra that were actually saved in RAM lt 0 incase an error occurred see
49. es a smoothpix and a smoothmodel field In the current version of the as5216 dll there is just one smoothing model available 0 in which the spectral data is averaged over a number of pixels on the detector array For example if the smoothpix parameter is set to 2 the spectral data for all pixels x on the detector array will be averaged with their neighbor pixels x Xn 1 Xn 1 aNd Xpi2 The optimal smoothpix parameter depends on the distance between the pixels at the detector array and the light beam that enters the spectrometer For the AvaSpec 2048 the distance between the pixels on the CCD array is 14 micron With a 200 micron fiber no slit installed connected the optical pixel resolution is about 14 3 CCD pixels With a smoothing parameter set to 7 each pixel will be averaged with 7 left and 7 right neighbor pixels Averaging over 15 pixels with a pitch distance between the CCD pixels of 14 micron will cover 15 14 210 micron at the CCD array Using a fiber diameter of 200 micron means that we will lose resolution when setting the smoothing parameter to 7 Theoretically the optimal smoothing parameter is therefore 6 The formula is slit size pixel size 1 2 In the table below the recommended smoothing values for the AvaSpec spectrometer are listed as function of the light beam that enters the spectrometer This light beam is the fiber core diameter or if a smaller slit has been installed in the spectrometer the slit width Note
50. es in a single measurement DarkCorrectionType m CorDynDark dynamic dark correction parameters SmoothingType m Smoothing smoothing parameters unsigned char m SaturationDetection 0 2 0 disabled 1 enabled determines during each measurement if pixels are saturated ADC value 2 14 1 2 enabled and also corrects inverted pixels only Sony TriggerType m Trigger trigger parameters ControlSettingsType m Control control parameters Size 41 bytes ProcessControl struct Type Settings that can be used for the 2 analog and 10 digital output float m_AnalogLow 2 signals at the DB26 connector The analog settings can be used float m AnalogHigh 2 to define a function output range that should correspond to the ux 0 5V range of the analog output signals float m DigitalLow 10 Mus float m DigitalHigh 10 o settings can be used as lower and upper Size 96 bytes SDCardType Struct Settings for SD Card needed in stand alone operation bool m Enable unsigned char m SpectrumType char m aFileRootName 6 TimeStampType m TimeStamp Size 12 bytes Oct 07 AS 5216 DLL Manual doc 35 Avantes website http www avantes com email Info avantes com ay ntes Type Format Value Range Description SensorType unsigned char 0 9 0x00 Reserved 0x01 Hams8378 256 0x02 Hams8378 1024 0x03 ILX554 0x04 Hams9201 0x05 Toshiba TCD1304 0x06 TSL1301 0x07 TSL1401 0x08 Hams8378 512 0x09 H
51. eter will keep scanning as long as the TTL input signal is HIGH and when the signal becomes LOW it will return the average scan over all scans that were performed during the HIGH time period 7 Integration time The integration time in the as161 dll can be set with a 1 ms resolution In the as5216 dll a 0 01 ms 10 us resolution is used for the integration time 8 Timestamp The AVS GetScopeData function in as5216 dll includes a timestamp in 10 us resolution ticks generated by the microcontroller which can be used to measure the time between two consecutive and processed scans very accurately 1 5 2 Synchronization in Multichannel systems There is a major difference between the USB1 and USB2 platform multichannel systems The USB1 platform multichannel systems always needs the same detectortype for each channel Also the integration time and number of averages in a measurement request is equal for all channels With the multiple usb support in the as161 dll v 1 5 and later spectrometers with different detectors and at different integration time or average can run simultaneously but in that case there is no synchronization between these spectrometers With the USB2 platform multichannel systems the advantage of the multiple USB implementation up to 127 spectrometers possibility of using different detectors integration time and averaging per channel has been combined with the advantage of the as161 multichannel systems synchronizatio
52. eters 4 Select the spectrometers you want to use with AVS Activate 5 Register a notification window handle with AVS Register to detect device attachment removal Oct 07 AS 5216 DLL Manual doc 13 Avantes website http www avantes com email Info avantes com cy ntes 2 3 Exported functions 2 3 1 AVS Init Function int AVS Init short a Port Group Blocking control function Description Opens the communication with the spectrometer and initialises internal data structures Parameters a Port id of port to be used use auto detect of USB or COM port 0 use USB port 1 use COMI port 2 use COM2 port 3 use COMG port 4 use COM4 port etc Return On success number of connected device On error ERR DEVICE NOT FOUND 2 3 0 AVS Done Function int AVS Done Void Group Blocking control function Description Closes the communication and releases internal storage Parameters None Return SUCCESS 2 3 3 AVS GetNrOfDevices Function int AVS GetNrOfDevices void Group Blocking control function Description Internally checks the list of connected devices and returns the number of devices currently attached Parameters None Return gt 0 number of devices in the list 0 no devices found 14 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 2 3 4 AVS GetList Function Group Description Parameters Return int AVS GetList
53. ferent integration times the detector is not linear Oct 07 AS 5216 DLL Manual doc 29 Avantes website http www avantes com email Info avantes com cy ntes 2 3 36 AVS UseHighResAdc Function Group Description Remark Parameters Return 30 Avantes int AVS UseHighResAdc AvsHandle a hDevice bool a Enable Internal DLL write function With the as5216 electronic board revision 1D and later a 16bit resolution AD Converter is used instead of a 14bit in earlier hardware versions As a result the ADC Counts scale can be set to the full 16 bit 0 65535 Counts For compatibility reasons with previous hardware revisions the default range 1s set to 14 bit 0 16383 75 ADC Counts When using the 16 bit ADC in full High Resolution mode 0 65535 please note that the irradiance intensity calibration as well as the nonlinearity calibration are based on the 14bit ADC range Therefore if using the nonlinearity correction or irradiance calibration in your own a hDevice device identifier returned by AVS_ Activate a_Enable True use 16bit resolution ADC Counts range 0 65535 False use 14bit resolution ADC Counts range 0 16383 75 On success ERR SUCCESS On error ERR OPERATION NOT SUPPORTED this function is not supported by as5216 hardware version R1C or earlier AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com cy ntes 2 4 Data Elements Several data types used
54. gOut 2 3 32 AVS SetPwmOut 2 3 33 AVS SetSyncMode 2 3 34 AVS StopMECasUute ioiececsopbciermiecomdedoegn edo ed aa peser E R SA TEE 2 3 35 SAXNS SetPrescanMOde s saint as ri a repere DU P ERR ROO RARO OE EIER 29 2 3136 AVS UscHighResAdc eenecononin eene eere RO Pee HORE ERR ERES cree RR 30 AEBn 31 24 1 Return value constants eterni tere eee engan eee Re ERE NER daceuecesdyendgutusceencaavusduiebees 38 242 Windows messages o oorgeeimrested rats er rings VIO OE Per FI UD GO LOUER bias O OTE 40 3 EXAMPLE SOURCE CODE 525 6 5 cr rkaknrin ss Sap Ek pa n 6 En aka ra ang RR d cds 41 3 1 Initialization and Activation of a spectrometer eese eee esent nent tn tasa insta stata sins inensun 41 3 2 Starting a measurement 42 3 2 1 Measurement structure Start and Stoppixel sss 42 3 2 2 Measurement structure Integration Time sess ener 43 3 2 3 Measurement structure Integration Delay seseesessssseeseeseeneeeenenee nennen nennen 43 3 2 4 Measurement structure Number of Averages 43 3 2 5 Measurement structure Dynamic Dark Correction sess 43 3 2 6 Measurement structure Smoothing ssreesissir soriire ronssar ae eene nenne nre trennen nennen 3 2 7 Measurement structure Saturation Detection 3 2 8 Measurement structure Trigger Type sosi naa S a TE ener n
55. have shown a lock up in continuous measurements over a long period at short integration time Another problem that showed up very rarely concerns multichannel spectrometers running in synchronization mode Both problems have been solved in as5216 dll version 1 3 Support for the AvaSpec 2048x14 High UV sensitivity back thinned CCD Spectrometer The new detector type used in this spectrometer is the HAMS9840 and is supported in as5216 dll version 1 3 and all the sample programs The new function AVS UseHighResAdc has been added to enable the full 16 bit ADC range which is available with a 16 bit ADC on the as5216 board as of revision 1D See also section 2 3 36 A minor bug in the smoothing routine has been solved The sample program in Visual Basic 6 0 has been modified because it crashed after running continuously for a number of hours The cause was found to be in the VB6 Timer function that was used to show some statistics about the measurement speed By eliminating the Timer function from the sample program this problem was solved Feedback from VB6 programmers who know how to use the Timer function or an equivalent without crashing the application is appreciated 1 3 New in version 1 2 0 0 Visual Basic 6 0 developers may have noticed that the programs developed with as5216 dll v 1 1 or earlier and Visual Basic 6 0 are stable but the Visual Basic 6 0 Integrated Development Environment IDE was not Running the program from t
56. he VB6 IDE caused the IDE to close down without saving any changes as soon as the program was closed To solve this problem a special as5216 dll version 1 2 0 1 has been created which can be used in the VB6 IDE to develop and debug your programs AS5216 dll version 1 2 0 1 will be installed in the VB6 example folder as well as a readme txt file with recommendations for redistributing programs developed with Visual Basic 6 0 Furthermore a parameter structure has been added to the EEProm to control the TEC cooling for the NIR spectrometer AvaSpec 256 NIR2 2 More detailed information about this TEC Control structure can be found in section 3 6 5 The last change in version 1 2 is only in this manual For spectrometers that have been calibrated for irradiance measurements the IrradianceType structure contains data that can be used to convert the ScopeData A D Counts to an irradiance spectrum Section 3 6 3 in this manual decribes more in detail how this can be done 1 4 New in version 1 1 0 0 The as5216 dll version 1 1 includes one new function AVS_SetPrescanMode which can be used for the AvaSpec 3648 spectrometer Furthermore a lower and upper limit has been added to the nonlinearity polynomial to avoid incorrect correction for very low and or high counts Finally example programs with source in LabView 7 1 Visual C 6 0 Visual Basic 6 0 and Visual Basic NET 2005 2 0 have been added to the already existing examples in Delphi
57. ibed below under Running multiple spectrometers Synchronized Single channel spectrometers or multiple spectrometers in ASYNC mode can operate in one of the three following Trigger settings Trigger Source should be set to External Trigger Mode Software This Trigger setting is used when one or more nrms measurements should start after a measurement request in the software AVS Measure call The Edge Level is irrelevant because this only applies to an external hardware trigger Trigger Mode Hardware Edge triggered This trigger setting is used when one or more nrms measurements should start after an external hardware trigger pulse has been received at pin 6 of the DB26 connector First a measurement request is posted in the software AVS Measure call Then the spectrometer waits until a rising edge of the TTL input pulse is detected at pin 6 of the DB26 connector before nrms scans are started Oct 07 AS 5216 DLL Manual doc 45 Avantes website http www avantes com email Info avantes com cy ntes Trigger Mode Hardware Level triggered This trigger setting is used when scans should be performed as long as the external trigger at pin 6 of the DB26 connector is HIGH The spectrometer will start to accumulate data take scans at the selected integration time at the rising edge of the TTL pulse and will continue to do so as long as the TTL signal remains high When the signal becomes low the average of the accumulated
58. ile time and date that will be used when the spectra are stored ERR SUCCESS ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER ERR OPERATION NOT SUPPORTED SD Card not present AS 5216 DLL Manual doc 25 website http www avantes com email Info avantes com cy ntes 2 3 29 AVS SetParameter Function Group Description Parameters Return int AVS SetParameter AvsHandle a hDevice DeviceConfigType a pData Blocking data send function Overwrites the device configuration data internally and in the spectrometer The data is not checked a hDevice device identifier returned by AVS_ Activate a pData pointer to a DeviceConfigType structure On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR OPERATION PENDING ERR INVALID STATE measurement pending 2 3 30 AVS SetAnalogOut Function Group Description Parameters Return int AVS SetAnalogOut AvsHandle a hDevice unsigned char a PortlId float a Value Blocking data send function Sets the analog output value for the specified analog output a hDevice device identifier returned by AVS_ Activate a_Portld identifier for one of the two output signals 0 AOI pin 17 at 26 pins connector 1 AO2 pin 26 at 26 pins connector a Value DAC value to be set in Volts internally an 8 bits DAC is used with range 0
59. ingsType m Control M Trigger Settings M Control Settings Flashes per Scan RN Laser delay p m Laser width o o E Laser wavelength jooo m Spectra stored ta RAM po Trigger mode Hardware IV Software Trigger source w External Synchronized Trigger type v Edge I Level The parameters in the measurement structure have been briefly described in section 2 4 In this section a more detailed description will be given 3 2 1 Measurement structure Start and Stoppixel The start and stoppixel are the first and last pixel to be sent to the PC The full range for a spectrometer is between startpixel 0 and stoppixel NrOfPixels 1 where NrOfPixels specifies the total pixels available for the detectortype used in the spectrometer see also AVS GetNumPixels If the wavelength range of a spectrometer exceeds 1100nm 1160nm for the AvaSpec 2048x14 and the detectortype 1s different from HAMS9201 AvaSpec NIR the stoppixel can be set to the pixelnumber that corresponds to a wavelength of 1100 1160 nm because the sensitivity is almost zero at this wavelength range Reducing the range increases the data transfer speed and allows you to transfer only the data that 1s relevant to the application Note that if m StartPixel is not equal to zero then a pSpectrum n see AVS GetScopeData represents the measured data at pixel number m StartPixel n Also pSaturated n see AVS GetSaturatedPixels represents pixel number m St
60. ion 2 4 In this section a more detailed description will be given The Borland C and Delphi sample programs display most of the parameters in the structure The Structure Length m Len Structure Version m ConfigVersion and InfoString m aUserFriendlyId 64 are shown on top of the tabs that correspond to the structures that are used to group the parameters into the following categories 3 6 EEProm DetectorType m Detector IrradianceType m Irradiance SpectrumCalibrationType m Reflectance SpectrumCorrectionType m SpectrumCorrect StandaloneType m StandAlone TempSensorType m Temperature 3 TecControlType m TecControl ProcessControlType m_ProcessControl not displayed in sample program 01x Structure Length 53484 bytes Structure Version E Information 070203301 Detector StandAlone Irradiance Calibration Reflectance Calibration Spectrum Correction Temperature Sensors Tec Control The structure version is used internally to maintain compatible between different versions of the dll and firmware The Information character string can be used e g to write a user friendly name for the spectrometer 3 6 1 EEProm structure Detector Parameters Detector StandAlone Inadiance Calibration Reflectance Calibration Spectrum Correctio Nonlinearity Calibrt The detector parameters are defined in the DetectorType jes x anes esc structure which includes the following
61. it ADC mode and 1 0 when running in 14bit ADC mode In 16bit ADC mode the measured counts will be a factor 4 higher than in 14bit mode or with a 14 bit ADC Therefore the same pixel of the same spectrometer in this example returns 4 300 1200 Counts for darkdata and 4 14000 56000 Counts at a certain light intensity The AD Counts corrected for dark therefore becomes 54800 The Normalized Counts Per Second can be calculated from the polynomial NCPS m aNLCorrect 0 m aNLCorrect 1 ADCFactor 54800 m aNLCorrect 2 ADCFactor 54800 m aNLCorrect 3 ADCFactor 54800 m aNLCorrect 4 ADCFactor 54800 m aNLCorrect 5 ADCFactor 54800 m aNLCorrect 6 ADCFactor 54800 m aNLCorrect 7 ADCFactor 54800 0 97741 Q The AD Counts value corrected for linearity and dark becomes 54800 0 97741 56067 Counts The AD Counts value corrected for linearity only not for dark becomes 56067 1200 57267 Counts Using the m aLowNL Counts and m aHighNL Counts parameters in 16bit mode also requires to include the ADCFactor when comparing the measured Counts to these parameters m aLowNLCounts 200 therefore if ADCFactor measured counts corrected for Dark lt 200 use NCPS 200 0 99203 else if ADCFactor measured counts corrected for Dark gt 15500 use NCPS 15500 0 96099 else calculate NCPS as shown above In the example above all counts corrected fo
62. ixel i saved in application software IntensityCal i m Irradiance m IntensityCalib m aCalibConvers 1 CalInttime m Irradiance m IntensityCalib m CalInttime CurInttime ntegration time in measurement used in the PrepareMeasurement structure The equation for irradiance intensity at pixel i then becomes Inttimefactor CalInttime CurInttime Irradiance Intensity Inttimefactor ScopeData i DarkData 1 IntensityCal i If Scopedata i and Darkdata i are taken with the 16bit ADC Counts range see also section 2 3 36 function AVS_UseHighResAdc an additional ADCFactor needs to be added to the equation above because the intensity calibration if performed by Avantes or by using AvaSoft application software is always recorded in 14bit mode The value of ADCFactor becomes 0 25 when running in 16bit ADC mode and 1 0 when running in 14bit ADC mode The equation becomes Irradiance Intensity ADCFactor Inttimefactor ScopeData i DarkData 1 IntensityCal 1 The Reflectance Calibration data can be used to convert the scopedata into a Reflectance or Absorbance spectrum The Spectrum Correction data can be used to correct the spectral data e g for Pixel Response Non Uniformity PRNU or for temperature effects The Reflectance and Correction arrays are not yet used for calibration purposes by Avantes Oct 07 AS 5216 DLL Manual doc 55 Avantes website http www avantes com email Info avantes com cy nte
63. l to AVS Measure in as161 dll results in returning the first available scan see section 2 2 of the as161 dll manual The USB2 platform spectrometers are in idle mode if not scanning and will start a scan if a measurement request AVS Measure from the as5216 dll 1s received 2 Number of measurements The AVS Measure function in as161 dll always results in one single scan A spectrum is only sent to the PC if a measurement request is received The AVS Measure function in as5216 dll includes a nrms argument which specifies the number of measurements the spectrometer should perform after one measurement request 3 Stopping a measurement A measurement in as161 dll cannot be interrupted After a measurement request the application must wait for the response before changing measurement parameters or sending other commands to the spectrometer The as5216 dll includes a function AVS StopMeasure that can be called to interrupt a measurement request 4 Spectrometer not blocked while measurement is pending With the USB1 platform spectrometers the spectrometer is blocked for receiving commands as long as a measurement is pending A measurement is pending between the call to AVS Measure and the DATA READY message from the as161 dll to the application The USB2 platform spectrometers are not blocked from receiving commands while a measurement is pending This means that you can e g control the digital and analog IO ports while a measurement is pending
64. make this manual as complete and as accurate as possible but no warranty or fitness is implied The information provided is on an as is basis Avantes bv shall have neither liability nor responsibility to any person or entity with respect to any loss or damages arising from the information contained in this manual 2 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes Software License THE INFORMATION AND CODE PROVIDED HEREUNDER COLLECTIVELY REFERRED TO AS SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE IN NO EVENT SHALL AVANTES BV OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT INDIRECT INCIDENTAL CONSEQUENTIAL LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES EVEN IF AVANTES BV OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY This Software gives you the ability to write applications to acquire and process data from Avantes equipment You have the right to redistribute the libraries contained in the Software subject to the following conditions 1 You are developing applications to control Avantes equipment If you use the code contained herein
65. meters IrradianceType m Irradiance intensity calibration parameters SpectrumCalibrationType m Reflectance reflectance calibration parameters SpectrumCorrectionType m SpectrumCorrect correction parameters StandaloneType m StandAlone stand alone related parameters e g measure mode control TempSensorType m Temperature 3 calibration parameters of three temperature sensors TecControlType m TecControl TecControl parameters ProcessControlType m ProcessControl ProcessControl parameters unsigned char m aReserved 13832 makes structure size equal to 63484 bytes Size 63484 DeviceStatus enum UNKNOWN 0 initial state AVAILABLE 1 device is connected to PC and not in use IN_USE_BY_APPLICATION 2 device is connected to PC and in use by caller IN USE BY OTHER 3 device is connected to PC and in use by other application Oct 07 AS 5216 DLL Manual doc 33 Avantes website http www avantes com email Info avantes com ay ntes Type Format Value Range Description DetectorType struct Sensor configuration structure SensorType m_SensorType sensor identification unsigned short float bool double double double float float float float unsigned short m_NrPixels m aFit 5 m NLEnable m aNLCorrect 8 m aLowNLCounts m aHighNL Counts m Gain 2 m Reserved m Offset 2 m ExtOffset m DefectivePixels 30 0 4096 1 5 7 0 350 0 350 0 0 2 0 number of pixels of se
66. n All USB2 platform spectrometers can be connected by a SYNC cable In syncmode one spectrometer is configured as Master all other slave spectrometers are set into Trigger by SYNC mode After a measurement request for the slave spectrometer s these spectrometers will wait until they receive the trigger signal on the SYNC cable This SYNC signal will be started if a measurement request is posted for the Master spectrometer 1 5 3 Laser control and integration time delay e g for LIBS If the AvaSpec 2048FT USBI platform is set in external hardware trigger mode an external trigger pulse results in an output signal pulse width 15 us at pin2 of the DB15 connector DO2 about 1 3 us after the trigger pulse was received The pulse at DO2 can be used to fire a laser in a LIBS application The function AVS SetIntegrationDelay can be used to specify an integration time delay which is related to DO2 With the AvaSpec 2048 USB2 and AvaSpec 3648 USB2 this feature has been improved at the following points 1 Not limited to external trigger mode The output signal and integration delay can be generated in external trigger mode but also in normal software trigger mode 2 Multiple measurements The number of measurements can be set by the nrms parameter in the AVS Measure function 3 Pulse width The laserpulse width at pin 23 of the DB26 connector can be set by the user between 0 and 1 ms 21 nanosec steps
67. n be programmed for these 6 digital output ports 3 SDCard support If the spectrometer was ordered with an SDxxx card the function AVS SaveSpectraToSDCard can be used to save spectra at the SDCard To access the files that are saved at the SDCard the functions AVS GetFileSize AVS_GetFile AVS GetFirstFile AVS GetNextFile and AVS DeleteFile can be used 4 Eeprom IO With the USB1 platform spectrometers it is also possible to read write a number of parameters from to Eeprom with the as161 dll such as start and stoppixel AVS GetStartStopPixel and AVS SetStartStopPixel wavelength calibration coefficients AVS GetWLCoef and AVS SetWLCoef gain AVS GetGain and AVS SetGain and offset AVS GetOffset and AVS SetOffset The Eeprom for the USB2 spectrometers has a lot more memory available to store all kind of parameters These parameters have been defined in the DeviceConfigType structure see section 2 4 The functions AVS GetParameter and AVS SetParameter in as5216 dll can be used to read write the DeviceConfigType structure from to Eeprom 12 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes The interface from the PC to the DLL is based on a function interface The interface allows the application to configure a spectrometer and to receive and send data from and to the spectrometer 2 AS 5216 DLL description 2 1 Interface overview 2 2 Usage AS 5216 DLL The DLL uses a singl
68. nd m_aHighNLCounts parameters can be used to limit the range for the correction in counts for which the polynomial should be applied The use of polynomials beyond the range of measured data points can give erratic corrections In AvaSoft Avantes uses the same 52 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes correction factor NCPS for measured counts corrected for dark that are lower than m aLowNLCounts as is used for m aLowNLCounts and for counts higher than m aHighNL Counts the same NCPS as is used for m aHighNL Counts In the example above NCPS 200 0 99203 and all counts lt 200 will be corrected in AvaSoft by dividing through 0 99203 Likewise NCPS 15500 0 96099 and all counts gt 15500 will be corrected in AvaSoft by dividing through 0 96099 All counts 200 counts 15500 will be corrected by the NCPS calculated by the polynomial Using the nonlinearity correction polynomial in combination with the 16bit ADC Counts range see also section 2 3 36 function AVS UseHighResAdc does require a small modification in your application software since the polynomial was recorded in 14bit mode and therefore should be applied to a 14bit range when calculating the NCPS This will be illustrated by introducing the variable ADCFactor to the equations that are used in the correction same example as above same polynomial The value of ADCFactor becomes 0 25 when running in 16b
69. nsor polynomial coefficients needed to determine wavelength enable disable nonlinearity correction polynomial coefficients needed for non linearity correction lower counts limit for nonlinearity correction higher counts limit for nonlinearity correction gain correction for spectrometer ADC range is divided in 64 steps not used offset correction for spectrometer ADC in Volt range is divided in 512 steps offset to match the detector output range with the ADC range defective pixel numbers Size 188 bytes IrradianceType struct SpectrumCalibrationType m_IntensityCalib unsigned char unsigned int m_CalibrationType m_FiberDiameter Setting during intensity calibration Bare fiber diffusor integrating sphere Fiber diameter during intensity calibration Size 16391 1 4 16396 bytes 34 Avantes AS 5216 DLL Manual doc website http www avantes com Oct 07 email Info avantes com cy ntes Type Format Value Range Description MeasConfig struct Type unsigned short m StartPixel 0 4095 first pixel to be sent to PC unsigned short m StopPixel 0 4095 last pixel to be sent to PC float m IntegrationTime 0 01 600000 integration time in ms unsigned int m IntegrationDelay 0 OxFFFFFFFF integration delay unit is internal FPGA clock cycle 0 one unit before laser start unsigned int m_NrAverages 1 OxFFFFFFFF number of averag
70. nto a different folder click Browse and select another folder You can choose not to install 4S 5216 DLL interface package In the next dialog the by clicking Cancel to exit Setup destination directory for the AS5216 DLL software can be changed The default destination directory 1s C AS5216 DLL_ 1 4 If you want to install the software to a different directory click the Browse button select a new directory and click OK If the specified directory does not exist it will be created Destination Folder CNASS215 DLL 1 4 Browse Cancel lt Back x This installation is password protected Enter the following password to proceed with the installation This installation is password protected Please enter the installation password into the field below Avantes6961LL4a Password Press the OK button to continue Press Cancel to abort the installation cone 6 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com ay ntes During this installation the installation program will check 1f the most recent USB driver has been installed already at the PC If no driver 1s found or if the driver needs to be upgraded the Device Driver Installation Wizard is launched automatically click Next If the Operating System is Windows Vista it will display a message that it can t verify the publisher of the driver software select Install this driver software any
71. ocated buffer size too small ERR INVALID PIXEL RANGE 10 Measurement preparation failed because pixel range is invalid ERR INVALID INT TIME 11 Measurement preparation failed because integration time is invalid for selected sensor ERR INVALID COMBINATION 12 Measurement preparation failed because of an invalid combination of parameters e g integration time of 600000 and Navg gt 5000 Reserved 13 ERR NO MEAS BUFFER AVAIL 14 Measurement preparation failed because no measurement buffers available ERR_UNKNOWN 15 Unknown error reason received from spectrometer ERR COMMUNICATION 16 Error in communication occured ERR NO SPECTRA IN RAM 17 No more spectra available in RAM all read or measurement not started yet ERR INVALID DLL VERSION 18 DLL version information can not be retrieved ERR NO MEMORY 19 Memory allocation error in the DLL ERR DLL INITIALISATION 20 Function called before AVS Init is called ERR INVALID STATE 21 Function failed because AS5216 is in wrong state e g AVS StartMeasurement while measurement is pending ERR INVALID PARAMETER NR PIXEL 100 NrOfPixel in Device data incorrect ERR INVALID PARAMETER ADC GAIN 101 Gain Setting Out of Range ERR INVALID PARAMETER ADC OFFSET 102 OffSet Setting Out of Range ERR INVALID MEASPARAM AVG SAT2 110 Use of Saturation Detection Level 2 is not 38 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes
72. onnected before the Found New Hardware Wizard will need to install the software for this port as well For this reason this Wizard will run NrOfChannel times for a multichannel AvaSpec USB2 spectrometer system This happens because inside the housing the USB ports for each spectrometer channel are connected to a USB Hub Click Finish to close the wizard lt Back j Cancel Windows Vista will install the driver automatically without displaying the Found New Hardware Wizard dialogs Launching the software This AS 5216 DLL manual and several example programs can be started from the Windows Start Menu The source code of the example programs can be found in the Examples folder Oct 07 AS 5216 DLL Manual doc 7 Avantes website http www avantes com email Info avantes com Back Cancel cy ntes 1 Version History This section will be used to describe the new features in the as5216 dll compared to the previous versions 1 1 New in version 1 4 0 0 8 Avantes Implementation of the StoreToRam function which allows the storing of scans at high speed as fast as 1 1 msecs per scan for the AvaSpec 2048 USB2 and 0 1 msecs per scan for the AvaSpec 102 USB2 in the spectrometer without the overhead of USB communication About 4MB of storage 1s available which allows for 1013 full spectra with the AvaSpec 2048 USB2 and 19784 for the AvaSpec 102 USB2 or a lot more if the pixelrange is redu
73. r dark lt 800 will be corrected in AvaSoft by dividing through 0 99203 Likewise all counts corrected for dark gt 62000 will be corrected in AvaSoft by dividing through 0 96099 All counts corrected for dark 800 lt counts lt 62000 will be corrected by the NCPS calculated by the polynomial Gain and Offset These parameters have been optimized by Avantes and there should be no need to change these values The m Gain and m Offset parameters are used to optimize the Gain and Offset of the AD Converter Most spectrometers use only the m Gain 0 and m Offset 0 Only the NIR2 2 with 2stage TE Cooling uses the m Gain 1 and m Offset 1 The m ExtOffset parameter is used to be able to match the detector output range with the ADC range Oct 07 AS 5216 DLL Manual doc 53 Avantes website http www avantes com email Info avantes com Defective Pixels AVS GetNumPixels cy ntes The m DefectivePixels 30 array can be used to store the pixelnumbers that should be eliminated from the data transfer The as5216 dll will calculate the data for a defective pixel by interpolating the data of the neigbor pixels A defective pixel can be specified in the range from 0 to NrOfPixels 1 where NrOfPixels specifies the total pixels available for the detectortype used in the spectrometer see also The as5216 dll evaluates the array m DefectivePixels i inan increasing order until a pixel is specified which is equal or larger than the number of pixel
74. s 3 6 4 EEProm structure Temperature Sensors The as5216 boards are prepared for using up to three thermistors NTC1 is mounted on the board NTC2 is not mounted and the third thermistor 1s 1n the NIR2 2 detector The voltage level of the thermistors can be retrieved by calling the AVS GetAnaloglIn function see also section 2 3 16 and 3 5 The structure TempSensorType can hold the coefficients for a polynomial that converts the voltage level into a temperature Detector Standalone Irradiance Calibration Reflectance Calibration Spectrum Correction Temperature Sensors Tec Control NTC1 Calibration NTC2Calbraion p Thermistor Calibration ps 1 1868976E 2 Intercept n o000000E 0 Intercept 5s700mE x1 7o05 x1 ooooon n x1 2048000061 x2 2 1019672E 1 x2 o o000000E 0 x2 o o000000E 0 x3 3644271460 x3 o ooo0000E 0 x3 o ooo0000E 0 x4 i590 x4 o o000000E 0 x4 o o000000E 0 3 6 5 EEProm structure Tec Control Detector Standalone Inadiance Calibration Reflectance Calibration Spectrum Correction Temperature Sensors Tec Control Enable SetPoint 20 0 degree C DAC Coefficients xo fi 510 xi o0 The TecControl parameters are used to control the cooling of the detector in the AvaSpec 256 NIR2 2 For this spectrometer the m Enable flag will always be set to true The default
75. s in the detector 3 6 2 The StandaloneType structure includes a boolean m Enable which is not used in the standard version but which can be used for user specific standalone functionality The Measurement parameters are also included in this structure as well as the Number of Measurements parameter m Nmsr Finally the SDCardType structure has been added to have storage space available to store dark and reference and scopemode Spectra EEProm structure Standalone Parameters Enable Measurement Settings Start pixel 0 m Dark Correction Settings Stop pixel 127 Enable o P Integration time 0 50 m Integration Delay 21 ns r Smoothing Settings 3 Number of averages 1 Model 0 Saturation detection 0 Nr Of Pixels D Trigger Settings 4 Control Settings Trigger mode Hardware Flashes per Scan 0 Iv Software Laser delay 0 n Trigger source V Extemal Lore villi 0 5 Synchronized Laser wavelength 0 000 p T ggertype V Edge j A r Level Spectra stored ta RAM 10 Nr Of Measurements 1 1 Detector Stand lone Inadiance Calibration Reflectance Calibration Spectrum Correction Temperature Sensors SDCard Settings Enable Spectrum Type FileRootN ame r TimeStamp 3j p DateNr 13338 Day 0 31 pc Month 1 12 E Years 1980 e TimeNr 30836 0 5 Sec 0 30 jo Minutes 0 59
76. ters Return bool AVS Register HWND a hWnd Blocking control function Installs an application windows handle to which device attachment removal messages have to be sent a hWnd Application window handle true Registration successful false registration failed or function not supported on OS 2 3 8 AVS PrepareMeasure Function Group Description Parameters Return int AVS PrepareMeasure AvsHandle a hDevice MeasConfigType a pMeasConfig Blocking data write function Prepares measurement on the spectrometer using the specified measurement configuration a hDevice Device identifier returned by AVS_ Activate a pMeasConfig pointer to structure containing measurement configuration On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID PARAMETER ERR INVALID PIXEL RANGE ERR INVALID CONFIGURATION invalid fpga type 2 3 9 AVS Measure Function Group Description Parameters 16 Avantes ERR TIMEOUT int AVS Measure AvsHandle a hDevice HWND a hWnd short a Nmsr Non Blocking data write function Starts measurement on the spectrometer a hDevice device identifier returned by AVS_ Activate AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com Return cy ntes a hWnd window handle to notify application measurement result data 1s available The DLL sends a message to the window with command WM MEAS REA
77. that this table shows the optimal smoothing without losing resolution If resolution is not an important issue a higher smoothing parameter can be set to decrease noise at the price of less resolution Slitor AvaSpec 102 AvaSpec 128 AvaSpec 256 AvaSpec 2048 AvaSpec 3648 AvaSpec Fiber AvaSpec 1024 AvaSpec 2048x14 NIR256 Pixel 77 um Pixel 63 5 um Pixel 25 um Pixel 14 um Pixel 8 um Pixel 50 um lOum na n a n a 0 0 n a 25um n a n a 0 0 1 1 n a 50um 0 0 0 1 1 2 2 3 0 100um 0 1 0 1 1 2 3 5 6 0 1 200um 1 1 3 4 6 7 12 1 2 400um 2 2 3 7 8 13 14 24 25 3 4 500um 3 3 4 9 10 17 31 4 5 600um 3 4 4 11 12 21 37 5 6 44 AS 5216 DLL Manual doc Oct 07 Avantes website http www avantes com email Info avantes com cy ntes 3 2 7 Measurement structure Saturation Detection The 16 bit A D converter in the AvaSpec results in raw Scope pixel values between 0 and 65535 counts If the value of 65535 counts is measured at one or more pixels then these pixels are called to be saturated or overexposed Saturation detection can be set off m_SaturationDetection 0 or on m_SaturationDetection 1 Saturation detection is done by the as5216 dll after a measurement result has been sent to the PC If a measurement is the result of a number of averages the as5216 dll can only detect saturation if all NrOfAverage scans in a measurement were saturated for one or more pixels Only for AvaSpe
78. to digital input status 0 1 On success ERR SUCCESS a pDiglIn contains valid value On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID PARAMETER invalid digital input id ERR TIMEOUT error in communication 2 3 18 AVS GetVersionInfo Function Group Description Parameters Return 20 Avantes int AVS GetVersionInfo AvsHandle a hDevice unsigned char a pFPGAVersion unsigned char a pFirmwareVersion unsigned char a pDLL Version Blocking read function Returns the status of the software version of the different parts DLL does not check the size of the buffers allocated by the caller a hDevice device identifier returned by AVS_ Activate a pFPGAVersion pointer to buffer to store FPGA software version 16 char a pFirmwareVersion pointer to buffer to store Microcontroller software version 16 char a pDLL Version pointer to buffer to store DLL software version 16 char On success ERR SUCCESS buffer contains valid value AS 5216 DLL Manual doc Oct 07 website http www avantes com email Info avantes com cy ntes On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication 2 3 19 AVS GetFileSize Function Group Description Parameters Return int AVS GetFileSize AvsHandle a hDevice unsigned char a pName unsigned int a pSize Blocking read function Returns the file size in bytes 1f the file can b
79. ved ERR OPERATION NOT SUPPORTED ERR OPERATION NOT ENABLED 2 3 16 AVS GetAnalogIn Function Group Description Parameters Oct 07 Avantes int AVS GetAnalogIn AvsHandle a hDevice unsigned char a AnalogInlId float a pAnalogIn Blocking control function Returns the status of the specified analog input a hDevice device identifier returned by AVS_ Activate a AnalogInId identifier of analog input 0 thermistor on optical bench NIR2 2 1 1V2 2 5VIO 3 5VUSB 4 AI pin 18 at 26 pins connector 5 All pin 9 at 26 pins connector 6 NTCI onboard thermistor 7 Not used AS 5216 DLL Manual doc 19 website http www avantes com email Info avantes com Return cy ntes a pAnalogIn pointer to float for analog input value Volts On success ERR SUCCESS On error ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR INVALID PARAMETER invalid analog input id ERR TIMEOUT error in communication 2 3 17 AVS GetDigIn Function Group Description Parameters Return int AVS GetDigIn AvsHandle a hDevice unsigned char a DigInId unsigned char a pDigIn Blocking control function Returns the status of the specified digital input a hDevice device identifier returned by AVS_ Activate a DiglInld identifier of digital input 1 3 0 DII Pin 24 at 26 pins connector 1 DI2 Pin 7 at 26 pins connector 2 DB Pin 16 at 26 pins connector a pDigln pointer
80. way Device Driver Installation Wizard Device Driver Installation Wizard Welcome to the Device Driver Installation Wizard This wizard helps you install the software drivers that some computers devices need in order to work Completing the Device Driver Installation Wizard The drivers were successfully installed on this computer came with instructions please read them first Driver Name Status You can now connect your device to this computer If your device v Avantes AvaSpec USB2 Ready to use To continue click Next lt Back After the drivers have been installed successfully the dialog at the right is displayed click Finish After all files have been installed the Installation Complete dialog shows up Click Finish Connecting the hardware Connect the USB connector to a USB port on your computer with the supplied USB cable Windows XP will display the Found New Hardware dialog Select the default option to install the software automatically and click next After the Hardware Wizard has completed the following dialog is displayed under Windows XP Found New Hardware Wizard Completing the Found New Hardware Wizard Click Finish to complete the installation The wizard has finished installing the software for Bal AvaSpec USB2 Please note that if the spectrometer is Connected to another USB port to which it has not been c
81. y can be set with 20 83 nanoseconds steps See also section 3 2 9 about using the integration delay in combination with the control settings laser delay and pulse width 3 2 4 Measurement structure Number of Averages The signal to noise ratio of the scope data is improved by the square root of NrOfAverage Averaging is done by the microcontroller at the as5216 board therefore no time is lost by sending the individual scans from the spectrometer to the PC 3 2 5 Measurement structure Dynamic Dark Correction The pixels of the CCD detector AvaSpec 2048 3648 2048x14 are thermally sensitive which causes a small dark current even without light exposure To get an approximation of this dark current the signal of the first 14 optical black pixels of the CCD detector can be taken and subtracted from the raw scope data This will happen if the correct for dynamic dark option is enabled As these 14 pixels have the same thermal behaviour as the active pixels the correction is dynamic The Dark Correction Type structure includes an m enable and m ForgetPercentage field see also section 2 4 Measurements have shown that taking into account the historical dark scans does not make much difference The recommended value for m ForgetPercentage is therefore 100 Oct 07 AS 5216 DLL Manual doc 43 Avantes website http www avantes com email Info avantes com cy ntes 3 2 6 Measurement structure Smoothing The smoothing type structure includ
82. yCycle Blocking data send function Selects the PWM functionality for the specified digital output a hDevice a PortId a Frequency a DutyCycle On success On error device identifier returned by AVS_ Activate identifier for one of the 6 PWM output signals 0 DOI pin 11 at 26 pins connector DO2 pin 2 at 26 pins connector 2 DO3 pin 20 at 26 pins connector 4 DOS pin 3 at 26 pins connector 5 DO6 pin 21 at 26 pins connector 6 DO7 pin 13 at 26 pins connector desired PWM frequency 500 300000 Hz the frequency of outputs 0 1 and 2 is the same the last specified frequency is used also the frequency of outputs 4 5 and 6 is the same percentage high time in one cycle 0 100 channels 0 1 and 2 have a synchronised rising edge the same holds for channels 4 5 and 6 ERR SUCCESS ERR DEVICE NOT FOUND ERR INVALID DEVICE ID ERR TIMEOUT error in communication ERR INVALID PARAMETER AS 5216 DLL Manual doc 27 website http www avantes com email Info avantes com cy ntes 2 3 33 AVS SetSyncMode Function Group Description Parameters Return int AVS SetSyncMode AvsHandle a hDevice unsigned char a Enable Internal DLL write function Disables enables support for synchronous measurement DLL takes care of dividing Nmsr request into Nmsr number of single measurement requests Note this function should only be called for the master spectrometer a hDevic

AS-5216-DLL - Pembroke Instruments

Contents

Download Pdf Manuals

Related Search

Related Contents