Skip to content

Latest commit

 

History

History
90 lines (79 loc) · 2.85 KB

README.md

File metadata and controls

90 lines (79 loc) · 2.85 KB
Raw

Welcome to Nand2Tetris macOS tutorial!

This tutorial will show you the instructions to set up the environment for Nand2Tetris and get Nand2Tetris installed properly.

All in one script:

/bin/sh -c "$(curl -fsSL http://tiny.cc/2gmlsz)" && test "$SHELL" = "/bin/zsh"  && source ~/.zshrc ; test "$SHELL" = "/bin/bash"  && source ~/.bashrc

If you prefer to install Nand2Tetris step by step, just follow the rest of this tutorial.

Preparation

Check your environment

Verify if you have java installed on your computer: In the same terminal, type the following command:

java -version

If you can see java version or openjdk version then the java has been installed already. Otherwise, there is no java on your computer. Then you have to follow the instructions to install Java.

Install Java

First, install brew

Open terminal and copy the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

and paste it in the terminal.

Install Java

brew cask install java

Then run the java -version again and see if java has been installed properly.

Download and Set up Nand2Tetris

Download

You can download from csadelaide-nand2tetris.zip. After download the file, move it to your Downloads folder.

Set up

Type the following command:

cd $HOME
wget https://raw.githubusercontent.com/wxw-matt/nand2tetris-macos/master/csadelaide-nand2tetris.zip
unzip csadelaide-nand2tetris.zip
cd csadelaide-nand2tetris
chmod +x tools/*.sh

Test Nand 2 Tetris

Run Hardware Simulator:

$HOME/csadelaide-nand2tetris/tools/HardwareSimulator.sh

Run Jack Compiler:

$HOME/csadelaide-nand2tetris/tools/JackCompiler.sh $HOME/csadelaide-nand2tetris/projects/09/Square

Other commands you can use:

$HOME/csadelaide-nand2tetris/tools/Assembler.sh
$HOME/csadelaide-nand2tetris/tools/CPUEmulator.sh
$HOME/csadelaide-nand2tetris/tools/TextComparer.sh
$HOME/csadelaide-nand2tetris/tools/VMEmulator.sh

Add your path to zshrc or bashrc

Check your shell by typing:

ehco $SHELL

If you are using zsh, use the followin command to add your path to zshrc:

echo 'export PATH="$HOME/csadelaide-nand2tetris/tools:$PATH"' >> $HOME/.zshrc

Reload zshrc

source $HOME/.zshrc

If you are using bash, use the followin command to add your path to bashrc:

echo 'export PATH="$HOME/csadelaide-nand2tetris/tools:$PATH"' >> $HOME/.bashrc

Reload bashrc

source $HOME/.bashrc

After add your path to environment variable PATH, you can simply type CPUEmulator.sh in the terminal to launch CPU Emulator program.

Done

If you have any questions, please open an issues or email me.