summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPawel Moll2011-09-30 05:47:12 -0500
committerPawel Moll2011-09-30 05:47:12 -0500
commit1d5b785dbabac2dfc45103e7c2d787952c93488c (patch)
treee03426ecb18855bb05af48a811e619cc26eb2f3b /README_Streamline.txt
parent7c366b2d106bd14742cc3446f874e520d473703d (diff)
downloadarm-ds5-gator-1d5b785dbabac2dfc45103e7c2d787952c93488c.tar.gz
arm-ds5-gator-1d5b785dbabac2dfc45103e7c2d787952c93488c.tar.xz
arm-ds5-gator-1d5b785dbabac2dfc45103e7c2d787952c93488c.zip
gator: Move driver sources to a separate directory
... in prepration for daemon sources. Signed-off-by: Pawel Moll <pawel.moll@arm.com>
Diffstat (limited to 'README_Streamline.txt')
-rw-r--r--README_Streamline.txt81
1 files changed, 0 insertions, 81 deletions
diff --git a/README_Streamline.txt b/README_Streamline.txt
deleted file mode 100644
index 4688474..0000000
--- a/README_Streamline.txt
+++ /dev/null
@@ -1,81 +0,0 @@
1
2*** Purpose ***
3
4Instructions on setting up ARM Streamline on the target.
5The gator driver and gator daemon are required to run on the ARM linux target in order for ARM Streamline to operate.
6The driver should be built as a module and the daemon must run with root permissions on the target.
7
8*** Preparing and building the kernel ***
9
10cd into the root source dir of the linux kernel
11make ARCH=arm CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-none-linux-gnueabi- <platform_defconfig> (choose the appropriate configuration for your board)
12make ARCH=arm CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-none-linux-gnueabi- menuconfig
13
14Required Kernel Changes (depending on the kernel version, the location of these configuration settings within menuconfig may be different)
15- General Setup
16 - [*] Profiling Support
17- Kernel hacking
18 - [*] Tracers
19 - [*] Trace process context switches and events
20- Kernel Features
21 - [*] High Resolution Timer Support
22
23The "context switches and events" option will not be available if other trace configurations are enabled. Other trace configurations being enabled is sufficient to turn on context switches and events.
24
25Optional Kernel Changes (depending on the kernel version, the location of these configuration settings within menuconfig may be different)
26Note: Configurations may not be supported on all targets
27- System Type
28 - [*] <SoC name> debugging peripherals (enable core performance counters on supported SoCs) /* kernels before 2.6.35 */
29
30make -j5 ARCH=arm CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-none-linux-gnueabi- uImage
31
32*** Building the gator module ***
33
34To create the gator.ko module,
35 cd /ds-5-install-directory/arm/src
36 tar xzf gator-driver.tar.gz
37 cd gator-driver
38 make -C <kernel_build_dir> M=`pwd` ARCH=arm CROSS_COMPILE=<...> modules
39for example
40 make -C /home/username/kernel_2.6.32/ M=`pwd` ARCH=arm CROSS_COMPILE=/home/username/CodeSourcery/Sourcery_G++_Lite/bin/arm-none-linux-gnueabi- modules
41If successful, a gator.ko module should be generated
42
43*** Compiling an application or shared library ***
44
45Recommended compiler settings:
46 "-g": Debug symbols needed for best analysis results.
47 "-fno-inline": Speed improvement when processing the image files and most accurate analysis results.
48 "-fno-omit-frame-pointer": ARM EABI frame pointers (Code Sourcery cross compiler) allow the call stack to be recorded with each sample taken when in ARM state (i.e. not -mthumb).
49
50*** Running gator ***
51
52Load the kernel onto the target and copy gatord and gator.ko into the target's filesystem.
53gatord is located in <installdir>/arm/armv5t/.
54Ensure gatord has execute permissions
55 chmod +x gatord
56gator.ko must be located in the same directory as gatord on the target.
57With root privileges, run the daemon
58 sudo ./gatord &
59
60*** Profiling the kernel (optional) ***
61
62make ARCH=arm CROSS_COMPILE=$(CROSS_TOOLS}/bin/arm-none-linux-gnueabi- menuconfig
63- Kernel Hacking
64 - [*] Compile the kernel with debug info
65
66make -j5 ARCH=arm CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-none-linux-gnueabi- uImage
67Use vmlinux as the image for debug symbols in Streamline.
68Drivers may be profiled using this method by statically linking the driver into the kernel image.
69Note that the gator driver does not perform kernel call stack recording.
70
71*** Automatically start gator on boot (optional) ***
72
73cd /etc/init.d
74vi rungator.sh
75 #!/bin/bash
76 /path/to/gatord &
77update-rc.d rungator.sh defaults
78
79*** GPL License ***
80
81For license information, please see the file LICENSE.