mklindtner / computerscratch

MIT 2.semester course nand2-tetris finished

Introduction

This is a completion of the course nand2tetris. For which The purpose of is to build a full-scale computer, starting from a nand chip and ending in a high-level OOP language, the name of the course is. Below is an depicting of each step in the process.

Each abstraction goes through a chapter, a chapter might present the next abstraction before asking to build it. Here is an overview w. appropriate chapters.

.

Tools, Emulators and OS

• all Tools used for testing can be found under here. Which also provides a guide on how to dl it. Personally I used Linux while going through the course. Indescrepencies might occur if trying to use test my software on other OS like Windows. It should compile fine but Windows might add unexpected spaces when using things like textcomparer.

Testing

• each chapter comes with premade tests, once all tests are passed within a chapter it's considered finished.
• an input file is delivered into a given emulator or tool, then a test file is added and the given emulator will run a comparision alerting of any unexpected behvaior.

project 01-05: computer architecture

• emulators

  • uses the hardwaresimulator and the CPU emulator

• hdl language

  • a language for running chips on software, is used to simulate proper connection of chips

• uses the tool "Digital"

  • pictures displaying the wiring logic of some chips.
  • all chips are made in the hdl language, but Digital allows for a better mental image.
  • drawings for the respective chapter can be found under "digital-drawings" in said chapter

project 06: Assembler-Hack

• emulators
  • uses the assembler (simulator), takes an input (assembler code) and compares it with a test
  • uses the textcomparer
• Overview
  • The folder "Assembler" consists of the solution for the chapter (my code)
  • The other 4 folders are program-examples that can be given as input to the Parser(inside the Assembler folder)

project 07-08: VM-Assembler

• emulators

  • uses the VMemulator

• Overview

  • the folder "VMTranslator" consists of the solution for the chapter (my code)

• note

  • a directory must containt a Sys.vm file otherwise it'll fail
  • if you wish to test files that does not have this, add the OS folders to the folder for translator to work.

project 10-11: Jack Compiler

• emulators
  • uses the JackCompiler
  • uses the textcomparer when going through chapter 10 (XML)
• overview
  • the folder "JackCompiler" consists of the solution for the chapter (my code)
  • using the terminal line call "python3.5 dest/to/jackcompiler/jackcompiler.py input/input.jack"
  • The folder/file to compile must lie in the same dest as JackCompiler.py