summaryrefslogtreecommitdiff
path: root/docs/01-Usage.txt
blob: 3eeb7645395be1f6e78144e9b251445270c23623 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
Usage
=====

1.  Requirements/Pre-requisites

    1.  A Linux development environment. This release has been
        build tested on the following Linux host environments:

        1.  Linux Ubuntu 10.10  
        2.  Red Hat Enterprise Linux WS release 4 (Nahant Update 4)

        This release is not intended to be used on development
        environments other than Linux.

    2.  An installation of the ARM RealView Development Suite. This
        release was built and tested with version 4.1 [Build 514].

    3.  An installation of the Perl scripting language. This release
        was built and tested with v5.10.1.

    4.  An installation of the GNU coreutils suite 
        <http://www.gnu.org/software/coreutils/>.  This release was
        built and tested with v8.5.

2.  Build instructions

    Note that this release relies on the 'env' utility, which is
    a part of the coreutils suite. The 'env' utility is expected
    to be located at '/bin/env'. If it is at a different
    location then this must be reflected in the first line of
    the following file:

    arm-virtualizer-v2_1-171111/bootwrapper/makemap

    Failure to make this modification will result in a build
    failure.

    To build the software:

    $ tar -jxf arm-virtualizer-v2_1-171111.tar.bz2
    $ cd arm-virtualizer-v2_1-171111/bootwrapper
    $ make clean && make

    The resulting file is 'img.axf'.

    This image may be loaded and executed on the model debugger 
    as explained in section 3 below.

    Note that the pre-built stub kernel image is located at:

    arm-virtualizer-v2_1-171111/bootwrapper/payload/kernel

    .. and the placeholder dummy root filesystem image is located 
    at:
        
    arm-virtualizer-v2_1-171111/bootwrapper/payload/fsimg

    These may be replaced with custom built images such as a 
    suitably configured linux kernel image and a root filesystem 
    image. 
    
    Look at docs/03-Linux-kernel-build.txt for instructions on 
    building a suitable Linux kernel. 
    
    Look at docs/06-Optional-rootfs-build.txt for optionally 
    building a complete root filesystem.

3.  Usage

    If the Kingfisher Real-Time System Model (RTSM VE Cortex-A15 KF
    CCI version 6.2 Beta) is installed, the resulting 
    img.axf file may be loaded, executed and debugged on the 
    model and the associated model debugger.

    This model may be obtained from ARM by separate arrangement.

    Steps to run the software:

    a.    Depending upon whether the MPx1 or MPx4 model is being used,
          update the big-little-mp<x>.mxscript file (x is 1 or 
          4 as the case may be) with the absolute
          path to the model and the img.axf file. (Comments in the
          file indicate where the changes have to be made)

    b.    Invoke the modeldebugger and the script file as follows:

          $ <path to modeldebugger> -s <path to big-little-mp<x>.mxscript>

          The default build simultaneously switches clusters 
          every 12 million cycles (appx).