https://github.com/visrealm/vrcpu

Code, documentation, schematics, notes for my Ben Eater inspired breadboard computer and emulator
https://github.com/visrealm/vrcpu

8-bit arduino assembler ben-eater ben-eaters-cpu breadboard cpu electronics emulator esp8266 html5-canvas sap-1 sap1 wasm webassembly

Last synced: 14 days ago
JSON representation

Code, documentation, schematics, notes for my Ben Eater inspired breadboard computer and emulator

• Host: GitHub
• URL: https://github.com/visrealm/vrcpu
• Owner: visrealm
• License: mit
• Created: 2019-09-24T08:31:26.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-05-06T01:39:14.000Z (almost 5 years ago)
• Last Synced: 2025-03-07T16:51:24.498Z (about 2 months ago)
• Topics: 8-bit, arduino, assembler, ben-eater, ben-eaters-cpu, breadboard, cpu, electronics, emulator, esp8266, html5-canvas, sap-1, sap1, wasm, webassembly
• Language: JavaScript
• Homepage: https://cpu.visualrealmsoftware.com/emu/?h=7e387e0f377e010716bd0c7d1042303915fcc22f0d6e48656c6c6f2c20576f726c642100
• Size: 19.5 MB
• Stars: 123
• Watchers: 10
• Forks: 16
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# vrCPU

Code, documentation, schematics, notes for my [Ben Eater](https://eater.net/8bit "Ben Eater") and [James Bates](https://github.com/jamesbates/jcpu "James Bates") inspired breadboard computer, assembler and web-based [emulator](https://cpu.visualrealmsoftware.com/emu/ "emulator") using a C backend compiled to WASM.

![The real deal](https://cpu.visualrealmsoftware.com/img/computer_gh.jpg "The real deal")

## Structure

### Arduino

* Microcode EEPROM writer

* DecimalDisplay EEPROM writer

* ESP8266 Wi-Fi Program Loader

* Page-write-enabled EEPROM writer library (Tested on Greenliant GLS29EE010)

### Emulator (C library)

* SimLib - The emulator core

* SimInst - A single instance interface of the emulator core

* SimWin - A windows executable around the library (used for testing)

* SimWasm - Emscripten source and scripts to produce WASM output

### Notes

Various files used while building the breadboard computer

### Programs

Various ASM programs used to test the assembler (and the emualtor and physcial computer)

### Web

A copy of most files from [https://cpu.visualrealmsoftware.com](https://cpu.visualrealmsoftware.com "https://cpu.visualrealmsoftware.com") including:

* Assembler derived from [customasm](https://github.com/hlorenzi/customasm "customasm")

* Web-based Emulator (C engine compiled to WASM)

## Videos

##### An overview

[![An overview.](https://img.visualrealmsoftware.com/youtube/thumb/7H-PHc1CNSU)](https://youtu.be/7H-PHc1CNSU "My 8-bit breadboard computer, assembler, emulator and esp8266 program loader. An overview.")

##### Snake!

[![Snake!](https://img.visualrealmsoftware.com/youtube/thumb/xVAOxb0N3pg)](https://youtu.be/xVAOxb0N3pg "Snake! on my Ben Eater inspired 8-bit breadboard computer.")

##### Virtual versus reality. 

[![Virtual versus reality.](https://img.visualrealmsoftware.com/youtube/thumb/90tw-9bhMc0)](http://www.youtube.com/watch?v=90tw-9bhMc0 "Virtual versus reality. My Ben Eater inspired computer and emulator.")

##### Troy's breadboard computer - Triangular numbers

[![Troy's breadboard computer - Triangular numbers](https://img.visualrealmsoftware.com/youtube/thumb/Zj5HfeiyHRU)](http://www.youtube.com/watch?v=Zj5HfeiyHRU "My Ben Eater (and James Bates) inspired 8-bit computer..(Triangular numbers)")

##### Troy's breadboard computer - Emulator

[![Troy's breadboard computer - Emulator](https://img.visualrealmsoftware.com/youtube/thumb/omVyW-ZOdC8)](http://www.youtube.com/watch?v=omVyW-ZOdC8 "Web-based Emulator of my Ben Eater inspired 8-bit computer")

## License

This code is licensed under the [MIT](https://opensource.org/licenses/MIT "MIT") license