README.ES.md -> 01_wait_forever

01_wait_forever/README.ES.md

@@ -0,0 +1,55 @@
+# Tutorial 01 - Esperar para siempre
+
+## tl;dr
+
+* Se configura la estructura que tendrá 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` selecciona:
+
+ * `doc`: Genera la documentación.
+
+ * `qemu`: Ejecutar el kernel en QEMU.
+
+ * `clippy`
+
+ * `clean`
+
+ * `readelf`: Inspeccionar la salida de `ELF`.
+
+ * `objdump`: Inspecciona el ensamblador. 
+
+ * `nm`: Inspecciona los símbolos.
+
+## Código a revisar
+
+* El script enlazador específico de `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 Por Un Evento), detiene todos los núcleos del procesador que están ejecutando `_start()`. 
+
+* Tenemos que definir una función `#[panic_handler]` para que el compilador no nos cause problemas.
+
+ * Hazla una `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 hilado en `wfe`:
+
+```
+$ make qemu
+[...]
+IN:
+0x00080000: d503205f wfe
+0x00080004: 17ffffff b #0x80000
+```