How cr4t3/neodymium works
Neodymium is an 8-bit virtual machine. Its user workflow is to launch the executable with a binary program, which validates and loads the file into machine memory before running the CPU. The machine also provides an in-RAM stack and a GLFW-backed virtual screen. The excerpts show the loader, RAM operations, instruction handling, and screen drawing; they do not expose the complete CPU run loop or how it updates the screen, so those links are omitted.
Main entry points: main.cpp CLI Loader · cpu.cpp CPU · ram.cpp RAM · stack.cpp In-RAM Stack
Components 11
Program Entry
- CLI Loader
src/main.cpp
Virtual Machine
- CPU
src/modules/cpu.cpp - RAM
src/modules/ram.cpp - In-RAM Stack
src/modules/stack.cpp - Virtual Screen
src/modules/screen.cpp
Runtime Support
- Error Handling
src/modules/errors.cpp - Byte Conversions
src/modules/casts.cpp - VM Types
src/modules/def.h
Other components
- VM User
- Program Binary
- GLFW
Connections 11
- VM User → CLI Loader: runs
README.MD - Program Binary → CLI Loader: provides input
src/main.cpp - CLI Loader → CPU: creates
src/main.cpp - CLI Loader → RAM: loads bytes
src/main.cpp - CLI Loader → Error Handling: raises errors
src/main.cpp - CPU → RAM: reads and writes
src/modules/cpu.cpp - CPU → In-RAM Stack: pushes and pops
src/modules/cpu.cpp - CPU → Error Handling: raises errors
src/modules/cpu.cpp - RAM → Byte Conversions: converts bytes
src/modules/ram.cpp - In-RAM Stack → Byte Conversions: converts bytes
src/modules/stack.cpp - Virtual Screen → GLFW: uses windowing
src/modules/screen.cpp