Coherent Solutions matrIQ 1000 Series, User Manual

Page: 20 / 29

matrIQ Optical Switch | matrIQ Switch
Coherent Solutions Ltd. Version 1.03 19
9 Programming Guide
Introduction
Remote communication with the CSLServer is achieved through the Standard Commands for
Programmable Instruments (SCPI). Support for VISA I/O API over TCP/IP is provided by the
VXI-11 compliant CSLServer. With VISA communication drivers installed on the client, the
implementation of VISA programming within environments such as MATLAB becomes
available. This guide provides general information on the commands available to
communicate with the CSLServer remotely using the VISA I/O.
Programming Conventions
This section details the programming and measurement conventions to follow while
executing the commands for the CSLServer.
Parameter Default Unit Alternative Units
Power DBM DBM
Frequency HZ THZ, GHZ, MHZ, KHZ
Frequency Fine HZ THZ, GHZ, MHZ, KHZ
Wavelength M NM, PM
Argument Data Format
<wsp> Specifies whitespace character (01
16
– 09
16
, 0B
16
– 20
16
).
<value> Is numerical data, an integer, a decimal, exponential (10e-9 or 5.8e6)
or string
[VALUE1|VALUE2] A parameter choice . The ‘ | ’ separates the unique parameters
available, only one of the choices can be used. In the example, either
the input parameter [VALUE1] or [VALUE2] can be used, but not both.
Some commands may have more than two choices available.
This parameter can be omitted where the command has a default
defined in the command description.
Index Addressing of Modules (slot, source) and Units (channel)
When executing commands, it is almost always necessary to provide the index of a specific
laser module.
For the commands that require index values:
•
<n> : is the slot index of a matrIQ instrument, this is always <1>.
•
<m>: is the channel index of a specific unit in the module, this is an integer, <1, 2, 3, 4 >.
Message Queues
Information is exchanged in the form of messages. These messages are held in input and
output queues.
The output queue stores responses to query commands. The CSLServer transmits any data
in the output queue when a read request is received. Unless explicitly specified otherwise in
the command description, all output response data is transmitted in ASCII format.