Gossen MAVOSPEC Communication Protocol User Manual
Page 2

GOSSEN Foto- und Lichtmesstechnik GmbH
2
The communication protocol between MAVOSPEC and GL SpectroSoft is based on Extensible Markup
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.
Tag:
Direction:
request
PC
→ MAVOSPEC
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:
Tag:
Direction:
config
MAVOSPEC
→ PC, PC → MAVOSPEC
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.