COM usage and notes

COM objects are used within all EDX programs primarily to allow access to the RF equipment data for import and export through Microsoft Excel or other custom API’s. Study function objects (Area, lInk, etc studies) are also available only within EDX SignalPro and SignalMX.

A list of all currently-registered COM objects is available by running the following Command in the BIN folder of the EDX program installation directory: signalpro.exe /typelib This creates the Windows Type Library “main_esp.OLB” file in the BIN folder. This contains pre-compiled headers for the objects. In almost all installations of Microsoft Visual Studio (for C++, VisualBasic, FORTRAN, etc) is a utility program found in the TOOLS folder called “oleviewer.exe” that can display the contents of this file.

Each EDX program automatically registers itself for COM when it starts. However, if in Vista or Win7 and the UAC is on then you may need to run the EDX program “as administrator” once to allow the registration to occur. The following command will also work (if run with administrator privileges): regsvr32 {path to .EXE file}

The following are some basic things can that can be done with COM:

Display The SignalPro Application Through COM

By default, SignalPro does not display when using COM. It is running, but not visible. To display the GUI, you need to set Visible to true. Below is a C# example:

_signalPro = new Application();

System.Threading.Thread.Sleep(3000); // Wait for application to load

_signalPro.Visible = true;

Running Area Studies Through COM

There is an ability to run an individual study. There are a few ways to run area studies through COM.

1) View Interface

RunAllStudies – Through the View interface, you can run all the studies set to ‘calculate’. This is the same as pressing the “Run Studies” button on the SignalPro toolbar.

RunStudy(index) – This lets you run an individual study, whether or not it is set to ‘calculate’. The index is 0-based and is in the order as listed in the Area Studies dialog.

2) Area Study Interface

From the View interface, you can get the list of all Views, and from this Views collection, you can get each individual View.
Once you have the View of interest, you can get its list of Area Studies through the AreaStudies call. From here, you can get access to each individual Area Study.
Call ‘Run’ to run the specific study.
Call ‘Export’ to export the study results in a specific format. The file extension is used to determine the file format (SHP, TAB, MIF, MIG, KMZ).
Call ‘GetStudyValue’ to get a study result value at a specific latitude/longitude.

Creating New Transmitter Sites Through COM

You can create new sites through COM using the IRFSystems interface. Through this interface you can access the collection of Sites (ISites interface).

1) Creating a new Site

To create a new Site, use the ISites interface and call “Add”. You can pass in a latitude and longitude, elevation, and a Site Template to use for the basis of the site.
This will return the new site. You can set and update various data on the Site.

2) Creating Transmitters on the Site

Call ‘Add’ on the ISite interface to create a new Transmitter (ITxcvr).
Using the call ‘Txcvrs’ gives you access to the entire list of Transmitters for the specific Site.

Once you have the ITxcvr object/interface, you can then access the data for the Transmitter. For example, calling ‘Frequency’ will return the frequency result assignment from the Automatic Frequency Planning study.