DEVice - Device specification and properties

Device properties of Spektralwerk Core can be accessed using the DEVice root path. The individual information is deposited on the spectrometer during initialization. Most of the properties can not be altered by the user but provide necessary information about the internally used spectrometer head.

:CONSumption - Electrical consumption

query only

The electrical consumption of the Spektralwerk Core can be monitored using DEVice:CONSumption path.

Parent path: DEVice:CONSumption

SCPI String Query ? Command [<INPUT VALUE>]
:CURRent returns the current consumption -
  :UNIT returns the unit of the current consumption -
:POWer returns the power consumption -
  :UNIT returns the unit of the power consumption -
:VOLTage returns the voltage consumption -
  :UNIT returns the unit of the voltage consumption -

Example:

> DEVice:CONSumption:CURRent?
...
> DEVice:CONSumption:CURRent:UNIT?
I
> DEVice:CONSumption:POWer?
...
> DEVice:CONSumption:POWer:UNIT?
W
> DEVice:CONSumption:VOLTage?
...
> DEVice:CONSumption:VOLTage:UNIT?
V

:SPECtrometer - Spectrometer head properties

The spectrometer head represents a fundamental component of a Spektralwerk Core. Head-specific properties are found below the subcommand DEVice:SPECtrometer.

:ARRay - Spectrometer array properties

Technical properties concerning the spectrometer array itself are listed below DEVIce:SPECtrometer:ARRay.

:PCOunt - Number of spectrometer array pixels

query only

The DEVice:SPECtrometer:ARRay:PCOunt query provides information about the number of pixels in the built-in spectrometer array.

Parent path: DEVice:SPECtrometer:ARRay

SCPI String Query ? Command [<INPUT VALUE>]
:PCOunt returns the number of pixels of the built-in spectrometer array -

Example:

> DEVice:SPECtrometer:ARRay:PCOunt?
256

The value returned depends on the used hardware configuration and might differ.

:PEAK - Peak intensity of the spectrometer

query only

The maximum possible peak value (intensity counts of the spectrometer head) can be obtained with DEVice:SPECtrometer:ARRay:PEAK? query.

Parent path: DEVice:SPECtrometer:ARRay

SCPI String Query ? Command [<INPUT VALUE>]
:PEAK returns the maximum pixel intensity value of the built-in spectrometer array -

Example:

> DEVice:SPECtrometer:ARRay:PEAK?
65535

The value returned depends on the used hardware configuration and might differ.

:BACKground - Signal background adjustment

Properties affecting the noise background of the spectrometer (Dark Current Non-Uniformity (DCNU), read-out-noise, etc.) are located below DEVIce:SPECtrometer:BACKground. The background settings are already preconfigured to return the best possible result. Be careful when changing these parameters.

:OFFSet:VOLTage - Spectrometer ADC offset voltage

query and command

The DEVice:SPECtrometer:BACKground:OFFSet:VOLTage query and command path provide access to the spectrometer ADC offset voltage. The ADC offset voltage is used to adjust the signal level and the background noise with respect to the baseline.

In addition to the base command :OFFSet:VOLTage, additional subcommands are provided to inform about default offset voltage, maximum and minimum values and the unit of the provided values.

Parent path: DEVice:SPECtrometer:BACKground

SCPI String Query ? Command [<INPUT VALUE>]
:OFFSet:VOLTage returns the current spectrometer offset voltage <FLOAT>: sets target offset voltage
   :DEFault returns the default spectrometer offset voltage -
   :MAXimum returns the maximum allowed spectrometer offset voltage -
   :MINimum returns the minimum allowed spectrometer offset voltage -
   :UNIT returns the unit of the spectrometer offset voltage -

Example:

> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage?
0.600
> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage 0.800

> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage?
0.800
> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage:DEFault?
0.612
> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage:MAXimum?
1.200
> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage:MINimum?
0.300
> DEVice:SPECtrometer:BACKground:OFFSet:VOLTage:UNIT?
V

:CONNector - Spectrometer connector type

query only

The DEVice:SPECtrometer:CONNector? query provides information about the available fibre connection used in the current device. Possible return values are sma (SMA or SubMiniature version A) or fc_pc / fc_apc (FC or Ferrule Connector, Fiber Channel with or without angled physical contact polish).

Parent path: DEVice:SPECtrometer

SCPI Command String Query ? Command [<INPUT VALUE>]
:CONNector returns the kind of fibre connection -

Example:

> DEVice:SPECtrometer:CONNector?
fc_pc

DEVIce:SPECtrometer:PIXels lists pixel specific properties and values.

:SENSitivity - Pixel sensitivity

query only

The DEVIce:SPECtrometer:PIXels:SENSitivity? query provides a sensitivity value for each pixel. The sensitivity represents a scaling factor for each pixel to compensate the influence of optical behavior of the built-in optical components. This sensitivity scaling factor list is the default list for the MEASure:SPECtrum:SCALe and might be enabled using scale flag for MEASure:SPECtrum:CONFig:PROCessing (see MEASure:SPECtrum:SCALe for additional information).

Parent path: DEVice:SPECtrometer:PIXels

SCPI String Query ? Command [<INPUT VALUE>]
:SENSitivity returns a list containing the sensitivity value for each pixel -

Example:

> DEVice:SPECtrometer:PIXels:SENSitivity?
0.000,0.010,0.020,...,0.030,0.020

:WAVelengths - Wavelength positions

query only

The DEVice:SPECtrometer:PIXels:WAVelengths? query returns the wavelength position for each pixel.

The unit can be obtained by using the respective subcommand. All values listed are represented in the provided unit.

Parent path: DEVice:SPECtrometer:PIXels

SCPI String Query ? Command [<INPUT VALUE>]
:WAVelengths returns the wavelength value for each pixel -
   :UNIT returns the unit of the wavelength -

Example:

> DEVice:SPECtrometer:PIXels:WAVelengths?
4.000e-7,4.015e-7,4.030e-7,...,8.000e-7
> DEVice:SPECtrometer:PIXels:WAVelengths:UNIT?
m
:RESolution - Spectral resolution of the spectrometer

query only

The DEVice:SPECtrometer:PIXels:WAVelengths:RESolution? query provides information about the spectral resolution of the built-in spectrometer head. The spectral resolution is presented as full width half maximum (FWHM) values at specific wavelength values.

Parent path: DEVice:SPECtrometer:PIXels:WAVelengths

SCPI String Query ? Command [<INPUT VALUE>]
:RESolution returns the resolution of the spectrometer -
   :UNIT returns the unit of the resolution -

Example:

> DEVice:SPECtrometer:PIXels:RESolution?
8.6e-9@1.200e-6,8.9e-9@1.500e-6,15.2e-9@1.700e-6
> DEVice:SPECtrometer:PIXels:RESolution:UNIT?
m@m

:SERial - Spectrometer serial number

query only

For reference, each built-in spectrometer head owns a unique serial number which can be queried with DEVIce:SPECtrometer:SERial?.

Parent path: DEVIce:SPECtrometer

SCPI String Query ? Command [<INPUT VALUE>]
:SERial returns the serial number of the spectrometer -

Example:

> DEVIce:SPECtrometer:SERial?
P2.224/990029

:TEMPerature - Temperature monitoring

query only

The Spektralwerk Core contains four temperature sensors at different places to provide the possibility to monitor temperature while measuring.

Parent path: DEVice:TEMPerature

SCPI String Query ? Command [<INPUT VALUE>]
:BOARd returns current mainboard temperature -
  :UNIT returns the unit of the mainboard temperature -
:ENCLosure returns current enclosure temperature -
  :UNIT returns the unit of the enclosure temperature -
:SPECtrometer returns current spectrometer array temperature -
  :UNIT returns the unit of the spectrometer temperature -
:SUBBoard returns current subboard temperature -
  :UNIT returns the unit of the subboard temperature -

Example response:

> DEVice:TEMPerature:BOARd?
293.23
> DEVice:TEMPerature:BOARd:UNIT?
K
> DEVice:TEMPerature:ENCLosure?
292.12
> DEVice:TEMPerature:ENCLosure:UNIT?
K
> DEVice:TEMPerature:SPECtrometer?
295.25
> DEVice:TEMPerature:SPECtrometer:UNIT?
K
> DEVice:TEMPerature:SUBBoard?
295.17
> DEVice:TEMPerature:SUBBoard:UNIT?
K