Configuring Data Collection

3.4 Starting and Stopping Data Collection

As you add more instrumentation, you increase the number of logged events. If there is a lot of activity on your target, starting and stopping WindView manually from the control window can generate unnecessarily large logs and make your problem-solving more difficult. There are three ways to control WindView:

Use the and buttons on the Control window. This is the most straightforward but least precise method.

Use triggering. This is a powerful tool for focusing your data collection and simplifying your problem solving. See 6. Triggering.

Use the WindView API; issue WindView commands from WindSh or include them in your application code. This method can be very precise but is more difficult to use than triggering.

There are two approaches to using the API. The most straightforward is to use wvOn( ) and wvOff( ), located in target/src/config/usrWindview.c. These routines start a typical instance of event logging and upload. These routines are not used by WindView itself, so they can be modified to suit individual requirements.

The second approach is to use the routines in wvLib. Information is available in the reference entries; you can examine the source code in target/src/config/usrWindview.c to see how they are used. They are more difficult to use than wvOn( ) and wvOff( ), since the order in which they are invoked is critical.

All WindView routines are discussed in C. Library and Subroutine Reference.