In-browser emulator of Hack CPU from nand2tetris course using react

Hack Emulator

This project emulates Hack computer from
nand2tetris course. It is still under light
development (light means that I might add/fix/polish things from time to time,
but not actively).

https://hithroc.github.io/hack-emulator/

Current features

  • Built-in assembler (although it is very crude and doesn’t really have error
    reporting as of yet)

  • ROM view, including binary machine code as well as the coresponding
    instructions. Current instruction (program counter) is highlighted.

  • RAM view

  • Full ALU implementation, which includes undocumented instructions, unlike the
    official CPU emulator.

  • Adjustable clock speed (although I would not recommend to go above ~10MHz)

  • Full support for keyboard input and display output.

  • All in your browser on any device! No Java required!

Kinda Maybe Sorta Planned features:

  • Breakpoints

  • Ability to modify values in RAM

  • Running official test files

  • Ahead of time compilation as well as other optimizations

  • Perhaps some extensions to Hack, like

    • Memory banks

    • Colored display

    • Periferals like storage?

    • 6/N-key rollover support

  • Light/dark theme support?

Building

To build the project you need Node 12.x. Then you can just run:

npm install
npm run-stript build

This should create app.js file in ./dist/. You can open ./dist/index.html
in your browser.

Contributing

Ha, like anyone ever will!

Some other notes

This project was mostly written in about a week to get some practice with
TypeScript and React (given that I’ve not used either before), so there might
be some rough edges or non-idiomatic code/project structure. Reviews are
welcome!

GitHub

View Github