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 the desired port number after the IP address. For example, enter
to use port 1010 to connect to the target.
If you use the port forwarding of ADB with USB, enter
localhostin 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:
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.
- 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
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
- 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
@Fis a variable for the given configuration name, while
@Nis a sequential number.
- Energy Capture
Use this field to define the path to the
caiman.exeexecutable, 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. For more information on setting up the Energy Probe, see Energy Probe setup
- Process Debug Information
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 disassmebly code is still available with this option disabled, but the source section shows only a
No source availablemessage.
- High Resolution Timeline
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, 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:
- 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.
Removes the selected images and libraries.