These instructions are specific to targets running ARM Linux.
You must have the following tools on your host to build the Linux kernel and the Gator driver:
Linux kernel source code for the target platform. Streamline supports only Linux kernel versions 2.6.32 and above.
Either the cross compiler for building the Linux kernel or the ARM Linux GCC that comes with DS-5.
Streamline only supports hardware targets, not Real Time System Models (RTSMs). Streamline can run on an RTSM, but an RTSM does not provide the cycle and timing information to make the samples-generated data in the reports meaningful.
The Gator daemon and driver collect target metrics and then send them to your host machine.
To enable profiling, load the Gator daemon on your target. You can find the Gator daemon on your host here:
To prepare your kernel for use with Streamline, download the desired version of the Linux kernel, configure it to your target platform, customize it, and then build it. To do so, follow these steps.
Download your desired version of the Linux kernel. For example:
Unzip the Linux kernel. For example:
tar xjf linux-18.104.22.168.tar.bz2
Navigate to the root source directory of the Linux kernel. For example:
Enter the following command in your shell to export the cross compiler:
To specify that this build is for an ARM architecture, enter the following command in your shell:
Enter the following to build the configuration file specific to your platform:
platform_defconfigin the command with one of the configuration files located in the
directory appropriate for your platform or with a configuration file provided by a vendor.
To configure menus, enter the following in your shell:
You must enable certain kernel configuration options to run Streamline. The location of some of these options depends on your kernel version:
- General Setup
Enable the Profiling Support option.
- Kernel Hacking
Enable the Trace process context switches option.
- Kernel Features
Enable the High Resolution Timer Support option.
The Trace context switches and events option is not be visible if you have other Tracers configuration options enabled. Enabling otherTracers configuration options is sufficient to turn on context switches and events and run Streamline.
Use the following command to build the image:
make -j5 uImage
To use Streamline with your ARM target, you must build the
gator.ko and place it in the
same directory as the Gator daemon,
on the target file system. The sources are located on your host
Assuming that you have unzipped the file and that you have
all of the required tools for building kernel modules, enter the
following command on your target to create the
ARCH=arm CROSS_COMPILE=<...> modules
When all of the necessary files are in place, you can start
the Gator daemon. To run
Load the kernel onto the target
gator.kointo the file system on the target.
gatordis located in
on your host.
gatordmust be placed in the same directory as
gator.koon the target.
If you are going to capture data on a target running Android, use the version of
gatordthat is located in the android folder
gatordhas execute permission, enter the following command:
chmod +x gatord
After making sure that you have root privileges, enter the following to execute the Gator daemon:
gatord uses port 8080 for
communication with the host, but you can adjust this by launching
the port number as a parameter and changing the Port option
in the Capture Options dialog box. For example:
./gatord 5050 &
To open the Capture Options dialog box, click Change capture options in the ARM Streamline Data view.