Gossen MAVOSPEC User Manual
Operating Instructions
MAVOSPEC
Communication Protocol 1/07.14
The communication protocol between MAVOSPEC and GL SpectroSoft is based on Extensible Markup
Tag:
Direction:
request
PC → MAVOSPEC
Tag:
Direction:
config
MAVOSPEC → PC, PC → MAVOSPEC
Language (XML). The MAVOSPEC listens for incoming connections on TCP port 13000. Only one TCP
connection at the time is possible. When MAVOSPEC is connected to the PC via USB, an additional tool
must be used to provide port forwarding. The tool is installed on the disk together with SpectroSoft.
Following command creates TCP server port 13000 on PC ready for accepting connection to
MAVOSPEC.
“C:\GL Optic\GL_Spectrosoft\adb\adb” forward tcp:13000 tcp:13000
Brief information about messages exchanged between the MAVOSPEC and PC is presented below.
Request an action in MAVOSPEC. Possible actions are specyfied as atribute name
Attribure name:
"measure" - make measurement with current device configuraton
"getconfig" - get device configuration (see "config" message).
"welcome" - get welcome message
"background" - start dark current calibration process. TODO: needs to be completed
beep="on" - do not beep on measurement. Not implemented in MAVOSPEC
Example:
<request name="getconfig" />
<request name="measure" beep="on" />
Used for reading and changing the device configuration.
MAVOSPEC sends the configuration message to the PC each time when something changes in the
device configuration (for example an accessory change occurs or a new TCP connection to the device is
opened). The configuration can also be requested by sending the appropriate request message.
The config message is also used to change the configuration of the MAVOSPEC. When the client
software wants to change something in the MAVOSPEC configuration, it sends a modified config
message to the MAVOSPEC.
The main parameters of the measurement are placed in tags "stage". The value type defines the allowed
parameter type. The tag stage named “average" contains the main values which are used to configure
the measurement.
GOSSEN Foto- und Lichtmesstechnik GmbH 2
Attribute name:
"integrationTime" - sets integration time to be used by MAVOSPEC during measurement.
The min and max attributes contain the defined range of allowed values
for the integration time and cannot be changed.
"repeatCount" - sets the number of measurement repetitions. The measurement result
send to the PC is the average over the given number of measurements.
"autoIntegration" - turns on/off automatic mode - the effective integration time in this mode
will be calculated based on available amount of light. The calculated
integration time is stored in integrationTime.
"maximumIntegrationTime" - defines maximum value of integration time which could be used in
autoIntegration mode.
"flickerFrequency" - allows to set frequency [Hz] of measured light flicker. This frequency is
used in automatic mode to determine the integration time which is a
multiple of the flicked period.
Stage Interpolation is not important.
Section "global" contains information about mounted accessory code (value name="measuringHeads")
and allows to start dark current calibration (value name="Calibration"). Changing text "Select calibration.."
to "Dark Current" will execute dark current calibration on the device.
Example of received config message:
<config version="0.0.1">
<stage type="AverageStage" name="average" caption="Measurement">
<value type="uint" name="integrationTime" caption="Integration time" min="5" max="10000"
unit="[ms]">10</value>
<value type="int" name="repeatCount" caption="Repeat" min="1" max="250" unit="">1</value>
<value type="bool" name="autoIntegration" caption="Auto">true</value>
<value type="uint" name="maximumIntegrationTime" caption="Maximum integration time" min="5"
max="10000" unit="[ms]">10000</value>
<value type="double" name="flickerFrequency" caption="Flicker frequency">50.000000</value>
</stage>
<stage type="InterpolationStage" name="interpolate" caption="Range">
<value type="uint" name="lowerWaveLength" caption="Lowest wavelength" min="340" max="750"
unit="[nm]">340</value>
<value type="uint" name="upperWaveLength" caption="Highest wavelength" min="340" max="750"
unit="[nm]">750</value>
</stage>
<global>
<value type="QString" name="measuringHeads" caption="Measuring head">
<option caption="">010.cfg</option>
010.cfg</value>
<value type="QString" name="Calibration" caption="Calibration">
<option caption="Select calibration..">Select calibration..</option>
<option caption="Dark Current">Dark Current</option>
Select calibration..</value>
</global>
</config>
GOSSEN Foto- und Lichtmesstechnik GmbH 3
Loading...