Introduction

Nintendo Entertainment Kernel is a very basic kernel with only the minimun to run a NES emulator. This means that it can be run without any OS. It does not have pagging nor userspace nor any kind of protection at all. Only one program can be run. It is embedded in the kernel, which means the program's code is compiled alongside the kernel.

Screenshots

Building

You should use make and provide the cross compiler:

PATH=/path/to/crosscompiler/bin:$PATH make kernel program=emulador

If there are not errors, kernel.elf should be in the bin folder.

Examples

Besides "emulador" there are three other working programs:

mandelbrot (shows a explorable fractal)
paleta (shows nes avalaible colors)
corazon (a heart animation using math functions)

All of them can be compiled with the kernel using make.

Ej: make program=examples/mandelbrot

Installing

You may copy kernel.elf to /boot/ and add an entry at /etc/grub.d/40_custom like:

menuentry "nek" {

multiboot /boot/kernel.elf module /boot/initrd.img

}

Remember to update the config file:

sudo grub-mkconfig -o /boot/grub/grub.cfg

Testing

The makefile should run QEMU using the disk image disk.img. A loop device to this file must have been set up in the mount folder.

Dependencies

i686 cross compiler (both C and ASM), like GCC and nasm
GRUB2(optional): Generates .iso (cd image)
QEMU(optional): Emulation
Doxygen and Graphviz (optional): For generating the documentation
grub-mkrescue (optional): For generating a booteable cd image (.iso)

Boot call stack

GRUB (multiboot standard)

kernel/arch/x86/init/boot.s <-- calls c code, initializes stack

kernel_entry() at kernel/arch/x86/init/kernel_entry.c <--base system initilization

kmain() at kernel/kmain.c <--- some services are started

main() at program/main.(c|cpp) <--- main program

Folder Structure

kernel folder has all related to the kernel
kernel/arch code that depends on the architecture
kernel/fs file system(currently only vfs implemented)
fdlibm: a math library downloaded from internet
util/specs: Some useful documents
informe: University report (in spanish)
iso: a few files to generate an .iso with the kernel
util: contains the program to generate the initrd and a few other things
util/fuente: Tools/file used to generate the console font

vmartinv/nek