Spirent CommunicationsDLS
Sp
irent C
om
mu
nicatio
ns D
LS 1
20
0 D
LS Lib
rary fo
r Sp
irent C
on
nect
1200DLS Library for Spirent Connect
DLS 1200 Operating Manual
Spirent Communications - Table Of Contents Page i
7104170669-12/04-3
Table of Contents1. INTRODUCTION ............................................................................................. 1-1
1.1 About Spirent’s Involvement in Wireline Simulation ....................................... 1-11.2 About this Manual ............................................................................................. 1-1
1.2.1 About Related Documentation and Products .............................................. 1-1
2. GETTING STARTED ...................................................................................... 2-12.1 Compatible Products .......................................................................................... 2-1
2.1.1 Installing Spirent Connect Software ............................................................ 2-32.1.2 Installing the DLS 1200 Module Software .................................................. 2-32.1.3 Installing the IEEE 488 (GPIB) Card and Software ................................... 2-3
2.2 Starting Up the Spirent Connect Software ......................................................... 2-32.2.4 Accessing the DLS 1200 Command Widget(s) ............................................ 2-4
3. DLS 400xx TCL COMMANDS ................................................................... 3-13.1 DLS 400IA/E ..................................................................................................... 3-1
3.1.1 Dls_400IA_Connect .................................................................................... 3-13.1.2 Dls_400IA_Disconnect ............................................................................... 3-23.1.3 Dls_EnableCompensation ........................................................................... 3-33.1.4 Dls_400IA_Loop ......................................................................................... 3-33.1.5 Dls_400IA_WhiteNoise ............................................................................... 3-43.1.6 Dls_400IA_CrosstalkNoise ......................................................................... 3-53.1.7 Dls_400IA_ShapedNoise ............................................................................ 3-73.1.8 Dls_400IA_Impulses ................................................................................... 3-83.1.9 Dls_400IA_Output ...................................................................................... 3-83.1.10 Dls_400IA_Quiet ...................................................................................... 3-93.1.1 DLS 400IA Loop Parameters .................................................................... 3-10
3.1.1.1 Straight Loops ........................................................................................ 3-103.1.1.2 DLS 400IAE Straight Loops .................................................................... 3-113.1.1.3 Fixed Loops ........................................................................................... 3-123.1.1.4 Bridged Tap (BT) Loops .......................................................................... 3-12
3.2 DLS 400HN ..................................................................................................... 3-133.2.2 Dls_D4hn_Connect ................................................................................... 3-133.2.3 Dls_D4hn_SetLoop ................................................................................... 3-143.2.4 Dls_D4hn_LoopDirection ......................................................................... 3-163.2.5 Dls_Disconnect ......................................................................................... 3-16
3.3 DLS 400H ........................................................................................................ 3-173.3.1 Dls_D4h_Connect ..................................................................................... 3-173.3.2 Dls_D4h_SetLoop ..................................................................................... 3-183.3.3 Dls_D4h_LoopDirection ........................................................................... 3-203.3.4 Dls_Disconnect ......................................................................................... 3-20
3.4 DLS 400N ........................................................................................................ 3-213.4.1 Dls_D4n_Connect ..................................................................................... 3-213.4.2 Dls_D4n_SetLoop ..................................................................................... 3-223.4.3 Dls_D4n_LoopDirection ........................................................................... 3-243.4.4 Dls_Disconnect ......................................................................................... 3-24
3.5 DLS 400HE1 ................................................................................................... 3-263.5.1 Dls_D4he1_Connect ................................................................................. 3-263.5.2 Dls_D4he1_Bypass ................................................................................... 3-273.5.3 Dls_D4he1_LoopDirection ....................................................................... 3-273.5.4 Dls_D4he1_SetSlot ................................................................................... 3-283.5.5 Dls_D4he1_GetSlotInfo ............................................................................ 3-293.5.6 Dls_D4he1_IsChassisBypass .................................................................... 3-30
DLS 1200 Operating Manual
Page ii Table Of Contents - Spirent Communications
7104170669-12/04-3
3.5.7 Dls_D4he1_IsLoopReversed ..................................................................... 3-313.5.8 Dls_D4he1_Disconnect ............................................................................ 3-32
3.6 DLS 400HE2 ................................................................................................... 3-333.6.1 Dls_D4he2_Connect ................................................................................. 3-333.6.2 Dls_D4he2_Bypass ................................................................................... 3-343.6.3 Dls_D4he2_LoopDirection ....................................................................... 3-353.6.4 Dls_D4he2_SetSlot ................................................................................... 3-363.6.5 Dls_D4he2_GetSlotInfo ............................................................................ 3-373.6.6 Dls_D4he2_IsChassisBypass .................................................................... 3-383.6.7 Dls_D4he2_IsLoopReversed ..................................................................... 3-393.6.8 Dls_D4he2_Disconnect ............................................................................ 3-40
4. DLS 41xx TCL COMMANDS ...................................................................... 4-14.1 DLS 410A .......................................................................................................... 4-1
4.1.1 Dls_410A_Connect ..................................................................................... 4-14.1.2 Dls_410A_Disconnect ................................................................................. 4-24.1.3 Dls_410A_Init ............................................................................................. 4-34.1.4 Dls_410A_SetLoopMode ............................................................................ 4-34.1.5 Dls_410A_SetLoopsFile .............................................................................. 4-44.1.6 Dls_410A_SetModel .................................................................................... 4-54.1.7 Dls_410A_SetNoiseSource .......................................................................... 4-64.1.8 Dls_410A_SetSimulationMode ................................................................... 4-74.1.9 (Custom) Dls_410A_Loop ........................................................................... 4-84.1.10 (Standard based ANSI13 Modified1) Dls_410A_Loop ............................. 4-94.1.11 (Standard based ANSI13 Modified2) Dls_410A_Loop ........................... 4-104.1.12 (Standard based ANSI13) Dls_410A_Loop ............................................ 4-114.1.13 (Standard based 3.0Kft Bridged Tap) Dls_410A_Loop .......................... 4-124.1.14 (Standard based 9.0/12.0Kft Bridged Tap) Dls_410A_Loop .................. 4-134.1.15 (Standard based 15.0/17.5Kft Bridged Tap) Dls_410A_Loop ................ 4-144.1.16 (Standard based CSA4) Dls_410A_Loop ................................................ 4-154.1.17 (Standard Based Straight) Dls_410A_Loop ........................................... 4-164.1.18 Dls_410A_GetLoopInfo .......................................................................... 4-174.1.19 Dls_410A_GetLoopStateInfo .................................................................. 4-184.1.20 Dls_410A_GetNoiseInfo ......................................................................... 4-19
4.2 DLS 410E ........................................................................................................ 4-204.2.1 Dls_410E_Connect ................................................................................... 4-204.2.2 Dls_410E_Disconnect ............................................................................... 4-214.2.3 Dls_410E_EnableExtended ...................................................................... 4-224.2.4 Dls_410E_Init ........................................................................................... 4-234.2.5 Dls_410E_SetLoopsFile ............................................................................ 4-244.2.6 Dls_410E_SetNoiseSource ........................................................................ 4-254.2.7 Dls_410E_SetSimulationMode ................................................................. 4-264.2.8 Dls_410E_Loop ........................................................................................ 4-274.2.9 Dls_410E_GetExtendReachInfo ............................................................... 4-284.2.10 Dls_410E_GetFineCoarseInfo ................................................................ 4-294.2.11 Dls_410E_GetLoopStateInfo .................................................................. 4-304.2.12 Dls_410E_GetNoiseInfo ......................................................................... 4-31
4.3 DLS 414A ........................................................................................................ 4-334.3.1 Dls_414A_Connect ................................................................................... 4-334.3.2 Dls_414A_Disconnect ............................................................................... 4-344.3.3 Dls_414A_EnableExtended ...................................................................... 4-344.3.4 Dls_414A_Init ........................................................................................... 4-354.3.5 Dls_414A_SetLoopsFile ............................................................................ 4-36
DLS 1200 Operating Manual
Spirent Communications - Table Of Contents Page iii
7104170669-12/04-3
4.3.6 Dls_414A_SetNoiseSource ........................................................................ 4-374.3.7 Dls_414A_SetSimulationMode ................................................................. 4-384.3.8 Dls_414A_Loop ........................................................................................ 4-394.3.9 Dls_414A_GetExtendReachInfo ............................................................... 4-404.3.10 Dls_414A_GetFineCoarseInfo ................................................................ 4-414.3.11 Dls_414A_GetLoopStateInfo .................................................................. 4-424.3.12 Dls_414A_GetNoiseInfo ......................................................................... 4-43
4.4 DLS 414E ........................................................................................................ 4-444.4.1 Dls_414E_Connect ................................................................................... 4-444.4.2 Dls_414E_Disconnect ............................................................................... 4-454.4.3 Dls_414E_EnableExtended ...................................................................... 4-464.4.4 Dls_414E_Init ........................................................................................... 4-474.4.5 Dls_414E_SetLoopsFile ............................................................................ 4-484.4.6 Dls_414E_SetNoiseSource ........................................................................ 4-494.4.7 Dls_414E_SetSimulationMode ................................................................. 4-504.4.8 Dls_414E_Loop ........................................................................................ 4-514.4.9 Dls_414E_GetExtendReachInfo ............................................................... 4-524.4.10 Dls_414E_GetFineCoarseInfo ................................................................ 4-534.4.11 Dls_414E_GetLoopStateInfo .................................................................. 4-544.4.12 Dls_414E_GetNoiseInfo ......................................................................... 4-55
4.5 DLS 415E ........................................................................................................ 4-564.5.1 Dls_415E_Connect ................................................................................... 4-564.5.2 Dls_415E_Disconnect ............................................................................... 4-574.5.3 Dls_415E_EnableExtended ...................................................................... 4-584.5.4 Dls_415E_Init ........................................................................................... 4-594.5.5 Dls_415E_SetLoopsFile ............................................................................ 4-604.5.6 Dls_415E_SetNoiseSource ........................................................................ 4-614.5.7 Dls_415E_SetSimulationMode ................................................................. 4-624.5.8 Dls_415E_Loop ........................................................................................ 4-634.5.9 Dls_415E_GetExtendReachInfo ............................................................... 4-644.5.10 Dls_415E_GetFineCoarseInfo ................................................................ 4-654.5.11 Dls_415E_GetLoopStateInfo .................................................................. 4-664.5.12 Dls_415E_GetNoiseInfo ......................................................................... 4-67
5. DLS 5xxx TCL COMMANDS ...................................................................... 5-15.1 DLS 5A00 .......................................................................................................... 5-1
5.1.1 Dls_5A00_Connect ..................................................................................... 5-15.1.2 Dls_5A00_CrossTalkA ................................................................................ 5-25.1.3 Dls_5A00_CrossTalkB ................................................................................ 5-35.1.4 Dls_5A00_CrossTalkC ................................................................................ 5-45.1.5 Dls_5A00_Impulses .................................................................................... 5-65.1.6 Dls_5A00_Longitudinal .............................................................................. 5-75.1.7 Dls_5A00_Metallic ..................................................................................... 5-85.1.8 Dls_5A00_Mode .......................................................................................... 5-95.1.9 Dls_5A00_Output ...................................................................................... 5-105.1.10 Dls_5A00_Quiet ...................................................................................... 5-115.1.11 Dls_5A00_ShapedNoise .......................................................................... 5-125.1.12 Dls_5A00_WhiteNoise ............................................................................ 5-135.1.13 Dls_5A00_Disconnect ............................................................................. 5-14
5.2 DLS 5A01 ........................................................................................................ 5-155.2.1 Dls_5A01_Connect ................................................................................... 5-155.2.2 Dls_5A01_CrossTalkA .............................................................................. 5-165.2.3 Dls_5A01_CrossTalkB .............................................................................. 5-17
DLS 1200 Operating Manual
Page iv Table Of Contents - Spirent Communications
7104170669-12/04-3
5.2.4 Dls_5A01_CrossTalkC .............................................................................. 5-185.2.5 Dls_5A01_Impulses .................................................................................. 5-205.2.6 Dls_5A01_Longitudinal ............................................................................ 5-215.2.7 Dls_5A01_Metallic ................................................................................... 5-225.2.8 Dls_5A01_Output ...................................................................................... 5-245.2.9 Dls_5A01_Quiet ........................................................................................ 5-255.2.10 Dls_5A01_ShapedNoise .......................................................................... 5-265.2.11 Dls_5A01_ShapedNoiseLevel ................................................................. 5-275.2.12 Dls_5A01_WhiteNoise ............................................................................ 5-285.2.13 Dls_5A01_Disconnect ............................................................................. 5-295.2.14 DLS 5A01H ............................................................................................. 5-30
5.3 DLS Loader ..................................................................................................... 5-315.3.1 Dls_Loader_Connect ................................................................................ 5-315.3.2 Dls_Loader_GetNoiseInfoFromCard ....................................................... 5-325.3.3 Dls_Loader_GetNoiseInfoFromNifFile .................................................... 5-325.3.4 Dls_Loader_LoadNoiseFile ...................................................................... 5-345.3.5 Dls_Loader_Disconnect ............................................................................ 5-35
5.4 DLS 5204 ........................................................................................................ 5-365.4.1 Dls_5204_CombinerXtkRfi ....................................................................... 5-365.4.2 Dls_5204_Connect .................................................................................... 5-375.4.3 Dls_5204_Disconnect ............................................................................... 5-385.4.4 Dls_5204_GetFileNames .......................................................................... 5-395.4.5 Dls_5204_GetInjectorLoss ....................................................................... 5-405.4.6 Dls_5204_GetInstalledLicense ................................................................. 5-415.4.7 Dls_5204_GetMacAddress ....................................................................... 5-425.4.8 Dls_5204_GetNetworkName .................................................................... 5-435.4.9 Dls_5204_GetOutputCFRC ...................................................................... 5-445.4.10 Dls_5204_GetOutputLevel ...................................................................... 5-455.4.11 Dls_5204_GetSelectedChannel .............................................................. 5-465.4.12 Dls_5204_GetSoftwareVersion ............................................................... 5-475.4.13 Dls_5204_GetSystemID .......................................................................... 5-485.4.14 Dls_5204_CopyChannel ......................................................................... 5-495.4.15 Dls_5204_EnableCFRC .......................................................................... 5-505.4.16 Dls_5204_EnableOutput ......................................................................... 5-515.4.17 Dls_5204_GenerateSample .................................................................... 5-525.4.18 Dls_5204_LoadFile ................................................................................ 5-535.4.19 Dls_5204_LoadOutput ............................................................................ 5-545.4.20 Dls_5204_NoiseDisturber ...................................................................... 5-555.4.21 Dls_5204_ResetChannel ......................................................................... 5-565.4.22 Dls_5204_SaveCustomNoiseFile ............................................................ 5-575.4.23 Dls_5204_SelectNoise ............................................................................ 5-585.4.24 Dls_5204_SetCrestFactor ....................................................................... 5-595.4.25 Dls_5204_SetCustomerHeader ............................................................... 5-605.4.26 Dls_5204_SetExternalSync ..................................................................... 5-615.4.27 Dls_5204_SetImpulseLevel ..................................................................... 5-625.4.28 Dls_5204_SetImpulseRate ...................................................................... 5-635.4.29 Dls_5204_SetImpulseRepeatNumber ...................................................... 5-645.4.30 Dls_5204_SetImpulseType ...................................................................... 5-655.4.31 Dls_5204_SetInjectorLoss ...................................................................... 5-665.4.32 Dls_5204_SetMicroGain ........................................................................ 5-675.4.33 Dls_5204_SetNoiseGain ......................................................................... 5-685.4.34 Dls_5204_SetNoiseGainEX .................................................................... 5-695.4.35 Dls_5204_SetNumberOfSamples ............................................................ 5-705.4.36 Dls_5204_SetReferenceLevel .................................................................. 5-71
DLS 1200 Operating Manual
Spirent Communications - Table Of Contents Page v
7104170669-12/04-3
5.4.37 Dls_5204_SetSelectedChannel ............................................................... 5-725.4.38 Dls_5204_SetTDWhiteNoise ................................................................... 5-73
6. DLS 6000 and RS-232/GPIB TCL COMMANDS ................................ 6-16.1 RS232/GPIB ...................................................................................................... 6-1
6.1.1 Dls_Open Command ................................................................................... 6-16.1.2 Dls_SendString Command .......................................................................... 6-26.1.3 Dls_GetString Command ............................................................................ 6-36.1.4 Dls_Close Command ................................................................................... 6-4
6.2 DLS 6100 (XPS) ................................................................................................ 6-46.2.1 Dls_D6100_Connect Command ................................................................. 6-46.2.2 Dls_D6100_SetLength Command ............................................................... 6-56.2.3 Dls_Disconnect Command .......................................................................... 6-6
6.3 DLS 6200 (MPS) ............................................................................................... 6-76.3.1 Dls_D6200_Connect Command ................................................................. 6-76.3.2 Dls_D6200_SetMultipleLines Command .................................................... 6-86.3.3 Dls_D6200_SetLineLength Command ...................................................... 6-116.3.4 Dls_Disconnect Command ........................................................................ 6-12
7. DLS 1200 Scripting Example ........................................................................ 7-17.1 TR-048 Script Example ..................................................................................... 7-1
7.1.1 TCL Code .................................................................................................... 7-1
8. CUSTOMER SERVICE ................................................................................. 8-18.1 Customer Service Contact Information ............................................................. 8-18.2 DLS 1200 Software Maintenance ...................................................................... 8-1
DLS 1200 Operating Manual
Page vi Table Of Contents - Spirent Communications
7104170669-12/04-3
DLS 1200 Operating Manual
Spirent Communications - Page 1-1
7104170669-12/04-3
1. INTRODUCTION
1.1 About Spirent’s Involvement in Wireline Simulation
Thank you for choosing Spirent Communications.
Spirent Communications has been in the wireline simulation business for over 20 years. Since the days of the S2, Spirent has designed many new simulators both to customers' specifications and to conform to an ever-growing range of industry standards. By introducing the DLS 100 in 1985 we believe that we sold the world's first truly wideband wireline simulator with the capability to successfully simulate attenuation, char-acteristic impedance and delay.
1.2 About this ManualThis manual contains information about the DLS 1200 library for Spirent Connect. For complete informa-tion about the Spirent Connect software menu bars, tool bars or information about creating other scripts, see the Spirent Connect Online Help.
1.2.1 About Related Documentation and Products
Spirent Connect User Guide (included in the Spirent Connect help menu)
Existing customers can view and download manuals and software updates from the Spirent Communications extranet site:
https://ae.spirentcom.com/secure
Apply for a password at https://ae.spirentcom.com/customer_care/needlogin.htm
DLS 1200 Operating Manual
Page 1-2 - Spirent Communications
7104170669-12/04-3
DLS 1200 Operating Manual
Spirent Communications - Page 2-1
7104170669-12/04-3
2. GETTING STARTED
2.1 Compatible ProductsThe DLS 1200 ATS version 2.4 is compatible with the following platforms or products:
Spirent Connect Software Versions
• Spirent Connect version 1.1
Operating Systems Versions
Windows 98 2nd edition
Windows 2000 service pack 1.0
Windows NT 4.0 with service pack 4.0 and up
Communication Ports Versions
IEEE NI.488.2 version 1.7 or 2.1, Reference specific hardware release notes
on driver requirements.
RS-232Ethernet
Database
Borland Interbase version 6
Spirent Software
Spirent Connect version 1.1
DLS Interbase version 1.0.0
DLS Database version 1.1.1
DLS 1310 version 1.2.1
Factory Compensation version F1.0
DLS 5204 version 2.4.3 or higher
DLS 1200 Operating Manual
Page 2-2 - Spirent Communications
7104170669-12/04-3
Spirent Equipment
Table 2-1:Supported Products and Features
Supported Products Features Supported
DLS 400 A DLS_Sendstring and DLS_Getstring only
DLS 400BR DLS_Sendstring and DLS_Getstring only
DLS 400E 2 Mb DLS_Sendstring and DLS_Getstring only
DLS 400 E 6Mb DLS_Sendstring and DLS_Getstring onlyc
DLS 400 E Generic DLS_Sendstring and DLS_Getstring only
DLS 400S DLS_Sendstring and DLS_Getstring only
DLS 400H Yes
DLS 400HE1 Yes
DLS 400HE2 Yes
DLS 400HN Yes
DLS 400N Yes
DLS 400IA Yes
DLS 400IAE Yes
DLS 400J DLS_Sendstring and DLS_Getstring only
DLS 410A Yes
DLS 410E Yes
DLS 410J DLS_Sendstring and DLS_Getstring only
DLS 414A Yes
DLS 414E Yes
DLS 415E Yes
DLS 5101 Yes
DLS 5103 Yes
DLS 5204 (v1.2.1)??????? Yes
DLS 5A00 internal impairment card Yes
DLS 5A01H internal impairment card Yes
DLS 6100 (XPS) Yes
DLS 6200 (MPS) Yes
DLS 6300 DLS_Sendstring and DLS_Getstring only
DLS 6400 DLS_Sendstring and DLS_Getstring only
DLS 6500 DLS_Sendstring and DLS_Getstring only
DLS 1200 Operating Manual
Spirent Communications - Page 2-3
7104170669-12/04-3
2.1.1 Installing Spirent Connect SoftwareSpirent Connect 1.1 or higher must be installed on your computer prior to installing the DLS 1200. The Spirent Connect installation disk is included with the DLS 1200.
This chapter of the manual describes only the software options for the DLS 1200. For complete information about installing the Spirent Connect Software or for information about the menu bars and tool bar options, contact information can be found in the “About this Guide” section of the Spirent Connect User Guide
2.1.2 Installing the DLS 1200 Module Software
Insert the DLS 1200 Software Installation CD in the computer CD drive. The Installation Wizard will start automatically. Simply follow the instructions on the Wizard’s series of dialog boxes. The installation pro-gram will also install DLS InterBase version 1.0.0 and DLS Database version 1.1.0 if they have not been installed before.
2.1.3 Installing the IEEE 488 (GPIB) Card and Software
The IEEE 488 portion of the control software supplied by Spirent Communications only works with a National™ IEEE 488 interface card. If necessary, install the National™ IEEE 488 interface card in the com-puter. Please refer to the “NATIONAL INSTRUMENTS GPIB CARD AND SOFTWARE INSTALLA-TION” for information on how to install the NI card and associated software.
2.2 Starting Up the Spirent Connect SoftwareTo access the main window:
DLS 8000 series DLS_Sendstring and DLS_Getstring only
Table 2-1:Supported Products and Features
DLS 1200 Operating Manual
Page 2-4 - Spirent Communications
7104170669-12/04-3
1) From the Start menu, select Programs>Spirent> Spirent Connect>Spirent Connect or double-click the SpirentConnect icon on your desktop. The SpirentConnect main window appears.
Figure 2.1 Spirent Connect Software - Main Window
The left-hand side of main window displays a tree view menu listing all available directories, subdirectories, folders and files. When you highlight the lowest level item (test file) in the tree view menu, script for the selected test appears on the right-hand side of the main window (in the script window). The menu bar and toolbar are the same for all scripts. For complete information about the Spirent Connect software menu bars, tool bars or information about creating other scripts, see the Spirent Connect User Guide.
2.2.4 Accessing the DLS 1200 Command Widget(s)
There are two ways to use the extended DLS commands in Spirent Connect. The easiest way is to use the command insert widgets tool as follows:
1. Start the Spirent Connect application.2. Select the New command from the File menu to open an active text editor window.3. Prior to running any script users must enter “package require dls” in the text editor window.
DLS 1200 Operating Manual
Spirent Communications - Page 2-5
7104170669-12/04-3
4. From the Tools menu, select the Command Inserts command, Dls sub command.
5. Select one of the products from the list such as the DLS 410E. A unit command tree view window appears.
6. Select a command from the tree view. A command insert window for the selected command appears.
DLS 1200 Operating Manual
Page 2-6 - Spirent Communications
7104170669-12/04-3
7. Fill in parameters in command insert window and click OK. The tcl code for the command appears in the active text editor window. (Start with the connect command).
8. Select other commands and fill in parameters in command insert windows. (Finish with the disconnect command).
IMPORTANT: Insert the commands one at a time from top to bottom of the command tree view (with the exception of the disconnect command). Some commands require others to be inserted as a prerequisite.
The RS232/GPIB module allows you to program DLS devices using Dls_SendString and Dls_GetString along with SCPI commands.
For those who are familiar with the Spirent Connect and DLS 1200 package, typing the DLS commands directly on the Spirent Connect edit field may be more efficient.
Finally, you have to make sure the appropriate DLS devices are connected to the right COM ports or GPIB addresses or IP addresses (DLS 5200/5204) and make sure the devices have been turned on before they run the scripts.
DLS 1200 Operating Manual
Spirent Communications - Page 3-1
7104170669-12/04-3
3. DLS 400xx TCL COMMANDS
3.1 DLS 400IA/E
3.1.1 Dls_400IA_Connect
Command Name:
Dls_400IA_Connect
Usage:
Dls_400IA_Connect type first_address second_address
Parameters:
type Serial or GPIB.first_address First address of the DLS400IA/E.second_address Second address of the DLS400IA/E.
Command Insert Widget:
Example:
Dls_400IA_Connect GPIB 14 15Dls_400IA_Connect Serial 2 3
DLS 1200 Operating Manual
Page 3-2 - Spirent Communications
7104170669-12/04-3
Description:
Establishes a connection to the DLS 400IA/E system via GPIB or serial communications.
3.1.2 Dls_400IA_Disconnect
Command Name:
Dls_400IA_Disconnect
Usage:
Dls_400IA_ Disconnect type
Parameters:
type Serial or GPIB.
Command Insert Widget:
Example:
Dls_400IA_Disconnect GPIB
Description:
Terminates a connection to the DLS 400IA/E system via GPIB or serial communications.
DLS 1200 Operating Manual
Spirent Communications - Page 3-3
7104170669-12/04-3
3.1.3 Dls_EnableCompensation
Command Name:
Dls_EnableCompensation
Usage:
Dls_EnableCompensation
Parameters:
mode The type of compensation to be applied. There 4 settings for this parameter:0 no compensation1 loop and noise compensation2 loop compensation only3 noise compensation only
file_name The path and filename of the compensation file. i.e. “C:/DLS_1310_compensation/ R_2002_12_17_H10M47.csv”
Command Insert Widget:
3.1.4 Dls_400IA_Loop
Command Name:
Dls_400IA_Loop
DLS 1200 Operating Manual
Page 3-4 - Spirent Communications
7104170669-12/04-3
Usage:
Dls_400IA_Loop loop
Parameters:loop The type of loop to set. See Section 3.1.1 "DLS 400IA Loop Parameters" for full list of
loops.comp_line The compensated loop length required to be adjusted for the standard loop. This parameter
is optional.comp_tap THe compensated length for the bridged tap . This parameter is optional and is only appli-
cable to the bridged tap loops.
Command Insert Widget:
Example:
Dls_400IA_Loop “TR-048/Straight Loops/3 kft” Dls_400IA_Loop “TR-048/Straight Loops/3 kft” -100Dls_400IA_Loop “TR-048/Bridged Tap Loop/9 kft/100 BT” -100 -5
Description:
Sets a loop (optionally a compensated loop) on the 400IA or 400IAE system.
3.1.5 Dls_400IA_WhiteNoise
Command Name:
Dls_400IA_WhiteNoise
DLS 1200 Operating Manual
Spirent Communications - Page 3-5
7104170669-12/04-3
Usage:
Dls_400IA_WhiteNoise side status –default
Dls_400IA_WhiteNoise side status –level -amount
Parameters:
side Side to adjust. ‘A’ for DSLAM side. ‘B’ for CPE side.status ‘ON’ enables action. ‘OFF’ disables action.–level amount Power level (dBm) of white noise to set.–default Sets the level to its default level.
Command Insert Widget:
Example:
Dls_400IA_WhiteNoise A ON –defaultDls_400IA_WhiteNoise A ON –level –141.2
Description:
Sets white noise for the 400IA or 400IAE system.
3.1.6 Dls_400IA_CrosstalkNoise
Command Name:
Dls_400IA_CrosstalkNoise
DLS 1200 Operating Manual
Page 3-6 - Spirent Communications
7104170669-12/04-3
Usage:
Dls_400IA_CrosstalkNoise side type –disturber amount
Dls_400IA_CrosstalkNoise side –level amount
Parameters:
side Side to adjust. ‘A’ for DSLAM side. ‘B’ for CPE side.type Type of cross talk noise to apply.
HDSL NextDSL NextT1-413 II T1 (AMI) NextETSI-AETSI-BITU-T Euro-K
Note: ETSI-A, ETSI-B, and ITU-T Euro-K can only be applied on a DLS 400IAE system.
–disturber amount Number of disturbers to apply.–level amount Level (dBm) of cross talk noise to apply.
Command Insert Widget:
Example:
Dls_400IA_CrosstalkNoise A “T1-413 II T1 (AMI) Next” –disturber 5Dls_400IA_CrosstalkNoise B “HDSL Next” –level –53.8
DLS 1200 Operating Manual
Spirent Communications - Page 3-7
7104170669-12/04-3
Description:
Sets cross talk noise on the 400IA or 400IAE system.
3.1.7 Dls_400IA_ShapedNoise
Command Name:
Dls_400IA_ShapedNoise
Usage:
Dls_400IA_ShapedNoise side file level dBm
Parameters:
side Side to adjust. ‘A’ for DSLAM side. ‘B’ for CPE side.file Noise file with location to load.level Level to apply to noise
Command Insert Widget:
Example:
Dls_400IA_ShapedNoise A \“C:/Program Files/Spirent Communications/DLS 5A17/DLS 5A01 Series/1.0/Shaped Noise Files/Tone10.shp” -50 dBm
Description:
Load and apply a shaped tone.
DLS 1200 Operating Manual
Page 3-8 - Spirent Communications
7104170669-12/04-3
3.1.8 Dls_400IA_Impulses
Command Name:
Dls_400IA_Impulses
Usage:
Dls_400IA_Impulses side impulse_type amplitude duration impulse_number
Dls_400IA_Impulses side $impulse $amplitude 1.1 15
Parameters:
side Side to adjust. ‘A’ for DSLAM side. ‘B’ for CPE side.impulse_type Type of impulse to use. ADSL-C1or ADSL-C2amplitude Amplitude of impulse. Floatduration Duration of impulses. Float.impulse_number Number of impulses to be triggered during duration seconds. Integer.
Command Insert Widget:
Example:
Dls_400IA_Impulses A ADSL-C1 20.0 1.1 15
Description:
Sends X number of Impulses per Y number of seconds.
3.1.9 Dls_400IA_Output
Command Name:
Dls_400IA_Output
DLS 1200 Operating Manual
Spirent Communications - Page 3-9
7104170669-12/04-3
Usage:
Dls_400IA_Output side status
Parameters:
side Side to adjust. ‘A’ for DSLAM side. ‘B’ for CPE side.status ‘ON’ enables action. ‘OFF’ disables action.
Command Insert Widget:
Example:
Dls_400IA_Output A ON
Description:
Enables or disables applied noises to the requested side of the DLS 400IA/E system.
3.1.10 Dls_400IA_Quiet
Command Name:
Dls_400IA_Quiet
Usage:
Dls_400IA_Quiet side
Parameters:
side Side to adjust. ‘A’ for DSLAM side. ‘B’ for CPE side.
DLS 1200 Operating Manual
Page 3-10 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_400IA_Quiet ADls_400IA_Quiet B
Description:
Removes all applied noises on the requested side.
3.1.1 DLS 400IA Loop ParametersThe DLS 1400 ATS uses the DLS 400IA Series loop function to set loops. This section outlines the type of loop (and associated parameters) that this function can set.
3.1.1.1 Straight Loops
Works with:
• DLS 400IA• DLS 400IAE
Loop length (kft) Usage as a parameter to a function call
0 TR-048/Straight Loops/0 kft
1 TR-048/Straight Loops/1 kft
2 TR-048/Straight Loops/2 kft
DLS 1200 Operating Manual
Spirent Communications - Page 3-11
7104170669-12/04-3
Example:
Dls_400IA_Loop “TR-048/Straight Loops/5 kft”
3.1.1.2 DLS 400IAE Straight Loops
Works with:
DLS 400IAE
3 TR-048/Straight Loops/3 kft
4 TR-048/Straight Loops/4 kft
5 TR-048/Straight Loops/5 kft
6 TR-048/Straight Loops/6 kft
7 TR-048/Straight Loops/7 kft
8 TR-048/Straight Loops/8 kft
9 TR-048/Straight Loops/9 kft
10 TR-048/Straight Loops/10 kft
11 TR-048/Straight Loops/11 kft
12 TR-048/Straight Loops/12 kft
13 TR-048/Straight Loops/13 kft
14 TR-048/Straight Loops/14 kft
15 TR-048/Straight Loops/15 kft
16 TR-048/Straight Loops/16 kft
17 TR-048/Straight Loops/17 kft
17.5 TR-048/Straight Loops/17.5 kft
18 TR-048/Straight Loops/18 kft
Loop length (kft)
Usage as a parameter to a function call
0 TR-048/Straight Loops/0 km
0.9 TR-048/Straight Loops/0.9 km
1.4 TR-048/Straight Loops/1.4 km
1.8 TR-048/Straight Loops/1.8 km
Loop length (kft) Usage as a parameter to a function call
DLS 1200 Operating Manual
Page 3-12 - Spirent Communications
7104170669-12/04-3
Example:
Dls_400IA_Loop “TR-048/Straight Loops/3.5 km”
3.1.1.3 Fixed Loops
Works with:
• DLS 400IA• DLS 400IAE
Loop Type Usage as a parameter to a function call
CSA #4 TR-048/Fixed Loops/CSA/4IA
MID-CSA #6 TR-048/Fixed Loops/MID-CSA/4IA
ANSI 13 TR-048/Fixed Loops/ANSI/13IA
Example:
Dls_400IA_Loop “TR-048/Fixed Loops/MID-CSA/4IA”
3.1.1.4 Bridged Tap (BT) Loops
Works with:
• DLS 400IA• DLS 400IAE
9 kft Loops
BT length (kft) Usage as a parameter to a function call
2.15 TR-048/Straight Loops/2.15 km
2.7 TR-048/Straight Loops/2.7 km
2.8 TR-048/Straight Loops/2.8 km
3.5 TR-048/Straight Loops/3.5 km
3.6 TR-048/Straight Loops/3.6 km
4.2 TR-048/Straight Loops/4.2 km
4.5 TR-048/Straight Loops/4.5 km
0 TR-048/Bridged Tap Loops/9kft/0 BT
50 TR-048/Bridged Tap Loops/9kft/50 BT
150 TR-048/Bridged Tap Loops/9kft/150 BT
Loop length (kft)
Usage as a parameter to a function call
DLS 1200 Operating Manual
Spirent Communications - Page 3-13
7104170669-12/04-3
12 kft Loops
BT length (kft) Usage as a parameter to a function call
0 TR-048/Bridged Tap Loops/12kft/0 BT
50 TR-048/Bridged Tap Loops/12kft/50 BT
150 TR-048/Bridged Tap Loops/12kft/150 BT
250 TR-048/Bridged Tap Loops/12kft/250 BT
350 TR-048/Bridged Tap Loops/12kft/350 BT
500 TR-048/Bridged Tap Loops/12kft/500 BT
750 TR-048/Bridged Tap Loops/12kft/750 BT
1250 TR-048/Bridged Tap Loops/12kft/1250 BT
1500 TR-048/Bridged Tap Loops/12kft/1500 BT
17.5 kft Loops
BT length (kft) Usage as a parameter to a function call
0 TR-048/Bridged Tap Loops/17.5kft/0 BT
50 TR-048/Bridged Tap Loops/17.5kft/50 BT
150 TR-048/Bridged Tap Loops/17.5kft/150 BT
200 TR-048/Bridged Tap Loops/17.5kft/200 BT
Example:
Dls_400IA_Loop “TR-048/Bridged Tap Loops/12kft/1500 BT”
3.2 DLS 400HN
3.2.2 Dls_D4hn_Connect
Command Name:
Dls_D4hn_Connect
250 TR-048/Bridged Tap Loops/9kft/250 BT
350 TR-048/Bridged Tap Loops/9kft/350 BT
500 TR-048/Bridged Tap Loops/9kft/500 BT
750 TR-048/Bridged Tap Loops/9kft/750 BT
1250 TR-048/Bridged Tap Loops/9kft/1250 BT
1500 TR-048/Bridged Tap Loops/9kft/1500 BT
DLS 1200 Operating Manual
Page 3-14 - Spirent Communications
7104170669-12/04-3
Usages:
Dls_D4hn_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial (RS232) or
address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_D4hn_Connect Serial 1Dls_D4hn_Connect GPIB 1
Descriptions:
Establish communication with DLS 400HN device, via RS-232/GPIB.
3.2.3 Dls_D4hn_SetLoop
Command Name:
Dls_D4hn_SetLoop
Usages:
Dls_D4hn_SetLoop loop line tapA tapB
DLS 1200 Operating Manual
Spirent Communications - Page 3-15
7104170669-12/04-3
Parameters:
loop This flag allows you to choose a standard or variable loop that DLS 400HN can simulate. If a standard loop (i.e. CSA_#6) is chosen, flags line, tapA or tapB can be 0 or not entered at all. For a variable loop, with or without taps (i.e., Variable_24_AWG or Var_24_AWG+Tap), you should choose a value (according to the DLS 400HN specifications) for line, tapA and tapB. This flag is not case sensitive.
line This flag allows you to set the length of a variable loop, with or without taps. The flag line should take a value (i.e. 12000) according to the DLS 400HN spec-ifications.
tapA This flag allows you to set a value (i.e., 0, 500, 1000 or 1500) for tapA, when you chooses a variable loop with taps (Var_24_AWG+Tap or Var_26_AWG+Tap).
tapB This flag allows you to choose a value (i.e., 0, 500, 1000 or 1500) for tapB, when you chooses a variable loop with taps (Var_24_AWG+Tap or Var_26_AWG+Tap).
Command Insert Widget:
Examples:
Dls_D4hn_SetLoop CSA_#6Dls_D4hn_SetLoop CSA_#6 0 0 0Dls_D4hn_SetLoop Variable_24_AWG 7000 0 0Dls_D4hn_SetLoop Var_24_AWG+Tap 11000 500 1500
Descriptions:
Set a standard or variable loop, according to the DLS 400HN specifications.
DLS 1200 Operating Manual
Page 3-16 - Spirent Communications
7104170669-12/04-3
3.2.4 Dls_D4hn_LoopDirection
Command Name:
Dls_D4hn_LoopDirection
Usages:
Dls_D4hnb_LoopDirection direction
Parameters:
direction This flag allows you to set the loop direction to FORWARD or REVERSE.
Command Insert Widget:
Examples:
Dls_D4hn_LoopDirection FORWARDDls_D4hn_LoopDirection REVERSE
Descriptions:
This command sets the loop direction to FORWARD or REVERSE.
3.2.5 Dls_Disconnect
Command Name:
Dls_Disconnect
DLS 1200 Operating Manual
Spirent Communications - Page 3-17
7104170669-12/04-3
Usages:
Dls_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting any device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_Disconnect SerialDls_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
3.3 DLS 400H
3.3.1 Dls_D4h_Connect
Command Name:
Dls_D4h_Connect
DLS 1200 Operating Manual
Page 3-18 - Spirent Communications
7104170669-12/04-3
Usages:
Dls_D4h_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial
(RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget :
Examples:
Dls_D4h_Connect Serial 1Dls_D4h_Connect GPIB 1
Descriptions:
Establish communication with DLS 400H device, via RS-232/GPIB.
3.3.2 Dls_D4h_SetLoop
Command Name:
Dls_D4h_SetLoop
Usages:
Dls_D4h_SetLoop loop line tapA tapB
DLS 1200 Operating Manual
Spirent Communications - Page 3-19
7104170669-12/04-3
Parameters:
loop This flag allows you to choose a standard or variable loop that DLS 400H can simulate. If a standard loop (i.e., CSA_#6) is chosen, flags line, tapA or tapB will be 0 or not entered at all. For a variable loop, with or without taps (i.e., Variable_24_AWG or Var_24_AWG+Tap), you should choose a value (according to the DLS 400H specifications) for line, tapA and tapB. This flag is not case sensitive.
line This flag allows you to set the length of a variable loop, with or without taps. The flag line should take a value (i.e., 12000) according to the DLS 400H speci-fications.
tapA This flag allows you to set a value (i.e., 0, 500, 1000 or 1500) for tapA, when you chooses a variable loop with taps (Var_24_AWG+Tap or Var_26_AWG+Tap).
tapB This flag allows you to choose a value (i.e., 0, 500, 1000 or 1500) for tapB, when you chooses a variable loop with taps (Var_24_AWG+Tap or Var_26_AWG+Tap).
Command Insert Widget :
Examples :
Dls_D4h_SetLoop CSA_#6Dls_D4h_SetLoop CSA_#6 0 0 0Dls_D4h_SetLoop Variable_24_AWG 7000 0 0Dls_D4h_SetLoop Var_24_AWG+Tap 11000 500 1500
Descriptions:
Set a standard or variable loop, according to the DLS 400H specifications.
DLS 1200 Operating Manual
Page 3-20 - Spirent Communications
7104170669-12/04-3
3.3.3 Dls_D4h_LoopDirection
Command Name:
Dls_D4h_LoopDirection
Usages:
Dls_D4h_LoopDirection direction
Parameters:
direction This flag allows you to set the loop direction to FORWARD or REVERSE.
Command Insert Widget:
Examples:
Dls_D4h_LoopDirection FORWARDDls_D4h_LoopDirection REVERSE
Descriptions:
This command sets the loop direction to FORWARD or REVERSE.
3.3.4 Dls_Disconnect
Command Name:
Dls_Disconnect
DLS 1200 Operating Manual
Spirent Communications - Page 3-21
7104170669-12/04-3
Usages:
Dls_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting any device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_Disconnect SerialDls_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
3.4 DLS 400N
3.4.1 Dls_D4n_Connect
Command Name:
Dls_D4n_Connect
DLS 1200 Operating Manual
Page 3-22 - Spirent Communications
7104170669-12/04-3
Usages:
Dls_D4n_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial (RS232) or
address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_D4n_Connect Serial 1Dls_D4n_Connect GPIB 1
Descriptions:
Establish communication with DLS 400N device, via RS-232/GPIB.
3.4.2 Dls_D4n_SetLoop
Command Name:
Dls_D4n_SetLoop
Usages:
Dls_D4n_SetLoop loop line tapA tapB
DLS 1200 Operating Manual
Spirent Communications - Page 3-23
7104170669-12/04-3
Parameters:
loop This flag allows you to choose a standard or variable loop that DLS 400N can simulate. If a stan-dard loop (i.e., ANSI_#7) is chosen, flags line, tapA or tapB can be 0 or not entered at all. For a variable loop, with or without taps (i.e., Variable_24_AWG or Var_24_AWG+Tap), you should choose a value (according to the DLS 400N specifications) for line, tapA and tapB. This flag is not case sensitive.
line This flag allows you to set the length of a variable loop, with or without taps. The flag line should take a value (i.e., 12000) according to the DLS 400N specifications.
tapA This flag allows you to set a value (i.e., 0, 500, 1000 or 1500) for tapA, when you chooses a vari-able loop with taps (Var_24_AWG+Tap or Var_26_AWG+Tap).
tapB This flag allows you to choose a value (i.e., 0, 500, 1000 or 1500) for tapB, when you chooses a variable loop with taps (Var_24_AWG+Tap or Var_26_AWG+Tap).
Command Insert Widget:
Examples :
Dls_D4n_SetLoop ANSI_#7Dls_D4n_SetLoop ANSI_#7 0 0 0Dls_D4n_SetLoop Variable_24_AWG 7000 0 0Dls_D4n_SetLoop Var_24_AWG+Tap 11000 500 1500
Descriptions:
Set a standard or variable loop, according to the DLS 400N specifications.
DLS 1200 Operating Manual
Page 3-24 - Spirent Communications
7104170669-12/04-3
3.4.3 Dls_D4n_LoopDirection
Command Name:
Dls_D4n_LoopDirection
Usages:
Dls_D4n_LoopDirection direction
Parameters:
direction This flag allows you to set the loop direction to FORWARD or REVERSE.
Command Insert Widget:
Examples:
Dls_D4n_LoopDirection FORWARDDls_D4n_LoopDirection REVERSE
Descriptions:
This command sets the loop direction to FORWARD or REVERSE.
3.4.4 Dls_Disconnect
Command Name:
Dls_Disconnect
Usages:
Dls_Disconnect serial_gpib
DLS 1200 Operating Manual
Spirent Communications - Page 3-25
7104170669-12/04-3
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting any device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_Disconnect SerialDls_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
DLS 1200 Operating Manual
Page -26 - Spirent Communications
7104170669-12/04-3
3.5 DLS 400HE1
3.5.1 Dls_D4he1_Connect
Command Name:
Dls_D4he1_Connect
Usages:
Dls_D4he1_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_add This flag allows you to select the COM port number, i.e., 1 to 4 for Serial
(RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_D4he1_Connect Serial 1Dls_D4he1_Connect GPIB 1
Descriptions:
Establish communication with DLS 400HE1 device, via RS-232/GPIB.
DLS 1200 Operating Manual
Spirent Communications - Page -27
7104170669-12/04-3
3.5.2 Dls_D4he1_Bypass
Examples:
Dls_D4he1_Bypass YESDls_D4he1_Bypass NO
Descriptions:
Set DLS 400HE1 chassis bypass YES or NO.
3.5.3 Dls_D4he1_LoopDirection
Command Name:
Dls_D4he1_LoopDirection
Usages:
Dls_D4he1_LoopDirection direction
Parameters:
direction This flag allows you to set the loop direction to FORWARD or REVERSE.
DLS 1200 Operating Manual
Page -28 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_LoopDirection FORWARDDls_D4he1_LoopDirection REVERSE
Descriptions:
This command sets the loop direction to FORWARD or REVERSE.
3.5.4 Dls_D4he1_SetSlot
Command Name:
Dls_D4he1_SetSlot
Usages:
Dls_D4he1_SetSlot slot length line_tap
Parameters:
slot Set the slot number in the chassis.length Set the length of the slot.line_tap Select the slot configuration as Line or Tap.
DLS 1200 Operating Manual
Spirent Communications - Page -29
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_SetSlot 1 100 LineDls_D4he1_SetSlot 2 50 Tap
Descriptions:
Set slot configuration for a slot in DLS 400HE1 chassis.
3.5.5 Dls_D4he1_GetSlotInfo
Command Name:
Dls_D4he1_GetSlotInfo
Usages:
Dls_D4he1_GetSlotInfo slot
Parameters:
slot Select the slot number in the chassis.
DLS 1200 Operating Manual
Page -30 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_GetSlotInfo 1
Descriptions:
Get slot configuration information for a slot in DLS 400HE1 chassis and print the information on the result windows.
3.5.6 Dls_D4he1_IsChassisBypass
Command Name:
Dls_D4he1_IsChassisBypass
Usages:
Dls_D4he1_IsChassisBypass
Parameters:
None.
DLS 1200 Operating Manual
Spirent Communications - Page -31
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_IsChassisBypass
Descriptions:
This command queries the chassis bypass status.
3.5.7 Dls_D4he1_IsLoopReversed
Command Name:
Dls_D4he1_IsLoopReversed
Usages:
Dls_D4he1_IsLoopReversed
Parameters:
None.
DLS 1200 Operating Manual
Page -32 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_IsLoopReversed
Descriptions:
This command queries the chassis if the loop is set in REVERSE or FORWARD status.
3.5.8 Dls_D4he1_Disconnect
Command Name:
Dls_D4he1_Disconnect
Usages:
Dls_D4he1_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting any device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
DLS 1200 Operating Manual
Spirent Communications - Page -33
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_Disconnect SerialDls_D4he1_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
3.6 DLS 400HE2
3.6.1 Dls_D4he2_Connect
Command Name:
Dls_D4he2_Connect
Usages:
Dls_D4he2_Connect serial_gpib com_addr1 com_addr2
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr1 Select the COM port number for chassis 1, i.e., 1 to 4 for Serial (RS232) or address, i.e., 1 to
30 for GPIB. com_addr2 Select the COM port number for chassis 2, i.e., 1 to 4 for Serial (RS232) or address, i.e., 1 to
30 for GPIB. The COM port or GPIB address for chassis 2 must be different for chassis 1.
DLS 1200 Operating Manual
Page -34 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_Connect Serial 1 2Dls_D4he1_Connect GPIB 14 15
Descriptions:
Establish communication with DLS 400HE2 chassises, via RS-232/GPIB.
3.6.2 Dls_D4he2_Bypass
Command Name:
Dls_D4he1_Bypass
Usages:
Dls_D4he1_Bypass chassis bypass
Parameters:
chassis Select chassis 1 or chassis 2. bypass Set the selected chassis in bypass if the flag is YES or not in bypass if the flag is NO.
DLS 1200 Operating Manual
Spirent Communications - Page -35
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_Bypass Chassis1 NODls_D4he2_Bypass Chassis2 YES
Descriptions:
Set DLS 400HE2 chassis 1 or chassis 2 bypass NO or YES.
3.6.3 Dls_D4he2_LoopDirection
Command Name:
Dls_D4he2_LoopDirection
Usages:
Dls_D4he2_LoopDirection chassis direction
Parameters:
chassis Select chassis 1 or chassis 2. direction This flag allows you to set the loop direction to FORWARD or REVERSE.
DLS 1200 Operating Manual
Page -36 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_LoopDirection Chassis1 FORWARDDls_D4he1_LoopDirection Chassis2 REVERSE
Descriptions:
This command sets the loop direction to FORWARD or REVERSE for chassis 1 or chassis 2.
3.6.4 Dls_D4he2_SetSlot
Command Name:
Dls_D4he2_SetSlot
Usages:
Dls_D4he2_SetSlot chassis slot length line_ta
Parameters:
chassis Select chassis 1 or chassis 2.slot Set the slot number in the chassis.length Set the length of the slot.line_tap Select the slot configuration as Line or Tap.
DLS 1200 Operating Manual
Spirent Communications - Page -37
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_SetSlot Chassis1 1 100 LineDls_D4he2_SetSlot Chassis2 3 50 Tap
Descriptions:
Set slot configuration for a slot in DLS 400HE2 chassis 1 or chassis 2.
3.6.5 Dls_D4he2_GetSlotInfo
Command Name:
Dls_D4he2_GetSlotInfo
Usages:
Dls_D4he2_GetSlotInfo chassis slot
Parameters:
chassis Select chassis 1 or chassis 2.slot Select the slot number in the chassis.
DLS 1200 Operating Manual
Page -38 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he1_GetSlotInfo Chassis1 1Dls_D4he1_GetSlotInfo Chassis2 3
Descriptions:
Get slot configuration information for a slot in DLS 400HE2 chassis 1 or chassis 2 and print the information on the result windows.
3.6.6 Dls_D4he2_IsChassisBypass
Command Name:
Dls_D4he2_IsChassisBypass
Usages:
Dls_D4he2_IsChassisBypass chassis
Parameters:
chassis Select chassis 1 or chassis 2.
DLS 1200 Operating Manual
Spirent Communications - Page -39
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_IsChassisBypass chassis1Dls_D4he2_IsChassisBypass chassis2
Descriptions:
This command queries the chassis bypass status for DLS 400HE2 chassis 1 or chassis 2.
3.6.7 Dls_D4he2_IsLoopReversed
Command Name:
Dls_D4he2_IsboopReversed
Usages:
Dls_D4he2_IsLoopReversed chassis
Parameters:
chassis Select chassis 1 or chassis 2.
DLS 1200 Operating Manual
Page -40 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_IsLoopReversed Chassis1Dls_D4he2_IsLoopReversed Chassis2
Descriptions:
This command queries the DLS 400HE2 chassises if the loop is set in REVERSE or FORWARD status.
3.6.8 Dls_D4he2_Disconnect
Command Name:
Dls_D4he2_Disconnect
Usages:
Dls_D4he2_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting the device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
DLS 1200 Operating Manual
Spirent Communications - Page -41
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_D4he2_Disconnect SerialDls_D4he2_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
DLS 1200 Operating Manual
Page -42 - Spirent Communications
7104170669-12/04-3
DLS 1200 Operating Manual
Spirent Communications - Page 4-1
7104170669-12/04-3
4. DLS 41xx TCL COMMANDS
4.1 DLS 410A
4.1.1 Dls_410A_Connect
Command Name:
Dls_410A_Connect
Usage:
Dls_410A_Connect type first_address second_address
Parameters:
type Serial or GPIB.first_address First address of the DLS 410A address of DLS 411A chassis.second_address Second address of the DLS410A address of DLS 412A chassis.
Command Insert Widget:
Example:
Dls_410A_Connect GPIB 14 15Dls_410A_Connect Serial 2 3
DLS 1200 Operating Manual
Page 4-2 - Spirent Communications
7104170669-12/04-3
Description:
Establishes a connection to the DLS 410A system via GPIB or serial communications.
4.1.2 Dls_410A_Disconnect
Command Name:
Dls_410A_Disconnect
Usage:
Dls_410A_ Disconnect
Parameters:
None
Command Insert Widget:
Example:
Dls_410A_Disconnect
Description:
Terminates a connection to the DLS 410A system via GPIB or serial communications.
DLS 1200 Operating Manual
Spirent Communications - Page 4-3
7104170669-12/04-3
4.1.3 Dls_410A_Init
Command Name:
Dls_410A_Init
Usage:
Dls_410A_Init
Parameters:
None
Command Insert Widget:
Example:
Dls_410A_Init
Description:
Initializes the DLS 410A units and sets unit default values. The default values are: loop = straight, length = 9000 feet, noise A = off, noise B = off, state = Normal, and model = T.417.
4.1.4 Dls_410A_SetLoopMode
Command Name:
Dls_410A_SetLoopMode
Usage:Dls_410A_SetLoopMode type
DLS 1200 Operating Manual
Page 4-4 - Spirent Communications
7104170669-12/04-3
Parameters:
type Whether the loop is compensated or not. There are 2 settings for this parameter:uncompensatedcompensated
Command Insert Widget:
4.1.5 Dls_410A_SetLoopsFile
Command Name:
Dls_410A_SetLoopsFile
Usage:
Dls_410A_SetLoopsFile loop
Dls_410A_SetLoopsFile comp
Parameters:
loop The loop file path and name to set. comp The compensated loop file path and name. This parameter is only required if you set the
Loop Mode as compensated with the 410A_SetLoopMode command (otherwise this is blank).
DLS 1200 Operating Manual
Spirent Communications - Page 4-5
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_SetLoopsFile \ "C:\\ProgramFiles\\Spirent\\SpirentConnect\\api\\Dls\\lib\\Dls410A_LoopLength_Setting.csv" \ ""
Description:
Sets a file path for a loop (compensated loop) on the 410A system.
4.1.6 Dls_410A_SetModel
Command Name:
Dls_410A_SetModel
Usage:
Dls_410A_SetMode type
Parameters:
type Cable model to set as either T1.417 or 996.1.
DLS 1200 Operating Manual
Page 4-6 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_SetModel T1.417
Description:
Sets the simulated cable model for the 410A system.
4.1.7 Dls_410A_SetNoiseSource
Command Name:
Dls_410A_SetNoiseSource
Usage:
Dls_410A_SetNoiseSource channel –noise channel toggle
Parameters:
channel Noise injection port to set. ‘A’ for side A. ‘B’ for side B.toggle Set noise injection ports to On or Off.
DLS 1200 Operating Manual
Spirent Communications - Page 4-7
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_SetNoiseSource A ON
Description:
Enable or disable the selected noise injection port on the 410A system. Noise channel A corresponds to the NA input located on the 411A front panel, selecting channel B corresponds to the NB noise input on the front panel of the DLS 412A simulator.
4.1.8 Dls_410A_SetSimulationMode
Command Name:
Dls_410A_SetSimulationMode
Usage:
Dls_410A_SetSimulationMode channel
Parameters:
channel Simulation mode to set. Your choices are:Normal (default) - Includes the unit in the circuit (with the line segment lengths set in the Length field).Bypass - Bypasses the unit(s) in the test system (short circuit between A and B). Disconnect - Disconnects the unit(s) from the test system (open circuit between A and B).
DLS 1200 Operating Manual
Page 4-8 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_SetSimulationMode Normal
Description:
Sets simulation mode on the 410A system.
4.1.9 (Custom) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop type length1 length2 length3 length4 length5 length 6
Parameters:
type Loop type to use. Your choices are: STRAIGHT_CUSTOM, CSA4_CUSTOM, BRIDGEDTAP_CUSTOM or ANSI13_CUSTOM.
length1 Valid values are in feet: for Straight or Bridged Tap loop; 0-23000, step 50, for ANSI13 loop; 0-9000, step 50, for CSA4 loop; 0-550, step 50.
length2 Valid values are in feet: for Straight loop; 0-0, for Bridged Tap loop; 0, 50-1500, step 10, for ANSI13 loop; 0-2000, step 50, for CSA4 loop; 0, 50-400, step 10.
length3 Valid values are in feet: for Straight loop; 0-0, for Bridged Tap loop; 0-0, for ANSI13 loop; 0, 50-1500, step 10, for CSA4 loop; 0-6250, step 50.
length4 Valid values are in feet: for Straight loop; 0-0, for Bridged Tap loop; 0-0, for ANSI13
DLS 1200 Operating Manual
Spirent Communications - Page 4-9
7104170669-12/04-3
loop; 0-500, step 50, for CSA4 loop; 0, 50-800, step 10.length5 Valid values are in feet: for Straight loop; 0-0, for Bridged Tap loop; 0-0, for ANSI13
loop; 0-500, step 50, for CSA4 loop; 0-800, step 50.length6 Valid values are in feet: for Straight loop; 0-0, for Bridged Tap loop; 0-0, for ANSI13
loop; 0-500, step 50, for CSA4 loop; 0-0.
Command Insert Widget:
Example:
Dls_410A_Loop BRIDGEDTAP_CUSTOM 19000 50 0 0 0 0
Description:
Sets the custom loop type and line segment lengths (including bridged taps) for the 410A system.
4.1.10 (Standard based ANSI13 Modified1) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop type length1 length2 length3 length4 length5 length 6
Parameters:
type Loop type set as ANSI13_Modified1.length1 Loop length 1 set as 1000 feet.length2 Loop length 2 set as 2000 feet.
DLS 1200 Operating Manual
Page 4-10 - Spirent Communications
7104170669-12/04-3
length3 Loop length 3 set as 1500 feet.length4 Loop length 4 set as 500 feet. length5 Loop length 5 set as 1500 feet.length6 Loop length 6 set as 500 feet.
Command Insert Widget:
Example:
Dls_410A_Loop ANSI13_Modified1 1000 2000 1500 500 1500 500
Description:
Sets the standard based ANSI13 (modified1) or compensated loop type and line segment lengths for the 410A system.
4.1.11 (Standard based ANSI13 Modified2) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop type length1 length2 length3 length4 length5 length 6
Parameters:
type Loop type set as ANSI13_Modified2.length1 Loop length 1 set as 2000 feet.length2 Loop length 2 set as 2000 feet.length3 Loop length 3 set as 1500 feet.
DLS 1200 Operating Manual
Spirent Communications - Page 4-11
7104170669-12/04-3
length4 Loop length 4 set as 500 feet. length5 Loop length 5 set as 1500 feet.length6 Loop length 6 set as 500 feet.
Command Insert Widget:
Example:
Dls_410A_Loop ANSI13_Modified2 2000 2000 1500 500 1500 500
Description:
Sets the standard based ANSI13 (modified2) or compensated loop type and line segment lengths for the 410A system.
4.1.12 (Standard based ANSI13) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop type length1 length2 length3 length4 length5 length 6
Parameters:
type Loop type set as ANSI13_Standard.length1 Loop length 1set as 9000 feet.length2 Loop length 2 set as 2000 feet.length3 Loop length 3 set as 1500 feet.length4 Loop length 4 set as 500 feet.
DLS 1200 Operating Manual
Page 4-12 - Spirent Communications
7104170669-12/04-3
length5 Loop length 5 set as 1500 feet.length6 Loop length 6 set as 500 feet.
Command Insert Widget:
Example:
Dls_410A_Loop ANSI13_Standard 9000 2000 1500 500 1500 500
Description:
Sets the standard based ANSI13 loop type and line segment lengths for the 410A system.
4.1.13 (Standard based 3.0Kft Bridged Tap) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop name length tap_length
Parameters:
name Loop name set as BRIDGEDTAP.length Loop length set as 3000 feet.tap length Bridged Tap length adjusted as desired from 50 to 500ft in 50 foot increments, 500 to 1500 in 100ft steps.
DLS 1200 Operating Manual
Spirent Communications - Page 4-13
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_Loop BRIDGEDTAP 3000 500
Description:
Sets the standard based 3.0Kft bridged tap loop (line segment and bridged tap) lengths for the 410A system.
4.1.14 (Standard based 9.0/12.0Kft Bridged Tap) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop name length tap_length
Parameters:
name Loop name set as BRIDGEDTAP.length Loop length adjusted as either 9000 feet or 12000 feet.tap length Bridged Tap length adjusted as desired from 50, 150, 250, 350, 500, 750, 1000, 1250
and 1500 feet.
DLS 1200 Operating Manual
Page 4-14 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_Loop BRIDGEDTAP 9000 50
Description:
Sets the standard based 9.0 or 12.0 Kft bridged tap loop (line segment and bridged tap) lengths for the 410A system.
4.1.15 (Standard based 15.0/17.5Kft Bridged Tap) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop name length tap_length
Parameters:
name Loop name set as BRIDGEDTAP.length Loop length adjusted as either 15000 feet or 17500 feet.tap length Bridged Tap length adjusted as desired from 50, 150, 200 to 1000 feet in 100 foot incre-
ments,1250 and 1500 feet.
DLS 1200 Operating Manual
Spirent Communications - Page 4-15
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_Loop BRIDGEDTAP 15000 50
Description:
Sets the standard based 15.0 or 17.5 Kft bridged tap loop (line segment and bridged tap) lengths for the 410A system.
4.1.16 (Standard based CSA4) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop type length1 length2 length3 length4 length5
Parameters:
type Loop type set as CSA4_Standard.length1 Loop length 1set as 550 feet.length2 Loop length 2 set as 400 feet.length3 Loop length 3 set as 6250 feet.length4 Loop length 4 set as 800 feet. length5 Loop length 5 set as 800 feet.
DLS 1200 Operating Manual
Page 4-16 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_Loop CSA4_Standard 550 400 6250 800 800
Description:
Sets the standard based CSA4 loop type and line segment lengths for the 410A system.
4.1.17 (Standard Based Straight) Dls_410A_Loop
Command Name:
Dls_410A_Loop
Usage:
Dls_410A_Loop name length
Parameters:
name Loop name set as Straight.length Loop length adjusted as desired 500 to 18000 feet in 500 foot increments.
DLS 1200 Operating Manual
Spirent Communications - Page 4-17
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_Loop STRAIGHT 500
Description:
Sets the standard based straight loop type and line segment length for the 410A system.
4.1.18 Dls_410A_GetLoopInfo
Command Name:
Dls_410A_GetLoopInfo
Usage:
Dls_410A_GetLoopInfo unit loop_command
Parameters:
unit Chassis to query as either the DLS411A or DLS412A.loop command Specify M value to retrieve as either M1, M2 or M3.
DLS 1200 Operating Manual
Page 4-18 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_GetLoopInfo DLS411A M1
Description:
Gets the M value information from the DLS 410A chassis. The M value is a 54-character hex string. Three M values must be specified (M1,M2,M3) for each wireline simulator DLS 411A and DLS 412A to specify a specific loop type.
4.1.19 Dls_410A_GetLoopStateInfo
Command Name:
Dls_410A_GetLoopStateInfo
Usage:
Dls_410A_GetLoopStateInfo unit
Parameters:
unit Chassis to query as either the DLS411A or DLS412A.
DLS 1200 Operating Manual
Spirent Communications - Page 4-19
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_GetLoopStateInfo DLS411A
Description:
Gets the simulation state information from the DLS 410A chassis, bypass,disconnect, normal.
4.1.20 Dls_410A_GetNoiseInfo
Command Name:
Dls_410A_GetNoiseInfo
Usage:
Dls_410A_GetNoiseInfo external_noise
Parameters:
external noise Port to query as either ‘A’ for side A or ‘B’ for side B.
DLS 1200 Operating Manual
Page 4-20 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410A_GetNoiseInfo A
Description:
Gets the external noise information from the DLS 410A chassis. Returns either an ‘on’ or ‘off’ state.
4.2 DLS 410E
4.2.1 Dls_410E_Connect
Command Name:
Dls_410E_Connect
Usage:
Dls_410E_Connect type first_address second_address
Parameters:
type Serial or GPIB.first_address Address of the DLS414E.second_address Address of the DLS415E.
DLS 1200 Operating Manual
Spirent Communications - Page 4-21
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_Connect GPIB 14 15Dls_410E_Connect Serial 2 3
Description:
Establishes a connection to the DLS 410E system via GPIB or serial communications.
4.2.2 Dls_410E_Disconnect
Command Name:
Dls_410E_Disconnect
Usage:
Dls_410E_ Disconnect
Parameters:
None
DLS 1200 Operating Manual
Page 4-22 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_Disconnect
Description:
Terminates a connection to the DLS 410E system via GPIB or serial communications.
4.2.3 Dls_410E_EnableExtended
Command Name:
Dls_410E_EnableExtended
Usage:
Dls_410E_EnableExtended unit type
Parameters:
unit The unit on which to enable extended reach as either DLS414E or DLS415E.type Apply extended reach with settings of On or Off.
DLS 1200 Operating Manual
Spirent Communications - Page 4-23
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_EnableExtended DLS414E ON
Description:
The maximum length of the DLS 415E is 7750 m and the maximum length of the DLS 414E is 7000 m. If you wish to extend the length of line simulation, reach extension ports are available at the back of each unit. The extended reach option may only be turned on when the DLS 410E is set to its maximum length (for each cable type) in the software or when the coarse value is set at or above a minimum level from a script. Once the Extend function is enabled, all distances larger than the maximum reach are controlled from the low fre-quency simulator (the DLS 414E remains at 7000 meters and the DLS 415E remains at 7750 meters).
4.2.4 Dls_410E_Init
Command Name:
Dls_410E_Init
Usage:
Dls_410E_Init
Parameters:
None
DLS 1200 Operating Manual
Page 4-24 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_Init
Description:
Initializes the DLS 410E units and sets unit default values as: external noise injection port set to A, B set to OFF, extended reach set to OFF on both units, loop state set to NORMAL, loop length for both 414E and 415E units set to 50
4.2.5 Dls_410E_SetLoopsFile
Command Name:
Dls_410E_SetLoopsFile
Usage:
Dls_410E_SetLoopsFile loop
Parameters:
loop The loop coefficient file name and path to use. A default length or compensation length file may be used.
DLS 1200 Operating Manual
Spirent Communications - Page 4-25
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_SetLoopsFile \ "C:\\ProgramFiles\\Spirent\\SpirentConnect\\api\\Dls\\lib\\Dls410E_Length_Coefficient.csv"
Description:
Sets a file path for a default loop coefficient file or compensation loop coefficient file on the 410E system.
4.2.6 Dls_410E_SetNoiseSource
Command Name:
Dls_410E_SetNoiseSource
Usage:
Dls_410E_SetNoiseSource channel toggle
Parameters:
channel Noise injection port to set. ‘A’ for side A. ‘B’ for side B.toggle Set noise injection ports to On or Off.
DLS 1200 Operating Manual
Page 4-26 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_SetNoiseSource A ON
Description:
Enables or disables the selected noise injection port on the 410E system. Noise channel A corresponds to NA input on the DLS 414E. Noise channel B corresponds to the NB input on the DLS 415E chassis.
4.2.7 Dls_410E_SetSimulationMode
Command Name:
Dls_410E_SetSimulationMode
Usage:
Dls_410E_SetSimulationMode channel
Parameters:
channel Simulation mode to set. Your choices are:Normal (default) - Includes the unit in the circuit (with the line segment lengths set in the Length field).Bypass - Bypasses the unit(s) in the test system (short circuit between A and B). Disconnect - Disconnects the unit(s) from the test system (open circuit between A and B).
DLS 1200 Operating Manual
Spirent Communications - Page 4-27
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_SetSimulationMode Normal
Description:
Sets simulation mode on the 410E system.
4.2.8 Dls_410E_Loop
Command Name:
Dls_410E_Loop
Usage:
Dls_410E_Loop type length1 length2
Parameters:
type Loop type to set as 0.4 mm or 0.5 mm or a combination of both.length1 Loop length 1of 0.4 mm segment adjusted as desired in meters (0-7000, step 25).
Should be 0 if loop type is set to 0.5 mm. Default is 50 meters (type 0.4 mm or both) or 0 meters (type 0.5 mm).
length2 Loop length 2 of 0.5 mm segment adjusted as desired in meters (0-7750, step 25). Should be 0 if loop type is set to 0.4 mm. Default is 50 meters (type 0.5 mm or both) or 0 meters (type 0.4 mm).
NOTE: for .4 and .5mm loops the combined compensated length of length 1 and length 2 cannot exceed 8000 meters increments are 500meter settings.
DLS 1200 Operating Manual
Page 4-28 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_Loop 0.4mm 50 0
Description:
Sets the loop type and line segment lengths for the 410E system.
4.2.9 Dls_410E_GetExtendReachInfo
Command Name:
Dls_410E_GetExtendReachInfo
Usage:
Dls_410E_GetExtendReachInfo unit
Parameters:
unit Chassis to query as either the DLS414E or DLS415E.
DLS 1200 Operating Manual
Spirent Communications - Page 4-29
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_GetExtendReachInfo DLS414E
Description:
Gets the extended reach information from the DLS 410E chassis, ON or OFF.
4.2.10 Dls_410E_GetFineCoarseInfo
Command Name:
Dls_410E_GetFineCoarseInfo
Usage:
Dls_410E_GetFineCoarseInfo unit
Parameters:
unit Chassis to query as either the DLS 414E or DLS 415E. The fine coarse settings vary automatically with line length settings.
DLS 1200 Operating Manual
Page 4-30 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_GetFineCoarseInfo DLS414E
Description:
Gets the current fine-coarse coefficient information from the selected DLS 414E or DLS 415E chassis.
4.2.11 Dls_410E_GetLoopStateInfo
Command Name:
Dls_410E_GetLoopStateInfo
Usage:
Dls_410E_GetLoopStateInfo unit
Parameters:
unit Chassis to query as either the DLS 414E or DLS 415E.
DLS 1200 Operating Manual
Spirent Communications - Page 4-31
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_GetLoopStateInfo DLS414E
Description:
Gets the loop state information from the DLS 410E chassis. Returns either a ‘Bypass’, ‘Normal’ or ‘Discon-nect’ state.
4.2.12 Dls_410E_GetNoiseInfo
Command Name:
Dls_410E_GetNoiseInfo
Usage:
Dls_410E_GetNoiseInfo external_noise
Parameters:
external noise Port to query as either ‘A’ for side A or ‘B’ for side B.
DLS 1200 Operating Manual
Page 4-32 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_410E_GetNoiseInfo A
Description:
Gets the external noise information from the DLS 410E chassis. Returns either an ‘on’ or ‘off’ state.
DLS 1200 Operating Manual
Spirent Communications - Page -33
7104170669-12/04-3
4.3 DLS 414A
4.3.1 Dls_414A_Connect
Command Name:
Dls_414A_Connect
Usage:
Dls_414A_Connect type com_address
Parameters:
type Serial or GPIB.com_address Address of the DLS414A.
Command Insert Widget:
Example:
Dls_414A_Connect GPIB 14 Dls_414A_Connect Serial 2
Description:
Establishes a connection to the DLS 414A system via GPIB or serial communications.
DLS 1200 Operating Manual
Page -34 - Spirent Communications
7104170669-12/04-3
4.3.2 Dls_414A_Disconnect
Command Name:
Dls_414A_Disconnect
Usage:
Dls_414A_ Disconnect
Parameters:
None
Command Insert Widget:
Example:
Dls_414A_Disconnect
Description:
Terminates a connection to the DLS 414A system via GPIB or serial communications.
4.3.3 Dls_414A_EnableExtended
Command Name:
Dls_414A_EnableExtended
DLS 1200 Operating Manual
Spirent Communications - Page -35
7104170669-12/04-3
Usage:
Dls_414A_EnableExtended type
Parameters:
type Enable or disable the extended reach port with settings of On or Off.
Command Insert Widget:
Example:
Dls_414A_EnableExtended ON
Description:
The maximum length of the DLS 414A is 21000 feet. If you wish to extend the length of line simulation, a reach extension port is available at the back of each unit. An additional low-frequency simulator such as the DLS 90 may be connected to this port to extend the system reach capabilities. The extended reach option may only be turned on when the DLS 414A is set to its maximum length (for each cable type) in the software or when the coarse value is set at or above a minimum level from a script. Once the Extend function is ena-bled, all distances larger than the maximum reach are controlled from the low frequency simulator. Note that at long loop lengths the DSL modems will not use the higher frequencies.
4.3.4 Dls_414A_Init
Command Name:
Dls_414A_Init
DLS 1200 Operating Manual
Page -36 - Spirent Communications
7104170669-12/04-3
Usage:
Dls_414A_Init
Parameters:
None
Command Insert Widget:
Example:
Dls_414A_Init
Description:
Initializes the DLS 414A units and sets unit default values. Default values are: length set to 100 feet, loop state set to NORMAL, noise injection ports A and B set to OFF, and extended reach set to OFF.
4.3.5 Dls_414A_SetLoopsFile
Command Name:
Dls_414A_SetLoopsFile
Usage:
Dls_414A_SetLoopsFile loop
Parameters:
loop The loop coefficient file name and path to use. A default length or compensation length file may be used.
DLS 1200 Operating Manual
Spirent Communications - Page -37
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_SetLoopsFile \ "C:\\ProgramFiles\\Spirent\\SpirentConnect\\api\\dls\\lib\\Dls414A_Length_Coefficient.csv"
Description:
Sets a file path for a default loop coefficient file or compensation loop coefficient file on the 414A system.
4.3.6 Dls_414A_SetNoiseSource
Command Name:
Dls_414A_SetNoiseSource
Usage:
Dls_414A_SetNoiseSource channel status
Parameters:
channel Noise injection port to set. ‘A’ for side A. ‘B’ for side B.status Set noise injection ports to On or Off.
DLS 1200 Operating Manual
Page -38 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_SetNoiseSource A ON
Description:
Enables or disables the selected noise injection port on the 414A system.
4.3.7 Dls_414A_SetSimulationMode
Command Name:
Dls_414A_SetSimulationMode
Usage:
Dls_414A_SetSimulationMode channel
Parameters:
channel Simulation mode to set. Your choices are:Normal (default) - Includes the unit in the circuit (with the line segment lengths set in the Length field).Bypass - Bypasses the unit(s) in the test system (short circuit between A and B). Disconnect - Disconnects the unit(s) from the test system (open circuit between A and B).
DLS 1200 Operating Manual
Spirent Communications - Page -39
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_SetSimulationMode Normal
Description:
Sets simulation mode on the 414A system.
4.3.8 Dls_414A_Loop
Command Name:
Dls_414A_Loop
Usage:
Dls_414A_Loop length
Parameters:
length Loop length adjusted as desired in feet (range from 100 - 21000, step 50).
DLS 1200 Operating Manual
Page -40 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_Loop 100
Description:
Sets the loop line segment length for the 414A system.
4.3.9 Dls_414A_GetExtendReachInfo
Command Name:
Dls_414A_GetExtendReachInfo
Usage:
Dls_414A_GetExtendReachInfo
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -41
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_GetExtendReachInfo
Description:
Gets the extended reach information from the DLS 414A chassis. The return value is either ‘on’ or ‘off’.
4.3.10 Dls_414A_GetFineCoarseInfo
Command Name:
Dls_414A_GetFineCoarseInfo
Usage:
Dls_414A_GetFineCoarseInfo
Parameters:
None
DLS 1200 Operating Manual
Page -42 - Spirent Communications
7104170669-12/04-3
Command Insert Widget
Example:
Dls_414A_GetFineCoarseInfo
Description:
Gets the compensated loop fine-coarse coefficient information from the DLS 414A chassis. The return parameters are fine-value, coarse-value where fine-value, coarse-value are integers.
4.3.11 Dls_414A_GetLoopStateInfo
Command Name:
Dls_414A_GetLoopStateInfo
Usage:
Dls_414A_GetLoopStateInfo
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -43
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_GetLoopStateInfo
Description:
Gets the simulation state information from the DLS 414A chassis. Returns a ‘Bypass’, ‘Normal’ or ‘Discon-nect’ state.
4.3.12 Dls_414A_GetNoiseInfo
Command Name:
Dlas_414A_GetNoiseInfo
Usage:
Dls_414A_GetNoiseInfo external_noise
Parameters:
external noise Port to query as either ‘A’ for side A or ‘B’ for side B.
DLS 1200 Operating Manual
Page -44 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414A_GetNoiseInfo A
Description:
Gets the external noise information from the DLS 414A chassis. Returns either an ‘on’ or ‘off’ state.
4.4 DLS 414E
4.4.1 Dls_414E_Connect
Command Name:
Dls_414E_Connect
Usage:
Dls_414E_Connect type com_address
Parameters:
type Serial or GPIB.com_address Address of the DLS414E.
DLS 1200 Operating Manual
Spirent Communications - Page -45
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_Connect GPIB 14Dls_414E_Connect Serial 2
Description:
Establishes a connection to the DLS 414E system via GPIB or serial communications.
4.4.2 Dls_414E_Disconnect
Command Name:
Dls_414E_Disconnect
Usage:
Dls_414E_ Disconnect
Parameters:
None
DLS 1200 Operating Manual
Page -46 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_Disconnect
Description:
Terminates a connection to the DLS 414E system via GPIB or serial communications.
4.4.3 Dls_414E_EnableExtended
Command Name:
Dls_414E_EnableExtended
Usage:
Dls_414E_EnableExtended type
Parameters:
type Enable or disable extended reach port with settings of On or Off.
DLS 1200 Operating Manual
Spirent Communications - Page -47
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_EnableExtended ON
Description:
The maximum length of the DLS 414E is 7000 meters. If you wish to extend the length of line simulation, a reach extension port is available at the back of each unit. An additional low-frequency simulator such as the DLS 90 may be connected to this port to extend the system reach capabilities. The extended reach option may only be turned on when the DLS 414E is set to its maximum length (for each cable type) in the software or when the coarse value is set at or above a minimum level from a script. Once the Extend function is ena-bled, all distances larger than the maximum reach are controlled from the low frequency simulator. Note that at long loop lengths the DSL modems will not use the higher frequencies.
4.4.4 Dls_414E_Init
Command Name:
Dls_414E_Init
Usage:
Dls_414E_Init
Parameters:
None
DLS 1200 Operating Manual
Page -48 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_Init
Description:
Initializes the DLS 414E units and sets unit default values. The default values are: length set to 50 meters, side A and B noise injection ports set to OFF, and loop state is set to NORMAL.
4.4.5 Dls_414E_SetLoopsFile
Command Name:
Dls_414E_SetLoopsFile
Usage:
Dls_414E_SetLoopsFile loop
Parameters:
loop The loop coefficient file name and path to use. A default length or compensation length file may be used.
DLS 1200 Operating Manual
Spirent Communications - Page -49
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_SetLoopsFile \ "C:\\ProgramFiles\\Spirent\\SpirentConnect\\api\\dls\\lib\\Dls414E_Length_Coefficient.csv"
Description:
Sets a file path for a default loop coefficient file or compensation loop coefficient file on the 414E system.
4.4.6 Dls_414E_SetNoiseSource
Command Name:
Dls_414E_SetNoiseSource
Usage:
Dls_414E_SetNoiseSource channel toggle
Parameters:
channel Noise injection port to set. ‘A’ for side A. ‘B’ for side B.toggle Set noise injection ports to On or Off.
DLS 1200 Operating Manual
Page -50 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_SetNoiseSource A ON
Description:
Enables or disables the selected noise injection port on the 414E system.
4.4.7 Dls_414E_SetSimulationMode
Command Name:
Dls_414E_SetSimulationMode
Usage:
Dls_414E_SetSimulationMode channel
Parameters:
channel Simulation mode to set. Your choices are:Normal (default) - Includes the unit in the circuit (with the line segment lengths set in the Length field).Bypass - Bypasses the unit(s) in the test system (short circuit between A and B). Disconnect - Disconnects the unit(s) from the test system (open circuit between A and B).
DLS 1200 Operating Manual
Spirent Communications - Page -51
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_SetSimulationMode Normal
Description:
Sets simulation mode on the 414E system.
4.4.8 Dls_414E_Loop
Command Name:
Dls_414E_Loop
Usage:
Dls_414E_Loop length
Parameters:
length Loop length adjusted as desired in meters (range from 50-7000, step 25).
DLS 1200 Operating Manual
Page -52 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_Loop 50
Description:
Sets the loop line segment length for the 414E system.
4.4.9 Dls_414E_GetExtendReachInfo
Command Name:
Dls_GetExtendReachInfo
Usage:
Dls_414E_GetExtendReachInfo
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -53
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_GetExtendReachInfo
Description:
Gets the extended reach information from the DLS 414E chassis. The return value is either ‘on’ or ‘off’.
4.4.10 Dls_414E_GetFineCoarseInfo
Command Name:
Dls_414EGetFineCoarseInfo
Usage:
Dls_414E_GetFineCoarseInfo
Parameters:
None
DLS 1200 Operating Manual
Page -54 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_GetFineCoarseInfo
Description:
Gets the compensated loop fine-coarse coefficient information from the DLS 414E chassis. The return parameters are fine-value, coarse-value where fine-value, coarse-value are integers.
4.4.11 Dls_414E_GetLoopStateInfo
Command Name:
Dls_GetLoopStateInfo
Usage:
Dls_414E_GetLoopStateInfo
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -55
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_GetLoopStateInfo
Description:
Gets the simulation state information from the DLS 414E chassis. Returns a ‘Bypass’, ‘Normal’ or ‘Discon-nect’ state.
4.4.12 Dls_414E_GetNoiseInfo
Command Name:
Dls_414E_GetNoiseInfo
Usage:
Dls_414E_GetNoiseInfo external_noise
Parameters:
external noise Port to query as either ‘A’ for side A or ‘B’ for side B.
DLS 1200 Operating Manual
Page -56 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_414E_GetNoiseInfo A
Description:
Gets the external noise information from the DLS 414E chassis. Returns either an ‘on’ or ‘off’ state.
4.5 DLS 415E
4.5.1 Dls_415E_Connect
Command Name:
Dls_415E_Connect
Usage:
Dls_415E_Connect type com_address
Parameters:
type Serial or GPIB.com_address Address of the DLS415E.
DLS 1200 Operating Manual
Spirent Communications - Page -57
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_Connect GPIB 14Dls_415E_Connect Serial 2
Description:
Establishes a connection to the DLS 415E system via GPIB or serial communications.
4.5.2 Dls_415E_Disconnect
Command Name:
Dls_415E_Disconnect
Usage:
Dls_415E_ Disconnect
Parameters:
None
DLS 1200 Operating Manual
Page -58 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_Disconnect
Description:
Terminates a connection to the DLS 415E system via GPIB or serial communications.
4.5.3 Dls_415E_EnableExtended
Command Name:
Dls_415E_EnableExtended
Usage:
Dls_415E_EnableExtended type
Parameters:
type Apply extended reach with settings of On or Off.
DLS 1200 Operating Manual
Spirent Communications - Page -59
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_EnableExtended ON
Description:
The maximum length of the DLS 415E is 7750 meters.If you wish to extend the length of line simulation, a reach extension port is available at the back of each unit. An additional low-frequency simulator such as the DLS 90 may be connected to this port to extend the system reach capabilities. The extended reach option may only be turned on when the DLS 415E is set to its maximum length in the software or when the coarse value is set at or above a minimum level from a script. Once the Extend function is enabled, all distances larger than the maximum reach are controlled from the low frequency simulator. Note that at long loop lengths the DSL modems will not use the higher frequencies.
4.5.4 Dls_415E_Init
Command Name:
Dls_415E_Init
Usage:
Dls_415E_Init
Parameters:
None
DLS 1200 Operating Manual
Page -60 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_Init
Description:
Initializes the DLS 415E units and sets unit default values. The default values are: length set to 50 meters, side A and B noise injection ports set to OFF, and loop state is set to NORMAL.
4.5.5 Dls_415E_SetLoopsFile
Command Name:
Dls_415E_SetLoopsFile
Usage:
Dls_415E_SetLoopsFile loop
Parameters:
loop The loop coefficient file name and path to use. A default length or compensation length file may be used
DLS 1200 Operating Manual
Spirent Communications - Page -61
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_SetLoopsFile \ "C:\\ProgramFiles\\Spirent\\SpirentConnect\\api\\dls\\lib\\Dls415E_Length_Coefficient.csv"
Description:
Sets a file path for a default loop coefficient file or compensation loop coefficient file on the 415E system.
4.5.6 Dls_415E_SetNoiseSource
Command Name:
Dls_415E_SetNoiseSource
Usage:
Dls_415E_SetNoiseSource channel –noise channel toggle
Parameters:
channel Noise injection port to set. ‘A’ for side A. ‘B’ for side B.toggle Set noise injection ports to On or Off.
DLS 1200 Operating Manual
Page -62 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_SetNoiseSource A ON
Description:
Enables or disables the selected noise injection port on the 415E system.
4.5.7 Dls_415E_SetSimulationMode
Command Name:
Dls_415E_SetSimulationMode
Usage:
Dls_415E_SetSimulationMode channel
Parameters:
channel Simulation mode to set. Your choices are:Normal (default) - Includes the unit in the circuit (with the line segment lengths set in the Length field).Bypass - Bypasses the unit(s) in the test system (short circuit between A and B). Disconnect - Disconnects the unit(s) from the test system (open circuit between A and B).
DLS 1200 Operating Manual
Spirent Communications - Page -63
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_SetSimulationMode Normal
Description:
Sets simulation mode on the 415E system. Normal/Bypass/Disconnect
4.5.8 Dls_415E_Loop
Command Name:
Dls_415E_Loop
Usage:
Dls_415E_Loop length
Parameters:
length Loop length adjusted as desired in meters (range from 50 - 7750, step 25).
DLS 1200 Operating Manual
Page -64 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_Loop 50
Description:
Sets the loop line segment length for the 415E system.
4.5.9 Dls_415E_GetExtendReachInfo
Command Name:
Dls_415E_GetExtendReachInfo
Usage:
Dls_415E_GetExtendReachInfo
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -65
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_GetExtendReachInfo
Description:
Gets the extended reach information from the DLS 415E chassis. The return value is either ‘on’ or ‘off’.
4.5.10 Dls_415E_GetFineCoarseInfo
Command Name:
Dls_415E_GetFineCoarseInfo
Usage:
Dls_415E_GetFineCoarseInfo
Parameters:
None
DLS 1200 Operating Manual
Page -66 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_GetFineCoarseInfo
Description:
Gets the compensated loop fine-coarse coefficient information from the DLS 415E chassis. The return parameters are fine-value, coarse-value where fine-value, coarse-value are integers.
4.5.11 Dls_415E_GetLoopStateInfo
Command Name:
Dls_415E_GetLoopStateInfo
Usage:
Dls_415E_GetLoopStateInfo
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -67
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_GetLoopStateInfo
Description:
Gets the simulation state information from the DLS 415E chassis. Returns a ‘Bypass’, ‘Normal’ or ‘Discon-nect’ state.
4.5.12 Dls_415E_GetNoiseInfo
Command Name:
Dls_415E_GetNoiseInfo
Usage:
Dls_415E_GetNoiseInfo external_noise
Parameters:
external noise Port to query as either ‘A’ for side A or ‘B’ for side B.
DLS 1200 Operating Manual
Page -68 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_415E_GetNoiseInfo A
Description:
Gets the external noise information from the DLS 415E chassis. Returns either an ‘on’ or ‘off’ state.
DLS 1200 Operating Manual
Spirent Communications - Page 5-1
7104170669-12/04-3
5. DLS 5xxx TCL COMMANDS
5.1 DLS 5A00
5.1.1 Dls_5A00_Connect
Command Name:
Dls_5A00_Connect
Usages:
Dls_5A00_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial
(RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_5A00_Connect Serial 1Dls_5A00_Connect GPIB 1
DLS 1200 Operating Manual
Page 5-2 - Spirent Communications
7104170669-12/04-3
Descriptions:
Establish communication with DLS 5A00 card through a DLS chassis using RS-232/GPIB.
5.1.2 Dls_5A00_CrossTalkA
Command Name:
Dls_5A00_CrossTalkA
Usages:
Dls_5A00_CrossTalkA side xtalk level
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
xtalk This flag allows you to choose the Crosstalk noise type:OFFT1.601DSLNEXTHDSLHDSL+ADSLRange level for above noise type: : -75.0 to –30.0 dBm in 0.1 dB steps.In addition, DLS 5A00 will accept a downloadable noise file such as “C:/Pro-gram Files/Spirent Communications/DLS 1100/Impairments Files/Lo1 and Lo2 Files/HDSL2 Dn NEXT(H2TUC).Lo1".Range level for a downloadable noise can be found in the noise file.
level This flag allows you to set the level of the noise in dBm.
DLS 1200 Operating Manual
Spirent Communications - Page 5-3
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A00_CrossTalkA A " T1.601 " -75.0Dls_5A00_CrossTalkA A " C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/Lo1 and Lo2 Files/HDSL2 Dn NEXT(H2TUC).Lo1 " -75.0
Descriptions:
Set Crosstalk Generator A to inject a noise on side A or side B.
5.1.3 Dls_5A00_CrossTalkB
Command Name:
Dls_5A00_CrossTalkB
Usages:
Dls_5A00_CrossTalkB side xtalk level
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
xtalk This flag allows you to choose the Crosstalk noise type:OFFT1.601DSLNEXT
DLS 1200 Operating Manual
Page 5-4 - Spirent Communications
7104170669-12/04-3
HDSLHDSL+ADSLADSLNEXTRange level for above noise type: : -75.0 to –30.0 dBm in 0.1 dB steps.In addition, DLS 5A00 will accept a downloadable noise file such as “C:/Pro-gram Files/Spirent Communications/DLS 1100/Impairments Files/Lo1 and Lo2 Files/HDSL2 FDM ADSL Dn NEXT(LF).Lo2".Range level for a downloadable noise can be found in the noise file.
level This flag allows you to set the level of the noise in dBm.
Command Insert Widget:
Examples:
Dls_5A00_CrossTalkB A " HDSL+ADSL " -75.0Dls_5A00_CrossTalkB A " C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/Lo1 and Lo2 Files/HDSL2 FDM ADSL Dn NEXT(LF).Lo2" -75.0
Descriptions:
Set Crosstalk Generator B to inject a noise on side A or side B.
5.1.4 Dls_5A00_CrossTalkC
Command Name:
Dls_5A00_CrossTalkC
DLS 1200 Operating Manual
Spirent Communications - Page 5-5
7104170669-12/04-3
Usages:
Dls_5A00_CrossTalkC side xtalk level
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
xtalk This flag allows you to choose the Crosstalk noise type:OFFADSLFEXTADSLAADSLBT1AMIRange level for above noise type: -85.0 to –35.0 dBm in 0.1 dB steps.In addition, DLS 5A00 will accept a downloadable noise file such as “C:/Pro-gram Files/Spirent Communications/DLS 1100/Impairments Files/Hi Files/HDSL2 FDM ADSL Dn NEXT(HF).Hi".Range level for a downloadable noise can be found in the noise file.
level This flag allows you to set the level of the noise in dBm.
Command Insert Widget:
DLS 1200 Operating Manual
Page 5-6 - Spirent Communications
7104170669-12/04-3
Examples:
Dls_5A00_CrossTalkC A " ADSLFEXT " -85.0 Dls_5A00_CrossTalkC A " C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/Hi Files/HDSL2 FDM ADSL Dn NEXT(HF).Hi " -67.0
Descriptions:
Set Crosstalk Generator C to inject a noise on side A or side B.
5.1.5 Dls_5A00_Impulses
Command Name:
Dls_5A00_Impulses
Usages:
Dls_5A00_Impulses side type level rate width
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the impulses will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
type This flag allows you to choose the type of impulse to be injected:OFF3-levelbipolarunipolar+unipolar-Cookadsl-c1adsl-c2.
level This flag allows you to set the level of the impulses. Range from 0.0 to 100.0 mV peak in 0.1 mV steps except for Cook impulses. Range from –20.0 to 6.0 dB in 0.1 dB steps for Cook impulses
rate This flag allows you to set the rate at which the impulses will be generated and it will be measured in pulses per seconds. Range is from 0 to 100 pps in steps of 1 pps.
width This flag allows you to set the width of the impulses. Range from 20 to 120 ìs. The width only applies to 3-level, Bipolar, Unipolar+ and Unipolar- impulses. For Cook, ADSL-C1 and ADSL-C this flag must be ignored.
DLS 1200 Operating Manual
Spirent Communications - Page 5-7
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A00_Impulses A 3-LEVEL 10.0 10 20
Descriptions:
Generate impulses on side A or B, at the desired level, rate and width.
5.1.6 Dls_5A00_Longitudinal
Command Name:
Dls_5A00_Longitudinal
Usages:
Dls_5A00_Longitudinal side state freq voltsRMS
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Longitudinal Noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
state This flag allows you to turn the Longitudinal Noise Generator ON or OFF.
freq This flag allows you to set the fundamental frequency, which is the frequency of the powerline, i.e. 50Hz or 60Hz.
DLS 1200 Operating Manual
Page 5-8 - Spirent Communications
7104170669-12/04-3
level This flag allows you to set the level of the noise. For side A or B, 0 to 60 Vrms at 60 Hz; 0 to 50 Vrms at 50 Hz. For side BOTH, 0 to 30 Vrms at 60 Hz; 0 to 25 Vrms at 50 Hz.
Command Insert Widget:
Examples:
Dls_5A00_Longitudinal A ON 50 50
Descriptions:
Turn on and generate Longitudinal Noise on side A or B, at the desired frequency and level.
5.1.7 Dls_5A00_Metallic
Command Name:
Dls_5A00_Metallic
Usages:
Dls_5A00_Metallic side powerfreq harmonic_1 harmonic_2 offset
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Metallic Noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
powerfreq This flag allows you to set the fundamental frequency, which is the fre-
DLS 1200 Operating Manual
Spirent Communications - Page 5-9
7104170669-12/04-3
quency of the powerline, i.e. 50Hz or 60Hz.
harmonic_1 This flag allows you to choose the harmonic of the fundamental fre-quency. Range: 1st, 3rd, 5th, 7th, 9th, 11th which are the times of the powerline frequency.
harmonic_2 This flag allows you to choose the harmonic of the fundamental fre-quency. Range: 1st, 3rd, 5th, 7th, 9th, 11th which are the times of the powerline frequency.
offset This flag allows you to set the offset level of the Metallic Noise, i.e. –5.0 dB.
Command Insert Widget:
Examples:
Dls_5A00_Metallic A 60 3rd 5th -10.0
Descriptions:
Generate Metallic Noise on side A or B, at the desired harmonic and offset level.
5.1.8 Dls_5A00_Mode
Command Name:
Dls_5A00_Mode
Usages:
Dls_5A00_Mode mode
DLS 1200 Operating Manual
Page 5-10 - Spirent Communications
7104170669-12/04-3
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Metallic Noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
mode This flag allows you to set the DLS 5A00 card in DLS 200 mode or DLS 400 mode.
Command Insert Widget:
Examples:
Dls_5A00_Mode A D2
Descriptions:
Set the DLS 5A00 card on side A or B in DLS 200 mode or DLS 400 mode.
5.1.9 Dls_5A00_Output
Command Name:
Dls_5A00_Output
Usages:
Dls_5A00_Output side output
Parameters:
side This flag allows you to choose the side, i.e. A or B, where all impairments will be
DLS 1200 Operating Manual
Spirent Communications - Page 5-11
7104170669-12/04-3
turned off. output This flag allows you to Connect (ON) or disconnect (OFF) the impairments gen-
erator to or from the line.
Command Insert Widget:
Examples:
Dls_5A00_Output A ON
Descriptions:
Connect (ON) or disconnect (OFF) the impairments generator to or from the line.
5.1.10 Dls_5A00_Quiet
Command Name:
Dls_5A00_Quiet
Usages:
Dls_Quiet side
Parameters:
side This flag allows you to choose the side, i.e. A or B, where all impairments will be turned off.
DLS 1200 Operating Manual
Page 5-12 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A00_Quiet A
Descriptions:
This command turns all impairments OFF but leaves the output stage ON.
5.1.11 Dls_5A00_ShapedNoise
Command Name:
Dls_5A00_ShapedNoise
Usages:
Dls_5A00_ShapedNoise side type level unit
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Shaped Noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
type This flag allows you to choose the shaped noise type:OFFBASIC_RATEHDSLFTZ
DLS 1200 Operating Manual
Spirent Communications - Page 5-13
7104170669-12/04-3
The 10-tone noise is selected when selecting ADSL noise type in Crosstalk C.
level This flag allows you to set the level of the noise. Range from 3.2 to 100.0 uV/SQRT(HZ) in 0.1 steps of uV/SQRT(HZ); or from –103.3 to –71.3 dBm/Hz in steps of dB/Hz.
unit This flag allows you to set the unit used for measuring the level of the noise , i.e. dBm/Hz or uV/SQRT(HZ) .
Command Insert Widget:
Examples:
Dls_5A00_ShapedNoise A BASIC_RATE -101.3 dBm/HzDls_5A00_ShapedNoise A FTZ 23.5 UV/SQRT(HZ)
Descriptions:
Set Shaped Noise Generator to inject a noise on side A or B, at the desired level, measured in dBm/Hz or uV/SQRT(HZ).
5.1.12 Dls_5A00_WhiteNoise
Command Name:
Dls_5A00_WhiteNoise
Usages:
Dls_5A00_WhiteNoise side state level
DLS 1200 Operating Manual
Page 5-14 - Spirent Communications
7104170669-12/04-3
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the White Noise will be injected. This works only when the DLS 5A00 (NIM) is physically installed in slot A or/and slot B of a chassis.
state This flag allows you to turn the White Noise Generator ON or OFF.
level This flag allows you to set the level of the noise. Range from -140.0 to -90.0 dBm/Hz in steps of 0.1 dB.
Command Insert Widget:
Examples:
Dls_5A00_WhiteNoise A ON -140.0
Descriptions:
Turn on and generate White Noise on side A or B, at the desired level.
5.1.13 Dls_5A00_Disconnect
Command Name:
Dls_5A00_Disconnect
Usages:
Dls_5A00_Disconnect serial_gpib
DLS 1200 Operating Manual
Spirent Communications - Page 5-15
7104170669-12/04-3
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting the device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_5A00_Disconnect SerialDls_5A00_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
5.2 DLS 5A01
5.2.1 Dls_5A01_Connect
Command Name:
Dls_5A01_Connect
Usages:
Dls_5A01_Connect serial_gpib com_addr
DLS 1200 Operating Manual
Page 5-16 - Spirent Communications
7104170669-12/04-3
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB.
com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial (RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_5A01_Connect Serial 1Dls_5A01_Connect GPIB 1
Descriptions:
Establish communication with DLS 5A01 card through a DLS chassis using RS-232/GPIB.
5.2.2 Dls_5A01_CrossTalkA
Command Name:
Dls_5A01_CrossTalkA
Usages:
Dls_5A01_CrossTalkA side xtalk level
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/
DLS 1200 Operating Manual
Spirent Communications - Page 5-17
7104170669-12/04-3
and slot B of a chassis. xtalk This flag allows you to choose the Crosstalk noise type. Range depends on what
noises are loaded into the card. User can use DLS Loader to detect the noise types inside the card.
level This flag allows you to set the level of the noise in dBm. Level range depends on what noises are loaded into the card. User can use DLS Loader to detect the min-imum and maximum level.
Command Insert Widget:
Examples:
Dls_5A01_CrossTalkA A " T1.601 " -75.0
Descriptions:
Set Crosstalk Generator A to inject a noise on side A or side B.
5.2.3 Dls_5A01_CrossTalkB
Command Name:
Dls_5A01_CrossTalkB
Usages:
Dls_5A01_CrossTalkB side xtalk level
DLS 1200 Operating Manual
Page 5-18 - Spirent Communications
7104170669-12/04-3
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
xtalk This flag allows you to choose the Crosstalk noise type. Range depends on what noises are loaded into the card. User can use DLS Loader to detect the noise types inside the card.
level This flag allows you to set the level of the noise in dBm. Level range depends on what noises are loaded into the card. User can use DLS Loader to detect the min-imum and maximum level.
Command Insert Widget:
Examples:
Dls_5A01_CrossTalkB A " HDSL+ADSL " -75.0
Descriptions:
Set Crosstalk Generator B to inject a noise on side A or side B.
5.2.4 Dls_5A01_CrossTalkC
Command Name:
Dls_5A01_CrossTalkC
DLS 1200 Operating Manual
Spirent Communications - Page 5-19
7104170669-12/04-3
Usages:
Dls_5A01_CrossTalkC side xtalk level
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
xtalk This flag allows you to choose the Crosstalk noise type. Range depends on what noises are loaded into the card. User can use DLS Loader to detect the noise types inside the card.
level This flag allows you to set the level of the noise in dBm. Level range depends on what noises are loaded into the card. User can use DLS Loader to detect the min-imum and maximum level.
Command Insert Widget:
Examples:
Dls_5A01_CrossTalkC A " ADSLFEXT " -85.0
Descriptions:
Set Crosstalk Generator C to inject a noise on side A or side B.
DLS 1200 Operating Manual
Page 5-20 - Spirent Communications
7104170669-12/04-3
5.2.5 Dls_5A01_Impulses
Command Name:
Dls_5A01_Impulses
Usages:
Dls_5A01_Impulses side type level rate width
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the impulses will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
type This flag allows you to choose the type of impulse to be injected:OFF3-levelbipolarunipolar+unipolar-Cookadsl-c1adsl-c2.
level This flag allows you to set the level of the impulses. Range from 0.0 to 100.0 mV peak in 0.1 mV steps except for Cook impulses. Range from –20.0 to 6.0 dB in 0.1 dB steps for Cook impulses
rate This flag allows you to set the rate at which the impulses will be generated and it will be measured in pulses per seconds. Range is from 0 to 100 pps in steps of 1 pps.
width This flag allows you to set the width of the impulses. Range from 20 to 120 ìs. The width only applies to 3-level, Bipolar, Unipolar+ and Unipolar- impulses. For Cook, ADSL-C1 and ADSL-C this flag must be ignored.
DLS 1200 Operating Manual
Spirent Communications - Page 5-21
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A01_Impulses A 3-LEVEL 10.0 10 20
Descriptions:
Generate impulses on side A or B, at the desired level, rate and width.
5.2.6 Dls_5A01_Longitudinal
Command Name:
Dls_5A01_Longitudinal
Usages:
Dls_5A01_Longitudinal side state freq voltsRMS
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Longitudinal Noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
state This flag allows you to turn the Longitudinal Noise Generator ON or OFF.
freq This flag allows you to set the fundamental frequency, which is the frequency of the powerline, i.e. 50Hz or 60Hz.
DLS 1200 Operating Manual
Page 5-22 - Spirent Communications
7104170669-12/04-3
level This flag allows you to set the level of the noise. For side A or B, 0 to 60 Vrms at 60 Hz; 0 to 50 Vrms at 50 Hz. For side BOTH, 0 to 30 Vrms at 60 Hz; 0 to 25 Vrms at 50 Hz.
Command Insert Widget:
Examples:
Dls_5A01_Longitudinal A ON 50 50
Descriptions:
Turn on and generate Longitudinal Noise on side A or B, at the desired frequency and level.
5.2.7 Dls_5A01_Metallic
Command Name:
Dls_5A01_Metallic
Usages:
Dls_5A01_Metallic side powerfreq harmonic_1 harmonic_2 offset
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Metallic Noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
powerfreq This flag allows you to set the fundamental frequency, which is the frequency of
DLS 1200 Operating Manual
Spirent Communications - Page 5-23
7104170669-12/04-3
the powerline, i.e. 50Hz or 60Hz.
harmonic_1 This flag allows you to choose the harmonic of the fundamental frequency. Range: 1st, 3rd, 5th, 7th, 9th, 11th which are the times of the powerline fre-quency.
harmonic_2 This flag allows you to choose the harmonic of the fundamental frequency. Range: 1st, 3rd, 5th, 7th, 9th, 11th which are the times of the powerline fre-quency.
offset This flag allows you to set the offset level of the Metallic Noise, i.e. –5.0 dB.
Command Insert Widget:
Examples:
Dls_5A01_Metallic A 60 3rd 5th -10.0
Descriptions:
Generate Metallic Noise on side A or B, at the desired harmonic and offset level.
DLS 1200 Operating Manual
Page 5-24 - Spirent Communications
7104170669-12/04-3
5.2.8 Dls_5A01_Output
Command Name:
Dls_5A01_Output
Usages:
Dls_5A01_Output side output
Parameters:
side This flag allows you to choose the side, i.e. A or B, where all impairments in the side will be turned off.
output This flag allows you to Connect (ON) or disconnect (OFF) the impairments gen-erator to or from the line.
Command Insert Widget:
Examples:
Dls_5A01_Output A ON
Descriptions:
Connect (ON) or disconnect (OFF) the impairments generator to or from the line.
DLS 1200 Operating Manual
Spirent Communications - Page 5-25
7104170669-12/04-3
5.2.9 Dls_5A01_Quiet
Command Name:
Dls_5A01_Quiet
Usages:
Dls_5A01_Quiet side
Parameters:
side This flag allows you to choose the side, i.e. A or B, where all impairments in the side will be turned off.
Command Insert Widget:
Examples:
Dls_5A01_Quiet A
Descriptions:
This command turns all impairments OFF but leaves the output stage ON.
DLS 1200 Operating Manual
Page 5-26 - Spirent Communications
7104170669-12/04-3
5.2.10 Dls_5A01_ShapedNoise
Command Name:
Dls_5A01_ShapedNoise
Usages:
Dls_5A01_ShapedNoise side type level unit
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Shaped Noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
type This flag allows you to choose the downloadable shaped noise type such as “C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/DLS400J SHP Files/ETSI BASIC.shp".
level This flag allows you to set the level of the noise. Level range in dBm/Hz for a downloadable shape noise can be found in the noise file. Level range in uV/SQRT(HZ) must be calculated based on the value in dBm/Hz.
unit This flag allows you to set the unit used for measuring the level of the noise , i.e. dBm/Hz or uV/SQRT(HZ) .
Command Insert Widget:
DLS 1200 Operating Manual
Spirent Communications - Page 5-27
7104170669-12/04-3
Examples:
Dls_5A01_ShapedNoise A " C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/DLS400J SHP Files/ETSI BASIC.shp " –94.4 dBm/Hz
Descriptions:
Set Shaped Noise Generator to inject a noise on side A or B, at the desired level, measured in dBm/Hz or uV/SQRT(HZ).
5.2.11 Dls_5A01_ShapedNoiseLevel
Command Name:
Dls_5A01_ShapedNoiseLevel
Usages:
Dls_5A01_ShapedNoiseLevel side type level unit
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the Shaped Noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
type This flag allows you to choose the downloadable shaped noise type such as “C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/DLS400J SHP Files/ETSI BASIC.shp".
level This flag allows you to set the level of the noise. Level range in dBm/Hz for a downloadable shape noise can be found in the noise file. Level range in uV/SQRT(HZ) must be calculated based on the value in dBm/Hz.
unit This flag allows you to set the unit used for measuring the level of the noise , i.e. dBm/Hz or uV/SQRT(HZ) .
DLS 1200 Operating Manual
Page 5-28 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A01_ShapedNoiseLevel A " C:/Program Files/Spirent Communications/DLS 1100/Impairments Files/DLS400J SHP Files/ETSI BASIC.shp " –94.4 dBm/Hz
Descriptions:
Set shaped noise level without downloading the noise. This command can only be used if the shaped noise has been downloaded into the card.
5.2.12 Dls_5A01_WhiteNoise
Command Name:
Dls_5A01_WhiteNoise
Usages:
Dls_5A01_WhiteNoise side state level
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the White Noise will be injected. This works only when the DLS 5A01 is physically installed in slot A or/and slot B of a chassis.
state This flag allows you to turn the White Noise Generator ON or OFF.
level This flag allows you to set the level of the noise. Range from -140.0 to -90.0 dBm/Hz in steps of 0.1 dB.
DLS 1200 Operating Manual
Spirent Communications - Page 5-29
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A01_WhiteNoise A ON -140.0
Descriptions:
Turn on and generate White Noise on side A or B, at the desired level.
5.2.13 Dls_5A01_Disconnect
Command Name:
Dls_5A01_Disconnect
Usages:
Dls_5A01_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting the device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
DLS 1200 Operating Manual
Page 5-30 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5A01_Disconnect SerialDls_5A01_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
5.2.14 DLS 5A01H
Extended Tcl command names and interfaces in DLS 5A01H module are similar as in DLS 5A01 module. The only difference is that 5A01 has been changed to 5A01H in the extended command names. For exam-ple, Dls_5A01H_Connect GPIB 14 will be used for connecting a DLS 5A01H card and Dls_5A01_Connect GPIB 14 will be used for connecting a DLS 5A01 card. Refer to section 2.10 for a specific command usage.
DLS 1200 Operating Manual
Spirent Communications - Page 5-31
7104170669-12/04-3
5.3 DLS Loader
5.3.1 Dls_Loader_Connect
Command Name:
Dls_Loader_Connect
Usages:
Dls_Loader_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB.
com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial (RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_Loader_Connect Serial 1Dls_Loader_Connect GPIB 14
Descriptions:
Establish communication with DLS 5A01 card through a DLS chassis using RS-232/GPIB.
DLS 1200 Operating Manual
Page 5-32 - Spirent Communications
7104170669-12/04-3
5.3.2 Dls_Loader_GetNoiseInfoFromCard
Command Name:
Dls_Loader_GetNoiseInfoFromCard
Usages:
Dls_Loader_GetNoiseInfoFromCard side position
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the DLS 5A01 is phys-ically installed in slot A or/and slot B of a chassis.
position Specify the impairments filter position in DLS 5A01 card which is from 1 to 15.
Command Insert Widget:
Examples:
Dls_Loader_GetNoiseInfoFromCard A 1
Descriptions:
Select the impairments side and obtain the impairments information in a position of DLS 5A01 card.
5.3.3 Dls_Loader_GetNoiseInfoFromNifFile
Command Name:
Dls_Loader_GetNoiseInfoFromNifFile
DLS 1200 Operating Manual
Spirent Communications - Page 5-33
7104170669-12/04-3
Usages:
Dls_Loader_GetNoiseInfoFromNifFile noise_name file_name
Parameters:
noise_name Specify the impairments type name which will be assigned to a corresponding NIF file such as DSL Next. Refer to file “Dls 5a01.csv” for a proper impairment file name.
file_name Specify the impairments NIF file name with the folder using forward slash / or double back slash \\. For example, both "C:/Program Files/Spirent Communica-tions/DLS Loader/NIF Files/10000020.nif" and"C:\\Program Files\\Spirent Communications\\DLS Loader\\NIF Files\\10000020.nif" are good names; but "C:\Program Files\Spirent Communi-cations\DLS Loader\NIF Files\10000020.nif" is an invalid name with folder.It is assumed that the DLS 1100 software was installed under “C:/Program Files”. If the DLS 1100 software was installed under “D:/My folder”, one of the valid names will be "D:/My folder/Spirent Communications/DLS Loader/NIF Files/10000020.nif".
Command Insert Widget:
Examples:
Dls_Loader_GetNoiseInfoFromNifFile " DSL Next " " C:/Program Files/Spirent Communications/DLS Loader/NIF Files/10000020.nif "
Descriptions:
Specify the impairments type name to a corresponding NIF file and obtain the impairments information about the NIF file.
DLS 1200 Operating Manual
Page 5-34 - Spirent Communications
7104170669-12/04-3
5.3.4 Dls_Loader_LoadNoiseFile
Command Name:
Dls_Loader_LoadNoiseFile
Usages:
Dls_Loader_LoadNoiseFile side position noise_name file_name
Parameters:
side This flag allows you to choose the side, i.e. A or B, where the DLS 5A01 is phys-ically installed in slot A or/and slot B of a chassis.
position Specify the impairments filter position in DLS 5A01 card which is from 1 to 15.
noise_name Specify the impairments type name which will be assigned to a corresponding NIF file such as DSL Next. Refer to file “Dls 5a01.csv” for a proper impairment file name.
file_name Specify the impairments NIF file name with the folder using forward slash / or double back slash \\.
Command Insert Widget:
Examples:
Dls_Loader_LoadNoiseFile A 1 " DSL Next " " C:/Program Files/Spirent Communications/DLS Loader/NIF Files/filename.nif "
DLS 1200 Operating Manual
Spirent Communications - Page 5-35
7104170669-12/04-3
Descriptions:
Load an impairments type to DLS 5A01 card which includes: erase the position; load the impairments file name; load the NIF file; and load the LDF file.
5.3.5 Dls_Loader_Disconnect
Command Name:
Dls_Loader_Disconnect
Usages:
Dls_Loader_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting the device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_Loader_Disconnect SerialDls_Loader_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
DLS 1200 Operating Manual
Page -36 - Spirent Communications
7104170669-12/04-3
5.4 DLS 5204
The DLS 5204 has an extensive library of commands which may not be required for most test requirements. The sequence displayed below would be a good starting point for most script requirements..
Typical sequence: Dls_5204_ResetChannel Dls_5204_Loadfile Dls_5204_SetCrestFactor (optional) Dls_5204_SetNumberOfSambles Dls_5204_SetSelectedChannel Dls_5204_GenerateSample Dls_5204_LoadOutput Dls_5204_SetMicroGain Additional sequence commands: Dls_5204_GetFileNames must be after Dls_5204_LoadOutput Dls_5204_SetTDWhiteNoise must be after Dls_5204_Loadfile Dls_5204_SetReferenceLevel must be after Dls_5204_SelectNoise
5.4.1 Dls_5204_CombinerXtkRfi
Command Name:
Dls_5204_CombinerXtkRfi
Usages:
Dls_5204_CombinerXtkRfi channel mode sample_number number_of_files file1 gain 1 file2 gain 2 file3 gain 3 file4 gain 4 file5 gain 5 file6 gain 6 file7 gain 7 mico_gain
Parameters:
channel Channel to be selected from Channel_1 to Channel_4.
mode Enable/ disable crest factor greater than or equal to 5.
sample_number Select the number of samples to be used.
file1 Load an RFI or a Xtalk noise file.
gain 1 Set a noise gain for file1 (range -72.25 to 72.25 dB).
file2 Load an RFI or a Xtalk noise file.
gain 2 Set a noise gain for file2 (range -72.25 to 72.25 dB).
file3 Load an RFI or a Xtalk noise file.
gain 3 Set a noise gain for file3 (range -72.25 to 72.25 dB).
DLS 1200 Operating Manual
Spirent Communications - Page -37
7104170669-12/04-3
file4 Load an RFI or a Xtalk noise file.
gain 4 Set a noise gain for file4 (range -72.25 to 72.25 dB).
file5 Load an RFI or a Xtalk noise file.
gain 5 Set a noise gain for file5 (range -72.25 to 72.25 dB).
file6 Load an RFI or a Xtalk noise file.
gain 6 Set a noise gain for file6 (range -72.25 to 72.25 dB).
file7 Load an RFI or a Xtalk noise file.
gain 7 Set a noise gain for file7 (range -72.25 to 72.25 dB).
mico_gain Set gain from -3.0 to +9.0 dB for frequency domain noises.
Command Insert Widget:
Example:
Dls_5204_CombinerXtkRfi channel_1 ON 32768:\”C:\\Programfiles\\spirent communications\\DLS 5204\\Noisefiles\\DSL Forum........_xtk.enc”gain 1”5”
Description:
Combine commands (from select channel to load output and set micro gain) in one line for XTALK and RFI.
5.4.2 Dls_5204_Connect
Command Name:
Dls_5204_Connect
DLS 1200 Operating Manual
Page -38 - Spirent Communications
7104170669-12/04-3
Usages:
Dls_5204_Connect ipaddr port
Parameters:
ipaddr IP address of DLS 5204 unit.
port Port of DLS 5204 unit. Defaults to 2001 if not entered
Command Insert Widget:
Example:
Dls_5204_Connect 10.20.2.105 2001
Description:
Establish a connection to a DLS 5204 unit.
5.4.3 Dls_5204_Disconnect
Command Name:
Dls_5204_Disconnect
Usages:
Dls_5204_Disconnect
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -39
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_Disconnect
Description:
Disconnect from a DLS 5204 unit.
5.4.4 Dls_5204_GetFileNames
Command Name:
Dls_5204_GetFileNames
Usages:
Dls_5204_GetFileNames channel
Parameters:
Channel Get noise file name for selected channel. Your choices are: Channel 1 to 4.(Query Commands)
DLS 1200 Operating Manual
Page -40 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetFileNames Channel_1
Description:
Query for the noise file name of the selected DLS 5204 channel.
5.4.5 Dls_5204_GetInjectorLoss
Command Name:
Dls_5204_GetInjectorLoss
Usages:
Dls_5204_GetInjectorLoss channel
Parameters:
Channel Get injector loss for selected channel. Your choices are: Channel 1 to 4.
DLS 1200 Operating Manual
Spirent Communications - Page -41
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetInjectorLoss Channel_1
Description:
Query for the injector loss in dB of the selected injection unit used, all noise files generated by the DLS 5204 will be increased by this value to compensate for the loss of the noise injection unit. The return string will display the injector loss value or injector name.
5.4.6 Dls_5204_GetInstalledLicense
Command Name:
Dls_5204_GetInstalledLicense
Usages:
Dls_5204_GetInstalledLicense
Parameters:
None
DLS 1200 Operating Manual
Page -42 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetInstalledLicense
Description:
Query for all installed licences of the DLS 5204 unit.
5.4.7 Dls_5204_GetMacAddress
Command Name:
Dls_5204_GetMacAddress
Usages:
Dls_5204_GetMacAddress
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -43
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetMacAddress
Description:
Query for the media access control (MAC) address of the DLS 5204 unit.
5.4.8 Dls_5204_GetNetworkName
Command Name:
Dls_5204_GetNetworkName
Usages:
Dls_5204_GetNetworkName
Parameters:
None
DLS 1200 Operating Manual
Page -44 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetNetworkName
Description:
Query which network is currently connected to the DLS 5204 unit. Returns the computer name which you connect to.
5.4.9 Dls_5204_GetOutputCFRC
Command Name:
Dls_5204_GetOutputCFRC
Usages:
Dls_5204_GetOutputCFRC channel
Parameters:
Channel Channel to get the CFRC file for. Your choices are: Channel 1 to 4.
DLS 1200 Operating Manual
Spirent Communications - Page -45
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetOutputCFRC Channel_1
Description:
Query for the channel frequency response compensation CFRC file name of the selected DLS 5204 channel. To create a CFRC file an Agilent 4395A spectrum network analyzer is required. (For Future Development).
5.4.10 Dls_5204_GetOutputLevel
Command Name:
Dls_5204_GetOutputLevel
Usages:
Dls_5204_GetOutputLevel channel
Parameters:
Channel Channel to get the noise output level from. Your choices are: Channel 1 to 4.
DLS 1200 Operating Manual
Page -46 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetOutputLevel Channel_1
Description:
Query for the noise output level in dBm of the selected DLS 5204 channel.
5.4.11 Dls_5204_GetSelectedChannel
Command Name:
Dls_5204_GetSelectedChannel
Usages:
Dls_5204_GetSelectedChannel
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -47
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetSelectedChannel
Description:
Query which is the current selected channel is being set. Returns Channel_1, Channel_2, Channel_3, or Channel_4.
5.4.12 Dls_5204_GetSoftwareVersion
Command Name:
Dls_5204_GetSoftwareVersion
Usages:
Dls_5204_GetSoftwareVersion
Parameters:
None
DLS 1200 Operating Manual
Page -48 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetSoftwareVersion
Description:
Query which software version is currently installed on the DLS 5204 unit.
5.4.13 Dls_5204_GetSystemID
Command Name:
Dls_5204_GetSystemID
Usages:
Dls_5204_GetSystemID
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -49
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GetSystemID
Description:
Query for the identification set by the ‘System identifier” in the system properties window of the 5204 GUI.
5.4.14 Dls_5204_CopyChannel
Command Name:
Dls_5204_CopyChannel
Usages:
Dls_5204_CopyChannel src_chan dst_chan
Parameters:
src_chan Source channel.
dst_chan Destination channel.
DLS 1200 Operating Manual
Page -50 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_CopyChannel Channel_1 Channel_2
Description:
Copy channel settings from src_chan to dst_chan. (Source to Destination) noise profile/setting will be cop-ied from source to destination channel.
5.4.15 Dls_5204_EnableCFRC
Command Name:
Dls_5204_EnableCFRC
Usages:
Dls_5204_EnableCFRC channel state file
Parameters:
channel Channel to enable CFRC on (Channel_1 through Channel_4).
state 'on' to enable, 'off' to disable.
file CFRC file name to select (optional only for state OFF).
DLS 1200 Operating Manual
Spirent Communications - Page -51
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_EnableCFRC Channel_1 ON "Test"
Description:
Enable or disable the selected channel frequency response compensation (CFRC) file on the selected DLS 5204 channel. An Agilent 4395A spectrum analyzer is required to create this file type
5.4.16 Dls_5204_EnableOutput
Command Name:
Dls_5204_EnableOutput
Usages:
Dls_5204_EnableOutput channel mode
Parameters:
channel Channel to select (Channel_1 through Channel_4)
mode 'on' to enable, 'off' to disable.
DLS 1200 Operating Manual
Page -52 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_EnableOutput Channel_1 ON
Description:
Enable or disable signal output. Active noise will be turned on or off
5.4.17 Dls_5204_GenerateSample
Command Name:
Dls_5204_GenerateSample
Usages:
Dls_5204_GenerateSample
Parameters:
N/A
DLS 1200 Operating Manual
Spirent Communications - Page -53
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_GenerateSample
Description:
Interpolate noise shape and store in PC RAM.
5.4.18 Dls_5204_LoadFile
Command Name:
Dls_5204_LoadFile
Usages:
Dls_5204_LoadFile file
Parameters:
file For noise file types "XTalk", "RFI", "Time_Domain", to load the file can be expressed in two ways:
1.Absolute path ( c:\\...\\Noisefiles\\…\\whitenoise.xtk.enc)
2.Package/Version/Location/File (DLS 5B17\\v1.0\\NoiseFiles\\…)
For the noise file types Impulse or Custom (must end in _cst.enc), enter the absolute path and file name of the file to load.
DLS 1200 Operating Manual
Page -54 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_LoadFile XTALK C:/whitenoise_xtk.dat
Description:
Load a noise file *_td file types cannot be loaded with a _xtk or _rfi.enc file type on the same DLS 5204 channel.
5.4.19 Dls_5204_LoadOutput
Command Name:
Dls_5204_LoadOutput
Usages:
Dls_5204_LoadOutput
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -55
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_LoadOutput
Description:
Loads the signal to the noise card, pre-calculates the selected noise.
5.4.20 Dls_5204_NoiseDisturber
Command Name:
Dls_5204_NoiseDisturber
Usages:
Dls_5204_NoiseDisturber file value
Parameters:
File File index (start from 0) or file name to use as a noise disturber.
Value Number of Noise disturbers to set.
DLS 1200 Operating Manual
Page -56 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_NoiseDisturber "1" 2
Description:
Set the file index and the number of noise disturbers for the DLS 5204 unit. The file or file index is based on the order of which the noise files have been loaded into the workspace window. Users should note that not all file types will allow a user to change or modify the qty of disturbers. When using this command the user should also verify that the proper noise level output has been acheived. File 1 value would be 0, File 2 value would be 1 etc.
5.4.21 Dls_5204_ResetChannel
Command Name:
Dls_5204_ResetChannel
Usages:
Dls_5204_ResetChannel
Parameters:
None
DLS 1200 Operating Manual
Spirent Communications - Page -57
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_ResetChanne
Description:
Deselects all noises and disables output on the current channel.
5.4.22 Dls_5204_SaveCustomNoiseFile
Command Name:
Dls_5204_SaveCustomNoiseFile
Usages:
Dls_5204_SaveCustomNoiseFile file
Parameters:
name Custom noise file name to save (must have _cst.enc extension).
DLS 1200 Operating Manual
Page -58 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SaveCustomNoise "Noise1_cst.enc"
Description:
Save a custom noise file. (For future development).
5.4.23 Dls_5204_SelectNoise
Command Name:
Dls_5204_SelectNoise
Usages:
Dls_5204_SelectNoise noise mode
Parameters:
noise Type of noise ("XTalk","RFI","Time_Domain","Impulse")
mode 'on' to enable, 'off' to disable
DLS 1200 Operating Manual
Spirent Communications - Page -59
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SelectNoise RFI OFF
Description:
Enables / Disables the requested noise
5.4.24 Dls_5204_SetCrestFactor
Command Name:
Dls_5204_SetCrestFactor
Usages:
Dls_5204_SetCrestFactor mode
Parameters:
mode 'on' to enable, 'off' to disable
DLS 1200 Operating Manual
Page -60 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetCrestFactor OFF
Description:
Enables / Disables crest factor ( => 5) for XTalk noise.
5.4.25 Dls_5204_SetCustomerHeader
Command Name:
Dls_5204_SetCustomHeader
Usages:
Dls_5204_SetCustomHeader value
Parameters:
value A string with a maximum of 256 characters can be entered which describes the custom noise file created_cst.enc
DLS 1200 Operating Manual
Spirent Communications - Page -61
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetCustomHeader”text”
Description:
Set the user-defined description for saved files. Information in this text field should represent information of interest to the user.
5.4.26 Dls_5204_SetExternalSync
Command Name:
Dls_5204_SetExternalSync
Usages:
Dls_5204_SetExternalSync value
Parameters:
value 'on' to enable, 'off' to disable
DLS 1200 Operating Manual
Page -62 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetExternalSync ON
Description:
Enables / Disables the external sync out BNC connector used for Japanese transmission synchronization. This field should not be set unless testing using Japanese noise files.
5.4.27 Dls_5204_SetImpulseLevel
Command Name:
Dls_5204_SetImpulseLevel
Usages:
Dls_5204_SetImpulseLevel level
Parameters
level Impulse level in millivolts (mV).
DLS 1200 Operating Manual
Spirent Communications - Page -63
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetImpulseLevel 10
Description:
Set the impulse noise level. Range from 0-100mV.
5.4.28 Dls_5204_SetImpulseRate
Command Name:
Dls_5204_SetImpluseRate
Usages:
Dls_5204_SetImpulseRate value
Parameters:
value Number of pulses per second (pps) for impulse noise (when not used in conjunc-tion with time domain noise) _td files. Range is 1 to 100 pps.
DLS 1200 Operating Manual
Page -64 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetImpulseRate 50
Description:
Set the number of pulses per second for impulse noise (when not used with time domain noise). The pps value should not be set if a user is generating an impulse noise in conjunction with a time domain _td file type.
5.4.29 Dls_5204_SetImpulseRepeatNumber
Command Name:
SetImpulseRepeatNumber
Usages:
Dls_5204_SetImpulseRepeatNumber repeat
Parameters:
repeat Total number of impulses to generate.
DLS 1200 Operating Manual
Spirent Communications - Page -65
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetImpulseRepeatNumber 15
Description:
Set the number of impulse per second to generate. Impulse noise will automatically stop once the last impulse has been generated.
5.4.30 Dls_5204_SetImpulseType
Command Name:
Dls_5204_SetImpulseType
Usages:
Dls_5204_SetImpulseType type
Parameters:
type Type of impulse noise ("ADSL-C1", "ADSL-C2")
DLS 1200 Operating Manual
Page -66 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetImpulseType ADSL-C1
Description:
Sets the type of impulse noise to generate.
5.4.31 Dls_5204_SetInjectorLoss
Command Name:
Dls_5204_SetInjectorLoss
Usages:
Dls_5204_SetInjectorLoss channel value
Parameters:
Channel Channel to set as connected to the injector. Your choices are: Channel 1 to 4.
Value Injector loss value to set in dB or a valid injector name (one of DLS5402DC, DLS 5403D and DLS 5404)
DLS 1200 Operating Manual
Spirent Communications - Page -67
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetInjectorLoss Channel_1 "1.0"
Description:
Set the injector loss in dB for the selected DLS 5204 channel the value entered in this field should be based on the noise injection loss of the specified noise injector.
5.4.32 Dls_5204_SetMicroGain
Command Name:
Dls_5204_SetMicroGain
Usages:
Dls_5204_SetMicroGain micro gain
Parameters:
micro gain The output noise power level to set in dB (frequency domain = -3.0 to +9.0 dB, time domain = -3.0 to +7.0 dB).
DLS 1200 Operating Manual
Page -68 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5204_SetMicroGain "3.0"
Descriptions:
Adjust the noise power level of the current noise source output in dB from reference (for frequency or time domain noise). A value entered in this field will increase or decrease all file spectrums loaded on the speci-fied channel.
5.4.33 Dls_5204_SetNoiseGain
Command Name:
Dls_5204_SetNoiseGain
Usages:
Dls_5204_SetNoiseGain value
Parameters:
value The last loaded noise gain, (In the case of impulse noise, the gain is based from a starting level of 0 microVolts). For Xtalk and RFI the range is -72.25 to 72.25. For time domain the range is -7.0 to + 7.0. For Impulse the range is 0.0 to 100.0.
DLS 1200 Operating Manual
Spirent Communications - Page -69
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5204_SetNoiseGain "3.0"
Descriptions:
Adjust the gain of the last loaded noise file.
5.4.34 Dls_5204_SetNoiseGainEX
Command Name:
Dls_5204_SetNoiseGainEx
Usages:
Dls_5204_SetNoiseGainEx index value
Parameters:
index (index numbers start from 0).value For Xtalk and RFI the range is -72.25 to 72.25. For time domain the range is -7.0
to + 7.0. For Impulse the range is 0.0 to 100mV.
DLS 1200 Operating Manual
Page -70 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_5204_SetNoiseGainEx "1" "3.0"
Descriptions:
Within the workspace.
5.4.35 Dls_5204_SetNumberOfSamples
Command Name:
Dls_5204_SetNumberOfSamples
Usages:
Dls_5204_SetNumberOfSamples samples
Parameters:
samples number of samples to use, higher number of samples will take longer to calcu-late, the higher number of samples will decrease the repetition rate of the noise profile.
DLS 1200 Operating Manual
Spirent Communications - Page -71
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetNumberOfSamples 32768
Description:
Set the number of samples to use.
5.4.36 Dls_5204_SetReferenceLevel
Command Name:
Dls_5204_SetReferenceLevel
Usages:
Dls_5204_SetReferenceLevel noise ref
Parameters:
noise Type of noise ("XTalk", "RFI", "Time_Domain")
ref Reference level to use.
DLS 1200 Operating Manual
Page -72 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetReferenceLevel XTALK -5
Description:
Sets the reference level for the selected noise.
5.4.37 Dls_5204_SetSelectedChannel
Command Name:
Dls_5204_SetSelectedChannel
Usages:
Dls_5204_SetSelectedChannel channel
Parameters:
channel Channel to select (Channel_1 through Channel_4).
DLS 1200 Operating Manual
Spirent Communications - Page -73
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetSelectedChannel Channel_3
Description:
Sets the current selected channel.
5.4.38 Dls_5204_SetTDWhiteNoise
Command Name:
Dls_5204_SetTDWhiteNoise
Usages:
Dls_5204_SetTDWhiteNoise value
Parameters:
value 'on' to enable, 'off' to disable.
DLS 1200 Operating Manual
Page -74 - Spirent Communications
7104170669-12/04-3
Command Insert Widget:
Example:
Dls_5204_SetTDWhiteNoise ON
Description:
Enable/Disable time domain white noise. This file can only be combined with other *_td noise types.
DLS 1200 Operating Manual
Spirent Communications - Page 6-1
7104170669-12/04-3
6. DLS 6000 and RS-232/GPIB TCL COMMANDS
6.1 RS232/GPIB
6.1.1 Dls_Open Command
Command Name:
Dls_Open
Usages:
Dls_Open type address
Parameters:
comtype This flag allows you to select the communication types Serial or GPIB.
address This flag allows you to select the COM port number, i.e., 1 to 4 for SERIAL (RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_Open Serial 1Dls_Open GPIB 14
DLS 1200 Operating Manual
Page 6-2 - Spirent Communications
7104170669-12/04-3
A complete scripts:
package require dlsDls_Open Serial 1 Dls_SendString "*idn?" Dls_GetString buffer puts $bufferDls_Close Serial
Descriptions:
This command opens a communication port in RS232 or GPIB to the DLS device.
6.1.2 Dls_SendString Command
Command Name:
Dls_SendString
Usages:
Dls_SendString sendStr
Parameters:
sendStr This flag allows you to manually type a string which will be sent to the DLS device when the connection has been established.
Command Insert Widget:
Examples:
Dls_SendString “ *idn? “ Dls_SendString “:SET:CHAN:LOOP VARIABLE_26_AWG”
DLS 1200 Operating Manual
Spirent Communications - Page 6-3
7104170669-12/04-3
Descriptions:
This command sends a string entered by user to the DLS device.
6.1.3 Dls_GetString Command
Command Name:
Dls_GetString
Usages:
Dls_GetString buffer
Parameters:
buffer This buffer is used to store the received string from the DLS device when the connection has been established.
Command Insert Widget:
Examples:
Dls_GetString bufferputs $buffer
Descriptions:
This command returns the last string received from the DLS device.
DLS 1200 Operating Manual
Page 6-4 - Spirent Communications
7104170669-12/04-3
6.1.4 Dls_Close Command
Command Name:
Dls_Close
Usages:
Dls_Close comtype
Parameters:
comtype This flag allows you to select the communication types Serial or GPIB.
Command Insert Widget:
Examples:
Dls_Close SerialDls_Close GPIB
Descriptions:
Close an opened port in RS-232 or GPIB.
6.2 DLS 6100 (XPS)
6.2.1 Dls_D6100_Connect Command
Command Name:
Dls_D6100_Connect
DLS 1200 Operating Manual
Spirent Communications - Page 6-5
7104170669-12/04-3
Usages:
Dls_D6100_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial
(RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_D6100_Connect Serial 1Dls_D6100_Connect GPIB 14
Descriptions:
Establish communication with DLS 6100 (XPS) device, via RS-232 or GPIB.
6.2.2 Dls_D6100_SetLength Command
Command Name:
Dls_ D6100_SetLength
Usages:
Dls_D6100_SetLength length ft_or_kft
DLS 1200 Operating Manual
Page 6-6 - Spirent Communications
7104170669-12/04-3
Parameters:
length This flag allows you to set the length, i.e. 16000 or 14.5, according to DLS 6100 (XPS) specifications. The number could be an integer or a decimal, depending on the measuring unit, i.e. ft or Kft respectively.
ft_or_km This flag allows you to choose the measuring unit i.e. ft, Kft, m or Km, and it could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_D6100_SetLength 23000 ft Dls_D6100_SetLength 12.5 Kft Dls_D6100_SetLength 4500 m Dls_D6100_SetLength 3.5 Km
Procedure:
Dls_D6100_SetLength { {length 0} {ft_or_km ft} };
Descriptions:
Set DLS 6100 (North American XPS) or DLS 6140 (European XPS) to simulate various lengths, according to the specifications.
6.2.3 Dls_Disconnect Command
Command Name:
Dls_Disconnect
DLS 1200 Operating Manual
Spirent Communications - Page 6-7
7104170669-12/04-3
Usages:
Dls_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting any device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
Command Insert Widget:
Examples:
Dls_Disconnect SerialDls_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
6.3 DLS 6200 (MPS)
6.3.1 Dls_D6200_Connect Command
Command Name:
Dls_D6200_Connect
DLS 1200 Operating Manual
Page 6-8 - Spirent Communications
7104170669-12/04-3
Usages:
Dls_D6200_Connect serial_gpib com_addr
Parameters:
serial_gpib This flag allows you to select the communication types Serial or GPIB. com_addr This flag allows you to select the COM port number, i.e., 1 to 4 for Serial
(RS232) or address, i.e., 1 to 30 for GPIB.
Command Insert Widget:
Examples:
Dls_D6200_Connect Serial 1Dls_D6200_Connect GPIB 14
Descriptions:
Establish communication with DLS 6200 (MPS) device, via RS-232/GPIB.
6.3.2 Dls_D6200_SetMultipleLines Command
Command Name:
Dls_ D6200_SetMultipleLines
Usages:
Dls_D6200_SetMultipleLines unit line1Length line2Length line3Length line4Length line5Length line6Length line7Length line8Length line9Length line10Length line11Length line12Length line13Length line14Length line15Length line16Length line17Length line18Length line19Length line20Length line21Length line22Length line23Length line24Length
DLS 1200 Operating Manual
Spirent Communications - Page 6-9
7104170669-12/04-3
Parameters:
unit This flag allows you to choose the measuring unit for all lines , i.e. ft or m. The unit can be set once for all lines.
Line1Length This flag allows you to set the length for line 1, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line2Length This flag allows you to set the length for line 2, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line3Length This flag allows you to set the length for line 3, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line4Length This flag allows you to set the length for line 4, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line5Length This flag allows you to set the length for line 5, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line6Length This flag allows you to set the length for line 6, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line7Length This flag allows you to set the length for line 7, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line8Length This flag allows you to set the length for line 8, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line9Length This flag allows you to set the length for line 9, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line10Length This flag allows you to set the length for line 10, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line11Length This flag allows you to set the length for line 11, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line12Length This flag allows you to set the length for line 12, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line13Length This flag allows you to set the length for line 13, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line14Length This flag allows you to set the length for line 14, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line15Length This flag allows you to set the length for line 15, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
DLS 1200 Operating Manual
Page 6-10 - Spirent Communications
7104170669-12/04-3
Line16Length This flag allows you to set the length for line 16, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line17Length This flag allows you to set the length for line 17, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line18Length This flag allows you to set the length for line 18, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line19Length This flag allows you to set the length for line 19, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line20Length This flag allows you to set the length for line 20, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line21Length This flag allows you to set the length for line 21, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line22Length This flag allows you to set the length for line 22, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line23Length This flag allows you to set the length for line 23, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
Line24Length This flag allows you to set the length for line 24, i.e., 16000 , according to DLS 6200 (MPS) specifications. The number must be an integer.
DLS 1200 Operating Manual
Spirent Communications - Page 6-11
7104170669-12/04-3
Command Insert Widget:
Examples :
Dls_D6200_SetMultipleLines ft NA 4500 NA 16500 NA NA NA NA NA NA NA \ NA NA NA NA 23000 NA 12500 NA NA NA NA NA NADls_D6200_SetMultipleLines m NA 4500 NA 16500 NA NA NA NA NA NA NA \ NA NA NA NA 23000 NA 12500 NA NA NA NA NA NA
Descriptions:
Set DLS 6200 (MPS) to simulate multiple lines at various lengths, according to the specifications.
The measuring unit, i.e. m or ft, must be the same for all lines.
6.3.3 Dls_D6200_SetLineLength Command
Command Name:
Dls_ D6200_SetLineLength
Usages:
Dls_D6200_SetLineLength line length ft_or_km
Parameters:
line This flag allows you to choose a line, i.e. 3 or 13. The maximum number of lines, which were installed in DLS 6200 (MPS), could be 24. This number will vary depending on the physical configuration of each device.
length This flag allows you to set the length of chosen line, i.e., 16000 or 14.5, according to DLS 6200 (MPS) specifications. The number could be an inte-ger or a decimal, depending on the measuring unit for any line, i.e., ft or Kft, m or km.
DLS 1200 Operating Manual
Page 6-12 - Spirent Communications
7104170669-12/04-3
ft_or_km This flag allows you to choose the measuring unit i.e., ft or Kft, m or km, and is not case sensitive.
Command Insert Widget:
Examples :
Dls_D6200_SetLineLength 9 16.5 KftDls_D6200_SetLineLength 11 5000 m
Descriptions:
Set DLS 6200 (MPS) to simulate multiple lines at various lengths, according to the specifications.
6.3.4 Dls_Disconnect Command
Command Name:
Dls_Disconnect
Usages:
Dls_Disconnect serial_gpib
Parameters:
serial_gpib The flag to choose the communication type used for disconnecting any device previously connected to a serial (RS232) or GPIB communication port. you can choose Serial for RS-232 or GPIB for GPIB communication. This flag could be in upper case or lower case.
DLS 1200 Operating Manual
Spirent Communications - Page 6-13
7104170669-12/04-3
Command Insert Widget:
Examples:
Dls_Disconnect SerialDls_Disconnect GPIB
Descriptions:
Disconnect the device from RS-232/GPIB communication port.
DLS 1200 Operating Manual
Page 6-14 - Spirent Communications
7104170669-12/04-3
DLS 1200 Operating Manual
Spirent Communications - Page 7-1
7104170669-12/04-3
7. DLS 1200 Scripting Example
7.1 TR-048 Script Example
The following example script automates TR-048 Section 8.1.1 for the DLS 400IA wireline simulator and the DLS 5204 noise generator.
7.1.1 TCL Code
################################################################
# ####Script for setting white noise and TR-048 Loops required in section 8.1.1
####################################################################
package require dls
#### File path on DLS5204 (Noise Files)
set path5204 "c:\\Program Files\\Spirent Communications\\DLS 5204\\NoiseFiles\\DSL Forum\\ADSL_TR-048 (Apr 2002)\\"
####Connect to 400IA chassis 1 and 2 on GPIB addresses 14 and 15
Dls_400IA_Connect GPIB 14 15
#### Connect to 5204 on IP address 10.20.2.20 and port 2002
Dls_5204_Connect 10.20.2.20 2002
################################################################
# ####Set Noise on Channel 1
####################################################################
Dls_5204_SetSelectedChannel Channel_1
Dls_5204_ResetChannel
Dls_5204_SelectNoise XTALK ON
Dls_5204_SelectNoise RFI OFF
set noise "${path5204}8-1-1_White_Noise_Impairment\\Upstream_At_ATU-C\\White_Noise_xtk.enc"
Dls_5204_LoadNoiseFile XTALK $noise
Dls_5204_SetCrestFactor ON
Dls_5204_SetNumberOfSamples 131072
Dls_5204_GenerateSample
Dls_5204_EnableOutput Channel_1 OFF
Dls_5204_LoadOutput
Dls_5204_EnableOutput Channel_1 ON
################################################################
DLS 1200 Operating Manual
Page 7-2 - Spirent Communications
7104170669-12/04-3
# ### Set Noise on Channel 2
####################################################################
Dls_5204_SetSelectedChannel Channel_2
Dls_5204_ResetChannel
Dls_5204_SelectNoise XTALK ON
Dls_5204_SelectNoise RFI OFF
set noise "${path5204}8-1-1_White_Noise_Impairment\\Downstream_At_ATU-R\\White_Noise_xtk.enc"
Dls_5204_LoadNoiseFile XTALK $noise
Dls_5204_SetCrestFactor ON
Dls_5204_SetNumberOfSamples 131072
Dls_5204_GenerateSample
Dls_5204_EnableOutput Channel_2 OFF
Dls_5204_LoadOutput
Dls_5204_EnableOutput Channel_2 ON
################################################################
# Set Loops with White noise on
################################################################
set rowCount 1
foreach i { 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 17.5 18 } {
Dls_400IA_Loop "TR-048/Straight Loops/$i kft"
}
DLS 1200 Operating Manual
Spirent Communications - Page 8-1
7104170669-12/04-3
8. CUSTOMER SERVICE
8.1 Customer Service Contact Information
For all North American customers, please direct any questions or concerns regarding the operation of a pur-chased unit, to the Spirent AE Customer Service team by one of the following methods:
Direct Line: 613-592-7301
Toll free at: 800-465-1796
Fax at: 613-592-0522
E-mail at: [email protected].
Mail: Spirent Communications750 Palladium DriveOttawa, Ontario, CanadaK2V 1C7
All other customers should check the ae.spirentcom.com web site for the contact information of the nearest Customer Service center or contact the main Spirent AE service center for assistance (contact information is listed above).
For product information and updates, please visit the Spirent Communications web site at:
http://ae.spirentcom.com.
For product manuals, software updates and more information, please visit the customer extranet at
https://ae.spirentcom.com/secure/
Passwords for the extranet can be requested at:
https://ae.spirentcom.com/Customer_care/needlogin.htm
8.2 DLS 1200 Software Maintenance
The DLS 1200 maintenance agreement entitles the user to free upgrades for one year following confirmation of the DLS 1200 purchase order. All DLS 1200 versions with release dates within this year time frame, can be ordered free of charge by contacting your local Spirent Communications sales representative or Customer Service.
DLS 1200 Operating Manual
Page 8-2 - Spirent Communications
7104170669-12/04-3