EXFO OSICS Operating instructions

www.EXFO.com
OSICS Multifunction Platform
8-Channel Modular Platform
Programming Guide
OSICS_PG_3v2.2

OSICS Programming Guide 3
About This Manual
Subject This manual specifies the remote interfaces of the OSICS Mainframe and modules and
the corresponding remote commands.
Application Information in this document applies to the OSICS Mainframe version 3.06 and the
following versions of OSICS modules:
•OSICS ATN v. 1.07 and higher versions
•OSICS BKR v. 1.07 and higher versions
•OSICS DFB v. 2.38 and higher versions
•OSICS SLD v. 1.03 and higher versions
•OSICS SWT v. 1.07 and higher versions
•OSICS SWT-APC v. 1.13 and higher versions
•OSICS T100 v. 3.05 and higher versions
•OSICS TLS-AG v. 3.14 and higher versions
Intended Readers Users of this manual must be familiar with:
•Fiber optic technology
•The RS-232C and/or IEEE-488.1 interfaces used to operate the OSICS in remote
mode
•The use of the OSICS multifunction platform (see OSICS User Guide)
Date 17 September 2018
Manual Reference OSICS_PG_3v2.2
Typographical
Conventions
Command Syntax
Notation
Conventions
bold Identifies graphical interface objects such as menu names, labels,
buttons and icons.
italic Identifies references to other sections or other guides.
monospace Identifies portions of program codes, command lines, or messages
displayed in command windows.
IMPORTANT Identifies important information to which you must pay particular
attention.
Notation Meaning
[...] The content between square brackets is optional.
<...> The content between angled brackets indicates the type of
information that you must enter as parameter (command) or that is
received (response).
| Indicates an alternative. Equivalent to "or".
# Represents a numeric suffix, for example an OSICS slot number.

About This Manual
4OSICS Programming Guide
Symbols
Abbreviations
Used
Copyright Copyright © 2012–2018 by EXFO. Published by EXFO. All rights reserved.
This documentation is provided as a user guide to EXFO customers and potential
customers only. The contents of this document may not be reproduced in any part or as
a whole, transcribed, stored in a retrieval system, translated into any language, or
transmitted in any form or by any means (electronic, mechanical, magnetic, optical,
chemical, photocopying, manual, or otherwise) without the prior written permission of
EXFO.
Product Warranty
and Limitation of
Warranty
For detailed information about the sales terms and conditions, visit the EXFO web site at
www.exfo.com/how-to-buy/sales-terms-conditions
Contact
Information
To obtain after-sales service or technical support for this product, contact EXFO at one of
the following numbers.
For detailed information about technical support and for a list of other worldwide
locations, visit the EXFO web site at
www.EXFO.com/support
To accelerate the process, please have information such as the name and the serial
number (see the product identification label), as well as a description of your problem,
close at hand.
Warning
Indicates a potentially hazardous situation which, if not avoided, could result
in death or serious injury. Do not proceed unless you understand and meet
the required conditions.
Caution
Indicates a potentially hazardous situation which, if not avoided, may result in
component damage. Do not proceed unless you understand and meet the
required conditions.
Abbreviation Meaning
GPIB General Purpose Interface Bus
LF line feed
CR carriage return
EOI End-Or-Identify
LSB Least Significant Bit
Technical Support Group
400 Godin Avenue
Quebec (Quebec) G1M 2K2
CANADA
Tel. USA and Canada: 1 866 683-0155
Fax: [phone]
E-mail: [e-mail]

OSICS Programming Guide 5
Table of Contents
About This Manual..................................................................................................................................... 3
Table of Contents ...................................................................................................................................... 5
1. Remotely Controlling the OSICS Multifunction Platform ...................................................................... 9
1.1 Switching Between Remote and Local Mode ...................................................................................... 9
1.2 Remotely Controlling the OSICS via IEEE 488.................................................................................... 10
1.3 Remotely Controlling the OSICS via USB-B (RS-232C Protocol)....................................................... 12
2. General System and Status Control ................................................................................................... 13
2.1 Communication Principles .................................................................................................................. 13
2.2 Standard IEEE Status Register Commands and Queries................................................................... 15
2.3 RS-232C Common Commands ........................................................................................................... 19
3. OSICS Mainframe Control ................................................................................................................. 21
3.1 Optical-Output Control......................................................................................................................... 22
3.2 Spectral Unit Selection ........................................................................................................................ 23
3.3 Output Power Control .......................................................................................................................... 24
3.4 Modulation Control .............................................................................................................................. 26
3.5 Working Configuration Control ........................................................................................................... 27
3.6 OSICS System Management Control.................................................................................................. 28
4. OSICS ATN Control ........................................................................................................................... 31
4.1 Unit Selection ....................................................................................................................................... 31
4.2 Attenuation Setting .............................................................................................................................. 33
4.3 Wavelength Setting.............................................................................................................................. 34
4.4 Offset Setting ....................................................................................................................................... 35
4.5 Module System-Version Information.................................................................................................. 36
5. OSICS BKR Control............................................................................................................................ 37
5.1 Unit Selection ....................................................................................................................................... 37
5.2 Reflectance Setting.............................................................................................................................. 39
5.3 Wavelength Setting.............................................................................................................................. 40
5.4 Offset Setting ....................................................................................................................................... 41
5.5 Module System-Version Information.................................................................................................. 42
6. OSICS DFB Control ............................................................................................................................ 43
6.1 Optical-Output Control......................................................................................................................... 44
6.2 Unit Selection ....................................................................................................................................... 45
6.3 Output-Power Setting........................................................................................................................... 47
6.4 Diode-Current Setting .......................................................................................................................... 48
6.5 Optical Emission-Wavelength/Frequency Setting ............................................................................. 49

Table of Contents
6OSICS Programming Guide
6.6 Modulation Control .............................................................................................................................. 51
6.7 Calibration Control............................................................................................................................... 55
6.8 Module Parameter-Monitoring with the OUT 1 Output...................................................................... 57
6.9 Module System-Version Information.................................................................................................. 58
7. OSICS SLD Control ............................................................................................................................ 59
7.1 Unit Selection ....................................................................................................................................... 59
7.2 Optical-Output Control......................................................................................................................... 61
7.3 Optical Output Settings........................................................................................................................ 62
7.4 Module System-Version Information.................................................................................................. 63
8. OSICS SWT Control ........................................................................................................................... 65
8.1 Input/Output Selection ........................................................................................................................ 65
8.2 Module System-Version Information.................................................................................................. 69
9. OSICS SWT-APC Control................................................................................................................... 71
9.1 Operating-Mode Selection and Configuration.................................................................................... 72
9.2 Input/Output Channel Selection.......................................................................................................... 73
9.3 Unit Selection ....................................................................................................................................... 73
9.4 Optical-Output Control......................................................................................................................... 75
9.5 Output-Power Setting........................................................................................................................... 77
9.6 Optical Emission-Wavelength/Frequency Setting ............................................................................. 79
9.7 Coherence Control ............................................................................................................................... 80
9.8 Auto-peak Find Control........................................................................................................................ 81
9.9 Modulation Control .............................................................................................................................. 82
9.10 Module System-Version Information.................................................................................................. 84
10. OSICS T100 Control .......................................................................................................................... 85
10.1 Optical-Output Control......................................................................................................................... 86
10.2 Unit Selection ....................................................................................................................................... 87
10.3 Output-Power Setting........................................................................................................................... 89
10.4 Diode-Current Setting .......................................................................................................................... 90
10.5 Optical Emission-Wavelength/Frequency Setting ............................................................................. 91
10.6 Coherence Control ............................................................................................................................... 92
10.7 Auto-peak Find Control........................................................................................................................ 92
10.8 Modulation Control .............................................................................................................................. 94
10.9 Calibration Control............................................................................................................................... 96
10.10 Module Parameter-Monitoring with the OUT 1 Output...................................................................... 99
10.11 Module System-Version Information................................................................................................ 100
11. OSICS TLS-AG Control .................................................................................................................... 101
11.1 Optical-Output Control....................................................................................................................... 102
11.2 Unit Selection ..................................................................................................................................... 102
11.3 Operating-Mode Control .................................................................................................................... 105
11.4 Output-Power Setting......................................................................................................................... 107

Table of Contents
OSICS Programming Guide 7
11.5 Optical Emission-Wavelength/Frequency Setting ........................................................................... 108
11.6 Module System-Version Information................................................................................................ 113
12. Error Codes ..................................................................................................................................... 115
13. Program Example and Library ......................................................................................................... 117
13.1 OSICS LabVIEW Library ..................................................................................................................... 117
13.2 OSICS LabVIEW Example .................................................................................................................. 118
Index...................................................................................................................................................... 121

Table of Contents
8OSICS Programming Guide

OSICS Programming Guide 9
1. Remotely Controlling the OSICS Multifunction
Platform
You can remotely control the OSICS Mainframe through the following ports:
•IEEE-488.2 communication through the GPIB port
•RS-232C communication through the USB-B port
This section explains how to use these ports to remotely control the OSICS multifunction
platform.
1.1 Switching Between Remote and Local Mode
Procedures Entering the Remote Mode
•The OSICS multifunction platform automatically switches to remote mode if it
receives a command (via the USB or GPIB port).
When the OSICS multifunction platform enters into remote mode, the Mode area
displays Mode: REMOTE and the user interface control-panel is disabled.
The System Status screen remains active and displays the current module settings,
such as operating wavelength (or frequency) or output power.
Switching Back to Local Mode
•To go back to local mode, select LOCAL by pressing the right control button (see the
front panel description in the OSICS User Guide).
In GPIB, if the OSICS multifunction platform is set to local lockout condition, the
message LOCAL LOCKOUT is displayed. This means that the OSICS multifunction
platform is locked into GPIB remote-control operation: all OSICS front panel controls
are disabled and local operating mode can no longer be restored using the LOCAL
soft-key.
To restore the user interface control panel, send the "Go to local" instruction to the
OSICS multifunction platform from the computer or GPIB controller (refer to the
programming guide of your GPIB board to know the exact syntax for the "Go to local"
instruction).

Remotely Controlling the OSICS Multifunction Platform
10 OSICS Programming Guide
1.2 Remotely Controlling the OSICS via IEEE 488
Subject This section explains how to use the IEEE-488.2 GPIB interface to remotely operate the
OSICS multifunction platform.
The GPIB port is located on the rear panel and is labeled IEEE 488 (see OSICS User
Guide).
Capabilities The following table lists the OSICS GPIB capabilities.
Table 1: GPIB Interface Capabilities
1.2.1 Setting the GPIB Address
Subject The default GPIB address of the OSICS is factory-set to 10. This section explains how to
modify it (possible values are 1 to 30).
Up to 15 devices may be connected on the same GPIB bus simultaneously. Each device
has its own GPIB address in the range of 0 to 30. To avoid address conflicts, you must
make sure that your OSICS GPIB address is different from the address of any other
device already connected to the GPIB port.
Procedure 1. Access the Main Setup menu (see OSICS User Guide).
2. Turn the rotary knob to put the cursor before the GPIB address menu and press the
knob to enter it.
The GPIB Address sub-menu appears and displays the current GPIB address.
Figure 1: Main Setup – GPIB Address
3. Enter the wanted address as follows:
Mnemonic Function
SH1 Complete source handshake
AH1 Complete acceptor handshake
T5 Complete talker
L3 Complete listener
SR1 Complete service request
RL1 Complete remote/local
PP0 No parallel poll
DC1 Complete device clear
DT0 No device trigger
C0 No controller
Main 12 345678
Main Setup - GPIB Address
EXITESCAPE
▲
GPIB Address :
10
Modify the value.
ENTER