You copied the Doc URL to your clipboard.

Capture options

The Capture Options dialog box presents various options that you can use to customize a capture session.

Figure 6. Configuration options

Configuration options

It contains the following settings:

Name

A descriptive name for your capture options. By default, Streamline uses the contents of this field to name capture and analysis files.

Figure 7. Naming the capture options

Naming the capture options

Address

The network address of the target. You can also enter the network name of your target here. The value given in this field overwrites the value in the Address field of the ARM Streamline Data view, if one has been given. The reverse is also true. If you enter a new address in the Address field of the ARM Streamline data view, it replaces the value entered here.

Note

By default, Streamline uses port 8080 to connect to a target. To use a different port, specify one here by entering a colon and the desired port number after the IP address. For example, enter Your_IP_address:1010 to use port 1010 to connect to the target.

Note

If you use the port forwarding of ADB with USB, enter localhost in the Address field.

Sample Rate

The target generates periodic measurement interrupts according to the following settings: Normal=1kHz, Low=100Hz. The Normal setting works well for most instances. Low is recommended if you have a slow target, or if the target is heavily loaded, as the Low setting means less intrusion by Streamline. The Low setting does necessitate a longer capture to collect representative data.

Buffer Mode

The default setting is unbounded streaming of target data directly to your host using a 1MB buffer. You can also use one of the following store-and-forward buffers:

Large

16MB

Medium

4MB

Small

1MB

If you select one of these sizes the capture ends when the buffer is full. This prevents the latency caused by streaming data from the target to the host.

Duration

The length of the capture session, in seconds. For example, enter 1:05 for 1 minute and 5 seconds. If you do not provide a value here, the capture session continues until you stop it manually.

Call stack unwinding

Select this checkbox to ensure that Streamline records call stacks. This greatly improves your visibility into the behavior of your target, but increases the amount of raw data Streamline sends from the target to the host. Make sure to compile your EABI images and libraries with frame pointers using the-fno-omit-frame-pointer compilation option.

Note

Streamline supports callstack unwinding for ARM binaries created using gcc, provided you compile them with frame pointers enabled. Streamline does not support Thumb or output from armcc.

Process Debug Information

If you select this checkbox, Streamline processes dwarf debug infromation and line numbers. This provides a higher level of detail in your Analysis Reports, but results in higher memory usage.

Note

If you disable this option, the source section of the Code view does not display the source code or source code statistics. The disassmebly code is still available with this option disabled, but the source section shows only a No source available message.

Output Path

Use this field to define the directory location and name of the file generated by the capture and analysis session. By default, the file is saved to a results directory defined by an install variable and given the name @F_@N.apd. @F is a variable for the given configuration name, while @N is a sequential number.

The Program Images section

Use this area to explore your file system and define all of the images and libraries that you want to profile.

Note

When compiling images, make sure to set the -g compilation option to enable debug symbols. Disabling inlining with the -fno-inline compiler setting substantially improves the call path quality.

The following buttons are included in the Program Images section of the Capture Options dialog box:

Figure 8. Program images toolbar

Program images toolbar

Add Program...

Opens a file system dialog box that you can use to choose images to add. Select the image or executable and click Open to add the file to the list.

Add Program from Workspace...

Opens an image from your Eclipse workspace.

Toggle Symbol Loading

Activates or deactivates symbol loading for the selected elf image. An eye appears next to any image or library in the list with symbol loading turned on. Using this option instead of removing an image from the list makes it easy to toggle an image on and off over multiple runs, as it does not remove it from the list of program images.

Remove

Removes the selected images and libraries.

Was this page helpful? Yes No