This can be used in association with the example programs installed via the N4010 Software installation CD ROM. When installed, the example programs are available via:
Start -> All Programs -> Agilent N4010 WLAN Test Suite -> Example Programs
As part of the N4010 software installation from the CD ROM the WLAN Test Dynamic Link Library (DLL), or “driver” is installed providing two DLL programming interfaces:
N4010 WLAN COM DLL, and
N4010 WLAN .NET DLL
Having both a COM DLL and a .NET DLL gives the option to use the specific DLL type that is compatible with the software development environment being used.
The COM and .NET programming interfaces are compatible with any programming language that supports either COM or .NET DLL programming. Example programs are available for:
Microsoft Visual C# .NET (.NET)
Microsoft Visual Basic .NET (.NET)
Microsoft Visual Basic 6.0 (COM)
Microsoft Visual C++ 6.0 (COM)
Visual Basic Script (COM)
Agilent VEE 6.2 (COM)
Agilent VEE 7.0 (.NET)
LabVIEW 6 (COM)
LabVIEW 7.1 (.NET)
These can be accessed via Start -> All Programs -> Agilent N4010 WLAN Test Suite -> Example Programs.
The example N4010 WLAN DLL commands used here demonstrate the COM DLL interface. At time of writing, the COM DLL interface is the DLL type that is compatible with most test programming environments used in the Test and Measurement industry worldwide. As development environments use in T&M evolve they are likely to be compatible with the .NET DLL type.
The differences between interfacing with the COM and .NET DLL interfaces are summarized in COM and .NET API Comparison.
This topic shows you the 6 basic steps involved in making a WLAN test program using the Agilent N4010A WLAN COM or .NET DLL
Step 1 - Reference the Dynamic Link Library (DLL)
Step 2 - Create the Instrument Object
Step 3 - Configure the Measurement Setup Parameters
Step 4 - Perform the Test
Step 5 - Get the Measurement Results
Step 6 - Close the Session
Step 1 “Reference”, Step 2 “Create” and Step 6 “Dispose” of the Instrument object must be performed if the PC or the N4010 is power cycled.
Steps 3 to 5 can be repeated as many times as required for a full test sequence of measurements to cover the chosen test plan for the WLAN device under test.
It is advisable during software test development / debugging to catch any potential exceptions due to potential errors in the programming or setup. For example the use of Try / Catch Blocks in Microsoft Visual Studio .NET, allows the program to catch any errors without the program aborting.
If the program aborts due to an exception, the “Dispose” method may not be reached and the N4010 can be left in an unknown state.