README.ES.md -> 01 & 02

01_wait_forever/README.ES.md

@@ -0,0 +1,55 @@
+# 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
+```