mirror of
https://github.com/rust-embedded/rust-raspberrypi-OS-tutorials.git
synced 2024-11-11 07:10:59 +00:00
a6be5b34ad
* README.ES.md I added a spanish translation for the README.md file, and modified the README.md to add my github profile and to add the link to README.ES.md file * Slightly reorganize translation overview * README.ES.md These changes are in response to PR comments * Update README.ES.md * README.ES.md -> 00_before_we_start * Updating README.ES.md I corrected a few mistakes in both README.ES.md files. * README.ES.md for 00 These changes are in response to PR comments * README.ES.md -> 01_wait_forever * README.ES.md -> 02_runtime_init * README.md for 01 & 02 with corrections/improvements * Update 01_wait_forever/README.ES.md * Update 02_runtime_init/README.ES.md Co-authored-by: zanez <zanez@protonmail.com> Co-authored-by: Andre Richter <andre-richter@users.noreply.github.com> Co-authored-by: Diego Barrios Romero <eldruin@gmail.com>
56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# Tutorial 01 - Esperar infinitamente
|
|
|
|
## tl;dr
|
|
|
|
* Se configura la estructura que tiene el proyecto.
|
|
|
|
* Se ejecuta una pequeño código hecho en ensamblador que tiene como función detener todos los núcleos del procesador que están ejecutando el kernel.
|
|
|
|
## Compilar
|
|
|
|
* El archivo `Makefile` permite ejecutar:
|
|
|
|
* `doc`: Genera la documentación.
|
|
|
|
* `qemu`: Ejecutar el kernel en QEMU.
|
|
|
|
* `clippy`: Analiza el código y sugiere mejoras.
|
|
|
|
* `clean`: Elimina todos los archivos generados durante la compilación, etc.
|
|
|
|
* `readelf`: Inspecciona el archivo `ELF` de salida.
|
|
|
|
* `objdump`: Inspecciona el ensamblador.
|
|
|
|
* `nm`: Inspecciona los símbolos.
|
|
|
|
## Código a revisar
|
|
|
|
* El script para enlazado específico para la `BSP` llamado `link.ld`.
|
|
|
|
* Carga la dirección en `0x8_0000`.
|
|
|
|
* Solo la sección `.text`.
|
|
|
|
* `main.rs`: [Atributos internos](https://doc.rust-lang.org/reference/attributes.html) importantes:
|
|
|
|
* `#![no_std]`, `#![no_main]`.
|
|
|
|
* `boot.s`: La función de ensamblador `_start()` que inicia `wfe` (Wait For Event / Esperar Hasta Un Evento), detiene todos los núcleos del procesador que están ejecutando `_start()`.
|
|
|
|
* Tenemos que definir una función que funcione como `#[panic_handler]` (manejador de pánico) para que el compilador no nos cause problemas.
|
|
|
|
* Hazla `unimplemented!()` porque se eliminará ya que no está siendo usada.
|
|
|
|
## Pruébalo
|
|
|
|
Dentro de la carpeta del proyecto, ejecuta a QEMU y mira el núcleo del procesador ejecutando `wfe` en bucle:
|
|
|
|
```
|
|
$ make qemu
|
|
[...]
|
|
IN:
|
|
0x00080000: d503205f wfe
|
|
0x00080004: 17ffffff b #0x80000
|
|
```
|