= Manuel d'utilisateur : =
[[PageOutline]]
== I. Organisation des bibliothèques système ==
La figure suivante illustre la modalisation du système :


[[Image(modalisation_mutekp.PNG, nolink)]][[BR]]
Les bibliothèques constituant le système sont :
 *  pthread : contient l’implémentation d’un sous-ensemble des thread POSIX.
 *  libc : contient l’implémentation des services système tel que malloc, printf, read, memcpy ..etc.
 *  mwmr : contient l’implémentation du protocole MWMR.
 *  sys  : contient le code système qui ne dépend pas de l'architecture de la plate-forme ou de type des processeurs utilisés.
 *  cpu  : contient le code système en assembleur qui dépend de type des processeurs de la plate-forme.
 *  arch : contient le code C qui dépend de la plate-forme tel que des configurations système vis-à-vis des composants de la plate-forme, les ISR d’interruption des différant types de cibles ..etc. 

Les bibliothèques pthread, libc et mwmr sont indépendantes de la spécification de la plate-forme.

En cas de modification au niveau de la configuration matériel, il suffit d’adapter le code système des deux bibliothèques cpu et arch pour pouvoir déployer MUTEKP sur la nouvelle plate-forme.

== II. API du système ==
MUTEKP fourni trois bibliothèques pour les threads de l’application :

 *  Un sous-ensemble de l'API des threads POSIX :
   *  [wiki:pthread_attr_init]: initier la structure d’un attribut.
   *  [wiki:pthread_create]: créer une tâche
   *  [wiki:pthread_exit]: mettre fin à une tâche avec une valeur de retour 
   *  [wiki:pthread_self]: Donner l’indenté du thread appelant. 
   *  [wiki:pthread_equal]: tester l’égalité entre deux identificateur.
   *  [wiki:pthread_yield]: céder le processeur pour un autre thread.
   *  [wiki:pthread_join]: attendre la fin d’un thread. 
   *  [wiki:pthread_spin_init]: initialiser un verrou à une attente active.
   *  [wiki:pthread_spin_destroy]: détruire un verrou.  
   *  [wiki:pthread_spin_lock]: verrouiller le verrou à une attente active.
   *  [wiki:pthread_spin_trylock]: version non bloquante de pthread_spin_lock.
   *  [wiki:pthread_spin_unlock]: déverrouiller le verrou à une attente active.

 *  Les fonctions implémentant le protocole MWMR :
   *  [wiki:mwmr_read]: lecture d’un FIFO MWMR.
   *  [wiki:mwmr_write]: écriture dans un FIFO MWMR.
   *  [wiki:mwmr_init]: création et initialisation d’un FIFO MWMR.
	
 *  Quelques fonctions de la bibliothèque libC :
   *  [wiki:printf]: afficher une chaîne de caractères formatée sur le terminal utilisateur (tty1).
   *  [wiki:sprintf]: écrire une chaîne de caractères formatée dans un buffer.  
   *  [wiki:fprintf]: afficher une chaîne de caractères formatée sur un terminal donné.
   *  [wiki:puts]: afficher une chaîne de caractères non formatée sur le terminal utilisateur (tty1).
   *  [wiki:strlen]: calculer la longueur d'une chaîne de caractères.
   *  [wiki:malloc]: allocation de mémoire dynamique.
   *  [wiki:read]: pour lire un nombre fixe d'octets à partir du buffer système.
   *  [wiki:write]: pour écrire le contenu d'un buffer sur un terminal.
   *  [wiki:memset]: remplir une zone mémoire par une valeur donnée.
   *  [wiki:memcpy]: copie une zone moire source vers une autre zone mémoire distination.

 *  Appels propres à l'implémentation Mutek''p'' : 
   *  [wiki:pthread_attr_setprocid_np] : permet d’affecter un numéro de processeur à un attribut.
   *  [wiki:pthread_profiling_np] : permet d'afficher, sur le terminal système (tty0), des statistiques sur le déroulement de l'application et la réactivité du système.   

== III. Description de la plateforme ==
La figure suivante illustre la plateform SocLib [[BR]]
[[Image(Plate-forme.PNG, nolink)]]
[[BR]]
=== Composants de la plate-forme ===
 * Type MPSoCs 1 seul cluster
   * 4 processeurs de type MIPS R3000 avec cache Instruction et Data (16 lignes/8mots).
 * Un inter-connect VCI (Virtual Component Interconnect)
 * Une RAM multi segments
   * 8 segments
   * taille de 256 octets à 64ko
 * Un contrôleur TTY
   * 4 terminaux
 * Un contrôleur de timers programmables.
   * 5 timers
 * Un ICU : concentrateur d’interruptions
   * relié au processeur 0 pour 1 timers et les TTY
 * Un contrôleur de verrous matériels
== IV. L’Organisation des fichiers systèmes ==
== V. La génération d’une application ==