NAND2Tetris

Practice of the book The Elements of Computing Systems: Building a Modern Computer from First Principles

Overview

This repository contains my solutions and experiments for the NAND2Tetris course, a comprehensive program that teaches how to build a computer from the ground up.

Prerequisites

• Access to the NAND2Tetris Software Suite.
• Understanding of digital logic and basic computer architecture.

Usage

The repository is structured according to the course's projects:

NAND2Tetris Practice Repository Structure

Project Overview

This repository is organized based on the chapters of the NAND2Tetris book, with each project corresponding to a specific chapter.

Note: Inside the folder practice/chips are add-on chips made for practice, but those are not related to the standard course.

Chapter 1: Boolean Logic

• Folder: materials/projects/01/
  • Description: Implementation of basic logic gates (AND, OR, NOT, etc.)
  • Contents:
    • Logic gate HDL files
    • Test scripts and comparison files

Chapter 2: Boolean Arithmetic

• Folder: materials/projects/02/
  • Description: Construction of arithmetic circuits like Half Adder, Full Adder, and ALU
  • Contents:
    • Arithmetic circuit HDL files
    • Test scripts and comparison files

Chapter 3: Sequential Logic

• Folder: materials/projects/03/
  • Description: Building basic sequential circuits such as DFF, Registers, and Counters
  • Contents:
    • Sequential circuit HDL files
    • Test scripts and comparison files

Chapter 4: Machine Language

• Folder: materials/projects/04/
  • Description: Writing machine language programs and scripts
  • Contents:
    • Machine language programs
    • Test scripts and comparison files

Chapter 5: Computer Architecture

• Folder: materials/projects/05/
  • Description: Implementation of the Hack CPU and Memory
  • Contents:
    • Hack CPU and Memory HDL files
    • Test scripts and comparison files

Each folder includes the necessary .hdl files and other relevant resources.

To use a project's files:

1. Open the NAND2Tetris software.
2. Load the .hdl file from the project folder.
3. Execute the corresponding test script provided by the NAND2Tetris course materials.

Simulators

To execute the Hardware simulator

make hardware

To execute the CPU simulator

make software

License

This project is open source under the MIT License.