Changes between Version 11 and Version 12 of QuickStartSoclib

Timestamp:

Oct 27, 2009, 4:39:33 PM (15 years ago)

Author:

Nicolas Pouillon

Comment:

--

QuickStartSoclib

@@ -44 +44 @@
 
 {{{
-svn co -r 766 https://www-asim.lip6.fr/svn/mutekh/trunk/mutekh
+svn co -r 900 https://www-asim.lip6.fr/svn/mutekh/trunk/mutekh
 }}}
 crée un répertoire mutekh contenant les sources et les documentations de MutekH.
@@ -168 +168 @@
 }}}
 
-= Plus loin sur une plateforme SoCLib =
+= Aller plus loin avec une plateforme SoCLib =
 
 
 == Récupération des sources de SoCLib ==
 
-renvoie au site de soclib à la page d'installation
+Il faut disposer d'une installation fonctionnelle de SoCLib, on vous renvoie au site de soclib à la page d'installation: https://www.soclib.fr/trac/dev/wiki/InstallationNotes
 
 == Description de la plafeforme SoCLib ==
 
 Pour ce premier contact avec MutekH, nous avons préparé un plateforme à 4 processeurs.
-Cette plateforme se trouve dans les sources de SoCLib dans le répertoire
-``soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial-mipsel_mipseb_ppc405/``.
+Cette plateforme se trouve dans les plateformes de démo de SoCLib dans le répertoire
+``soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial/``.
 
 == Configuration de MutekH ==
@@ -185 +185 @@
 Note: Cet exemple est disponible directement dans le sous repertoire `examples/hello`.
 
-La configuration de MutekH pour une plateforme simulé de 4 processeurs va etre placé dans le fichier `hello/config_mips`: 
-{{{
+La configuration de MutekH pour une plateforme simulée de 4 processeurs va etre placée dans le fichier `hello/config_soclib_mips`: 
+{{{
+
 # Application license
   CONFIG_LICENSE_APP_LGPL
@@ -200 +201 @@
   CONFIG_CPU_MAXCOUNT 4
 
+  CONFIG_CPU_RESET_HANDLER
+
 # Mutek features
   CONFIG_PTHREAD
@@ -207 +210 @@
   CONFIG_DRIVER_CHAR_SOCLIBTTY
   CONFIG_DRIVER_ICU_SOCLIB
+  CONFIG_ARCH_DEVICE_TREE
 
 # New source code module to be compiled
-  CONFIG_MODULES hello:%CONFIGPATH
-}}}
-On note que la définition des processeurs changent. On indique qu'il s'agit de 4 mips de type bigendian.
+  CONFIG_MODULES examples/hello:%CONFIGPATH
+
+# definitions of the memory sections where to put things
+  CONFIG_ROM_ADDR 0x60100000
+  CONFIG_ROM_SIZE 0x00100000
+
+  CONFIG_RAM_ADDR 0x62600000
+  CONFIG_RAM_SIZE 0x00100000
+
+# Add an hardware enumerator
+  CONFIG_FDT
+  CONFIG_DRIVER_ENUM_FDT
+}}}
+
+On note que la définition des processeurs change. On indique qu'il s'agit de 4 mips de type bigendian.
 Le systeme peut donner des informations sur les options en tapant la commande:
+
 {{{
 make CONF=hello/config_mips showconfig TOKEN=CONFIG_SMP
@@ -220 +237 @@
 make CONF=hello/config_mips listconfig
 }}}
-Le résultat:
-{{{
-    Configuration token name                 Declare location 
-===============================================================================
-
-    CONFIG_ARCH_EMU                          (arch/emu/emu.config:2)
-    CONFIG_ARCH_IBMPC                        (arch/ibmpc/ibmpc.config:2)
-    CONFIG_ARCH_SIMPLE                       (arch/simple/simple.config:2)
- +  CONFIG_ARCH_SOCLIB                       (arch/soclib/soclib.config:2)
-    CONFIG_CLUSTER                           (arch/arch.config:8)
- m  CONFIG_CPU_MAXCOUNT                      (cpu/cpu.config:2)
- +  CONFIG_CPU_MIPS                          (cpu/mips/mips.config:2)
-    CONFIG_CPU_MIPS_ABI_EABI                 (cpu/mips/mips.config:40)
-    CONFIG_CPU_MIPS_ABI_N32                  (cpu/mips/mips.config:34)
- +  CONFIG_CPU_MIPS_ABI_O32                  (cpu/mips/mips.config:22)
-    CONFIG_CPU_MIPS_ABI_O64                  (cpu/mips/mips.config:28)
- v  CONFIG_CPU_MIPS_VERSION                  (cpu/mips/mips.config:16)
-    ...
-    (+) defined, (p) provided, (m) mandatory, (v) value.
-}}}
+
+Voir BuildSystem pour plus d'informations
+
+== Description de la plateforme ==
+
+On voit qu'on a ajouté un token `CONFIG_ARCH_DEVICE_TREE` dans le fichier de configuration, celui-ci sert à
+dire qu'on a une définition de la plateforme sous forme d'un FlattenedDeviceTree qui accompagne le kernel.
+
+Il faut en fait compiler cette description dans le kernel, en l'ajoutant dans la Makefile. Le fichier `hello/Makefile` contient alors:
+
+{{{
+objs = hello.o platform.o
+}}}
+
+Il faut ensuite ajouter un fichier `platform.dts`, au format accepté par l'utilitaire `dtc`, contenant la définition de la plateforme. Ce format est issu de l'IEEE1275 (Open Firmware).
+
+{{{
+/dts-v1/;
+
+/ {
+        model = "MutekH_Tutorial";
+        compatible = "MutekH_Tutorial";
+        #address-cells = <1>;
+        #size-cells = <1>;
+
+        cpus {
+                #address-cells = <1>;
+                #size-cells = <0>;
+                Mips,32@0 {
+                        name = "Mips,32";
+                        device_type = "cpu";
+                        reg = <0>;
+                };
+
+                Mips,32@1 {
+                        name = "Mips,32";
+                        device_type = "cpu";
+                        reg = <1>;
+                };
+
+                Mips,32@2 {
+                        name = "Mips,32";
+                        device_type = "cpu";
+                        reg = <2>;
+                };
+
+                Mips,32@3 {
+                        name = "Mips,32";
+                        device_type = "cpu";
+                        reg = <3>;
+                };
+
+        };
+
+        tty@0 {
+            device_type = "soclib:tty";
+                tty_count = <1>;
+                reg = <0x90600000 0x10>;
+                icudev = &{/icu@0};
+                irq = <1>;
+        };
+
+        icu@0 {
+            device_type = "soclib:icu";
+                input_count = <2>;
+                reg = <0x20600000 0x20>;
+                icudev = &{/cpus/Mips,32@0};
+                irq = <0>;
+        };
+
+        timer@0 {
+            device_type = "soclib:timer";
+                timer_count = <1>;
+                reg = <0x01620000 0x10>;
+                icudev = &{/icu@0};
+                irq = <0>;
+        };
+
+        memory@0 {
+                device_type = "memory";
+                cached;
+                memreg: reg = <0x61100000 0x00100000>;
+        };
+
+        memory@1 {
+                device_type = "memory";
+                memreg: reg = <0x62600000 0x00100000>;
+        };
+
+        chosen {
+                console = &{/tty@0};
+        };
+};
+}}}
+
 
 == Compilation de l'application et de MutekH ==
 
-La plateforme mutek_basic s'adapte automatique à la configuration des sources de MutekH (type de cpu, ...). 
-il faut donc ajouter un lien symbolique dans le repertoire de la plateforme soclib mutek_basic vers les sources de MutekH.
-{{{
-cd ~/soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial-mipsel_mipseb_ppc405
-ln -s ~/mutekh
-}}}
-Par ailleurs, Mutekh doit connaitre les adresses liées au matériel de la plateforme, Il faut donc ajouter des liens symboliques dans le repertoire de mutekh vers la description des adresses de la plateforme:
-{{{
-cd ~/mutekh
-ln -s ~/soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial-mipsel_mipseb_ppc405/soclib_addresses.h
-ln -s ~/soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial-mipsel_mipseb_ppc405/soclib_addresses.ldscript.m4
-}}}
-On commence par compiler le système MutekH avant de compiler la plateforme.
+La plateforme mutek_tutorial s'adapte automatique à la configuration des sources de MutekH (type de cpu, ...). 
+De plus, on peut compiler le noyau depuis le répertoire de la plateforme, donc en dehors de l'arborescence de MutekH.
+
+La Makefile fournie contient tout le code nécessaire. Elle a besoin de 3 variables:
+ `MUTEKH_DIR`::
+   Le répertoire contenant les sources de MutekH
+ `APP`::
+   Le répertoire contenant les sources de l'application (ici le répertoire de hello)
+ `CONFIG`::
+   Le fichier de configuration, dans le répertoire de la plateforme
+
 La compilation de MutekH impose que les cross tools suivants soient disponibles:
  - mipsel-unknown-elf-gcc
  - mipsel-unknown-elf-ld
- - ...
-
-{{{
-make CONF=hello/config_mips
-}}}
-Lancer la compilation de la plateforme:
-{{{
-cd soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial-mipsel_mipseb_ppc405
-make
-}}}
+ - …
+
+{{{
+$ cd soclib/soclib/platform/topcells/caba-vgmn-mutekh_tutorial
+$ make MUTEKH_DIR=~/mutekh/ APP=~/mutekh/examples/hello CONFIG=config_soclib
+}}}
+
+Cette commande compile successivement le noyau, puis la plateforme.
 
 == Exécution ==
 
-{{{
-./system.x mutekh/kernel-soclib-mips.out
-}}}
+Le simulateur prend en argument le kernel à charger, ici, il est dans `mutekh/kernel-soclib-mips.out`
+
+{{{
+$ ./system.x mutekh/kernel-soclib-mips.out
+}}}