Teledyne LeCroy Automation API for Bluetooth Exercisers - Manual (Page 5)

CATC Automation API for CATC Bluetooth Exercisers Manual Version 1.01
2
1.3
Setting Up Automation for Local Use
If you intend to run Automation on the Exerciser's Host Controller (i.e., the PC attached
to the exerciser) you do not need to perform any special configuration. You can simply
execute the scripts or programs you have created and they will run the exerciser.
1.4
Setting Up Automation for Remote Use
If you intend to run automation remotely over a network, you will need to perform
DCOM configuration.
2 Automation API Description
2.1 Initialization
Both Merlin’s Wand and BTTrainer are started in automation mode using the standard
command line switch when they are invoked through the BTExerciser interface. To start
the application in automation mode, call it using the following arguments: /automation.
In this case the application does not present a GUI to the user but instead runs in
Minimized mode an icon in the taskbar without the option to Maximize or Restore).
Interfaces to other tools will not be available if the application is not started in
automation mode (when the application was started by the user in GUI mode and then
later connected to by a client), or another client is currently using the application. In
either of these cases the BTExerciser::Status property will be set to
BTAPP_STATUS_BUSY (see section 2.2.11Status Property). Multiple client
connections are queued and only the first client is allowed access to the BTExerciser
methods.
Since both BTTrainer and Merlin’s wand are restricted to one instance of the application
running at a time, a user on the server side will not be able to start the application from
the shell while a client is connected to an instance of the application that is running in
automation mode.
2.1.1 BTTrainer Initialization
Since BTTrainer cannot be run without BTTracer already running, it is required that
clients first establish a connection to BTTracer. In the case that BTTrainer is run in
automation mode without BTTracer, the inoperable status of the application will be
reflected in the value of the BTExerciser::Status property (see section 02.2.11 Status
Property).