Gossen MAVOSPEC User Manual

Download

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:

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:

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

Tag:

Direction:

nop

MAVOSPEC → PC

Tag:

Direction:

hello

MAVOSPEC → PC

Example of message sent to MAVOSPEC to disable automatic mode, set integration time to 5000 and make average of 10 measurements:

<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]">5000</value> <value type="int" name="repeatCount" caption="Repeat" min="1" max="250" unit="">10</value> <value type="bool" name="autoIntegration" caption="Auto">false</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>

Sent by MAVOSPEC to confirm that link is active.

Example:

<nop />

First message sent by MAVOSPEC after opening connection

Example:

GOSSEN Foto- und Lichtmesstechnik GmbH 4

Tag:

Direction:

progress

MAVOSPEC → PC

Tag:

Direction:

notification

MAVOSPEC → PC

Tag:

Direction:

measurement

MAVOSPEC → PC

This message informs PC about measurement progress. The value contains % of progress.

Example:

Notification about changes in state warnings or errors in MAVOSPEC. The type describes the level of importance.

Example:

<notification type="info">Accessory : 010</notification>

In section status measurement contains informations about the process of making measurement and calculating results.

Section "data" contains data from spectrometer. Tag "range" describes range of wavelenghts which are considered as usable for mounted accessory. Tag interpolation describes details of processing. Tag results contains parameters calculated by MAVOSPEC.

Example:

<?xml version="1.0" encoding="UTF-8"?><measurement version="0.0.1"> <status> <parameter caption="GL MAVOSPEC" name="SPX version">0.0.1</parameter> <parameter caption="date" name="date">2000-01-01T01:16:17</parameter> <parameter caption="device name" name="device name">GL MAVOSPEC</parameter> <parameter caption="device sensor temperature" name="device sensor temperature">31.3125</parameter> <parameter caption="device serial number" name="device serial number">GLX10t 00000000</parameter> <parameter caption="integration time" name="integration time">439443</parameter> <parameter caption="measuring head" name="measuring head">null</parameter> <parameter caption="repeat count" name="repeat count">1</parameter> <parameter caption="signalLevel" name="signalLevel">19.648</parameter> <parameter caption="measuring head" name="measuring head">010</parameter> <parameter caption="dark current status" name="dark current status">missing dark current calibration</parameter> <parameter caption="maximum measurement" name="maximum measurement">12845.000</parameter> <parameter caption="coefficient_y" name="coefficient_y">3.415</parameter>

GOSSEN Foto- und Lichtmesstechnik GmbH 5

........

GOSSEN Foto- und Lichtmesstechnik GmbH 6

GOSSEN Foto- und Lichtmesstechnik GmbH 7

Printed in Germany – Subject to change without notice

GOSSEN Foto- und Lichtmesstechnik GmbH I Lina-Ammon-Str.22 I D-90471 Nürnberg I Germany Telefon: +49 911 8602-181 I Fax: +49 911 8602-142 I E-Mail: info@gossen-photo.de

www.gossen-photo.de

GOSSEN Foto- und Lichtmesstechnik GmbH 8

Gossen MAVOSPEC User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual