Building-The-Hack-Computer

KO | EN

gitlite — search

#hacktoberfest #react #android #rust #linux #docker #awesome #kubernetes #vue #security #pytorch #mcp #ios #open-source

Building-The-Hack-Computer

(★ 12)

This is a personal project which purpose is to learn computer architecture by implementing the Hack Computer.

Building-The-Hack-Computer 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://github.com/VitorgsRuffo/Building-The-Hack-Computer">
 <img src="./Images/logo.png" alt="Logo" width="100" height="100">
 </a>

<h3 align="center">Building the Hack Computer</h3>

This is a personal project which purpose is to learn computer architecture by implementing the Hack Computer.

<details open="open">
 <summary>Table of Contents</summary>
 <ol>
 <li>
 <a href="#about-the-project">About The Project</a>
 </li>
 <li>
 <a href="#getting-started">Getting Started</a>
 <ul>
 <li><a href="#prerequisites">Prerequisites</a></li>
 </ul>
 </li>
 <li><a href="#usage">Usage</a></li>
 <li><a href="#contributing">Contributing</a></li>
 <li><a href="#contact">Contact</a></li>
 </ol>
</details>

## About The Project

![hack-computer](https://raw.githubusercontent.com/VitorgsRuffo/Building-The-Hack-Computer/main/Hack-Computer-(Logisim)/Images/hack-computer.png)

This is a personal project which purpose is to learn computer architecture by implementing the Hack Computer (Noam Nisan and Shimon Schocken. 2008. The Elements of Computing Systems: Building a Modern Computer from First Principles (History of Computing S.). The MIT Press).

The aforementioned book, a.k.a NandToTetris, aims to take the reader on a journey to build a simple but powerful 16-bit general-purpose computer. It gives you the knowledge and tools to gradually and modularly implement it from the ground up. The reader starts by building elementary logic gates, such as NOT, AND, OR, ..., and goes all the way until high-level applications, as the classic Tetris game, can be run on the computer that has been built.

I have only read the book until the 5th chapter in which the system hardware is already implemented and ready to run low-level code. Firstly, I have described the computer in a Hardware Description Language (HDL) by following the book instructions [(check out computer description)](./Hack-Computer-description-in-HDL). Then, I have implemented the computer in Logisim, which is an educational software to simulate logic gates [(check out the Logisim project)](./Hack-Computer-(Logisim)). This book is awesome and presents many computer architecture fundamental concepts, I recommend it to everyone interested in computer science.

## Getting Started

The computer description in HDL can be interpreted and tested by using the software suite provided by the book. But, its implementation in Logisim is a thing that I have done by myself, so let's see how you can get a local copy of that project and run it.

### Prerequisites

1. Go to [this website](http://www.cburch.com/logisim/download.html) and follow the instructions to install Logisim.
  
2. Clone this repo:
   ```sh
   git clone https://github.com/VitorgsRuffo/Building-The-Hack-Computer.git
   ```

## Usage

1. Open Logisim and inside it open the "hack-computer.circ" file located at "/path/to/repository/Building-The-Hack-Computer/Hack Computer (Logisim)":

2. Click on the Hack Computer chip:
<a href="https://github.com/VitorgsRuffo/Building-The-Hack-Computer">
 <img src="./Images/chip.png" alt="chip" width="800" height="500">
</a>

3. Go to the Simulate option on Logisim's menu and enable clock ticks:
<a href="https://github.com/VitorgsRuffo/Building-The-Hack-Computer">
 <img src="./Images/simulate.png" alt="simulate" width="800" height="500">
</a>

4. The computer will start to run the program that is preloaded in its ROM. After the first four intructions, value 10 gets loaded at RAM's 6th address. The 2 last instructions are there to avoid that the computer runs garbage instructions stored at subsequential ROM addresses, compromising the result of the actual program.

5. By inspecting RAM chip we can see that the value 10 has actually been loaded at RAM's 6th address.
<a href="https://github.com/VitorgsRuffo/Building-The-Hack-Computer">
 <img src="./Images/ram.png" alt="ram" width="800" height="500">
</a>

The book's 4th chapter defines the computer machine language. After understanding it you can write machine-level programs, load them into ROM chip and get the computer to run your program. For more information, check out the book.

## Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## Contact

Vitor G. S. Ruffo - [LinkedIn](https://www.linkedin.com/in/vitor-ruffo-8211731b6/) - vitor.gs.ruffo@gmail.com

Building-The-Hack-Computer

Building-The-Hack-Computer 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Building-The-Hack-Computer

Building-The-Hack-Computer 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README