[[PageOutline]]
{{{#!html
<h1> <font size="+2"> Boot et premier programme en mode kernel
</font></h1>
}}}

Si ce n'est pas encore fait, vous devez lire la page décrivant les [WikiStart#obj_gen objectifs généraux] des séances, le [WikiStart#prin_peda principe pédagogique] choisi et le [WikiStart#fonc_sean fonctionnement des séances].

= Présentation des étapes 


La séance est découpé en 5 étapes. Dans cette présentation, pour chaque étape, nous donnons une brève description, suivie d'une liste des objectifs principaux et d'une liste des fichiers présents. Un bref commentaire est ajouté pour les fichiers.

 [#hello_boot 1. hello_boot]:: \\
   Nous commençons par un petit programme de quelques lignes en assembleur, placé entièrement dans la région mémoire 
   du boot, qui réalise l'affichage du message "Hello World". C'est un tout tout petit programme, mais pour obtenir 
   l'exécutable, vous devrez utiliser tous les outils de la chaîne de cross-compilation MIPS et 
   pour l'exécuter vous devrez exécuter le simulateur du prototype. C'est simple, mais c'est nouveau pour
   beaucoup d'entre vous.
   \\\\
 **Objectifs**
   - Savoir produire un exécutable à partir d'un code en assembleur.
   - Savoir comment afficher un caractère sur un terminal.
 
 **Fichiers**
{{{
1_hello_boot
├── hcpu.S       : code dépendant du cpu matériel en assembleur
├── kernel.ld    : ldscript décrivant l'espace d'adressage pour l'éditeur de lien
└── Makefile     : description des actions possibles sur le code : compilation, exécution, nettoyage, etc.
}}}


 [#kinit_asm 2. kinit_asm]:: \\
   Dans le deuxième programme, nous restons en assembleur, mais nous avons deux fichiers source : (1) le fichier contenant
   le code de boot et (2) le fichier contenant le code du noyau. Ici, le code du noyau c'est juste une ''fonction'' `kinit()`. Ce n'est pas vraiment une fonction car on n'utilise pas la pile.
   \\\\
   **Objectifs**
   - Savoir comment le programme de boot fait pour sauter à l'adresse de la routine kinit.
   - Savoir un fichier kernel.ld un peu plus complet.
 
 **Fichiers**
{{{
2_init_asm/
├── hcpu.S       : code dépendant du cpu matériel en assembleur
├── kernel.ld    : ldscript décrivant l'espace d'adressage pour l'éditeur de lien
├── kinit.S      : fichier contenant le code de démarrage du noyau, ici c'est une routine kinit.
└── Makefile     : description des actions possibles sur le code : compilation, exécution, nettoyage, etc.
}}}


 [#kinit_c 3. kinit_c]:: \\
   Dans ce troisième programme, nous faisons la même chose que pour le deuxième mais `kinit()` est désormais écrit en 
   langage C. Cela change peu de choses, sauf une chose importante `kinit()` est une fonction et donc il faut absolument 
   une pile d'exécution.
   \\\\
   **Objectifs**
   - Savoir comment et où déclarer la pile d'exécution du noyau. 
   - Savoir comment afficher un caractère sur un terminal depuis un programme C.
 
 **Fichiers**
{{{
3_init_c/
├── hcpu.S       : code dépendant du cpu matériel en assembleur
├── kernel.ld    : ldscript décrivant l'espace d'adressage pour l'éditeur de lien
├── kinit.c      : fichier en C contenant le code de démarrage du noyau, ici c'est la fonction kinit().
└── Makefile     : description des actions possibles sur le code : compilation, exécution, nettoyage, etc.
}}}

 [#nttys 4. nttys]:: \\
   Le prototype de SoC que nous utilisons pour les TP est configurable. Il est possible par exemple de choisir le nombre 
   terminaux texte (TTY). Par défaut, il y en a un mais, nous pouvons en avoir jusqu'à 4. Nous allons modifier le code du 
   noyau pour s'adapter à cette variabilité.
   \\\\
   **Objectifs**
   - Savoir comment compiler un programme C avec du code conditionnel.
   - Comment décrire en C l'ensemble des registre d'un contrôleur de périphérique et y accéder.
 
 **Fichiers**
{{{
4_nttys/
├── hcpu.S       : code dépendant du cpu matériel en assembleur
├── kernel.ld    : ldscript décrivant l'espace d'adressage pour l'éditeur de lien
├── kinit.c      : fichier en C contenant le code de démarrage du noyau, ici c'est la fonction kinit().
└── Makefile     : description des actions possibles sur le code : compilation, exécution, nettoyage, etc.
}}}

 [#driver 5. driver]::
   
 **Fichiers**
{{{
}}}
   

{{{#!comment —————————————————————————————————————————————————————————————————————————————————————————————————— 
}}}
=  [=#hcpu_s 1. Premier programme en assembleur dans la seule section de boot]

== Codes

{{{#!c
.section .boot,"ax",@progbits       // def. of a new section: .boot (see https://bit.ly/3gzKWob)
                                    // flags "ax":     a -> allocated means section put in memory
                                    //                 x -> section contains instructions
                                    // type @progbits: contains somethings (not just space)
boot:                                   
    la      $26,    kinit           // get address of kinit() function
    j       $26                     // goto kinit()
}}}

[attachment:tp2_hcpu.s]

== Objectif


- Affichage d'un message sur le terminal avec un programme en assembleur.




 Questions::

 - Dans quel fichier se trouve la description de l'espace d'adressage du MIPS ? 
{{{#!protected 
''
C'est dans le fichier kernel.ld
''
}}}
 - Dans quel fichier se trouve le code de boot et pourquoi l'avoir nommé ainsi ? (la réponse est dans le fichier)
{{{#!protected
''
Le code de boot est dans le fichier `hcpu.S`. Il a a été nommé ainsi parce que c'est du code qui dépend du 
hardware et qu'il concerne le cpu.
''
}}}
 - A quelle adresse démarre le MIPS ? Où peut-on le vérifier ?
{{{#!protected 
''
L'adresse de démarrage est `0xBFC00000`. On peut le vérifier dans le fichier `kernel.ld`. Il y a une définition des
régions mémoire avec une région commençant à cette adresse et c'est dans cette région que l'on met le code de boot.
''
}}}
 - Que produit le compilateur C quand on utilise l'option -c ?
{{{#!protected 

}}}
 - Que fait l'éditeur de liens ?
{{{#!protected 

}}}
 - De quels fichiers a besoin l'éditeur de liens pour fonctionner ?
{{{#!protected 

}}}
 - Dans quelle section se trouve le code de boot pour le compilateur ?
{{{#!protected 

}}}
 - Dans quelle section se trouve le message hello pour le compilateur ?
{{{#!protected 

}}}
 - Dans quelle section se trouve le code de boot dans le code exécutable ?
{{{#!protected 

}}}
 - Dans quelle région de la mémoire le code de boot est placé ?
{{{#!protected 

}}}
 - Comment connaît-on l'adresse du registre de sortie du contrôleur de terminal TTY ?
{{{#!protected 

}}}
 - Comment sait-on que le message est fini et que le programme doit s'arrêter ?
{{{#!protected 

}}}
 - Pourquoi terminer le programme par un `dead: j dead` ? 
{{{#!protected 

}}}



{{{#!comment —————————————————————————————————————————————————————————————————————————————————————————————————— 
}}}
= [=#kinit_asm 2. Saut dans le code du noyau en assembleur]


== Compétences acquises


- Comment aller à une adresse définie dans un autre fichier
- Création d'une section dans le code objet produit par le compilateur 


== Questions


- Quel est le nom de la directive assembleur permettant de déclarer une section


{{{#!comment —————————————————————————————————————————————————————————————————————————————————————————————————— 
}}}
= [=#kinit_c 3. Saut dans la fonction kinit() du noyau en langage C]

== Objectif de l'étape


- 


== Compétences acquises


- 


== Questions

- 


{{{#!comment —————————————————————————————————————————————————————————————————————————————————————————————————— 
}}}
= [=#nttys 4.  Accès aux registres de contrôle des terminaux TTY]

== Objectif de l'étape


- 


== Compétences acquises


- 


== Questions

- 


{{{#!comment —————————————————————————————————————————————————————————————————————————————————————————————————— 
}}}
= [=#drivers 5. Premier petit pilote pour le terminal]

== Objectif de l'étape


- 


== Compétences acquises


- 


== Questions

-