Changes between Version 28 and Version 29 of QuickStartSoclib


Ignore:
Timestamp:
Jun 16, 2010, 1:00:35 AM (14 years ago)
Author:
becoulet
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • QuickStartSoclib

    v28 v29  
    33SoCLib simulator allow easy experimentation with advanced multi-processor programming.
    44
    5 This guide explains how to run MutekH on a [wiki:Arch/Soclib SoCLib] hardware simulator with native processor heterogeneity support.
     5This guide explains how to run MutekH on a [wiki:Arch/Soclib SoCLib] hardware simulator.
    66
    77The SoCLib simulator used here is easy to use but has a complex internal design due to dynamic processors model instanciation.
     
    1616=== Getting SoCLib ===
    1717
    18 We now need to have a working SoCLib install. SoCLib installation is explained here: soclib:InstallationNotes
     18A precompiled {{{caba-vgmn-mutekh_kernel_tutorial}}} SoCLib platform is available [https://www.mutekh.org/www/tools/ here] for test purpose.
     19You can use this simulator and skip to the MutekH part if you are in a hurry.
    1920
    20 Moreover, you'll need the MutekH source tree and its prerequisites. See InstallationNotes
     21We need to have a working SoCLib install. SoCLib installation is explained here: soclib:InstallationNotes
    2122
    2223=== SoCLib platform description ===
     
    2526{{{soclib/soclib/platform/topcells/caba-vgmn-mutekh_kernel_tutorial/}}}.
    2627
     28The simulator can be built using:
     29
     30{{{
     31#!sh
     32$ cd path/to/soclib/soclib/platform/topcells/caba-vgmn-mutekh_kernel_tutorial
     33$ make system.x
     34}}}
     35
    2736== The MutekH part ==
    2837
    2938=== Getting the sources ===
    3039
     40You'll need the MutekH source tree and its prerequisites. See InstallationNotes
     41
    3142{{{
    3243#!sh
    33 svn co https://www-asim.lip6.fr/svn/mutekh/trunk/mutekh
     44svn co https://www.mutekh.org/svn/trunk/mutekh/
    3445}}}
    3546
     
    4253What you need to do:
    4354
    44  - Write the source code in `hello.c`
    45  - Write the `Makefile`
    46  - Write the `platform-mips+arm.dts` to describe hardware, see FlattenedDeviceTree for details.
     55 - Create a directory for the application.
     56 - Write the source code in `hello.c`.
     57 - Write the `Makefile`.
    4758 - Write the source configuration file, see BuildSystem for details.
    4859
    49 Note: This example is available directly from {{{examples/hello_het}}} directory in source tree: [source:trunk/mutekh/examples/hello_het]
     60Note: This example is available directly from {{{examples/hello}}} directory in source tree: [source:trunk/mutekh/examples/hello]
    5061
    5162=== Getting the cross-compilers ===
    5263
    53 You can rely on the {{{tools/crossgen.mk}}} script which comes along with MutekH to build some GNU cross-toolchains:
    54 {{{
    55 #!sh
    56  $ tools/crossgen.mk
    57  $ tools/crossgen.mk all TARGET=mipsel-unknown-elf
    58  $ tools/crossgen.mk all TARGET=arm-unknown-elf
    59 }}}
     64You can rely on the {{{tools/crossgen.mk}}} script which comes along with MutekH to build some GNU toolchains or download a precompiled toolchain. See BuildingExamples page.
    6065
    6166=== Compiling the application along with MutekH ===
     
    6469#!sh
    6570$ cd path/to/mutekh
    66 $ make kernel-het CONF=examples/hello_het/config BUILD=ph-het EACH=soclib-arm:soclib-mips32el
     71$ make CONF=examples/hello/config BUILD=ph-tutorial:soclib-arm
    6772}}}
    6873
    6974This will build the MutekH kernel along with the application.
    70 The simulator can then be built using:
    71 
    72 {{{
    73 #!sh
    74 $ cd path/to/soclib/soclib/platform/topcells/caba-vgmn-mutekh_kernel_tutorial
    75 $ make system.x
    76 }}}
    7775
    7876== Execution ==
     
    8280#!sh
    8381$ cd path/to/soclib/soclib/platform/topcells/caba-vgmn-mutekh_kernel_tutorial
    84 $ ./system.x mips32el:2 path/to/mutekh/kernel-mipsel.het.out arm:2 path/to/mutekh/kernel-arm.het.out
     82$ ./system.x arm:4 path/to/mutekh/kernel-arm.het.out
    8583}}}
    8684