EXFO OSICS Programming Manual
  1. Manuals
  2. Brands
  3. EXFO Manuals
  4. Laboratory Equipment
  5. OSICS
  6. Programming manual
EXFO OSICS Programming Manual

EXFO OSICS Programming Manual

8-channel modular multifunction platform
Hide thumbs
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the OSICS and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for EXFO OSICS

Summary of Contents for EXFO OSICS

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

  • Page 3: About This Manual

    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: •...
  • Page 4 (electronic, mechanical, magnetic, optical, chemical, photocopying, manual, or otherwise) without the prior written permission of EXFO. Product Warranty For detailed information about the sales terms and conditions, visit the EXFO web site at and Limitation of www.exfo.com/how-to-buy/sales-terms-conditions Warranty...

  • Page 5: Table Of Contents

    Remotely Controlling the OSICS Multifunction Platform ..............9 Switching Between Remote and Local Mode ..................9 Remotely Controlling the OSICS via IEEE 488 ..................10 Remotely Controlling the OSICS via USB-B (RS-232C Protocol) ............12 General System and Status Control ....................13 Communication Principles ........................13 Standard IEEE Status Register Commands and Queries..............
  • Page 6 Coherence Control ..........................80 Auto-peak Find Control ........................81 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 ................
  • Page 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 OSICS Programming Guide...
  • Page 8 Table of Contents OSICS Programming Guide...

  • Page 9: Remotely Controlling The Osics Multifunction Platform

    • 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. Switching Between Remote and Local Mode Procedures Entering the Remote Mode •...

  • Page 10: 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.
  • Page 11 1.2.2 Connecting the OSICS to an IEEE 488 Controller Subject The GPIB port enables you to connect the OSICS Mainframe to a computer and to control it via remote commands. Before Starting Make sure you have a GPIB cable to link the OSICS Mainframe to an IEEE-488.2 controller (GPIB PCI card or GPIB-USB-HS module from National Instrument) connected to your computer.

  • Page 12: Remotely Controlling The Osics Via Usb-B (Rs-232C Protocol)

    Remotely Controlling the OSICS via USB-B (RS-232C Protocol) Subject The USB 2.0-B port is located on the on the rear panel and is labeled USB-B (see OSICS User Guide). The OSICS multifunction platform can receive RS-232C commands at the USB-B port from a computer on which the appropriate USB driver is installed.

  • Page 13: General System And Status Control

    Response Message Ending • All commands sent via RS-232C generate a response message from the OSICS Mainframe to inform the computer whether the order was successfully performed (OK) or that an error was produced (error messages are explained in the following Error Handling section, p 14).
  • Page 14 Mainframe command, simply type in the instruction string followed by the carriage return character in RS-232C, as shown in the following example: P=0.22 <CR> This command sets the output power for all the modules installed in the OSICS Mainframe to 0.22 mW (if mW is the selected power unit). •...

  • Page 15: Standard Ieee Status Register Commands And Queries

    Standard Status Model Status Model The status word is an 8-bit variable that relates to the status of the OSICS Mainframe and error reporting as well. It contains a number of binary indicators which can be used by the controller for an optimal synchronization between the OSICS Mainframe and the controller.
  • Page 16 (OPeration Complete) Set to 1 if a service request has been generated by the OSICS Mainframe. This bit remains activated (ReQuest Service) until a serial poll has been performed. Set to 1 together with the RQS bit. This bit remains...
  • Page 17 General System and Status Control Name Meaning Number RQC (ReQuest Control) This bit may not be set to 1, since the OSICS instrument does not work as an IEEE-488.2 bus controller. OPC (OPeration In most cases this bit is set to 1 as soon as a Complete) command has been completely executed.
  • Page 18 Common IEEE Commands and Queries To accelerate and secure the exchange of information between the controller and the OSICS Mainframe, we recommend checking the values of the Status Register and of the standard Event Status Register using the IEEE-488.2 common commands presented in the following table.

  • Page 19: Rs-232C Common Commands

    OSICS Query Mainframe Response ECHON none Sets the OSICS Mainframe to echo each typed character received back to the terminal. ECHOFF none Default setting. Cancels the echo mode on the OSICS Mainframe. If the local operating mode is restored using the...
  • Page 20 General System and Status Control OSICS Programming Guide...

  • Page 21: Osics Mainframe Control

    3. OSICS Mainframe Control The following table gives an overview of all available commands and queries for OSICS Mainframe control. Command/Query Corresponding Section Optical-Output Control DISABLE, p. 22 DISABLE ENABLE, p. 22 ENABLE ENABLE?, p. 22 ENABLE? Spectral Unit Selection GHZ, p.

  • Page 22: Optical-Output Control

    3.1.3 ENABLE? Syntax ENABLE? Parameter None. Description Returns the current state of the OSICS Mainframe laser output master control. OSICS Response • ENABLED: the laser is set to ENABLE. • DISABLED: the laser is set to DISABLE. OSICS Programming Guide...

  • Page 23: Spectral Unit Selection

    Standard Status Model, p. 15. 3.2.2 Syntax Parameter None. Description Default setting. Sets the wavelength in nm as the spectral unit on the OSICS Mainframe and all installed OSICS modules. OSICS Response • RS-232C: OK • GPIB: none, see section Standard Status Model, p.

  • Page 24: Output Power Control

    Standard Status Model, p. 15. 3.3.1.3 Syntax Parameter None. Description Returns the current power unit used on the OSICS Mainframe and all installed OSICS modules. OSICS Response • 1: the current power unit used is mW. •...
  • Page 25 [±]xx.xx: optical output power in dBm, if the unit is set to dBm (see section DBM, p. 24). Possible values are given in the Technical Specifications section corresponding to the installed modules in the OSICS User Guide. • xx.xx: optical output power in mW, if the unit is set to mW (see section MW, p. 24).

  • Page 26: Modulation Control

    Sets the frequency of the OSICS Mainframe internal digital (TTL) modulation source. If the OSICS Mainframe is not able to generate the exact value of the frequency setting, it applies the nearest available frequency value, right under the value of the setting.

  • Page 27: Working Configuration Control

    Syntax MOD_F? Parameter None. Description Returns the frequency of the OSICS internal digital (TTL) modulation source in Hz. OSICS Response MOD_F=xxxxxxx Working Configuration Control The commands detailed in this section enable you to load or save working configurations. For more details on working configuration, see OSICS User Guide.

  • Page 28: Osics System Management Control

    Syntax *RST Parameter None. Description • Resets the OSICS Mainframe and all modules to the same state as after system turn- on and initialization. • Clears the input queue. • Sets the OPC bit to 1. The command interpreter is reset and a reset instruction is sent to every module.
  • Page 29 Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the type of OSICS module installed in channel-slot number #. Each type of OSICS module has its own module code. OSICS Response • -1: empty slot.
  • Page 30 OSICS Mainframe Control OSICS Programming Guide...

  • Page 31: Osics Atn Control

    4. OSICS ATN Control The following table gives an overview of all available commands and queries for OSICS ATN control. Command/Query Unit Selection (p. 31) CH#:GHZ CH#:NM CH#:NM? Attenuation Setting (p. 33) CH#:ATN CH#:ATN? CH#:ATN_MIN_MAX? Wavelength Setting (p. 34) CH#:L...
  • Page 32 OSICS ATN Control Parameter • #: slot number of the module, in the range 1 to 8. Description Sets nm as the spectral unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 33: Attenuation Setting

    Technical Specifications section of the module in the OSICS User Guide. To know the possible values, see section CH#:ATN_MIN_MAX?, p. 33.

  • Page 34: Wavelength Setting

    OSICS ATN Control Wavelength Setting 4.3.1 CH#:L Syntax CH#:L 1|2 Parameters • #: slot number of the module, in the range 1 to 8. • 1: first wavelength value of the factory calibration: • on SMF: 1300 nm • on PMF: 1550 nm •...

  • Page 35: Offset Setting

    OSICS ATN Control Description Returns the wavelength in nanometer corresponding to the given wavelength number (1|2). OSICS Response CH#:L(1|2)=<wavelength value> Offset Setting 4.4.1 CH#:OFFSET Syntax CH#:OFFSET 1|2 xx.xx Parameters • #: slot number of the module, in the range 1 to 8.

  • Page 36: Module System-Version Information

    OSICS ATN Control Module System-Version Information 4.5.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 4.5.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...

  • Page 37: Osics Bkr Control

    5. OSICS BKR Control The following table gives an overview of all available commands and queries for OSICS BKR control. Command/Query Unit Selection (p. 37) CH#:GHZ CH#:NM CH#:NM? Reflectance Setting (p. 39) CH#:ATN CH#:ATN? CH#:ATN_MIN_MAX? Wavelength Setting (p. 40) CH#:L...
  • Page 38 OSICS BKR Control Parameter • #: slot number of the module, in the range 1 to 8. Description Sets nm as the spectral unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 39: Reflectance Setting

    Technical Specifications section of the module in the OSICS User Guide. To know the possible values, see section CH#:ATN_MIN_MAX?, p. 39.

  • Page 40: Wavelength Setting

    OSICS BKR Control Wavelength Setting 5.3.1 CH#:L Syntax CH#:L 1|2 Parameters • #: slot number of the module, in the range 1 to 8. • 1: first wavelength value of the factory calibration: • on SMF: 1300 nm • on PMF: 1550 nm •...

  • Page 41: Offset Setting

    OSICS BKR Control Description Returns the wavelength in nanometer corresponding to the given wavelength number (1|2). OSICS Response CH#:L(1|2)=<wavelength value> Offset Setting 5.4.1 CH#:OFFSET Syntax CH#:OFFSET 1|2 xx.xx Parameters • #: slot number of the module, in the range 1 to 8.

  • Page 42: Module System-Version Information

    OSICS BKR Control Module System-Version Information 5.5.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 5.5.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...

  • Page 43: Osics Dfb Control

    6. OSICS DFB Control The following table gives an overview of all available commands and queries for OSICS DFB control. Command/Query Optical-Output Control (p. 44) CH#:DISABLE CH#:ENABLE CH#:ENABLE? Unit Selection (p. 45) CH#:GHZ CH#:NM CH#:NM? CH#:DBM CH#:MW CH#:MW? Output-Power Setting (p. 47)

  • Page 44: Optical-Output Control

    OSICS DFB Control Command/Query Calibration Control (p. 55) CH#:PCAL= CH#:PCAL? CH#:DL= CH#:DL? Module Parameter-Monitoring with the CH#:AOUT OUT 1 Output (p. 57) CH#:AOUT? Module System-Version Information CH#:FIRM? (p. 58) CH#:*IDN? CH#:TYPE? CH#:ERRORT? Optical-Output Control 6.1.1 CH#:DISABLE Syntax CH#:DISABLE Parameter •...

  • Page 45: Unit Selection

    OSICS DFB Control Description Returns the state of the laser-output control on the DFB module. OSICS Response • CH#:ENABLED: the laser output is set to ENABLE. • CH#:DISABLED: the laser output is set to DISABLE. Unit Selection 6.2.1 CH#:GHZ Syntax...
  • Page 46 OSICS DFB Control 6.2.4 CH#:DBM Syntax CH#:DBM Parameter • #: slot number of the module, in the range 1 to 8. Description Sets dBm as the power unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 47: Output-Power Setting

    [±]xx.xx: optical output power in dBm, if the unit is set to dBm (see section Unit Selection, p. 45). Possible values are given in the module Technical Specifications section in the OSICS User Guide. • xx.xx: optical output power in mW, if the unit is set to mW (see section Unit Selection, p.

  • Page 48: Diode-Current Setting

    OSICS DFB Control Diode-Current Setting 6.4.1 CH#:I? Syntax CH#:I? Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the present current level in mA. The module optical output must be enabled (see section Optical-Output Control, p. 44).

  • Page 49: Optical Emission-Wavelength/Frequency Setting

    OSICS DFB Control Optical Emission-Wavelength/Frequency Setting 6.5.1 CH#:L= Syntax CH#:L=xxxx.xxx Parameters • #: slot number of the module, in the range 1 to 8. • xxxx.xxx: the emission wavelength value in nm. The possible wavelength range is available by using the CH#:LMIN? and CH#:LMAX? commands (see p. 49).
  • Page 50 OSICS DFB Control 6.5.5 CH#:F= Syntax CH#:F=xxxxxx.x Parameters • #: slot number of the module, in the range 1 to 8. • xxxxxx.x: the emission frequency value in GHz. The possible frequency range is available by using the CH#:FMIN? and CH#:FMAX? commands (see p. 50).

  • Page 51: Modulation Control

    Sets the modulation source of the DFB module. • The MAINFRAME modulation signal may be generated either by the OSICS Mainframe's own source, or by an external function generator connected to the Mainframe's Mod. In BNC connector. To set the frequency of the internal Mainframe generator, see section MOD_F=, p.
  • Page 52 OSICS DFB Control • The internal source uses the module's built-in modulation signal generator. To set the frequency of the internal TTL modulation, see the CH#:MOD_F= section of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.
  • Page 53 %, in the range of 0 % to 15 %. Description Sets the amplitude rate of the DFB module's internal sinus modulation signal as a percentage of the diode bias-current. For more details, see OSICS User Guide. OSICS Response •...
  • Page 54 OSICS DFB Control 6.6.10 CH#:SIN_FREQ? Syntax CH#:SIN_FREQ? Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the frequency setting of the DFB module's internal sinus modulation signal in kHz. OSICS Response CH#:SIN_FREQ=xxx.x 6.6.11...

  • Page 55: Calibration Control

    Description Sets the power value of the one-point power calibration method to correct the discrepancies between the power displayed by the OSICS DFB module and the power measured at your reference power meter. To perform a power calibration, proceed as follows (full detail on the power calibration method is given in OSICS User Guide): 1.
  • Page 56 OSICS DFB Control Description Sets the wavelength offset applied to the emission wavelength of the DFB module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15. 6.7.4 CH#:DL? Syntax CH#:DL? Parameter • #: slot number of the module, in the range 1 to 8.

  • Page 57: Module Parameter-Monitoring With The Out 1 Output

    OSICS DFB Control Module Parameter-Monitoring with the OUT 1 Output 6.8.1 CH#:AOUT Syntax CH#:AOUT I|P|T Parameters • #: slot number of the module, in the range 1 to 8. • I: the OUT 1 BNC port (corresponding to the # slot number) is assigned to monitor the diode’s current signal.

  • Page 58: Module System-Version Information

    OSICS DFB Control Module System-Version Information 6.9.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 6.9.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...

  • Page 59: Osics Sld Control

    7. OSICS SLD Control The following table gives an overview of all available commands and queries for OSICS SLD control. Command/Query Unit Selection (p. 59) CH#:GHZ CH#:NM CH#:NM? CH#:DBM CH#:MW CH#:MW? Optical-Output Control (p. 61) CH#:DISABLE CH#:ENABLE CH#:ENABLE? Optical Output Settings (p. 62)
  • Page 60 OSICS SLD Control Parameter • #: slot number of the module, in the range 1 to 8. Description Sets nm as the spectral unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 61: Optical-Output Control

    OSICS SLD Control Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the actual power unit. OSICS Response • CH#:1: the selected unit is mW. • CH#:0: the selected unit is dBm. Optical-Output Control 7.2.1...

  • Page 62: Optical Output Settings

    OSICS SLD Control Optical Output Settings 7.3.1 CH#:P= Syntax CH#:P=high|low Parameter • #: slot number of the module, in the range 1 to 8. • high: high power setting, which is 10 mW or +10dBm depending on the power unit setting.

  • Page 63: Module System-Version Information

    OSICS SLD Control Module System-Version Information 7.4.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 7.4.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...
  • Page 64 OSICS SLD Control OSICS Programming Guide...

  • Page 65: Osics Swt Control

    8. OSICS SWT Control The following table gives an overview of all available commands and queries for OSICS SWT control. Command/Query Input/Output Selection (p. 65) CH#:SHUT CH#:OPEN CH#:SHUT? CH#:SHUTMODE CH#:SHUTMODE? CH#:BAR CH#:CROSS CH#:BAR? CH#:CH CH#:CH? Module System-Version Information CH#:FIRM? (p. 69)
  • Page 66 OSICS SWT Control 8.1.2 CH#:OPEN Syntax CH#:OPEN Parameter • #: slot number of the module, in the range 1 to 8. Description Only on shutter SWT 1x1. Opens the shutter. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.
  • Page 67 OSICS SWT Control means: • 2x shutter is in slot 6. • Shutter A-B is closed. • Shutter 1-2 is open. 8.1.5 CH#:SHUTMODE? Syntax CH#:SHUTMODE? Parameter • #: slot number of the module, in the range 1 to 8. Description Only on 2x shutter SWT 2x(1x1).
  • Page 68 OSICS SWT Control 8.1.8 CH#:BAR? Syntax CH#:BAR? Parameter • #: slot number of the module, in the range 1 to 8. Description Only on SWT 2x2. Returns the output mode of the switch • A is linked to 1 •...

  • Page 69: Module System-Version Information

    OSICS SWT Control Module System-Version Information 8.2.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 8.2.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...
  • Page 70 OSICS SWT Control OSICS Programming Guide...

  • Page 71: Osics Swt-Apc Control

    9. OSICS SWT-APC Control The following table gives an overview of all available commands and queries for OSICS SWT-APC control. Command/Query Operating-Mode Selection and CH#:MODE Configuration (p. 72) CH#:ACFG CH#:MODE? Input/Output Channel Selection (p. 73) CH#:CLOSE= CH#:CLOSE? Unit Selection (p. 73)

  • Page 72: Operating-Mode Selection And Configuration

    Automatically detects the T100 modules connected to the SWT-APC module. If your module’s software-version is older than v. 2.21, this function is not available. You must manually configure the T100 modules connected to the SWT-APC module as explained in OSICS User Guide. OSICS Response •...

  • Page 73: Input/Output Channel Selection

    OSICS SWT-APC Control Input/Output Channel Selection 9.2.1 CH#:CLOSE= Syntax CH#:CLOSE=<channel number> Parameter • #: slot number of the module, in the range 1 to 8. • x: number of the channel you want to activate in the range 1 to 4.
  • Page 74 OSICS SWT-APC Control Description Only available if the SWT-APC module to is set to Full-band mode (see section CH#:MODE, p. 72). Sets nm as the spectral unit of the SWT-APC module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 75: Optical-Output Control

    OSICS SWT-APC Control 9.3.6 CH#:MW? Syntax CH#:MW? Parameter • #: slot number of the module, in the range 1 to 8. Description Only available if the SWT-APC module to is set to Full-band mode (see section CH#:MODE, p. 72). Returns the actual power unit of the SWT-APC module.
  • Page 76 OSICS SWT-APC Control 9.4.3 CH#:ENABLE? Syntax CH#:ENABLE? Parameter • #: slot number of the module, in the range 1 to 8. Description Only available if the SWT-APC module to is set to Full-band mode (see section CH#:MODE, p. 72). Returns the state of the laser-output control on the active channel of the SWT-APC module.

  • Page 77: Output-Power Setting

    [±]xx.xx: optical output power in dBm, if the unit is set to dBm (see section Unit Selection, p. 73). Possible values are given in the module Technical Specifications section in the OSICS User Guide. • xx.xx: optical output power in mW, if the unit is set to mW (see section Unit Selection, p.
  • Page 78 OSICS SWT-APC Control OSICS Response • CH#:1: the selected output power is not reached. • CH#:0: the selected output power is reached. OSICS Programming Guide...

  • Page 79: Optical Emission-Wavelength/Frequency Setting

    • xxxx.xxx: the emission wavelength value in nm. The possible wavelength range is available in the module Technical Specifications section in the OSICS User Guide. Description Only available if the SWT-APC module to is set to Full-band mode (see section CH#:MODE, p.

  • Page 80: Coherence Control

    OSICS SWT-APC Control 9.6.4 CH#:F? Syntax CH#:F? Parameter • #: slot number of the module, in the range 1 to 8. Description Only available if the SWT-APC module to is set to Full-band mode (see section CH#:MODE, p. 72). Returns the emission frequency of the module in GHz.

  • Page 81: Auto-Peak Find Control

    OSICS SWT-APC Control Auto-peak Find Control 9.8.1 CH#:APF Syntax CH#:APF OFF|ON Parameters • #: slot number of the module, in the range 1 to 8. • OFF (default setting): the Auto-peak Find function is disabled. • ON: the Auto-peak Find function is enabled.

  • Page 82: Modulation Control

    OSICS SWT-APC Control Modulation Control 9.9.1 CH#:MOD_CTRL Syntax CH#:MOD_CTRL OFF|ON|ON_INV Parameters • #: slot number of the module, in the range 1 to 8. • OFF (default setting): the digital modulation is turned off. • ON: the digital modulation is turned on.
  • Page 83 Sets the modulation source of all the T100 modules connected to the SWT-APC module. • The MAINFRAME modulation signal may be generated either by the OSICS Mainframe's own source, or by an external function generator connected to the Mainframe's Mod. In BNC connector. To set the frequency of the internal Mainframe generator, see section MOD_F=, p.

  • Page 84: Module System-Version Information

    OSICS SWT-APC Control 9.10 Module System-Version Information 9.10.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 9.10.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...

  • Page 85: Osics T100 Control

    10. OSICS T100 Control The following table gives an overview of all available commands and queries for OSICS T100 control. Command/Query Optical-Output Control (p. 86) CH#:DISABLE CH#:ENABLE CH#:ENABLE? Unit Selection (p. 87) CH#:GHZ CH#:NM CH#:NM? CH#:DBM CH#:MW CH#:MW? Output-Power Setting (p. 89)

  • Page 86: Optical-Output Control

    OSICS T100 Control Command/Query Calibration Control (p. 96) CH#:WAVEREF CH#:LCAL1= CH#:LCAL2= CH#:LCAL1? CH#:LCAL2? CH#:PCAL1= CH#:PCAL2= CH#:PCAL1? CH#:PCAL2? Module Parameter-Monitoring with the CH#:AOUT OUT 1 Output (p. 99) CH#:AOUT? Module System-Version Information CH#:FIRM? (p. 100) CH#:*IDN? CH#:TYPE? 10.1 Optical-Output Control 10.1.1...

  • Page 87: Unit Selection

    OSICS T100 Control Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the state of the laser-output control on the T100 module. OSICS Response • CH#:ENABLED: the laser output is set to ENABLE.
  • Page 88 OSICS T100 Control Parameter • #: slot number of the module, in the range 1 to 8. Description Sets dBm as the power unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 89: Output-Power Setting

    [±]xx.xx: optical output power in dBm, if the unit is set to dBm (see section Unit Selection, p. 87). Possible values are given in the module Technical Specifications section in the OSICS User Guide. • xx.xx: optical output power in mW, if the unit is set to mW (see section Unit Selection, p.

  • Page 90: Diode-Current Setting

    OSICS T100 Control 10.4 Diode-Current Setting 10.4.1 CH#:I? Syntax CH#:I? Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the present current level in mA. The module optical output must be enabled (see section Optical-Output Control, p. 86).

  • Page 91: Optical Emission-Wavelength/Frequency Setting

    #: slot number of the module, in the range 1 to 8. • xxxx.xxx: the emission wavelength value in nm. The possible wavelength range is available in the module Technical Specifications section in the OSICS User Guide. Description Sets the emission wavelength of the module in nm.

  • Page 92: Coherence Control

    OSICS T100 Control 10.6 Coherence Control 10.6.1 CH#:CTRL Syntax CH#:CTRL OFF|ON Parameters • #: slot number of the module, in the range 1 to 8. • OFF (default setting): the Coherence Control function is disabled. • ON: the Coherence Control function is enabled.
  • Page 93 OSICS T100 Control 10.7.2 CH#:APF? Syntax CH#:APF? Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the state of the Auto-peak Find function. OSICS Response • CH#:1: the Auto-peak Find function is set to ON.

  • Page 94: Modulation Control

    Sets the modulation source of the T100 module. • The MAINFRAME modulation signal may be generated either by the OSICS Mainframe's own source, or by an external function generator connected to the Mainframe's Mod. In BNC connector. To set the frequency of the internal Mainframe generator, see section MOD_F=, p.
  • Page 95 OSICS T100 Control 10.8.4 CH#:MOD_F= Syntax CH#:MOD_F=xxxxxx Parameters • #: slot number of the module, in the range 1 to 8. • xxxxxx: frequency of the modulation signal in Hz, in the range 153 to 1000000 (1 Mhz). Description Sets the frequency of the T100 module INTERNAL digital (TTL) modulation source.

  • Page 96: Calibration Control

    Sets the first wavelength value of the two-point wavelength calibration method. LCAL1 is the first factory calibration wavelength (in nm only). The value of LCAL1 corresponds to the value displayed on the wavemeter (see OSICS User Guide for more details).
  • Page 97 T100 module wavelength-range. To perform a power calibration, proceed as follows (full detail on the power calibration method is given in OSICS User Guide): 1. Make sure the unit is set to mW.
  • Page 98 T100 module wavelength range. To perform a power calibration proceed as follows (full detail on the power calibration method is given in OSICS User Guide): 1. Make sure the unit is set to mW.

  • Page 99: Module Parameter-Monitoring With The Out 1 Output

    OSICS T100 Control 10.10 Module Parameter-Monitoring with the OUT 1 Output 10.10.1 CH#:AOUT Syntax CH#:AOUT I|P Parameters • #: slot number of the module, in the range 1 to 8. • I: the OUT 1 BNC port (corresponding to the # slot number) is assigned to monitor the diode’s current signal.

  • Page 100: Module System-Version Information

    OSICS T100 Control 10.11 Module System-Version Information 10.11.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 10.11.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...

  • Page 101: Osics Tls-Ag Control

    11. OSICS TLS-AG Control The following table gives an overview of all available commands and queries for OSICS TLS-AG control. Command/Query Optical-Output Control (p. 102) CH#:DISABLE CH#:ENABLE CH#:ENABLE? Unit Selection (p. 102) CH#:GHZ CH#:NM CH#:NM? CH#:DBM CH#:MW CH#:MW? Operating-Mode Control (p. 105)

  • Page 102: Optical-Output Control

    OSICS TLS-AG Control 11.1 Optical-Output Control 11.1.1 CH#:DISABLE Syntax CH#:DISABLE Parameter • #: slot number of the module, in the range 1 to 8. Description Default setting. Disables the laser output of the TLS-AG module. OSICS Response • RS-232C: CH#:OK •...
  • Page 103 OSICS TLS-AG Control Parameter • #: slot number of the module, in the range 1 to 8. Description Sets GHz as the spectral unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.
  • Page 104 OSICS TLS-AG Control Parameter • #: slot number of the module, in the range 1 to 8. Description Sets mW as the power unit of the module. OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15.

  • Page 105: Operating-Mode Control

    #: slot number of the module, in the range 1 to 8. • xxxx.xxx: the first emission wavelength in nm. Wavelength range is given in the module Technical Specifications section in the OSICS User Guide. • xxxxxx.x: the first emission frequency in GHz. Wavelength range is given in the module Technical Specifications section in the OSICS User Guide.
  • Page 106 OSICS TLS-AG Control OSICS Response • RS-232C: CH#:OK • GPIB: none, see section Standard Status Model, p. 15. 11.3.4 CH#:GRID_START? Syntax CH#:GRID_START? Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the first channel emission wavelength in nm or frequency in GHz, depending on...

  • Page 107: Output-Power Setting

    [±]xx.xx: optical output power in dBm, if the unit is set to dBm (see section Unit Selection, p. 102). Possible values are given in the module Technical Specifications section in the OSICS User Guide. • xx.xx: optical output power in mW, if the unit is set to mW (see section Unit Selection, p.

  • Page 108: Optical Emission-Wavelength/Frequency Setting

    OSICS TLS-AG Control 11.5 Optical Emission-Wavelength/Frequency Setting 11.5.1 CH#:L= Syntax CH#:L=xxxx.xxx Parameters • #: slot number of the module, in the range 1 to 8. • xxxx.xxx: the emission wavelength value in nm. The possible wavelength range is available by using the CH#:L_MIN? and CH#:L_MAX? commands (see p. 108).
  • Page 109 OSICS TLS-AG Control Description Returns the last wavelength of the laser in nm. OSICS Response CH#:L_MAX=xxxx.xxx 11.5.5 CH#:CHN= Syntax CH#:CHN=xxx Parameters • #: slot number of the module, in the range 1 to 8. • xxx: emission channel number of the TLS-AG module. The number of available channels depends on grid spacing (see section CH#:GRID_SPACING, p.
  • Page 110 #: slot number of the module, in the range 1 to 8. • xxxxxx.x: the emission frequency value in GHz. The possible frequency range is available in the module Technical Specifications section in the OSICS User Guide. Description Sets the emission frequency of the module in GHz.
  • Page 111 OSICS TLS-AG Control Description Returns the grid spacing of the laser in GHz. OSICS Response CH#:ISL=xxx.xx 11.5.13 CH#:LOCKED? Syntax CH#:LOCKED? Parameter • #: slot number of the module, in the range 1 to 8. Description This command is only available from software version 3.07 and above.
  • Page 112 OSICS TLS-AG Control 11.5.16 CH#:FT_F= Syntax CH#:FT_F=(±)xxxx Parameter • #: slot number of the module, in the range 1 to 8. • xxxx: fine tune value in MHz, in the range -6000 to +6000 MHz. Description Only available if the module is set to Manual or Grid mode (see section CH#:MODE, p.

  • Page 113: Module System-Version Information

    OSICS TLS-AG Control 11.6 Module System-Version Information 11.6.1 CH#:FIRM? Syntax CH#:FIRM=x.xx Parameter • #: slot number of the module, in the range 1 to 8. Description Returns the software version of the module. OSICS Response CH#:FIRM=x.xx 11.6.2 CH#:*IDN? Syntax CH#:*idn? Parameter •...
  • Page 114 OSICS TLS-AG Control OSICS Programming Guide...

  • Page 115: Error Codes

    Generic instrument-dependent error for instruments that cannot detect more specific errors. This code indicates only that a device-dependent error as defined in IEEE 488.2 has occurred. -301 OSICS Scan-State Busy The OSA is still scanning, analyzing, stopping or aborting and is not in an idle state. -302 OSICS Calibration-State Busy The OSA is still calibrating and is not in an idle state.
  • Page 116 Error Codes OSICS Programming Guide...

  • Page 117: Program Example And Library

    LabVIEW Virtual Instrument example OSICS_FBL_Example.vi • LabVIEW library OSICS_LIB.lvlib These tools are available on the USB key delivered with the OSICS Mainframe, or you can download them from the EXFO website (www.exfo.com/en/exfo-apps). Compatibility The Virtual Instrument OSICS_FBL_Example is part of the LabVIEW library OSICS_LIB.lvlib, developed for LabVIEW 2010 or later.

  • Page 118: Osics Labview Example

    This VI example controls an OSICS Full-band Laser (FBL) remotely. The OSICS FBL consists of an OSICS SWT-APC module and up to four OSICS T100 laser modules (for more information about how to setup an OSICS Full-Band Laser, please see OSICS User Guide).
  • Page 119 Program Example and Library 3. Run the Vi by pressing the Run arrow, or using the shortcut CTRL+R. The Vi first runs the OSICS_Openport.vi to establish communication with the OSICS Mainframe and modules used in the Full-band setup. Next the OSICS_Get_Laser_Settings_SWT-APC.vi collects the laser output state, wavelength/frequency and power settings.
  • Page 120 Program Example and Library OSICS Programming Guide...

  • Page 121: Index

    F? ..........50 SHUT ..............65 F= ..........50 SHUT? ............66 FIRM? .....36 SHUTMODE ...........66 FMAX? ............50 SHUTMODE? ..........67 FMIN? ............50 SIN_FREQ? .............54 GHZ ......31 SIN_FREQ= ............53 GRID_SPACING ...........106 SIN_OUT ............53 GRID_SPACING? .........106 SIN_OUT? ............54 GRID_START ..........105 SIN_RATE? .............54 OSICS Programming Guide...
  • Page 122 Mainframe .............23 CH#: .......... 47 INTERLOCK? ............28 Mainframe .............25 LabVIEW CH#: .......... 47 Diagram ............119 Mainframe .............25 Example ............117 PRESENT? ............29 Library ............117 Library ..............117 RECALL ..............27 MOD_F? SAVE ..............27 CH#: ............52 Mainframe .............27 OSICS Programming Guide...

Table of Contents