Home

Series 4000 Programmers Reference

1. aDC EDE CURRent2 DC VOLTage2 DC Tiate IMMediate 23 TEMPerature CURR MESI DEE VOLTage3 DC POWer4 gt TSENsSor sCURReme 1 se VOLTAGE DC CURRent2 DC POWer2 s VOLTAGE 3 DC POWer3 BONE AIMI READ 25 MEASure SCALar 25 TUM MPerec teu mei CURR MESI DEE VOLTage3 DC POWer4 SENS Cae SCURIREGiae iL 3 DC 2 2012 Thorlabs 3 Commands by Subsystem Description Configures instrument for LD current measurement Configures instrument for LD voltage measurement Configures instrument for PD current measurement Configures instrument for for power measurement via photodiode Configures instrument for thermopile power meter voltage measurement Configures instrument for power measurement via thermopile power meter Configures instrument for LD electrical input power measurement Returns the current configuration Starts measurement Returns the last measurement data The data returned is the data configured with the last CONFigure SCALar or the last MEASure SCALar Command Returns the last measured temperature Returns the last measured TEC current Returns the last measured TEC voltage Returns the last measured TEC power Returns the last measured temperature sensor signal Returns the last measured LD current Returns the last measured LD voltage Returns the last measured PD current Returns the las
2. Syntax OUTPut 1 PROTection EXTernal MODE OFF PROTection ENABle OUTPut 1 PROTection EXTernal MODE Description The OUTPut 1 PROTection EXTernal MODE Command sets the function of the rear panel LD ENABLE input 2012 Thorlabs 29 Series 4000 SCPI Programmers Reference Manual Parameter Description OFF The LD ENABLE input is ignored and has no effect PROTection Acts as protection input inhibit functionality A TTL low level switches the LD output off ENABle Acts as enable input A TTL low level disables the LD output temporarily Example OUTP PROT EXT ENAB Sets the LD ENABLE input mode to output enable mode This command is valid for LDC4000 and ITC4000 Series instruments only 3 4 7 Protection Queries Syntax OUTPut 1 PROTection VOLTage TRIPped OUTPut 1 PROTection EXTernal TRIPped OUTPut 1 PROTection INTernal TRIPped OUTPut 1 PROTection INTLock TRIPped OUTPut 1 PROTection KEYLock TRIPped OUTPut 1 PROTection OTEMp TRIPped Description The outTPut 1 PROTection VOLTage TRIPped query command returns 1 if the LD output protection voltage was reached The ouTPut 1 PROTection EXTernal TRIPped query command returns 1 if the LD ENABLE input has a TTL low level The oOUTPut 1 PROTection INTernal TRIPped query command returns 1 if the temperature window protection is currently active Th
3. Example TRIG SOUR INT Sets the trigger source for QCW pulses to the internal pulse generator TRIG SOUR EXT Sets the trigger source for QCW pulses to the rear panel BNC connector TRIG SOUR Queries the trigger source for QCW pulses INT The response is either INT or EXT This command is valid for LDC4000 and ITC4000 Series instruments only 3 11 TEC Source Commands The souRce 1 2 subsystem controls the TEC source part of the instrument These commands are valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 Table 15 TEC Source Commands Command Description SOuRee 1 24 Path to TED source function FUNCt ion 51 MODE 151 TEMPerature CURRent Set function CURRent LIMit AMPLitude si MIN MAX Set limit current value lt amps gt LIMit AMPLitude s1 MIN MAX Return limit current value 2012 Thorlabs 49 Series 4000 SCPI Programmers Reference Manual Command elinvel ils MIN MAX lt amps gt liave MIN MAX TEMPerature SPOint 53 MJ lt temperature gt SLI Mit 52 N MAX DEF IMMediate AMPLitude 52 IMMediate AMPLitude 52 HIGH 521 MIN MAX lt temperature gt oes LCONstants 53 Io INTe
4. Table 21 Measurement Register Group Bit Number Decimal Value 0 1 1 2 2 4 3 8 4 16 5 32 6 64 7 128 8 256 9 512 10 1024 11 2048 12 4096 13 8192 14 16384 15 32768 2012 Thorlabs Definition keylock protection active LD compliance voltage LDC ITC LD interlock active LDC ITC LD current limit reached LDC ITC LD output inhibit active LDC ITC LD power limit reached LDC ITC not used not used Temperature protection active TED ITC Temperature window failure TED ITC Temperature sensor failure TED ITC TEC compliance voltage reached TED ITC TEC connection failure TED ITC not used Over temperature reserved 67 Series 4000 SCPI Programmers Reference Manual For more information on the SCPI Status System for Thorlabs 4000 Series instruments see chapter Programming and Reading Registers 51 3 14 4 Questionable Register Group Syntax STATus QUEStionable EVENt STATus QUEStionable CONDition STATus QUEStionable PTRansition lt value gt STATus QUEStionable PTRansition STATus QUEStionable NTRansition lt value gt STATus QUEStionable NTRansition STATus QUEStionable ENABle lt value gt STATus QUEStionable ENABle Description The STATus QUEStionable commands and queries handle the registers of the Questionable Register Group Table 22 Questionable Register Group Bit Number Decimal Value Definition 0 1 Questionabl
5. This command performs a previously configured measurement and stores the reading in memory Example The following program segment configures a TED4000 ITC4000 Series Instrument for temperature measurements and performs one measurement CONF TEMP Co INI nfigure the instrument for temperature measurement T Pe rform the measurement and store reading in memory FETC Transfer reading from memory to instrument s output buffer 2 500000E 01 Typical response 3 3 4 Fetch a Measurement Syntax For TED4000 Series instruments F ETCH F ETCh TI EMPerature 2012 Thorlabs FAD command 3 Commands by Subsystem 23 Series 4000 SCPI Programmers Reference Manual FETCh CURRent 1 FETCh VOLTage 1 FETCh POWer 1 FETCh TSENsSor DC DC a For LDC4000 Series instruments ETC ETC ETC ETC ETC ETC ETC ETG mj oj j j a a o CURRent 1 VOLTage 1 CURRent2 POWer2 VOLTage2 POWer3 POWer 1 nu DC DC DC i DC For ITC4000 Series instruments FETCh FETCh TEMPerature FETCh CURRent3 DC FETCh VOLTage3 DC FETCh POWer4 FETCh TSENsor FETCh CURRent 1 DC FETCh VOLTage 1 DC FETCh CURRent2 DC FETCh POWer2 FETCh VOLTage2 DC FETCh POWer3 FETCh POWer 1 Description This command trans
6. 2 TEMPerature LCONstants PERiod MIN MAX DEF lt value gt SOURce 1 2 TEMPerature LCONstants PERiod MIN MAX DEF Description The sSoURce 1 2 TEMPerature LCONstants commands control the instrument PID temperature control loop The gain value proportional is in 4 its default value is 1 0 The integral value is in 4 its default value is 0 1 The derivative value is in A s its default value is 0 The period value specifies the thermal load oscillation period in seconds s its default value is 1s 2012 Thorlabs 53 Series 4000 SCPI Programmers Reference Manual Example SOUR TEMP LCON GAIN 1 0 INT 0 1 DER 0 0 PER 1 0 Sets the PID control loop constants on a TED4000 Series instrument This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 3 11 7 PID Auto Tune Syntax SOURce 1 2 TEMPerature ATUNe INITiate SOURce 1 2 TEMPerature ATUNe CANCel SOURce 1 2 TEMPerature ATUNe STATe SOURce 1 2 TEMPerature ATUNe LCONStants GAIN SOURce 1 2 TEMPerature ATUNe LCONstants INTegral SOURce 1 2 TEMPerature ATUNe LCONstants DERivative SOURce 1 2 TEMPerature ATUNe LCONStants PERiod SOURce 1
7. Returns the last measurement data The data returned is the data configured with the last CONFigure SCALar or the last MEASure SCALar Command Returns the last measured LD current Returns the last measured LD voltage Returns the last measured PD current Returns the last measured optical power via PD Returns the last measured thermopile power meter voltage Returns the last measured optical power via thermopile power meter Returns the last measured LD input electrical power Starts new measurement and returns data Measures LD current Measures LD voltage Measures PD current Measures LD power via PD Measures thermopile power meter voltage Measures LD power via thermopile power meter Measures LD electrical input power Table 7 Measurement Commands for a ITC4000 Series Instrument Command A BORt 21 CONFigure SCALar 2t 18 POWer4 ZES ENSO TEMPerature SCURREeine 3 IDC VOLTage3 DC Description Aborts the current measurement Configures instrument for temperature measurement Configures instrument for TEC current measurement Configures instrument for TEC voltage measurement Configures instrument for TEC power measurement Configures instrument for temperature sensor signal measurement 2012 Thorlabs Command sSCURRE ioe IL VOLTage 1 POWer2 POWer3 POWer 1 CONFigure 2t N mj FETCh 23 ETCh 23
8. Table 32 Instrument Default Settings Parameter SCPI command to set parameter LDC operating mode SOURce 1 FUNCtion MODE 36 LDC amplitude modulation SOURce 1 AM STATe 40 LDC power feedback SOURce 1 POWer ALC SOURce 38 LDC power feedback bandwidth SOURce 1 POWer ALC BANDwidthl 391 LDC switch on delay OUTPut 1 DELay 271 LDC polarity OUTPut 1 POLarity 28 LDC current limit SOURce 1 CURRent LIMit AMPLitude 37 LDC photodiode current protection SENSe 1 CURRent DC PROTection LEVel 43 LDC thermopile power meter protection SENSe2 VOLTage DC PROTection LEVel 46 LDC output voltage protection compliance voltage OUTPut 1 PROTection VOLTage LEVe1 28 LDC photodiode polarity INPut 1 POLarity 3i LDC photodiode current range SENSe 1 CURRent DC RANGe UPPer 43 LDC path for photodiode input routing INPut 1 ROUTe TERMinals 33 LDC photodiode BIAS state INPut 1 BIAS STATe 3 2012 Thorlabs Default Value lt value gt Constant Current CURR OFF OFF Photodiode DIOD 100 Hz 100 2 seconds 2 cathode grounded CG e g 20 Amperes 20 e g 2 mA 2 0E 03 e g 1 Volt e g 1 Volt cathode grounded CG e g 20 mA 0 02 LASER OUTPUT D SUB connector DSUB no BIAS vol
9. Command Description SENSe2 Path to thermopile power meter sense subsystem VOLTage DC RANGe UPPer 46 MIN MAX lt amps gt Set thermopile power meter range RANGe UPPer 2 46 MIN MAX Return thermopile power meter range PROTection 46 LEVel MIN MAX DEF lt amps gt Set thermopile power meter voltage limit value LEVel MIN MAX DEF Return thermopile power meter voltage limit value TRIPed Return protection tripped CORRECTION 47 POWer PDIode RESPonse MIN MAX DEF lt amps gt Set thermopile power meter responsivity value in Y 2012 Thorlabs 45 Series 4000 SCPI Programmers Reference Manual Command Description POWer PDIode RESPonse MIN MAX DEF Return thermopile power meter responsivity value in Y PONET DC RANGe UPPer 47 MIN MAX lt watts gt Set thermopile power meter range in units of power RANGe UPPer l47 MIN MAX Return thermopile power meter range setting in units of power PROTectionl 48 LEVel MIN MAX DEF lt watts gt Set power limit value thermopile power meter LEVel MIN MAX DEF Return power limit value thermopile power meter ARTHO Return protection tripped 3 9 1 Thermopile Power Meter Voltage Range Syntax SENSe2 VOLTage DC RANGe UPPer MIN MAX lt v
10. LEVel IMMediate AMPLitude MIN MAX Description The SouRce 1 2 CURRent LEVel IMMediate AMPLitude command sets the TEC current setpoint in amperes in current source mode Example SOUR CURR 1 0 Sets the TEC element current to 1 0 Aon a TED4000 Series instrument SOUR2 CURR MAX Queries the maximum settable TEC element current setpoint of a ITC4000 Series instrument 1 500000E 01 Typical response This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 3 11 4 TEC Temperature Setpoint Limit Syntax SOURce 1 2 TEMPerature LIMit HIGH MIN MAX lt temperature gt SOURce 1 2 TEMPerature LIMit HIGH MIN MAX SOURce 1 2 TEMPerature LIMit LOW MIN MAX lt temperature gt SOURce 1 2 TEMPerature LIMit LOW MIN MAX Description The souRce 1 2 TEMPerature LIMit Commands set a user defined temperature setpoint range in the selected temperature unit Example SOUR TEMP LIM LOW 0 HIGH 70 Sets the temperature setpoint range to 0 70 on a TED4000 Series instrument This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 52 2012 T
11. MIN MAX DEF lt watts gt SENSe2 POWer DC PROTection LEVel MIN MAX DEF SENSe2 POWer DC PROTection TRIPped Description The SENSe2 POWer DC PROTection LEVel command sets the power limit value The SENSe2 POWer DC PROTection TRIPped query command returns an ASCII 1 if the power limit value is currently reached or an ASCII 0 if the power is currently below that limit Example SENS POW PROT 0 511 Sets the power limit to 511 0 mW This command is valid for LDC4000 and ITC4000 Series instruments only 3 10 QCW Pulse Trigger Commands The TRIGger 1 subsystem controls the QCW mode triggering of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only For LDC4000 and ITC4000 Series instruments the command suffix is 1 can be omitted Table 14 QCW Pulse Trigger Commands Command Description ITRIGGEF Path to trigger functions SEQuence SOURcel 48 INTernal EXTernal Set the trigger source TRIGger SEQuence SOURce 481 Return the trigger source 48 2012 Thorlabs 3 Commands by Subsystem 3 10 1 QCW Trigger Source Syntax TRIGger SEQuence SOURce INTernal EXTernal TRIGger SEQuence SOURce Description The TRIGger SEQuence SOURce command sets the source for the QCW pulse trigger to either internal pulse generator or external pulse source connected through a rear panel BNC connector
12. SENSe 1 CURRent DC PROTection LEVel MIN MAX DEF lt amps gt SENSe 1 CURRent DC PROTection LEVel MIN MAX DEF SENSe 1 CURRent DC PROTection TRIPped Description The SENSe 1 CURRent DC PROTection LEVel command sets the photodiode current limit value The SENSe 1 CURRent DC PROTection TRIPped query command returns an ASCII 1 if the photodiode current limit value is currently reached or an ASCII 0 if the photodiode current is currently below that limit Example SENS PROT 0 3mA Sets the photodiode current limit to 0 3 mA This command is valid for LDC4000 and ITC4000 Series instruments only 2012 Thorlabs 43 Series 4000 SCPI Programmers Reference Manual 3 8 3 Photodiode Responsivity Syntax SENSe 1 CURRent DC CORRection POWer PDIode RESPonse MIN MAX DEF lt amps gt SENSe 1 CURRent DC CORRection POWer PDIode RESPonse MIN MAX DEF Description The SENSe 1 CURRent DC CORRection POWer PDIode RESPonse Command sets the photodiode responsivity in w Example SENS CORR POW 511mA Sets the photodiode responsivity to 511 0 This command is valid for LDC4000 and ITC4000 Series instruments only 3 8 4 Photodiode Power Range Syntax SENSe 1 POWer DC RANGe UPPer MIN MAX lt watts gt SENSe 1 POWer DC RANGe UPPer
13. 01 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 2012 Thorlabs 37 Series 4000 SCPI Programmers Reference Manual 3 7 3 LD Current Setpoint Syntax SOURce 1 CURRent LEVel IMMediate AMPLitude MIN MAX lt amps gt SOURce 1 CURRent LEVel IMMediate AMPLitude MIN MAX Description The SOURce 1 CURRent LEVel IMMediate AMPLitude command sets the LD current setpoint in amperes in current source modes Example SOUR CURR 1 0 Sets the LD source current to 1 0 A on a LDC4000 Series or an ITC4000 Series instrument SOUR CURR MAX Queries the maximum settable LD source current setpoint of a LDC4000 Series or an ITC4000 Series instrument 2 000000E 01 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 7 4 LD Optical Power Syntax SOURce 1 POWer LEVel IMMediate AMPLitude MIN MAX lt watts gt SOURce 1 POWer LEVel IMMediate AMPLitude MIN MAX SOURce 1 POWer ALC SOURce DIODe PMETer SOURce 1 POWer ALC SOURce SOURce 1 POWer ALC BANDwidth MIN MAX DEF lt hertz gt SOURce 1 POWer ALC BANDwidth MIN MAX DEF SOURce 1 POWer LEVel DIODe CURRent IMMediate AMPLitude MIN MAX lt amps gt SOUR
14. 2 TEMPerature ATUNe LCONstants TRANSfer Description The souRce 1 2 TEMPerature ATUNe INITiate Starts the Auto PID procedure The souRce 1 2 TEMPerature ATUNe CANCel stops a running Auto PID procedure The SoURce 1 2 TEMPerature ATUNe STATe query retrieves information about a previously run Auto PID procedure The Auto PID state query response is state phase loop as numeric values where state reflects the current state phase shows the algorithm used and loop indicates the Auto PID progress State Description 0 Never run for this sensor configuration 1 Auto PID currently running 2 Canceled by user 3 Auto PID failed 4 Auto PID finished successfully Phase Description 0 Full tuning Auto PID procedure 1 Fine tuning Auto PID procedure The query commands SOURce 1 2 TEMPerature ATUNe LCONStants GAIN 54 2012 Thorlabs 3 Commands by Subsystem SOURce 1 2 TEMPerature ATUNe LCONstants INTegral SOURce 1 2 TEMPerature ATUNe LCONstants DERivative SOURce 1 2 TEMPerature ATUNe LCONStants PERiod read back the evaluated Auto PID loop constants You may pass the evaluated values to the PID temperature control loop using the command SOURce 1 2 TEMPerature ATUNe LCONstants TRANsfer This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instrum
15. 3 Thermopile Power Meter Responsivity Syntax ENSe2 VOLTage DC CORRection POWer THERmopile RESPonse MIN MAX DEF lt volts gt SENSe2 Voltage DC CORRection POWer THERmopile RESPonse MIN MAX DEF n Description The SENSe2 VOLTage DC CORRection POWer THERmopile RESPonse command sets the thermopile power meter responsivity in Y y Example SENS2 CORR POW 0 04V Sets the thermopile power meter responsivity to 40 0 Y This command is valid for LDC4000 and ITC4000 Series instruments only 3 9 4 Thermopile Power Meter Power Range Syntax SENSe2 POWer DC RANGe UPPer MIN MAX lt watts gt SENSe2 POWer DC RANGe UPPer MIN MAX Description The SENSe2 POWer DC RANGe UPPer MIN MAX lt watts gt command sets the thermopile power meter power range to the most appropriate range for the given value Example 2012 Thorlabs 47 Series 4000 SCPI Programmers Reference Manual SENS2 POW RANG 0 012 Sets the power range to or above 12 mW depending on the set responsivity of the used thermopile power meter SENS2 POW RANG MAX Queries the biggest available power range 1 800000E 00 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 9 5 Thermopile Power Meter Power Protection Syntax SENSe2 POWer DC PROTection LEVel
16. 31 31 32 32 33 33 34 34 36 37 38 38 39 40 41 42 43 43 44 44 45 45 46 46 47 47 48 48 49 49 51 51 52 52 53 53 54 55 3 12 Temperature Sense Commands 3 12 1 Sensor Selection 56 3 12 2 Thermistor Calculations 57 3 12 3 Transducer Offset 58 3 12 4 Temperature Protection 58 3 13 TEC Output Commands 59 3 13 1 Output State 60 3 13 2 Protection Queries 60 3 14 Status Subsystem Commands 62 3 14 1 Programming and Reading Registers 3 14 2 Auxiliary Register Group 65 66 3 14 3 Measurement Register Group 3 14 4 Questionable Register Group 67 68 3 14 5 Operation Registers Group 69 3 14 6 Status Preset Command 70 3 15 Memory Subsystem Commands 71 3 15 1 Number of State Memories 71 3 15 2 State Memories Names 71 72 3 16 Display Subsystem Commands 3 16 1 Display Brightness 72 3 16 2 Display Contrast 72 3 17 Digital I O Output Commands 73 3 17 1 Digital I O Output 73 3 17 2 Digital I O Configuration 74 3 18 Digital I O Input Commands 74 75 3 18 1 Digital I O Input 3 19 Unit Subsystem Commands 76 3 19 1 Temperature Unit Commands 3 20 Calibration Subsystem Commands 76 76 3 20 1 Calibration String 77 4 SCPI Error Messages 4 1 Command Errors 78 79 4 2 Execution Errors 81 83 4 3 Devic
17. CLS Syntax CLS Description The cLs command clears the event registers in all register groups This command also clears the error queue 3 1 10 ESR ESE ESE Syntax ESR ESE lt value gt ESE Description The ESR command queries the Standard Event Register In order to be reported to the Status Byte Register the corresponding bits in the event register must be enabled using the ESE Command The ESE command enables bits in the enable register Standard Event Status Enable Register for the Standard Event Register Group The selected bits are then reported to bit 5 of the Status Byte Register See also chapter Status Subsystem e and figure Status Structure e 2012 Thorlabs 13 Series 4000 SCPI Programmers Reference Manual The following table lists the bit definitions for the Standard Event Register Group Table 3 Standard Event Register Bit 0 Example ES Decimal Value Description 1 Operation Complete All commands prior to and including orc 11 have been executed not used Query Error The instrument tried to read the output buffer but it was empty or anew command line was received before a previous query has been read or both the input and output buffers are full 8 Device Dependent Error A self test or calibration error occurred an error in the 300 399 range or any positive error has been generated For a c
18. Example SOUR POW 0 001 Sets the LD source power to 1 0 mW on a LDC4000 Series or an ITC4000 Series instrument SOUR POW ALC SOUR PMET Sets the feedback source loop input to thermopile power meter input SOUR POW MAX Queries the maximum settable LD source power setpoint of a LDC4000 Series or an ITC4000 Series instrument 5 111964E 01 Typical response The power regulation is actually based on photodiode current or the thermopile power meter voltage Setting a new value for the responsivity for the connected photodiode or the connected thermopile power meter will not cause the instrument to change its output setting In this case the power set point will be adapted Example The LD power is set to 1 0 mW the photodiode responsivity is set to 1 0 A W the resulting feedback current of the photodiode is 1 0 mA When you change the responsivity to 2 0 A W the feedback current remains constant at 1 0 mA but the read back value of the laser power set point will decrease to 0 5 mW This command is valid for LDC4000 and ITC4000 Series instruments only 3 7 5 LD Power Feedback Syntax SOURce 1 POWer ALC SOURce DIODe PMETer PDIode THERmopile SOURce 1 POWer ALC SOURce SOURce 1 POWer ALC SPEed MIN MAX DEF lt percent gt SOURce 1 POWer ALC SPEed MIN MAX DEF 2012 Thorlabs 39 Series 4000 SCPI Programmers Reference Manual Description The SouRce 1 POWer ALC SO
19. Return number of state memories STATe NAME 71 lt value gt lt name gt Assign a name to a state memory NAME 71 lt value gt Return the name of a state memory 3 15 1 Number of State Memories Syntax MEMory NSTates Description The MEMory NSTates query command returns the number of state memories For 4000 Series instruments the answer will be 8 See also chapter SAV RCL SDS Save Recall Setup 11 Example 2 MEM NST Queries the number of state memories available 8 Typical response 3 15 2 State Memories Names Syntax MEMory STATe NAME lt value gt lt name gt MEMory STATe NAME lt value gt Description The MEMory STATe NAME Command assigns a name to a state memory For the parameter lt value gt remember that the state memories 1 8 are numbered 0 7 Example MEM STAT NAME 0 Experiment 5 Sets the name of state memory 1 to Experiment 5 2012 Thorlabs 71 Series 4000 SCPI Programmers Reference Manual 3 16 Display Subsystem Commands The DISPlay subsystem controls the front panel display LCD of a Thorlabs Series 4000 instrument Table 26 Display Commands Command Description DISPlay Path to display subsystem BRIGHTness 72 lt value gt Set the display brightness BRIGHTness 72 Return the display brightness CONTrast 72 lt value gt Set the display contrast CONTrast 72 Return the display contrast
20. Setup Syntax SAV lt value gt RCL lt value gt SDS lt value gt Description Value 0 7 Memory location 1 8 Use the sav command to save the present instrument setup configuration in non volatile state memory for later recall The RcL command is used to restore the instrument to the saved setup configuration Eight setup configurations can be saved and recalled Use the sps command to initialize the selected state memory with factory default settings Your settings will be overwritten See also chapter Memory Subsystem Commands 71 and appendix Instrument Default Settings s5 Example SAV 1 Saves the present instrument setup configuration to memory location 2 3 1 4 TST Self Test Syntax TST Description Use this query command to perform the instrument self test routine The command places the coded result in the output queue A returned value of zero 0 indicates that the test passed other values indicate that the test failed and the error code is placed into the instrument s error queue 3 1 5 OPC OPC Operation Complete Syntax OPC OPC Description When oec is sent the OPC bit in the Standard Event Register will be set after all pending command operations are complete When opc is sent an ASCII 1 is placed in the output queue after all pending command operations are complete 2012 Thorlabs 11 Series 4000 SCPI Programmers Reference Manual Typically either one
21. in the Error Queue Use the SySTem ERRor NEXT 15 command to read and delete errors 3 8 QUES Questionable Data Structure Summary Bit One or more bits are set in the Questionable Event Register bits must be enabled see Questionable Data Register Group 68 4 16 MAV Message Available Bit Data is available in the instrument s output buffer 5 32 ESB Standard Event Status Bit One or more bits are set in the Standard Event Register bits must be enabled see EsEl13 command 12 2012 Thorlabs 3 Commands by Subsystem Bit Decimal Value Mnemonic Description 6 64 RQS MSS Request Service Master Summary Status Bit One or more bits are set in the Status Byte Register and may generate a Request for Service RQS Bits must be enabled using the SRE 13 command 7 128 OPER Standard Operation Status Summary Bit One or more bits are set in the Standard Operation Register bits must be enabled see STATus OPERation ENABlel 69 command 3 1 8 SRE SRE Syntax SRE lt value gt SRE Description The SRE command enables bits in the enable register Service Request Enable Register for the Status Byte Register Group See table Status Byte Register 12 for a description of the bits Once enabled the corresponding bits may generate a Request for Service RQS in the status byte This RQS event may generate a call back to your application as a type of asynchronous interrupt 3 1 9
22. instrument s LD source function to constant current CW mode or to pulsed constant current QCW mode or to constant power CW mode Note The combination Power and PULSe is not available Example 36 2012 Thorlabs 3 Commands by Subsystem SOUR FUNC MODE CURR SHAP DC Sets the LD source function of a _LDC4000 Series or an ITC4000 Series instrument to constant current CW mode SOUR FUNC MODE SHAP Queries the LD source function CURR DC Response for constant current CW mode or CURR PULS response for pulsed constant current QCW mode or POW DC response for constant power CW mode This command is valid for LDC4000 and ITC4000 Series instruments only 3 7 2 LD Current Limit Syntax SOURce 1 CURRent LIMit AMPLitude MIN MAX lt amps gt SOURce 1 CURRent LIMit AMPLitude MIN MAX SOURce 1 CURRent LIMit TRIPped Description The souRce 1 CURRent LIMit AMPLitude command sets the LD source limit current in amperes The soURce 1 CURRent LIMit TRIPped query command returns an ASCII 1 if the LD source current reached the limit value or an ASCII 0 if it s inactive Example SOUR CURR LIM 1 5 Sets the LD source limit current to 1 5 A on a LDC4000 Series or an ITC4000 Series instrument SOUR CURR LIM MAX Queries the maximum settable LD source limit current of a _LDC4000 Series or an ITC4000 Series instrument 1 500000E
23. lt value gt ansition Ble lt value gt ENAI Ble QUESEt ionable 68 REN ENt ICON Davie Lom 2 PTRansition lt value gt PTRansition ENAI NTRansition lt value gt NTRansition Ble lt value gt ENAI Ble OPERat ion 69 SW ENt 2 CON Dale LO 2 PTRansition lt value gt 62 Description Path to status subsystem Path to control auxiliary event registers Read the event register Read the condition register Program the positive transition filter Read the positive transition filter Program the negative transition filter Read the negative transition filter Program the enable register Read the enable register Path to measurement event registers Read the event register Read the condition register Program the positive transition filter Read the positive transition filter Program the negative transition filter Read the negative transition filter Program the enable register Read the enable register Path to control questionable event registers Read the event register Read the condition register Program the positive transition filter Read the positive transition filter Program the negative transition filter Read the negative transition filter Program the enable register Read the enable register Path to control operation event registers Read the event register Read the condition register Program
24. needed Ro T Beta to calculate the temperature from a given resistance for a ITC4000 Series instrument This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 3 3 12 3 Transducer Offset Syntax SENSe 1 3 TEMPerature OFFSet MIN MAX DEF lt temperature gt SENSe 1 3 TEMPerature OFFSet MIN MAX DEF Description The SENSe 1 3 TEMPerature OFFSet command sets a temperature offset for a temperature sensor usually used to compensate small errors of temperature sensors Example SENS TEMP OFFS 0 2 Sets a temperature offset of 0 2K for a TED4000 Series instrument This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 3 3 12 4 Temperature Protection Syntax SENSe 1 3 TEMPerature PROTection WINDow AMPLitude MIN MAX DEF lt temperature gt SENSe 1 3 TEMPerature PROTection WINDow AMPLitude MIN MAX DEF SENSe 1 3 TEMPerature PROTection DELay MIN MAX DEF lt seconds gt SENSe 1 3 TEMPerature PROTection DELay MIN MAX DEF SENSe 1 3 TEMPerature PROTection TRIPed Descri
25. of errors 114 121 141 and perhaps some others 102 Syntax error An unrecognized command or data type was encountered for example a string was received when the device does not accept strings 103 Invalid separator The parser was expecting a separator and encountered an illegal character for example the semicolon was omitted after a program message unit INP POL CG STB instead of INP POL CG STB 104 Data type error The parser recognized a data element different than one allowed for example numeric or string data was expected but block data was encountered 105 GET not allowed A Group Execute Trigger was received within a program message see IEEE 488 2 Toth 108 Parameter not allowed More parameters were received than expected for the header for example the SRE common command only accepts one parameter so receiving SRE 0 1 is not allowed 109 Missing parameter Fewer parameters were received than required for the header for example the SRE Common command requires one parameter so receiving SRE is not allowed 110 Command header error An error was detected in the header This error message should be used when the device cannot detect the more specific errors described for errors 111 through 119 113 Undefined header Unknown command The header is syntactically correct but it is undefined for this specific device for example xyz is not defined for any device 115 Une
26. of these commands is sent after the INITiate command The INITiate command is used to take the instrument out of idle in order to perform measurements While operating within the trigger model layers many sent commands will not execute After all programmed operations are completed the instrument returns to the idle state at which time all pending commands including opc and or opc are executed When executing the OPC bit in the status structure is set and or an ASCII 1 is placed in the output queue 3 1 6 WAI Wait To Continue Syntax WAI Description The WAI command is a no operation command for the instrument and thus does not need to be used It is there for conformance to IEEE488 2 3 1 7 STB Syntax STB Description The STB command queries the instrument s Status Byte Register This is a read only register and the bits are not cleared when you read the register See also figure Status Structure e2 Table 2 Status Byte Register Bit Decimal Value Mnemonic Description 0 1 AUX Auxiliary Status Structure Summary Bit One or more bits are set in the Auxiliary Event Register bits must be enabled see Auxiliary Status Register Group s 1 2 MEAS Measurement Status Structure Summary Bit One or more bits are set in the Measurement Event Register bits must be enabled see Measurement Status Register Group s7 2 4 EAV Error Available Bit One or more errors have been stored
27. value ENAB1e 1 74 Return digital I O output enable value 3 17 1 Digital I O Output Syntax SOURce 2 3 DIGital DATA lt value gt SOURce 2 3 DIGital DATA Description The souRce 2 3 DIGital DATA command sets the I O pins according to value Value can be calculated as value 1 xl O 2xl O 4xl O 8xl O Where I O 0 for I O is low level I O 1 for I O is high level In table Digital I O values 75 all possible I O values are listed in decoded form Example SOUR3 DIG DATA 8 Sets I O of the digital I O port of an ITC4000 to high I O I O I O to low I O of the digital I O port can be configured as input or output see Digital I O configuration 74 To drive an external load the respective I O has to be configured as output 2012 Thorlabs 73 Series 4000 SCPI Programmers Reference Manual For TED4000 Series instruments and for LDC4000 Series instruments the command suffix is 2 for ITC4000 Series instruments the suffix is 3 3 17 2 Digital I O Configuration Syntax SOURce 2 3 DIGital ENABle lt value gt SOURce 2 3 DIGital ENABle Description The souRce 2 3 DIGital ENABle command enables the I O pins as output according to value Value can be calculated as value 1xI O 2xI O 4xl O 8xl O Where I O 0 for I O is input I O 1 for I O is output In table Digital I
28. 2 TED temperature setpoint limit low SOURce 1 2 TEMPerature LIMit Low 52 TED temperature setpoint SOURce 1 2 TEMPerature SPOint 53 TED thermistor R T calculation method SENSe 1 3 TEMPerature THERmistor METHod 57 TED thermistor Steinhart Hart parameter A SENSe 1 3 TEMPerature THERmistor 57 METHod SHH Al 57 TED thermistor Steinhart Hart parameter B SENSe 1 3 TEMPerature THERmistor 57 METHod SHH B 571 TED thermistor Steinhart Hart parameter C SENSe 1 3 TEMPerature THERmistor 57 METHod SHH Cl 571 TED thermistor exp method parameter R SENSe 1 3 TEMPerature THERmistor 57 METHod EXPonential R0 57 TED thermistor exp method parameter T SENSe 1 3 TEMPerature THERmistor 57 METHod EXPonential TO0 57 TED thermistor exp method parameter B value SENSe 1 3 TEMPerature THERmistor 57 METHod EXPonential BETA57 Display brightness DISP ay BRIGHTness l 721 Display contrast DISP lay CONTrast 721 Acoustic feedback SYSTem BEEPer IMMediate 151 Temperature unit UN T TEMPeraturel 76 Line frequency setting SYSTem LFRequency 16 88 Default Value lt value gt 150 0 C 150 55 0 C 55 25 C 25 expon
29. 24 512 256 as power of 2 Coe aA I en ee 2 2 3 14 2 Auxiliary Register Group Syntax STATus AUXiliary EVENt STATus AUXiliary CONDition STATus AUXiliary PTRansition lt value gt STATus AUXiliary PTRansition STATus AUXiliary NTRansition lt value gt STATus AUXiliary NTRansition STATus AUXiliary ENABle lt value gt STATus AUXiliary ENABle Description The STATus AUXiliary commands and queries handle the registers of the Auxiliary Register Group Table 20 Auxiliary Register Group Bit Number Decimal Value Definition 0 1 General Purpose I O 1 2 General Purpose I O 2 4 General Purpose 1 0 66 2012 Thorlabs Bit Number Decimal Value 3 8 4 15 3 Commands by Subsystem Definition General Purpose O reserved For more information on the SCPI Status System for Thorlabs 4000 Series instruments see chapter Programming and Reading Registers es 3 14 3 Measurement Register Group STATus MEASurement EVENt STATus MEASurement CONDition STATus MEASurement PTRansition lt value gt STATus MEASurement PTRansition STATus MEASurement NTRansition lt value gt STATus MEASurement NTRansition STATus MEASurement ENABle lt value gt STATus MEASurement ENAB1le Description The STATus MEASurement commands and queries handle the registers of the Measurement Register Group
30. 3 16 1 Display Brightness Syntax DISPlay BRIGHTness lt value gt DISPlay BRIGHTness Description The DISPlay BRIGHTness command controls the intensity of the display The range of the parameter is 0 to 1 where 1 is full intensity and 0 is fully blanked Example DISP BRIGHT 0 6 Sets the brightness of the front panel display to 60 of full intensity 3 16 2 Display Contrast Syntax DISPlay CONTrast lt value gt DISPlay CONTrast Description The DISPlay CONTrast Command determines the relative difference in brightness between full intensity and no intensity as displayed The parameter ranges in value from O to 1 0 indicates no difference between data and background and 1 indicates maximum contrast Example DISP CONT 0 5 Sets the contrast of the front panel display to 50 72 2012 Thorlabs 3 Commands by Subsystem 3 17 Digital O Output Commands The soURce 2 3 subsystem controls the instrument s digital I O output For LDC4000 and TED4000 Series instruments the command suffix is 2 for ITC4000 Series instruments the suffix is 3 Table 27 Digital I O Output Commands Command Description SOURce 2 3 Path to output functions eDIGital Path to digital I O functions DATAI73 lt value gt Set digital I O output data DATA 73 Return digital I O output data ENABle 74 lt value gt Set digital I O output enable
31. 3 5 PD Input Commands 3 5 1 3 5 2 3 5 3 3 5 4 3 6 Thermopile Power Meter Input Commands 3 6 1 3 7 LD Source Commands 3 7 1 3 7 2 3 7 3 3 7 4 3 7 5 3 7 6 3 7 7 3 8 PD Sense Commands 3 8 1 3 8 2 3 8 3 3 8 4 3 8 5 3 9 Thermopile Power Meter Sense Commands 3 9 1 3 9 2 3 9 3 3 9 4 3 9 5 3 10 QCW Pulse Trigger Commands 3 10 1 3 11 TEC Source Commands 3 11 1 3 11 2 3 11 3 3 11 4 3 11 5 3 11 6 3 11 7 Switch On Delay Polarity Protection Voltage Temperature Protection Mode LD ENABLE Input Mode Protection Queries Polarity BIAS State BIAS Voltage Input Routing Input Routing LD Source Function LD Current Limit LD Current Setpoint LD Optical Power LD Power Feedback LD Amplitude Modulation QCW Pulse Setting Photodiode Current Range Photodiode Current Protection Photodiode Responsivity Photodiode Power Range Photodiode Power Protection Thermopile Power Meter Voltage Range Thermopile Power Meter Voltage Protection Thermopile Power Meter Responsivity Thermopile Power Meter Power Range Thermopile Power Meter Power Protection QCW Trigger Source TEC Source Function TEC Current Limit TEC Current Setpoint TEC Temperature Setpoint Limit TEC Temperature Setpoint PID Loop Constants PID Auto Tune 27 28 28 29 29 30
32. 87 MIN MAX POWer LEVel 1 38 AMPLitude MIN MAX lt amps gt 37 AMPLitude MIN MAX 37 IMMediate AMPLitude MIN MAX lt watts gt IMMediate AMPLitude MIN MAX DIODe CURRent IMMediate AMPLitude MIN MAX lt amps gt DIODe CURRent IMMediate AMPLitude MIN MAX PMETer VOLTage IMMediate AMPLitude MIN PMETer VOLTage IMMediate AMPLitude MIN MAX ALC 39 TOOURCE THERmopile aS OUCH DIODe PMETer PDIode SPEed MIN MAX DEF lt percent gt SPEed MIN MAX D I AM 40 setate Owis ON 11 2S2ATES 2 EE SOURce INTernal EXTernal 2012 Thorlabs INTernal EXTernal MAX lt volts gt 3 Commands by Subsystem Description Set CW DC or QCW PULSe mode Return mode Set LD limit current value Return LD limit current value Return LD limit current tripped Set LD current setpoint Return LD current setpoint Set LD power setpoint Return LD power setpoint Set LD power via setting photodiode current setpoint Return photodiode current setpoint Set LD power via setting thermopile power meter voltage setpoint Return thermopile power meter voltage setpoint Set the power source feedback loop input Return the power source feed
33. DC CONFigure SCALar VOLTage 1 DC CONFigure SCALar CURRent2 DC CONFigure SCALar POWer2 CONFigure SCALar VOLTage2 DC CONFigure SCALar POWer3 CONFigure SCALar POWer 1 CONFigure For ITC4000 Series instruments CONFigure SCALar TEMPerature CONFigure SCALar CURRent3 DC CONFigure SCALar VOLTage3 DC CONFigure SCALar POWer4 CONFigure SCALar TSENsor CONFigure SCALar CURRent 1 CONFigure SCALar VOLTage 1 DC CONFigure SCALar CURRent2 DC CONFigure SCALar POWer2 CONFigure SCALar VOLTage2 DC CONFigure SCALar POWer3 CONFigure SCALar POWer 1 CONFigure 2012 Thorlabs 21 Series 4000 SCPI Programmers Reference Manual Description Configures the instrument to measure the selected value The CONFigure command does not perform the measurement Use the INITiate Or READ command to take the configured measurement The configuration query returns the current measurement configuration Example The following program segment configures a TED4000 Series instrument for temperature measurements and performs one measurement with the READ command CONF TEMP Configure the instrument for temperature measurement READ Perform a measurement and send the reading to the output buffer 2 500000E 01 Typical response Example The following program segment configures a TED4000 S
34. MAX DEF Description The SENSe 1 3 TEMPerature THERmistor METHod command selects one of the two temperature to from resistance calculation methods Steinhart Hart or Exponential method The SENSe 1 3 TEMPerature THERmistor SHH A command sets the parameter A for the calculation method according to Steinhart Hart The SENSe 1 3 TEMPerature THERmistor SHH B command sets the parameter B for the calculation method according to Steinhart Hart The SENSe 1 3 TEMPerature THERmistor SHH C command sets the parameter C for the calculation method according to Steinhart Hart The SENSe 1 3 TEMPerature THERmistor EXPonential RO command sets the parameter R resistance at nominal temperature T for the exponential calculation method The SENSe 1 3 TEMPerature THERmistor EXPonential TO command sets the parameter T nominal temperature for the exponential calculation method 2012 Thorlabs 57 Series 4000 SCPI Programmers Reference Manual The SENSe 1 3 TEMPerature THERmistor EXPonential BETA command sets the parameter Beta also known as B value for the exponential calculation method Example SENS TEMP THER METH EXP Sets the calculation method for a thermistor to exponential for a TED4000 Series instrument SENS3 TEMP THER EXP RO 10k TO 25 BETA 3988 Sets the three thermistor parameters
35. MIN MAX Description The SENSe 1 POWer DC RANGe UPPer Command sets the power range to the most appropriate range for the given value Example SENS POW RANG 0 012 Sets power range to or above 12 mW depending on the set responsivity of the used photodiode SENS POW RANG MAX Queries the biggest available power range 1 800000E 00 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 44 2012 Thorlabs 3 Commands by Subsystem 3 8 5 Photodiode Power Protection Syntax SENSe 1 POWer DC PROTection LEVel MIN MAX DEF lt watts gt SENSe 1 POWer DC PROTection LEVel MIN MAX DEF SENSe 1 POWer DC PROTection TRIPped Description The SENSe 1 POWer DC PROTection LEVel Command sets the power limit value The SENSe 1 POWer DC PROTection TRIPped query command returns an ASCII 1 if the power limit value is currently reached or an ASCII 0 if the power is currently below that limit Example SENS POW PROT 0 035 Sets the power limit to 35 0 mW This command is valid for LDC4000 and ITC4000 Series instruments only 3 9 Thermopile Power Meter Sense Commands The SENSe2 subsystem controls the thermopile power meter sense part of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only Table 13 Thermopile Power Meter Sense Commands
36. N Oo FW PS O es Es eas Gm S Eoi gt fa Sok I O of the digital I O port can be configured as input or output see Digital I O configuration 74 To be able to read the level of a connected driver the respective I O has to be configured as input 2012 Thorlabs 75 Series 4000 SCPI Programmers Reference Manual For LDC4000 Series instruments the command suffix is 3 for TED4000 Series instruments the command suffix is 2 and for ITC4000 Series instruments the command suffix is 4 3 19 Unit Subsystem Commands For each SCPI command default units are defined where applicable The UNIT subsystem provides a mechanism to change these default units The units selected apply to the designated command parameters for both command and response Table 30 Unit Commands Command Description UNIT Path to unit functions TEMPeraturel 76 C CEL CELSius Set the temperature unit F FAR FAHRenheit K KELVin TEMPerature 76 Return the temperature unit 3 19 1 Temperature Unit Commands Syntax UNIT TEMPerature C CEL CELSius F FAR FAHRenheit K KELVin UNIT TEMPerature Description The UNIT TEMPerature command sets the temperature unit used for further communication with the instrument Example UNIT TEMP K Sets the temperature unit for further communication with the instrument to Kelvin This command is valid only for TED4000 and ITC4000 Series instrument
37. O values 75 all possible I O values are listed in decoded form Example gt SOUR3 DIG ENAB 15 Sets I O of the digital I O port of an ITC4000 to output For TED4000 Series instruments and for LDC4000 Series instruments the command suffix is 2 for ITC4000 Series instruments the suffix is 3 3 18 Digital I O Input Commands The SENSe 2 3 4 subsystem controls the instrument s digital I O input For LDC4000 Series instruments the command suffix is 3 for TED4000 Series instruments the command suffix is 2 and for ITC4000 Series instruments the command suffix is 4 Table 28 Digital I O Input Commands Command Description SENSe 2 3 4 Path to input functions DIGital Path to digital I O functions DATA 75 Return digital I O input data 74 2012 Thorlabs 3 18 1 Digital I O Input Syntax 2 3 4 DIGital DATA SENSe Description The s returned value represents the levels of I O according to ENSe 2 3 4 1 D IGital Table 29 Digital I O Values Queries the digital I O port of a TED4000 Series instrument 1 0 1 0 L L L L L L L L L H L H L H L H H L H L H L H L H H H H H H H H Example SENS2 DIG DATA 9 Typical response Note 3 Commands by Subsystem DATA command queries the I O pins of the digital I O port The a L Em Ee L Emn eee L Em Ee IL Emr Be ee ea r e r a r e r hL value oOo
38. ODE Description The souRce 1 2 FUNCtion MODE command sets the instrument s TEC source function to current source mode or temperature control mode Example SOUR FUNC TEMP Sets the TEC source function of a TED4000 Series instrument to temperature source mode This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 3 11 2 TEC Current Limit Syntax SOURce 1 2 CURRent LIMit AMPLitude MIN MAX lt amps gt SOURce 1 2 CURRent LIMit AMPLitude MIN MAX Description The souRce 1 2 CURRent LIMit AMPLitude command sets the TEC element limit current in amperes Example SOUR CURR LIM 1 5 Sets the TEC element limit current to 1 5A on a TED4000 Series instrument SOUR2 CURR LIM MAX Queries the maximum settable TEC element limit current of a ITC4000 Series instrument 1 500000E 01 Typical response This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 2012 Thorlabs 51 Series 4000 SCPI Programmers Reference Manual 3 11 3 TEC Current Setpoint Syntax SOURce 1 2 CURRent LEVel IMMediate AMPLitude MIN MAX lt amps gt SOURce 1 2 CURRent
39. OLTage DC command sets the PD input BIAS voltage Example 32 2012 Thorlabs 3 Commands by Subsystem INP BIAS VOLT 800mV Sets the PD input BIAS voltage to 0 8V INP BIAS VOLT MAX Queries the maximum settable PD input BIAS voltage 5 000000E 01 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 5 4 Input Routing Syntax INPut 1 ROUTe TERMinals DSUB BNC INPut 1 ROUTe TERMinals Description The INPut 1 ROUTe TERMinals command sets the path for the PD input routing to either the rear panel LASER OUTPUT D SUB connector or the rear panel BNC connector Example INP ROUT BNC Sets the path for the PD input to the rear panel BNC connector INP ROUT Queries the path for the PD input routing BNC The answer is either DSUB Or BNC This command is valid for LDC4000 and ITC4000 Series instruments only 3 6 Thermopile Power Meter Input Commands The INPut2 subsystem controls the thermopile power meter input of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only Table 10 Thermopile Power Meter Input Commands Command Description INPut 2 Path to PD input 2012 Thorlabs 33 Series 4000 SCPI Programmers Reference Manual Command Description ROUTe TERMinals 34 DSUB BNC Set thermopile power meter input routing RO
40. SS Thorlabs Series 4000 LDC40xx TED4015 ITC40xx SCPI Programmers Reference Manual 2012 ORLA Version 3 1 Date 27 11 2012 Copyright 2012 Thorlabs u J p Contents Foreword 0 1 General Information 4 2 Introduction to the SCPI Language 5 2 1 Syntax Conventions 5 2 2 Command Separators 6 2 3 Using the MIN MAX and DEF Parameters 6 2 4 Querying Parameter Settings 7 2 5 Command Terminators 7 2 6 Parameter Types 7 2 6 1 Numeric Parameters 7 2 6 2 Discrete Parameters 8 2 6 3 Boolean Parameters 8 2 6 4 ASCII String Parameters 8 3 Commands by Subsystem 9 3 1 IEEE 488 2 Commands 9 3 1 1 IDN Identification Query 10 3 1 2 RST Reset 10 3 1 3 SAV RCL SDS Save Recall Setup 11 3 1 4 TST Self Test 11 3 1 5 OPC OPC Operation Complete 11 3 1 6 WAI Wait To Continue 12 3 1 7 STB 12 3 1 8 SRE SRE 13 3 1 9 CLS 13 3 1 10 ESR ESE ESE 13 3 2 System Subsystem Commands 14 3 2 1 Beeper 15 3 2 2 Error Query 15 3 2 3 Line Frequency 16 3 2 4 SCPI Version Query 16 3 3 Measurement Commands 16 3 3 1 Abort Measurement in Progres 21 3 3 2 Configuring a Measurement 21 3 3 3 Initiating a Measurement 23 3 3 4 Fetch a Measurement 23 3 3 5 Read Measurement Data 25 3 3 6 Simple Measurement 25 3 4 LD Output Commands 26 3 4 1 Output State 27 ORLA 3 4 2 3 4 3 3 4 4 3 4 5 3 4 6 3 4 7
41. URce 49 LDC pulsed constant current QCW mode pulse period SO LDC p SO LDC p SO LDC p SO 86 U U ulsed Rce 1 ulsed ulsed Rce 1 URES IL URce 1 PULSe PERiod 4il PULSe WIDTh 41 PULSe DCYClel 41 PULSe HOLD 4 constant current QCW mode pulse width constant current QCW mode duty cycle constant current QCW mode hold parameter Default Value lt value gt 0 Volts 0 10 Volts 10 LASER OUTPUT D SUB connector DSUB AL disabled OFF internal INT sinusoidal SIN 10 0 kHz 1 0B 04 10 10 no function OFF no function OFF internal INT 20 ms O02 ims 1 0E 03 5 5 pulse width WIDT 2012 Thorlabs Parameter SCPI command to set parameter LDC laser current setpoint SOURce 1 CURRent LEVel IMMediate 38 AMPLitude 38 LDC photodiode current setpoint SOURce 1 POWer LEVel DIODe CURRent 38 IMMediate 38 LDC thermopile power meter voltage setpoint SOURce 1 POWer LEVel PMETer VOLTage 38 IMMediate 38 LDC power setpoint SOURce 1 POWer LEVel IMMediate 38 AMPlitude 38 TED operating mode SOURce 1 2 FUNCtion MODE 5 TED current limit SOURce 1 2 CURRent LIMit AMPLitude 51 TED current setpoin
42. URce command sets the power source feedback loop input to photodiode DIODe PDIode or to thermopile power meter PMETer THERmopile The SOURce 1 POWer ALC SPEed command sets the speed of the power source feedback loop Please refer to the instrument s operation manual for a detailed description of the constant power mode operation Example SOUR POW ALC SOUR PDI Sets the power source feedback loop input to photodiode SOUR POW ALC BAND 250 Sets the power source feedback loop bandwidth to 250 Hz This command is valid for LDC4000 and ITC4000 Series instruments only 3 7 6 LD Amplitude Modulation Syntax SOURce 1 AM STATe OFF 0 ON 1 SOURce 1 AM STATe SOURce 1 AM SOURce INTernal EXTernal INTernal EXTernal SOURce 1 AM SOURce SOURce 1 AM INTernal SHAPe SINusoid SQUare TRIangle SOURce 1 AM INTernal SHAPe SOURce 1 AM INTernal FREQuency MIN MAX DEF lt hertz gt SOURce 1 AM INTernal FREQuency MIN MAX DEF SOURce 1 AM INTernal DEPTh MIN MAX DEF lt percent gt SOURce 1 AM INTernal DEPTh MIN MAX DEF Description The SoURce 1 AM STATe command enables on 1 or disables orr 0 the amplitude modulation of the LD source The SoURce 1 AM SOURce command selects the amplitude modulation source s of the LD source It may specify a single source or two sources The specified source
43. UTe TERMinals 34 Return thermopile power meter input routing See also chapter Thermopile Power Meter Sense Commands 45 3 6 1 Input Routing Syntax INPut2 ROUTe TERMinals DSUB INPut2 ROUTe TERMinals BNC Description The INPut2 ROUTe TERMinals command sets the path for the thermopile oower meter input routing either to the rear panel LASER OUTPUT D SUB connector or to the rear panel BNC connector Example INP2 ROUT BNC Sets the path for the thermopile power meter input to the rear panel BNC connector INP2 ROUT Queries the path for the thermopile power meter input routing BNC The answer is either DSUB or BNC This command is valid for LDC4000 and ITC4000 Series instruments only 3 7 LD Source Commands The SOURce 1 subsystem controls the LD source part of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only Table 11 LD Source Commands Command Description SOURce 1 Path to LD source function FUNCt ion 36 MODE 5 CURRent POWer Set LD driver source function MODE 51 Return LD driver source function 34 2012 Thorlabs Command SHAPe DC PULSE a SSEAPS 2 CURRent 8 LUMILE TRIPped 37 LEVel IMMediate AMPLitude 38 MIN MAX lt amps gt LEVel IMMediate AMPLitude 3
44. X DEF Return exponential parameter Ro TO MIN MAX DEF Set exponential parameter T lt temperature gt T0 MIN MAX DEF Return exponential parameter To BETA MIN MAX DEF lt value gt Set exponential parameter beta BETA MIN MAX DEF Return exponential parameter beta OFFSet 58 MIN MAX DEF Set transducer temperature lt temperature gt offset OFFSet 2 58 MIN MAX DEF Return transducer temperature offset PROTect ion s8l DELay 58 MIN MAX DEF lt seconds gt Set protection reset delay DELayl58 MIN MAX DEF Return protection reset delay WINDow AMPLitude l58 MIN MAX Set temperature window DEF lt temperature gt amplitude WINDow AMPLitude 58 MIN MAX Return temperature window DEF amplitude TRIPped 58 Return protection tripped 3 12 1 Sensor Selection Syntax SENSe 1 3 TEMPerature TRANsducer TYPE AD590 THLow THHigh PT100 PT1000 LM35 LM335 SENSe 1 3 TEMPerature TRANsducer TYPE Description The SENSe 1 3 TEMPerature TRANsducer TYPE command selects the temperature sensor to be used for future operation See the operation manual for a more detailed description on temperature sensors for TED4000 and ITC4000 Series instruments Example SENS TEMP TRAN AD590 Sets the temperature sensor to be used to an AD590 for a TED4000 Series instrument 56 2012 Thorlabs 3 Commands by Subsystem This
45. a parameter from a command keyword If a command requires more than one parameter you must separate adjacent parameters using a comma as shown below MEM STAT NAME 1 My setting A semicolon is used to separate commands within the same subsystem and can also minimize typing For example sending the following command string DISP BRIG 1 CONT 0 5 is the same as sending the following two commands DISP BRIG 1 DISP CONT 0 5 Use a semicolon and a colon to link commands from different subsystems The colon resets the command tree to the root level For example SOURce CURRent 0 5 OUTPut ON 2 3 Using the MIN MAX and DEF Parameters For many commands you can substitute MINimum Or MAXimum in place of a parameter In some cases you may also substitute DEFault For example consider the following command SOURce TEMPerature PROTection WINDow MIN MAX DEF lt temp gt SOURce 1 CURRent LIMit AMPLitude MIN MAX lt amps gt Instead of selecting a specific value for the lt temp gt parameter you can substitute MIN or MINimum to set the value to its minimum Max or MAXimum to set the value to its maximum DEF Or DEFault to set the value to the default value For reasons of clarity the following parts of commands are written in short form only throughout this manual Original Form Short Form MINimum MAXimum DEFault lt valu
46. andard Codes Formats Protocols and Common Commands available at www ieee org e SCPI Specification Version 1999 0 May 1999 available at www ivifoundation org 4 2012 Thorlabs 2 Introduction to the SCPI Language 2 Introduction to the SCPI Language SCPI Standard Commands for Programmable Instruments is an ASCII based instrument command language designed for test and measurement instruments based on a hierarchical tree structure It means associated commands are grouped together under a common node For example SOURce 1 CURRent LIMit AMPLitude MIN MAX lt amps gt SOURce Is the root level keyword of the command cuRRent is the second level keyword LIMit is the third level keyword and AMPLitude is the fourth level keyword which can be omitted in this case A colon separates between command levels For further information about SCPI please see SCPI Standard available at www ivifoundation org 2 1 Syntax Conventions The format used in this manual for commands is illustrated below SOURce 1 CURRent MINimum MAXimum lt amps gt The command syntax shows most commands and some parameters as a mixture of upper and lower case letters The upper case letters indicate the abbreviated spelling for the command For shorter program lines you can use the abbreviated form For better program readability you can send the long form In the above example CURR and cuRRent are both acceptable syntax s
47. back loop input Set feedback loop speed setting Return feedback loop speed setting Enables ON or disables OFF modulation Return modulation state Set modulation source 35 Series 4000 SCPI Programmers Reference Manual Command Description SOURce Return modulation source INTernal SHAPe Set internal modulation shape SINusoid SQUare TRIangle SHAPe Return internal modulation shape FREQuency MIN MAX DEF lt hertz gt Set internal modulation frequency FREQuency MIN MAX DEF Return internal modulation frequency DEPTh MIN MAX DEF lt percent gt Set internal modulation depth DEPTh MIN MAX DEF Return internal modulation depth PULSel4t PERiod MIN MAX DEF lt secs gt Set pulse period PERiod MIN MAX DEF Return pulse period WIDTh MIN MAX DEF lt secs gt Set pulse width WIDTh MIN MAX DEFault Return pulse width DCYCle MIN MAX DEF lt percent gt Set pulse duty cycle DerCle MIN MAX DEE Return pulse duty cycle HOLD WIDTh DCYCle Set parameter to hold HOLD Return parameter to hold 3 7 1 LD Source Function Syntax SOURce 1 FUNCtion MODE CURRent POWer SOURce 1 FUNCtion MODE SOURce 1 FUNCtion SHAPe DC PULSe SOURce 1 FUNCtion SHAPe Description The souRce 1 FUNCtion MODE and SOURce 1 FUNCtion SHAPe commands set the
48. ce 1 POWer LEVel DIODe CURRent IMMediate AMPLitude MIN MAX SOURce 1 POWer LEVel PMETer VOLTage IMMediate AMPLitude MIN MAX lt volts gt SOURce 1 POWer LEVel PMETer VOLTage IMMediate AMPLitude MIN MAX Description The sSouRce 1 POWer LEVel IMMediate AMPLitude command sets the LD power setpoint in watts for constant power CW mode The SOURce 1 POWer ALC SOURce command sets the feedback source loop input to current input DIODe or to voltage input PMETer The SoOURce 1 POWer ALC BANDwidth command sets the bandwidth of the feedback source loop input 38 2012 Thorlabs 3 Commands by Subsystem For constant power CW mode the feedback source input photodiode current or thermopile voltage can additionally be used as parameter to control the LD output power The SouRce 1 POWer LEVel DIODe CURRent IMMediate AMPLitude Command sets the value for the photodiode current feedback The LD power will be regulated so that the current through the photodiode caused by the laser light will equal the value set by this command The source 1 POWer LEVel PMETer VOLTage IMMediate AMPLitude command sets the value for the thermopile voltage feedback The LD power will be regulated so that the voltage of the thermopile caused by the laser light will equal the value set by this command
49. command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 3 3 12 2 Thermistor Calculations Syntax SENSe 1 3 TEMPerature THERmistor METHod EXPonential SHH SENSe 1 3 TEMPerature THERmistor METHod SENSe 1 3 TEMPerature THERmistor SHH A MIN MAX DEF lt value gt SENSe 1 3 TEMPerature THERmistor SHH A MIN MAX DEF SENSe 1 3 TEMPerature THERmistor SHH B MIN MAX DEF lt value gt SENSe 1 3 TEMPerature THERmistor SHH B MIN MAX DEF SENSe 1 3 TEMPerature THERmistor SHH C MIN MAX DEF lt value gt SENSe 1 3 TEMPerature THERmistor SHH C MIN MAX DEF SENSe 1 3 TEMPerature THERmistor EXPonential R0O MIN MAX DEF lt value gt SENSe 1 3 TEMPerature THERmistor EXPonential R0 MIN MAX DEF SENSe 1 3 TEMPerature THERmistor EXPonential TO MIN MAX DEF lt value gt SENSe 1 3 TEMPerature THERmistor EXPonential T0 MIN MAX DEF SENSe 1 3 TEMPerature THERmistor EXPonential BETA MIN MAX DEF lt value gt SENSe 1 3 TEMPerature THERmistor EXPonential BETA MIN
50. e Specific Errors 4 4 Query Errors 83 4 5 Instrument Errors 84 5 Appendix 5 1 Instrument Default Settings 85 85 5 2 Thorlabs Worldwide Contacts 89 Series 4000 SCPI Programmers Reference Manual 1 General Information This part of the programmer s reference manual contains specific information about the SCPI command set of the Series 4000 instruments A general description is followed by explanations of how to use the SCPI commands The command set is according to the SCPI 1999 0 standard The Series 4000 instruments provide a USB 2 0 Full Speed link according to the USB 2 0 specification the USBTMC specification and the USBTMC USB488 specification The instrument s command buffer accepts commands with a maximum length of 255 characters The instrument s message output buffer can contain response messages of up to 255 characters There are VXlIpnp VISA instrument drivers available for Series 4000 instruments See www thorlabs com for downloads Related documents e TED4000 Series Operation Manual available at www thorlabs com e LDC4000 Series Operation Manual available at www thorlabs com e 1TC4000 Series Operation Manual available at www thorlabs com e USB Test and Measurement Class USBTMC Specification Revision 1 0 available at www usb org e USB Test and Measurement Class Subclass USB488 Specification USBTMC USB488 Revision 1 0 available at www usb org e IEEE Std 488 2 1992 IEEE St
51. e gt MIN MAX DEF lt value gt MINimum MAXimum DEFault MIN MAX DEF MINimum MAXimum lt value gt MIN MAX lt value gt MINimum MAXimum MIN MAX 6 2012 Thorlabs 2 Introduction to the SCPI Language 2 4 Querying Parameter Settings You can query the current value of most parameters by adding a question mark 2 to the command For example the following command sets the temperature setpoint SOURce CURRent 5 0 You can then query the value by typing SOURce CURRent You can also query the minimum or maximum and where specified the default values as follows SOURce CURRent MINimum SOURce CURRent MAXimum 2 5 Command Terminators A command string sent to the instrument must terminate with a lt new line gt lt NL gt character Command string termination will always reset the current SCPI command path to the root level 2 6 Parameter Types The SCPI language defines several data formats to be used in program messages and response messages 2 6 1 Numeric Parameters Commands that require numeric parameters will accept all commonly used decimal representations of numbers including optional signs decimal points and scientific notation Special values for numeric parameters such as MIN MAX and DEF may also be accepted You can also send engineering unit suffixes with numeric parameters e g M k m or u If a command accepts only certain specific values the instrument will automaticall
52. e voltage measure 1 2 Questionable current measure 2 4 not used 3 8 Questionable power measure 4 16 Questionable temperature measure 5 15 not used For more information on the SCPI Status System for Thorlabs 4000 Series instruments see chapter Programming and Reading Registers 65 68 2012 Thorlabs 3 Commands by Subsystem 3 14 5 Operation Registers Group Syntax STATus OP STATus 0OP STATus OP STATus OP STATus OP STATus OP STATus OP STATus OP Ration EVENt Ration CONDition Ration PTRansition lt value gt Ration PTRansition Ration NTRansition lt value gt Ration NTRansition Ration ENABle lt value gt Ration ENABle J AM G A ee Description The STATus OPERat ion commands and queries handle the registers of the Operation Register Group Table 23 Operation Register Group Bit Number Decimal Value Definition 0 1 not used 1 2 not used 2 4 Ranging LDC TED ITC 3 8 not used 4 16 Measuring LDC TED ITC 5 32 Waiting for trigger LDC ITC 6 64 not used 7 128 Correcting Auto PID TED ITC 8 256 not used 9 512 LD output state is ON LDC ITC 10 1024 not used 11 2048 LD output is currently ON LDC ITC 12 4096 TEC output is ON TED ITC 13 8192 not used 14 16384 not used 15 32768 reserved For more information on the SCPI Status System for Thorlabs 4000 Series instruments see chapter Programming and Reading Registers 651 2012 T
53. ement promise representation or legal relationship nor an alteration or amendment thereof All obligations of Thorlabs GmbH result from the respective contract of sale which also includes the complete and exclusively applicable warranty regulations These contractual warranty regulations are neither extended nor limited by the information contained in this User Manual Should you require further information on this product or encounter specific problems that are not discussed in sufficient detail in the User Manual please contact your local Thorlabs dealer or system installer All rights reserved This manual may not be reproduced transmitted or translated to another language either as a whole or in parts without the prior written permission of Thorlabs GmbH Status 2012 Copyright Thorlabs GmbH All rights reserved 90 2012 Thorlabs
54. ential meth EXP 1 129241x10 Lo l2g24 ilies 2 341077x104 2 S4ALOVIE O4 8 775468x 10 8 775468E 08 10 0 k 1 0E 04 25 0 C 25 3575 0 3575 100 100 45 45 enabled ON degree Celsius Cc autom detection AUTO 2012 Thorlabs 5 Appendix The default values stated here are typical values they may vary from model to model For more information on default values please see the user s manual provided with the instrument 5 2 Thorlabs Worldwide Contacts USA Canada and South America Thorlabs Inc 56 Sparta Avenue Newton NJ 07860 USA Tel 973 579 7227 Fax 973 300 3600 www thorlabs com www thorlabs us West Coast Email sales thorlabs com Support techsupport thorlabs com Europe Thorlabs GmbH Hans Bockler Str 6 85221 Dachau Germany Tel 49 8131 5956 0 Fax 49 8131 5956 99 www thorlabs de Email europe thorlabs com France Thorlabs SAS 109 rue des C tes 78600 Maisons Laffitte France Tel 33 970 444 844 Fax 33 811 38 17 48 www thorlabs com Email sales fr thorlabs com Japan Thorlabs Japan Inc Higashi Ikebukuro Q Building 2nd Floor 2 23 2 Toshima ku Tokyo 170 0013 Japan Tel 81 3 5979 8889 Fax 81 3 5979 7285 www thorlabs jp Email sales thorlabs jp 2012 Thorlabs UK and Ireland Thorlabs Ltd 1 Saint Thomas Place Ely Cambridgeshire CB7 4EX United Kingdom Tel 44 1353 654440 Fax 44 1353 654444 www thor
55. ents the suffix is 2 3 12 Temperature Sense Commands The SENSe 1 3 subsystem controls the temperature sensing part of the instrument These commands are valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 3 Table 16 Temperature Sense Commands Command Description SENSe 1 13 Path to TEC sense function gS TEMP Sica ice TRANsducer s l TYPE AD590 THLow Set temperature sensor type THHigh PT100 PT1000 LM35 LM335 TRANsducerl 56l TYPE Return temperature sensor THERmistor 571 METHod EXPonential SHH Set thermistor calculation method METHod Return thermistor calculation method 3 SHEL A MIN MAX DEF lt value gt Set Steinhart Hart parameter A sA MIN MAX DEF Return Steinhart Hart parameter A B MIN MAX DEF lt value gt Set Steinhart Hart parameter B B MIN MAX DEF Return Steinhart Hart parameter B C MIN MAX DEF lt value gt Set Steinhart Hart parameter C 2C2 MEN MAX DEE 4 Return Steinhart Hart parameter C 2012 Thorlabs 55 Series 4000 SCPI Programmers Reference Manual Command Description EXPonential RO MIN MAX DEF lt ohms gt Set exponential parameter Ro RO MIN MA
56. eries instrument for temperature measurements and performs one measurement with the INITiate IMMediate and FETCh command sequence CONF TEMP Configure the instrument for temperature measurement INIT Perform the measurement and store reading in memory FETC Transfer reading from memory to instrument s output buffer 2 500000E 01 Typical response Example CONF Query the current measurement configuration TEMP Typical response Example The following program segment configures a LDC4000 Series instrument for thermopile power meter voltage measurements and performs one measurement with the INITiate IMMediate and FETCh command sequence CONF VOLT2 Configure the instrument for thermopile power meter voltage measurement INIT Perform the measurement and store reading in memory 22 2012 Thorlabs measurement and performs one measurement with the RI PETC Transfer reading from memory to instrument s output buffer 3 770000E 01 Typical response Example The following program segment configures a ITC4000 Series instrument for TEC current CONF CURR3 Co nfigure the instrument for TEC current measurement READ Perform a measurement and send the reading to the output buffer 6 532000E 00 Typical response 3 3 3 Initiating a Measurement Syntax INITiat IMMediate Description
57. fers readings from memory to the instrument s output buffer where you can read them into your computer The readings are not erased from memory when you read them You can send the command multiple times to retrieve the same data With the FETCh command the last configured measurement will be transferred to the instruments output buffer With FI instruments output buffer Example E ETC Query last measurement ETCh XXX the value of the last measurement of XXX will be transferred to the Query last measurement of optical power via photodiode of an ITC4000 Series 2 500000E 01 Typical response Example FETC POW2 instrument 24 2012 Thorlabs 2 4 520000E 03 Typical response 3 3 5 Read Measurement Data Syntax READ Description 3 Commands by Subsystem The READ command performs a previously configured measurement and then sends the reading to the instrument output buffer It has the same effect as INI followed by the FETCh command Example Tiatel IMMediate The following program segment configures a TED4000 ITC4000 Series instrument for temperature measurements and performs one measurement CONF TEMP Configure the instrument for temperature measurement READ Perform a measurement and send the reading to the output buffer 2 500000E 01 Typical response 3 3 6 Simple Measurement Syntax For TED4000 Series instr
58. gral 53 LOW 52 MIN MAX lt temperature gt GAIN 53 DERivativel53 MIN lt value gt PERiodl53 MI ATUNe 54 Le CANCe1 541 STATe 54 MI N MAX MIN N MAX N Tiate l s54 LCONstantsl 54 GAIN 54 INTegral ls DERivative 54 PERiod 54 TRANs fer 54 PROTection s58 TRIPped 58 50 D D EE Ei MAX EF lt value gt MAX DEF lt value gt DEF lt seconds gt DELay 58 MIN MAX DEF lt seconds gt WINDow AMPLitude 58l MIN MAX EF lt temperature gt Description Set current setpoint Return current setpoint Set temperature setpoint Set settable temperature high limit Set settable temperature low limit Set PID loop P value Set PID loop value Set PID loop D value Set thermal load oscillation period Start AUTO PID tune Cancel AUTO PID tune Query AUTO PID state Query AUTO PID P value Query AUTO PID value Query AUTO PID D value Query AUTO PID oscillation period Transfer AUTO PID to control loop Set protection delay Set temperature window amplitude Query protection tripped 2012 Thorlabs 3 Commands by Subsystem 3 11 1 TEC Source Function Syntax SOURce 1 2 FUNCtion MODE TEMPerature CURRent SOURce 1 2 FUNCtion M
59. horlabs 3 Commands by Subsystem 3 11 5 TEC Temperature Setpoint Syntax SOURce 1 2 TEMPerature SPOint MIN MAX DEF lt temperature gt SOURce 1 2 TEMPerature SPOint MIN MAX DEF Description The souRce 1 2 TEMPerature SPOint Command sets the temperature setpoint in the selected temperature unit in temperature control mode The default value is 25 0 C Example SOUR TEMP 25C Sets the temperature setpoint to 25 C on a TED4000 Series instrument SOUR2 TEMP Queries the temperature setpoint of a ITC4000 Series instrument 2 500000E 01 Typical response This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 3 11 6 PID Loop Constants Syntax SOURce 1 2 TEMPerature LCONstants GAIN MIN MAX DEF lt value gt SOURce 1 2 TEMPerature LCONStants GAIN MIN MAX DEF SOURce 1 2 TEMPerature LCONstants INTegral MIN MAX DEF lt value gt SOURce 1 2 TEMPerature LCONstants INTegral MIN MAX DEF SOURce 1 2 TEMPerature LCONstants DERivative MIN MAX DEF lt value gt SOURce 1 2 TEMPerature LCONstants DERivative MIN MAX DEF SOURce 1
60. horlabs 69 Series 4000 SCPI Programmers Reference Manual 3 14 6 Status Preset Command Syntax STATus PRESet Description The STATus PRESet command presets the registers of the Auxiliary Register Group s the Measurement Register Groupls7 the Questionable Register Grouplss and the Operation Register Group s to the default values shown in the table below Table 24 Default Register Values Register Default Value Auxiliary Status Enable Register all set Auxiliary Status Positive Transition Register all set Auxiliary Status Negative Transition Register all cleared Measurement Status Enable Register all set Measurement Status Positive Transition Register all set Measurement Status Negative Transition Register all cleared Questionable Status Enable Register all cleared Questionable Status Positive Transition Register all set Questionable Status Negative Transition Register all cleared Standard Operation Status Enable Register all cleared Standard Operation Status Positive Transition Register all set Standard Operation Status Negative Transition Register all cleared For more information on the SCPI Status System for Thorlabs 4000 Series instruments see chapter Programming and Reading Registers 651 70 2012 Thorlabs 3 Commands by Subsystem 3 15 Memory Subsystem Commands The MEMory subsystem manages instrument memory Table 25 Memory Commands Command Description MEMory Path to memory subsystem NSTates 71
61. is command is valid for ITC4000 instruments only The ouTPut 1 PROTection INTLock TRIPped query command returns 1 if the interlock circuit is open The outTPut 1 PROTection KEYLock TRIPped query command returns 1 if the front panel key switch is in the lock position The ouTPut 1 PROTection OTEMp TRIPped query command returns 1 if the instrument s internal temperature is too high Example 30 2012 Thorlabs OUTP PROT KEYL TRIP Queries the front panel key switch Typical response These commands are valid for LDC4000 and ITC4000 only 3 5 PD Input Commands The 3 Commands by Subsystem INPut 1 subsystem controls the PD input of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only For LDC4000 and ITC4000 Series instruments the command suffix is 1 can be omitted Table 9 PD Input Commands Command TNE hy POLarity 31 NORMal CG INVerted AG POLarity 31l 3B w TAS STATe 2 22 JB ROUTe TERMinals B IAS STATe 32 OFF 0 ON 1 IAS VOLTage DC 321 MIN MAX DEF lt volts gt IAS VOLTage DC 32 MIN MAX DEF 33 DSUB BNC ROUTe TERMinals 33 See also chapter PD Sense Commands 221 3 5 1 Polarity Syntax INPut 1 INPut 1 POLarity NORMal CG INVerted AG L POLarity Description The CG o
62. it is set subsequent events corresponding to that bit are ignored This is a read only register Once a bit is set it remains set until cleared by a query or clear status cLs 13 command An enable register defines which bits in the event register will be reported to the Status Byte Register Group You can write to or read from an enable register A filter register positive negative transition register defines which transition of the condition register will cause an event for the event register A set bit in the positive negative transition register will lead to a set bit in the event register when a low to high high to low transition of the corresponding bit in the condition register occurs The only registers that can be programmed by the user are the enable and the filter registers All other registers in the status structure are read only registers The following explains how to get the parameter values for the various commands used to program enable registers A command to program an event enable register or a filter register is sent with a parameter value that determines the desired state 0 or 1 of each bit in the appropriate register An enable register or a filter register can be programmed using binary decimal hexadecimal or octal data formats for the parameter value for a detailed description of numeric formats see chapter 7 7 4 lt NONDECIMAL NUMERIC PROGRAM DATAS of IEEE488 2 1992 Example The four commands program
63. labs com Email sales uk thorlabs com Support techsupport uk thorlabs com Scandinavia Thorlabs Sweden AB M lndalsv gen 3 412 63 G teborg Sweden Tel 46 31 733 30 00 Fax 46 31 703 40 45 www thorlabs com Email scandinavia thorlabs com China Thorlabs China Room A101 No 100 Lane 2891 South Qilianshan Road Putuo District Shanghai 200331 China Tel 86 21 60561122 Fax 86 21 32513480 www thorlabs hk Email chinasales thorlabs com 89 Series 4000 SCPI Programmers Reference Manual Exclusion of Liability and Copyright Thorlabs GmbH has taken every possible care in preparing this Operation Manual We however assume no liability for the content completeness or quality of the information contained therein The content of this manual is regularly updated and adapted to reflect the current status of the software We furthermore do not guarantee that this product will function without errors even if the stated specifications are adhered to Under no circumstances can we guarantee that a particular objective can be achieved with the purchase of this product Insofar as permitted under statutory regulations we assume no liability for direct damage indirect damage or damages suffered by third parties resulting from the purchase of this product In no event shall any liability exceed the purchase price of the product Please note that the content of this User Manual is neither part of any previous or existing agre
64. liance voltage TEC connection failure Over temperature oa Questionable Data Register Error Queue Quest voltage measure Quest current measure Error available Quest power measure Quest temp measure Standard Operation Register Status Byte Register e Condition Register Positive Negative Transition Register Status Byte Enable Register r Event Register 7 Enable Register Ranging Measuring Waiting for trigger Correcting Auto PID LD output state is ON Service LD output is currently ON Request TEC output is ON Figure 1 Status Structure 64 2012 Thorlabs 3 Commands by Subsystem 3 14 1 Programming and Reading Registers The status system records various instrument conditions and states in several register groups Each register group is made up of several low level registers called the condition register event register filter register and enable register which control the action of specific bits within the register group A condition register continuously monitors the state of the instrument The bits in the condition register are updated in real time and the bits are not latched or buffered This is a read only register and the bits are not cleared when you read the register An event register latches the various events from the changes in the condition register There is no buffering in this register while an event b
65. m VERSion Command queries the level of the SCPI standard implemented This is a query only command Example SYST VERS Query the SCPI version 1999 0 Typical response 3 3 Measurement Commands Table 5 Measurement Commands for a TED4000 Series Instrument Command Description ABORt 21 Aborts the current measurement CONFigure SCALar 21 TeMPeraturc Configures instrument for temperature measurement CURREmE 1 fe bei Configures instrument for TEC current measurement 16 2012 Thorlabs Command VOLTage 1 DC POWer 1 TSENsor CONFigure 2tl INITiate IMMediate 23 FETCh 23 Ss FETCh 23 TEMPerature sCUIRNRSiove 1 J sD VOLTAGE TDCI POWer 1 SR OEINS is A READ 25 MEASure SCALar 25 TEMPerature SCURIREioe iL i s DC 2 VOLTage 1 DC POWer 1 TSENsor 3 Commands by Subsystem Description Configures instrument for TEC voltage measurement Configures instrument for TEC power measurement Configures for sensor signal measurement Returns the current configuration Starts measurement Returns the last measurement data The data returned is the data configured with the last CONFigure SCALar or the last MEASure SCALar Command Returns the last measured temperature Returns the last measured TEC current Returns the last measured TEC voltage Returns the la
66. n CABLe 60 Path to cable failure detection TRIPped Return protection tripped TRANsducer_ e0 Path to temperature sensor protection TRIPped Return protection tripped OTEMp 60 Path to Over Temperature protection circuit TRIPped Return protection tripped 2012 Thorlabs 59 Series 4000 SCPI Programmers Reference Manual 3 13 1 Output State Syntax OUTPut 1 2 STATe OFF 0 ON 1 OUTPut 1 2 STATe Description The outTPut 1 2 STATe command switches the instrument s TEC output on off Example OUTP ON Switches the TEC output of a TED4000 Series instrument on OUTP Queries the state of the TEC output of a TED4000 Series instrument OUTP2 ON Switches the TEC output of an ITC4000 Series instrument on OUTP2 Queries the state of the TEC output of an ITC4000 Series instrument 7 The response is ASCII 1 if the output is switched on or an ASCII 0 if the output is off The RST 10 command switches the output off These commands are valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 3 13 2 Protection Queries Syntax OUTPut 1 PROTection CABLe TRIPped OUTPut 1 PROTection TRANsducer TRIPped OUTPut 1 PROTection OTEMp TRIPped Description The oOUTPut 1 PROTection CABLe TRIPped query command returns a 1 if the cable connec
67. n photodiode current limit value TRIPed Return protection tripped CORRECTION IN ee 4 Set photodiode responsivity MIN MAX DEF lt amps gt value in Ay POWer PDIode RESPonse 2 44 MIN MAX DEF Return photodiode responsivity value in wy POWer DC power RANGe UPPer 144 MIN MAX Return photodiode range setting in units of power PROTectionl 45 LEVel MIN MAX DEF lt watts gt Set power limit value photodiode Return power limit value photodiode Return protection tripped LEVel MIN MAX DEF a Wikies 42 2012 Thorlabs 3 Commands by Subsystem 3 8 1 Photodiode Current Range Syntax SENSe 1 CURRent DC RANGe UPPer MIN MAX lt amps gt SENSe 1 CURRent DC RANGe UPPer MIN MAX Description The SENSe 1 CURRent DC RANGe UPPer command sets the photodiode current range to the most appropriate range for the given value Example SENS RANG 1 7mA Sets the photodiode current range to 2 mA this is valid for 4000 Series instruments with a 2 mA photodiode input range SENS RANG MAX Queries the biggest available photodiode current range 2 000000E 02 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 8 2 Photodiode Current Protection Syntax
68. ned 2 6 3 Boolean Parameters Boolean parameters represent a single binary condition that is either true or false For a false condition the instrument will accept oFF or 0 For a true condition the instrument will accept on or 1 When you query a boolean setting the instrument will always return 0 or 1 Boolean parameters may also have a default condition In this manual the default conditions are underlined 2 6 4 ASCII String Parameters String parameters can contain virtually any set of ASCII characters A string must begin and end with matching quotes either with a single quote or a double quote You can include the quote delimiter as part of the string by typing it twice without any characters in between 8 2012 Thorlabs 3 Commands by Subsystem 3 Commands by Subsystem 3 1 IEEE 488 2 Commands The IEEE 488 2 standard defines a set of common commands that perform functions such as reset self test and status operations Common commands always begin with an asterisk are three characters in length and may include one or more parameters The command keyword is separated from the first parameter by a blank space Use a semicolon to separate multiple commands IEEE488 2 commands are device commands that are common to all devices according to the IEEE488 2 standard Most of the commands are described in detail in this section The following common commands associated with the status structure are related to the STATus Subsy
69. o read or copy a nonexistent file File name error Indicates that a legal program command or query could not be executed because the file name on the device media was in error for example an attempt was made to copy to a duplicate file name 2012 Thorlabs 81 Series 4000 SCPI Programmers Reference Manual 258 Media protected Indicates that a legal program command or query could not be executed because the media was protected for example the write protect tab on a disk was present 82 2012 Thorlabs 4 SCPI Error Messages 4 3 Device Specific Errors Error 310 311 313 314 315 321 330 340 350 363 Description System error Indicates that some error termed system error by the device has occurred Memory error Indicates some physical fault in the device s memory such as parity error Calibration memory lost Indicates that nonvolatile calibration data used by the cAL command has been lost Save recall memory lost Indicates that the nonvolatile data saved by the sav command has been lost Configuration memory lost Indicates that nonvolatile configuration data saved by the device has been lost Out of memory An internal operation needed more memory than was available Self test failed There was an error detected during a self test During a self test the instrument checks the internal hardware for proper function Calibration failed The instrument is not or impr
70. olts gt OUTPut 1 PROTection VOLTage LEVel MIN MAX DEF Description The outTPut 1 PROTection VOLTage LEVel Command sets the output voltage protection compliance voltage threshold If this threshold is reached the output switches off Example OUTP PROT VOLT 8 0 Sets the LD output protection voltage to 8V 28 2012 Thorlabs 3 Commands by Subsystem OUTP PROT VOLT MAX Queries the maximum settable LD output protection voltage 1 000000E 01 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 4 5 Temperature Protection Mode Syntax OUTPut 1 PROTection INTernal MODE OFF PROTection ENABle OUTPut 1 PROTection INTernal MODE Description The ouTPut 1 PROTection INTernal MODE command sets the function of the internal temperature protection circuit Parameter Description OFF Temperature protection is disabled and has no effect on the LD output PROTection Acts as protection If the temperature is out of bounds the LD output is switched off ENABle Acts as enable If the temperature is out of bounds the LD output is disabled temporarily Example OUTP PROT INT ENAB Sets the temperature protection mode to output enable mode This command is valid for ITC4000 Series instruments only See also Temperature Protection s8 for further details 3 4 6 LD ENABLE Input Mode
71. olts gt SENSe2 VOLTage DC RANGe UPPer MIN MAX Description The SENSe2 VOLTage DC RANGe UPPer command sets the thermopile power meter voltage range to the most appropriate range for the given value Example SENS2 RANG 0 5 Sets the thermopile power meter voltage range to 1 0 V this is valid for 4000 Series instruments with a 1 V thermopile power meter input range SENS2 RANG MAX Queries the biggest available thermopile power meter voltage range 1 000000E 01 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 9 2 Thermopile Power Meter Voltage Protection Syntax SENSe2 VOLTage DC PROTection LEVel MIN MAX DEF lt volts gt SENSe2 VOLTage DC PROTection LEVel MIN MAX DEF SENSe2 VOLTage DC PROTection TRIPped Description 46 2012 Thorlabs 3 Commands by Subsystem The SENSe2 VOLTage DC PROTection LEVel command sets the thermopile power meter voltage limit value The SENSe2 VOLTage DC PROTection TRIPped query command returns an ASCII 1 if the thermopile power meter voltage limit value is currently reached or an ASCII o if the thermopile power meter voltage is currently below that limit Example SENS2 PROT 0 4V Sets the thermopile power meter voltage limit to 400 mV This command is valid for LDC4000 and ITC4000 Series instruments only 3 9
72. omplete listing of error messages see chapter SCPI Error Messages 7 16 Execution Error An execution error occurred an error in the 200 299 range has been generated 32 Command Error A command syntax error occurred an error in the 100 199 range has been generated 64 User Request 128 Power On Power has been turned off and on since the last time the event register was read or cleared E 4 Sets bit 2 of the Standard Event Status Enable Register which enables bit 2 of the Standard Event Register to be reported to bit 5 of the Status Byte Register 3 2 Sys tem Subsystem Commands Table 4 System Subsystem Commands Command Description SYSTeml 21 BEEPer 15 IMMediate Issues an audible signal Pouce ON Orn 10 Activates deactivates the beeper 14 2012 Thorlabs 3 Commands by Subsystem Command Description ele Returns the state of the beeper ERRor 15 NEXT Returns the latest lt error code gt Message LFRequency 16 50 60 AUTO Sets the line frequency to fixed 50 60Hz or auto detect ACTual Returns the used line frequency LFRequency 16 Returns the line frequency setting VERSion 16 3 2 1 Beeper Syntax SYSTem BEEPer Returns the level of SCPI standard 1999 0 MMediate SYSTem BEEPer STATe ON 1 OFF 0 SYSTem BEEPer STATe Description The SsyStTem BEEPer 1 The syStTem B E
73. oper calibrated Queue overflow A specific code entered into the queue in lieu of the code that caused the error This code indicates that there is no room in the queue and an error occurred but was not recorded Input buffer overrun Software or hardware USB input port buffer overflows with data caused by improper or nonexistent pacing 4 4 Query Errors Error 400 410 Description Query error This code indicates that a generic Query Error as defined in IEEE 488 2 11 5 1 1 7 and 6 3 has occurred Query INTERRUPTED Indicates that a condition causing an INTERRUPTED Query error occurred see IEEE 488 2 6 3 2 3 for example a query followed by another query before a response was completely sent 2012 Thorlabs 83 Series 4000 SCPI Programmers Reference Manual 4 5 Error 3 20 22 23 24 25 26 27 28 30 31 32 33 34 35 36 84 Instrument Errors Description Instrument is overheated The device s internal temperature is too high Not permitted with LD output on Operation is not allowed while the LD output is switched on Interlock circuit is open Operation is not allowed while the interlock protection is tripped Key switch is in locked position Operation is not allowed while the front panel key switch protection is tripped LD open circuit detected Operation is not allowed while the LD output voltage protection is tripped LD ENABLE input is de asserted Opera
74. orm the unit s self test and return the result WAT 121 Wait to continue Wait until all previous commands are executed command 2012 Thorlabs 9 Series 4000 SCPI Programmers Reference Manual 3 1 1 IDN Identification Query Syntax TDN Description The identification query reads the instrument s identification code which contains four comma separated fields The first field is the manufacturer the second field is the model code the third filed is the serial number and the fourth field is the firmware revision code which contains two LDC4000 or three TED4000 ITC4000 codes separated by slashes The query is sent in the following format THORLABS MMM SSS X X X Y Y Y Z 2 2Z Where MMM is the model code SSS is the serial number X X X is the instrument firmware revision level Y Y Y is the firmware revision level of the front panel board Z 2 2 is the firmware revision level of the temperature controller board TED4000 ITC4000 only Example IDN Query the ID code 2 THORLABS ITC4020 E12345678 1 4 0 2 0 3 1 6 0 Typical response 3 1 2 RST Reset Syntax RST Description When the rst command is sent the instrument performs the following operations e Switches off the instrument s outputs e Sets the direction of general purpose O to input e Switches photodiode BIAS to OFF 10 2012 Thorlabs 3 Commands by Subsystem 3 1 3 SAV RCL SDS Save Recall
75. ors are cleared as you read them When you have read all errors from error queue the ERROR annunciator turns off e If more than 10 errors have occurred the last error stored in the queue the most recent error is replaced with 350 Error queue overflow No additional errors are stored until you read from the queue e f no errors have occurred when you read the error queue the instrument responds with 0 No error e Error conditions are also summarized in the Status Byte Register For more information on the SCPI Status System for the LDC4000 TED4000 and ITC4000 Series instruments see chapter Status Subsystem Commands e2 e The error queue is cleared by the cusli Clear Status command and when power is cycled All errors are cleared when you read the error queue The error queue is not cleared by the Reset RsTI 10 command or an status preset command STATus PRESet 70 command e For reading the error queue refer to chapter Error Query 151 78 2012 Thorlabs 4 SCPI Error Messages 4 1 Command Errors Error Description 100 Command error This is the generic syntax error for devices that cannot detect more specific errors This code indicates only that a Command Error as defined in IEEE 488 2 11 5 1 1 4 has occurred 101 Invalid character A syntactic element contains a character which is invalid for that type for example a header containing an ampersand SETUP amp This error might be used in place
76. pellings Other spellings like CUR or CURRe are not allowed and will generate an error Commands are not case sensitive Curly braces enclose the parameter choices for a given command string Braces are not sent with the command string A vertical bar separates multiple parameter choices for a given command string For example MINimum MAXimum lt amps gt in the above command indicates that you can specify a numeric current parameter or MINimum Of MAXimum The bar is not sent with the command string Triangle brackets lt gt indicate that you must specify a value for the enclosed parameter For example the above syntax statement shows the lt amps gt parameter enclosed in triangle brackets The brackets are not sent with the command string You must specify a value for the parameter for example 5 0 unless you select one of the other options shown in the syntax for example MIN Some parameters and even parts of the command itself are enclosed in square brackets This indicates that the part of the command or the parameter is optional and can be omitted The brackets are not sent with the command string If you do not specify a value for an optional parameter the instrument chooses a default value 2012 Thorlabs 5 Series 4000 SCPI Programmers Reference Manual 2 2 Command Separators A colon is used to separate a command keyword from a lower level keyword You must insert a blank space to separate
77. period time of the internal modulator The SOURce 1 PULSe WIDTh command sets the pulse width of the internal modulator The SoURce 1 PULSe DCYCle command sets the duty cycle of the internal modulator The SoURce 1 PULSe HOLD command sets for a pulsed waveform the parameter to be held constant when the period changes Example SOUR PULS PER 0 0001 Sets the pulse period to 100us SOUR PULS DCYC MIN Sets the duty cycle of the internal modulation to its minimum SOUR PULS HOLD Queries the parameter to be held constant for a pulsed waveform WIDT The response is either WIDT or Dcyc This command is valid for LDC4000 and ITC4000 Series instruments only 2012 Thorlabs 41 Series 4000 SCPI Programmers Reference Manual 3 8 PD Sense Commands The SENSe 1 subsystem controls the photodiode PD sense part of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only For LDC4000 and ITC4000 Series instruments the command suffix is 1 can be omitted Table 12 PD Sense Commands Command Description SENSe 1 Path to PD sense subsystem sCURIRGIa E 3 IDC RANGe UPPer 43 MIN MAX lt amps gt Set photodiode range RANGe UPPer 43 MIN MAX Return photodiode range PROTection 43 LEVel MIN MAX DEF lt amps gt Set photodiode current limit value FSS Ie CMIM MAX DER 1 Retur
78. ption 58 2012 Thorlabs 3 Commands by Subsystem The SENSe 1 3 TEMPerature PROTection WINDow AMPLitude sets the temperature window width The SENSe 1 3 TEMPerature PROTection DELay sets the temperature window protection reset delay The SENSe 1 3 TEMPerature PROTection TRIPped query command returns an ASCII 1 if the window protection is currently active or an ASCII 0 if it s inactive Example SENS TEMP PROT WIND 1 5K DEL 5 Sets the temperature window amplitude to 1 5 Kelvin and the protection reset delay to 5 seconds for a TED4000 Series instrument This command is valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 3 See also Temperature Protection Mode 29 to protect the LD output of an ITC4000 Series instrument 3 13 TEC Output Commands The outTPut 1 2 subsystem controls the TEC output of the instrument These commands are valid for TED4000 and ITC4000 Series instruments only For TED4000 Series instruments the command suffix is 1 can be omitted for ITC4000 Series instruments the suffix is 2 Table 17 TEC Output Commands Command Description OUlrPuEq 11112 Path to TEC output function STATe 60 ON 1 OFF 0 Enable ON or disable OFF TEC output STATe l60 Return output state JERONE EGN Path to TEC output protectio
79. r anode ground 1 conformance 2012 Thorlabs Description Path to PD input Set input state Return input state Switch PD Bias on or off Return PD Bias state Set PD Bias voltage level Return PD Bias voltage Set PD input routing Return PD input routing INPut 1 POLarity command sets the PD input polarity to cathode ground NoRMa1 or NVerted or AG The parameters NoRMal and INVerted are for SCPI 31 Series 4000 SCPI Programmers Reference Manual Example INP POL CG Sets the PD input polarity to cathode ground INP POL Queries the PD input polarity cG The response is either cc or AG This command is valid for LDC4000 and ITC4000 Series instruments only 3 5 2 BIAS State Syntax INPut 1 BIAS STATe OFF 0 ON 1 INPut 1 BIAS STATe Description The INPut 1 BIAS STATe command switches the instrument s PD input BIAS on off Example INP BIAS ON Switches the PD input BIAS on INP BIAS Queries the state of the PD input BIAS 1 The response is ASCII 1 if the BIAS is switched on or an ASCII 0 if the BIAS is off This command is valid for LDC4000 and ITC4000 Series instruments only The rst 10 command switches the BIAS off 3 5 3 BIAS Voltage Syntax INPut 1 BIAS VOLTage DC MIN MAX DEF lt volts gt INPut 1 BIAS VOLTage DC MIN MAX DEF Description The INPut 1 BIAS V
80. r stale Possibly invalid data new reading started but not completed since last access Data questionable Indicates that measurement accuracy is suspect Hardware error Indicates that a legal program command or query could not be executed because of a hardware problem in the device Hardware missing Indicates that a legal program command or query could not be executed because of missing device hardware for example an option was not installed Mass storage error Indicates that a mass storage error occurred Missing mass storage Indicates that a legal program command or query could not be executed because of missing mass storage for example an option that was not installed Missing media Indicates that a legal program command or query could not be executed because of a missing media for example no SD card or no USB stick Corrupt media Indicates that a legal program command or query could not be executed because of corrupt media for example bad SD card or wrong format Media full Indicates that a legal program command or query could not be executed because the media was full for example there is no room on the SD card Directory full Indicates that a legal program command or query could not be executed because the media directory was full File name not found Indicates that a legal program command or query could not be executed because the file name on the device media was not found for example an attempt was made t
81. s 3 20 Calibration Subsystem Commands 4000 Series instruments do not provide an internal calibration mechanism they are calibrated at the factory The CALibration subsystem for 4000 Series instruments only provides a means of retrieving the instrument s calibration string This string is factory set at calibration time 76 2012 Thorlabs 3 Commands by Subsystem Table 31 Calibration Commands Command Description CALibration Path to calibration functions STRing 177 Return the calibration string 3 20 1 Calibration String Syntax CALibration STRing Description The CALibration STRing command returns the calibration string Example CAL STR Queries the calibration string CALIBRATED JUNE 30 2009 Typical response 2012 Thorlabs 77 Series 4000 SCPI Programmers Reference Manual 4 SCPI Error Messages Command Errors 199 100 731 Execution Errors 299 200 8 Device Specific Errors 399 300 83 Query Errors 499 400 83 Instrument Errors 0 84 LDC4000 TED4000 and ITC4000 Series instruments return error messages in accord with the SCPI standard e A record of up to 10 errors can be stored in the instrument s error queue e The front panel ERROR annunciator turns on when one or more errors are currently stored in the error queue e Errors are retrieved in first in first out FIFO order The first error returned is the first error that was stored e Err
82. s in the SouRce 1 AM SOURce Command are all selected and turned on Any sources from a previous selection that are not part of the current selection list are deselected and turned off The SsouRce 1 AM INTernal SHAPe command sets the internal modulation shape The SoURce 1 AM INTernal command sets the internal modulation depth Example SOUR AM 1 Enables LD source modulation on a LDC4000 Series or an ITC4000 Series instrument SOUR AM SOUR EXT Selects the external BNC connector as source for modulation 40 2012 Thorlabs 3 Commands by Subsystem SOUR AM SOUR INT EXT Selects both internal modulator and external BNC connector as source for modulation SOUR AM INT FREQ DEF Queries the default internal modulation frequency 1 000000E 03 Typical response This command is valid for LDC4000 and ITC4000 Series instruments only 3 7 7 QCW Pulse Setting Syntax SOURce 1 PULSe PERiod MIN MAX DEF lt secs gt SOURce 1 PULSe PERiod MIN MAX DEF SOURce 1 PULSe WIDTh MIN MAX DEF lt secs gt SOURce 1 PULSe WIDTh MIN MAX DEFault SOURce 1 PULSe DCYCle MIN MAX DEF lt percent gt SOURce 1 PULSe DCYCle MIN MAX DEF SOURce 1 PULSe HOLD WIDTh DCYCle SOURce 1 PULSe HOLD Description The SoURce 1 PULSe PERiod command sets the
83. st measured TEC power Returns the last measured sensor signal Starts new measurement and returns data Measures temperature Measures TEC current Measures TEC voltage Measures TEC power Measures sensor signal Table 6 Measurement Commands for a LDC4000 Series Instrument Command ABORt 21 CONFigure SCALar 2t1 CURRent 1 DC VOLTage 1 DC 7CURRene7 IDE POWer2 VOLTage2 DC POWer3 2012 Thorlabs Description Aborts the current measurement Configures instrument for LD current measurement Configures instrument for LD voltage measurement Configures instrument for PD current measurement Configures instrument for power measurement via photodiode Configures instrument for thermopile power meter voltage measurement Configures instrument for power measurement via thermopile power meter 17 Series 4000 SCPI Programmers Reference Manual Command POWer 1 CONFigure 21 IN ITiate IMMediate 23 FETCh 23 zal vs ES CURRent2 POWer2 VOLTage2 CURRent CURRent2 POWer2 gt VOLTage2 ETChI 23 CURRent 1 VOLTage 1 POWer3 POWer 1 EAD 25 EASure SCALar 25 VOLTage 1 POWer3 POWer 1 LL MEDIR SDCI 2 IDE DEIR Description Configures instrument for LD electrical input power measurement Returns the current configuration Starts measurement
84. stem Commands 2 section CLS ESE ESE ESR SRE SRE STB See also figure Status Structure 21 Table 1 IEEE 488 2 commands Mnemonic Name Description CLS 13 Clear status Clear all event registers and Error Queue ESE 13 lt value gt Event enable Program the Standard Event Enable Register command ESE 13 Event enable Read the Standard Event Enable Register query ESR 13 Event status Read and clear the Standard Event Register register query IDN 10 Identification Read the unit s identification string query opcl 1 Operation Set the Operation Complete bit in the Standard Event complete Register command OPC 11 Operation Place a 1 into the output queue when all device complete query operations have been completed RCL 11 lt value gt Recall command Return the unit to the user saved setup RST 10 Reset command Return the unit to the RST default condition SAV 11 lt value gt Save default Initialize the content of save recall registers device setting xspsli lt value gt Save default Initialize the content of save recall registers device setting SRE 12 lt value gt Service request Program the Service Request Enable Register enable command SRE 12 Service request Read the Service Request Enable Register enable query STB 12 Status byte query Read the Status Byte Register TST 411 Self test query Perf
85. t SOURGS 1 2 sCURReine sib WelL 3 amp MMediate 52 AMPLitude 52 TED sensor selection TED transducer offset TED temperature protection window WINDow AMPLitude 58 SENSe 1 3 TEMPerature TRANsducer TYPI SENSe 1 3 TEMPerature 0FFSet 58 SENSe 1 3 TEMPerature PROTect ion sal TED temperature protection window reset delay SENSe 1 3 TEMPerature PROTect ion DELay 56I TED PID control loop gain value P share SOURce 1 2 TEMPerature LCONstants GAI TED PID control loop integral value share SOURCe 2 TEMPerature LCONstants 1 TED PID control loop derivative value D share SOURce 1 2 TEMPerature LCONstants 53 DERivativels3 TED PID control loop period SOURce 1 2 TEMPerature LCONstants PIl 2012 Thorlabs E 56 N 53 NTegralls53 ERiodl 53 5 Appendix Default Value lt value gt 0 Amperes 0 0 Amperes 0 0 Volts 0 0 Watts 0 const temperature TEMP e g 0 1 A eal 0 Amperes 0 AD590 sensor AD590 0 C OK 0 5 0 C 5 1 second il 1 04 1 0 1 A s omi 0 0 1 08s 87 Series 4000 SCPI Programmers Reference Manual Parameter SCPI command to set parameter TED temperature setpoint limit high SOURce 1 2 TEMPerature LIMit HIGH 5
86. t Commands The ouTPut 1 subsystem controls the LD output of the instrument These commands are valid for LDC4000 and ITC4000 Series instruments only For LDC4000 and ITC4000 Series instruments the command suffix is 1 can be omitted Table 8 LD Output Commands Command Description OUTPut 1 Path to LD output STATe 271 OFF ON 01 1 Set output state DELay 27 MIN MAX DEF lt seconds gt Set switch on delay POLarity 28 NORMal CG INVerted AG Set output polarity PROTection VOLTage LEVel 28 MIN MAX DEF lt volts gt Set output protection voltage LEVel 28 MIN MAX DEF Return output protection voltage TRIPped 30 Return voltage protection tripped EXTernal MODE 29 OFF PROTect ion ENABle Set external protection mode TRIPped 30 Return external protection tripped INTernal 26 2012 Thorlabs 3 Commands by Subsystem Command Description MODE 28 OFF PROTection ENABle Set internal protection mode TRIPped 30 Return internal protection tripped INTLock TRIPped 30 Return interlock protection tripped KEYLock TRIPped 30 Return front panel key switch protection tripped OTEMp TRIPped 30 Return over temperature protection tripped 3 4 1 Output State Syntax OUTPut 1 STATe OFF 0 ON 1 OUTPut 1 STATe Description The outTPut 1 STATe command switches
87. t measured optical power via PD Returns the last measured thermopile power meter voltage Returns the last measured optical power via thermopile power meter Returns the last measured LD input electrical power Starts new measurement and returns data Measures temperature Measures TEC current Measures TEC voltage Measures TEC power Measures temperature sensor signal Measures LD current 19 Series 4000 SCPI Programmers Reference Manual Command 20 POWer2 VOLTage 1 DC CURREN EZI DECI VOLTage2 DC POWer3 BONE te IL Description Measures LD voltage Measures PD current Measures LD power via PD Measures thermopile power meter voltage Measures LD power via thermopile power meter Measures LD electrical input power 2012 Thorlabs 3 Commands by Subsystem 3 3 1 Abort Measurement in Progres Syntax ABORt Description This command aborts a measurement in progress Remarks This command aborts a measurement a measurement in progress and stops returning the instrument to the idle state Example ABOR Abort the measurement in progress 3 3 2 Configuring a Measurement Syntax For TED4000 Series instruments CONFigure SCALar TEMPerature CONFigure SCALar CURRent 1 DC CONFigure SCALar VOLTage 1 DC CONFigure SCALar POWer 1 CONFigure SCALar TSENsor CONFigure For LDC4000 Series instruments CONFigure SCALar CURRent 1
88. tage OFF 85 Series 4000 SCPI Programmers Reference Manual Parameter SCPI command to set parameter LDC photodiode BIAS voltage INPut UJ J LDC photodiode responsivity SENSe 1 REDI IAS VOLTage DC 32 CURRent DC CORRect ion POWer 44 ode RESPonse 441 LDC thermopile power meter voltage range SENSe2 LDC path for thermopile power meter routing LDC thermopile power meter responsivity SENSe2 VOLTage s a VOLTage DC RANGe UPPer 46 INPut2 ROUTe TERMinals 3A LDC amplitude modulation state SO LDC a SO LDC a SO LDC a SO LDC a SO U U Rce 1 Ree IN URce 1 URce 1 mplitude modulation depth URce 1 AM STATe 40 mplitude modulation source AM SOURce 40 mplitude modulation shape AM INTernal mplitude modulation frequency AM INTernal AM LDC enable input function QUT GE LDC internal OUTPut INTernal DEPTh 1 PROTection EXTernal 1 PROTection INTernal SHAPe 40 40 MOI temperature protection function MO FREQuency 40 D T B T E DC CORRection POWer 47 ERmopile RESPonse 471 23 29 LDC pulsed constant current QCW trigger source TRI Gger SEQuence SO
89. the Auxiliary Enable Register to the same value STAT AUX ENAB 208 Program the Auxiliary Enable Register with 2018 decimal STAT AUX ENAB H821 Program the Auxiliary Enable Register with 821 hexadecimal STAT AUX ENAB 04041 Program the Auxiliary Enable Register with 4041 octal STAT AUX ENAB B100000100001 Program the Auxiliary Enable Register with 100000100001 binary 2012 Thorlabs 65 Series 4000 SCPI Programmers Reference Manual The bit positions of the register see table below indicate the binary parameter value For example if you wish to sets bits B11 B5 and BO the binary value would be 100000100001 where B11 1 B5 1 BO 1 and all other bits are 0 When you use one of the other formats convert the binary number to its decimal hexadecimal or octal equivalent Binary 100000100001 Decimal 2081 Hexadecimal 821 Octal 4041 Note that the table below includes the decimal weight for each register bit To set bits B11 B5 and BO the decimal parameter value would be the sum of the decimal weights for those bits 2048 32 1 2081 Table 19 16 bit Register Values bit position B7 B6 B5 B4 B3 B2 B1 BO binary value 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 decimal weights 128 64 32 16 8 4 2 1 as power of 2 27 2 2 2 2 2 2 2 bit position B15 B14 B13 B12 B11 B10 B9 B8 binary value 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 decimal weights 32768 16384 8192 4096 2048 10
90. the instrument s LD output on off Example OUTP ON Switches the LD output on OUTP Queries the state of the LD output 1 The response is ASCII 1 if the output is switched on or an ASCII o if the output is off This command is valid for LDC4000 and ITC4000 Series instruments only The RST 10 command switches the output off 3 4 2 Switch On Delay Syntax OUTPut 1 DELay MIN MAX DEF lt seconds gt OUTPut 1 DELay MIN MAX DEF Description 2012 Thorlabs 2 Series 4000 SCPI Programmers Reference Manual The ouTPut 1 DELay sets the output switch on delay of the LD output Example OUTP DEL 3 Sets the LD output switch on delay to 3 seconds This command is valid for LDC4000 and ITC4000 Series instruments only 3 4 3 Polarity Syntax OUTPut 1 POLarity NORMal CG INVerted AG OUTPut 1 POLarity Description The outTPut 1 POLarity command sets the LD output polarity to cathode ground NoRMal1 or CG or anode ground INVerted or AG The parameters NoRMal and INVerted are for SCPI conformance Example OUTP POL CG Sets the LD output polarity to cathode ground OUTP POL Queries the LD output polarity cc The response is either cc or Ac This command is valid for LDC4000 and ITC4000 Series instruments only 3 4 4 Protection Voltage Syntax OUTPut 1 PROTection VOLTage LEVel MIN MAX DEF lt v
91. the positive transition filter 2012 Thorlabs Command PTRansition NTRansition lt value gt NTRansition ENABle lt value gt ENABle PRESet 70 2012 Thorlabs 3 Commands by Subsystem Description Read the positive transition filter Program the negative transition filter Read the negative transition filter Program the enable register Read the enable register Return status registers to default states 63 Series 4000 SCPI Programmers Reference Manual Auxiliary Status Register Condition Register Positive Negative Transition Register r Event Register i r Enable Register General Purpose I O 1 General Purpose I O 2 General Purpose I O 3 General Purpose I O 4 Standard Event Register Event Register z Enable Register r i i i Operation Complete Query Error Device Dependent Error Execution Error Command Error User Request Power On Bleke E a Measurement Status Register r Condition Register e Positive Negative Transition Register r Event Register E o E Output Queue S N Message available 8 mom Keylock protection active LD compliance voltage LD interlock active LD current limit reached LD output inhibit active LD power limit reached kefe ie sa D ma FBR ell elle Aa a a oo N Temp protection active Temp window failure Temp sensor failure TEC comp
92. tion from pin 1 to pin 15 interlock of the TEC DRIVER 17W2 D Sub jack is disrupted and returns a 0 if the connection is closed The ouTPut 1 PROTection TRANsducer TRIPped query command returns 1 if a sensor failure condition is detected and a 0 if a sensor is detected The ouTPut 1 PROTection OTEMp TRIPped query command returns 1 if the internal temperature of the instrument is too hot and a 0 when not 60 2012 Thorlabs 3 Commands by Subsystem Example OUTP PROT CABL TRIP Queries the cable failure protection of the TEC part of the instrument o Typical response These commands are valid for TED4000 and ITC4000 only 2012 Thorlabs 61 Series 4000 SCPI Programmers Reference Manual 3 14 Status Subsystem Commands The Status Subsystem of the 4000 Series instruments is implemented based on the SCPI 1999 0 standard chapter 9 Status Reporting and the status mechanism described in chapter 11 of IEEE 488 2 see also IEEE 488 2 commands Table 18 Status Commands Command STATUS AUXil EWA CON g IR IPIS ZRI NTR NTR ENAI iary 66 ENt Dition ansition lt value gt ansition ansition lt value gt ansition Ble lt value gt ENAI Ble MEASu rement 67 SEW ENt CON RIP UU SIP UIE NTR NTR ENAI Dali Loin ansition lt value gt ansition ansition
93. tion is not allowed while the external protection is tripped This error occurs when the rear panel LD enable input is set to protection mode and has a low level LD temperature protection is active Operation is not allowed while the temperature protection is tripped ITC 4000 Series instruments only Not permitted with photodiode BIAS on Operation is not allowed while the photodiode BIAS is switched on Not permitted with QCW mode on Operation is not allowed while QCW mode is enabled Not permitted with TEC output on Operation is not allowed while the TEC output is switched on Wrong TEC source operating mode Operation is not allowed for the selected TEC operating mode PID Auto Tune is currently running Operation not allowed while the PID Auto Tune procedure is running PID Auto Tune value error An PID Auto Tune procedure was not able to detect proper values TEC open circuit detected Operation is not allowed while the TEC output voltage protection is tripped Temperature sensor failure Operation is not allowed while the temperature sensor protection is tripped E g no or wrong sensor connected TEC cable connection failure Operation is not allowed while the TEC cable connection failure protection is tripped 2012 Thorlabs 5 Appendix 5 1 Instrument Default Settings 5 Appendix The instrument s default settings can be set with the sps 1 command The following table lists the parameters affected by the command
94. uments MEASure SCALar TEMPerature MEASure SCALar CURRent 1 DC MEASure SCALar VOLTage 1 DC MEASure SCALar POWer 1 MEASure SCALar TSENsor For LDC4000 Series instruments MEASure SCALar CURRent 1 DC MFASure SCALar VOLTage 1 DC MEASure SCALar CURRent2 DC EFASure SCALar POWer2 EFASure SCALar VOLTage2 DC EASure SCALar POWer3 EFASure SCALar POWer 1 Ss ss For ITC4000 Series instruments MEASure SCALar TEMPerature MEASure SCALar CURRent3 DC MEASure SCALar VOLTage3 DC MEASure SCALar POWer4 2012 Thorlabs 25 Series 4000 SCPI Programmers Reference Manual MEASure SCALar TSENsor MEASure SCALar CURRent 1 DC MFASure SCALar VOLTage 1 DC MEASure SCALar CURRent2 DC MEASure SCALar POWer2 MBASure SCALar VOLTage2 DC MEASure SCALar POWer3 MEASure SCALar POWer 1 Description The MEASure Command provides the easiest way to program the instrument for measurements However this command does not offer much flexibility The results are sent directly to the instrument s output buffer Sending MEASure is functionally the same as sending CoNFigure followed immediately by a READ command Example MEAS TEMP Query temperature of a TED4000 ITC4000 Series instrument 2 500000E 01 Typical response 3 4 LD Outpu
95. xample SYST BEEP The instrument w SYST BEEP STAT MMediate issues an audible signal EEPer STATe command activates or deactivates the beeper ill issue an audible signal Queries the state of the beeper activation 4 Response for beeper activated The response is ASCII 1 if the beeper is activated or an ASCII o if the beeper is deactivated 3 2 2 Error Query Syntax SYSTem ERRor NEXT Description The sySTem ERRor N EXT command queries the instrument s error queue This is a query only command For a detailed list of possible error codes see chapter SCPI Error Messages 781 Example SYST E RR Query the error queue 40 No error Typical response 2012 Thorlabs 15 Series 4000 SCPI Programmers Reference Manual 3 2 3 Line Frequency Syntax SYSTem LFRequency 50 60 AUTO SYSTem LFRequency ACTual SYSTem LFRequency Description The SySTem LFRequency sets the line frequency to use for signal filtering to the given value or to automatic detection With the SySTem LFRequency ACTual query the actual used value can be retrieved The sySTem LFRequency query returns the line frequency setting Example SYST LFR 50 Sets the line frequency setting to 50Hz SYST LFR ACT Queries the actual used line frequency 60 Typical response 3 2 4 SCPI Version Query Syntax SYSTem VERSion Description The sySTe
96. xpected number of parameters The number of parameters received does not correspond to the number of parameters expected 120 Numeric data error This error is generated when parsing a data element which appears to be numeric including the nondecimal numeric types 130 Suffix error This error as well as error 131 is generated when parsing a suffix 2012 Thorlabs 79 Series 4000 SCPI Programmers Reference Manual 131 Invalid suffix The suffix does not follow the syntax described in IEEE 488 2 7 7 3 2 or the suffix is inappropriate for this device 151 Invalid string data A string data element was expected but was invalid for some reason see IEEE 488 2 7 7 5 2 for example an END message was received before the terminal quote character 80 2012 Thorlabs 4 SCPI Error Messages 4 2 Execution Errors Error 220 221 222 230 231 240 241 250 251 252 253 254 255 256 257 Description Parameter error Indicates that a program data element related error occurred Settings conflict Indicates that a legal program data element was parsed but could not be executed due to the current device state see IEEE 488 2 6 4 5 3 and 11 5 1 1 5 Data out of range Indicates that a legal program data element was parsed but could not be executed because the interpreted value was outside the legal range as defined by the device see IEEE 488 2 11 5 1 1 5 Data corrupt o
97. y round the input numeric parameter to the accepted values Additionally numeric parameters can be programmed using binary decimal hexadecimal or octal data formats for the parameter value for a detailed description of numeric formats see chapter 7 7 4 lt NONDECIMAL NUMERIC PROGRAM DATAS of IEEE488 2 1992 Example The four commands program the Auxiliary Enable Register to the same value STAT AUX ENAB 208 Program the Auxiliary Enable Register with 2018 decimal STAT AUX ENAB H821 Program the Auxiliary Enable Register with 821 hexadecimal STAT AUX ENAB 04041 Program the Auxiliary Enable Register with 4041 octal STAT AUX ENAB B100000100001 Program the Auxiliary Enable Register with 100000100001 binary 2012 Thorlabs 7 Series 4000 SCPI Programmers Reference Manual 2 6 2 Discrete Parameters Discrete parameters are used to program settings that have a limited number of values like CELSius FAHRenheit Of KELVin They have a short form and a long form just like command keywords You can mix upper and lower case letters Query responses will always return the short form in all upper case letters Example The following command requires a discrete parameter for the temperature unit UNIT TEMPerature C CEL CELSius F FAR FAHRenheit K KELVin Discrete parameters may also have a default condition In this manual the default conditions are underli

Series 4000 Programmers Reference

Contents

Download Pdf Manuals

Related Search

Related Contents