| |||
| Home > Setting Capture Options > Capture options | |||
The Capture Options dialog box presents various options that you can use to customize a capture session.
It contains the following settings:
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.
By default, Streamline uses port 8080 to connect to a target.
To use a different port, specify one here by entering a colon and
a port number after the IP address. For example, enter to
use port 1010 to connect to the target. Your_IP_address:1010
If you use the port forwarding of ADB with USB, enter localhost in
the Address field.
The target generates periodic measurement interrupts according to the following settings: Normal=1kHz, Low=100Hz, and None. 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. If you set Sample Rate to None, Streamline does not force the target to generate any periodic measurement interrupts. This ensures that Streamline has the lowest level of intrusion on your code, but also means that resulting Analysis Reports show only zeroes in any report columns that rely on sampling.
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:
16MB
4MB
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.
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.
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.
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.
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.
Use this field to define the path to the caiman.exe executable,
necessary to use the ARM Energy Probe to gather power output statistics.
Leave this field blank if you do not have Energy Probe or do not
wish to capture power data during the capture session.
You can add the following options with caiman.exe in the Enery Capture field:
Sets a specific device ast the target, overriding the auto-detect feature.
You might need to specify the tty device
in the Energy Path field when using Streamline
on Linux. To do so, enter the following command in the Energy Path
field: caiman -d /dev/ttyACM0.
Sets the port number that Streamline uses to commincate with the target for data collected by the Energy Probe. 8081 is the default value. Sample usage: caiman -p 8082.
Displays the version
information for caiman.
Lists all of the available gatord command
line options.
For more information on setting up the Energy Probe, see Energy Probe setup
If you select this checkbox, Streamline processes dwarf debug information and line numbers. This provides a higher level of detail in your Analysis Reports, but results in higher memory usage.
If you disable this option, the source section of the Code
view does not display the source code or source code statistics.
The disassembly code is still available with this option disabled,
but the source section shows only a No source available message.
If you select this checkbox, Streamline processes more data, enabling you to zoom in three more levels in the Timeline view. By default, the highest resolution in the Timeline view is the millisecond, but with this option enabled, you can zoom into one hundred microsecond, ten microsecond, and one microsecond bin sizes.
Use this area to explore your file system and define all of the images and libraries that you want to profile.
When compiling images on your host, 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:
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.
Opens an image from your Eclipse workspace.
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.
Removes the selected images and libraries.