my-own-operating-system

┌─────────────────────────────────────────────┐
│           Bootloader GRUB                    │  (protocolo Multiboot2)
│         targets/x86_64/iso/boot/            │
└────────────────────┬────────────────────────┘
                     │ carga kernel.bin, pone en eax el magic de Multiboot2
                     ▼
┌─────────────────────────────────────────────┐
│          Cabecera Multiboot2                 │  src/impl/x86_64/boot/header.asm
│   Magic: 0xe85250d6  |  Arch: i386           │
└────────────────────┬────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│         Arranque en 32 bits                  │  src/impl/x86_64/boot/main.asm
│  - Valida Multiboot2, CPUID, long mode       │
│  - Construye tablas de páginas de 4 niveles  │
│  - Habilita PAE + paginación                 │
│  - Activa long mode via MSR                  │
│  - Carga GDT 64 bits, salto lejano           │
└────────────────────┬────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│         Punto de entrada 64 bits             │  src/impl/x86_64/boot/main64.asm
│  - Limpia registros de segmento              │
│  - Llama a kernel_main()                     │
└────────────────────┬────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│              Kernel (C)                      │  src/impl/kernel/main.c
│  - Limpieza de pantalla y colores            │
│  - Utilidades de conversión entero/cadena    │
│  - Punto de entrada kernel_main()            │
└────────────────────┬────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────┐
│           Driver de texto VGA                │  src/impl/x86_64/vga.c
│  - E/S mapeada en memoria (0xb8000)          │
│  - Modo texto 80×25, 16 colores              │
│  - Scroll, saltos de línea, cursor           │
└─────────────────────────────────────────────┘

my-own-operating-system/
├── buildenv/
│   └── Dockerfile          # Entorno de compilación cruzada (x86_64-elf-gcc + nasm + grub)
├── src/
│   ├── intf/
│   │   └── vga.h           # Interfaz pública del driver VGA
│   └── impl/
│       ├── kernel/
│       │   └── main.c      # Punto de entrada del kernel (kernel_main)
│       └── x86_64/
│           ├── boot/
│           │   ├── header.asm   # Cabecera Multiboot2
│           │   ├── main.asm     # Arranque 32 bits + configuración de long mode
│           │   └── main64.asm   # Entrada 64 bits, llama a kernel_main
│           └── vga.c            # Driver de texto VGA
├── targets/
│   └── x86_64/
│       ├── linker.ld            # Script del linker (disposición de memoria)
│       └── iso/boot/grub/
│           └── grub.cfg         # Configuración del bootloader GRUB
├── Makefile                     # Reglas de compilación, enlazado y creación de ISO
├── build.sh                     # Script de build con Docker
└── test.sh                      # Runner de pruebas con QEMU

src/intf/vga.h
    └── incluido por src/impl/kernel/main.c
                  y src/impl/x86_64/vga.c

src/impl/x86_64/boot/header.asm  ─────────┐
src/impl/x86_64/boot/main.asm    ──────────┤ enlazados por linker.ld
src/impl/x86_64/boot/main64.asm  ──────────┤ entrada: start (main.asm)
src/impl/x86_64/vga.c            ──────────┤
src/impl/kernel/main.c           ──────────┘
        │
        └──→ dist/x86_64/kernel.bin
                    │
                    └──→ targets/x86_64/iso/boot/kernel.bin (symlink)
                                │
                                └──→ dist/x86_64/kernel.iso  (grub-mkrescue)

GRUB → start (main.asm, 32 bits)
         → valida el magic de Multiboot2 (eax)
         → verifica soporte de CPUID / long mode
         → mapea 1 GB con páginas de 2 MB
         → habilita PAE + long mode + paginación
         → carga GDT 64 bits, salto lejano
              → long_mode_start (main64.asm, 64 bits)
                   → kernel_main() (main.c)
                        → print_clear() / print_set_color() / print_str()
                             → buffer VGA 0xb8000 (vga.c)