How eklavyamirani/nand2tetris works
Main Components
A. Hardware Layer (Bottom-Up Approach)
• Basic Logic Gates (Project 01)
• ALU and Arithmetic Chips (Project 02)
• Sequential Logic (Project 03)
• Machine Language (Project 04)
• Computer Architecture (Project 05)
B. Software Layer
• Assembler (Project 06)
• VM Translator (Projects 07-08)
• Compiler (Projects 10-11)
• Operating System (Project 12)
C. Simulation Tools
• Hardware Simulator
• CPU Emulator
• VM Emulator
• Compiler
• Assembler
[Tools Layer]
┌─────────────────────────────────────────────┐
• Hardware CPU VM Jack │
• Simulator Emulator Emulator Compiler │
• ┘
[Software Layer]
┌─────────────────────────────────────────────┐
• Operating System (OS) │
• ┤
• Compiler │
• ┤
• VM Translator │
• ┤
• Assembler │
• ┘
[Hardware Layer]
┌─────────────────────────────────────────────┐
• Computer Architecture (CPU/Memory) │
• ┤
• Machine Language │
• ┤
• Sequential Logic │
• ┤
• ALU & Arithmetic │
• ┤
• Basic Logic Gates │
• ┘
Additional Details
Sub-components for each major section:
A. Hardware Layer Details:
• Logic Gates: AND, OR, NOT, etc.
• Memory components: RAM, ROM
• CPU components: ALU, Registers
• Bus structure and data paths
B. Software Layer Details:
• OS APIs (Math, Memory, Screen, etc.)
• Compilation stages
• VM translation process
• Assembly process
Testing Flow
• .hdl files to Hardware Simulator
• .asm files to CPU Emulator
• .vm files to VM Emulator
• .jack files to Compiler
Implementation Notes
• Use standardized symbols for components:
• Rectangles: Processing units
• File extensions (.hdl, .asm, .vm, .jack)
• Testing file relationships (.tst, .cmp)
• Tool purposes and interactions
Docker Integration
A separate section showing how the Docker container encapsulates:
• Simulation tools
• Project files
• Testing environment